mirror of
https://github.com/McShelby/hugo-theme-relearn.git
synced 2024-11-27 09:43:06 +00:00
335 lines
28 KiB
HTML
335 lines
28 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.5">
|
|
<meta name="generator" content="Relearn 7.0.1+41a1e95d1eb3169d1238a078b0f2f0cf2f6246d6">
|
|
<meta name="robots" content="noindex, nofollow, noarchive, noimageindex">
|
|
<meta name="description" content="7.1.0 (xxxx-xx-xx) Change Change The sidebar menus are now completely configurable.">
|
|
<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 7 :: Hugo Relearn Theme">
|
|
<meta name="twitter:description" content="7.1.0 (xxxx-xx-xx) Change Change The sidebar menus are now completely configurable.">
|
|
<meta property="og:url" content="https://mcshelby.github.io/hugo-theme-relearn/introduction/releasenotes/7/index.html">
|
|
<meta property="og:site_name" content="Hugo Relearn Theme">
|
|
<meta property="og:title" content="Version 7 :: Hugo Relearn Theme">
|
|
<meta property="og:description" content="7.1.0 (xxxx-xx-xx) Change Change The sidebar menus are now completely configurable.">
|
|
<meta property="og:locale" content="en">
|
|
<meta property="og:type" content="website">
|
|
<meta property="og:image" content="https://mcshelby.github.io/hugo-theme-relearn/images/hero.png">
|
|
<meta itemprop="name" content="Version 7 :: Hugo Relearn Theme">
|
|
<meta itemprop="description" content="7.1.0 (xxxx-xx-xx) Change Change The sidebar menus are now completely configurable.">
|
|
<meta itemprop="wordCount" content="1058">
|
|
<meta itemprop="image" content="https://mcshelby.github.io/hugo-theme-relearn/images/hero.png">
|
|
<title>Version 7 :: Hugo Relearn Theme</title>
|
|
<link href="https://mcshelby.github.io/hugo-theme-relearn/introduction/releasenotes/7/index.html" rel="alternate" hreflang="x-default">
|
|
<link href="https://mcshelby.github.io/hugo-theme-relearn/introduction/releasenotes/7/index.html" rel="alternate" hreflang="en">
|
|
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/introduction/releasenotes/7/index.html" rel="alternate" hreflang="art-x-pir">
|
|
<link href="https://mcshelby.github.io/hugo-theme-relearn/introduction/releasenotes/7/index.html" rel="canonical" type="text/html" title="Version 7 :: Hugo Relearn Theme">
|
|
<link href="/hugo-theme-relearn/introduction/releasenotes/7/index.xml" rel="alternate" type="application/rss+xml" title="Version 7 :: Hugo Relearn Theme">
|
|
<link href="/hugo-theme-relearn/images/logo.svg?1729807858" rel="icon" type="image/svg+xml">
|
|
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1729807858" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1729807858" rel="stylesheet"></noscript>
|
|
<link href="/hugo-theme-relearn/css/nucleus.css?1729807858" rel="stylesheet">
|
|
<link href="/hugo-theme-relearn/css/auto-complete.css?1729807858" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1729807858" rel="stylesheet"></noscript>
|
|
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1729807858" rel="stylesheet">
|
|
<link href="/hugo-theme-relearn/css/fonts.css?1729807858" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1729807858" rel="stylesheet"></noscript>
|
|
<link href="/hugo-theme-relearn/css/theme.css?1729807858" rel="stylesheet">
|
|
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1729807858" rel="stylesheet" id="R-variant-style">
|
|
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1729807858" rel="stylesheet" id="R-variant-chroma-style">
|
|
<link href="/hugo-theme-relearn/css/print.css?1729807858" rel="stylesheet" media="print">
|
|
<link href="/hugo-theme-relearn/css/format-print.css?1729807858" rel="stylesheet">
|
|
<script src="/hugo-theme-relearn/js/variant.js?1729807858"></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/7/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+ALT+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+ALT+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="#7-1-0">7.1.0 (xxxx-xx-xx)</a>
|
|
<ul>
|
|
<li><a href="#change">Change</a></li>
|
|
<li><a href="#new">New</a></li>
|
|
</ul>
|
|
</li>
|
|
<li><a href="#7-0-0">7.0.0 (2024-10-15)</a>
|
|
<ul>
|
|
<li><a href="#hugo-01260">Hugo 0.126.0</a></li>
|
|
<li><a href="#breaking">Breaking</a></li>
|
|
<li><a href="#change-1">Change</a></li>
|
|
<li><a href="#new-1">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"> > </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's New</span></a><meta itemprop="position" content="2"> > </li><li
|
|
itemscope itemtype="https://schema.org/ListItem" itemprop="itemListElement"><span itemprop="name">Version 7</span><meta itemprop="position" content="3"></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/7/_index.en.md" target="_self" title="Edit (CTRL+ALT+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/7/index.print.html" title="Print whole chapter (CTRL+ALT+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/index.html" title="What's New (🡐)"><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/5/index.html" title="Version 5 (🡒)"><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-7">Version 7</h1>
|
|
See the <a href="/hugo-theme-relearn/introduction/changelog/7/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>
|
|
|
|
|
|
<p></p>
|
|
<h2 id="7-1-0">7.1.0 (xxxx-xx-xx)</h2>
|
|
<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 sidebar menus are now <a href="/hugo-theme-relearn/configuration/sidebar/menus/index.html">completely configurable</a>.</p>
|
|
<p>This is provided by the new parameter <code>sidebarmenus</code>. With the new system, you can</p>
|
|
<ul>
|
|
<li>show arbitrary amounts of menus</li>
|
|
<li>set headings for each menu</li>
|
|
<li>base it on your page structure or use Hugo’s menu feature</li>
|
|
<li>configure a starting page if a menu is based on page structure</li>
|
|
<li>display unlimited nesting for both menu types</li>
|
|
<li>reconfigure the menus in a page’s front matter</li>
|
|
<li>apply the usual parameter <code>alwaysopen</code>, <code>collapsibleMenu</code>, etc. for all menu types</li>
|
|
</ul>
|
|
<p>You don’t need to change anything in your existing installation as the old configuration is used as a default.</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 <a href="/hugo-theme-relearn/shortcodes/children/index.html"><code>children</code> shortcode</a> was changed to output a page’s <em>LinkTitle</em> instead of previously using the <em>Title</em>.</p>
|
|
<p>As the shortcode always outputs subpages in context of the parent page, it functions similar to the sidebar menu. The sidebar menu itself uses the <em>LinkTitle</em> for naming the menu entries and so should the shortcode do.</p>
|
|
<p>The parameter value <code>sort=linktitle</code> was deprecated for the easier <code>sort=title</code>. You can still use the old value but both behave the same way in sorting by <em>LinkTitle</em>.</p>
|
|
</li>
|
|
</ul>
|
|
<h3 id="new">New</h3>
|
|
<ul>
|
|
<li><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> Menus created by your page structure are now able to <a href="/hugo-theme-relearn/configuration/sidebar/menus/index.html#displaying-arbitrary-links-in-a-page-menu">contain arbitrary links</a> inserted into the structure using the <code>menuUrl</code> or <code>menuPageRef</code> front matter.
|
|
</li>
|
|
</ul>
|
|
<hr>
|
|
<p></p>
|
|
<h2 id="7-0-0">7.0.0 (2024-10-15)</h2>
|
|
<h3 id="hugo-01260">Hugo 0.126.0</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.126.0</span></span> This release requires a newer Hugo version.</li>
|
|
</ul>
|
|
<h3 id="breaking">Breaking</h3>
|
|
<ul>
|
|
<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> This release comes with significant changes in file naming of partials and how the theme works internally. This was done because the theme</p>
|
|
<ul>
|
|
<li>suffered from poor build performance for sites with 1000 or more pages</li>
|
|
<li>reinvented the wheel instead of using available Hugo mechanisms</li>
|
|
</ul>
|
|
<p><em>What do I gain</em>, you may ask. A significant performance boost during build! Usually, the build time has been cut at least in half for bigger sites. It is now possible to build even larger sites with 5000 or more pages. This was previously almost impossible due to rapidly increasing build time with the more pages you’ve introduced. For even bigger sites, the theme now has <a href="/hugo-theme-relearn/configuration/sidebar/menus/index.html#expander-for-submenus">configurable performance optimizations</a> - at the price of feature limitations.</p>
|
|
<p>If you haven’t done customizations to any partials, you can update right away.</p>
|
|
<p>If you have customized your templates, in the best cases, you will get build warnings or even errors. In the worst cases, your build succeeds but the site will not work as intended by you.</p>
|
|
<p>Specifically, you will have to adapt your site if you have</p>
|
|
<ul>
|
|
<li><a href="/hugo-theme-relearn/configuration/customization/partials/index.html">overwritten the <code>header.html</code>, <code>menu.html</code> or <code>footer.html</code> partials</a></li>
|
|
<li><a href="/hugo-theme-relearn/configuration/customization/outputformats/index.html">self-defined output formats</a></li>
|
|
<li>self-defined archetype partials in <code>layouts/partials/archetypes</code> - now becoming <a href="/hugo-theme-relearn/configuration/customization/designs/index.html">page designs</a></li>
|
|
<li><a href="/hugo-theme-relearn/configuration/customization/topbar/index.html">overwritten prev/next topbar buttons</a> - needs sync with implementation changes</li>
|
|
</ul>
|
|
</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> This release changes the way the search index and the dedicated search page are generated. This may require reconfiguration by you to still work as you have intended.</p>
|
|
<p>You need to remove the now obsolete <code>search</code> and <code>searchpage</code> output format from <code>[outputs.home]</code> in your <code>hugo.toml</code>, resulting in something similar to</p>
|
|
<div class="tab-panel" data-tab-group="config-code">
|
|
<div class="tab-nav">
|
|
<div class="tab-nav-title">hugo.</div>
|
|
<button
|
|
data-tab-item="toml"
|
|
class="tab-nav-button tab-panel-style cstyle initial active" tabindex="-1"
|
|
onclick="switchTab('config-code','toml')"
|
|
>
|
|
<span class="tab-nav-text">toml</span>
|
|
</button>
|
|
<button
|
|
data-tab-item="yaml"
|
|
class="tab-nav-button tab-panel-style cstyle initial"
|
|
onclick="switchTab('config-code','yaml')"
|
|
>
|
|
<span class="tab-nav-text">yaml</span>
|
|
</button>
|
|
<button
|
|
data-tab-item="json"
|
|
class="tab-nav-button tab-panel-style cstyle initial"
|
|
onclick="switchTab('config-code','json')"
|
|
>
|
|
<span class="tab-nav-text">json</span>
|
|
</button>
|
|
</div>
|
|
<div class="tab-content-container">
|
|
<div
|
|
data-tab-item="toml"
|
|
class="tab-content tab-panel-style cstyle initial active">
|
|
<div class="tab-content-text">
|
|
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-toml" data-lang="toml"><span class="line"><span class="cl"><span class="p">[</span><span class="nx">outputs</span><span class="p">]</span>
|
|
</span></span><span class="line"><span class="cl"> <span class="nx">home</span> <span class="p">=</span> <span class="p">[</span><span class="s1">'html'</span><span class="p">,</span> <span class="s1">'rss'</span><span class="p">,</span> <span class="s1">'print'</span><span class="p">]</span></span></span></code></pre></div>
|
|
</div>
|
|
</div>
|
|
<div
|
|
data-tab-item="yaml"
|
|
class="tab-content tab-panel-style cstyle initial">
|
|
<div class="tab-content-text">
|
|
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">outputs</span><span class="p">:</span><span class="w">
|
|
</span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">home</span><span class="p">:</span><span class="w">
|
|
</span></span></span><span class="line"><span class="cl"><span class="w"> </span>- <span class="l">html</span><span class="w">
|
|
</span></span></span><span class="line"><span class="cl"><span class="w"> </span>- <span class="l">rss</span><span class="w">
|
|
</span></span></span><span class="line"><span class="cl"><span class="w"> </span>- <span class="l">print</span></span></span></code></pre></div>
|
|
</div>
|
|
</div>
|
|
<div
|
|
data-tab-item="json"
|
|
class="tab-content tab-panel-style cstyle initial">
|
|
<div class="tab-content-text">
|
|
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-json" data-lang="json"><span class="line"><span class="cl"><span class="p">{</span>
|
|
</span></span><span class="line"><span class="cl"> <span class="nt">"outputs"</span><span class="p">:</span> <span class="p">{</span>
|
|
</span></span><span class="line"><span class="cl"> <span class="nt">"home"</span><span class="p">:</span> <span class="p">[</span>
|
|
</span></span><span class="line"><span class="cl"> <span class="s2">"html"</span><span class="p">,</span>
|
|
</span></span><span class="line"><span class="cl"> <span class="s2">"rss"</span><span class="p">,</span>
|
|
</span></span><span class="line"><span class="cl"> <span class="s2">"print"</span>
|
|
</span></span><span class="line"><span class="cl"> <span class="p">]</span>
|
|
</span></span><span class="line"><span class="cl"> <span class="p">}</span>
|
|
</span></span><span class="line"><span class="cl"><span class="p">}</span></span></span></code></pre></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<p>After that, your build will succeed but will most likely cause new defaults to be applied. With no further settings, in-page search, search popup and dedicated search page are all active by default. This can be reconfigured.</p>
|
|
<p>In addition, you are now able to overwrite the default file name of the search index and the default page name of the dedicated search page by changing <code>searchIndexURL</code> and <code>searchPageURL</code> respectively in your <code>hugo.toml</code>.</p>
|
|
<p>See the <a href="/hugo-theme-relearn/configuration/sidebar/search/index.html">updated documentation</a> for reference.</p>
|
|
</li>
|
|
</ul>
|
|
<h3 id="change-1">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> Once again, the theme changed the font. We switched to the excellent <a href="https://github.com/googlefonts/roboto-flex" rel="external" target="_self">Roboto Flex</a> font.</p>
|
|
<p>Care was taken to configure the font to look similar to the previously used Work Sans. Nevertheless, in direct comparison, you will see slight differences in appearance.</p>
|
|
<p>This change was necessary as the previously used font had display issues with <a href="/hugo-theme-relearn/authoring/markdown/index.html#marked-text">marked text</a>, contrast, and some other minor stuff. As an aftermath, the number of requests and the download size were decreased when loading a page.</p>
|
|
<p>The font was created by Google, is licensed under OFL 1.1 and is delivered from your theme’s installation. As always, no third-party server calls are involved.</p>
|
|
<p>If you have changed the <code>font-family</code> in your installation, you most likely have to adjust the variables <code>--MAIN-font-weight</code>, <code>--MAIN-BOLD-font-weight</code> and <code>--MAIN-letter-spacing</code>.</p>
|
|
<p>Additionally, if you have changed the font to a <a href="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">variable font</a> in your installation, you may have to adjust the variable <code>--MAIN-font-variation-settings</code>. As this only applies to <strong>variable fonts</strong>, this should rarely be necessary.</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> While switching the font, it was discovered that certain CSS variables were falsely named. You don’t need to change anything in your custom variant stylesheet as the old names will be used as a fallback.</p>
|
|
<p><code>--MAIN-TITLES-TEXT-font</code> was renamed to <code>--MAIN-TITLES-font</code>, <code>--MAIN-TITLES-H<n>-color</code> was renamed to <code>--MAIN-TITLES-H<n>-TEXT-color</code>.</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 options and front matter to force loading a <a href="/hugo-theme-relearn/shortcodes/math/index.html#force-loading-of-the-mathjax-library">math</a>, <a href="/hugo-theme-relearn/shortcodes/mermaid/index.html#force-loading-of-the-mermaid-library">mermaid</a> or <a href="/hugo-theme-relearn/shortcodes/openapi/index.html#force-loading-of-the-swagger-ui-library">openapi</a> library has been changed.</p>
|
|
<p>Previously, you had to set the unintuitive <code>disableMathJax=false</code> to force load the math library in case of a passthrough configuration. This is replaced by the simpler <code>math=true</code> or <code>math.force=true</code> and is now in line with <a href="https://gohugo.io/content-management/mathematics/#step-1" rel="external" target="_self">Hugo’s official documentation</a>.</p>
|
|
<p>You don’t need to change anything yet but will receive warnings if the old settings are used.</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 default logo is not contained inside of the theme’s logo partial anymore.</p>
|
|
<p>This is to avoid usage of the theme’s branding throughout the web in non-modified installations.</p>
|
|
<p>In addition, the default text for the logo partial is now <a href="/hugo-theme-relearn/configuration/sidebar/headerfooter/index.html#title">taken from the <code>linkTitle</code> setting</a> of your <code>hugo.toml</code>.</p>
|
|
</li>
|
|
</ul>
|
|
<h3 id="new-1">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> The docs received a much-needed overhaul for all chapters.</p>
|
|
<p>Basically, the structure was reorganized, giving each topic its own page while keeping the amount of items for each menu level comprehensible by adding sub-pages.</p>
|
|
<p>The docs now clearly differentiate between <a href="/hugo-theme-relearn/configuration/index.html">configuration of your site</a>, all things <a href="/hugo-theme-relearn/authoring/index.html">writing page content</a> and the <a href="/hugo-theme-relearn/shortcodes/index.html">shortcodes docs</a> that cover both topics, configuration and usage.</p>
|
|
<p>To give you a better overview of what’s possible with the theme, we introduced reference pages for all theme <a href="/hugo-theme-relearn/configuration/reference/index.html">configuration options</a> and <a href="/hugo-theme-relearn/authoring/frontmatter/reference/index.html">front matter</a> and mark each occurrence of such on all pages with the badges <span class="badge cstyle cyan badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-gears"></i></span><span class="badge-content">Option</span></span> and <span class="badge cstyle green badge-with-title"><span class="badge-title"><i class="fa-fw fab fa-markdown"></i></span><span class="badge-content">Front Matter</span></span>.</p>
|
|
<p>Also, a lot of previously undocumented features are now included, namely</p>
|
|
<ul>
|
|
<li>the <a href="/hugo-theme-relearn/configuration/content/hidden/index.html">hidden pages</a> feature</li>
|
|
<li><a href="/hugo-theme-relearn/configuration/sidebar/menus/index.html">options of the menus</a></li>
|
|
<li>configuring <a href="/hugo-theme-relearn/configuration/content/titles/index.html">breadcrumb, titles</a> and <a href="/hugo-theme-relearn/configuration/content/headings/index.html">headings</a> of your content</li>
|
|
<li><a href="/hugo-theme-relearn/configuration/content/linking/index.html">options for using links</a></li>
|
|
<li>adding <a href="/hugo-theme-relearn/configuration/customization/outputformats/index.html">custom output formats</a>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
<footer class="footline">
|
|
</footer>
|
|
</article>
|
|
</div>
|
|
</main>
|
|
</div>
|
|
<script src="/hugo-theme-relearn/js/clipboard.min.js?1729807858" defer></script>
|
|
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1729807858" defer></script>
|
|
<script src="/hugo-theme-relearn/js/theme.js?1729807858" defer></script>
|
|
</body>
|
|
</html>
|