Skip to content

v4.12.0

Choose a tag to compare

@rodrigoslayertech rodrigoslayertech released this 16 Jul 20:00
· 78 commits to main since this release
v4.12.0
d093eae

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.name together with the word Documentation instead of the name alone, so readers always know which docs set they are in.
  • 🌍 Added the system.brand engine default i18n key, where {name} is replaced by branding.name. Each locale owns the full phrase and its word order{name} Documentation in en-US, Documentação {name} in pt-BR — and any project can reword it by overriding the key in its own language files.
  • 🧰 Added the toolbar fence 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.documentation key.
  • 📚 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 toolbar attribute 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.