1 从一个能运行的站点开始

安装唯一必需的工具，启动本地预览，在调整设计前先建立可见的基线。

好的教程首先要给读者一个看得见的结果。对 OINK 而言，这个结果是由 Hugo Extended 在本地提供的官方 Starter——此时还没有改标识、配色、语言组合或内容架构。

明确结果

完成本章时，你应该拥有英文、中文、法语首页，可用的 Docs、Blog、Book 路由，本地搜索，以及颜色模式控件。这条小基线足以在后续工作中区分内容问题、主题问题与部署问题。

当前 Starter 需要 Git、Go 1.27 或更新版本，以及 Hugo Extended 0.165.0 或更新版本。 OINK 声明的较低兼容下限仍是 0.160.1，但 Starter 与它的 workflow 有意固定当前持续测试工具链。不需要 Node.js。

$ go version
go version go1.27.0 darwin/arm64
$ hugo version
hugo v0.165.0+extended+withdeploy darwin/arm64

真实项目应通过 GitHub 的 Use this template 操作创建仓库。只在本地评估原始模板时，克隆并启动 Hugo：

$ git clone https://github.com/pgsty/oink-starter.git my-docs
$ cd my-docs
$ hugo server

打开 Hugo 输出的地址，修改 data/home/en.yaml 里的一句话，再确认浏览器已经显示变更。一个能对内容修改作出响应的预览，比终端里只显示“服务已启动”更有证明力。

在开始定制前，记录四个事实：Hugo 版本、go.mod 中的主题版本、正在评审的 commit，以及你实际打开的路由。第 2 章会在不丢失这条基线的前提下，把运行中的站点组织成内容树。

完整分层流程见使用 OINK Starter，不采用模板的安装方式见从零建站。