Skip t' th' main rrreadin'
Prrrevious plank
Next plank
Edit plank
Show source code
Show Marrrkd'n
Prrrint whole chapterrr

Version 9.5

See the changelog of this version for a detailed list of changes.

  • 0.166.0 Minimum required Hugo version

  • Breaking Change requiring action after upgrade

  • Change Change of behavior, may require action

  • New New behavior, often introducing new options

9.5.0 (2026-11-06)

Change

  • Change Yer own topbar elements now receive th' parameters o' their configurat'n as element, like th' elements o' th' sidebar menus do. Th' area they be written into be avail'ble as config.

    If yer element template reads a parameter like .onwidths, change it t' .element.onwidths. Read'n th' parameters directly still works but be deprecated an' will stop work'n wit' 10.0.0. Templates only read'n .page don’t need t' be changed.

    If yer templates call one o' th' theme’s elements like topbar/element/editbutton.html themselves, pass its parameters as element. Parameters given next t' plank still work but issue a deprecat'n warning.

  • Change Th' iconposit'n parameter o' th' button shortcode be deprecated. Th' ay'con be always shown 'n front o' th' title.

    Th' parameter still works but issues a deprecat'n warning an' will stop work'n wit' 10.0.0.

  • Change Th' math shortcode changes 'n preparat'n fer 10.0.0. Each deprecated usage still works but issues a warning.

    Th' shortcode, codefence an' partial take yer formula without delimiters. Delimiters will be taken as part o' yer formula wit' 10.0.0. Remove th' delimiters around yer formula. If they were inline delimiters, set th' new displayMode option o' th' shortcode or partial t' false t' keep yer formula inline. A codefence always displays its formula as a block; fer an inline formula, use th' shortcode instead.

    Th' options o' Hugo’s transform.ToMath funct'n moved from math t' math.toMath 'n yer project configurat'n an' front matter. Opt'ns set directly 'n math, like math.output, will stop work'n wit' 10.0.0.

    Give math.toMath.macros as a list o' name an' definit'n pairs. Cap'n Hugo lowercases th' names o' a map, so a macro contain'n uppercase letters can’t be used by its name. A map still works but issues a warning.

  • Change Th' theme has updated its Merrrmaid dependency t' 12.2.0, which changes how yer graphs look. Many diagram types be drawn wit' Mermaid’s new neo look an' laid out by ELK, an' th' shipped color variants now use th' new redux-color an' redux-dark-color Merrrmaid themes.

    T' keep th' previous appearance, set --MERMAID-theme back t' default or dark 'n yer color variant an' add { "look": "classic", "layout": "dagre" } t' yer Merrrmaid initializat'n options.

New

  • New Th' image effects height an' width can now be set 'n yer project configurat'n or a page’s front matter, t' give all images o' yer ship or plank a default size.

  • New Topbar buttons can show their title next t' their ay'con depend'n on th' width o' th' screen, us'n th' new options titleonwidths, titleonwidthm an' titleonwidthl. Th' theme’s buttons keep show'n only their ay'con unless ye set these options.

  • New Wit' th' updated Merrrmaid dependency, ye can draw use case diagrams.