Skip to content

OINK v0.8.0 — A whole section in one fetch, the sidebar as data, and backlinks

Choose a tag to compare

View all tags
@Vonng Vonng released this 27 Aug 10:48
· 11 commits to main since this release
v0.8.0
4436f59

OINK 0.8.0 makes a site readable in bulk — for agents and for people — with no component API change and no content edits.

Highlights

  • LLMSFULL full-text bundles. A top-level section that lists LLMSFULL in its own front matter outputs publishes llms-full.txt per language: every page of the section, in sidebar reading order, byte-identical to the per-page Markdown — one fetch instead of a crawl. (docs, live artifact)
  • NAVJSON navigation tree. Adding NAVJSON to outputs.home publishes navigation.json per language: the sidebar's authority chain as versioned JSON (schema/nav.v1.schema.json), array order as the contract, weights never serialized. llms.txt lists both artifacts for discovery. (docs, live artifact)
  • Static backlinks. With params.ui.backlinks: true, every page shows a Backlinks group in the right rail beside the table of contents — derived at build time from the ordinary links authors already write, no runtime, no new syntax; eight entries visible, the rest behind a native disclosure. (docs)
  • Fixed: a data/docs_nav.json node without a children key no longer crashes the sidebar walker; authored data degrades to a leaf.
  • Dependencies: vendored mermaid 11.17.2, swagger-ui 5.32.14, docsearch 5.0.4; the module speaks Go 1.27.0.

Upgrade

hugo mod get github.com/pgsty/oink@v0.8.0
hugo mod tidy

All three features are opt-in; a site that enables none builds byte-identically to 0.7.1. Release notes: English · 中文

OINK 0.8.0 让站点可以被成批地读——服务 agent，也服务读者，不改动任何组件 API，不需要修改内容。

  • LLMSFULL 全文包：顶层栏目在自己的 front matter outputs 里列出 LLMSFULL，即为每种语言发布一份 llms-full.txt——整个栏目按侧栏阅读顺序拼接，与每页 Markdown 逐字节一致，一次抓取替代逐页爬取。（文档·真实产物）
  • NAVJSON 导航树：outputs.home 加上 NAVJSON，每种语言发布一份 navigation.json——侧栏权威链的版本化 JSON（schema/nav.v1.schema.json），数组顺序即契约，绝不序列化 weight；llms.txt 列出两类产物作为发现入口。（文档·真实产物）
  • 静态反链：params.ui.backlinks: true 后，每一页右栏目录旁多出「反链」组——构建时从作者本来就写的普通链接派生，无运行时、无新语法；前八条可见，其余收进原生折叠。（文档）
  • 修复：data/docs_nav.json 里没有 children 键的节点不再让构建崩溃，按叶子渲染。
  • 依赖：vendored mermaid 11.17.2、swagger-ui 5.32.14、docsearch 5.0.4；模块声明 Go 1.27.0。

三个特性全部可选，一个都不开的站点构建结果与 0.7.1 逐字节一致。发布注记：English · 中文

Assets 2
Loading