forestryio / novela-hugo-starter Goto Github PK

View Code? Open in Web Editor NEW

65.0 4.0 38.0 1.23 MB

Novela, the simplest way to start publishing with Hugo and Forestry.

Home Page: https://hugo-novela-forestry.netlify.app/

License: MIT License

hugo-starter forestry-starter blog-theme forestry-cms

novela-hugo-starter's Introduction

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

Create a new site in Netlify and import your repository.
Set the build command to: hugo --gc --minify
Set the publish directory to: public
Set GO_VERSION to 1.12 or above
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

novela-hugo-starter's People

Contributors

Stargazers

Watchers

novela-hugo-starter's Issues

new post templates are not applied on blog posts

I created an template for posts without hero image and applied to the post. Yet i see blank space after title.

Checked the theme code, sorry i couldn't find where you are selecting template for the posts. I am new to Hugo and Gatsby.

I have also one more issue, if we add field to Home or Home Hero in front matter templates, the markdown file is appended with all fields including new one rather than just adding new one to table. The new field is also not getting displayed.

Deploy failed in netlify

Hi, I love novela, elegant and simple. Thanks for your work.
But I came across a problem. When I choose Github as repository, and set hugo --gc --minify and public,(Step 1-3), HUGO_VERSION is right, but the netlify says 'Deploy failed'. I am a designer, so I don't know much about those. You list 5 steps, but I find that Step3 is same as Step 5. Would you give me some advice about how to solve this problem?

Not working connect

Not working from https://forestry.io/starters/ but work from https://app.forestry.io/quick-start?repo=forestryio/novela-hugo-starter&engine=hugo&version=0.60.1

Failed netlify deploy when using Forestry's import function

Hi,
I'm currently having problems when attempting to deploy a novela blog through Forestry's import function. Here is my process:

https://forestry.io/starters/ brings me to "Create a Site", using template [email protected]:forestryio/novela-hugo-starter.git. The template is correctly imported in forestry.
-In Netlify, I add a new site from Git, choosing the just created git repository. The Build command I use is hugo --minify, while Publish directory is set to public. Unfortunately, deploying fails soon thereafter with the following error:

5:47:37 PM: Build ready to start
5:47:39 PM: build-image version: 9cade8af58c2cf3a17a1e9433d2e979149488837
5:47:39 PM: build-image tag: v3.3.5
5:47:39 PM: buildbot version: 2d05064ce3dd2eb95d282a24602ab707dd9581e8
5:47:39 PM: Fetching cached dependencies
5:47:39 PM: Failed to fetch cache, continuing with build
5:47:39 PM: Starting to prepare the repo for build
5:47:40 PM: No cached dependencies found. Cloning fresh repo
5:47:40 PM: git clone [email protected]:just_created_repository_from_forestry
5:47:42 PM: Preparing Git Reference refs/heads/master
5:47:43 PM: Starting build script
5:47:44 PM: Installing dependencies
5:47:45 PM: Downloading and installing node v10.18.0...
5:47:45 PM: Downloading https://nodejs.org/dist/v10.18.0/node-v10.18.0-linux-x64.tar.xz...
5:47:46 PM: #####################
5:47:46 PM: 29.5%
5:47:46 PM: #######################
5:47:46 PM: ################################################# 100.0%
5:47:46 PM: Computing checksum with sha256sum
5:47:46 PM: Checksums matched!
5:47:48 PM: Now using node v10.18.0 (npm v6.13.4)
5:47:49 PM: Attempting ruby version 2.6.2, read from environment
5:47:50 PM: Using ruby version 2.6.2
5:47:50 PM: Using PHP version 5.6
5:47:50 PM: Started restoring cached go cache
5:47:50 PM: Finished restoring cached go cache
5:47:50 PM: unset GOOS;
5:47:50 PM: unset GOARCH;
5:47:50 PM: export GOROOT='/opt/buildhome/.gimme/versions/go1.12.linux.amd64';
5:47:50 PM: export PATH="/opt/buildhome/.gimme/versions/go1.12.linux.amd64/bin:${PATH}";
5:47:50 PM: go version >&2;
5:47:50 PM: export GIMME_ENV='/opt/buildhome/.gimme/env/go1.12.linux.amd64.env';
5:47:50 PM: go version go1.12 linux/amd64
5:47:50 PM: Installing missing commands
5:47:50 PM: Verify run directory
5:47:50 PM: Executing user command: hugo --minify
5:47:50 PM: Error: "/opt/build/repo/themes/novela/layouts/partials/func/GetArticleAuthors.html:39:1": parse failed: template: partials/func/GetArticleAuthors.html:39: function "return" not defined
5:47:50 PM: Skipping functions preparation step: no functions directory set
5:47:50 PM: Caching artifacts
5:47:50 PM: Started saving pip cache
5:47:50 PM: Finished saving pip cache
5:47:50 PM: Started saving emacs cask dependencies
5:47:50 PM: Finished saving emacs cask dependencies
5:47:50 PM: Started saving maven dependencies
5:47:51 PM: Finished saving maven dependencies
5:47:51 PM: Started saving boot dependencies
5:47:51 PM: Finished saving boot dependencies
5:47:51 PM: Started saving go dependencies
5:47:51 PM: Finished saving go dependencies
5:47:53 PM: Error running command: Build script returned non-zero exit code: 255
5:47:53 PM: Failing build: Failed to build site
5:47:53 PM: failed during stage 'building site': Build script returned non-zero exit code: 255
5:47:53 PM: Finished processing build request in 14.547300709s

This happens using both GitLab and GitHub.

Disclaimer: I'm a complete beginner, so it is quite probable I made a silly mistake. In any case, I haven't been able to find a solution. Any help is appreciated.