Skip to content

Latest commit

 

History

History
145 lines (107 loc) · 3.01 KB

README.md

File metadata and controls

145 lines (107 loc) · 3.01 KB
Raw

Minos

A simple and retro styled theme, concentrated more on your ideas.

Minos is a Hugo theme ported from Hexo theme Minos. Requires Hugo v0.59+.

Screenshots

Home Article Tag

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
  • Syntax highlighting using 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.

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

Ported by

Carson Ip

License

Licensed under the MIT License. See the LICENSE file for more details.