查看双语项目站点

把独立 Oink 项目站点作为完整参考。

独立的 pgsty/oink.pgsty.com 仓库是完整的双语示例与回归站点。它有意比 starter 更全面:应把它作为参考,然后只保留产品真正需要的内容与配置。

克隆项目站点

Oink 主题公开发布后,可以直接克隆并构建站点:

git clone https://github.com/pgsty/oink.pgsty.com.git product-docs
cd product-docs
hugo --gc --minify

已提交的 go.mod 会固定 github.com/pgsty/oink。本地开发主题时,请把主题克隆为同级目录,并使用 Oink 快速开始记录的 workspace 命令。

运行站点检查

Hugo 本身即可构建站点。Node.js 只用于项目站点的格式、链接、翻译与回归检查:

npm install
npm test

打开生成的站点,分别检查中英文页面。请从具有译文的详情页使用语言切换器,不要只在首页测试。

替换示例身份

编辑 hugo.yamlconfig/ 下的文件,并替换:

  • 站点标题,以及各语言的标题与描述;
  • baseURL
  • 代码仓库与分支 URL;
  • 版权所有者与起始年份;
  • Logo 与品牌素材;
  • 中英文菜单标签。

不要创建 oink.* 参数命名空间。请使用 Hugo 的语言、菜单、模块、输出和 markup 设置,以及主题已经记录的参数。

替换示例内容

把每组译文放在一起:

content/docs/getting-started.md
content/docs/getting-started.zh.md

删除产品不需要的历史与回归内容。只有在页面不再引用后,才删除对应示例资源。

中文标题应显式使用英文页面实际渲染出的 ID:

## Configure search
## 配置搜索 {#configure-search}

将新站点纳入版本控制

发布派生站点前,请修改模块路径、仓库元数据与 remote。继续在 go.mod 中固定 Oink 版本。除非托管工作流有明确要求,否则不要提交生成的 public/ 产物。

后续步骤