<metaname="description"content="5.27.0 (2024-04-07) Cap'n Hugo 0.121.0 0.121.0 This release requires a newer Cap'n Hugo version. Change Change If th' theme be configured t' generate warnings or errors dur'n build by sett'n image.errorlevel t' either warning or error 'n yer hugo.toml, it will now also generate output if a link fragment be not found 'n th' target plank.">
<metaname="twitter:title"content="Version 5 :: Cap'n Hugo Relearrrn Theme">
<metaname="twitter:description"content="5.27.0 (2024-04-07) Cap'n Hugo 0.121.0 0.121.0 This release requires a newer Cap'n Hugo version. Change Change If th' theme be configured t' generate warnings or errors dur'n build by sett'n image.errorlevel t' either warning or error 'n yer hugo.toml, it will now also generate output if a link fragment be not found 'n th' target plank.">
<metaproperty="og:title"content="Version 5 :: Cap'n Hugo Relearrrn Theme">
<metaproperty="og:description"content="5.27.0 (2024-04-07) Cap'n Hugo 0.121.0 0.121.0 This release requires a newer Cap'n Hugo version. Change Change If th' theme be configured t' generate warnings or errors dur'n build by sett'n image.errorlevel t' either warning or error 'n yer hugo.toml, it will now also generate output if a link fragment be not found 'n th' target plank.">
<metaitemprop="name"content="Version 5 :: Cap'n Hugo Relearrrn Theme">
<metaitemprop="description"content="5.27.0 (2024-04-07) Cap'n Hugo 0.121.0 0.121.0 This release requires a newer Cap'n Hugo version. Change Change If th' theme be configured t' generate warnings or errors dur'n build by sett'n image.errorlevel t' either warning or error 'n yer hugo.toml, it will now also generate output if a link fragment be not found 'n th' target plank.">
<li><spanclass="badge cstyle default badge-with-title"><spanclass="badge-title"><iclass="fa-fw fab fa-hackerrank"></i></span><spanclass="badge-content"style="background-color: fuchsia;">0.121.0</span></span> This release requires a newer Cap'n Hugo version.</li>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> If th' theme be configured t' generate warnings or errors dur'n build by sett'n <code>image.errorlevel</code> t' either <code>warning</code> or <code>error</code> 'n yer <code>hugo.toml</code>, it will now also generate output if a link fragment be not found 'n th' target plank.</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Th' <ahref="/hugo-theme-relearn/pir/configuration/customization/dependencies/index.html">dependency loader</a> was made more versatile.</p>
<p>Th' configurat'n 'n yer <code>hugo.toml</code> does not require th' <code>locat'n</code> parameter anymore. If ye still use it, th' theme will work as before but will generate a warning. So ye don’t need t' change anyth'n, yet.</p>
<p>Wit' th' new mechanism, yer dependency loader now receives an additional <code>locat'n</code> parameter instead that ye can query t' inject yer dependencies 'n th' desired locat'n.</p>
<p>By that ye can now call th' dependency mechanism 'n yer own overriden partials by giv'n it a distinct <code>locat'n</code> parameter. In addit'n yer injected files can now be spread t' multiple locat'ns which wasn’t previously poss'ble.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Additional styl'n was added fer th' native HTML elements <code><mark></code> an' <code><kbd></code>. T' use them ye must allow th' <ahref="https://gohugo.io/getting-started/configuration-markup/#rendererunsafe"rel="external"target="_self">usage o' HTML</a> 'n yer <code>hugo.toml</code>. Th' <ahref="/hugo-theme-relearn/pir/authoring/markdown/index.html#standard-and-extensions">Marrrkdown documentat'n</a> was enhanced fer this.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Ye now can scroll forward an' backward through all head'ns o' a plank by us'n <kbd>ALT</kbd><kbd>🡑</kbd> an' <kbd>ALT</kbd><kbd>🡓</kbd>. This also works fer th' <code>PRINT</code> output format.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' breadcrumbs used 'n th' topbar, search results an' th' taxonomy term lists be now us'n th' planks front matter <code>linktitle</code> instead o' <code>title</code> if set.
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' lazy load'n o' images be now configur'ble by us'n th' new <code>lazy</code><ahref="/hugo-theme-relearn/pir/configuration/customization/imageeffects/index.html">image effect</a>. Th' default value hasn’t changed 'n comparison t' older versions, ye don’t need t' change anyth'n.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> It be now poss'ble t' <ahref="/hugo-theme-relearn/pir/configuration/content/width/index.html">adjust th' max width o' th' main area</a>, eg. 'n case ye want t' use th' full plank width fer yer rrrambl'n.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' theme has updated its Merrrmaid dependency t' 10.6.0. This adds support fer <ahref="/hugo-theme-relearn/pir/shortcodes/mermaid/index.html#block-diagram">block diagrams</a>.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> This release fixes a long-stand'n bug whar' th' plank wasn’t reposition'n correctly when go'n forward or backward 'n yer browser history.
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> This release deprecates th' <ahref="/hugo-theme-relearn/pir/shortcodes/attachments/index.html"><code>attachments</code> shortcode</a> 'n favor o' th' new th' <ahref="/hugo-theme-relearn/pir/shortcodes/resources/index.html"><code>resources</code> shortcode</a>.</p>
<p>If ye be us'n Hugo below <spanclass="badge cstyle default badge-with-title"><spanclass="badge-title"><iclass="fa-fw fab fa-hackerrank"></i></span><spanclass="badge-content"style="background-color: fuchsia;">0.123.0</span></span>, ye don’t need t' change anyth'n as th' old shortcode still works (but may generate warnings).</p>
<p>Anyways, users be strongly advised t' migrate as th' <code>attachments</code> shortcode will not receive support anymore. Migrat'n instruct'ns be listed on th' <ahref="/hugo-theme-relearn/pir/shortcodes/attachments/index.html#migration"><code>attachments</code> shortcode plank</a>.</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> If ye run Hugo wit' <ahref="https://gohugo.io/methods/page/gitinfo/"rel="external"target="_self">GitInfo</a> configured, th' default plank footer now prints out name, email address an' date o' th' last commit. If ye want t' turn this off ye either have t' run Hugo without GitInfo (which be th' default) or overwrite th' <code>content-footer.html</code> partial.
<li><spanclass="badge cstyle default badge-with-title"><spanclass="badge-title"><iclass="fa-fw fab fa-hackerrank"></i></span><spanclass="badge-content"style="background-color: fuchsia;">0.112.4</span></span> This release requires a newer Cap'n Hugo version.</li>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Th' topbar button received a way t' add text next t' th' ay'con. For this, th' original <code>title</code> opt'n was renamed t' <code>hint</code> while th' new <code>title</code> opt'n be now displayed next t' th' ay'con.</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Th' front matter opt'n <code>menuTitle</code> be now deprecated 'n favor fer Hugo’s own <code>linkTitle</code>. Ye don’t need t' change anyth'n as th' old <code>menuTitle</code> opt'n be still supported.</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Th' light themes have a bit more contrast fer rrrambl'n text an' head'ns. Also th' syntaxhighlight'n was changed t' th' more colorful MonokaiLight. This br'ns th' syntaxhighlight'n 'n sync wit' th' correspond'n dark theme variants, which be us'n Monokai. If ye dislike this, ye can create yer own color variant file as <ahref="/hugo-theme-relearn/pir/configuration/branding/colors/index.html#modifying-variants">described here</a>.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> If th' theme can not resolve a link t' a plank or image, ye can now generate warnings or errors dur'n build by sett'n <code>link.errorlevel</code> or <code>image.errorlevel</code> t' either <code>warning</code> or <code>error</code> 'n yer <code>hugo.toml</code> respectively. By default this condit'n be silently ignored an' th' link be written as-is.</p>
<p>Please note that a plank link will generate false negatives if <code>uglyURLs=true</code> an' it references an ordinary plank before <spanclass="badge cstyle default badge-with-title"><spanclass="badge-title"><iclass="fa-fw fab fa-hackerrank"></i></span><spanclass="badge-content"style="background-color: fuchsia;">0.123.0</span></span>.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Ye now can configure additional opt'ns fer every theme variant 'n yer <code>hugo.toml</code>. This allows fer optional <ahref="/hugo-theme-relearn/pir/configuration/branding/colors/index.html#theme-variant-advanced">advanced functionality</a>. Ye don’t need t' change anyth'n as th' old configurat'n opt'ns will still work (but may generate warnings now).</p>
<p>Th' advanced functionality allows ye t' set an explicit name fer a theme variant an' now allows fer multiple auto mode variants that adjust t' th' light/dark preference o' yer OS sett'ns.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> New partial fer defin'n th' head'n. See <ahref="/hugo-theme-relearn/pir/configuration/customization/partials/index.html">documentat'n</a> fer further read'n.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Support fer Hugo’s built-in <ahref="https://gohugo.io/content-management/shortcodes/#figure"rel="external"target="_self"><code>figure</code> shortcode</a>.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> On taxonomy an' term planks ye can now use prev/next navigat'n as within th' normal plank structure.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> In additiion t' th' exist'n <ahref="/hugo-theme-relearn/pir/configuration/sidebar/width/index.html">menu width customizat'n</a>, it be now also poss'ble t' set th' width o' th' menu flyout fer small screen sizes wit' th' <code>--MENU-WIDTH-S</code> CSS property.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Improvements fer accessibility when tabb'n through th' plank fer images, links an' tab handles.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' <code>editURL</code> config parameter be now <ahref="/hugo-theme-relearn/pir/authoring/frontmatter/reference/index.html">overwrit'ble 'n yer planks front matter</a>. In addit'n it received more versatility by lett'n ye control whar' t' put th' file path into th' URL. This be achieved by replac'n th' vari'ble <code>${FilePath}</code> 'n yer URL by th' planks file path. Ye don’t need t' change anyth'n 'n yer exist'n configurat'n as th' old way without th' replacement vari'ble still works.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Restored compatibility wit' Cap'n Hugo versions <spanclass="badge cstyle default badge-with-title"><spanclass="badge-title"><iclass="fa-fw fab fa-hackerrank"></i></span><spanclass="badge-content"style="background-color: fuchsia;">0.121.0</span></span> or higher fer th' <ahref="/hugo-theme-relearn/pir/shortcodes/highlight/index.html"><code>highlight</code> shortcode</a>. This does not change th' minimum required Cap'n Hugo version.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Restored compatibility wit' Cap'n Hugo versions <spanclass="badge cstyle default badge-with-title"><spanclass="badge-title"><iclass="fa-fw fab fa-hackerrank"></i></span><spanclass="badge-content"style="background-color: fuchsia;">0.123.0</span></span> or higher fer theme specific output formats an' handl'n o' taxonomy an' term titles. This does not change th' minimum required Cap'n Hugo version.
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Wit' <spanclass="badge cstyle default badge-with-title"><spanclass="badge-title"><iclass="fa-fw fab fa-hackerrank"></i></span><spanclass="badge-content"style="background-color: fuchsia;">0.120.0</span></span> th' author sett'ns move into th' <code>[params]</code> array 'n yer <code>hugo.toml</code>. Because this collides wit' th' previous way, th' theme expected author informat'n, it now adheres t' Cap'n Hugo standards an' prints out a warning dur'n built if someth'n be wrong.</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Taxonomy <ahref="https://gohugo.io/content-management/taxonomies#add-custom-metadata-to-a-taxonomy-or-term"rel="external"target="_self">term planks</a> now add th' breadcrumb fer each listed plank. If this gets too crowded fer ye, ye can turn th' breadcrumbs off 'n yer <code>hugo.toml</code> by add'n <code>disableTermBreadcrumbs=true</code>.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Taxonomy an' term planks be now allowed t' contain rrrambl'n. This be added inbetween th' title an' th' plank list.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> It be now poss'ble t' print custom taxonomies anywhere 'n yer plank. <ahref="/hugo-theme-relearn/pir/configuration/customization/taxonomy/index.html#setting-up-custom-taxonomies">See th' docs</a>.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> It be now poss'ble t' adjust th' menu width fer yer whole ship. <ahref="/hugo-theme-relearn/pir/configuration/sidebar/width/index.html">See th' docs</a>.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> This release adds social media meta tags fer th' Open Graph protocol an' Twitter Cards t' yer ship. <ahref="/hugo-theme-relearn/pir/authoring/meta/index.html">See th' docs</a>.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> This release comes wit' additional sort opt'ns fer th' menu an' th' <ahref="/hugo-theme-relearn/pir/shortcodes/children/index.html"><code>children</code> shortcode</a>. Both will now accept th' follow'n values: <code>weight</code>, <code>title</code>, <code>linktitle</code>, <code>modifieddate</code>, <code>expirydate</code>, <code>publishdate</code>, <code>date</code>, <code>length</code> or <code>default</code> (adher'n t' Hugo’s default sort order).</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' theme now provides a mechanism t' board further JavaScript dependencies defined by ye only if it be needed. This comes 'n handy if ye want t' add own shorrrtcodes that depend on additional JavaScript code t' be boarded. <ahref="/hugo-theme-relearn/pir/configuration/customization/dependencies/index.html">See th' docs</a>.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' theme has updated its Merrrmaid dependency t' 10.6.0. This adds support fer th' <ahref="/hugo-theme-relearn/pir/shortcodes/mermaid/index.html#xychart">xychart type</a>.</p>
<p>Previously it was not poss'ble t' use pure Marrrkdown links 'n a configurat'n independent way t' link t' planks inside o' yer project. It always required ye t' know how yer <code>uglyURLs</code> sett'n be, wheather ye link t' a plank or plank bundle an' 'n case o' relative links if yer current plank be a plank or plank bundle. (eg. <code>[generator](generator/index.html)</code> vs. <code>[generator](generator.html)</code>). This be a hassle as ye have t' change these links manually once ye change yer <code>uglyURLs</code> sett'n or change th' type o' a plank.</p>
<p>Ye could work around this by us'n th' <code>relref</code> shortcode (eg <code>[generator]({{% relref "../generator" %}})</code>) which works but results 'n non-port'ble Marrrkdown.</p>
<p>Now it’s poss'ble t' use th' same path o' a call t' <code>relref</code> 'n a plain Marrrkdown link (eg <code>[generator](../generator)</code>). This be independent o' any configurat'n sett'ns or th' plank types involved 'n link'n. Avast, that this requires yer links t' be given without any extension, so <code>[generator](generator/index.html)</code> will work as before.</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> This release fixes an issue whar' 'n unfortunate condit'ns DOM ids generated by Cap'n Hugo may collide wit' DOM ids set by th' theme. T' avoid this, all theme DOM ids be now prefixed wit' <code>R-</code>.</p>
<p>If ye haven’t modified anyth'n, everyth'n be fine. Otherwise ye have t' check yer custom CSS rules an' JavaScript code.</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Ye can now have structural sections 'n th' hierarchical menu without generat'n a plank fer it.</p>
<p>This can come 'n handy, if rrrambl'n fer such a section plank doesn’t make much sense t' ye. See <ahref="/hugo-theme-relearn/pir/authoring/frontmatter/navigationmenu/index.html#disable-section-pages">th' documentat'n</a> fer how t' do this.</p>
<p>This feature may require ye t' make changes t' yer exist'n installat'n if ye be already us'n <em><ahref="/hugo-theme-relearn/pir/configuration/sidebar/shortcutmenu/index.html#displaying-pages-only-in-the-shortcuts-menu">shortcuts t' planks inside o' yer project</a></em> wit' a <em>headless branch parent</em>.</p>
<p>In this case it be advised t' remove th' <code>title</code> from th' headless branch parent’s front matter, as it will otherwise appear 'n yer breadcrumbs.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> It be now poss'ble t' overwrite th' sett'n fer <code>collapsibleMenu</code> o' yer <code>hugo.toml</code> inside o' a page’s front matter.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> If a Merrrmaid graph be zoom'ble a button t' reset th' view be now added t' th' upper right corner. Th' button be only shown once th' mouse be moved over th' graph.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> It be now poss'ble t' remove th' root breadcrumb by sett'n <code>disableRootBreadcrumb=true</code> 'n yer <code>hugo.toml</code>.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> T'ble rows now change their background color on every even row.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Translat'n into Swahili. This language be not supported fer search.
<li><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> We made changes t' th' menu footer t' improve alignment wit' th' menu items 'n most cases. Care was taken not t' break yer exist'n overwritten footer. Anyways, if ye have yer <code>menu-footer.html</code><ahref="/hugo-theme-relearn/pir/configuration/customization/partials/index.html">partial overridden</a>, ye may want t' review th' styl'n (eg. margins/paddings) o' yer partial.</li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> This release comes wit' an awesome new feature, that allows ye t' cust'mize yer topbar buttons, change behavior, reorder them or define entirely new ones, unique t' yer installat'n. See <ahref="/hugo-theme-relearn/pir/configuration/customization/topbar/index.html">th' documentat'n</a> fer further details.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' theme has updated its Swagger dependency t' 5.7.2 fer th' <ahref="/hugo-theme-relearn/pir/shortcodes/openapi/index.html"><code>openapi</code> shortcode</a>. This br'ns support fer OpenAPI Specificat'n 3.1.
<p>Wit' this comes a change 'n th' light theme variants o' <code>Relearrrn Bright</code>, <code>Relearrrn Light</code> an' <code>Zen Light</code> by switch'n th' syntaxhighlight'n inside o' openapi t' a light scheme. This br'ns it more 'n sync wit' th' code style used by th' theme variants itself.</p>
<p>Additionally, th' syntaxhighlight'n inside o' openapi fer print'n was switched t' a light scheme fer all theme variants.</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> For consistency reasons, we renamed th' CSS vari'ble <code>--MENU-SECTION-HR-color</code> t' <code>--MENU-SECTION-SEPARATOR-color</code>. Ye don’t need t' change anyth'n 'n yer custom color stylesheet as th' old name will be used as a fallback.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' default values fer th' <ahref="/hugo-theme-relearn/pir/authoring/markdown/index.html#image-effects">image effects</a> be <ahref="/hugo-theme-relearn/pir/configuration/customization/imageeffects/index.html">now configur'ble</a> fer yer whole ship via <code>hugo.toml</code> or fer each plank through front matter.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> This release fixes a long-stand'n bug whar' Merrrmaid graphs could not be displayed if they were initially hidden - like 'n collapsed <code>expand</code> or inactive <code>tabs</code>.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Restored compatibility wit' Cap'n Hugo versions lower than <spanclass="badge cstyle default badge-with-title"><spanclass="badge-title"><iclass="fa-fw fab fa-hackerrank"></i></span><spanclass="badge-content"style="background-color: fuchsia;">0.111.0</span></span> fer th' <ahref="/hugo-theme-relearn/pir/shortcodes/highlight/index.html"><code>highlight</code> shortcode</a>. This does not change th' minimum required Cap'n Hugo version.
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' <ahref="/hugo-theme-relearn/pir/shortcodes/highlight/index.html"><code>highlight</code> shortcode</a> now accepts th' new parameter <code>title</code>. This displays th' code like a <ahref="/hugo-theme-relearn/pir/shortcodes/tab/index.html">single tab</a>. This be also avail'ble us'n Marrrkdown codefences an' makes it much easier t' write nicer code samples.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' theme has added two new color variants <code>zen-light</code> an' <code>zen-dark</code>. Check it out!</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' theme now <ahref="/hugo-theme-relearn/pir/configuration/branding/colors/index.html#react-to-variant-switches-in-javascript">dispatches th' custom event</a><code>themeVariantLoaded</code> on th' <code>document</code> when th' variant be fully boarded either initially or by switch'n th' variant manually wit' th' variant selector.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' theme has updated its Merrrmaid dependency t' 10.3.1. This adds support fer th' <ahref="/hugo-theme-relearn/pir/shortcodes/mermaid/index.html#sankey">sankey diagram type</a> an' now comes wit' full support fer YAML inside Merrrmaid graphs (previously, th' theme ignored explicit Merrrmaid theme sett'ns 'n YAML).</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Translat'n into Hungarian.
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> There be visual improvements 'n display'n text links 'n yer rrrambl'n as well as t' some other click'ble areas 'n th' theme. If you’ve overwritten some theme styles 'n yer own CSS, keep this 'n mind.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Restored compatibility wit' Cap'n Hugo <spanclass="badge cstyle default badge-with-title"><spanclass="badge-title"><iclass="fa-fw fab fa-hackerrank"></i></span><spanclass="badge-content"style="background-color: fuchsia;">0.95.0</span></span> or higher. This does not change th' minimum required Cap'n Hugo version.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' <ahref="/hugo-theme-relearn/pir/shortcodes/siteparam/index.html"><code>siteparam</code> shortcode</a> be now cap'ble 'n display'n nested params as well as support'n text formatt'n.
<p>If ye dislike this new behavior ye can turn it off an' revert t' th' old behavior by add'n <code>[params] disableHoverBlockCopyToClipBoard=true</code> t' yer <code>hugo.toml</code>.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Restored compatibility wit' Cap'n Hugo <spanclass="badge cstyle default badge-with-title"><spanclass="badge-title"><iclass="fa-fw fab fa-hackerrank"></i></span><spanclass="badge-content"style="background-color: fuchsia;">0.114.0</span></span> or higher. This does not change th' minimum required Cap'n Hugo version.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' new <ahref="/hugo-theme-relearn/pir/shortcodes/highlight/index.html"><code>highlight</code> shortcode</a> replaces Hugo’s default implementat'n an' be fully compat'ble. So ye don’t need t' change anyth'n.</p>
<p>In addit'n it offers some extensions. Currently only th' <code>wrap</code> extension opt'n be provided t' control whether a code block should be wrapped or scrolled if t' long t' fit.
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Th' theme now provides warnings fer deprecated or now unsupported features. Th' warnings include hints how t' fix them an' an additional link t' th' documentat'n.</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Th' 404 error plank was revamped. Hopefully ye will not see this very often.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' <ahref="/hugo-theme-relearn/pir/shortcodes/tabs/index.html"><code>tabs</code> shortcode</a> an' th' <ahref="/hugo-theme-relearn/pir/shortcodes/tab/index.html"><code>tab</code> shortcode</a> received some love an' now align wit' their style, color, title an' ay'con parameter t' th' other shorrrtcodes.</p>
<p>Th' visuals be now slightly different compared t' previous versions. Most note'ble, if ye now display a single code block 'n a tab, its default styl'n will adapt t' that o' a code block but wit' a tab handle at th' top.</p>
<p>Additionally th' <code>name</code> parameter was renamed t' <code>title</code> but ye don’t need t' change anyth'n yet as th' old name will be used as a fallback. Nevertheless ye will get deprecat'n warnings while execut'n Hugo.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' theme now optionally supports <ahref="/hugo-theme-relearn/pir/configuration/branding/logo/index.html#change-the-favicon">separate favicons</a> fer light & dark mode.
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Restored compatibility wit' Cap'n Hugo <spanclass="badge cstyle default badge-with-title"><spanclass="badge-title"><iclass="fa-fw fab fa-hackerrank"></i></span><spanclass="badge-content"style="background-color: fuchsia;">0.112.0</span></span> or higher. This does not change th' minimum required Cap'n Hugo version.</p>
<p>Th' <ahref="/hugo-theme-relearn/pir/shortcodes/attachments/index.html"><code>attachments</code> shortcode</a> has compatibility issues wit' newer Cap'n Hugo versions. Ye must switch t' leaf bundles or be locked t' Cap'n Hugo <<code>0.112.0</code> fer now.</p>
<p>It be <ahref="https://github.com/McShelby/hugo-theme-relearn/issues/22"rel="external"target="_self">planned t' refactor</a> th' <code>attchments</code> shortcode 'n th' future. This will make it poss'ble t' use th' shortcode 'n branch bundles again but not 'n simple planks anymore. This will most likely come wit' a break'n change.</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Th' <ahref="/hugo-theme-relearn/pir/shortcodes/tabs/index.html"><code>tabs</code> shortcode</a> has changed behavior if ye haven’t set th' <code>groupid</code> parameter.</p>
<p>Formerly all tab views without a <code>groupid</code> were treated as so they belong t' th' same group. Now, each tab view be treated as it was given a unique id.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' already known <code>tabs</code>has a new friend th' <ahref="/hugo-theme-relearn/pir/shortcodes/tab/index.html"><code>tab</code> shortcode</a> t' make it easier t' create a tab view 'n case ye only need one single tab. Really handy if ye want t' flag yer code examples wit' a language identifier.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Besides th' <em>tag</em><ahref="/hugo-theme-relearn/pir/configuration/customization/taxonomy/index.html">taxonomy</a> th' theme now also provides th' <em>category</em> taxonomy out o' th' box an' shows them 'n th' rrrambl'n footer o' each plank.
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' taxonomy planks received some love 'n this release, mak'n them better leverage avail'ble screen space an' add'n translat'n support fer th' taxonomy names.</p>
<p>Hugo’s default taxonmies <code>tags</code> an' <code>categories</code> be already contained 'n th' theme’s i18n files. If ye have self-defined taxonomies, ye can add translat'ns by add'n them t' yer own i18n files. If ye don’t provide translat'ns, th' singualar an' plural forms be taken as configured 'n yer <code>hugo.toml</code>.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> T' give ye more flexibility 'n customiz'n yer article layout a new partial <code>content-header.html</code> be introduced.</p>
<p>This came out o' th' requirement t' cust'mize th' posit'n o' article tags, which by default be displayed above th' title. A second requirement was t' also show additional <ahref="https://gohugo.io/content-management/taxonomies/"rel="external"target="_self">taxonomies</a> not supported by th' theme natively. While Cap'n Hugo supports tags an' categories by default, th' theme only displays tags.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' new parameter <code>breadcrumbSeparator</code> be now avail'ble 'n yer <code>hugo.toml</code> t' change th' - well - separator o' th' breadcrumb items. An appropriate default be 'n place if ye do not configure anyth'n.
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Th' <code>swagger</code> shortcode was deprecated 'n favor fer th' <ahref="/hugo-theme-relearn/pir/shortcodes/openapi/index.html"><code>openapi</code> shortcode</a>. Ye don’t need t' change anyth'n yet as th' old name will be used as a fallback. It be planned t' remove th' <code>swagger</code> shortcode 'n th' next major release.</p>
<p>Additionally, th' implemant'n o' this shortcode was switched from RapiDoc t' <ahref="https://github.com/swagger-api/swagger-ui"rel="external"target="_self">SwaggerUI</a>.
<li><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> In th' effort t' comply wit' WCAG standards, th' implementat'n o' th' collaps'ble menu was changed (again). While Internet Explorer 11 has issues 'n display'n it, th' functionality still works.</li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Support fer th' great <ahref="https://github.com/estruyf/vscode-front-matter"rel="external"target="_self">VSCode Front Matter CMS extension</a> which provides on-premise CMS capabilties t' Cap'n Hugo.</p>
<p>Th' theme provides Front Matter CMS snippets fer its shorrrtcodes. Currently only English an' German be supported. Put a reference into yer <code>frontmatter.json</code> like this</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Support fer languages that be written right t' left (like Arabic) be now complete an' extended t' th' menu, th' top navigat'n bar an' print. Ye can experience this 'n th' <ahref="/hugo-theme-relearn/pir/pir/index.html">pirate translat'n</a>. This feature be not avail'ble 'n Internet Explorer 11.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' scrollbars be now colored accord'n t' their variant color scheme t' better fit into th' visuals.
<p>In case ye made changes t' th' theme that be depend'n on this library ye can place a copy o' jQuery into yer <code>static/js</code> directory an' board it from yer own <code>layouts/partials/custom-header.html</code> like this:</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span><ahref="/hugo-theme-relearn/pir/shortcodes/mermaid/index.html#parameter">Merrrmaid</a> diagrams can now be configured fer pan an' zoom on site-, page-level or individually fer each graph.</p>
<p>Th' default sett'n o' <code>on</code>, 'n effect since 1.1.0, changed back t' <code>off</code> as there was interference wit' scroll'n on mobile an' big planks.</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Th' JavaScript code fer handl'n image lightboxes (provided by <ahref="https://noelboss.github.io/featherlight"rel="external"target="_self">Featherlight</a>) was replaced by a CSS-only solut'n.</p>
<p>This also changed th' <ahref="/hugo-theme-relearn/pir/authoring/markdown/index.html#lightbox">lightbox effects</a> parameter from <code>featherlight=false</code> t' <code>lightbox=false</code>. Nevertheless ye don’t need t' change anyth'n as th' old name will be used as a fallback.</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> In th' effort t' comply wit' WCAG standards, th' implementat'n o' th' <ahref="/hugo-theme-relearn/pir/shortcodes/expand/index.html"><code>expand</code> shortcode</a> was changed. While Internet Explorer 11 has issues 'n display'n it, th' functionality still works.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Translat'n into Czech. This language be not supported fer search.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span><ahref="https://github.com/McShelby/hugo-theme-relearn/tags"rel="external"target="_self">GitHub releases</a> be also now tagged fer th' main version (eg. <code>1.2.x</code>), major version (eg. <code>1.x</code>) an' th' latest (just <code>x</code>) release mak'n it easier fer ye t' pin th' theme t' a certain version.
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' <ahref="/hugo-theme-relearn/pir/shortcodes/attachments/index.html"><code>attachments</code></a>, <ahref="/hugo-theme-relearn/pir/shortcodes/badge/index.html"><code>badge</code></a>, <ahref="/hugo-theme-relearn/pir/shortcodes/button/index.html"><code>button</code></a> an' <ahref="/hugo-theme-relearn/pir/shortcodes/notice/index.html"><code>notice</code></a> shorrrtcodes have a new parameter <code>color</code> t' set arbitrary CSS color values.</p>
<p><spanclass="badge cstyle warning badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-triangle"></i></span><spanclass="badge-content">Break'n</span></span> Wit' this version it be now poss'ble t' not only have sections on th' first menu level but also planks.</p>
<p>It was later discovered, that this causes planks only meant t' be displayed 'n th' <code>More</code> section o' th' menu an' stored directly inside yer <code>rrrambl'n</code> directory t' now show up 'n th' menu as well.</p>
<p>T' <ahref="/hugo-theme-relearn/pir/configuration/sidebar/shortcutmenu/index.html#displaying-pages-only-in-the-shortcuts-menu">get rid</a> o' this undesired behavior ye have two choices:</p>
<p>Make th' plank file a <ahref="https://gohugo.io/content-management/page-bundles/#headless-bundle"rel="external"target="_self">headless branch bundle</a> (contained 'n its own subdirectory an' called <code>_index.md</code>) an' add th' follow'n front matter configurat'n t' th' file (see exampleSite’s <code>content/showcase/_index.en.md</code>). This causes its rrrambl'n t' <strong>not</strong> be ontained 'n th' sitemap.</p>
<p>Store th' plank file fer below a parent headless branch bundle an' add th' follow'n front matter t' he <strong>parent</strong> (see exampleSite’s <code>content/more/_index.en.md</code>). <strong>Don’t give this plank a <code>title</code></strong> as this will cause it t' be shown 'n th' breadcrumbs - a th'n ye most likely don’t want.</p>
<p>In this case, th' file itself can be a branch bundle, leaf bundle or simple plank (see exampleSite’s <code>content/more/credits.en.md</code>). This causes its rrrambl'n t' be contained 'n th' sitemap.</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Th' required directory name fer th' <ahref="/hugo-theme-relearn/pir/shortcodes/attachments/index.html"><code>attachments</code> shortcode</a> was changed fer leaf bundles.</p>
<p>Previously, th' attachments fer leaf bundles 'n non-multilang setups were required t' be 'n a <code>files</code> subdirectory. For plank bundles an' leaf bundles 'n multilang setups they were always required t' be 'n a <code>_index.<LANGCODE>.files</code> or <code>index.<LANGCODE>.files</code> subdirectory accordingly.</p>
<p>This added unnecessary complexity. So attachments fer leaf bundles 'n non-multilang setups can now also reside 'n a <code>index.files</code> directory. Although th' old <code>files</code> directory be now deprecated, if both directories be present, only th' old <code>files</code> directory will be used fer compatibility.</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Absolute links prefixed wit' <code>http://</code> or <code>https://</code> be now opened 'n a separate browser tab.</p>
<p>Ye can revert back t' th' old behavior by defin'n <code>externalLinkTarget="_self"</code> 'n th' <code>params</code> section o' yer <code>hugo.toml</code>.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' new <ahref="/hugo-theme-relearn/pir/shortcodes/badge/index.html"><code>badge</code> shortcode</a> be now avail'ble t' add highly configur'ble markers t' yer rrrambl'n as ye can see it on this plank.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' new <ahref="/hugo-theme-relearn/pir/shortcodes/icon/index.html"><code>ay'con</code> shortcode</a> simplyfies th' usage o' ay'cons. This can even be combined wit' also new <code>badge</code> shortcode.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> A new color <code>--ACCENT-color</code> was introduced which be used fer highlight'n search results on th' plank. In case ye simply don’t care, ye don’t need t' change anyth'n 'n yer variant stylesheet as th' old <code>yellow</code> color be still used as default.
<li><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Th' Korean language translat'n fer this theme be now avail'ble wit' th' language code <code>ko</code>. Formerly th' country code <code>kr</code> was used instead.</li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' <ahref="/hugo-theme-relearn/pir/shortcodes/button/index.html"><code>button</code> shortcode</a> can now also be used as a real button inside o' HTML forms - although this be a pretty rare use case. Th' documentat'n was updated accordingly.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' search now supports th' Korean language.
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> This release introduces an additional dedicated search plank. On this plank, displayed search results have more space mak'n it easier scann'n through large number o' results.</p>
<p>T' activate this feature, ye need t' <ahref="/hugo-theme-relearn/pir/configuration/sidebar/search/index.html">configure it</a> 'n yer <code>hugo.toml</code> as a new outputformat <code>searchpage</code> fer th' home plank. If ye don’t configure it, no dedicated search plank will be access'ble an' th' theme works as before.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Keyboard handl'n fer th' TOC an' search was improved.</p>
<p>Press'n <code>CTRL+ALT+t</code> now will not only toggle th' TOC overlay but also places th' focus t' th' first head'n on open'n. Subsequently this makes it poss'ble t' easily select head'ns by us'n th' <code>TAB</code> key.</p>
<p>Th' search received its own brand new keyboard shortcut <code>CTRL+ALT+f</code>. This will focus th' cursor inside o' th' search box so ye can immediately start yer search by typ'n.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Ye be now able t' turn off th' generat'n o' generator meta tags 'n yer HTML head t' hide th' used versions o' Cap'n Hugo an' this theme.</p>
<p>T' <ahref="/hugo-theme-relearn/pir/configuration/reference/index.html">configure this</a> 'n yer <code>hugo.toml</code> make sure t' set Hugo’s <code>disableHugoGeneratorInject=true</code><strong>an'</strong> also <code>[params] disableGeneratorVersion=true</code>, otherwise Cap'n Hugo will generate a meta tag into yer home plank automagically.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Creat'n o' yer project gets a little bit faster wit' this release.</p>
<p>This addresses increased build time wit' th' version 5 releases. Th' theme now heavily caches partial results lead'n t' improved performance. T' further increase performance, unnecessary parts o' th' plank be now skipped fer creat'n o' th' print output (eg. menus, navigat'n bar, etc.).
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Th' way images be processed has changed. Now images be lazy boarded by default which speeds up plank board on slow networks and/or big planks an' also th' print preview.</p>
<p>For that th' JavaScript code t' handle th' <ahref="/hugo-theme-relearn/pir/authoring/markdown/index.html#image-effects">lightbox an' image effects</a> on th' client side was removed 'n favour fer static generat'n o' those effects on th' server.</p>
<p>If ye have used HTML directly 'n yer Marrrkdown files, this now has th' downside that it doesn’t respect th' effect query parameter anymore. In this case ye have t' migrate all yer HTML <code>img</code> URLs manually t' th' respective HTML attributes.</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span><ahref="/hugo-theme-relearn/pir/configuration/sitemanagement/deployment/index.html">Wit' th' proper sett'ns</a> 'n yer <code>hugo.toml</code> yer plank be now serv'ble from th' local file system us'n <code>file://</code> URLs.</p>
<p>Please note that th' searchbox will only work fer this if ye reconfigure yer outputformat fer th' home plank 'n yer <code>hugo.toml</code> from <code>json</code> t' <code>search</code>. Th' now deprecated <code>json</code> outputformat still works as before, so there be no need t' reconfigure yer installat'n if it be only served from <code>http://</code> or <code>https://</code>.</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Th' <ahref="/hugo-theme-relearn/pir/shortcodes/button/index.html"><code>button</code> shortcode</a> has a new parameter <code>target</code> t' set th' destinat'n frame/window fer th' URL t' open. If not given, it defaults t' a new window/tab fer external URLs or be not set at all fer internal URLs. Previously even internal URLs whar' opened 'n a new window/tab.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' <ahref="/hugo-theme-relearn/pir/shortcodes/math/index.html"><code>math</code> shortcode</a> an' <ahref="/hugo-theme-relearn/pir/shortcodes/mermaid/index.html"><code>mermaid</code> shortcode</a> now also support th' <code>align</code> parameter if Marrrkdown codefences be used.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Support fer languages that be written right t' left (like Arabic). This be only implemented fer th' rrrambl'n area but not th' navigat'n sidebar. This feature be not avail'ble 'n Internet Explorer 11.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Translat'n into Finnish (Suomi).
<li><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> In th' effort t' comply wit' WCAG standards, th' implementat'n o' th' collaps'ble menu was changed. Th' functionality o' th' new implementat'n does not work wit' old browsers (Internet Explorer 11).</li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span><ahref="/hugo-theme-relearn/pir/authoring/markdown/index.html#css-classes">Image formatt'n</a> has two new classes t' align images t' th' <code>left</code> or <code>right</code>. Additionally, th' already exist'n <code>inline</code> opt'n be now documented.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Print'n fer th' <ahref="/hugo-theme-relearn/pir/shortcodes/openapi/index.html"><code>swagger</code> shortcode</a> was optimized t' expand sections that be usually closed 'n interactive mode. This requires <ahref="/hugo-theme-relearn/pir/configuration/sitemanagement/outputformats/index.html#print-support">print support</a> t' be configured.
<li><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> If you’ve set <code>collapsibleMenu = true</code> 'n yer <code>hugo.toml</code>, th' menu will be expanded if a search term be found 'n a collapsed submenu. Th' menu will return t' its initial collapse state once th' search term does not match any submenus.
<li><spanclass="badge cstyle default badge-with-title"><spanclass="badge-title"><iclass="fa-fw fab fa-hackerrank"></i></span><spanclass="badge-content"style="background-color: fuchsia;">0.95.0</span></span> This release requires a newer Cap'n Hugo version.</li>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Because th' print preview URLs were non deterministic fer normal planks 'n comparison t' plank bundles, this be now changed. Each print preview be now access'ble by add'n a <code>index.print.html</code> t' th' default URL.</p>
<p><spanclass="badge cstyle warning badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-triangle"></i></span><spanclass="badge-content">Break'n</span></span> Th' theme changed how JavaScript an' CSS dependencies be boarded t' provide a better performance. In case you’ve added own JavaScript code that depends on th' themes jQuery implementat'n, ye have t' put it into a separate <code>*.js</code> file (if not already) an' add th' <code>defer</code> keyword t' th' <code>script</code> element. Eg.</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Th' way <ahref="/hugo-theme-relearn/pir/authoring/frontmatter/designs/index.html">archetypes</a> be used t' generate output has changed. Th' new systems allows ye, t' redefine exist'n archetypes or even generate yer own ones.</p>
<p>Yer exist'n markdown files will still work like before an' therefore ye don’t need t' change anyth'n after th' upgrade. Nevertheless, it be recommended t' adapt yer exist'n markdown files t' th' new way as follows:</p>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Th' front matter opt'ns <code>pre</code> / <code>post</code> were renamed t' <code>menuPre</code> / <code>menuPost</code>. Th' old opt'ns will still be used if th' new opt'ns aren’t set. Therefore ye don’t need t' change anyth'n after th' upgrade.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Add'n new partials <code>heading-pre.html</code> / <code>heading-post.html</code> an' accord'n front matter opt'ns <code>headingPre</code> / <code>headingPost</code> t' modify th' way yer page`s main head'n gets styled.</p>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Th' new shortcode <code>math</code> be avail'ble t' add beautiful math an' chemical formulae. See th' <ahref="/hugo-theme-relearn/pir/shortcodes/math/index.html">documentat'n</a> fer avail'ble features. This feature will not work wit' Internet Explorer 11.
