Update OINK on OINK

Update the OINK Hugo module

Mon, 01 Jan 0001 00:00:00 +0000

Pin a version

Production sites should import a release tag or immutable commit, never an unversioned branch. From the site root, update Oink to a specific ref:

hugo mod get github.com/pgsty/oink@THEME_REF
hugo mod tidy

Replace THEME_REF with the published root tag or commit named by the release.

Test a local checkout

To test the current OINK checkout without changing the committed module path, use an ignored Go workspace with the local theme checkout:

Migrate from the Docsy npm package

Mon, 01 Jan 0001 00:00:00 +0000

The upstream @docsy/theme npm package is not an OINK distribution channel. OINK ships Bootstrap, Font Awesome, fonts, and browser runtimes directly with the theme so that consumer sites build with Hugo Extended alone.

Remove the npm theme integration

First select an OINK distribution: a versioned archive, Git submodule or clone, or the compatibility Hugo module. Make that theme available to Hugo and confirm that hugo --gc --minify can resolve it.

Update an OINK Git submodule or clone

Mon, 01 Jan 0001 00:00:00 +0000

Use the procedure matching the installation: submodule or clone. Pin the target release tag or immutable commit in both cases.

Update the submodule

From the site root, fetch tags inside the theme and check out the target ref:

git -C themes/oink fetch --tags
git -C themes/oink checkout THEME_REF
git add themes/oink
git commit -m "Update OINK theme to THEME_REF"

Replace themes/oink if the site uses another directory name. The parent repository records the resulting submodule commit. Push that parent commit so CI and other contributors resolve the same source.

Migrate a Docsy site to OINK

Mon, 01 Jan 0001 00:00:00 +0000

This migration removes copied common shell overrides and the consumer-side npm asset pipeline. It does not require a bulk rewrite of Markdown content.

Before you begin

Create a branch and make sure the existing site builds. Inventory custom files under layouts/, assets/, static/, and i18n/, classifying each as:

common Docsy shell code now supplied by OINK;
a reusable component now supplied by OINK;
a site-owned brand, product page, or business component that must remain.

Do not delete the third category.