为 Hugo 博客安装 Tranquilpeak 响应式主题，集成评论、统计与图片画廊等服务

方案简介

Tranquilpeak 是一个为 Hugo 博客框架打造的高颜值响应式主题，由 Hexo 版本移植而来（Version 0.5.3-BETA，基于 Hexo 版本 3.1.0，兼容 Hugo v0.53）。它解决的问题很简单：让使用 Hugo 静态站点生成器的作者无需自行设计前端，就能获得一个功能完整的博客界面，包括可配置的侧边栏菜单、标签/分类/归档筛选页、封面背景图、图片画廊、代码高亮、文章目录等能力，同时通过配置即可接入 Disqus 评论、Google analytics 统计、Gravatar 头像、Facebook Insights 等外部服务。适合两类人群：一是想直接使用原版主题快速建站的 Hugo 用户；二是在此基础上创建自己定制版本的开发者。

亮点与能力

• 完全响应式，针对平板与手机优化
• 可配置的侧边栏菜单
• 标签、分类和归档筛选页面
• 背景封面图与文章缩略图/封面图
• 支持 Open Graph protocol
• 易于自定义（字体、颜色、布局元素、代码配色等）
• 支持国际化（i18n）
• 文章功能：响应式视频与图片、分享选项、GitHub 主题代码高亮（可自定义）、图片画廊、FancyBox 图片标签、宽图、表格化代码块、高亮文本、警告框、目录

组成与分工

• Hugo：静态站点生成器，主题的运行载体，兼容 v0.53
• Git：用于将主题仓库克隆到站点 themes 目录
• Disqus：集成的评论服务
• Google analytics：站点访问统计
• Gravatar：头像服务
• Facebook Insights：Facebook 数据分析
• FancyBox：图片画廊/灯箱展示

前置要求

• Hugo v0.53（材料标注的兼容版本）
• Git（用于克隆主题仓库）
• 如果是第一次使用 Hugo，请先阅读 Hugo 官方文档

实施步骤

1. 进入 Hugo 站点目录并安装主题

shell
mkdir themes
cd themes
git clone https://github.com/kakawait/hugo-tranquilpeak-theme.git

2. 参考示例站点

安装成功后，建议查看 exampleSite 目录，其中包含一个配置好 Tranquilpeak 主题、可直接作为起点的可用 Hugo 站点。

3. 修改配置文件

查看 config.toml，学习如何定制你的站点，可以随意调整各项设置。更多安装与配置信息见用户文档。

使用与配置要点

• 通读用户文档，它简短且有助于发现主题的所有功能与可能性，尤其是 writing posts（撰写文章）部分
• 通过 exampleSite 的 config.toml 学习并调整站点自定义设置
• 可访问在线 Demo 验证主题实际效果：https://tranquilpeak.kakawait.com

注意事项与常见问题

• alpha 或 beta 版本期间，配置文件可能出现破坏性变更，可通过 breaking changes 标签追踪，迁移方法见 CHANGELOG.md
• 相比原 Hexo 版本，Algolia 搜索和分页自定义（tagPagination、categoryPagination、archivePagination）尚未实现
• 受 Hugo 限制，按年（/archives/2015）或按月（/archives/2015/01）的归档页无法实现

优缺点

• ✓ 完全响应式适配移动端
• ✓ 集成多种评论统计服务
• ✕ Hexo 移植版功能有缺失
• ✕ alpha/beta 期配置可能有破坏性

出处

本方案挖掘自开源项目 kakawait/hugo-tranquilpeak-theme，方案内容与实施命令均来自其 README 原文。