hugo-theme-pure

A port of hexo-theme-pure for Hugo. Powerful & Clean. Iconfont

This was previously built but subsequently archived by @xiaoheiAh

Contribute

Since I mainly don't do considerable amount of front end work these days, I haven't kept up with new HTML, CSS or JavaScript standards over the years.

If you have a very good feature and hope to contribute it, please raise an issue first, so that we can chat about it. All PRs must link to an issue for context.

Live sites

This theme is used in the following sites run by @kilasuit

• https://blog.kilasuit.org
• https://kitchen.kilasuit.org
• https://mhasl.me

Development Roadmap

We have a high level plan for the development roadmap that includes

• Page layouts

• Responsive design improvements

• Accessibility Improvements

• Publishing a release package and publishing this to the Hugo Themes listing

• Potential forking to other static site generators

• Multilingual improvements

Theme Colors

The theme includes multiple color schemes that can be configured using the skin parameter. Available options:

• theme-black (default) - Dark charcoal gradient
• theme-blue - Blue gradient
• theme-green - Green/teal gradient
• theme-purple - Purple gradient
• theme-yellow - Golden yellow to orange gradient
• theme-orange - Orange to red gradient
• theme-dark-blue - Dark navy blue gradient
• theme-red-deep - Deep burgundy red gradient
• theme-red-bright - Bright red gradient
• theme-pink - Magenta to coral gradient
• theme-turquoise - Teal to turquoise gradient
• theme-bright-cyan - Cyan to blue gradient
• theme-bright-green - Green to lime gradient
• theme-bright-magenta - Magenta to dark purple gradient
• theme-bright-yellow - Bright yellow to olive gradient
• theme-cyan - Cyan gradient
• theme-magenta - Magenta to purple gradient

Configure in your config.yml:

params:
  config:
    skin: theme-blue  # Choose your preferred theme

Screenshots (Update these)

Installation

$ cd $HUGO_ROOT
$ git clone https://github.com/kilasuit/hugo-theme-pure themes/pure
$ ./hugo server -t pure

Note

1. Please copy the config.yml under the exampleSite folder to the root folder of your Hugo Site. Feel free to change it. If you don't like .yml file, you can also convert it to you want.

2. Your post should under the posts folder, like this : hugo new posts/any.md

Favicon & Images

You should put you images into static folder at your root project. When specify favicon or donate qr code , don't use absolute url like /favicon.ico, please use relative url like favicon.ico or donate/alipay.png

Menu Icons

You can configure the menu according to the icons of Iconfont, the following is configuration.

menuIcons:
  enable: true  
  home: icon-home-fill
  archives: icon-archives-fill
  categories: icon-folder
  tags: icon-tags
  repository: icon-project
  books: icon-book-fill
  links: icon-friendship
  about: icon-cup-fill

TOC

enable toc

  # config
  config:
    toc: true

TODO

• TOC
• pagination
• Multilingual

Multilingual

Translations are collected from the themes/even/i18n/ folder (built into the theme), as well as present in i18n at your root of project.

You can specify defaultContentLanguage to use translations.

defaultContentLanguage: zh # en,fr...

Currently supports English and Chinese, you can see en.yml and zh.yml under pure/i18n. If you want to support other language, you can copy any yml file under i18n and rename to new language, then feel free to translate.

Changelog

We will maintain a changelog in a dedicated CHANGELOG.MD file

License

Released under the MIT License.

Acknowledgements

• hexo-theme-pure

• hugo-theme-even

• @xiaoheiAh - hugo-theme-pure