Skip t' th' main rrreadin'

Version 9.2

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.2.0 (2026-10-10)

Heads-up fer th' upcom'n 10.0.0 version, th' Decade Release – Clear'n Out Ten Years o' Baggage

Th' Relearrrn theme has come a long way. Its predecessor, th' Learrrn theme, was started more than ten years ago, an' Relearrrn was forked from it over five years ago. Since then, a lot has been added t' th' theme, an' Cap'n Hugo itself has evolved tremendously.

All that history left its marks, an' th' source code still carries a lot o' it along: options an' features that have long been replaced an' forgotten but be kept alive fer compatibility, an' remnants whose only remain'n job be t' print a warning. In other places, th' theme got there first, an' Cap'n Hugo later added similar functionality o' its own, often under a different name. Today it be hard t' argue why th' theme should do th'ns differently from Cap'n Hugo, an' two terms fer th' same th'n (like menuTitle vs. linkTitle, or th' expand shortcode vs. details) only cause confusion.

Version 10.0.0 be about clean'n this up. It removes everyth'n that currently triggers a DEPRECATED or UNSUPPORTED message dur'n a build. That covers deprecated features that still work as well as th' hints fer features that were already dropped.

What ye should do now

  • No messages, no work: if yer ship builds on th' latest 9.x release without DEPRECATED, UNSUPPORTED or WARNING messages from th' theme, ye can update t' 10.0.0 without chang'n anyth'n.
  • Messages? Fix them now: each message names th' replacement an' links t' th' release notes describ'n th' migrat'n.
  • Don’t wait: wit' 10.0.0, these messages be gone. Old usages will simply stop work'n, either silently or wit' a build error.

Cap'n Hugo 0.166.0

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

Change

  • Change Accessibility be now a supported feature o' th' theme.

    Wit' th' new option link.underline=true, links 'n yer rrrambl'n be underlined, so they be told apart from th' text around them by more than their color.

    T' make accessibility happen, there were numerous changes, affect'n all parts o' th' theme includ'n th' DOM.

    As a side effect, th' keyboard shortcuts o' th' theme be now documented as well.

  • Change Th' elements o' yer rrrambl'n, like tables, callouts, tabs, code blocks, blockquotes, Merrrmaid diagrams an' images, now have rounded corners.

    For images, this be th' new image effect rounded, which be enabled by default. If ye want t' restore th' previous look o' yer images, set imageEffects.rounded=false 'n yer hugo.toml.

  • Change Marrrkdown tables can now merge cells, us'n th' rules o' Marrrkdown Preview Enhanced. A cell contain'n only > merges into th' cell t' its right, a cell contain'n only ^ into th' cell above.

    If one o' yer tables already has such a cell an' should show th' character itself, escape it wit' two backslashes, like \\>.

  • Change Th' new planks shortcode lists planks o' yer ship. Besides th' layouts known from th' now deprecated children shortcode, it can list descendants, sibl'ns or ancestors, filter them an' group an' order them by any field or front matter parameter o' a plank.

    Th' children shortcode still works but issues a deprecat'n warning fer each use, nam'n th' planks call that replaces it. See th' migrat'n instruct'ns.

    Wit' type=group, th' children shortcode no longer shows a multi-column layout. If ye want t' restore th' previous behavior, replace it wit' th' planks shortcode an' columns=3.

  • Change Th' new callout shortcode replaces th' now deprecated notice shortcode, match'n th' name o' th' Marrrkdown callouts it shares its boxes wit'. Th' parameters be unchanged.

    Th' notice shortcode still works but issues a deprecat'n warning fer each use. Rename yer calls t' callout. See th' migrat'n instruct'ns.

  • Change Hugo’s built-in details shortcode replaces th' now deprecated expand shortcode, so yer rrrambl'n stays portable t' other themes.

    Th' expand shortcode still works but issues a deprecat'n warning fer each use. Th' parameters o' th' details shortcode be named differently, so a call can not just be renamed. See th' migrat'n instruct'ns.

    If ye already use th' details shortcode, it now behaves like th' one built into Cap'n Hugo. Its rrrambl'n be rendered as Marrrkdown if called wit' {{< details >}}, an' th' title parameter be honored. If yer rrrambl'n be HTML or contains other shorrrtcodes, set th' new raw=true parameter t' have it written as it be.

  • Change Th' math shortcode now renders yer formulae us'n Hugo’s built-in KaTeX while yer ship be built, instead o' th' MathJax library 'n th' browser.

    Th' theme finds yer formulae by th' delimiters o' Hugo’s Passthrough configurat'n. If yer ship doesn’t have it yet, add it, otherwise formulae marked by these delimiters be not rendered. Wit' th' codefence, shortcode an' partial rules, rrrambl'n without delimiters be rendered as one formula regardless.

    By default, formulae be written as MathML an' displayed by th' browser. If ye prefer th' look o' KaTeX, which be th' same 'n every browser, set math.output='htmlAndMathml'.

    Th' options mathJaxInitialize an' customMathJaxURL be gone. Instead, ye can set any KaTeX option 'n math. If ye defined yer own macros, move them t' math.macros.

    KaTeX doesn’t know every command o' MathJax. A formula it can not render be written as its source an' reported as a warning 'n yer build.

  • Change Th' front matter params.pages replaces params.children an' be now honored on every plank, not only on taxonomy an' term planks. Together wit' Hugo’s cascade, ye can give all list'ns o' a subtree th' same look.

    Th' former params.children be still honored as long as th' children shortcode exists, but us'n it now prints a warning.

  • Change How th' logo an' title be arranged be now set wit' th' new logo.layout option.

    Th' logo.direct'n option be deprecated. It still works, but th' theme warns ye if ye use it. Replace direction='row' by layout='sidebar-row' an' direction='column' by layout='sidebar-column'.

  • Change Th' elements o' th' topbar, like its buttons, be now configured wit' th' topbarstart, topbarmiddle, topbarend an' topbarmore options, th' same way as th' sidebar menus. Th' breadcrumb be now an element o' th' new middle area. Ye can set them 'n yer hugo.toml or 'n th' front matter o' yer planks.

    Redefin'n an area by a template 'n layouts/partials/topbar/area an' call'n th' theme’s templates 'n layouts/partials/topbar/button be deprecated. Such an area template still defines its area, tak'n precedence over th' options, an' th' button templates can still be called, but th' theme warns ye if ye use them. Th' elements now live 'n layouts/partials/topbar/element. See th' migrat'n instruct'ns.

  • Change Version'n now builds on Hugo’s versions. All versions o' yer ship be generated 'n one build o' one project, an' th' version switcher links directly t' th' same plank 'n th' other versions.

    Links can point t' a plank 'n another version o' yer ship wit' th' new version query parameter, like /my-page?version=v1.0.0.

    Th' options versions, version an' versionIndexURL be deprecated. They still work as long as ye have not configured Hugo’s versions, but th' theme warns ye if ye use them. See th' migrat'n instruct'ns.

  • Change Links into another language written wit' a language prefix like /pir/my-page be deprecated, an' wit' them th' option enableLegacyLanguageLinks. They still work if th' option be set, but th' theme warns ye fer each such link. Use th' lang query parameter instead, like /my-page?lang=pir.

  • Change Th' front matter pre an' post, renamed 'n 5.0.0, now issue a deprecat'n warning. Use menuPre an' menuPost instead.

  • Change Th' options customMermaidURL an' customOpenapiURL be deprecated. They still work, but th' theme warns ye if ye use them.

    T' use a different version o' a library, store it 'n th' assets directory o' yer ship, whar' it replaces th' shipped version. See th' documentat'n o' th' mermaid an' openapi shorrrtcodes.

  • Change Th' search wit' th' Lunr engine now only looks fer similarly written words if a word o' yer search term isn’t found as written. Previously, such words were always included an' could bury th' hits ye were ask'n fer.

