rguid31 / novela-hugo-starter

Hugo Novela Forestry Starter

A port of Narative's Gatsby theme Novela

Prerequisites

This starter is importing the theme as a Hugo Module

• Go > 1.12
• Hugo > 0.65.0

Content Management

This starter is ready to be imported into Forestry ✨.

Any changes you save in the CMS will be commited back to your Git repository.

Deploy on Netlify

Import your repository in Netlify

1. Create a new site in Netlify and import your repository.
2. Set the build command to: hugo --gc --minify
3. Set the publish directory to: public
4. Set GO_VERSION to 1.12 or above
5. Set HUGO_VERSION to 0.65.3 or above

That's it, now your site gets deployed automatically on git push or when saving documents from Forestry.

Deploy on Vercel

Import your repository in Vercel

Add a bash script and build steps via a vercel.json file in your repository in order to build the site.

Development

# clone your repository
# cd in your project directory
# Start local server
hugo server

For more information, see official Hugo documentation.

Customization

Logo

Add to your projects layout directory your logo's SVG: /layouts/icons/ui/logo.html

Socials

In order for the Socials to be surfaced in Forestry, you should copy the theme's config/_default/social.yaml to your project.

Authors

You should register authors as a taxonomy in your project's `config.yaml``

taxonomies:
  author: authors

Creating authors

Add a similar file to your content directory and Front Matter example.

# /content/authors/firstname-lastname/_index.md
---
title: Dennis Brotzky
bio: |
  Written by You. This is where your author bio lives. Share your work, your
  joys and of course, your Twitter handle.
avatar: /images/dennis-brotzky.jpg
featured: true
social:
  - title: github
    url: https://github.com
  - title: twitter
    url: https://twitter.com
  - title: instagram
    url: https://instagram.com
  - title: dribbble
    url: https://dribbble.com
  - title: unsplash
    url: https://unsplash.com
---

Assigning authors to posts.

Add the name of the author to the "authors" field:

authors:
  - Dennis Brotzky
  - Thiago Costa

Newsletter call to action

This theme includes a shortcode for a newsletter callout form that you can add to any page. It uses formspree.io as proxy to send the actual email. Each month, visitors can send you up to one thousand emails without incurring extra charges. Visit the Formspree site to get get going add your Formspree email to your shortcode like this:

{{< subscribe email="[email protected]" >}}

LICENSE

MIT