hugo-theme-relearn/introduction/releasenotes/5/24/index.print.html
2024-10-24 15:36:57 +00:00

218 lines
20 KiB
HTML

<!DOCTYPE html>
<html lang="en" dir="ltr" itemscope itemtype="http://schema.org/Article">
<head>
<meta charset="utf-8">
<meta name="viewport" content="height=device-height, width=device-width, initial-scale=1.0, minimum-scale=1.0">
<meta name="generator" content="Hugo 0.136.4">
<meta name="generator" content="Relearn 7.0.1+0938e8bd2e8bce8d47586b5c26e306892fcb70a9">
<meta name="robots" content="noindex, nofollow, noarchive, noimageindex">
<meta name="description" content="5.24.0 (2024-02-28) Hugo 0.112.4 0.112.4 This release requires a newer Hugo version. Change Change The topbar button received a way to add text next to the icon. For this, the original title option was renamed to hint while the new title option is now displayed next to the icon.">
<meta name="author" content="Sören Weber">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:image" content="https://mcshelby.github.io/hugo-theme-relearn/images/hero.png">
<meta name="twitter:title" content="Version 5.24 :: Hugo Relearn Theme">
<meta name="twitter:description" content="5.24.0 (2024-02-28) Hugo 0.112.4 0.112.4 This release requires a newer Hugo version. Change Change The topbar button received a way to add text next to the icon. For this, the original title option was renamed to hint while the new title option is now displayed next to the icon.">
<meta property="og:url" content="https://mcshelby.github.io/hugo-theme-relearn/introduction/releasenotes/5/24/index.html">
<meta property="og:site_name" content="Hugo Relearn Theme">
<meta property="og:title" content="Version 5.24 :: Hugo Relearn Theme">
<meta property="og:description" content="5.24.0 (2024-02-28) Hugo 0.112.4 0.112.4 This release requires a newer Hugo version. Change Change The topbar button received a way to add text next to the icon. For this, the original title option was renamed to hint while the new title option is now displayed next to the icon.">
<meta property="og:locale" content="en">
<meta property="og:type" content="article">
<meta property="article:section" content="Introduction">
<meta property="og:image" content="https://mcshelby.github.io/hugo-theme-relearn/images/hero.png">
<meta itemprop="name" content="Version 5.24 :: Hugo Relearn Theme">
<meta itemprop="description" content="5.24.0 (2024-02-28) Hugo 0.112.4 0.112.4 This release requires a newer Hugo version. Change Change The topbar button received a way to add text next to the icon. For this, the original title option was renamed to hint while the new title option is now displayed next to the icon.">
<meta itemprop="wordCount" content="518">
<meta itemprop="image" content="https://mcshelby.github.io/hugo-theme-relearn/images/hero.png">
<title>Version 5.24 :: Hugo Relearn Theme</title>
<link href="https://mcshelby.github.io/hugo-theme-relearn/introduction/releasenotes/5/24/index.html" rel="alternate" hreflang="x-default">
<link href="https://mcshelby.github.io/hugo-theme-relearn/introduction/releasenotes/5/24/index.html" rel="alternate" hreflang="en">
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/introduction/releasenotes/5/24/index.html" rel="alternate" hreflang="art-x-pir">
<link href="https://mcshelby.github.io/hugo-theme-relearn/introduction/releasenotes/5/24/index.html" rel="canonical" type="text/html" title="Version 5.24 :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/introduction/releasenotes/5/24/index.xml" rel="alternate" type="application/rss+xml" title="Version 5.24 :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1729784203" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1729784203" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1729784203" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1729784203" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1729784203" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1729784203" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1729784203" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1729784203" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1729784203" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1729784203" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1729784203" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1729784203" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/print.css?1729784203" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1729784203" rel="stylesheet">
<script src="/hugo-theme-relearn/js/variant.js?1729784203"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..\/..\/..';
window.relearn.relBaseUri='..\/..\/..\/..\/..';
window.relearn.absBaseUri='https:\/\/mcshelby.github.io\/hugo-theme-relearn';
window.relearn.disableAnchorCopy=false;
window.relearn.disableAnchorScrolling=false;
// variant stuff
window.variants && variants.init( [ 'relearn-auto', 'relearn-light', 'relearn-dark', 'relearn-bright', 'zen-auto', 'zen-light', 'zen-dark', 'retro-auto', 'neon', 'learn', 'blue', 'green', 'red' ] );
// translations
window.T_Copy_to_clipboard = `Copy to clipboard`;
window.T_Copied_to_clipboard = `Copied to clipboard!`;
window.T_Copy_link_to_clipboard = `Copy link to clipboard`;
window.T_Link_copied_to_clipboard = `Copied link to clipboard!`;
window.T_Reset_view = `Reset view`;
window.T_View_reset = `View reset!`;
window.T_No_results_found = `No results found for "{0}"`;
window.T_N_results_found = `{1} results found for "{0}"`;
</script>
<style>
#R-body img.bg-white {
background-color: white;
}
</style>
</head>
<body class="mobile-support print disableInlineCopyToClipboard" data-url="/hugo-theme-relearn/introduction/releasenotes/5/24/index.html">
<div id="R-body" class="default-animation">
<div id="R-body-overlay"></div>
<nav id="R-topbar">
<div class="topbar-wrapper">
<div class="topbar-sidebar-divider"></div>
<div class="topbar-area topbar-area-start" data-area="start">
<div class="topbar-button topbar-button-sidebar" data-content-empty="disable" data-width-s="show" data-width-m="hide" data-width-l="hide"><button class="topbar-control" onclick="toggleNav()" type="button" title="Menu (CTRL&#43;ALT&#43;n)"><i class="fa-fw fas fa-bars"></i></button>
</div>
<div class="topbar-button topbar-button-toc" data-content-empty="hide" data-width-s="show" data-width-m="show" data-width-l="show"><button class="topbar-control" onclick="toggleTopbarFlyout(this)" type="button" title="Table of Contents (CTRL&#43;ALT&#43;t)"><i class="fa-fw fas fa-list-alt"></i></button>
<div class="topbar-content">
<div class="topbar-content-wrapper">
<nav class="TableOfContents">
<ul>
<li><a href="#5-24-0">5.24.0 (2024-02-28)</a>
<ul>
<li><a href="#hugo-01124">Hugo 0.112.4</a></li>
<li><a href="#change">Change</a></li>
<li><a href="#new">New</a></li>
</ul>
</li>
</ul>
</nav>
</div>
</div>
</div>
</div>
<ol class="topbar-breadcrumbs breadcrumbs highlightable" itemscope itemtype="http://schema.org/BreadcrumbList"><li
itemscope itemtype="https://schema.org/ListItem" itemprop="itemListElement"><a itemprop="item" href="/hugo-theme-relearn/introduction/index.html"><span itemprop="name">Introduction</span></a><meta itemprop="position" content="1">&nbsp;>&nbsp;</li><li
itemscope itemtype="https://schema.org/ListItem" itemprop="itemListElement"><a itemprop="item" href="/hugo-theme-relearn/introduction/releasenotes/index.html"><span itemprop="name">What&#39;s New</span></a><meta itemprop="position" content="2">&nbsp;>&nbsp;</li><li
itemscope itemtype="https://schema.org/ListItem" itemprop="itemListElement"><a itemprop="item" href="/hugo-theme-relearn/introduction/releasenotes/5/index.html"><span itemprop="name">Version 5</span></a><meta itemprop="position" content="3">&nbsp;>&nbsp;</li><li
itemscope itemtype="https://schema.org/ListItem" itemprop="itemListElement"><span itemprop="name">Version 5.24</span><meta itemprop="position" content="4"></li>
</ol>
<div class="topbar-area topbar-area-end" data-area="end">
<div class="topbar-button topbar-button-edit" data-content-empty="disable" data-width-s="area-more" data-width-m="show" data-width-l="show"><a class="topbar-control" href="https://github.com/McShelby/hugo-theme-relearn/edit/main/exampleSite/content/introduction/releasenotes/5/24.en.md" target="_self" title="Edit (CTRL&#43;ALT&#43;w)"><i class="fa-fw fas fa-pen"></i></a>
</div>
<div class="topbar-button topbar-button-print" data-content-empty="disable" data-width-s="area-more" data-width-m="show" data-width-l="show"><a class="topbar-control" href="/hugo-theme-relearn/introduction/releasenotes/5/24/index.print.html" title="Print whole chapter (CTRL&#43;ALT&#43;p)"><i class="fa-fw fas fa-print"></i></a>
</div>
<div class="topbar-button topbar-button-prev" data-content-empty="disable" data-width-s="show" data-width-m="show" data-width-l="show"><a class="topbar-control" href="/hugo-theme-relearn/introduction/releasenotes/5/index.html" title="Version 5 (🡐)"><i class="fa-fw fas fa-chevron-left"></i></a>
</div>
<div class="topbar-button topbar-button-next" data-content-empty="disable" data-width-s="show" data-width-m="show" data-width-l="show"><a class="topbar-control" href="/hugo-theme-relearn/introduction/releasenotes/4/index.html" title="Version 4 (🡒)"><i class="fa-fw fas fa-chevron-right"></i></a>
</div>
<div class="topbar-button topbar-button-more" data-content-empty="hide" data-width-s="show" data-width-m="show" data-width-l="show"><button class="topbar-control" onclick="toggleTopbarFlyout(this)" type="button" title="More"><i class="fa-fw fas fa-ellipsis-v"></i></button>
<div class="topbar-content">
<div class="topbar-content-wrapper">
<div class="topbar-area topbar-area-more" data-area="more">
</div>
</div>
</div>
</div>
</div>
</div>
</nav>
<div id="R-main-overlay"></div>
<main id="R-body-inner" class="highlightable releasenotes" tabindex="-1">
<div class="flex-block-wrapper">
<article class="default">
<header class="headline">
</header>
<h1 id="version-524">Version 5.24</h1>
See the <a href="/hugo-theme-relearn/introduction/changelog/5/24/index.html">changelog of this version</a> for a detailed list of changes.
<hr>
<ul>
<li>
<p><span class="badge cstyle default badge-with-title"><span class="badge-title"><i class="fa-fw fab fa-hackerrank"></i></span><span class="badge-content" style="background-color: fuchsia;">0.126.0</span></span> Minimum required Hugo version</p>
</li>
<li>
<p><span class="badge cstyle warning badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-exclamation-triangle"></i></span><span class="badge-content">Breaking</span></span> Change requiring action after upgrade</p>
</li>
<li>
<p><span class="badge cstyle note badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-exclamation-circle"></i></span><span class="badge-content">Change</span></span> Change of behavior, may require action</p>
</li>
<li>
<p><span class="badge cstyle info badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-plus-circle"></i></span><span class="badge-content">New</span></span> New behavior, often introducing new options</p>
</li>
</ul>
<hr>
<h2 id="5-24-0">5.24.0 (2024-02-28)</h2>
<h3 id="hugo-01124">Hugo 0.112.4</h3>
<ul>
<li><span class="badge cstyle default badge-with-title"><span class="badge-title"><i class="fa-fw fab fa-hackerrank"></i></span><span class="badge-content" style="background-color: fuchsia;">0.112.4</span></span> This release requires a newer Hugo version.</li>
</ul>
<h3 id="change">Change</h3>
<ul>
<li>
<p><span class="badge cstyle note badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-exclamation-circle"></i></span><span class="badge-content">Change</span></span> The topbar button received a way to add text next to the icon. For this, the original <code>title</code> option was renamed to <code>hint</code> while the new <code>title</code> option is now displayed next to the icon.</p>
</li>
<li>
<p><span class="badge cstyle note badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-exclamation-circle"></i></span><span class="badge-content">Change</span></span> The front matter option <code>menuTitle</code> is now deprecated in favor for Hugo&rsquo;s own <code>linkTitle</code>. You don&rsquo;t need to change anything as the old <code>menuTitle</code> option is still supported.</p>
</li>
<li>
<p><span class="badge cstyle note badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-exclamation-circle"></i></span><span class="badge-content">Change</span></span> The light themes have a bit more contrast for content text and headings. Also the syntaxhighlighting was changed to the more colorful MonokaiLight. This brings the syntaxhighlighting in sync with the corresponding dark theme variants, which are using Monokai. If you dislike this, you can create your own color variant file as <a href="/hugo-theme-relearn/configuration/branding/colors/index.html#modifying-variants">described here</a>.</p>
</li>
</ul>
<h3 id="new">New</h3>
<ul>
<li>
<p><span class="badge cstyle info badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-plus-circle"></i></span><span class="badge-content">New</span></span> If the theme can not resolve a link to a page or image, you can now generate warnings or errors during build by setting <code>link.errorlevel</code> or <code>image.errorlevel</code> to either <code>warning</code> or <code>error</code> in your <code>hugo.toml</code> respectively. By default this condition is silently ignored and the link is written as-is.</p>
<p>Please note that a page link will generate false negatives if <code>uglyURLs=true</code> and it references an ordinary page before <span class="badge cstyle default badge-with-title"><span class="badge-title"><i class="fa-fw fab fa-hackerrank"></i></span><span class="badge-content" style="background-color: fuchsia;">0.123.0</span></span>.</p>
<p>Please note that an image link will generate false negatives if the file resides in your <code>static</code> directory.</p>
</li>
<li>
<p><span class="badge cstyle info badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-plus-circle"></i></span><span class="badge-content">New</span></span> You now can configure additional options for every theme variant in your <code>hugo.toml</code>. This allows for optional <a href="/hugo-theme-relearn/configuration/branding/colors/index.html#theme-variant-advanced">advanced functionality</a>. You don&rsquo;t need to change anything as the old configuration options will still work (but may generate warnings now).</p>
<p>The advanced functionality allows you to set an explicit name for a theme variant and now allows for multiple auto mode variants that adjust to the light/dark preference of your OS settings.</p>
</li>
<li>
<p><span class="badge cstyle info badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-plus-circle"></i></span><span class="badge-content">New</span></span> New partial for defining the heading. See <a href="/hugo-theme-relearn/configuration/customization/partials/index.html">documentation</a> for further reading.</p>
</li>
<li>
<p><span class="badge cstyle info badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-plus-circle"></i></span><span class="badge-content">New</span></span> Support for Hugo&rsquo;s built-in <a href="https://gohugo.io/content-management/shortcodes/#figure" rel="external" target="_self"><code>figure</code> shortcode</a>.</p>
</li>
<li>
<p><span class="badge cstyle info badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-plus-circle"></i></span><span class="badge-content">New</span></span> On taxonomy and term pages you can now use prev/next navigation as within the normal page structure.</p>
</li>
<li>
<p><span class="badge cstyle info badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-plus-circle"></i></span><span class="badge-content">New</span></span> In additiion to the existing <a href="/hugo-theme-relearn/configuration/sidebar/width/index.html">menu width customization</a>, it is now also possible to set the width of the menu flyout for small screen sizes with the <code>--MENU-WIDTH-S</code> CSS property.</p>
</li>
<li>
<p><span class="badge cstyle info badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-plus-circle"></i></span><span class="badge-content">New</span></span> Improvements for accessibility when tabbing through the page for images, links and tab handles.</p>
</li>
<li>
<p><span class="badge cstyle info badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-plus-circle"></i></span><span class="badge-content">New</span></span> The <code>editURL</code> config parameter is now <a href="/hugo-theme-relearn/authoring/frontmatter/reference/index.html">overwritable in your pages front matter</a>. In addition it received more versatility by letting you control where to put the file path into the URL. This is achieved by replacing the variable <code>${FilePath}</code> in your URL by the pages file path. You don&rsquo;t need to change anything in your existing configuration as the old way without the replacement variable still works.</p>
</li>
<li>
<p><span class="badge cstyle info badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-plus-circle"></i></span><span class="badge-content">New</span></span> The themes <a href="/hugo-theme-relearn/configuration/reference/index.html">config</a> and <a href="/hugo-theme-relearn/authoring/frontmatter/reference/index.html">front matter</a> options received a comprehensive documentation update. In addition the theme switched from <code>config.toml</code> to <code>hugo.toml</code>.</p>
</li>
<li>
<p><span class="badge cstyle info badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-plus-circle"></i></span><span class="badge-content">New</span></span> Restored compatibility with Hugo versions <span class="badge cstyle default badge-with-title"><span class="badge-title"><i class="fa-fw fab fa-hackerrank"></i></span><span class="badge-content" style="background-color: fuchsia;">0.121.0</span></span> or higher for the <a href="/hugo-theme-relearn/shortcodes/highlight/index.html"><code>highlight</code> shortcode</a>. This does not change the minimum required Hugo version.</p>
</li>
<li>
<p><span class="badge cstyle info badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-plus-circle"></i></span><span class="badge-content">New</span></span> Restored compatibility with Hugo versions <span class="badge cstyle default badge-with-title"><span class="badge-title"><i class="fa-fw fab fa-hackerrank"></i></span><span class="badge-content" style="background-color: fuchsia;">0.123.0</span></span> or higher for theme specific output formats and handling of taxonomy and term titles. This does not change the minimum required Hugo version.</p>
</li>
</ul>
<footer class="footline">
</footer>
</article>
</div>
</main>
</div>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1729784203" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1729784203" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1729784203" defer></script>
</body>
</html>