hugo-theme-minima/exampleSite/content/instruction.md

---
author: Hugo Authors
title: Instruction
date: 2021-07-19T10:52:59+08:00
description: A Clean and minimal Hugo theme porting from Minima on Hexo. [Click me](https://h.xjj.pub/) to take a look at the demo site.
math: true
comment: true
---


## Features

- [x] Light/dark mode
- [x] VSCode-style code hightlighting
- [x] KaTeX
- [x] Mermaid
- [x] Google analytics
- [x] Disqus/Utterances comments
- [x] Optional ToC 

## Usage

Before using Minima, make sure you've got Hugo(v0.41.0 or higher) installed on your device.

### Installation

Suppose `blog` is where you place your sources.

```bash
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.

```bash
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](https://github.com/Mivinci/hugo-theme-minima/blob/main/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](https://github.com/Mivinci/hugo-theme-minima/issues).
mermaid support 2021-08-19 06:42:47 +02:00			`---`
			`author: Hugo Authors`
			`title: Instruction`
			`date: 2021-07-19T10:52:59+08:00`
			`description: A Clean and minimal Hugo theme porting from Minima on Hexo. [Click me](https://h.xjj.pub/) to take a look at the demo site.`
			`math: true`
100% support of utterances 2021-11-12 08:47:28 +01:00			`comment: true`
mermaid support 2021-08-19 06:42:47 +02:00			`---`



			`## Features`

			`- [x] Light/dark mode`
update introduction 2021-11-12 09:30:39 +01:00			`- [x] VSCode-style code hightlighting`
mermaid support 2021-08-19 06:42:47 +02:00			`- [x] KaTeX`
			`- [x] Mermaid`
			`- [x] Google analytics`
update introduction 2021-11-12 09:30:39 +01:00			`- [x] Disqus/Utterances comments`
mermaid support 2021-08-19 06:42:47 +02:00			`- [x] Optional ToC`

			`## Usage`

			`Before using Minima, make sure you've got Hugo(v0.41.0 or higher) installed on your device.`

			`### Installation`

			Suppose `blog` is where you place your sources.

			```bash
			`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.

			```bash
			`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](https://github.com/Mivinci/hugo-theme-minima/blob/main/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](https://github.com/Mivinci/hugo-theme-minima/issues).`