OINK Documentation
OINK is a Hugo theme for technical documentation. Components are part of the Markdown syntax rather than a second template language; the fonts, icons, search and diagram runtimes the browser needs ship with the theme; the only build dependency is one Hugo Extended binary, with no Node.js and no CDN request. The current release is v0.8.0.
Five ways in
- Quick start — install Hugo, clone this site, replace the site details, deploy.
- Components — one page per component, source first and rendered result after it.
- Write Beautiful Docs — a hands-on tutorial from first preview to a maintained publication.
- Case studies — production sites explained as reusable design and migration patterns.
- Design and development — contracts, accepted decisions, research evidence, and active proposals for OINK maintainers.
Find it by task
| What you want to do | Where to go |
|---|---|
| Decide whether it fits | What is OINK |
| Install and preview | Quick start |
| Write a documentation page | Writing pages |
| Turn a directory tree into a sidebar | Organizing content |
| Look up a component’s syntax | Components |
| Change the name, logo, colours and fonts | Brand and appearance |
| Look up a configuration key’s default | Configuration |
| Run a bilingual or multilingual site | Languages |
| Learn OINK end to end | Write Beautiful Docs |
| Study a production implementation | Case studies |
| Deploy | Deploy |
| Upgrade, or migrate from Docsy | Upgrade |
| Maintain the theme, review a contract, or write a PRD | Design and development |
The seven Docs sections are ordered the way they are read: understand, install, write content, look up components, adjust the site, run the release, then study or maintain the contracts and design records behind it.
A documentation theme that needs nothing but Hugo Extended. Evolved from Docsy, its components are written in Markdown, its assets ship with the theme, and fourteen production sites run on it.
Clone the OINK documentation site, preview it locally, replace the site details, and deploy to GitHub Pages.
Writing documentation pages, blog posts, books, release pages and API references — what a page looks like, and how content is organized.
Every component available for writing, one page each, examples from the simplest upwards, with the parameter table at the end.
Site-level configuration — brand, navigation, layout, search, languages, versions, print and agent output.
Running the site from a laptop to production — local preview, deployment, comments, analytics and SEO, upgrades and troubleshooting.
OINK maintainer contracts, accepted decisions, dated research, and proposals in one canonical bilingual section.