A clean and minimal Hugo theme.
.github/workflows | ||
archetypes | ||
assets | ||
data | ||
exampleSite | ||
i18n | ||
images | ||
layouts | ||
static | ||
testdata | ||
.gitignore | ||
config.toml | ||
LICENSE | ||
Makefile | ||
README.md | ||
theme.toml |
Minima
A clean and minimal Hugo theme porting from Hexo Minima. See the demo site.
The main branch is in development stage, UI or configuration may vary.
Features
- Dark mode
- Multilingual mode
- Code highlighting - VSCode dark+
- Math - KaTeX
- Flowcharts - Mermaid
- Comment - Disqus, Utterances, Giscus
- 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.toml and edit your own one.
Supported Front Matters
Field | Type | Explanation |
---|---|---|
title | string | Title of the post |
description | string | Description of the post |
date | string | Datetime when the post is written |
link | string | If set, the post will redirect to an external link |
categories | array | Array of categories the posts belongs to |
series | array | Array of series the post belongs to |
tags | array | Array of tags the posts is related to |
math | bool | True if the post needs to render math formulas |
mermaid | bool | True if the post needs to render mermaid diagrams |
comment | bool | True if the post allows people to make comments |
draft | bool | True if the post isn't already for publishing |
Contribution
I'm currently looking for i18n contributors :)
Feedback
Feedbacks are welcome here.