<metaname="description"content="7.0.0 (2024-10-15) Cap'n Hugo 0.126.0 0.126.0 This release requires a newer Cap'n Hugo version. Break'n Break'n This release comes wit' significant changes 'n file nam'n o' partials an' how th' theme works internally. This was done because th' theme">
<metaname="twitter:description"content="7.0.0 (2024-10-15) Cap'n Hugo 0.126.0 0.126.0 This release requires a newer Cap'n Hugo version. Break'n Break'n This release comes wit' significant changes 'n file nam'n o' partials an' how th' theme works internally. This was done because th' theme">
<metaproperty="og:description"content="7.0.0 (2024-10-15) Cap'n Hugo 0.126.0 0.126.0 This release requires a newer Cap'n Hugo version. Break'n Break'n This release comes wit' significant changes 'n file nam'n o' partials an' how th' theme works internally. This was done because th' theme">
<metaitemprop="description"content="7.0.0 (2024-10-15) Cap'n Hugo 0.126.0 0.126.0 This release requires a newer Cap'n Hugo version. Break'n Break'n This release comes wit' significant changes 'n file nam'n o' partials an' how th' theme works internally. This was done because th' theme">
<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.126.0</span></span> This release requires a newer Cap'n Hugo version.</li>
</ul>
<h3id="breaking">Break'n</h3>
<ul>
<li>
<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> This release comes wit' significant changes 'n file nam'n o' partials an' how th' theme works internally. This was done because th' theme</p>
<ul>
<li>suffered from poor build performance fer sites wit' 1000 or more planks</li>
<li>reinvented th' wheel instead o' us'n avail'ble Cap'n Hugo mechanisms</li>
<p><em>What do I gain</em>, ye may ask. A significant performance boost dur'n build! Usually, th' build time has been cut at least 'n half fer bigger sites. It be now poss'ble t' build even larger sites wit' 5000 or more planks. This was previously almost imposs'ble due t' rapidly increas'n build time wit' th' more planks you’ve introduced. For even bigger sites, th' theme now has <ahref="/hugo-theme-relearn/pir/authoring/frontmatter/menu/index.html#expander-for-submenus">configur'ble performance optimizat'ns</a> - at th' price o' feature limitat'ns.</p>
<p>If ye haven’t done customizat'ns t' any partials, ye can update right away.</p>
<p>If ye have customized yer templates, 'n th' best cases, ye will get build warnings or even errors. In th' worst cases, yer build succeeds but th' ship will not work as intended by ye.</p>
<p>Specifically, ye will have t' adapt yer ship if ye have</p>
<ul>
<li><ahref="/hugo-theme-relearn/pir/configuration/customization/partials/index.html">overwritten th' <code>header.html</code>, <code>menu.html</code> or <code>footer.html</code> partials</a></li>
<li>self-defined archetype partials 'n <code>layouts/partials/archetypes</code> - now becom'n <ahref="/hugo-theme-relearn/pir/configuration/customization/designs/index.html">plank designs</a></li>
<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> This release changes th' way th' search index an' th' dedicated search plank be generated. This may require reconfigurat'n by ye t' still work as ye have intended.</p>
<p>Ye need t' remove th' now obsolete <code>search</code> an' <code>searchpage</code> output format from <code>[outputs.home]</code> 'n yer <code>hugo.toml</code>, result'n 'n someth'n similar t'</p>
<p>Aft that, yer build will succeed but will most likely cause new defaults t' be applied. Wit' no further sett'ns, in-page search, search popup an' dedicated search plank be all active by default. This can be reconfigured.</p>
<p>In addit'n, ye be now able t' overwrite th' default file name o' th' search index an' th' default plank name o' th' dedicated search plank by chang'n <code>searchIndexURL</code> an' <code>searchPageURL</code> respectively 'n yer <code>hugo.toml</code>.</p>
<p>See th' <ahref="/hugo-theme-relearn/pir/configuration/sidebar/search/index.html">updated documentat'n</a> fer reference.</p>
<p>Care was taken t' configure th' font t' look similar t' th' previously used Work Sans. Nevertheless, 'n direct comparison, ye will see slight differences 'n appearance.</p>
<p>This change was necessary as th' previously used font had display issues wit' <ahref="/hugo-theme-relearn/pir/authoring/markdown/index.html#marked-text">marked text</a>, contrast, an' some other minor stuff. As an aftermath, th' number o' requests an' th' download size were decreased when load'n a plank.</p>
<p>Th' font was created by Google, be licensed under OFL 1.1 an' be delivered from yer theme’s installat'n. As always, no third-party server calls be involved.</p>
<p>If ye have changed th' <code>font-family</code> 'n yer installat'n, ye most likely have t' adjust th' variables <code>--MAIN-font-weight</code>, <code>--MAIN-BOLD-font-weight</code> an' <code>--MAIN-letter-spac'n</code>.</p>
<p>Additionally, if ye have changed th' font t' a <ahref="https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_fonts/Variable_fonts_guide#variable_fonts_what_they_are_and_how_they_differ"rel="external"target="_self">vari'ble font</a> 'n yer installat'n, ye may have t' adjust th' vari'ble <code>--MAIN-font-variation-sett'ns</code>. As this only applies t' <strong>vari'ble fonts</strong>, this should rarely be necessary.</p>
</li>
<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> While switch'n th' font, it was discovered that certain CSS variables were falsely named. Ye don’t need t' change anyth'n 'n yer custom variant stylesheet as th' old names will be used as a fallback.</p>
<p><code>--MAIN-TITLES-TEXT-font</code> was renamed t' <code>--MAIN-TITLES-font</code>, <code>--MAIN-TITLES-H<n>-color</code> was renamed t' <code>--MAIN-TITLES-H<n>-TEXT-color</code>.</p>
</li>
<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' opt'ns an' front matter t' force load'n a <ahref="/hugo-theme-relearn/pir/shortcodes/math/index.html#force-loading-of-the-mathjax-library">math</a>, <ahref="/hugo-theme-relearn/pir/shortcodes/mermaid/index.html#force-loading-of-the-mermaid-library">mermaid</a> or <ahref="/hugo-theme-relearn/pir/shortcodes/openapi/index.html#force-loading-of-the-swagger-ui-library">openapi</a> library has been changed.</p>
<p>Previously, ye had t' set th' unintuitive <code>disableMathJax=false</code> t' force board th' math library 'n case o' a passthrough configurat'n. This be replaced by th' simpler <code>math=true</code> or <code>math.force=true</code> an' be now 'n line wit' <ahref="https://gohugo.io/content-management/mathematics/#step-1"rel="external"target="_self">Hugo’s official documentat'n</a>.</p>
<p>Ye don’t need t' change anyth'n yet but will receive warnings if th' old sett'ns be used.</p>
</li>
<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' default logo be not contained inside o' th' theme’s logo partial anymore.</p>
<p>This be t' avoid usage o' th' theme’s brand'n throughout th' web 'n non-modified installat'ns.</p>
<p>In addit'n, th' default text fer th' logo partial be now <ahref="/hugo-theme-relearn/pir/configuration/sidebar/headerfooter/index.html#title">taken from th' <code>linkTitle</code> sett'n</a> 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' docs received a much-needed overhaul fer all chapters.</p>
<p>Basically, th' structure was reorganized, giv'n each topic its own plank while keep'n th' amount o' items fer each menu level comprehens'ble by add'n sub-pages.</p>
<p>Th' docs now clearly differentiate between <ahref="/hugo-theme-relearn/pir/configuration/index.html">configurat'n o' yer ship</a>, all th'ns <ahref="/hugo-theme-relearn/pir/authoring/index.html">writ'n plank rrrambl'n</a> an' th' <ahref="/hugo-theme-relearn/pir/shortcodes/index.html">shorrrtcodes docs</a> that cover both topics, configurat'n an' usage.</p>
<p>T' give ye a better overview o' what’s poss'ble wit' th' theme, we introduced reference planks fer all theme <ahref="/hugo-theme-relearn/pir/configuration/reference/index.html">configurat'n opt'ns</a> an' <ahref="/hugo-theme-relearn/pir/authoring/frontmatter/reference/index.html">front matter</a> an' mark each occurrence o' such on all planks wit' th' badges <spanclass="badge cstyle cyan badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-gears"></i></span><spanclass="badge-content">Opt'n</span></span> an' <spanclass="badge cstyle green badge-with-title"><spanclass="badge-title"><iclass="fa-fw fab fa-markdown"></i></span><spanclass="badge-content">Front Matter</span></span>.</p>
<p>Also, a lot o' previously undocumented features be now included, namely</p>
<li>configur'n <ahref="/hugo-theme-relearn/pir/configuration/content/titles/index.html">breadcrumb, titles</a> an' <ahref="/hugo-theme-relearn/pir/configuration/content/headings/index.html">head'ns</a> o' yer rrrambl'n</li>
<li><ahref="/hugo-theme-relearn/pir/configuration/content/linking/index.html">opt'ns fer us'n links</a></li>
