Hugo

This article is a stub. You can help the IndieWeb wiki by expanding it.

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:

• Jonathan Prozzi - jonathanprozzi.net
• Daniel Goldsmith - View from Ascraeus
• Craig Mod's On Margins - craigmod.com/onmargins
• René - renem.net (Moved from Medium on May 19, 2017) (German)
• Markus Heurung - byzero.de
• Alan S.
  • Details on webmention set up
• skippy
• Kaushal Modi - A Scripter's Notes
• Keith J. Grant - keithjgrant.com
• Vika - Vika's Hideout
• Christopher Allen using the Indie-Tufte theme by Kevin Marks
•   Jamie Tanna on [1]
• Robert A. Uhl on [2]
• Robert van Bregt uses GitHub + Hugo + Netlify for his personal domain.
• Evgeny Kuznetsov - evgenykuznetsov.org
• Ethan Yoo uses a modified version of the smol theme
• Josemar Lohn uses a self-hosted instance of Gitea + Drone + Hugo for his personal domain (since 2021-08-07).
• Ivan Boothe - rootwork.org (since 2022-09-29)
• Zinzy Waleson's website (since 2024-01-07)

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

• Daniel Goldsmith - Embracing the IndieWeb

• 2018-02-10: Amit Gawande - IndieWebify Your Hugo Website: Control Your Identity and Content Online

• Manton Reece - Custom templates, categories, new theme, and more (Micro.blog now using Hugo)

•   Jamie Tanna has written a few:
  • https://www.jvt.me/posts/2019/01/04/goodbye-jekyll-hello-hugo/
  • https://www.jvt.me/posts/2019/08/26/setting-up-micropub/
  • https://www.jvt.me/posts/2019/10/30/reader-mail-hugo-micropub/

• 2019-10-07 Paul Kinlan Using Web Mentions in a static site (Hugo)

• 2020-04-01 Evgeny Kuznetsov To the Un-Known! How I moved from Known to Hugo

• 2021-02-21 Jessica Smith: How I Integrated Webmentions Into My Hugo Static Site (archived)

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

• hyde-hyde: supports rel-me thanks to 2018-09-14 pull request by tommorris
• Indigo: supports h-entry, rel-me and IndieAuth, nice starting point for a basic IndieWeb website. >> Indigo Wiki Section
• ...

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

• static site generator
• https://www.sarasoueidan.com/blog/jekyll-ghpages-to-hugo-netlify/
• https://discourse.gohugo.io/t/anyone-for-webmention/10411/11
• Keeping Content DRY: Data Relationships In Hugo taxonomies with an example of venues, patterns likely relevant for IndieWeb sites
• https://blog.ktamas.com/index.php/2019/02/01/converting-my-blog-to-hugo-and-getting-rid-of-my-vps/
• Reproach An indieweb flavoured theme for the Hugo Static Site Generator by Daniel Goldsmith
• Indigo
• a million page static site made with Hugo How We Brought the Online Collections into the Modern Age using Web Technology of the Past
• PESOS from twitter https://github.com/victorstanciu/hugo-tweets
• Step-by-step instructions & examples to IndieWebify your Hugo site: 2022-07-22: Indiewebify me! And don't forget my webmentions!