mivinci / hugo-theme-minima

A clean and minimal Hugo theme.

Minima

Minima is a clean and minimal Hugo theme originally ported from Hexo Minima. Check out the example site.

Note that the main branch is in development phase, UI or configuration may vary.

Features

• 🌗 Dark mode
• 📚 Multilingual mode
• 🏳️‍🌈 Code highlighting - VSCode dark+
• 🔢 Math - KaTeX
• 💹 Flowcharts - Mermaid
• 🧑‍💻 Comment - Disqus, Utterances, Giscus
• 🔎 Search - FuseJS
• 〽️ Google analytics
• 🔗 External link
• ✉️ RSS

Usage

Before using Minima, make sure you've got Hugo (extended version) installed on your device.

Installation

You can use either git submodule or git clone to fetch this theme into the directory where Hugo places themes.

Git Submodule

git submodule add --depth 1 https://github.com/mivinci/hugo-theme-minima.git themes/minima

Git Clone

git clone https://github.com/mivinci/hugo-theme-minima.git themes/minima

Configuration

Follow exampleSite/config.yaml and edit your own one.

Supported Front Matters

Attr	Type	Explanation
title	string	title
description	string	description
date	string	creation time
categories	array	category list
series	array	series list
tags	array	tag list
math	bool	enables math plugin
diagram	bool	enables diagram plugin
comment	bool	enable comment plugin
draft	bool	disallow being published
link	string	a URL to redirect to

Contribution

I'm currently looking for i18n contributors :)

Feedback

Feedbacks are welcome here.

Star History

License

Hugo Minima is MIT licensed.