Skip to main content

Version 9.3

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

Change

  • Change Level one headings, the section titles of the sidebar menu and the title of the openapi shortcode are no longer forced to uppercase but show as written. The uppercase look, inherited from the Learn theme, became iconic for this theme, but it is strongly opinionated and looks strange with many fonts, especially script and serif fonts.

    If you want to keep the iconic look for headings and the sidebar menu, add the following to your assets/css/custom.css:

    ​
    h1,
#R-sidebar .nav-title {
  text-transform: uppercase;
}

  • Change The greys of the theme now carry the tint of your theme variant.

    The borders and stripes of tables, the borders of a zoomable Mermaid diagram and of tabs with style=transparent, the shadows of cards and images, the hover of buttons, the titles of badges and the tracks of scrollbars now take their color from the variables BOX-NEUTRAL-color and BOX-GREY-color. BOX-NEUTRAL-color inherits from BOX-GREY-color. Formerly they were a fixed grey that could not be changed by a variant and was too faint in the high contrast variants.

    The border of code blocks, CODE-BLOCK-BORDER-color, now inherits from BOX-NEUTRAL-color instead of CODE-BLOCK-BG-color. The shipped variants were adjusted to this.

    If your own variant does not set CODE-BLOCK-BORDER-color, its code blocks now get a visible border in the neutral color. As code boxes take their color from it, the title and frame of callouts and tabs with style=code change as well. To restore the previous look, set CODE-BLOCK-BORDER-color in your variant to the value of CODE-BLOCK-BG-color, or set BOX-CODE-color to only change code boxes.

    If your variant sets BOX-NEUTRAL-color or BOX-GREY-color to a strong color, all these greys now show it as well.

  • Change The logo of a variant is now set in the new params of the variant, which holds the values that override the site’s params while the variant is active. Setting logo directly on the variant is deprecated and you’ll get a warning; it still works for now.

    Change { identifier = 'neon', logo = { src = '/images/logo-neon.svg' } } to { identifier = 'neon', params = { logo = { src = '/images/logo-neon.svg' } } }.

  • Change Printing a page and its print version now use a print variant, by default relearn-light, with the theme’s print variables made for paper on top of it. Formerly the print used a fixed look that no variant could change.

    Printed pages now also show the logo and title of your site.

    You can choose the print variant of your site with the new themeVariantPrint option, or one for each variant with its new print parameter. A variant that names itself as its print variant keeps its own fonts on paper.

    The variables PRINT-MERMAID-theme, PRINT-OPENAPI-theme and PRINT-OPENAPI-CODE-theme were removed. If you’ve set them, set MERMAID-theme, OPENAPI-theme and OPENAPI-CODE-theme in your copy of the print variables instead, or mark them !important in your print variant.

  • Change The color variant relearn-bright is deprecated and will be removed with the next major release. You’ll get a warning if you use it.

    To keep it, copy assets/css/theme-relearn-bright.css from the theme into your site’s assets/css directory under a different name, like theme-my-bright.css, and use that name in the themeVariant option.

  • Change The color variant relearn has only been kept for compatibility since 3.0.0, where relearn-light replaced it. It will be removed with the next major release and you’ll now get a warning if you use it.

    It is identical to relearn-light, use that name in the themeVariant option instead.

New

  • New The new color variants tome-light and tome-dark give your site the look of a book, with calligraphic titles. They are the first shipped variants with tinted instead of grey content backgrounds, and show how colors the theme derives, like shadows, follow such a tint. Use them as a starting point for your own tinted variant.

    Many of the changes in this release were made to support this variant.

  • New The new color yellow can be used as style in every shortcode taking one and set with BOX-YELLOW-color in your theme variant. Each shipped variant picks a yellow that is readable with its title and text colors.

    To keep it apart from yellow, orange - and with it the note severity - is now a true orange instead of an amber, and darker so its titles are readable as well.

  • New The entries of the variant switcher can now be grouped by putting dividers into the themeVariant option. A divider with a name labels its group.