<metaname="description"content="7.4.0 (2025-02-18) Change Change The way you link to pages in a different language has changed. Until now this was an undocumented feature.">
<metaname="twitter:description"content="7.4.0 (2025-02-18) Change Change The way you link to pages in a different language has changed. Until now this was an undocumented feature.">
<metaproperty="og:description"content="7.4.0 (2025-02-18) Change Change The way you link to pages in a different language has changed. Until now this was an undocumented feature.">
<metaitemprop="description"content="7.4.0 (2025-02-18) Change Change The way you link to pages in a different language has changed. Until now this was an undocumented feature.">
<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> Change of behavior, may require action</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 behavior, often introducing new options</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> The way you <ahref="/hugo-theme-relearn/authoring/linking/pages/index.html">link to pages in a different language</a> has changed. Until now this was an undocumented feature.</p>
<p>Previously you could prepend an URL with the language code, e.g. <code>/pir/my-page</code> to link to pages of other languages. This could cause problems if you have a page with the same name as the language code on the top level of your page structure.</p>
<p>Now you have to set the query parameter <code>lang</code> to the language code, e.g. <code>/my-page?lang=pir</code>.</p>
<p>As this was previously undocumented, most projects will not be affected. If you <ahref="/hugo-theme-relearn/configuration/content/linking/index.html#legacy-cross-language-links">still need the old behavior</a>, you can set <code>enableLegacyLanguageLinks=true</code> in your <code>hugo.toml</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> The <code>target</code> parameter of the <ahref="/hugo-theme-relearn/shortcodes/button/index.html#parameter"><code>button</code> shortcode</a> was deprecated.</p>
<p>Use <ahref="/hugo-theme-relearn/authoring/markdown/index.html#link-effects">link effects</a> on the <code>href</code> parameter instead. You don’t need to change anything as the old parameter still works but may generate warnings.</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> The theme now allows page references (given as <code>pageRef</code> of a <ahref="https://gohugo.io/content-management/menus/"rel="external"target="_self">Hugo menu item</a>, <code>pageRef</code> parameter of a <ahref="/hugo-theme-relearn/configuration/sidebar/menus/index.html#defining-sidebar-menus"><code>sidebarmenus</code> entry </a> and the <code>menuPageRef</code> in a <ahref="/hugo-theme-relearn/configuration/sidebar/menus/index.html#displaying-arbitrary-links-in-a-page-menu">page’s front matter</a>) to also be global resources from your <code>assets</code> directory.</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 <ahref="/hugo-theme-relearn/authoring/frontmatter/linking/index.html#enabling-link-and-image-link-warnings"><code>link.errorlevel</code> is configured</a>, now also page references will be checked for existence.</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> You can now <ahref="/hugo-theme-relearn/authoring/frontmatter/linking/index.html#ignoring-false-negatives">configure an ignore list</a> of regular expressions for addresses that should be ignored if an errorlevel test fails. This is configured by setting <code>errorignore=[]</code> globally in your <code>hugo.toml</code> for all errorlevel checks.</p>
<p>This helps to remove false negatives while still benefitting from the check for all other addresses.</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 is now possible to add query parameter and an optional fragment part to all links. This is regardless whether it is a local or remote address and also applies to Hugo’s internal path.</p>
<p>By that you can now use it on Markdown links and image links, page references and <ahref="/hugo-theme-relearn/shortcodes/button/index.html">buttons</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> You can now <ahref="/hugo-theme-relearn/authoring/linking/pages/index.html">link to different output formats</a> of a page by adding a query parameter.</p>
<p>For example to link to the print format of a page, write <code>/my-page?format=print</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> There are two new <ahref="/hugo-theme-relearn/authoring/linking/imageeffects/index.html">image effects</a> that are usable if the linked image points to a resource:</p>
<li><strong>dataurl</strong>: resource is converted to a base64 encoded dataurl</li>
<li><strong>inlinecontent</strong>: in case of SVG resources, the content will be used instead of an <code><img></code> element, this is useful for applying additional CSS styles to the elements inside of the SVG which is otherwise impossible</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 introduces <ahref="/hugo-theme-relearn/authoring/linking/linkeffects/index.html">link effects</a> which work similar to <ahref="/hugo-theme-relearn/authoring/linking/imageeffects/index.html">image effects</a> and can be set as query parameter on any link.</p>
<p>With that you currently can specify</p>
<ul>
<li><strong>target</strong>: set a link target individually for each link</li>
<li><strong>download</strong>: a click on the link should result in a file download instead of a navigation</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> The theme supports the new <ahref="/hugo-theme-relearn/configuration/sitemanagement/outputformats/index.html#source-support"><code>source</code> output format</a> which behaves similar in configuration as the <code>markdown</code> output format but allows the original Markdown source including the front matter of a page to be viewed.</p>
<p>You can see this in action on the above linked page, accessible by clicking the <spanclass="btn cstyle transparent"><span><iclass="fa-fw fas fa-code"></i></span></span> topbar button.</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 you haven’t overridden <code>layouts/partials/custom-header.html</code> and <code>css/custom.css</code> and/or <code>js/custom.js</code> is present in your project, the theme now adds them to your pages.</p>
<p>This was done to be compatible with adding custom scripts in an older version of the Hugo documentation.</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 you haven’t overridden <code>layouts/partials/content-footer.html</code>, you can now <ahref="/hugo-theme-relearn/configuration/content/meta/index.html">configure which page meta information</a> - like author’s name, email address and authoring date - should be displayed. Also the date format is now configurable.</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> The logo color is now configurable via the <code>--MENU-HEADER-color</code> variable in your variant stylesheets.</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> Now favicons are also searched in the <code>assets/images</code> directory.</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> The themes documentation has been moved from <code>exampleSite</code> to <code>docs</code> to make place for a brand new exampleSite. Welcome on board the <ahref="https://mcshelby.github.io/hugo-theme-relearn/exampleSite/about/index.html"rel="external"target="_self">The Purple Pulpo</a>!</p>
<p>This was done because the docs contained to much docs specific configuration and quirks. The new exampleSite is meant as a starting template for your own project with minimal initial configuration.</p>
