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

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
• Automatically playing and pausing videos as they become (in)visible while scrolling

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
+++

Usage

Automatically playing and pausing videos with scrolling

VP9 (and H.264 to a lesser extent) are great at keeping file sizes down, but with the tradeoff of expensive CPU-based decoding if your GPU does not support it. This feature lets you use these formats in place of GIFs for short, silent, and repeating videos to save on bandwidth without paying the CPU cost when the video is not visible.

To use it, place your VP9 and fallback videos somewhere accessible and add it to your article using the <video> tag with the playpause-with-visibility class:

<video autoplay playsinline muted loop class="playpause-with-visibility">
  <source src="/path/to/your/video.webm" type="video/webm">
  <source src="/path/to/your/video.mp4" type="video/mp4">
</video>

autoplay is needed to have behavior that is as close as possible with JavaScript disabled, and playsinline is needed to enable inline playback on mobile Safari.

The script interprets loop to mean that the video is GIF-like. If loop is specified, the script will also mute the video and disable controls.

Please be a good Net citizen by refraining from autoplaying videos with sound, regardless of whether you use this feature.

Whether a page is a blog post

+++
blogpost = true
+++

If it is not set, the generated page will not have a date or navigation to the next or previous post. If your site overrides the default archetypes, it is recommended to also add this line to your archetypes for blog-like sections.

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 file for more details.