Netlify Gotchas

This is a page to document lessons learned while making sites with the Hugo static site generator and continuous delivery.

I have numbered these sections for reference.

1. Do Not Put Theme Folder in .gitignore

If you do this, netlify cannot find the theme. Duh.

I did it. Now it is fixed.

2. When Using Asciidoctor and Hugo

You have to include a GEM file in your git repo for Netlify to work.

GEM
  remote: https://rubygems.org/
  specs:
    asciidoctor (2.0.10)

PLATFORMS
  ruby

DEPENDENCIES
  asciidoctor

BUNDLED WITH
   1.16.1

And the gemfile I used is the following.

source 'https://rubygems.org'

gem "asciidoctor"

Updated on 02 Nov 2019

comments powered by Disqus