本地优先 · 仅依赖 Hugo 的技术文档主题

OINK

继承 Docsy 的功能与 Fumadocs 的设计，提供开箱即用，本地优先的工程文档体验

价值主张

工程文档所需的能力，默认就绪

从部署、检索和多版本管理，到富内容表达，OINK 保持简洁素雅、本地优先，并只按页面加载所需能力。

01 / 工程文档

◇ 从第一次构建到长期维护都没有额外阻力

内容团队可以把时间用在文档上，而不是重复搭建站点基础设施。

02 / 设计与能力

◇ 现代文档视觉与成熟内容能力兼得

界面保持克制，成熟文档站所需的功能一项不少。

03 / 本地优先

◇ CSS、JavaScript、字体与运行时全部本地化

开发、CI 与生产环境使用同一条可确定的构建路径。

build.sh

# 一条命令，一份确定性输出
$ hugo --gc --minify
✓ 本地资源已打包
✓ 多语言路由已生成
✓ public/ 可以部署

04 / 功能扩展

◇ 把工程内容需要的表达能力直接带进主题

富内容能力属于主题，普通页面不会因此背上额外负担。

主题原则

OINK 直接定制 Docsy，不把核心设计藏在增量皮肤后面。

品牌、导航、首页、footer 与组件均使用清晰的站点数据和参数。

保留 Docsy 的成熟能力，也保留从上游摘取修复与新特性的路径。

从可运行的双语 Starter 开始。复制配置，替换内容，然后只用 Hugo 构建。