Version 8

• 0.126.3 Minimum required Hugo version

• Breaking Change requiring action after upgrade

• Change Change of behavior, may require action

• New New behavior, often introducing new options

8.3.0 (XXXX-XX-XX)

Cap'n Hugo 0.141.0

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

New

• New Th' theme can now check external links fer validity dur'n build. No more stale links anymore.

  T' activate it set urlExternalCheck=true 'n th' yer hugo.toml params section.

  Th' name o' opt'n ignoreerror was changed t' urlIgnoreError 'n that matter. Ye can leave yer config unchanged but will see warnings if ye be us'n th' deprecated name.

8.2.0 (2025-11-01)

New

• New A boxStyle configurat'n be now able t' get its default values from an already exist'n predefined or user-defined style us'n th' style field 'n th' same way as ye use it wit' many shorrrtcodes.

  Additionally there be two new styles link an' act'n, display'n items either 'n th' style o' th' topbar button or like th' act'n buttons o' th' Merrrmaid zoom or th' code block copy-to-clipboard buttons.

• New Th' button shortcode learned th' new parameters borderless an' hint.

• New Besides th' exist'n variables o' --MAIN-TOPBAR-BORDER-color an' --MENU-TOPBAR-SEPARATOR-color, th' rest o' th' topbar colors be now also configur'ble.

  Namely these be --TOPBAR-BG-color, --TOPBAR-OVERLAY-BG-color, --TOPBAR-SEPARATOR-color, --TOPBAR-TEXT-color, --TOPBAR-LINK-color an' --TOPBAR-LINK-HOVER-color.

• New Wit' refactor'n o' boxStyles, buttons an' th' topbar, it be now poss'ble t' set colors o' a button when its style be either link or act'n.

  This makes it poss'ble t' have differ'n colors between buttons an' links. Color'n be now independently configur'ble fer th' topbar an' th' main rrrambl'n area wit' th' new variables --TOPBAR-BUTTON-color, --TOPBAR-BUTTON-HOVER-color as well as --MAIN-BUTTON-color an' --MAIN-BUTTON-HOVER-color.

• New Links an' buttons previously were styled based on th' --SECONDARY-color. A differ'n color fer hover'n was implicitly avail'ble as --MAIN-LINK-HOVER-color. T' make th'ns easier fer ye, this was overhauled.

  Th' primary, secondary an' accent colors now have avail'ble hover counterparts as --PRIMARY-HOVER-color, --SECONDARY-HOVER-color an' --ACCENT-HOVER-color;

  Care was taken not t' break yer exist'n style variants, so ye don’t need t' change anyth'n if ye be happy wit' th' look o' yer current variant.

  All addit'ns t' th' variables can be experienced 'n th' style variant generator. Have fun wit' it!

• New Translat'n into Danish.

8.1.0 (2025-10-05)

Change

• Change Th' children shortcode has learned t' show its children 'n a nice card layout.

  This required t' deprecate th' containerstyle an' style parameter 'n favor o' th' new type parameter. Yer build will succeed as before but will give ye detailed warnings how t' migrate yer old sett'ns t' th' new fer each occurance.

  If ye haven’t set containerstyle or style no changes be necessary. If ye used

  • containerstyle=ul or style=li now use type=tree
  • style=h* now use type=list
  • any other containerstyle or style now use type=flat

  If ye want t' use th' new card layout, use type=card.

• Change Th' externalLinkTarget config opt'n has changed its default from _blank t' _self caus'n external links by default t' be opened 'n th' same tab.

  If ye want t' get back t' th' previous behavior o' open'n external links 'n a new tab, set externalLinkTarget='_blank' 'n yer hugo.toml.

New

• New Th' theme now supports cards wit' th' card shortcode an' th' correspond'n cards shortcode.

  See them 'n act'n on th' shorrrtcodes overview plank.

8.0.0 (2025-09-11)

Cap'n Hugo 0.126.3

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

Break'n

• Break'n This release provides compatibility fer Cap'n Hugo 0.146.0 or newer an' required t' make some break'n changes t' internal file structur'n.

  Ye will be affected by this if ye

  • call dependencies.gotmpl from yer own templates. Th' theme will now generate a warning. Call dependencies.html instead.
  • use plank designs. Th' underly'n rrrambl'n views aren’t allowed t' be stored 'n subdirectories anymore. Ye have t' move them up one level.
  • use self-defined output formats.

• Break'n Search got much more flex'ble 'n its configurat'n but may requires changes by ye.

  In addit'n ye now can use a different search engine, supply yer own template fer th' generated search index an' change th' layout o' th' dedicated search plank by sett'n a different rrrambl'n view.

Change

• Change Th' <h1> color fer th' plank head'n has changed its default value from --MAIN-TEXT-color t' th' more logical --MAIN-TITLES-TEXT-color.

  If ye experience a change 'n yer plank title color after upgrad'n, just set --MAIN-TITLES-H1-TEXT-color t' yer previously used color.

• Change For th' children shortcode th' final default value if parameter sort=auto an' no ordersectionsby sett'n was found has changed from weight t' default.

  If yer weights be all correctly set ye will not recognize a difference. If ye have duplicate weights on a level or have not set weights at all while sort'n should happen by weight, this change will lead t' a deterministic order while previously it didn’t.

New

• New Th' theme has updated its Merrrmaid dependency t' 11.8.0. This adds support fer radar graphs an' treemaps.