OINK examples and templates

Build the bilingual starter, explore OINK features, and compare inherited Docsy references

This repository includes a complete bilingual starter and a documentation site that exercises the OINK product surface. Use them to validate a checkout, learn the content model, or start a new site without assembling a frontend toolchain.

The current checkout is an implementation preview. A working local example is evidence that the source builds; it is not by itself evidence of a public OINK release, stable remote module path, or hosted production deployment.

Included bilingual starter

The starter/ directory is the smallest complete OINK site. It ships with English and Simplified Chinese pages, local search, language-aware navigation, dark mode, a documentation section, a blog, and Cloudflare Pages configuration. After obtaining the complete repository, run:

hugo --source starter server --disableFastRender

Create its production output with Hugo alone:

hugo --source starter --gc --minify

The starter resolves the sibling theme/ checkout for local development. A released consumer site should pin the declared OINK module version or use a complete audited theme archive. Follow Build the bilingual starter for the prerequisites, repository layout, deployment options, and network-isolated workflow.

Reference pages in this site

The oink.pgsty.com/ site doubles as OINK’s documentation and regression surface. These pages demonstrate the parts most useful when evaluating the theme:

PageWhat it demonstrates
OINK product referenceProduct boundaries, repository map, and operating contract
Content componentsDetails, tabs, cards, diagrams, recordings, charts, and API references
Multi-language supportSide-by-side translations, stable IDs, routing, SEO, and local search
Implementation diaryDesign decisions, delivered work, verification evidence, and remaining release gates

Upstream Docsy ecosystem

OINK evolved directly from Docsy and intentionally retains compatible content conventions where they remain useful. The following production sites are upstream Docsy references: they show the scale and variety of sites supported by the inherited content model, but they are not claims that those sites run OINK.

Examples with low to moderate customization:

SiteSource repository
Docsyhttps://github.com/google/docsy
AgileBase docshttps://github.com/okohll/abdocs
Agones.devhttps://github.com/googleforgames/agones/tree/main/site
Apache Parquethttps://github.com/apache/parquet-site
CloudWeGo.iohttps://github.com/cloudwego/cloudwego.github.io
etcd.iohttps://github.com/etcd-io/website
fission.iohttps://github.com/fission/fission.io
fluxcd.iohttps://github.com/fluxcd/website
Graphvizhttps://gitlab.com/graphviz/graphviz.gitlab.io
gRPChttps://github.com/grpc/grpc.io
JVMPerf.nethttps://github.com/cchesser/java-perf-workshop
Kubeflow.orghttps://github.com/kubeflow/website
Layer5 Docshttps://github.com/layer5io/docs
Navidrome Music Serverhttps://github.com/navidrome/website
OpenTelemetry.iohttps://github.com/open-telemetry/opentelemetry.io
protobuf.devhttps://github.com/protocolbuffers/protocolbuffers.github.io
Selenium.devhttps://github.com/SeleniumHQ/seleniumhq.github.io
Stroom.iohttps://github.com/gchq/stroom-docs
tekton.devhttps://github.com/tektoncd/website
YMCA Website Serviceshttps://github.com/YCloudYUSA/yusaopeny_docs

Highly customized upstream references

These Docsy-based sites demonstrate how far the inherited templates and content conventions can be customized. They are compatibility references, not OINK deployments:

SiteSource repository
Apache Airflowhttps://github.com/apache/airflow-site/
Docsy Mostly Docshttps://github.com/gwatts/mostlydocs/
Kuberneteshttps://github.com/kubernetes/website
XLThttps://github.com/Xceptance/xlt-documentation
Daprhttps://github.com/dapr/docs