<metaname="description"content="2.9.0 (2021-11-19) Break'n Break'n This release removes th' themes implementat'n o' ref/relref 'n favor fer Hugo’s standard implementat'n. This be because o' inconsistencies wit' th' themes implementat'n. In advantage, yer project becomes standard compliant an' exchang'n this theme 'n yer project t' some other theme will be effortless.">
<metaname="twitter:title"content="Version 2 :: Cap'n Hugo Relearrrn Theme">
<metaname="twitter:description"content="2.9.0 (2021-11-19) Break'n Break'n This release removes th' themes implementat'n o' ref/relref 'n favor fer Hugo’s standard implementat'n. This be because o' inconsistencies wit' th' themes implementat'n. In advantage, yer project becomes standard compliant an' exchang'n this theme 'n yer project t' some other theme will be effortless.">
<metaproperty="og:site_name"content="Cap'n Hugo Relearrrn Theme">
<metaproperty="og:title"content="Version 2 :: Cap'n Hugo Relearrrn Theme">
<metaproperty="og:description"content="2.9.0 (2021-11-19) Break'n Break'n This release removes th' themes implementat'n o' ref/relref 'n favor fer Hugo’s standard implementat'n. This be because o' inconsistencies wit' th' themes implementat'n. In advantage, yer project becomes standard compliant an' exchang'n this theme 'n yer project t' some other theme will be effortless.">
<metaitemprop="name"content="Version 2 :: Cap'n Hugo Relearrrn Theme">
<metaitemprop="description"content="2.9.0 (2021-11-19) Break'n Break'n This release removes th' themes implementat'n o' ref/relref 'n favor fer Hugo’s standard implementat'n. This be because o' inconsistencies wit' th' themes implementat'n. In advantage, yer project becomes standard compliant an' exchang'n this theme 'n yer project t' some other theme will be effortless.">
See the <ahref="/hugo-theme-relearn/pir/introduction/changelog/2/index.html">changelog of this version</a> for a detailed list of changes.
<hr>
<p></p>
<h2id="2-9-0">2.9.0 (2021-11-19)</h2>
<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 removes th' themes implementat'n o' <code>ref</code>/<code>relref</code> 'n favor fer Hugo’s standard implementat'n. This be because o' inconsistencies wit' th' themes implementat'n. In advantage, yer project becomes standard compliant an' exchang'n this theme 'n yer project t' some other theme will be effortless.</p>
<p>In a standard compliant form ye must not link t' th' <code>*.md</code> file but t' its logical name. You’ll see, referenc'n other planks becomes much easier. All three types result 'n th' same reference:</p>
<p>If you’ve linked from a plank o' one language t' a plank o' another language, conversion be a bit more difficult but <ahref="https://gohugo.io/content-management/cross-references/#link-to-another-language-version"rel="external"target="_self">Cap'n Hugo got ye covered</a> as well.</p>
<p>Also, th' old themes implementat'n allowed refs t' non-exist'n rrrambl'n. This will cause Hugo’s implementat'n t' show th' error below an' abort th' generat'n. If yer project relies on this old behavior, ye can <ahref="https://gohugo.io/content-management/cross-references/#link-to-another-language-version"rel="external"target="_self">reconfigure th' error handl'n</a> o' Hugo’s implementat'n.</p>
<p>In th' best case yer usage o' th' old implementat'n be already standard compliant an' ye don’t need t' change anyth'n. You’ll notice this very easily once you’ve started <code>hugo server</code> after an upgrade an' no errors be written t' th' console.</p>
<p>Ye may see errors on th' console after th' update 'n th' form:</p>
<p>In this case, ye must apply one o' two opt'ns:</p>
<ol>
<li>
<p>Start up a text editor wit' regular expression support fer search an' replace. Search fer <code>(ref\s+"[^"]*?)(?:/_index|/index)?(?:\.md)?(#[^"]*?)?"</code> an' replace it by <code>$1$2"</code> 'n all <code>*.md</code> files. <strong>This be th' recommended choice</strong>.</p>
</li>
<li>
<p>Copy th' old implementat'n files <code>theme/hugo-theme-relearn/layouts/shortcode/ref.html</code> an' <code>theme/hugo-theme-relearn/layouts/shortcode/relref.html</code> t' yer own projects <code>layouts/shortcode/ref.html</code> an' <code>layouts/shortcode/relref.html</code> respectively. <strong>This be not recommended</strong> as yer project will still rely on non-standard behavior afterwards.
</p>
</li>
</ol>
</li>
</ul>
<hr>
<p></p>
<h2id="2-8-0">2.8.0 (2021-11-03)</h2>
<h3id="change">Change</h3>
<ul>
<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> Although never officially documented, this release removes th' font <code>Novacento</code>/<code>Novecento</code>. If ye use it 'n an overwritten CSS please replace it wit' <code>Work Sans</code>. This change was necessary as Novacento did not provide all Latin special characters an' lead t' mixed styled character text eg. fer Czech.</li>
</ul>
<h3id="new">New</h3>
<ul>
<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' theme now supports favicons served from <code>static/images/</code> named as <code>favicon</code> or <code>logo</code> 'n SVG, PNG or ICO format <ahref="/hugo-theme-relearn/pir/configuration/branding/logo/index.html#change-the-favicon">out o' th' box</a>. An overridden partial <code>layouts/partials/favicon.html</code> may not be necessary anymore 'n most cases.</p>
</li>
<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> Ye can hide th' t'ble o' contents menu fer th' whole ship by sett'n th' <code>disableToc</code> opt'n 'n yer <code>hugo.toml</code>. For an example see <ahref="/hugo-theme-relearn/pir/configuration/reference/index.html">th' example configurat'n</a>.
</p>
</li>
</ul>
<hr>
<p></p>
<h2id="2-7-0">2.7.0 (2021-10-24)</h2>
<h3id="new-1">New</h3>
<ul>
<li><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> Optional second parameter fer <ahref="/hugo-theme-relearn/pir/shortcodes/notice/index.html"><code>notice</code></a> shortcode t' set title 'n box header.
</li>
</ul>
<hr>
<p></p>
<h2id="2-6-0">2.6.0 (2021-10-21)</h2>
<h3id="new-2">New</h3>
<ul>
<li><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> Yer ship can now be served from a subdirectory if ye set <code>baseURL</code> 'n yer <code>hugo.toml</code>. See th' <ahref="/hugo-theme-relearn/pir/configuration/sitemanagement/deployment/index.html">documentat'n</a> fer a detailed example.
</li>
</ul>
<hr>
<p></p>
<h2id="2-5-0">2.5.0 (2021-10-08)</h2>
<h3id="change-1">Change</h3>
<ul>
<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> New colors <code>--CODE-BLOCK-color</code> an' <code>--CODE-BLOCK-BG-color</code> were added t' provide a fallback fer Hugo’s rules highlight'n 'n case no language was given or th' language be unsupported. Ideally th' colors be set t' th' same values as th' ones from yer chosen chroma style.
</li>
</ul>
<hr>
<p></p>
<h2id="2-4-0">2.4.0 (2021-10-07)</h2>
<h3id="change-2">Change</h3>
<ul>
<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> Creat'n o' customized stylesheets was simplified down t' only contain th' CSS variables. Everyth'n else can an' should be deleted from yer custom stylesheet t' assure everyth'n works fine. For th' predefined stylesheet variants, this change be already included.</li>
</ul>
<h3id="new-3">New</h3>
<ul>
<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> Hidden planks be displayed by default 'n their accord'n tags plank. Ye can now turn off this behavior by sett'n <code>disableTagHiddenPages=true</code> 'n yer <code>hugo.toml</code>.</p>
</li>
<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> Ye can define th' expansion state o' yer menus fer th' whole ship by sett'n th' <code>alwaysopen</code> opt'n 'n yer <code>hugo.toml</code>. Please see further <ahref="/hugo-theme-relearn/pir/authoring/frontmatter/navigationmenu/index.html#expand-state-of-nested-sections">documentat'n</a> fer poss'ble values an' default behavior.</p>
</li>
<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> New front matter <code>ordersectionsby</code> opt'n t' change immediate children sort'n 'n menu an' <code>children</code> shortcode. Poss'ble values be <code>title</code> or <code>weight</code>.</p>
</li>
<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> Alternate rrrambl'n o' a plank be now advertised 'n th' HTML meta tags. See <ahref="https://gohugo.io/templates/rss/#reference-your-rss-feed-in-head"rel="external"target="_self">Cap'n Hugo documentat'n</a>.
</p>
</li>
</ul>
<hr>
<p></p>
<h2id="2-3-0">2.3.0 (2021-09-13)</h2>
<h3id="hugo-0810">Cap'n Hugo 0.81.0</h3>
<ul>
<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.81.0</span></span> This release requires a newer Cap'n Hugo version.</li>
</ul>
<h3id="new-4">New</h3>
<ul>
<li><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> Showcase multilanguage features by provid'n a documentat'n translat'n “fer us pirrrates”. There will be no other translat'ns besides th' original English one an' th' Piratish one due t' maintenance constraints.
</li>
</ul>
<hr>
<p></p>
<h2id="2-2-0">2.2.0 (2021-09-09)</h2>
<h3id="new-5">New</h3>
<ul>
<li><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> Hidden planks be displayed by default 'n th' sitemap generated by Cap'n Hugo an' be therefore vis'ble fer search engine index'n. Ye can now turn off this behavior by sett'n <code>disableSeoHiddenPages=true</code> 'n yer <code>hugo.toml</code>.
</li>
</ul>
<hr>
<p></p>
<h2id="2-1-0">2.1.0 (2021-09-07)</h2>
<h3id="hugo-0690">Cap'n Hugo 0.69.0</h3>
<ul>
<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.69.0</span></span> This release requires a newer Cap'n Hugo version.</li>
</ul>
<h3id="change-3">Change</h3>
<ul>
<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 case th' site’s structure contains additional *.md files not part o' th' ship (eg files that be meant t' be included by ship planks - see <code>CHANGELOG.md</code> 'n th' exampleSite), they will now be ignored by th' search.</li>
</ul>
<h3id="new-6">New</h3>
<ul>
<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> Hidden planks be indexed fer th' ship search by default. Ye can now turn off this behavior by sett'n <code>disableSearchHiddenPages=true</code> 'n yer <code>hugo.toml</code>.</p>
</li>
<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> If a search term be found 'n an <code>expand</code> shortcode, th' expand will be opened.</p>
</li>
<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' menu will scroll th' active item into view on board.
</p>
</li>
</ul>
<hr>
<p></p>
<h2id="2-0-0">2.0.0 (2021-08-28)</h2>
<h3id="change-4">Change</h3>
<ul>
<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> Rules highlight'n was switched t' th' <ahref="https://gohugo.io/content-management/syntax-highlighting/"rel="external"target="_self">built 'n Hugo mechanism</a>. Ye may need t' configure a new stylesheet or decide t' roll ye own as described on 'n th' Cap'n Hugo documentat'n</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> In th' predefined stylesheets there was a typo an' <code>--MENU-HOME-LINK-HOVERED-color</code> must be changed t' <code>--MENU-HOME-LINK-HOVER-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>
</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><code>--MENU-HOME-LINK-color</code> an' <code>--MENU-HOME-LINK-HOVER-color</code> were miss'n 'n th' documentat'n. Ye should add them t' yer custom stylesheets if ye want t' override th' defaults.</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> Arrow navigat'n an' <code>children</code> shortcode were ignor'n sett'n fer <code>ordersectionsby</code>. This be now changed an' may result 'n different sort'n order o' yer sub planks.</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> If hidden planks be accessed directly by typ'n their URL, they will be exposed 'n th' menu.</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> A plank without a <code>title</code> will be treated as <code>hidden=true</code>.</p>
</li>
</ul>
<h3id="new-7">New</h3>
<ul>
<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> Ye can define th' expansion state o' yer menus 'n th' front matter. Please see further <ahref="/hugo-theme-relearn/pir/authoring/frontmatter/navigationmenu/index.html#expand-state-of-nested-sections">documentat'n</a> fer poss'ble values an' default behavior.</p>
</li>
<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> New partials fer defin'n pre/post rrrambl'n fer menu items an' th' rrrambl'n. See <ahref="/hugo-theme-relearn/pir/configuration/customization/partials/index.html">documentat'n</a> fer further read'n.</p>
</li>
<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> Shortcode <ahref="/hugo-theme-relearn/pir/shortcodes/children/index.html"><code>children</code></a> wit' new parameter <code>containerstyle</code>.</p>
</li>
<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> New shortcode <ahref="/hugo-theme-relearn/pir/shortcodes/include/index.html"><code>include</code></a> t' include arbitrary file rrrambl'n into a plank.
