Minimalistic Hugo theme (mirror of https://github.com/niklasbuschmann/contrast-hugo)
archetypes | ||
images | ||
layouts | ||
static | ||
.gitignore | ||
LICENSE.txt | ||
README.md | ||
theme.toml |
Adaption of the of contrast Jekyll theme.
Installation
To install Contrast as your default theme, first install this repository in the themes/
directory:
$ cd themes/
$ git clone https://github.com/niklasbuschmann/contrast-hugo.git
Second, specify contrast-hugo
as your default theme in the config.yaml
file. Just add the line
theme: "contrast-hugo"
at the top of the file.
Sidebar
Instead of the horizontal menu, a sidebar can be enabled with sidebar: true
. See here for an example of the sidebar in action. Adding a hidden
class to the icon tag will hide the icon on mobile devices.
An example config.yaml
section could look like this:
params:
sidebar: true
show_excerpts: true
fontawesome: true
description: 'Made by <a href="">Blog Author</a>'
menu:
main:
- {name: "Home", url: "/", identifier: "home", weight: 1, pre: "<span class='fas fa-home hidden'></span>"}
- {name: "About", url: "/about/", identifier: "address-card", weight: 2, pre: "<span class='fas fa-address-card hidden'></span>"}
remote:
- {name: "Mail", url: "mailto:", identifier: "envelope", weight: 3, pre: "<span class='fas fa-envelope hidden'></span>"}
- {name: "Github", url: "https://github.com/", identifier: "github", weight: 4, pre: "<span class='fab fa-github hidden'></span>"}
- {name: "Subscribe", url: "/index.xml", identifier: "rss", weight: 5, pre: "<span class='fas fa-rss hidden'></span>"}
Features
- supports dark mode on macOS Mojave
- optional sidebar
- MathJax support
- no external resources
- responsive