You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
hugo-theme-mini/README_zh-cn.md

5.4 KiB

Cactus Plus

English Documention | 中文文档

Cactus Plus 是一个根据 Cactus 改编的简约主题。我在 Cactus的基础上做了一些修改,主要是添加了归档页和标签页、添加了百度统计、修改了部分样式。总的来说该主题具有以下特点:

  • 自定义关于页面
  • 标签页
  • 归档页
  • Disqus 评论
  • 多说评论
  • Google Analytics
  • 百度统计
  • RSS 订阅
  • 语法高亮

Screenshot

Screenshot

安装

进入 hugo 的站点目录运行下面的命令:

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

示例站点

exampleSite 是本主题的一个示例站点,里面有配置文件、关于页面的一些示例。

配置文件

本主题提供了一个示例配置文件是 exampleSite 目录里的 config.toml 文件。

配置文件中对大部分配置都有详细的注释说明,复制该文件到站点目录下,根据自己的情况修改即可。

关于页面

使用关于页面首先要在你的站点目录的 content 目录下创建一个 about 目录,然后再创建一个 index.md 文件,编写该文件即可。

你也可以参考本主题示例站点中的关于页:exampleSite/content/about/index.md

头像

你需要将 images 目录下的 avatar.pngavatar@2x.pngfavicon.ico 都替换为你自己的图像。

隐藏页面

如果你不想让一个页面出现在文章列表中,只需要在 markdown 文件的 frontmatter 中添加 hidden = true 即可。

然后你可以在其他任何地方通过链接来引用该页面,如在菜单中放置一个链接。

关于页面就是这么实现的。

Disqus 评论

本主题提供两种评论系统Disqus 和多说。使用 Disqus 评论需要在 config.toml 中进行设置。

设置 disqusShortname 为你的 Disqus ID并将 enableDisqus 设置为 true 即可开启 Disqus 评论。

enableDisqus 设置为 false 则不启用 Disqus 评论。

多说评论

由于在中国大陆无法使用 Disqus所以本主题提供了多说评论系统。多说评论系统的配置和 Disqus 配置基本一致。

不使用评论系统

由于使用第三发评论系统会使网站加载速度变慢,所以也可以不使用评论系统。只需要将 enableDisqusenableDuoshuo 都设置为 false 即可。

然后我的博客由于同步到了 Github Issues所以也同时在主题中提供了跳转到 Github Issues 评论的文字提示。只需要设置 enableGithubIssuesTips = true 即可。当然,一般是不需要这么做的,这可能只是我个人需求。具体效果可以参考我的博客 http://nodejh.com

Google Analytics

该主题默认使用了 Google Analytics。如果要禁用 Google Analytics只需要设置 config.toml 中的 enableGoogleAnalytics = false

百度统计

该主题同样也提供了百度统计,主要是方便中国大陆用户使用。开启百度统计的方式,首先需要设置 config.toml 中的 enableBaiduAnalytics = true,然后将 baiduAnalytics 改为在百度统计后台获取的 统计代码,形如 39843ea392201290bd6f76173d2e0000

社交链接

本主题的社交链接是字体图标的样式,并放置在了页面底部。你可以通过在 config.tomlsocial 模块中修改添加你的社交链接。社交链接提供了两种字体图标,选用其中一种即可:

iconFont 变量即字体图标库,可以是 font-awesomemono-social

如果使用的是 Mono social iconsiconFont = "mono-social",则图标还有三种可选样式:-circlerounded、或默认 empty

部署主题

配置完成之后,就可以使用下面的命令来启动 hugo 服务编译 markdown 文件生成静态站点:

$ hugo server

然后在浏览器地址栏输入 localhost:1313 来访问站点。

License

MIT

鸣谢

特别感谢 digitalcraftsmanCacuts 主题: