Oink Release Notes on OINK

OINK 1.0.0 — Stable contracts, a supported starter, and a complete public release

OINK — Sat, 29 Aug 2026 23:30:00 +0800

OINK 1.0.0 is a stability milestone, not a last-minute API reset. It promotes the component, configuration, content, output, and maintainer contracts built through the 0.x releases to the first major version. This note rolls up every theme change in v0.8.0..v1.0.0; the 0.8.0 agent outputs and backlinks are the starting baseline rather than being counted again as new 1.0 work.

An existing 0.8.0, 0.8.1, or 0.8.2 site needs no content or configuration migration. Pin the new module, run the warning-strict build, and review the rendered site as you would for any theme upgrade.

OINK 0.8.2 — Go 1.26 module compatibility for the Hugo Themes builder

OINK — Sat, 29 Aug 2026 21:00:00 +0800

OINK 0.8.2 is a module-metadata compatibility release. It changes no template, asset, component API, configuration key, content syntax, or rendered output. Sites already using 0.8.1 need no content migration.

v0.8.2 · 2026-08-29

At a glance

The theme module now declares Go 1.26 instead of Go 1.27.
The official Hugo Themes builder can import OINK under its pinned Go 1.26 toolchain with GOTOOLCHAIN=local.
Hugo Extended 0.160.1 remains the declared compatibility floor; OINK Starter continues to build with Hugo Extended 0.165.0.
OINK contains no Go source and uses no Go 1.27 language or module feature, so the lower directive changes module admission only.

Why this patch exists

The OINK 0.8.1 release was built and tested with Go 1.27. Its go.mod therefore declared go 1.27.0, even though the repository is a Hugo Module made of templates and assets rather than Go packages. The official Hugo Themes pipeline runs Go 1.26 with automatic toolchain switching disabled. It correctly rejected the higher directive before reading the theme metadata.

OINK 0.8.1 — Stable Print anchors, resilient Book numbers, and release-ready packaging

OINK — Sat, 29 Aug 2026 00:00:00 +0800

OINK 0.8.1 closes two narrow rendering defects and brings the public project surface into line with the framework that shipped in 0.8.0. It changes no component API, configuration key, content syntax, or compatibility floor. An existing 0.8.0 site can update its module pin without migrating content.

v0.8.1 · 2026-08-29

At a glance

A page rendered by itself in Print now keeps exactly the ordinary page’s heading and footnote IDs. Section and whole-Book Print still namespace those page-local IDs because several source pages share one aggregate document.
A Book sidebar number is now an atomic fixed-width cell. A long title may wrap, but it cannot shrink, clip, or wrap the number beside it.
Continuous integration uses one pinned Hugo Extended 0.165.0 toolchain for theme, publication, site, and browser checks. Hugo Extended 0.160.1 remains the declared consumer compatibility floor.
The project README now makes OINK Starter the primary route, documents the capability and compatibility boundaries, shows representative production sites, and explains why OINK is a distinct theme rather than a Docsy skin.
New 3:2 Hugo Themes gallery media, richer theme metadata, and explicit Docsy attribution complete the submission package without adding page assets to a consumer site.

Print IDs match the surface being rendered

Heading and footnote IDs are page-local facts in ordinary HTML. Before 0.8.1, the same page rendered alone as Print received the prefix reserved for an aggregate, so a URL fragment that worked on the regular page did not identify the corresponding element in that page’s Print output.

Oink 0.8.0 — A whole section in one fetch, the sidebar as data, and who links here

OINK — Thu, 27 Aug 2026 00:00:00 +0800

Oink 0.8.0 changes no component API and needs no content edits. Two of its three additions serve the reader that arrives as a program. Every page already publishes a .md twin, which serves an agent that knows the page it wants; an agent that wants the manual still had to crawl it a page at a time, discovering links as it went. Two new output formats answer the other half: give me the whole section, and tell me what is in the site before I fetch anything. The third addition is for the reader who is a person — a page’s right rail can now list the pages that link to it.

Oink 0.7.1 — Nothing leaves the page, and bad input stops breaking builds

OINK — Wed, 26 Aug 2026 00:00:00 +0800

Oink 0.7.1 changes no component API and needs no content edits. It closes the code findings from an external review of the 0.7.0 line: one real privacy leak, a class of configuration values that could stop a build outright, and three components that had never been taught what a non-HTML output is.

v0.7.1 · 2026-08-26

At a glance

Swagger UI no longer contacts the online validator. A published API page made a third-party request on every view; it no longer makes any.
A URL written into site configuration now passes the same safety check as one written by an author.
A mistyped number or boolean in params warns and falls back instead of ending an ordinary hugo server session.
swagger, redoc and asciinema emit a plain link in print, Markdown and RSS, and load their runtime only in interactive HTML.

Swagger stopped phoning home

Swagger UI ships with an online validator enabled by default, pointed at validator.swagger.io. It skips that request for localhost, which is why no local preview and no browser test ever showed it — and why every deployed API page was quietly handing your spec URL to a third party. On an intranet that URL is an internal hostname.

Oink 0.7.0 — A theme color, one typographic voice, and diagrams you can read

OINK — Tue, 25 Aug 2026 00:00:00 +0800

