文档站本地预览
使用固定的 OINK 模块版本预览和检查 Hugo 文档站。
检查本地工具链
使用仓库 go.mod 和 CI 配置指定的工具版本。在文档仓库根目录执行以下命令,检查工具链和主题版本:
可选:终端播放器用法示例
版本检查使用上方可复制的命令即可。此处仅供维护者了解播放器用法;交互操作、启动过程和排障演示才适合录制。
修改 Markdown 中的 file、title、speed 可以更换文件、标题和速度;命令或输出变化时应重新录制 .cast。
录像实际录制于 2026-10-11,使用 Hugo 0.165 Extended、Go 1.27.1 和 OINK 1.2.0。
播放速度为原速的 0.1 倍,便于阅读简短输出;录像文件由本站本地提供。
文档工具链与主题版本检查实录
预览与验证
在仓库根目录启动本地预览:
打开本地站点,检查所改页面的中英文版本。
执行遇到警告即失败的严格构建:
包装脚本会先生成版本导航配置,再启动 Hugo。可通过 -p 指定预览端口,例如 scripts/hugo.sh server -p 8080。
完整的贡献检查和主题升级流程见仓库中的 贡献指南和 OINK 升级指南。