We have clarified our Privacy Statement. Please have a look at our changes.
fork of the hugo-sustain theme (https://github.com/nurlansu/hugo-sustain) 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 8d7bc62cb3
fix size of labels
2 weeks ago
archetypes Archetype fix 2 years ago
exampleSite add fediverse icon 1 month ago
images :wink: This is where it all begins... 3 years ago
layouts update ForkAwesome 1 month ago
static fix size of labels 2 weeks ago
LICENSE.md 😀 Updated LICENSE.md 2 years ago
README.md add atom feed content to the main page and rotate it, e.g. to display your latest Mastodon or GNU Social posts 2 years ago
theme.toml 🐶 Fixed broken links 2 years ago

README.md

This is a fork of https://github.com/nurlansu/hugo-sustain

Changes:

  • 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

Installation

With git

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

git clone https://github.com/nurlansu/hugo-sustain.git themes/hugo-sustain

Manual

  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.

  exampleSite
  ├── config.toml
  ├── content
  │   ├── projects.md
  │   │
  │   └── blog
  │       ├── creating-a-new-theme.md
  │       ├── go-is-for-lovers.md
  │       ├── hugo-is-for-lovers.md
  │       └── migrate-from-jekyll.md
  │
  ├── 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.

Features

Syntax highlighting

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

Disqus

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.

About

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

Contributing

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

Changelog

Version 1.0.1

  • Added proper “Projects” page rendering
  • Fixes, many fixes

Version 1.0

  • Initial release

License

MIT