简介 on OINK

OINK 是什么

Mon, 01 Jan 0001 00:00:00 +0000

OINK 是一款独立的 Hugo 主题，用于搭建中大型技术文档站。它从 Docsy 演化而来：保留 Docsy 的内容模型与多语言行为，替换外壳、导航、搜索与内容组件。

消费站点的构建依赖只有一个 Hugo Extended 二进制，不需要 Node.js、npm 或 PostCSS，也不请求 CDN。Bootstrap、Font Awesome、字体、本地搜索、图表与 API 文档运行时都提交在主题仓库里，只在页面用到时下发。

亮点特性

Mon, 01 Jan 0001 00:00:00 +0000

本页逐条列出 OINK 与普通 Hugo 主题的差别，每条末尾给出讲它的指南页。要立即安装，见十分钟上手。

组件写在 Markdown 里

提示块是 > [!NOTE] 块引用（十种语义类型加一个中性折叠块），参数表是表格加一行 {.fields}，步骤与卡片是列表加 {.steps} / {.cards}，图注是图片下面一行 {caption="…"}。标签页是几个相邻围栏各带一个 {tab="…"}；文件树、画廊、Mermaid、ECharts 是以语言命名的数据围栏。这些写法在 GitHub 或普通 Markdown 阅读器中退化为块引用、表格、列表与代码块，内容不丢失。

Case 导览

Mon, 01 Jan 0001 00:00:00 +0000

正式的 Case 案例库把十五个生产站点整理成可复用的实现模式，首页展示的也是同样这十五个。它们全都使用 OINK，本站本身也作为自举案例列入。

当你已经知道自己要搭建哪类站点时，可以从这里开始：先通过案例了解架构与取舍，再沿页面链接进入具体配置文档。案例中的数量描述对应盘点时的快照，不是对持续变化的线上站点作永久承诺。

开源许可与致谢

Mon, 01 Jan 0001 00:00:00 +0000

OINK 由三层材料组成：主题源码、文档内容、随主题分发的第三方资源。三者各自的许可证不会被重新授权成一份统一作品。下面每张表都指向仓库里的权威文件，摘要与许可证原文不一致时以文件为准。