Hugo Static Site Generator

Hugo is a static site generator written in Go. It is very easy to install and is available on Windows, Linux and Mac. Hugo has excellent documentation which makes it a breeze to get started. Hugo Quickstart Guide

Hugo Themes

Hugo has a large array of themes and for most themes it is simply a matter of cloning a GitHub repo and modifying config.toml. I am currently testing the hello-friend theme written by Radek Kozieł. I love its simplicity, readability and speed.

git submodule add https://github.com/orf/bare-hugo-theme.git themes/bare
# This is required:
git submodule update --init --recursive

Hugo Themes

Markdown

Markdown is simply a very readable marked up text standard. Markdown is versatile and flexible and can be used to generate html, pdf and many more file types. Pandoc is the Swiss army knife for document conversion. Pandoc can even generate *.docx files from markdown.

Hugo Basic Commands

Hugo is very well documented and being a command line tool you can always just run man hugo if you get stuck. Below are the main commands I use:

 # create a new site
hugo new site name-of-site
# add a new post
hugo new post/post.md
# test site locally and build drafts
hugo server -D
# generate site
hugo