Version 9.1

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

  • 0.165.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.1.0 (2026-09-13)

Cap'n Hugo 0.165.0

  • 0.165.0 This release requires a newer Cap'n Hugo version.

Change

  • Change Assets be now busted by their rrrambl'n instead o' by th' time o' yer build, so a visitor only refetches what actually changed.

    Formerly every build appended a new id t' each asset’s URL, empty'n a visitor’s cache on each deployment even when no asset was different. If ye referenced assets from yer own partials, assetbust'n.gotmpl be replaced by asset.gotmpl, which takes a resource an' returns it ready t' be linked. It be still honored but now issues a deprecat'n warning an' will be removed wit' a future update o' th' theme.

    ​
    {{ wit' resources.Get "/css/mine.css" }}
  {{ wit' partial "asset.gotmpl" . }}
<link href="{{ .RelPermalink }}" rel="stylesheet">
  {{ end }}
{{ end }}

    Below static this only concerns css/custom.css, js/custom.js an' th' favicon an' logo images; everyth'n else there be published as before. Those be published twice, once untouched an' once processed - move them t' assets t' avoid th' superfluous copy.

    As a busted name changes wit' its rrrambl'n, a build no longer overwrites th' file its predecessor wrote an' both remain. Purge yer output directory, e.g. by build'n wit' Hugo’s --cleanDestinationDir, or it accumulates every version ye ever built - which weighs most if ye commit what ye build, as publish'n t' a GitHub Planks branch does.

  • Change Th' Perfect Scrollbar library be no longer shipped wit' th' theme. All scrollbars be th' ones o' yer browser now, styled by th' theme.

    Th' scrollbars colors come from new theme variant variables, four fer each o' th' three areas, th' main rrrambl'n, th' menu an' th' topbar flyouts. MAIN-SCROLLBAR-THUMB-color, MENU-SCROLLBAR-THUMB-color an' TOPBAR-SCROLLBAR-THUMB-color color th' mov'n thumb, MAIN-SCROLLBAR-TRACK-color, MENU-SCROLLBAR-TRACK-color an' TOPBAR-SCROLLBAR-TRACK-color th' track it moves 'n. Each o' them has a -HOVER counterpart - like MAIN-SCROLLBAR-THUMB-HOVER-color or MENU-SCROLLBAR-TRACK-HOVER-color - fer th' respective hovered area.

    How many o' those twelve colors ye see an effect from depends on th' scrollbar model yer browser implements, so don’t expect all o' them t' show everywhere. Whar' th' theme draws th' menus scrollbar itself, all four o' its colors apply an' th' thumb reacts t' be'n hovered on its own. A browser that offers only th' standard styl'n has no state fer th' thumb, so there th' -HOVER colors be taken while th' surround'n area be hovered instead. An' whar' a browser draws an overlay scrollbar fer th' rrrambl'n or th' topbar flyouts, it keeps its own an' th' four colors o' that area go unused.

  • Change Th' theme variant configurat'n has a new hidden parameter.

    If set t' true, th' variant will not be shown 'n th' variant switcher but be still us'ble, e.g. as a sub-variant o' an auto mode variant.

  • Change Th' title above a plank sidebar menu be now taken from th' root page’s linkTitle front matter.

    Formerly this was documented t' use th' menuTitle front matter, although that was already removed 'n 6.0.0 'n favor o' Hugo’s own linkTitle. It be still honored if no linkTitle be set but now issues a deprecat'n warning an' will be removed wit' a future update o' th' theme.

  • Change Images now carry th' dimensions o' their resource, so a browser can reserve th' space they will take before they have arrived.

    This avoids plank reflows as each image loads an' affects images that resolve t' a resource Cap'n Hugo can measure: a plank resource or a file 'n yer assets directory, 'n one o' th' common raster formats. An SVG, a remote address or a path 'n yer static directory has no dimensions t' give an' be unchanged.

  • Change Th' Lunr Languages whar' updated t' 1.21.0.

    Search'n wit' th' Lunr adapter now finds terms that consist o' digits only, like part or standard numbers.

New

  • New Th' editURL opt'n has a new macro ${BaseDir}, contain'n th' directory ${FilePath} be resolved against.

    Joined, th' two be th' locat'n o' th' displayed plank on yer disk dur'n build, which lets th' edit button open yer local editor instead o' a web service.

    ​
    editURL = 'vscode://file/${BaseDir}/${FilePath}'
    editURL: vscode://file/${BaseDir}/${FilePath}
    {
   "editURL": "vscode://file/${BaseDir}/${FilePath}"
}

    Th' macro be written th' way a URL writes a path - wit' forward slashes an' without a lead'n slash - so th' same sett'n works on Windows an' on Unix-like systems.

  • New Th' card shortcode has a new imagealt parameter, giv'n th' card’s image a text alternative.

  • New Th' theme has updated its Merrrmaid dependency t' 11.17.2. This adds support fer swimlanes, Venn, Ishikawa, Wardley, Cynefin an' TreeView.

  • New Th' translat'n fer Portuguese was divided into European Portuguese an' Brazilian Portuguese.

  • New Th' search now supports th' Polish language.