用 fixit-cli 一条命令或模板仓库快速创建 FixIt 博客项目

方案简介

本方案是 FixIt 主题对评论系统的组合支持：作为 Hugo 博客主题，FixIt 内置了对十余种第三方评论服务的接入能力，包括 Disqus、Gitalk、Valine、Waline、Facebook comments、Telegram Comments、Commento、Utterances、Artalk、Twikoo、giscus 等，并支持通过模板块覆盖接入自定义评论系统。用户只需在站点配置中选择所需评论服务即可为静态博客补充动态评论能力。该方案适合已使用（或计划使用）FixIt 主题、希望为自己的静态博客挑选并接入合适评论系统的开发者。

亮点与能力

• 单条命令创建 FixIt 新项目（Starter Wizard）
• 基于 Hugo Modules 的快速启动模板仓库
• 基于 Git submodule 的快速启动模板仓库
• 一键生成多语言站点模板
• 基于主题定制的博客模板
• 性能优化（移动端 99/100、桌面端 100/100）
• 响应式布局、Light/Dark 模式、多语言支持
• PWA、内容加密、搜索（algolia/Fuse.js/Pagefind/CSE）等扩展功能

组成与分工

• Hugo：静态站点生成器，主题的运行基础
• FixIt 主题：博客外观与功能主体，基于 LoveIt、KeepIt、LeaveIt 主题发展而来
• fixit-cli：官方 CLI 工具，单条命令创建新项目
• hugo-fixit-starter：基于 Hugo Modules 的快速启动模板
• hugo-fixit-starter1：基于 Git submodule 的快速启动模板
• pnpx：执行 fixit-cli 的运行入口

前置要求

材料中明确给出的安装/创建命令为：

bash
pnpx fixit-cli create my-blog

即需要具备可运行 pnpx 的环境（pnpm 工具链）。若不走 CLI，也可直接使用模板仓库：

• A quick-start template base on Hugo Modules: hugo-fixit-starter
• A quick-start template base on Git submodule: hugo-fixit-starter1

实施步骤

1. 使用 Starter Wizard（推荐）

官方提供了 CLI 工具，单条命令即可创建新项目：

bash
pnpx fixit-cli create my-blog

2. 或使用模板仓库生成

点击 README 中 Templates 表格的 Generate link，直接在 GitHub 上生成包含 FixIt 主题的新仓库：

• 基于 Hugo Modules：hugo-fixit-starter
• 基于 Git submodule：hugo-fixit-starter1
• 多语言站点：docs 模板
• 自定义主题：Lruihao/hugo-blog 模板

3. 查阅文档逐步搭建

更详细的分步指南见官方 Quick Start 页面，路线为：Installation ➜ Getting Started ➜ Content Management ➜ Advanced Usage。

使用与配置要点

创建项目后可通过以下在线资源验证与学习：

• Docs：https://fixit.lruihao.cn 官方文档
• Test：https://demo.fixit.lruihao.cn/test/ 功能测试站
• Demo：https://demo.fixit.lruihao.cn 演示站
• Starter：https://hugo-fixit.github.io/hugo-fixit-starter/ 模板演示

更多实际案例可参考官方 Showcase 页面。

注意事项与常见问题

• main 分支包含 v1 代码，升级需参考官方 v1 migration guide
• Version 1.0.0 计划于 2027 年上半年发布，欢迎参与开发和讨论
• 主题基于 LoveIt、KeepIt、LeaveIt 三个原主题发展而来

优缺点

• ✓ 一条命令创建项目
• ✓ 模板一键生成仓库
• ✕ 需熟悉 Hugo 生态

出处

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