2.5 KiB
2.5 KiB
Minima
A Clean and minimal Hugo theme porting from the Hexo Minima. Click me to take a look at the demo site.
The main branch is in development stage, UI or configurations may vary. You can use the latest stable version here.
Features
- Clean
- Light/dark mode
- VSCode-style code hightlighting (the most alike among all Hugo themes)
- KaTeX
- Mermaid diagrams
- Google analytics
- Disqus/Utterances
- Optional ToC
Usage
Before using Minima, make sure you've got Hugo (extended version) installed on your device.
Installation
Suppose blog
is where you place your sources.
cd blog
git init
git submodule add --depth 1 https://github.com/mivinci/hugo-theme-minima.git themes/minima
Or clone
directly if you don't wanna use the Git submodule.
git clone https://github.com/mivinci/hugo-theme-minima.git themes/minima
Anyways, you just need to put Minima under the blog/themes
directory.
Configuration
Follow exampleSite/config.toml and edit your own blog/config.toml
file.
Supported Front Matters
Field | Type | Explanation |
---|---|---|
title | string | Title of the post, will be rendered in a h1 tag |
description | string | Description of the post, will be rendered in a p tag |
date | string | Datetime that the post is written |
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 graphs |
comment | bool | True if the post allows people to make comments |
draft | bool | True if the post isn't already to production |
toc | bool | True if the post needs a ToC |
Feedback
Feedbacks are welcome here.