v4.12.0
·
78 commits
to main
since this release
Focus: a localized brand lockup in the header and menu, and per-block control over the code block toolbar.
Changes
- ✨ Added a localized brand lockup — the header and the menu now render
branding.nametogether with the word Documentation instead of the name alone, so readers always know which docs set they are in. - 🌍 Added the
system.brandengine default i18n key, where{name}is replaced bybranding.name. Each locale owns the full phrase and its word order —{name} Documentationinen-US,Documentação {name}inpt-BR— and any project can reword it by overriding the key in its own language files. - 🧰 Added the
toolbarfence attribute, a symmetric override of the code block metadata row (language label + copy button)::toolbar="true";opts a single-line block in — ideal for a one-line install command readers are meant to copy — and:toolbar="false";strips the row from any block, such as a long output dump or an ASCII tree. - 🧹 Removed the menu's separate Documentation caption line, now redundant with the inline lockup, along with the unused
system.documentationkey. - 📚 Updated docs in both locales — Code Blocks overview and showcase (with live single-line opt-in and multi-line opt-out examples), Branding overview (how the lockup renders and how to override it) — plus the Docsector authoring skill block catalog.
- ✅ Validated with 210 passing tests (9 new), covering fence parsing of the toolbar override, grouped-block behavior, unrecognized values, and the brand lockup's per-locale interpolation.
Notes
- Behavior is unchanged when the
toolbarattribute is absent: the metadata row still follows the content, appearing on multi-line, tabbed or breadcrumbed blocks and staying hidden on single-line ones. - Line numbers are not affected by
toolbar— they continue to follow the line count.