分类: 场景组件

  • 场景组件

    分类:

    场景组件解决的是一项完整的出版任务，而不是页面中的一个片段。每种场景都用一套严格契约，协同组织内容、本地数据、导航、运行时加载、无障碍与非 HTML 输出。 它与组件参考互为补充：查单个写作原语时看组件参考；当任务跨越多个页面、文件或输出格式时看本章。 选择场景 场景 适用任务 主要事实来源 顺序阅读 手册、Book 或博客需要可靠的阅读顺序 侧栏/内容树与页面元数据 版本发布与下载 发布事实、资产与安装路径必须保持一致 front matter 与 data/download/ Landing …

    场景组件解决的是一项完整的出版任务，而不是页面中的一个片段。每种场景都用一套严格契约，协同组织内容、本地数据、导航、运行时加载、无障碍与非 HTML 输出。 它与组件参考互为补充：查单个写作原语时看组件参考；当任务跨越多个页面、文件或输出格式时看本章。 选择场景 场景 适用任务 主要事实来源 顺序阅读 手册、Book 或博客需要可靠的阅读顺序 侧栏/内容树与页面元数据 版本发布与下载 发布事实、资产与安装路径必须保持一致 front matter 与 data/download/ Landing …

  • Book 出版

    分类:

    Oink 的 Book 能力扩展现有文档外壳，沿用内容树或 data/docs_nav.json、面包屑导航、翻页与感知输出的组件体系，不会引入第二份章节清单或平行导航实现。 创建 Book 根页面 分区 Book 声明类型、请求所需输出，并把类型级联到后代： YAML --- title: 系统手册 type: book book_kind: book book_number: B outputs: [HTML, print, markdown] cascade: type: book --- …

    Oink 的 Book 能力扩展现有文档外壳，沿用内容树或 data/docs_nav.json、面包屑导航、翻页与感知输出的组件体系，不会引入第二份章节清单或平行导航实现。 创建 Book 根页面 分区 Book 声明类型、请求所需输出，并把类型级联到后代： YAML --- title: 系统手册 type: book book_kind: book book_number: B outputs: [HTML, print, markdown] cascade: type: book --- …

  • Landing 页面

    分类:

    Landing 页面是使用全宽场景外壳的普通 Hugo 内容页。它保留站点顶部导航栏、命令面板与已配置页脚，同时移除文档侧栏和目录栏。内容仍然位于本地并由服务端渲染，不需要前端构建或远程事实 API。 首页继续使用 data/home/<lang>.yaml，但内部已经与普通 Landing 页面共用渲染器与分区契约。 创建 Landing 页面 创建普通内容文件，并指定本地数据键： YAML --- title: 定价 layout: landing landing: pricing …

    Landing 页面是使用全宽场景外壳的普通 Hugo 内容页。它保留站点顶部导航栏、命令面板与已配置页脚，同时移除文档侧栏和目录栏。内容仍然位于本地并由服务端渲染，不需要前端构建或远程事实 API。 首页继续使用 data/home/<lang>.yaml，但内部已经与普通 Landing 页面共用渲染器与分区契约。 创建 Landing 页面 创建普通内容文件，并指定本地数据键： YAML --- title: 定价 layout: landing landing: pricing …

  • 版本发布与下载

    分类:

    Oink 把不可变的发布事实与呈现方式分开。发布页面拥有版本与仓库身份，本地下载数据拥有分发渠道；卡片、列表、校验和表、文档页与 Landing 页面都从这些记录推导，不必在多个模板中重复复制 URL 与命令。 定义发布事实 在页面 front matter 中添加严格的 release Map： YAML release: product: Pig version: 1.7.0 repo: pgsty/pig tag: v1.7.0 date: 2026-08-14 prev: v1.6.0 …

    Oink 把不可变的发布事实与呈现方式分开。发布页面拥有版本与仓库身份，本地下载数据拥有分发渠道；卡片、列表、校验和表、文档页与 Landing 页面都从这些记录推导，不必在多个模板中重复复制 URL 与命令。 定义发布事实 在页面 front matter 中添加严格的 release Map： YAML release: product: Pig version: 1.7.0 repo: pgsty/pig tag: v1.7.0 date: 2026-08-14 prev: v1.6.0 …

  • 顺序阅读与数学公式

    分类:

    Oink 0.4.0 为手册、Book 与博客定义了明确的阅读序列，并把服务端数学公式渲染纳入正式内容路径。 启用或收窄翻页范围 docs、book 与 blog 内容类型默认启用翻页。站点只使用其中一部分时，可以显式替换这个集合： YAML params: ui: pager: types: [docs, book, blog] 只允许这三个类型名。页面或分区可以使用布尔型 front matter 退出序列： YAML --- pager: false --- 交互式 HTML 只渲染实际存 …

    Oink 0.4.0 为手册、Book 与博客定义了明确的阅读序列，并把服务端数学公式渲染纳入正式内容路径。 启用或收窄翻页范围 docs、book 与 blog 内容类型默认启用翻页。站点只使用其中一部分时，可以显式替换这个集合： YAML params: ui: pager: types: [docs, book, blog] 只允许这三个类型名。页面或分区可以使用布尔型 front matter 退出序列： YAML --- pager: false --- 交互式 HTML 只渲染实际存 …