050de56dbe | 8 years ago | |
---|---|---|
archetypes | 8 years ago | |
exampleSite | 8 years ago | |
images | 8 years ago | |
layouts | 8 years ago | |
static | 8 years ago | |
.gitignore | 8 years ago | |
LICENSE.md | 8 years ago | |
README.md | 8 years ago | |
README_zh-cn.md | 8 years ago | |
theme.toml | 8 years ago |
README.md
Cactus Plus
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
.
For example:
+++
date = "2015-06-20T14:02:37+02:00"
title = "Tags"
hidden = true
+++
## Avatar
Furthermore, you should replace the [avatar placeholder](https://github.com/nodejh/hugo-theme-cactus-plus/blob/master/static/images/) 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`](https://github.com/nodejh/hugo-theme-cactus-plus/blob/master/exampleSite/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`](https://github.com/nodejh/hugo-theme-cactus-plus/blob/master/exampleSite/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`](https://github.com/nodejh/hugo-theme-cactus-plus/blob/master/exampleSite/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`](https://github.com/nodejh/hugo-theme-cactus-plus/blob/master/exampleSite/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`](https://github.com/nodejh/hugo-theme-cactus-plus/blob/master/exampleSite/config.toml). You can choose between two icon fonts:
- [Font awesome](https://fortawesome.github.io/Font-Awesome/) or
- [Mono social icons](https://github.com/drinchev/monosocialiconsfont)
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`](http://localhost:1313) in the address bar of your browser.
## License
This theme is released under the MIT license. For more information read the [license](https://github.com/nodejh/hugo-theme-cactus-plus/blob/master/LICENSE.md).
## Acknowledgements
Thanks to
- [hugo-cactus-theme](https://github.com/digitalcraftsman/hugo-cactus-theme)