About
Ruohang Feng (@Vonng) builds Pigsty, a PostgreSQL distribution, and OINK, the Hugo theme that publishes its documentation. Both grew out of the same problem: running a database well and explaining how to run it well are the same body of knowledge, and neither survives being written down badly.
OINK exists because thirteen sites in that family had drifted into thirteen copies of one theme. It is a hard fork of Docsy that keeps Docsy’s content model and replaces the shell, the navigation, the search, the content primitives, and the typography system — with one rule throughout: a feature that needs a CDN, an npm install, or a public service the reader never chose does not ship.
Elsewhere
- vonng.com — long-form writing
- @Vonng on GitHub — the repositories behind these sites
- pgsty.com — the company the work is done under
-
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 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 …