hugo-theme-minima/README.md
2022-01-26 22:45:45 +08:00

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.

screenshot

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.