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.
- 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
- Manton Reece - Custom templates, categories, new theme, and more (Micro.blog now using Hugo)
- Jamie Tanna has written a few:
- 2019-10-07 Paul Kinlan Using Web Mentions in a static site (Hugo)
- 2021-02-21 : How I Integrated Webmentions Into My Hugo Static Site (archived)
Migrating to Hugo
From Jekyll
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!