Hugo 日记风格博客主题，支持评论、暗色模式、多语言等第三方集成

方案简介

Hugo Theme Diary 是一个从 SumiMakito/hexo-theme-Journal 移植而来的 Hugo 博客主题，定位为「隻言片語・於此匯聚 / Moments piled up」的日记式写作平台。它面向使用 Hugo 搭建个人博客/随笔站点的用户，通过集成 Gitalk、Waline、Disqus、LiveRe、Twikoo 等第三方评论服务以及 Google Search、Analytics 等，提供开箱即用的静态博客方案。

亮点与能力

• 可定制：借助详细的项目 wiki 易于定制
• 自适应：对移动端与宽屏友好
• 集成丰富：第三方服务集成（Gitalk、LiveRe、Disqus、Waline、Twikoo、Google Search、Analytics 等）
• 便利：带滚动监听的目录（Table of Contents with scroll spy）
• 专业：LaTeX 支持（默认关闭）
• 优雅：暗色模式（自动或手动切换）
• 国际化：支持英、简中、繁中、法、德、巴西葡语
• 性能：1.3.0 移除 jQuery 及冗余脚本，性能提升

组成与分工

• Hugo：静态站点生成器，主题运行的基础框架
• Git：以 submodule 方式获取与更新主题
• Gitalk / LiveRe / Disqus / Waline / Twikoo：可选的第三方评论服务
• Google Search / Analytics：站内搜索与访问统计

实施步骤

若站点使用 Git 做版本控制，在 Hugo 站点根目录执行以下步骤。

1. 获取主题目录

bash
git submodule add https://github.com/AmazingRise/hugo-theme-diary.git themes/diary

2. 更新 git 仓库

bash
git submodule update --remote --merge

3. 运行示例站点

在 themes/diary/exampleSite 目录下执行：

bash
hugo server --themesDir ../..

使用与配置要点

个性化配置参考 exampleSite/config.toml，可修改配置项、第三方服务、写作与样式等。详细定制说明见项目 wiki。

注意事项与常见问题

• LaTeX 支持默认是关闭的，需要手动启用。
• 更多定制细节请查阅项目 wiki。

优缺点

• ✓ 移动端与宽屏自适应
• ✓ 暗色模式自动/手动切换
• ✕ LaTeX 默认关闭
• ✕ 详细定制需查阅 wiki

出处

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