69 lines
2.4 KiB
Markdown
69 lines
2.4 KiB
Markdown
# Minima
|
|
|
|
A clean and minimal Hugo theme porting from [Hexo Minima](https://github.com/adisaktijrs/hexo-theme-minima). See the [demo site](https://mivinci.github.io/hugo-theme-minima).
|
|
|
|
> The main branch is in development stage, UI or configuration may vary.
|
|
|
|
|
|
|
|
## Features
|
|
|
|
- [x] Dark mode
|
|
- [x] Multilingual mode
|
|
- [x] Code highlighting - VSCode dark+
|
|
- [x] Math - KaTeX
|
|
- [x] Flowcharts - Mermaid
|
|
- [x] Comment - Disqus, Utterances, Giscus
|
|
- [x] Google analytics
|
|
- [x] External link
|
|
- [x] 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
|
|
|
|
```bash
|
|
git submodule add --depth 1 https://github.com/mivinci/hugo-theme-minima.git themes/minima
|
|
```
|
|
|
|
#### Git Clone
|
|
|
|
```bash
|
|
git clone https://github.com/mivinci/hugo-theme-minima.git themes/minima
|
|
```
|
|
|
|
|
|
### Configuration
|
|
|
|
Follow [exampleSite/config.toml](https://github.com/Mivinci/hugo-theme-minima/blob/main/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](https://github.com/Mivinci/hugo-theme-minima/issues).
|