https://lxghost.github.io/zh/docs/design/Recent content in 设计与开发 on OINKHugozh-CNFri, 28 Aug 2026 00:08:16 +0800https://lxghost.github.io/zh/docs/design/architecture/Mon, 01 Jan 0001 00:00:00 +0000https://lxghost.github.io/zh/docs/design/architecture/<div class="td-callout td-callout--important" role="note"> <div class="td-callout__title"><i class="td-callout__icon fa-solid fa-circle-exclamation" aria-hidden="true"></i><span class="td-callout__label">OINK 0.8.0 契约</span></div> <div class="td-callout__body"> <p>这是随 OINK 0.8.0 正式发布的架构契约。本页是权威中文源文件，与英文版本 一同维护在 <code>content/docs/design/</code>。</p> </div> </div><h2 id="repository-and-assembly">仓库与装配 </h2> <p>仓库根目录是一个完整的 Hugo 模块与主题，不是站点，也不是 npm workspace。 Hugo Extended 负责编译 SCSS 与模板。浏览器运行时与第三方资源都已提交到仓库， 因此普通构建不会访问网络。公开的双语文档、示例与浏览器测试位于同级的 <code>oink.pgsty.com</code> 仓库；主题仓库只在 <code>tests/site/</code> 中保留范围明确的内部回归 夹具，不再维护独立的公开示例面。</p>https://lxghost.github.io/zh/docs/design/components/Mon, 01 Jan 0001 00:00:00 +0000https://lxghost.github.io/zh/docs/design/components/<div class="td-callout td-callout--important" role="note"> <div class="td-callout__title"><i class="td-callout__icon fa-solid fa-circle-exclamation" aria-hidden="true"></i><span class="td-callout__label">OINK 0.8.0 契约</span></div> <div class="td-callout__body"> <p>这是随 OINK 0.8.0 正式发布的组件契约。本页是权威中文源文件，与英文版本 一同维护在 <code>content/docs/design/</code>。</p> </div> </div><p>教程与完整示例位于面向读者的<a href="https://lxghost.github.io/zh/docs/components/">组件</a>专栏。本页定义这些 指南所依赖的 API 与行为。</p> <h2 id="authoring-model">创作模型 </h2> <p>一个区块加属性便能表达组件时，使用普通 Markdown；需要复合正文或 Markdown 无法携带的事实时，使用 shortcode。OINK 没有并行的组件注册表。原生形态要求：</p>https://lxghost.github.io/zh/docs/design/shell/Mon, 01 Jan 0001 00:00:00 +0000https://lxghost.github.io/zh/docs/design/shell/<div class="td-callout td-callout--important" role="note"> <div class="td-callout__title"><i class="td-callout__icon fa-solid fa-circle-exclamation" aria-hidden="true"></i><span class="td-callout__label">OINK 0.8.0 契约</span></div> <div class="td-callout__body"> <p>这是随 OINK 0.8.0 正式发布的外壳与导航契约。本页是权威中文源文件，与英文版本 一同维护在 <code>content/docs/design/</code>。</p> </div> </div><h2 id="authorities-and-navigation">权威来源与导航 </h2> <div class="td-table-scroll td-table-scroll--static"> <table> <thead> <tr> <th scope="col">关注点</th> <th scope="col">权威来源</th> </tr> </thead> <tbody> <tr> <td>全局导航</td> <td>Hugo <code>menus.main</code></td> </tr> <tr> <td>Docs / Book 侧栏与翻页</td> <td>内容树或 <code>data/docs_nav.json</code></td> </tr> <tr> <td>根栏目切换器</td> <td>解析后的顶层内容根</td> </tr> <tr> <td>内容发现</td> <td>各语言的本地搜索索引</td> </tr> <tr> <td>页面与命令面板操作</td> <td>共享操作注册表</td> </tr> </tbody> </table> </div> <p>任何功能都不能引入另一套菜单或页面树。菜单只允许一层子项交互；更深层级会警告， 并平铺到带链接的分组标题下。外部链接使用 <code>target=&quot;_blank&quot; rel=&quot;noopener noreferrer&quot;</code>；内部链接保持语言与子路径感知。</p>https://lxghost.github.io/zh/docs/design/landing/Mon, 01 Jan 0001 00:00:00 +0000https://lxghost.github.io/zh/docs/design/landing/<div class="td-callout td-callout--important" role="note"> <div class="td-callout__title"><i class="td-callout__icon fa-solid fa-circle-exclamation" aria-hidden="true"></i><span class="td-callout__label">OINK 0.8.0 契约</span></div> <div class="td-callout__body"> <p>这是随 OINK 0.8.0 正式发布的落地页契约。本页是权威中文源文件，与英文版本 一同维护在 <code>content/docs/design/</code>。</p> </div> </div><p>共享规则见<a href="https://lxghost.github.io/zh/docs/design/architecture/">架构契约</a>与 <a href="https://lxghost.github.io/zh/docs/design/components/">组件契约</a>；迁移行为属于 <a href="https://lxghost.github.io/zh/docs/design/migration/">迁移边界</a>。</p> <h2 id="shell-and-data">外壳与数据 </h2> <p>任何普通页面都可以声明 <code>layout: landing</code>。它渲染顶部导航栏、全宽画布与页脚， 不显示 docs 侧栏或 TOC 导轨。首页继续把 <code>data/home/&lt;lang&gt;.yaml</code> 作为兼容的创作 路径，并通过同一个渲染器处理。</p>https://lxghost.github.io/zh/docs/design/migration/Mon, 01 Jan 0001 00:00:00 +0000https://lxghost.github.io/zh/docs/design/migration/<div class="td-callout td-callout--important" role="note"> <div class="td-callout__title"><i class="td-callout__icon fa-solid fa-circle-exclamation" aria-hidden="true"></i><span class="td-callout__label">OINK 0.8.0 契约</span></div> <div class="td-callout__body"> <p>这是随 OINK 0.8.0 正式发布的迁移契约。本页是权威中文源文件，与英文版本 一同维护在 <code>content/docs/design/</code>。</p> </div> </div><p>这是源码与配置指南，不是版本发布流水账。本地源码、提交、标签、推送、消费站点 固定版本、部署与生产一致仍是彼此独立的状态。面向读者的升级流程见 <a href="https://lxghost.github.io/zh/docs/admin/upgrade/">版本升级</a>。</p>