Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/carsonip/hugo-theme-minos
A simple and retro styled Hugo theme ported from Hexo
https://github.com/carsonip/hugo-theme-minos
hugo hugo-theme
Last synced: about 1 month ago
JSON representation
A simple and retro styled Hugo theme ported from Hexo
- Host: GitHub
- URL: https://github.com/carsonip/hugo-theme-minos
- Owner: carsonip
- License: mit
- Created: 2017-02-18T21:48:02.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2021-04-04T15:18:35.000Z (almost 4 years ago)
- Last Synced: 2024-05-20T09:19:46.718Z (8 months ago)
- Topics: hugo, hugo-theme
- Language: CSS
- Homepage:
- Size: 1.91 MB
- Stars: 139
- Watchers: 6
- Forks: 74
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-hexo-themes - carsonip/hugo-theme-minos
README
# Minos
**_A simple and retro styled theme, concentrated more on your ideas._**
Minos is a Hugo theme ported from Hexo theme [Minos](https://github.com/ppoffice/hexo-theme-minos). Requires Hugo v0.59+.
## Screenshots
## Features
* Everything in the original Mino theme, except
* Gallery (fancybox)
* Duoshuo comment
* Search box
* Hierarchical categories (since this isn't supported in Hugo)
* Smart table of contents (will highlight and expand current section in TOC)
* Disqus
* Google Analytics
* [KaTeX](https://github.com/Khan/KaTeX)
* Syntax highlighting using [highlight.js](https://github.com/isagalaev/highlight.js)
## Installation
To install Minos as your theme, first clone this repository in the `themes/` directory:
```
$ cd themes/
$ git clone --depth 1 https://github.com/carsonip/hugo-theme-minos
```
Second, specify `hugo-theme-minos` as your default theme in the config.toml file. Just add the line
```
theme = "hugo-theme-minos"
```
## Options
### Pagination
```
paginate = 10
```
### Smart TOC
```
[params]
smartToc = true
```
### Post Navigation
```
[params]
noPostNavigation = true
```
This option disables links to next and previous post at the bottom of posts.
### Disqus
```
disqusShortname = "xxxxxx"
```
### Google Analytics
```
googleAnalytics = "UA-123-45"
```
### KaTeX
```
[params]
katex = true
```
This option enables the KaTeX auto-render extension. To render block math, use `$$ ... $$`. For inline math, use `\\( ... \\)`. For more details, please refer to https://github.com/KaTeX/KaTeX/blob/v0.7.1/contrib/auto-render/auto-render.js#L73 .
### Custom CSS
```
[params]
customCss = ["css/foo.css"]
```
### Others
For other configuration variables, visit [Hugo documentation](https://gohugo.io/overview/configuration/#configuration-variables).
## Post Params
### Featured Image displayed in index.html
```
+++
featuredImage = "img/foobar.jpg"
+++
```
### Hide the post from index.html
This can be used when creating an "About me"-page.
```
+++
hidden = true
+++
```
### Enable KaTeX for this post
Enable KaTeX for a specific post without enabling the global switch.
```
+++
katex = true
+++
```
### Suppress date in an article
Hide the date from an article, e.g. because it's just an index:
```
+++
omitDate = true
+++
```
## Contributing
1. Fork it!
2. Create your feature branch: `git checkout -b my-new-feature`
3. Commit your changes: `git commit -am 'Add some feature'`
4. Push to the branch: `git push origin my-new-feature`
5. Submit a pull request :D
## Original Author
PPOffice
* https://github.com/ppoffice
## Ported by
Carson Ip
* https://github.com/carsonip
## License
Licensed under the MIT License. See the [LICENSE](https://github.com/carsonip/hugo-theme-minos/blob/master/LICENSE.md) file for more details.