74 lines
1.9 KiB
Markdown
74 lines
1.9 KiB
Markdown
# Minima
|
|
|
|
A clean and minimal Hugo theme porting from [Hexo Minima](https://github.com/adisaktijrs/hexo-theme-minima). Check out the [example site](https://mivinci.github.io/hugo-theme-minima).
|
|
|
|
|
|
|
|
> Note that 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
|
|
|
|
| Attr | Type | Explanation |
|
|
|:----------- |:------ |:------------|
|
|
| title | string | title |
|
|
| description | string | description |
|
|
| date | string | creation time |
|
|
| categories | array | category list |
|
|
| series | array | series list |
|
|
| tags | array | tag list |
|
|
| math | bool | enables math formulas rendering |
|
|
| mermaid | bool | enables flowcharts rendering |
|
|
| comment | bool | enable comment plugin |
|
|
| draft | bool | disallow being published |
|
|
| link | string | a URL to redirect to |
|
|
|
|
|
|
## Contribution
|
|
|
|
I'm currently looking for i18n contributors :)
|
|
|
|
## Feedback
|
|
|
|
Feedbacks are welcome [here](https://github.com/Mivinci/hugo-theme-minima/issues).
|
|
|
|
## License
|
|
|
|
Hugo Minima is MIT licensed.
|