构建与发布

本地预览

cd /home/gitbook/docs.liliang.xyz
npx honkit serve
# 默认监听 http://localhost:4000,边改边刷新

服务器上没有浏览器,本地预览更常用的是在自己电脑上编辑后把 Markdown 传到服务器再构建。

构建并发布

bash /home/gitbook/docs.liliang.xyz/build.sh

脚本做两件事:npx honkit build 生成静态文件到 _book/,再 rsync 同步到 nginx 站点根目录 /home/wwwroot/docs.liliang.xyz/,无需重载 nginx。

线上环境备忘

依赖说明

• honkit 通过项目内 package.json 本地安装,经 npm overrides 把 undici 钉在 v6 以兼容系统 Node 18(undici ≥ 7 需要 Node 20 的全局 File 对象)。
• 升级 honkit 后若报 File is not defined,先检查 overrides 是否还在。