设计与开发 on OINK

架构契约

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

OINK 0.6.0 契约

这是随 OINK 0.6.0 正式发布的架构契约。本页是权威中文源文件，与英文版本一同维护在 content/docs/design/。

仓库与装配

仓库根目录是一个完整的 Hugo 模块与主题，不是站点，也不是 npm workspace。 Hugo Extended 负责编译 SCSS 与模板。浏览器运行时与第三方资源都已提交到仓库，因此普通构建不会访问网络。公开的双语文档、示例与浏览器测试位于同级的 oink.pgsty.com 仓库；主题仓库只在 tests/site/ 中保留范围明确的内部回归夹具，不再维护独立的公开示例面。

组件契约

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

OINK 0.6.0 契约

这是随 OINK 0.6.0 正式发布的组件契约。本页是权威中文源文件，与英文版本一同维护在 content/docs/design/。

教程与完整示例位于面向读者的组件专栏。本页定义这些指南所依赖的 API 与行为。

创作模型

一个区块加属性便能表达组件时，使用普通 Markdown；需要复合正文或 Markdown 无法携带的事实时，使用 shortcode。OINK 没有并行的组件注册表。原生形态要求：

外壳与导航契约

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

OINK 0.6.0 契约

这是随 OINK 0.6.0 正式发布的外壳与导航契约。本页是权威中文源文件，与英文版本一同维护在 content/docs/design/。

关注点	权威来源
全局导航	Hugo `menus.main`
Docs / Book 侧栏与翻页	内容树或 `data/docs_nav.json`
根栏目切换器	解析后的顶层内容根
内容发现	各语言的本地搜索索引
页面与命令面板操作	共享操作注册表

任何功能都不能引入另一套菜单或页面树。菜单只允许一层子项交互；更深层级会警告，并平铺到带链接的分组标题下。外部链接使用 target="_blank" rel="noopener noreferrer"；内部链接保持语言与子路径感知。

落地页契约

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

OINK 0.6.0 契约

这是随 OINK 0.6.0 正式发布的落地页契约。本页是权威中文源文件，与英文版本一同维护在 content/docs/design/。

共享规则见架构契约与组件契约；迁移行为属于迁移边界。

外壳与数据

任何普通页面都可以声明 layout: landing。它渲染顶部导航栏、全宽画布与页脚，不显示 docs 侧栏或 TOC 导轨。首页继续把 data/home/<lang>.yaml 作为兼容的创作路径，并通过同一个渲染器处理。

OINK 迁移边界

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

OINK 0.6.0 契约

这是随 OINK 0.6.0 正式发布的迁移契约。本页是权威中文源文件，与英文版本一同维护在 content/docs/design/。

这是源码与配置指南，不是版本发布流水账。本地源码、提交、标签、推送、消费站点固定版本、部署与生产一致仍是彼此独立的状态。面向读者的升级流程见版本升级。

设计与开发 on OINK

架构契约

仓库与装配

组件契约

创作模型

外壳与导航契约

权威来源与导航

落地页契约

外壳与数据

OINK 迁移边界