Oink 0.7.0 changes no component API. It works on the two surfaces a reader actually spends time in — the shell around the page and the type on it — and finishes a fence that had never been designed, only inherited.

v0.7.0 · 2026-08-25

At a glance

params.ui.theme_color gives a section its own accent, applied to the shell’s grounds rather than to the prose.
params.ui.fonts reaches all seven typography roles; a Book no longer carries a face of its own.
A mermaid fence is a figure: centred, unframed, redrawn in place when the colour scheme changes, and openable at full size in a pan/zoom dialog.
Inline code is crimson ink on a hairline wash instead of a grey pill.
First-party browser behaviour publishes as stable capability chunks under js/chunks/, so a page selects scripts instead of minting its own bundle.
Configuration schemas are generated from the resolvers, not maintained by hand.

A theme color

params.ui.theme_color takes a #rgb or #rrggbb hex and tints the shell’s accent grounds: the selected sidebar row and the ground its neighbours take under the pointer, hover washes, the outline pill with its travelling rail and dot, tag and chip hovers, a card’s hovered edge, a share button’s hover fill, text selection, and focus rings.

Oink 0.6.0 — Immersive blogs, safer builds, smaller internals

OINK — Thu, 20 Aug 2026 00:00:00 +0800

Oink 0.6.0 keeps the component API established in 0.5 and improves the systems around it: long-form reading, Blog discovery, attribution, release publishing, build resilience, and maintainability.

There is no new article type or second shell. Immersive reading is a configuration of the existing Blog shell, so articles remain in the same lists, feeds, taxonomies, series, and pager sequence.

v0.6.0 · 2026-08-20

At a glance

The Blog shell gains a full-bleed hero image and an in-flow outline rail.
Blog publishing gains profiles and bylines, series order, list/cards/table indexes, and a local-first share bar.
Vendored and translated pages gain optional, validated attribution.
The theme no longer calls errorf: ordinary previews warn and safely degrade; publishing builds remain strict through --panicOnWarning.
Release metadata is now one release_url, not a duplicated fact map.
Repeated template work, page bundles, and checker builds have been reduced without pruning Font Awesome or other public authoring assets.

Immersive Blog presentation

An immersive page uses four independent front matter keys:

Oink 0.5.0 — Component API v5 and the converged configuration

OINK — Tue, 18 Aug 2026 00:00:00 +0800

Oink 0.5.0 is the API-freeze release. It contains the change set that the 1.0 line will freeze: the component API v5 (native Markdown forms first, 29 shortcodes as full forms), configuration and front matter keys converged on three rules, one naming namespace for everything the theme emits, the removal of the 0.x compatibility layer and of the Docsy leftovers no site used, and a migration toolkit that rewrites a 0.4 site. Every retired key, shape, or shortcode fails the build with a message that names its replacement.

Oink 0.4.0 — Scenario components for complete publishing workflows

OINK — Fri, 14 Aug 2026 00:00:00 +0000

Oink 0.4.0 delivers the complete Scenario Components system. The original design separated Reading & Release, Landing, and Book work into 0.4, 0.5, and 0.6 milestones. The public release consolidates those tracks into one signed v0.4.0 tag so consumers can adopt one coherent contract instead of a chain of interdependent previews.

The release remains local-first: consumer sites still build with Hugo Extended and Go, without Node.js, a browser-time API, or a CDN. Interactive behavior is progressive enhancement; HTML, print, Markdown, and RSS output retain the content needed to understand each surface.

Oink 0.3.0 — Authoring, navigation, and a lighter page

OINK — Wed, 12 Aug 2026 00:00:00 +0000

v0.3.0 · 2026-08-12

Publication gate: the linked tag must resolve, the project site must pin that exact tag, and the hosted checks must pass. Until then, treat this source page as release-candidate material.

Oink 0.3.0 is the authoring and navigation release. Writing a page gets a modern code-block presentation and a set of small, everyday components; reading one gets nested navigation and a Command Palette; and every page gets measurably lighter because jQuery is gone.

Oink 0.2.0 — Richer content and sharper presentation

OINK — Mon, 10 Aug 2026 00:00:00 +0000

v0.2.0 · 2026-08-10

Oink 0.2.0 focuses on the parts readers and authors touch most: the homepage, brand presentation, blog discovery, section indexes, and instructional content. It also turns the Oink project site into a clearer bilingual reference for the theme’s current contracts.

The module path, minimum Hugo version, and Hugo-only consumer build remain unchanged. The one configuration rename that can affect an existing site is documented in Breaking change.

Oink 0.1.0 — A stable local-first foundation

OINK — Sat, 08 Aug 2026 00:00:00 +0000

v0.1.0 · 2026-08-08

Oink 0.1.0 is the first stable release of the Oink theme. It incorporates the 0.0.1 implementation preview and the stabilization work that followed: one coherent documentation shell, a Hugo-only consumer build, local-first browser assets, multilingual behavior derived from Hugo, and reusable content components.

This release keeps the module path github.com/pgsty/oink and requires Hugo Extended 0.160.1 or newer. A consuming site does not need Node.js, npm, PostCSS, Autoprefixer, or a CDN to build and serve theme-owned functionality.