分类: 教程

诊断从一次干净的生产构建开始： BASH hugo --gc --minify --logLevel info 消费端的构建命令不应该调用 npm、PostCSS 或 Autoprefixer，也不应该下载主题的浏览器资源。如果日志里出现这些，说明配置里混进了上游 Docsy 的流程。 构建问题 Hugo 不是 Extended 版本或版本过旧 BASH hugo version 输出必须包含 extended，版本不低于 0.160.1。 如果 shell、编辑器、CI runner 或容器仍 …

容器不是必需的——OINK 只要求 Hugo Extended。适合用容器的情况：团队要固定工具链版本，或者不想在每台开发机上装 Hugo。 构建镜像 Dockerfile DOCKERFILE FROM debian:bookworm-slim ARG HUGO_VERSION=0.164.0 ARG GO_VERSION=1.25.5 ARG TARGETARCH RUN apt-get update \ && apt-get install -y …

pgsty/oink.pgsty.com 是 OINK 的双语示例兼回归站点。它有意比一个最小消费站点更完整——把它当参考，然后删掉产品用不到的部分。 适合这条路径的情况：你想要一个开箱即用的双语结构，不介意先删再改。想从零精确控制每一项，走创建站点。 克隆并构建 BASH git clone https://github.com/pgsty/oink.pgsty.com.git product-docs cd product-docs hugo --gc --minify 已提交的 …

Hugo 从 hugo.yaml、hugo.toml 或 hugo.json 读取站点级设置。OINK 项目站点用 YAML，因为多语言菜单和主题选项以 YAML 形式更好读、也更好评审。 这一页覆盖让站点跑起来所必需的配置。导航菜单、多语言细节和版本管理见站点配置。 完整最小配置 hugo.yaml YAML 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 …

这一页从零建一个最小双语站点。如果你想要一个已经配置完整的参考，直接看项目站点。 建立骨架 BASH hugo new site --format yaml my-docs cd my-docs hugo mod init github.com/example/my-docs hugo mod get github.com/pgsty/[email protected] 最小配置 把下面的内容存为 hugo.yaml。这是能跑起来的最小集合，逐项含义见基础配置： hugo.yaml YAML title: …

OINK 以 Hugo Module github.com/pgsty/oink 发布。推荐所有站点使用模块方式——它是唯一能让 Hugo 自己解析版本、校验 checksum、并在 go.sum 里留下审计记录的方式。 另外三种方式面向特定约束：网络隔离、平台要求完整源码树、或者组织内部需要评审主题副本。它们都在其他安装方式一节。 前置条件 模块方式需要 Git、Go 和 Hugo Extended 0.160.1 或更高版本： BASH git --version go version …

OINK 是一个把浏览器运行时随主题一起发布的 Hugo 主题。消费站点只需要 Hugo Extended：不装 Node.js、不跑 PostCSS、不依赖 CDN，构建期间也不会远程拉取主题资源。 这一章讲什么 按顺序读完这七页，你会得到一个可以部署的双语文档站： 环境准备 , 5 分钟 装 Hugo Extended，确认版本带 extended 标记。Git 和 Go 是否需要取决于你怎么获取主题。 安装 OINK , 5 分钟 推荐用 Hugo Module 固定一个版本。另外三种发行 …

消费端唯一必需的工具是 Hugo Extended。是否还需要 Git 和 Go，取决于你用哪种方式获取主题。 安装 Hugo Extended 安装 0.160.1 或更高版本。项目站点当前的验证基线是 0.164.0。 按平台参照 Hugo 官方安装指南，装完之后核对实际选中的二进制： BASH hugo version 输出必须包含 extended： CONSOLE $ hugo version hugo v0.164.0+extended+withdeploy darwin/arm64 …