<!-- TOC depthFrom:1 depthTo:6 withLinks:1 updateOnSave:1 orderedList:0 -->
- [Cactus Plus ](#cactus-plus )
- [截图 ](#截图 )
- [安装 ](#安装 )
- [示例站点 ](#示例站点 )
- [配置文件 ](#配置文件 )
- [关于页面 ](#关于页面 )
- [标签页 ](#标签页 )
- [头像 ](#头像 )
- [隐藏页面 ](#隐藏页面 )
- [Disqus 评论 ](#disqus-评论 )
- [多说评论 ](#多说评论 )
- [不使用评论系统 ](#不使用评论系统 )
- [Google Analytics ](#google-analytics )
- [百度统计 ](#百度统计 )
- [社交链接 ](#社交链接 )
- [部署主题 ](#部署主题 )
- [License ](#license )
- [鸣谢 ](#鸣谢 )
<!-- /TOC -->
# Cactus Plus
[English Document ](https://github.com/nodejh/hugo-theme-cactus-plus/blob/master/README.md ) | [中文文档 ](https://github.com/nodejh/hugo-theme-cactus-plus/blob/master/README_zh-cn.md )
Cactus Plus 是一个根据 [Cactus ](https://github.com/digitalcraftsman/hugo-cactus-theme ) 改编的简约主题。
**Cactus Plus 的主要更新如下：**
+ ** 添加了标签页**
+ ** 添加了归档页**
+ ** 集成了 [Disqus ](https://disqus.com/ ) 和[多说](http://duoshuo.com/)评论系统**
+ ** 提供了 Google Analytics 和百度统计**
+ ** 文章目录**
示例网站： [http://nodejh.com ](http://nodejh.com )。
## 截图
**首页**
**标签页**
**归档页**
## 安装
进入 `hugo` 的站点目录运行下面的命令：
```
$ cd themes
$ git clone https://github.com/nodejh/hugo-theme-cactus-plus.git
```
## 示例站点
[`exampleSite` ](https://github.com/nodejh/hugo-theme-cactus-plus/tree/master/exampleSite ) 是本主题的一个示例站点，里面有配置文件、关于页面的一些示例。
## 配置文件
本主题提供了一个示例配置文件是 [`exampleSite` ](https://github.com/nodejh/hugo-theme-cactus-plus/tree/master/exampleSite ) 目录里的 [`config.toml` ](https://github.com/nodejh/hugo-theme-cactus-plus/blob/master/exampleSite/config.toml ) 文件。
配置文件中对大部分配置都有详细的注释说明，复制该文件到站点目录下，根据自己的情况修改即可。
## 关于页面
使用关于页面首先要在你的站点目录的 `content` 目录下创建一个 `about` 目录，然后再创建一个 `_index.md` 文件，编写该文件即可。
你也可以参考本主题示例站点中的关于页：[`exampleSite/content/about/index.md`](https://github.com/nodejh/hugo-theme-cactus-plus/blob/master/exampleSite/content/about/index.md)。
## 标签页
本主题也提供了 `标签页` 功能。
在 `content` 目录下新建一个名为 `tags` 的目录，然后在次目录创建一个名为 `_index.md` 的文件，写入下面的内容，注意设置 `hidden = true` 即可：
```markdown
+++
date = "2015-06-20T14:02:37+02:00"
title = "Tags"
hidden = true
+++
```
## 头像
你需要将 [images ](https://github.com/nodejh/hugo-theme-cactus-plus/blob/master/static/images/ ) 目录下的 `avatar.png` 、`avatar@2x.png` 和 `favicon.ico` 都替换为你自己的图像。
## 隐藏页面
如果你不想让一个页面出现在文章列表中，只需要在 markdown 文件的 `frontmatter` 中添加 `hidden = true` 即可。
然后你可以在其他任何地方通过链接来引用该页面，如在菜单中放置一个链接。
关于页面就是这么实现的。
## Disqus 评论
本主题提供两种评论系统， `config.toml` ](https://github.com/nodejh/hugo-theme-cactus-plus/blob/master/exampleSite/config.toml ) 中进行设置。
设置 `disqusShortname` 为你的 Disqus ID， `enableDisqus` 设置为 `true` 即可开启 Disqus 评论。
将 `enableDisqus` 设置为 `false` 则不启用 Disqus 评论。
## 多说评论
由于在中国大陆无法使用 Disqus，
## 不使用评论系统
由于使用第三发评论系统会使网站加载速度变慢，所以也可以不使用评论系统。只需要将 `enableDisqus` 和 `enableDuoshuo` 都设置为 `false` 即可。
然后我的博客由于同步到了 Github Issues， `enableGithubIssuesTips = true` 即可。当然，一般是不需要这么做的，这可能只是我个人需求。具体效果可以参考我的博客 [http://nodejh.com ](http://nodejh.com )。
## Google Analytics
该主题默认使用了 Google Analytics。如果要禁用 Google Analytics， `config.toml` ](https://github.com/nodejh/hugo-theme-cactus-plus/blob/master/exampleSite/config.toml ) 中的 `enableGoogleAnalytics = false` 。
## 百度统计
该主题同样也提供了百度统计，主要是方便中国大陆用户使用。开启百度统计的方式，首先需要设置 [`config.toml` ](https://github.com/nodejh/hugo-theme-cactus-plus/blob/master/exampleSite/config.toml ) 中的 `enableBaiduAnalytics = true` ，然后将 `baiduAnalytics` 改为在百度统计后台获取的 `统计代码` ，形如 `39843ea392201290bd6f76173d2e0000` 。
## 社交链接
本主题的社交链接是字体图标的样式，并放置在了页面底部。你可以通过在 `config.toml` 的 `social` 模块中修改添加你的社交链接。社交链接提供了两种字体图标，选用其中一种即可：
- [Font awesome ](https://fortawesome.github.io/Font-Awesome/ ) 或
- [Mono social icons ](https://github.com/drinchev/monosocialiconsfont )
`iconFont` 变量即字体图标库，可以是 `font-awesome` 或 `mono-social` 。
如果使用的是 `Mono social icons` 即 `iconFont = "mono-social"` ，则图标还有三种可选样式：`-circle`、`rounded`、或默认 `empty` 。
## 部署主题
配置完成之后，就可以使用下面的命令来启动 hugo 服务编译 markdown 文件生成静态站点：
```
$ hugo server
```
然后在浏览器地址栏输入 [`localhost:1313` ](http://localhost:1313 ) 来访问站点。
## License
[MIT ](https://github.com/nodejh/hugo-theme-cactus-plus/blob/master/LICENSE.md )
## 鸣谢
特别感谢 [digitalcraftsman ](https://github.com/digitalcraftsman ) 的 [Cacuts ](https://github.com/digitalcraftsman/hugo-cactus-theme ) 主题：
- [hugo-cactus-theme ](https://github.com/digitalcraftsman/hugo-cactus-theme )
