Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Sustain - Logo

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