fork of the hugo-sustain theme ( used for my personal homepage. I try to contribute back whenever it makes sense
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Björn Schießle 9a53497b25 add web mentions 2 years ago
archetypes Archetype fix 5 years ago
exampleSite add fediverse icon 3 years ago
images 😉 This is where it all begins... 6 years ago
layouts add web mentions 2 years ago
static add "follow me" button 2 years ago 😀 Updated 5 years ago add atom feed content to the main page and rotate it, e.g. to display your latest Mastodon or GNU Social posts 5 years ago
theme.toml 🐶 Fixed broken links 5 years ago

This is a fork of


  • Remove anti-features
    • Disqus
    • Google Analytics
  • Add a "burger menu" for small screens
  • Add comments via free & distributed social networks instead of Disqus
  • Add "share on social network"-buttons for blog posts
  • No external dependencies, all JavaScript, Fonts, etc. come directly with this theme
  • Add a nice and elegant way to add slides directly to your blog post (the example page contains a example article)
  • Add content from a Atom feed to the index page and rotate it, e.g. to show you latest posts on GNU Social, Mastodon or anything else with a Atom feed
  • Some small visual improvements

Table of Contents

Sustain Screen

Sustain Live Demo


With git

From the root of your Hugo site, clone the theme into themes/hugo-sustain by running :

git clone themes/hugo-sustain


  1. Download zip archive.
  2. Unarchive it.
  3. Move hugo-sustain folder in themes folder of your blog

For more information read the official setup guide of Hugo.

Quick start

After installation, take a look in the exampleSite folder at. This directory contains an example config file and the content for the demo. It serves as an example setup for your documentation.

  ├── config.toml
  ├── content
  │   ├──
  │   │
  │   └── blog
  │       ├──
  │       ├──
  │       ├──
  │       └──
  ├── data
  │   └── projects.yml
  └── static

Copy at least the config.toml in the root directory of your website. Overwrite the existing config file if necessary.

Hugo includes a development server, so you can view your changes as you go - very handy. Spin it up with the following command:

hugo serve

Now you can go to localhost:1313 and the Sustain theme should be visible.


Syntax highlighting

Use highlight = true in the front matter to include highlight.js javascript and css files.


To use this feature, uncomment and fill out the disqusShortname parameter in config.toml`.

Google Analytics

To add Google Analytics, simply sign up to Google Analytics to obtain your Google Tracking ID, and add this tracking ID to the googleAnalytics parameter in config.toml.


This is a port of the Jekyll theme Sustain by Fábio Madeira. It supports most of the features of the original theme.


Pull requests, bug fixes, and new features are welcome!

  1. Fork the repository
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -a -m 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request on GitHub


Version 1.0.1

  • Added proper "Projects" page rendering
  • Fixes, many fixes

Version 1.0

  • Initial release