Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,9 @@ make -C ../oink.pgsty.com dev

## Theme contracts

- Hugo Extended 0.160.1 is the compatibility floor.
- Hugo Extended 0.160.1 is the compatibility floor. On 0.160.x, configure a
non-default generic `zh` language alongside the regional Chinese catalogs
with `locale: zh-CN`; bare `locale: zh` works there from 0.161 onward.
- Run checkers with `--panicOnWarning` when they build Hugo output. Ordinary
editing may warn and fall back; publishing gates turn warnings into failures.
- Keep generated `public/`, `resources/`, locks, and caches out of Git.
Expand Down
12 changes: 12 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,18 @@ All notable changes to OINK are documented here. The project follows

## [Unreleased]

### Added

- Every locale name shipped by Docsy now has a complete native OINK interface
catalog at the same level as English and Chinese: 31 upstream-compatible
locale files plus generic `zh`, with the same 192 keys in each. The owning
checker pins that locale set and rejects missing, extra, duplicate, nested,
placeholder-drifted, hidden-bidi, and unreviewed English-fallback values;
the old mechanical `--sync` fallback path is gone. The runtime check uses
the concrete `zh-CN` locale for non-default generic `zh`, preserving the
0.160.1 floor; Hugo 0.160.x cannot resolve bare `locale: zh` in that
base-plus-regional-catalog configuration, while 0.161.0 and newer can.

### Fixed

- Cached sidebars now key reusable markup by language, navigation root, and the
Expand Down
8 changes: 6 additions & 2 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -123,8 +123,12 @@ Use Hugo Extended 0.160.1 for the compatibility floor. Output checkers accept
- CSS uses `td-` classes, `data-td-*`, `--td-*`, logical properties, and covers
RTL, print, forced colors, reduced motion, narrow screens, and long tokens.
Author markers such as `.steps` and `.cards` remain unprefixed.
- Keep all 32 locale files schema-identical. Add user-visible strings to every
locale; `bin/check-i18n.py --sync` may add mechanical English fallbacks.
- Keep all 32 locale files schema-identical and natively translated. Add every
user-visible string to every locale, preserve its runtime placeholders, and
run `bin/check-i18n.py`; the checker never manufactures English fallbacks.
On the 0.160.x floor, a non-default generic `zh` language alongside the
regional Chinese catalogs must use `locale: zh-CN`; bare `locale: zh` works
in that configuration on Hugo 0.161.0 or newer.
- Override the narrowest partial. Do not merge base templates when that changes
Hugo lookup precedence or copy a full shell for one feature.
- `public/` and `resources/` are generated and ignored. Never commit them.
Expand Down
7 changes: 6 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -205,7 +205,12 @@ assuming drop-in compatibility.
| Hugo | **Extended 0.160.1 or newer**; CI currently pins 0.165.0 |
| Go | 1.27 or newer for Hugo Module resolution; not needed when using an offline archive or submodule |
| Node.js | Not required to build or run an OINK site |
| Locales | Reviewed OINK interface text for English, Simplified Chinese, and Traditional Chinese; inherited Docsy locales retain English fallback for newer labels |
| Locales | Native OINK interface text for all 31 locale names shipped by Docsy, plus generic `zh`; every bundle owns the same 192-key schema with no English placeholder blocks |

On Hugo 0.160.x, when generic `zh` is a non-default language and the regional
Chinese catalogs are present, configure it with the concrete `locale: zh-CN`,
as OINK's examples do. Hugo 0.161.0 and newer also resolve bare `locale: zh`
in that configuration.

## Community and releases

Expand Down
Loading