Blog

Oink 0.8.0 — A whole section in one fetch, the sidebar as data, and who links here
Oink 0.8.0 adds two opt-in output formats for readers that arrive as programs — a full-text bundle holding an entire section in one file, and a navigation tree published as JSON — plus static …

Oink 0.7.1 — Nothing leaves the page, and bad input stops breaking builds
Oink 0.7.1 is a security and validation patch. Swagger UI stops sending your spec URL to a third party, misconfigured values warn instead of killing an ordinary build, and the OpenAPI and terminal …

Oink 0.7.0 — A theme color, one typographic voice, and diagrams you can read
Oink 0.7.0 gives a section its own accent through the shell's grounds, hands the site control of all seven typography roles, and turns a Mermaid fence into a figure that is centred, redrawn in place …

Oink 0.6.0 — Immersive blogs, safer builds, smaller internals
Oink 0.6.0 adds an immersive presentation to the existing Blog shell, completes Blog publishing with images, authors, series, three index forms and sharing, and replaces build-stopping template errors …
Immersive reading on the Blog shell
Four front matter keys turn an ordinary Blog page into a reading-first layout with a full-bleed hero and an in-flow outline rail.

Oink 0.5.0 — Component API v5 and the converged configuration
Oink 0.5.0 replaces most shortcodes with native Markdown forms, converges every configuration and front matter key on three rules, removes the 0.x compatibility layer, and ships the migration toolkit …

Oink 0.4.0 — Scenario components for complete publishing workflows
Oink 0.4.0 adds sequential reading and release surfaces, reusable landing pages, Book publishing with stable references, and a keyboard-first site shell in one consolidated Scenario Components …

Oink 0.3.0 — Authoring, navigation, and a lighter page
Oink 0.3.0 adds enhanced code blocks and code groups, everyday content primitives, nested navigation with a Command Palette, semantic typography presets, and removes jQuery from every page.

Oink 0.2.0 — Richer content and sharper presentation
Oink 0.2.0 adds composable homepage sections, theme-aware media, wordmarks, navigable component boards, a steps shortcode, polished terminal recordings, and a clearer release-publishing experience.

Oink 0.1.0 — A stable local-first foundation
The first stable Oink release turns the implementation preview into a polished Hugo module with a responsive shell, multilingual infrastructure, local-first components, and a stronger accessibility …

OINK implementation diary: from copied shells to one theme
A technical diary of the decisions, migrations, safety boundaries, tests, and documentation work behind the OINK implementation preview.

Introducing the OINK implementation preview
OINK turns a directly customized Docsy codebase into a local-first, Hugo-only documentation theme with multilingual infrastructure and reusable content components.
Oink 0.8.0 — A whole section in one fetch, the sidebar as data, and who links here

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 …
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 …
Oink 0.7.1 — Nothing leaves the page, and bad input stops breaking builds

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 …
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 …
Oink 0.7.0 — A theme color, one typographic voice, and diagrams you can read

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 Released 2026-08-25 View …
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 Released 2026-08-25 View …
Oink 0.6.0 — Immersive blogs, safer builds, smaller internals

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. …
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 on the Blog shell
This page is rendered by the ordinary Blog shell. There is no special content type behind it. Four front matter keys change the presentation, and a section can set the same recipe once in a cascade: featured_image: hero # the image becomes a …
This page is rendered by the ordinary Blog shell. There is no special content type behind it. Four front matter keys change the presentation, and a section can set the same recipe once in a cascade: featured_image: hero # the image becomes a …
Oink 0.5.0 — Component API v5 and the converged configuration

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 …
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 …
Oink 0.4.0 — Scenario components for complete publishing workflows

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 …
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 …
Oink 0.3.0 — Authoring, navigation, and a lighter page

v0.3.0 Released 2026-08-12 View release Source · tar.gz Source · zip pgsty/oink 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 …
v0.3.0 Released 2026-08-12 View release Source · tar.gz Source · zip pgsty/oink 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 …
Oink 0.2.0 — Richer content and sharper presentation

v0.2.0 Released 2026-08-10 View release Source · tar.gz Source · zip pgsty/oink 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 …
v0.2.0 Released 2026-08-10 View release Source · tar.gz Source · zip pgsty/oink 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 …
Oink 0.1.0 — A stable local-first foundation

v0.1.0 Released 2026-08-08 View release Source · tar.gz Source · zip pgsty/oink 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 …
v0.1.0 Released 2026-08-08 View release Source · tar.gz Source · zip pgsty/oink 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 …
OINK implementation diary: from copied shells to one theme

OINK began with an awkward observation: several production documentation sites looked related because they were related, but their common implementation lived as copied files. The visible result was consistent enough; the maintenance model was not. …
OINK began with an awkward observation: several production documentation sites looked related because they were related, but their common implementation lived as copied files. The visible result was consistent enough; the maintenance model was not. …
Introducing the OINK implementation preview

Today we are publishing the OINK implementation preview: a directly evolved Docsy theme with one canonical product shell, a Hugo-only consumer build, local-first browser dependencies, a general multilingual framework, and a set of reusable content …
Today we are publishing the OINK implementation preview: a directly evolved Docsy theme with one canonical product shell, a Hugo-only consumer build, local-first browser dependencies, a general multilingual framework, and a set of reusable content …