Hugo

cf iwc:Hugo-fr

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

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)
• Naty S — burgeonlab.com uses a heavily-modded Anubis2 theme
• Paul Tibbetts - paultibbetts.uk - recording my progress at /indiemark

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.
• Paul Robert Lloyd's Indiekit Micropub server has a publication Hugo preset plugin.

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

• Indigo: supports h-entry, rel-me and IndieAuth, nice starting point for a basic IndieWeb website. >> Indigo Wiki Section
• ...

rel-me

The rel-me support in the following themes was added via pull requests by tommorris between 2018 and 2020.

• charaka
• ghostwriter
• hermit
• hugo-dream-plus
• hugo-nuo
• hyde-hyde
• hyde-y
• nix
• resume
• sky
• whiteplain

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
• 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!

<footer>source iwc:Hugo</footer>

<footer>