Tips

• the contents of docs/ is deleted before building the site. If this is not done no longer used files will build up in there. Should you need to keep files put them in the static directory.

• I dislike the way hugo truncates posts automatically for summary.
  Manually truncating by placing <!–more–> assures the head is rendered nicely. For short posts one can just put it at the and assure they are rendered fully.

• The makefile create a minified version of the rendered site.
  I like this as the plain hugo rendered pages contain lots of extra spacing.
  Having comments and other unused code removed is also nice. This apparently can break some hugo functions. So if you find it causes trouble find following section in the Makefile and remove the --minify

  page: all_rmd
     rm -rf docs/*
     hugo --minify
  

  • You can modify the archetype for posts. However hugo will create posts for all md and html files, so make sure you have a preamble that they are hidden, or use custom extensions.