hugo-theme-mini/README.md

• Cactus Plus
  • Screenshot
  • Installation
  • Example Site
  • The config file
  • About page
  • Tags page
  • Avatar
  • Hide pages
  • Disqus
  • Duoshuo
  • Disable Comment
  • Google Analytics
  • Baidu Tongji
  • Social link icons
  • Nearly finished
  • License
  • Acknowledgements

Cactus Plus

English Document | 中文文档

Cactus Plus is a minimalistic theme for bloggers based on the theme named Cactus.

Noteworthy updates of this Hugo theme are :

• a tags page
• an archive page
• both Disqus and Duoshuo comment-system
• both Google Analytics and Baidu Tongji for site analytics.

Here's the link to online demo: http://nodejh.com.

Screenshot

home page

tags page

archive page

Installation

$ cd themes
$ git clone https://github.com/nodejh/hugo-theme-cactus-plus.git

For more information read the official setup guide of Hugo.

Example Site

There is an example site with config file and markdown files in exampleSite directory.

The config file

Take a look inside the exampleSite folder of this theme. You'll find a file called config.toml.

To use it, copy the config.toml in the root folder of your Hugo site. Feel free to change strings as you like to customize your website.

About page

Use the about page to introduce yourself to your visitors. You can customize the content as you like in the /content/about/_index.md.

Tags page

Use the tags page to show all post's tags. You can create the file /content/tags/index.md and set hidden = true so that the page does not show on your home page or other lists of pages.

For example:

+++
date = "2015-06-20T14:02:37+02:00"
title = "Tags"
hidden = true
+++

Avatar

Furthermore, you should replace the avatar placeholder with a great image of yourself.

Hide pages

Pages can be hidden and don't appear in the post list on the homepage if you add the variable hidden = true to the frontmatter. This allows you to link from elsewhere, i.e. just the menu.

Disqus

This theme features a comment system powered by Disqus. Just add your Disqus-shortname to the config.toml and set enableDisqus = true, then let readers respond to your blog posts.

Duoshuo

This theme features a comment system powered by Duoshuo too. Duoshuo is mainly provide for Chinese users. Just add your Duoshuo-shortname to the config.toml and set enableDuoshuo = true.

Disable Comment

Just set both enableDisqus = false and enableDuoshuo = false if you want to disable comment.

Google Analytics

This theme use Google Analytics defalut. If you want to disable Google Analytics, just set enableGoogleAnalytics = false in config.toml.

Baidu Tongji

This theme alse features Baidu Tongji for Chinese users. To use Baidu Tongji you should set enableBaiduAnalytics = true and set baiduAnalytics to your Baidu Tongji Code which looks like 39843ea392201290bd6f76173d2e0000 in config.toml.

Social link icons

You can add a social link panel in the footer by adding entries to the social block in the config.toml. You can choose between two icon fonts:

• Font awesome or
• Mono social icons

Assign either font-awesome or mono-social to the iconFont variable. The Mono social icons offer three styles of icons: -circle, rounded, or default (empty).

Nearly finished

In order to see your site in action, run Hugo's built-in local server.

$ hugo server

Now enter localhost:1313 in the address bar of your browser.

License

This theme is released under the MIT license. For more information read the license.

Acknowledgements

Thanks to

• hugo-cactus-theme