Hugo

From IndieWeb

Hugo is a static site generator written in Go used by several people in the IndieWeb community to run their personal sites. It is designed to build a site based on markdown files with header information in YAML, TOML or JSON. It uses Go templates and compiles a full site very rapidly. No built-in IndieWeb support, but adding microformats to templates is relatively straightforward.

How to

How to IndieWebify a Hugo site

Amit Gawande wrote an excellent post on How to IndieWebify Your Hugo Website: Control Your Identity and Content Online

IndieWeb Examples

People currently using Hugo as their primary site:

Micropub Implementation

  • Daniel Goldsmith wrote the nanopub micropub-endpoint specifically for use with Hugo. Provides implementation for notes, articles, check-ins, bookmarks and replies.
  •   Jamie Tanna's Micropub server is built around Hugo's directory structure, and required metadata

Articles

Migrating to Hugo

From Jekyll

migrate-jekyll-hpstr-hugo

From WordPress

There is a small nifty wordpress-to-hugo-exporter plugin for Wordpress, which exports Posts and Pages from a WordPress site into a files and directories hierarchy ready to be used with Hugo (one would still need to configure/create a theme, etc. before being able to actually compile the site).

Tested at IndieWebCamp Brighton 2016 by hotzeplotz on WordPress 4.6.1, worked perfectly (exporting around 7MB of post/pages and media to a zip file in <1 second, with content then compiled by Hugo in 150ms!)

Importing a Twitter Archive

skippy has created a rudimentary Python script to convert a Twitter export into Markdown, for use with Hugo. It relies on granary to manipulate the raw Twitter JSON.

Themes with indieweb-focussed microformat and markup support

Support present

PRs submitted

  • hermit – PR
  • hugo-nuo - PR
  • nix - PR
  • hugo-academic - PR
  • sada - PR
  • whiteplain - PR
  • hugo-dream-plus - PR
  • ghostwriter - PR
  • charaka - PR
  • sky - PR
  • jeffprod - PR
  • resume - PR
  • hyde-y - PR

See Also