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.3 KiB

Hugo Theme Cactus Plus

English Document | 中文文档

Cactus Plus 是在 Cactus 更改的一个简约主题。

特点

  • 更漂亮的样式
  • 添加了标签页
  • 添加了归档页
  • 集成了 Disqus 评论系统
  • 提供了 Google Analytics 和百度统计
  • 文章目录
  • Twitter Card

示例网站: http://nodejh.com

截图

首页

Screenshot

标签页

Screenshot

归档页

Screenshot

安装

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

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

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

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

然后可能你还需要用 hugo-theme-cactus-plus/archetypes/default.md 替换你的项目中的 archetypes/default.md

更多安装信息查看 Hugo 官方文档 setup guide

示例站点

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

文章摘要

Summary will show follow the post title title in home page.

摘要会显示在首页的文章标题下面。

如果你想用文章头信息中的 description 属性代替文章内容摘要,将 useDescriptionReplaceSummary 设置为 true 即可。

如果要使用文章内容摘要,你可能需要在文章中添加 <!--more--> 分割线来分割文章。分割线前面的字符会作为文章摘要。默认情况下Hugo 会截取内容的前 70 个字作为摘要。查看更多 https://gohugo.io/content-management/summaries/.

关于页面

使用关于页面首先要在你的站点目录的 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 评论。

社交链接

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

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

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

部署主题

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

$ hugo server

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

License

MIT