Skip to content

carsonip/hugo-theme-minos

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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.

About

A simple and retro styled Hugo theme ported from Hexo

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published