为 Hexo 博客套用 Tranquilpeak 响应式主题并集成评论、统计、搜索服务

方案简介

Tranquilpeak 是 Hexo 博客框架的一个华丽响应式主题。它解决的是 Hexo 用户默认主题功能单一、外观平淡的问题：安装该主题后即可获得完全响应式的布局、可自定义的侧边栏菜单、标签/分类/归档过滤页面、背景封面图、精美关于页，以及对 Open Graph 协议和国际化（i18n）的支持。

此外，主题还集成了 Disqus 评论、Google Analytics 与百度统计、Gravatar 头像、Algolia 搜索、Facebook Insights、Gitment 与 Gitalk 等服务，开箱即用，适合使用 Hexo 搭建个人博客、希望快速获得美观界面和完整第三方服务能力的开发者。

亮点与能力

• 完全响应式，针对平板与手机优化
• 可自定义侧边栏菜单
• 提供标签、分类、归档过滤页面
• 支持背景封面图与精美关于页
• 支持 Open Graph 协议与国际化（i18n）
• 文章支持缩略图、封面图、响应式视频与图片、图片画廊、目录
• 代码高亮使用 GitHub 主题且可自定义
• 集成 Disqus、Google Analytics、百度统计、Gravatar、Algolia、Facebook Insights、Gitment、Gitalk 服务

组成与分工

• Hexo：博客框架，主题的运行载体，通过 _config.yml 的 theme 变量启用主题
• Tranquilpeak：主题本体，提供响应式布局、侧边栏、文章增强等功能
• Disqus / Gitment / Gitalk：评论系统集成
• Google Analytics / 百度统计 / Facebook Insights：访问统计分析
• Algolia：站内搜索（依赖清单中的 algoliasearch）
• Gravatar：头像服务
• npm / Node.js：安装主题依赖并执行生产构建（npm install && npm run prod）

前置要求

• 已搭建好的 Hexo 博客
• Node.js 与 npm 环境（主题依赖通过 npm 安装）

实施步骤

1. 下载主题

下载最新版本压缩包：

bash
https://github.com/LouisBarranqueiro/hexo-theme-tranquilpeak/archive/main.zip

2. 放置主题

将文件夹重命名为 tranquilpeak，放到 Hexo 博客的 themes 目录下。

3. 启用主题

修改 Hexo 配置文件 _config.yml，将 theme 变量设置为 tranquilpeak。

4. 安装依赖并构建

进入 tranquilpeak 目录执行：

bash
npm install && npm run prod

5. 配置主题

阅读文档完成主题的具体配置。

使用与配置要点

• 通过修改 _config.yml 中 theme 变量启用主题
• 通过主题文档配置字体、颜色、布局元素、代码配色等自定义项
• 配置集成的服务：Disqus 评论、Google Analytics、百度统计、Algolia 搜索、Gitalk/Gitment 评论等
• 可参考官方 Demo 验证效果

注意事项与常见问题

• 主题构建需在 tranquilpeak 目录内执行 npm install && npm run prod，依赖较多（grunt、sass 等），首次安装耗时较长
• 具体服务（Disqus、Algolia 等）需按文档分别配置对应账号密钥
• 主题采用 GNU General Public License v3.0 许可证发布
• 欢迎各类贡献（增强、功能、文档与代码改进、bug 报告），详情见贡献指南

优缺点

• ✓ 全响应式适配移动端
• ✓ 内置多服务集成免开发
• ✕ 仅适用于 Hexo 框架
• ✕ 需手动构建主题资源

出处

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