查看双语项目站点
把独立 Oink 项目站点作为完整参考。
独立的 pgsty/oink.pgsty.com
仓库是完整的双语示例与回归站点。它有意比最小消费站点更全面:应把它作为参考,然后只保留产品真正需要的内容与配置。
克隆项目站点
克隆项目站,即可使用其中固定的 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 命令。
运行站点检查
使用 Oink 的站点无论构建还是预览,都不需要 Node.js,也不需要安装 npm 软件包。只有在维护这个示例项目站点仓库,并运行格式、链接、翻译与回归检查时,才需要 Node.js 以及仓库中的 npm 开发依赖:
npm ci
npm test打开生成的站点,分别检查中英文页面。请从具有译文的详情页使用语言切换器,不要只在首页测试。
替换示例身份
编辑 hugo.yaml 与 config/ 下的文件,并替换:
- 站点标题,以及各语言的标题与描述;
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/ 产物。