<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.9 :: 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.9 :: 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.9 :: 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/9/index.html">changelog of this version</a> for a detailed list of changes.
<hr>
<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>