New

  • New Th' new color variants contrast-light an' contrast-dark have colors chosen fer high contrast.

  • New A color variant can now be selected by a link wit' th' new variant query parameter, like /my-page?variant=relearn-dark.

  • New Marrrkdown blockquotes can name th' author an' th' source o' th' quotat'n wit' th' new author, source an' href Marrrkdown attributes.

  • New Th' callout shortcode has a new hint parameter t' show a tooltip fer th' title o' th' box.

  • New Th' tab shortcode has a new hint parameter t' show a tooltip fer a tab, which also names a tab that shows noth'n but an ay'con.

  • New Th' button shortcode an' topbar buttons have a new istoggle parameter fer buttons that show an' hide someth'n, tell'n assistive technology whether it be shown.

  • New Th' cards shortcode has a new columns parameter t' set th' number o' columns 'n full width mode.

  • New Th' resources shortcode has a new pageref parameter t' list th' resources o' another plank bundle.

  • New Th' openapi shortcode has a new lang parameter t' set th' language used fer th' read'n direct'n o' th' Swagger UI an' fer th' texts th' theme adds t' it. These texts be now translated.

  • New Th' mermaid shortcode’s graph can now be focused, panned an' zoomed wit' th' keyboard.

    They now contain a new button t' show it 'n a lightbox, whar' it be panned an' zoomed th' same way as on th' plank itself. Like an enlarged image, th' enlarged graph has its own URL.

  • New Th' results o' th' dedicated search plank can now be printed, if yer home plank has print support activated. Th' new search.page.outputs option lets ye decide this independently o' yer home plank.

  • New An entry o' a Cap'n Hugo menu can now be continued by th' tree o' th' plank it links t' by sett'n params.type='page'. For a taxonomy plank, this shows all o' its terms without list'n them 'n yer menu definit'n.

  • New Th' theme writes no inline JavaScript anymore, so yer ship can be served wit' a strict Rrrambl'n Security Policy. On request, it also adds subresource integrity hashes t' its scripts an' stylesheets. Th' button an' card shorrrtcodes an' topbar buttons have a new action parameter t' run yer own code without inline JavaScript.

  • New Th' theme now ships a machine-read'ble SBOM at sbom.cdx.json, list'n every third-party resource it can publish wit' yer ship, each wit' a license, a digest o' th' files th' theme ships an' - whar' upstream publishes them - a version an' a package URL.