2021-07-18 10:34:01 +02:00
# Minima
2022-11-08 17:05:50 +01:00
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 ).
2021-07-18 10:34:01 +02:00
2021-07-18 15:40:40 +02:00
![screenshot ](./images/tn.png )
2022-11-08 17:05:50 +01:00
> Note that the main branch is in development stage, UI or configuration may vary.
2021-07-18 10:34:01 +02:00
## Features
2022-11-08 16:53:16 +01:00
- [x] Dark mode
- [x] Multilingual mode
- [x] Code highlighting - VSCode dark+
- [x] Math - KaTeX
- [x] Flowcharts - Mermaid
- [x] Comment - Disqus, Utterances, Giscus
2021-07-18 15:40:40 +02:00
- [x] Google analytics
2022-11-08 16:53:16 +01:00
- [x] External link
2022-02-17 12:55:29 +01:00
- [x] RSS
2021-07-18 10:34:01 +02:00
## Usage
2021-11-12 09:30:39 +01:00
Before using Minima, make sure you've got Hugo (extended version) installed on your device.
2021-07-18 15:40:40 +02:00
### Installation
2022-11-08 16:53:16 +01:00
You can use either `git submodule` or `git clone` to fetch this theme into the directory where Hugo places themes.
#### Git Submodule
2021-07-18 15:40:40 +02:00
```bash
git submodule add --depth 1 https://github.com/mivinci/hugo-theme-minima.git themes/minima
```
2022-11-08 16:53:16 +01:00
#### Git Clone
2021-07-18 15:40:40 +02:00
```bash
git clone https://github.com/mivinci/hugo-theme-minima.git themes/minima
```
### Configuration
2022-11-08 19:11:37 +01:00
Follow [exampleSite/config.yaml ](https://github.com/Mivinci/hugo-theme-minima/blob/main/exampleSite/config.yaml ) and edit your own one.
2021-07-18 15:40:40 +02:00
2022-11-08 17:05:50 +01:00
## Supported Front Matters
2021-07-18 15:40:40 +02:00
2022-11-08 17:05:50 +01:00
| 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 |
2022-11-09 13:51:50 +01:00
| math | bool | enables math plugin |
| diagram | bool | enables diagram plugin |
2022-11-08 17:05:50 +01:00
| comment | bool | enable comment plugin |
| draft | bool | disallow being published |
| link | string | a URL to redirect to |
2022-01-30 08:12:29 +01:00
2022-11-08 17:05:50 +01:00
## Contribution
2022-02-17 12:55:29 +01:00
2022-11-08 16:53:16 +01:00
I'm currently looking for i18n contributors :)
2022-01-30 08:12:29 +01:00
2023-03-14 18:08:49 +01:00
## Forms
[add a contact form and publish to github pages]
](https://fabform.io/a/create-a-static-website-with-contact-form-on-github-pages)
2022-11-08 17:05:50 +01:00
## Feedback
2021-07-18 15:40:40 +02:00
Feedbacks are welcome [here ](https://github.com/Mivinci/hugo-theme-minima/issues ).
2022-11-08 17:05:50 +01:00
2023-03-01 19:38:59 +01:00
## Star History
[![Star History Chart ](https://api.star-history.com/svg?repos=mivinci/hugo-theme-minima&type=Date )](https://star-history.com/#star-history/star-history& Date)
2022-11-08 17:05:50 +01:00
## License
Hugo Minima is MIT licensed.