nishiki/hugo-theme-relearn
1
0
Fork 0
mirror of https://github.com/McShelby/hugo-theme-relearn.git synced 2025-05-29 13:04:06 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

deploy: 46e7e5e4cd

Browse source
This commit is contained in:
McShelby 2024-04-07 11:45:38 +00:00
parent ff6d64bc31
commit 2611a9597c
264 changed files with 12648 additions and 12648 deletions

60
basics/branding/index.html
View file

@ -23,21 +23,21 @@
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/basics/branding/index.html" rel="alternate" hreflang="art-pir">
<link href="/hugo-theme-relearn/basics/branding/index.xml" rel="alternate" type="application/rss+xml" title="Branding :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/basics/branding/index.print.html" rel="alternate" type="text/html" title="Branding :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490231" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490231" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490231"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490231"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490332" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490332" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490332" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490332" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490332" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490332" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490332" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490332" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490332" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490332" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490332" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490332" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490332" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490332" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490332"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490332"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -410,13 +410,13 @@
<p>If no favicon file is found, the theme will lookup the alternative filename <code>logo</code> in the same location and will repeat the search for the list of supported file types.</p>
<p>If you need to change this default behavior, create a new file <code>layouts/partials/favicon.html</code> in your site&rsquo;s directory and write something like this:</p>
<div class="tab-panel" data-tab-group="d9bcdd9c61350a8da1c14e7b5716c3a3">
<div class="tab-panel" data-tab-group="ff58e5f95d6c5ce228ed5712f1f645bf">
<div class="tab-nav">
<div class="tab-nav-title">&#8203;</div>
<button
data-tab-item="layoutspartialsfaviconhtml"
class="tab-nav-button tab-panel-style cstyle initial active" tabindex="-1"
onclick="switchTab('d9bcdd9c61350a8da1c14e7b5716c3a3','layoutspartialsfaviconhtml')"
onclick="switchTab('ff58e5f95d6c5ce228ed5712f1f645bf','layoutspartialsfaviconhtml')"
>
<span class="tab-nav-text">layouts/partials/favicon.html</span>
</button>
@ -441,9 +441,9 @@
</div>
</div>
<h2 id="syntax-highlightning">Syntax Highlightning</h2>
<p>If you want to switch the syntax highlighting theme together with your color variant, you need to configure your installation <a href="https://gohugo.io/content-management/syntax-highlighting/" target="_blank">according to Hugo&rsquo;s documentation</a> and provide a syntax highlighting stylesheet file.</p>
<p>If you want to switch the syntax highlighting theme together with your color variant, you need to configure your installation <a href="https://gohugo.io/content-management/syntax-highlighting/" rel="external" target="_blank">according to Hugo&rsquo;s documentation</a> and provide a syntax highlighting stylesheet file.</p>
<p>You can use a one of the shipped stylesheet files or use Hugo to generate a file for you. The file must be written to <code>static/css/chroma-&lt;NAME&gt;.css</code>. To use it with your color variant you have to define <code>--CODE-theme: &lt;NAME&gt;</code> in the color variant stylesheet file.</p>
<p>For an example, take a look into <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/static/css/theme-relearn-light.css" target="_blank"><code>theme-relearn-light.css</code></a> and <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/exampleSite/config/_default/hugo.toml" target="_blank"><code>hugo.toml</code></a> of the exampleSite.</p>
<p>For an example, take a look into <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/static/css/theme-relearn-light.css" rel="external" target="_blank"><code>theme-relearn-light.css</code></a> and <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/exampleSite/config/_default/hugo.toml" rel="external" target="_blank"><code>hugo.toml</code></a> of the exampleSite.</p>
<h2 id="theme-variant-advanced">Change the Variant (Advanced)</h2>
<p>The theme offers a new way to configure theme variants and all of the aspects above inside of a single configuration item. This comes with some features previously unsupported.</p>
<p>Like with the <a href="/hugo-theme-relearn/basics/branding/index.html#multiple-variants">multiple variants</a> option, you are defining your theme variants in an array but now <em>not by simple strings</em> <strong>but in a table with suboptions</strong>.</p>
@ -741,13 +741,13 @@
<p>You can create a new variant file in the site&rsquo;s <code>static/css</code> directory and give it a new name. Import the shipped variant, add the settings you want to change and save the new file. Afterwards you can use it in your <code>hugo.toml</code> by the choosen name.</p>
<p>For example, you want to use the <code>relearn-light</code> variant but want to change the syntax highlightning schema to the one used in the <code>neon</code> variant. For that, create a new <code>static/css/theme-my-branding.css</code> in your site&rsquo;s directory and add the following lines:</p>
<div class="tab-panel" data-tab-group="f72e9d6632a5113d462bbb7c15607bd4">
<div class="tab-panel" data-tab-group="0ab94165aa8b19b88e45472f8d237877">
<div class="tab-nav">
<div class="tab-nav-title">&#8203;</div>
<button
data-tab-item="staticcsstheme-my-brandingcss"
class="tab-nav-button tab-panel-style cstyle initial active" tabindex="-1"
onclick="switchTab('f72e9d6632a5113d462bbb7c15607bd4','staticcsstheme-my-brandingcss')"
onclick="switchTab('0ab94165aa8b19b88e45472f8d237877','staticcsstheme-my-brandingcss')"
>
<span class="tab-nav-text">static/css/theme-my-branding.css</span>
</button>
@ -926,12 +926,12 @@
<script>
var contentLangs=['en'];
</script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490332" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490332" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490332" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490332" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490332" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490332" defer></script>
</div>
<div id="R-homelinks" class="default-animation">
<hr class="padding">
@ -1094,13 +1094,13 @@
setTimeout( githubButtonsInit, 400 );
});
</script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490231"></script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490332"></script>
</div>
</div>
</div>
</aside>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490332" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490332" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490332" defer></script>
</body>
</html>

48
basics/branding/index.print.html
View file

@ -23,22 +23,22 @@
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/basics/branding/index.html" rel="alternate" hreflang="art-pir">
<link href="https://mcshelby.github.io/hugo-theme-relearn/basics/branding/index.html" rel="canonical" type="text/html" title="Branding :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/basics/branding/index.xml" rel="alternate" type="application/rss+xml" title="Branding :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490232" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490232" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490232"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490232"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490333" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490333" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490333"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490333"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -368,13 +368,13 @@
<p>If no favicon file is found, the theme will lookup the alternative filename <code>logo</code> in the same location and will repeat the search for the list of supported file types.</p>
<p>If you need to change this default behavior, create a new file <code>layouts/partials/favicon.html</code> in your site&rsquo;s directory and write something like this:</p>
<div class="tab-panel" data-tab-group="d9bcdd9c61350a8da1c14e7b5716c3a3">
<div class="tab-panel" data-tab-group="ff58e5f95d6c5ce228ed5712f1f645bf">
<div class="tab-nav">
<div class="tab-nav-title">&#8203;</div>
<button
data-tab-item="layoutspartialsfaviconhtml"
class="tab-nav-button tab-panel-style cstyle initial active" tabindex="-1"
onclick="switchTab('d9bcdd9c61350a8da1c14e7b5716c3a3','layoutspartialsfaviconhtml')"
onclick="switchTab('ff58e5f95d6c5ce228ed5712f1f645bf','layoutspartialsfaviconhtml')"
>
<span class="tab-nav-text">layouts/partials/favicon.html</span>
</button>
@ -399,9 +399,9 @@
</div>
</div>
<h2 id="syntax-highlightning">Syntax Highlightning</h2>
<p>If you want to switch the syntax highlighting theme together with your color variant, you need to configure your installation <a href="https://gohugo.io/content-management/syntax-highlighting/" target="_blank">according to Hugo&rsquo;s documentation</a> and provide a syntax highlighting stylesheet file.</p>
<p>If you want to switch the syntax highlighting theme together with your color variant, you need to configure your installation <a href="https://gohugo.io/content-management/syntax-highlighting/" rel="external" target="_blank">according to Hugo&rsquo;s documentation</a> and provide a syntax highlighting stylesheet file.</p>
<p>You can use a one of the shipped stylesheet files or use Hugo to generate a file for you. The file must be written to <code>static/css/chroma-&lt;NAME&gt;.css</code>. To use it with your color variant you have to define <code>--CODE-theme: &lt;NAME&gt;</code> in the color variant stylesheet file.</p>
<p>For an example, take a look into <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/static/css/theme-relearn-light.css" target="_blank"><code>theme-relearn-light.css</code></a> and <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/exampleSite/config/_default/hugo.toml" target="_blank"><code>hugo.toml</code></a> of the exampleSite.</p>
<p>For an example, take a look into <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/static/css/theme-relearn-light.css" rel="external" target="_blank"><code>theme-relearn-light.css</code></a> and <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/exampleSite/config/_default/hugo.toml" rel="external" target="_blank"><code>hugo.toml</code></a> of the exampleSite.</p>
<h2 id="theme-variant-advanced">Change the Variant (Advanced)</h2>
<p>The theme offers a new way to configure theme variants and all of the aspects above inside of a single configuration item. This comes with some features previously unsupported.</p>
<p>Like with the <a href="/hugo-theme-relearn/basics/branding/index.html#multiple-variants">multiple variants</a> option, you are defining your theme variants in an array but now <em>not by simple strings</em> <strong>but in a table with suboptions</strong>.</p>
@ -699,13 +699,13 @@
<p>You can create a new variant file in the site&rsquo;s <code>static/css</code> directory and give it a new name. Import the shipped variant, add the settings you want to change and save the new file. Afterwards you can use it in your <code>hugo.toml</code> by the choosen name.</p>
<p>For example, you want to use the <code>relearn-light</code> variant but want to change the syntax highlightning schema to the one used in the <code>neon</code> variant. For that, create a new <code>static/css/theme-my-branding.css</code> in your site&rsquo;s directory and add the following lines:</p>
<div class="tab-panel" data-tab-group="f72e9d6632a5113d462bbb7c15607bd4">
<div class="tab-panel" data-tab-group="0ab94165aa8b19b88e45472f8d237877">
<div class="tab-nav">
<div class="tab-nav-title">&#8203;</div>
<button
data-tab-item="staticcsstheme-my-brandingcss"
class="tab-nav-button tab-panel-style cstyle initial active" tabindex="-1"
onclick="switchTab('f72e9d6632a5113d462bbb7c15607bd4','staticcsstheme-my-brandingcss')"
onclick="switchTab('0ab94165aa8b19b88e45472f8d237877','staticcsstheme-my-brandingcss')"
>
<span class="tab-nav-text">static/css/theme-my-branding.css</span>
</button>
@ -800,8 +800,8 @@
</div>
</main>
</div>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490333" defer></script>
</body>
</html>

1082
basics/changelog/index.html
View file

File diff suppressed because it is too large Load diff

36
basics/changelog/index.print.html
View file

@ -20,22 +20,22 @@
<meta property="article:section" content="Basics :: Hugo Relearn Theme">
<meta property="og:site_name" content="Hugo Relearn Theme">
<title></title>
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490232" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490232" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490232"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490232"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490333" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490333" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490333"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490333"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -84,8 +84,8 @@
</div>
</main>
</div>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490333" defer></script>
</body>
</html>

54
basics/configuration/index.html
View file

@ -23,21 +23,21 @@
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/basics/configuration/index.html" rel="alternate" hreflang="art-pir">
<link href="/hugo-theme-relearn/basics/configuration/index.xml" rel="alternate" type="application/rss+xml" title="Configuration :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/basics/configuration/index.print.html" rel="alternate" type="text/html" title="Configuration :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490231" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490231" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490231"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490231"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490332" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490332" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490332" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490332" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490332" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490332" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490332" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490332" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490332" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490332" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490332" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490332" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490332" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490332" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490332"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490332"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -122,7 +122,7 @@
</header>
<h1 id="configuration">Configuration</h1>
<p>On top of <a href="https://gohugo.io/overview/configuration/" target="_blank">Hugo&rsquo;s global configuration options</a>, the Relearn theme lets you define further options unique to the theme in your <code>hugo.toml</code>.</p>
<p>On top of <a href="https://gohugo.io/overview/configuration/" rel="external" target="_blank">Hugo&rsquo;s global configuration options</a>, the Relearn theme lets you define further options unique to the theme in your <code>hugo.toml</code>.</p>
<p>Note that some of these options are explained in detail in other sections of this documentation.</p>
<h2 id="all-config-options">All config options</h2>
<p>The values reflect the options active in this documentation. The defaults can be taken from the <a href="/hugo-theme-relearn/basics/configuration/index.html#annotated-config-options">annotated example</a> below.</p>
@ -463,13 +463,13 @@
</div>
<h2 id="annotated-config-options">Annotated config options</h2>
<div class="tab-panel" data-tab-group="e51fae5c53820fe23ae1f9048dd54c15">
<div class="tab-panel" data-tab-group="611cac4bd295b41a9ea92e655aaa5a6d">
<div class="tab-nav">
<div class="tab-nav-title">&#8203;</div>
<button
data-tab-item="hugotoml"
class="tab-nav-button tab-panel-style cstyle initial active" tabindex="-1"
onclick="switchTab('e51fae5c53820fe23ae1f9048dd54c15','hugotoml')"
onclick="switchTab('611cac4bd295b41a9ea92e655aaa5a6d','hugotoml')"
>
<span class="tab-nav-text">hugo.toml</span>
</button>
@ -1029,12 +1029,12 @@
<script>
var contentLangs=['en'];
</script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490333" defer></script>
</div>
<div id="R-homelinks" class="default-animation">
<hr class="padding">
@ -1197,13 +1197,13 @@
setTimeout( githubButtonsInit, 400 );
});
</script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490231"></script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490333"></script>
</div>
</div>
</div>
</aside>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490333" defer></script>
</body>
</html>

42
basics/configuration/index.print.html
View file

@ -23,22 +23,22 @@
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/basics/configuration/index.html" rel="alternate" hreflang="art-pir">
<link href="https://mcshelby.github.io/hugo-theme-relearn/basics/configuration/index.html" rel="canonical" type="text/html" title="Configuration :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/basics/configuration/index.xml" rel="alternate" type="application/rss+xml" title="Configuration :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490232" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490232" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490232"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490232"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490333" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490333" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490333"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490333"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -95,7 +95,7 @@
</header>
<h1 id="configuration">Configuration</h1>
<p>On top of <a href="https://gohugo.io/overview/configuration/" target="_blank">Hugo&rsquo;s global configuration options</a>, the Relearn theme lets you define further options unique to the theme in your <code>hugo.toml</code>.</p>
<p>On top of <a href="https://gohugo.io/overview/configuration/" rel="external" target="_blank">Hugo&rsquo;s global configuration options</a>, the Relearn theme lets you define further options unique to the theme in your <code>hugo.toml</code>.</p>
<p>Note that some of these options are explained in detail in other sections of this documentation.</p>
<h2 id="all-config-options">All config options</h2>
<p>The values reflect the options active in this documentation. The defaults can be taken from the <a href="/hugo-theme-relearn/basics/configuration/index.html#annotated-config-options">annotated example</a> below.</p>
@ -436,13 +436,13 @@
</div>
<h2 id="annotated-config-options">Annotated config options</h2>
<div class="tab-panel" data-tab-group="e51fae5c53820fe23ae1f9048dd54c15">
<div class="tab-panel" data-tab-group="611cac4bd295b41a9ea92e655aaa5a6d">
<div class="tab-nav">
<div class="tab-nav-title">&#8203;</div>
<button
data-tab-item="hugotoml"
class="tab-nav-button tab-panel-style cstyle initial active" tabindex="-1"
onclick="switchTab('e51fae5c53820fe23ae1f9048dd54c15','hugotoml')"
onclick="switchTab('611cac4bd295b41a9ea92e655aaa5a6d','hugotoml')"
>
<span class="tab-nav-text">hugo.toml</span>
</button>
@ -918,8 +918,8 @@
</div>
</main>
</div>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490333" defer></script>
</body>
</html>

78
basics/customization/index.html
View file

@ -23,21 +23,21 @@
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/basics/customization/index.html" rel="alternate" hreflang="art-pir">
<link href="/hugo-theme-relearn/basics/customization/index.xml" rel="alternate" type="application/rss+xml" title="Customization :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/basics/customization/index.print.html" rel="alternate" type="text/html" title="Customization :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490231" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490231" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490231"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490231"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490333" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490333" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490333"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490333"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -366,7 +366,7 @@
<div class="box-label"><i class="fa-fw fas fa-exclamation-triangle"></i> Warning</div>
<div class="box-content">
<p>Using a <code>baseURL</code> with a subdirectory and <code>relativeURLs=true</code> are mutally exclusive due to the fact, that <a href="https://github.com/gohugoio/hugo/issues/12130" target="_blank">Hugo does not apply the <code>baseURL</code> correctly</a>.</p>
<p>Using a <code>baseURL</code> with a subdirectory and <code>relativeURLs=true</code> are mutally exclusive due to the fact, that <a href="https://github.com/gohugoio/hugo/issues/12130" rel="external" target="_blank">Hugo does not apply the <code>baseURL</code> correctly</a>.</p>
<p>If you need both, you have to generate your site twice but with different settings into separate directories.</p>
</div>
</div>
@ -580,8 +580,8 @@
</div>
</div>
<p>You can access this page by either clicking on the magnifier glass or by typing some search term and pressing <code>ENTER</code> inside of the menu&rsquo;s search box .</p>
<p><a href="#R-image-67f4c45ae974a669aac78386e159e059" class="lightbox-link"><img alt="Screenshot of the dedicated search page" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/customization/search_page.png?&width=60pc" style=" height: auto; width: 60pc;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-67f4c45ae974a669aac78386e159e059"><img alt="Screenshot of the dedicated search page" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/customization/search_page.png?&width=60pc"></a></p>
<p><a href="#R-image-571744e2ff0cfada534f8dba93fea805" class="lightbox-link"><img alt="Screenshot of the dedicated search page" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/customization/search_page.png?&width=60pc" style=" height: auto; width: 60pc;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-571744e2ff0cfada534f8dba93fea805"><img alt="Screenshot of the dedicated search page" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/customization/search_page.png?&width=60pc"></a></p>
<div class="box notices cstyle note">
<div class="box-label"><i class="fa-fw fas fa-exclamation-circle"></i> Note</div>
@ -684,7 +684,7 @@
<div class="box-label"><i class="fa-fw fas fa-exclamation-circle"></i> Note</div>
<div class="box-content">
<p>The resulting URL will not be <a href="https://gohugo.io/templates/output-formats/#configure-output-formats" target="_blank">configured ugly</a> in terms of <a href="https://gohugo.io/content-management/urls/#ugly-urls" target="_blank">Hugo&rsquo;s URL handling</a> even if you&rsquo;ve set <code>uglyURLs=true</code> in your <code>hugo.toml</code>. This is due to the fact that for one mime type only one suffix can be configured.</p>
<p>The resulting URL will not be <a href="https://gohugo.io/templates/output-formats/#configure-output-formats" rel="external" target="_blank">configured ugly</a> in terms of <a href="https://gohugo.io/content-management/urls/#ugly-urls" rel="external" target="_blank">Hugo&rsquo;s URL handling</a> even if you&rsquo;ve set <code>uglyURLs=true</code> in your <code>hugo.toml</code>. This is due to the fact that for one mime type only one suffix can be configured.</p>
<p>Nevertheless, if you&rsquo;re unhappy with the resulting URLs you can manually redefine <code>outputFormats.print</code> in your own <code>hugo.toml</code> to your liking.</p>
</div>
</div>
@ -822,10 +822,10 @@ appearance, you will have to configure the <code>landingPageName</code> for the
</div>
</div>
<p>The home button is going to look like this:</p>
<p><a href="#R-image-685ec42a8dd682ba5fa2745e642ca496" class="lightbox-link"><img alt="Default Home Button" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/customization/home_button_defaults.png?width=18.75rem" style=" height: auto; width: 18.75rem;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-685ec42a8dd682ba5fa2745e642ca496"><img alt="Default Home Button" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/customization/home_button_defaults.png?width=18.75rem"></a></p>
<p><a href="#R-image-eab7f233a90a3e575e52a0feb64d32ce" class="lightbox-link"><img alt="Default Home Button" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/customization/home_button_defaults.png?width=18.75rem" style=" height: auto; width: 18.75rem;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-eab7f233a90a3e575e52a0feb64d32ce"><img alt="Default Home Button" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/customization/home_button_defaults.png?width=18.75rem"></a></p>
<h2 id="social-media-meta-tags">Social Media Meta Tags</h2>
<p>You can add social media meta tags for the <a href="https://gohugo.io/templates/internal/#open-graph" target="_blank">Open Graph</a> protocol and <a href="https://gohugo.io/templates/internal/#twitter-cards" target="_blank">Twitter Cards</a> to your site. These are configured as mentioned in the Hugo docs.</p>
<p>You can add social media meta tags for the <a href="https://gohugo.io/templates/internal/#open-graph" rel="external" target="_blank">Open Graph</a> protocol and <a href="https://gohugo.io/templates/internal/#twitter-cards" rel="external" target="_blank">Twitter Cards</a> to your site. These are configured as mentioned in the Hugo docs.</p>
<h2 id="change-the-menu-width">Change the Menu Width</h2>
<p>The menu width adjusts automatically for different screen sizes.</p>
<table>
@ -872,13 +872,13 @@ appearance, you will have to configure the <code>landingPageName</code> for the
<li>
<p>Write the shortcode file <code>layouts/shortcodes/myshortcode.html</code> and add the following line</p>
<div class="tab-panel" data-tab-group="7ec7f4aff1a5a1c3f3c1e8f13f71de83">
<div class="tab-panel" data-tab-group="872aed442bcef6f91c61a4ab064f2b9f">
<div class="tab-nav">
<div class="tab-nav-title">&#8203;</div>
<button
data-tab-item="layoutsshortcodesmyshortcodehtml"
class="tab-nav-button tab-panel-style cstyle initial active" tabindex="-1"
onclick="switchTab('7ec7f4aff1a5a1c3f3c1e8f13f71de83','layoutsshortcodesmyshortcodehtml')"
onclick="switchTab('872aed442bcef6f91c61a4ab064f2b9f','layoutsshortcodesmyshortcodehtml')"
>
<span class="tab-nav-text">layouts/shortcodes/myshortcode.html</span>
</button>
@ -965,19 +965,19 @@ appearance, you will have to configure the <code>landingPageName</code> for the
</div>
</li>
<li>
<p>Add the dependency loader file <code>layouts/partials/dependencies/myshortcode.html</code>. The loader file will be called from multiple locations inside of the theme with the parameter <code>page</code> containing the current <a href="https://gohugo.io/methods/page/" target="_blank">page</a> variable and <code>location</code> with one of the currently defined locations</p>
<p>Add the dependency loader file <code>layouts/partials/dependencies/myshortcode.html</code>. The loader file will be called from multiple locations inside of the theme with the parameter <code>page</code> containing the current <a href="https://gohugo.io/methods/page/" rel="external" target="_blank">page</a> variable and <code>location</code> with one of the currently defined locations</p>
<ul>
<li><code>header</code>: if called at the end of the HTML <code>head</code> element</li>
<li><code>footer</code>: if called at the end of the HTML <code>body</code> element</li>
</ul>
<div class="tab-panel" data-tab-group="24b6fa8f7c11c2f66b1f4b5ab7fccfe0">
<div class="tab-panel" data-tab-group="8d482378d30223a4a63d6c974da093e7">
<div class="tab-nav">
<div class="tab-nav-title">&#8203;</div>
<button
data-tab-item="layoutspartialsdependenciesmyshortcodehtml"
class="tab-nav-button tab-panel-style cstyle initial active" tabindex="-1"
onclick="switchTab('24b6fa8f7c11c2f66b1f4b5ab7fccfe0','layoutspartialsdependenciesmyshortcodehtml')"
onclick="switchTab('8d482378d30223a4a63d6c974da093e7','layoutspartialsdependenciesmyshortcodehtml')"
>
<span class="tab-nav-text">layouts/partials/dependencies/myshortcode.html</span>
</button>
@ -1010,14 +1010,14 @@ appearance, you will have to configure the <code>landingPageName</code> for the
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go"><span class="line"><span class="cl"><span class="p">{{</span><span class="o">-</span> <span class="nx">partial</span> <span class="s">&#34;dependencies.html&#34;</span> <span class="p">(</span><span class="nx">dict</span> <span class="s">&#34;page&#34;</span> <span class="p">.</span> <span class="s">&#34;location&#34;</span> <span class="s">&#34;mylocation&#34;</span><span class="p">)</span> <span class="p">}}</span></span></span></code></pre></div></div>
</div>
<h2 id="output-formats">Output Formats</h2>
<p>Certain parts of the theme can be changed for support of your own <a href="https://gohugo.io/templates/output-formats/" target="_blank">output formats</a>. Eg. if you define a new output format <code>PLAINTEXT</code> in your <code>hugo.toml</code>, you can add a file <code>layouts/partials/header.plaintext.html</code> to change the way, the page header should look like for that output format.</p>
<p>Certain parts of the theme can be changed for support of your own <a href="https://gohugo.io/templates/output-formats/" rel="external" target="_blank">output formats</a>. Eg. if you define a new output format <code>PLAINTEXT</code> in your <code>hugo.toml</code>, you can add a file <code>layouts/partials/header.plaintext.html</code> to change the way, the page header should look like for that output format.</p>
<h2 id="react-to-variant-switches-in-javascript">React to Variant Switches in JavaScript</h2>
<p>Once a color variant is fully loaded, either initially or by switching the color variant manually with the variant selector, the custom event <code>themeVariantLoaded</code> on the <code>document</code> will be dispatched. You can add an event listener and react to changes.</p>
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-javascript" data-lang="javascript"><span class="line"><span class="cl"><span class="nb">document</span><span class="p">.</span><span class="nx">addEventListener</span><span class="p">(</span> <span class="s1">&#39;themeVariantLoaded&#39;</span><span class="p">,</span> <span class="kd">function</span><span class="p">(</span> <span class="nx">e</span> <span class="p">){</span>
</span></span><span class="line"><span class="cl"> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span> <span class="nx">e</span><span class="p">.</span><span class="nx">detail</span><span class="p">.</span><span class="nx">variant</span> <span class="p">);</span> <span class="c1">// `relearn-light`
</span></span></span><span class="line"><span class="cl"><span class="c1"></span><span class="p">});</span></span></span></code></pre></div><h2 id="partials">Partials</h2>
<p>The Relearn theme has been built to be as configurable as possible by defining multiple <a href="https://gohugo.io/templates/partials/" target="_blank">partials</a></p>
<p>In <code>themes/hugo-theme-relearn/layouts/partials/</code>, you will find all the partials defined for this theme. If you need to overwrite something, don&rsquo;t change the code directly. Instead <a href="https://gohugo.io/themes/customizing/" target="_blank">follow this page</a>. You&rsquo;d create a new partial in the <code>layouts/partials</code> folder of your local project. This partial will have the priority.</p>
<p>The Relearn theme has been built to be as configurable as possible by defining multiple <a href="https://gohugo.io/templates/partials/" rel="external" target="_blank">partials</a></p>
<p>In <code>themes/hugo-theme-relearn/layouts/partials/</code>, you will find all the partials defined for this theme. If you need to overwrite something, don&rsquo;t change the code directly. Instead <a href="https://gohugo.io/themes/customizing/" rel="external" target="_blank">follow this page</a>. You&rsquo;d create a new partial in the <code>layouts/partials</code> folder of your local project. This partial will have the priority.</p>
<p>This theme defines the following partials :</p>
<ul>
<li><code>header.html</code>: the header of the page. See <a href="/hugo-theme-relearn/basics/customization/index.html#output-formats">output-formats</a></li>
@ -1134,12 +1134,12 @@ appearance, you will have to configure the <code>landingPageName</code> for the
<script>
var contentLangs=['en'];
</script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490333" defer></script>
</div>
<div id="R-homelinks" class="default-animation">
<hr class="padding">
@ -1302,13 +1302,13 @@ appearance, you will have to configure the <code>landingPageName</code> for the
setTimeout( githubButtonsInit, 400 );
});
</script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490231"></script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490333"></script>
</div>
</div>
</div>
</aside>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490333" defer></script>
</body>
</html>

66
basics/customization/index.print.html
View file

@ -23,22 +23,22 @@
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/basics/customization/index.html" rel="alternate" hreflang="art-pir">
<link href="https://mcshelby.github.io/hugo-theme-relearn/basics/customization/index.html" rel="canonical" type="text/html" title="Customization :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/basics/customization/index.xml" rel="alternate" type="application/rss+xml" title="Customization :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490232" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490232" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490232"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490232"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490333" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490333" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490333"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490333"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -319,7 +319,7 @@
<div class="box-label"><i class="fa-fw fas fa-exclamation-triangle"></i> Warning</div>
<div class="box-content">
<p>Using a <code>baseURL</code> with a subdirectory and <code>relativeURLs=true</code> are mutally exclusive due to the fact, that <a href="https://github.com/gohugoio/hugo/issues/12130" target="_blank">Hugo does not apply the <code>baseURL</code> correctly</a>.</p>
<p>Using a <code>baseURL</code> with a subdirectory and <code>relativeURLs=true</code> are mutally exclusive due to the fact, that <a href="https://github.com/gohugoio/hugo/issues/12130" rel="external" target="_blank">Hugo does not apply the <code>baseURL</code> correctly</a>.</p>
<p>If you need both, you have to generate your site twice but with different settings into separate directories.</p>
</div>
</div>
@ -533,8 +533,8 @@
</div>
</div>
<p>You can access this page by either clicking on the magnifier glass or by typing some search term and pressing <code>ENTER</code> inside of the menu&rsquo;s search box .</p>
<p><a href="#R-image-67f4c45ae974a669aac78386e159e059" class="lightbox-link"><img alt="Screenshot of the dedicated search page" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/customization/search_page.png?&width=60pc" style=" height: auto; width: 60pc;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-67f4c45ae974a669aac78386e159e059"><img alt="Screenshot of the dedicated search page" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/customization/search_page.png?&width=60pc"></a></p>
<p><a href="#R-image-571744e2ff0cfada534f8dba93fea805" class="lightbox-link"><img alt="Screenshot of the dedicated search page" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/customization/search_page.png?&width=60pc" style=" height: auto; width: 60pc;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-571744e2ff0cfada534f8dba93fea805"><img alt="Screenshot of the dedicated search page" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/customization/search_page.png?&width=60pc"></a></p>
<div class="box notices cstyle note">
<div class="box-label"><i class="fa-fw fas fa-exclamation-circle"></i> Note</div>
@ -637,7 +637,7 @@
<div class="box-label"><i class="fa-fw fas fa-exclamation-circle"></i> Note</div>
<div class="box-content">
<p>The resulting URL will not be <a href="https://gohugo.io/templates/output-formats/#configure-output-formats" target="_blank">configured ugly</a> in terms of <a href="https://gohugo.io/content-management/urls/#ugly-urls" target="_blank">Hugo&rsquo;s URL handling</a> even if you&rsquo;ve set <code>uglyURLs=true</code> in your <code>hugo.toml</code>. This is due to the fact that for one mime type only one suffix can be configured.</p>
<p>The resulting URL will not be <a href="https://gohugo.io/templates/output-formats/#configure-output-formats" rel="external" target="_blank">configured ugly</a> in terms of <a href="https://gohugo.io/content-management/urls/#ugly-urls" rel="external" target="_blank">Hugo&rsquo;s URL handling</a> even if you&rsquo;ve set <code>uglyURLs=true</code> in your <code>hugo.toml</code>. This is due to the fact that for one mime type only one suffix can be configured.</p>
<p>Nevertheless, if you&rsquo;re unhappy with the resulting URLs you can manually redefine <code>outputFormats.print</code> in your own <code>hugo.toml</code> to your liking.</p>
</div>
</div>
@ -775,10 +775,10 @@ appearance, you will have to configure the <code>landingPageName</code> for the
</div>
</div>
<p>The home button is going to look like this:</p>
<p><a href="#R-image-685ec42a8dd682ba5fa2745e642ca496" class="lightbox-link"><img alt="Default Home Button" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/customization/home_button_defaults.png?width=18.75rem" style=" height: auto; width: 18.75rem;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-685ec42a8dd682ba5fa2745e642ca496"><img alt="Default Home Button" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/customization/home_button_defaults.png?width=18.75rem"></a></p>
<p><a href="#R-image-eab7f233a90a3e575e52a0feb64d32ce" class="lightbox-link"><img alt="Default Home Button" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/customization/home_button_defaults.png?width=18.75rem" style=" height: auto; width: 18.75rem;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-eab7f233a90a3e575e52a0feb64d32ce"><img alt="Default Home Button" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/customization/home_button_defaults.png?width=18.75rem"></a></p>
<h2 id="social-media-meta-tags">Social Media Meta Tags</h2>
<p>You can add social media meta tags for the <a href="https://gohugo.io/templates/internal/#open-graph" target="_blank">Open Graph</a> protocol and <a href="https://gohugo.io/templates/internal/#twitter-cards" target="_blank">Twitter Cards</a> to your site. These are configured as mentioned in the Hugo docs.</p>
<p>You can add social media meta tags for the <a href="https://gohugo.io/templates/internal/#open-graph" rel="external" target="_blank">Open Graph</a> protocol and <a href="https://gohugo.io/templates/internal/#twitter-cards" rel="external" target="_blank">Twitter Cards</a> to your site. These are configured as mentioned in the Hugo docs.</p>
<h2 id="change-the-menu-width">Change the Menu Width</h2>
<p>The menu width adjusts automatically for different screen sizes.</p>
<table>
@ -825,13 +825,13 @@ appearance, you will have to configure the <code>landingPageName</code> for the
<li>
<p>Write the shortcode file <code>layouts/shortcodes/myshortcode.html</code> and add the following line</p>
<div class="tab-panel" data-tab-group="7ec7f4aff1a5a1c3f3c1e8f13f71de83">
<div class="tab-panel" data-tab-group="872aed442bcef6f91c61a4ab064f2b9f">
<div class="tab-nav">
<div class="tab-nav-title">&#8203;</div>
<button
data-tab-item="layoutsshortcodesmyshortcodehtml"
class="tab-nav-button tab-panel-style cstyle initial active" tabindex="-1"
onclick="switchTab('7ec7f4aff1a5a1c3f3c1e8f13f71de83','layoutsshortcodesmyshortcodehtml')"
onclick="switchTab('872aed442bcef6f91c61a4ab064f2b9f','layoutsshortcodesmyshortcodehtml')"
>
<span class="tab-nav-text">layouts/shortcodes/myshortcode.html</span>
</button>
@ -918,19 +918,19 @@ appearance, you will have to configure the <code>landingPageName</code> for the
</div>
</li>
<li>
<p>Add the dependency loader file <code>layouts/partials/dependencies/myshortcode.html</code>. The loader file will be called from multiple locations inside of the theme with the parameter <code>page</code> containing the current <a href="https://gohugo.io/methods/page/" target="_blank">page</a> variable and <code>location</code> with one of the currently defined locations</p>
<p>Add the dependency loader file <code>layouts/partials/dependencies/myshortcode.html</code>. The loader file will be called from multiple locations inside of the theme with the parameter <code>page</code> containing the current <a href="https://gohugo.io/methods/page/" rel="external" target="_blank">page</a> variable and <code>location</code> with one of the currently defined locations</p>
<ul>
<li><code>header</code>: if called at the end of the HTML <code>head</code> element</li>
<li><code>footer</code>: if called at the end of the HTML <code>body</code> element</li>
</ul>
<div class="tab-panel" data-tab-group="24b6fa8f7c11c2f66b1f4b5ab7fccfe0">
<div class="tab-panel" data-tab-group="8d482378d30223a4a63d6c974da093e7">
<div class="tab-nav">
<div class="tab-nav-title">&#8203;</div>
<button
data-tab-item="layoutspartialsdependenciesmyshortcodehtml"
class="tab-nav-button tab-panel-style cstyle initial active" tabindex="-1"
onclick="switchTab('24b6fa8f7c11c2f66b1f4b5ab7fccfe0','layoutspartialsdependenciesmyshortcodehtml')"
onclick="switchTab('8d482378d30223a4a63d6c974da093e7','layoutspartialsdependenciesmyshortcodehtml')"
>
<span class="tab-nav-text">layouts/partials/dependencies/myshortcode.html</span>
</button>
@ -963,14 +963,14 @@ appearance, you will have to configure the <code>landingPageName</code> for the
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go"><span class="line"><span class="cl"><span class="p">{{</span><span class="o">-</span> <span class="nx">partial</span> <span class="s">&#34;dependencies.html&#34;</span> <span class="p">(</span><span class="nx">dict</span> <span class="s">&#34;page&#34;</span> <span class="p">.</span> <span class="s">&#34;location&#34;</span> <span class="s">&#34;mylocation&#34;</span><span class="p">)</span> <span class="p">}}</span></span></span></code></pre></div></div>
</div>
<h2 id="output-formats">Output Formats</h2>
<p>Certain parts of the theme can be changed for support of your own <a href="https://gohugo.io/templates/output-formats/" target="_blank">output formats</a>. Eg. if you define a new output format <code>PLAINTEXT</code> in your <code>hugo.toml</code>, you can add a file <code>layouts/partials/header.plaintext.html</code> to change the way, the page header should look like for that output format.</p>
<p>Certain parts of the theme can be changed for support of your own <a href="https://gohugo.io/templates/output-formats/" rel="external" target="_blank">output formats</a>. Eg. if you define a new output format <code>PLAINTEXT</code> in your <code>hugo.toml</code>, you can add a file <code>layouts/partials/header.plaintext.html</code> to change the way, the page header should look like for that output format.</p>
<h2 id="react-to-variant-switches-in-javascript">React to Variant Switches in JavaScript</h2>
<p>Once a color variant is fully loaded, either initially or by switching the color variant manually with the variant selector, the custom event <code>themeVariantLoaded</code> on the <code>document</code> will be dispatched. You can add an event listener and react to changes.</p>
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-javascript" data-lang="javascript"><span class="line"><span class="cl"><span class="nb">document</span><span class="p">.</span><span class="nx">addEventListener</span><span class="p">(</span> <span class="s1">&#39;themeVariantLoaded&#39;</span><span class="p">,</span> <span class="kd">function</span><span class="p">(</span> <span class="nx">e</span> <span class="p">){</span>
</span></span><span class="line"><span class="cl"> <span class="nx">console</span><span class="p">.</span><span class="nx">log</span><span class="p">(</span> <span class="nx">e</span><span class="p">.</span><span class="nx">detail</span><span class="p">.</span><span class="nx">variant</span> <span class="p">);</span> <span class="c1">// `relearn-light`
</span></span></span><span class="line"><span class="cl"><span class="c1"></span><span class="p">});</span></span></span></code></pre></div><h2 id="partials">Partials</h2>
<p>The Relearn theme has been built to be as configurable as possible by defining multiple <a href="https://gohugo.io/templates/partials/" target="_blank">partials</a></p>
<p>In <code>themes/hugo-theme-relearn/layouts/partials/</code>, you will find all the partials defined for this theme. If you need to overwrite something, don&rsquo;t change the code directly. Instead <a href="https://gohugo.io/themes/customizing/" target="_blank">follow this page</a>. You&rsquo;d create a new partial in the <code>layouts/partials</code> folder of your local project. This partial will have the priority.</p>
<p>The Relearn theme has been built to be as configurable as possible by defining multiple <a href="https://gohugo.io/templates/partials/" rel="external" target="_blank">partials</a></p>
<p>In <code>themes/hugo-theme-relearn/layouts/partials/</code>, you will find all the partials defined for this theme. If you need to overwrite something, don&rsquo;t change the code directly. Instead <a href="https://gohugo.io/themes/customizing/" rel="external" target="_blank">follow this page</a>. You&rsquo;d create a new partial in the <code>layouts/partials</code> folder of your local project. This partial will have the priority.</p>
<p>This theme defines the following partials :</p>
<ul>
<li><code>header.html</code>: the header of the page. See <a href="/hugo-theme-relearn/basics/customization/index.html#output-formats">output-formats</a></li>
@ -1003,8 +1003,8 @@ appearance, you will have to configure the <code>landingPageName</code> for the
</div>
</main>
</div>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490333" defer></script>
</body>
</html>

76
basics/generator/index.html
View file

@ -23,21 +23,21 @@
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/basics/generator/index.html" rel="alternate" hreflang="art-pir">
<link href="/hugo-theme-relearn/basics/generator/index.xml" rel="alternate" type="application/rss+xml" title="Stylesheet generator :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/basics/generator/index.print.html" rel="alternate" type="text/html" title="Stylesheet generator :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490231" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490231" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490231"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490231"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490333" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490333" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490333"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490333"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -114,13 +114,13 @@
<p>This interactive tool may help you to generate your own color variant stylesheet.</p>
<div class="expand">
<input type="checkbox" id="R-expand-fa0be854aa05715fd8877a4cab9ae2ea" aria-controls="R-expandcontent-fa0be854aa05715fd8877a4cab9ae2ea" >
<label class="expand-label" for="R-expand-fa0be854aa05715fd8877a4cab9ae2ea" >
<input type="checkbox" id="R-expand-8ecd9f96d8fec44bbf805caeaa3bda9f" aria-controls="R-expandcontent-8ecd9f96d8fec44bbf805caeaa3bda9f" >
<label class="expand-label" for="R-expand-8ecd9f96d8fec44bbf805caeaa3bda9f" >
<i class="fa-fw fas fa-chevron-down"></i>
<i class="fa-fw fas fa-chevron-right"></i>
Show usage instructions
</label>
<div id="R-expandcontent-fa0be854aa05715fd8877a4cab9ae2ea" class="expand-content">
<div id="R-expandcontent-8ecd9f96d8fec44bbf805caeaa3bda9f" class="expand-content">
<p>To get started, first select a color variant from the variant selector in the lower left sidebar that fits you best as a starting point.</p>
<p>The graph is interactive and reflect the current colors. You can click on any of the colored boxes to adjust the respective color. The graph <strong>and the page</strong> will update accordingly.</p>
@ -237,12 +237,12 @@ window.variants && variants.generator( '#R-vargenerator' );
<script>
var contentLangs=['en'];
</script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490333" defer></script>
</div>
<div id="R-homelinks" class="default-animation">
<hr class="padding">
@ -405,27 +405,27 @@ window.variants && variants.generator( '#R-vargenerator' );
setTimeout( githubButtonsInit, 400 );
});
</script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490231"></script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490333"></script>
</div>
</div>
</div>
</aside>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-color.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-dispatch.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-drag.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-ease.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-interpolate.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-selection.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-timer.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-transition.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-zoom.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/js-yaml.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/mermaid.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-color.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-dispatch.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-drag.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-ease.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-interpolate.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-selection.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-timer.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-transition.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-zoom.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/js-yaml.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/mermaid.min.js?1712490333" defer></script>
<script>
window.themeUseMermaid = JSON.parse("{ \"securityLevel\": \"loose\" }");
</script>
<script src="/hugo-theme-relearn/js/theme.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490333" defer></script>
</body>
</html>

64
basics/generator/index.print.html
View file

@ -23,22 +23,22 @@
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/basics/generator/index.html" rel="alternate" hreflang="art-pir">
<link href="https://mcshelby.github.io/hugo-theme-relearn/basics/generator/index.html" rel="canonical" type="text/html" title="Stylesheet generator :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/basics/generator/index.xml" rel="alternate" type="application/rss+xml" title="Stylesheet generator :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490232" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490232" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490232"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490232"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490333" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490333" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490333"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490333"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -93,13 +93,13 @@
<p>This interactive tool may help you to generate your own color variant stylesheet.</p>
<div class="expand">
<input type="checkbox" id="R-expand-fa0be854aa05715fd8877a4cab9ae2ea" aria-controls="R-expandcontent-fa0be854aa05715fd8877a4cab9ae2ea" >
<label class="expand-label" for="R-expand-fa0be854aa05715fd8877a4cab9ae2ea" >
<input type="checkbox" id="R-expand-8ecd9f96d8fec44bbf805caeaa3bda9f" aria-controls="R-expandcontent-8ecd9f96d8fec44bbf805caeaa3bda9f" >
<label class="expand-label" for="R-expand-8ecd9f96d8fec44bbf805caeaa3bda9f" >
<i class="fa-fw fas fa-chevron-down"></i>
<i class="fa-fw fas fa-chevron-right"></i>
Show usage instructions
</label>
<div id="R-expandcontent-fa0be854aa05715fd8877a4cab9ae2ea" class="expand-content">
<div id="R-expandcontent-8ecd9f96d8fec44bbf805caeaa3bda9f" class="expand-content">
<p>To get started, first select a color variant from the variant selector in the lower left sidebar that fits you best as a starting point.</p>
<p>The graph is interactive and reflect the current colors. You can click on any of the colored boxes to adjust the respective color. The graph <strong>and the page</strong> will update accordingly.</p>
@ -132,22 +132,22 @@ window.variants && variants.generator( '#R-vargenerator' );
</div>
</main>
</div>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-color.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-dispatch.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-drag.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-ease.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-interpolate.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-selection.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-timer.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-transition.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-zoom.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/js-yaml.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/mermaid.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-color.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-dispatch.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-drag.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-ease.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-interpolate.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-selection.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-timer.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-transition.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/d3/d3-zoom.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/js-yaml.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/mermaid.min.js?1712490333" defer></script>
<script>
window.themeUseMermaid = JSON.parse("{ \"securityLevel\": \"loose\" }");
</script>
<script src="/hugo-theme-relearn/js/theme.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490333" defer></script>
</body>
</html>

1082
basics/history/index.html
View file

File diff suppressed because it is too large Load diff

1070
basics/history/index.print.html
View file

File diff suppressed because it is too large Load diff

48
basics/index.html
View file

@ -23,21 +23,21 @@
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/basics/index.html" rel="alternate" hreflang="art-pir">
<link href="/hugo-theme-relearn/basics/index.xml" rel="alternate" type="application/rss+xml" title="Basics :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/basics/index.print.html" rel="alternate" type="text/html" title="Basics :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490231" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490231" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490231"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490231"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490332" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490332" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490332" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490332" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490332" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490332" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490332" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490332" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490332" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490332" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490332" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490332" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490332" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490332" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490332"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490332"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..';
@ -204,12 +204,12 @@
<script>
var contentLangs=['en'];
</script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490332" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490332" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490332" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490332" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490332" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490332" defer></script>
</div>
<div id="R-homelinks" class="default-animation">
<hr class="padding">
@ -372,13 +372,13 @@
setTimeout( githubButtonsInit, 400 );
});
</script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490231"></script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490332"></script>
</div>
</div>
</div>
</aside>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490332" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490332" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490332" defer></script>
</body>
</html>

1258
basics/index.print.html
View file

File diff suppressed because it is too large Load diff

64
basics/installation/index.html
View file

@ -23,21 +23,21 @@
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/basics/installation/index.html" rel="alternate" hreflang="art-pir">
<link href="/hugo-theme-relearn/basics/installation/index.xml" rel="alternate" type="application/rss+xml" title="Installation :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/basics/installation/index.print.html" rel="alternate" type="text/html" title="Installation :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490231" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490231" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490231"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490231"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490333" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490333" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490333"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490333"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -134,7 +134,7 @@
</header>
<h1 id="installation">Installation</h1>
<p>The following steps are here to help you initialize your new website. If you don&rsquo;t know Hugo at all, we strongly suggest you learn more about it by following this <a href="https://gohugo.io/overview/quickstart/" target="_blank">great documentation for beginners</a>.</p>
<p>The following steps are here to help you initialize your new website. If you don&rsquo;t know Hugo at all, we strongly suggest you learn more about it by following this <a href="https://gohugo.io/overview/quickstart/" rel="external" target="_blank">great documentation for beginners</a>.</p>
<div class="box notices cstyle tip">
<div class="box-label"><i class="fa-fw fas fa-lightbulb"></i> Tip</div>
@ -150,14 +150,14 @@
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl"><span class="nb">cd</span> my-new-site</span></span></code></pre></div><p>Every upcoming command will be executed from inside your new site&rsquo;s root.</p>
<h2 id="install-the-theme">Install the theme</h2>
<h3 id="from-download">From Download</h3>
<p>You can <a href="https://github.com/McShelby/hugo-theme-relearn/archive/main.zip" target="_blank">download the theme as .zip</a> file and extract it into them <code>themes/hugo-theme-relearn</code> directory.</p>
<p>You can <a href="https://github.com/McShelby/hugo-theme-relearn/archive/main.zip" rel="external" target="_blank">download the theme as .zip</a> file and extract it into them <code>themes/hugo-theme-relearn</code> directory.</p>
<h3 id="with-hugos-module-system">With Hugo&rsquo;s Module System</h3>
<p>Install the Relearn theme by following <a href="https://gohugo.io/hugo-modules/use-modules/#use-a-module-for-a-theme" target="_blank">this documentation</a> using Hugo&rsquo;s module system.</p>
<p>This theme&rsquo;s repository is: <a href="https://github.com/McShelby/hugo-theme-relearn.git" target="_blank">https://github.com/McShelby/hugo-theme-relearn.git</a></p>
<p>Install the Relearn theme by following <a href="https://gohugo.io/hugo-modules/use-modules/#use-a-module-for-a-theme" rel="external" target="_blank">this documentation</a> using Hugo&rsquo;s module system.</p>
<p>This theme&rsquo;s repository is: <a href="https://github.com/McShelby/hugo-theme-relearn.git" rel="external" target="_blank">https://github.com/McShelby/hugo-theme-relearn.git</a></p>
<h3 id="using-git-or-git-submodules">Using Git or Git Submodules</h3>
<p>If you install the theme from your git repository or GitHub, you have several options.</p>
<p>If you use the <code>head</code> of the <code>main</code> branch, you are using the development version. Usually it is fully functional but can break from time to time. We try to fix newly introduced bugs in this version as soon as possible.</p>
<p>Additionally you can checkout one of the tagged versions. These tagged versions correspond to an official <a href="https://github.com/McShelby/hugo-theme-relearn/releases" target="_blank">releases from the GitHub repository</a>.</p>
<p>Additionally you can checkout one of the tagged versions. These tagged versions correspond to an official <a href="https://github.com/McShelby/hugo-theme-relearn/releases" rel="external" target="_blank">releases from the GitHub repository</a>.</p>
<p>Besides the usual version tags (eg <code>1.2.3</code>) there are also tags for the main version (eg. <code>1.2.x</code>), major version (eg. <code>1.x</code>) and the latest (just <code>x</code>) released version making it easier for you to pin the theme to a certain version.</p>
<h2 id="basic-configuration">Basic Configuration</h2>
<p>When building the website, you can set a theme by using <code>--theme</code> option. However, we suggest you modify the configuration file <code>hugo.toml</code> and set the theme as the default.</p>
@ -223,8 +223,8 @@
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-md" data-lang="md"><span class="line"><span class="cl"><span class="gh"># Basics
</span></span></span><span class="line"><span class="cl"><span class="gh"></span>
</span></span><span class="line"><span class="cl">Discover what this Hugo theme is all about and the core concepts behind it.</span></span></code></pre></div><p>renders as</p>
<p><a href="#R-image-e9db4020aa998614e168d6f3be3aa3e2" class="lightbox-link"><img alt="A Chapter" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/installation/chapter.png?width=60pc" style=" height: auto; width: 60pc;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-e9db4020aa998614e168d6f3be3aa3e2"><img alt="A Chapter" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/installation/chapter.png?width=60pc"></a></p>
<p><a href="#R-image-03daf2d1558847d4ade9d0334710d9a2" class="lightbox-link"><img alt="A Chapter" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/installation/chapter.png?width=60pc" style=" height: auto; width: 60pc;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-03daf2d1558847d4ade9d0334710d9a2"><img alt="A Chapter" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/installation/chapter.png?width=60pc"></a></p>
<p>Begin by creating your first chapter page with the following command:</p>
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">hugo new --kind chapter basics/_index.md</span></span></code></pre></div><p>By opening the given file, you should see the property <code>archetype=chapter</code> on top, meaning this page is a <em>chapter</em>.</p>
<p>The <code>weight</code> number will be used to generate the subtitle of the chapter page, set the number to a consecutive value starting at 1 for each new chapter level.</p>
@ -244,7 +244,7 @@
<h2 id="build-the-website">Build the Website</h2>
<p>When your site is ready to deploy, run the following command:</p>
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">hugo</span></span></code></pre></div><p>A <code>public</code> folder will be generated, containing all content and assets for your website. It can now be deployed on any web server.</p>
<p>Now it&rsquo;s time to deploy your page by simply uploading your project to some webserver or by using one of <a href="https://gohugo.io/hosting-and-deployment/" target="_blank">Hugo&rsquo;s many deployment options</a>.</p>
<p>Now it&rsquo;s time to deploy your page by simply uploading your project to some webserver or by using one of <a href="https://gohugo.io/hosting-and-deployment/" rel="external" target="_blank">Hugo&rsquo;s many deployment options</a>.</p>
<footer class="footline">
</footer>
@ -337,12 +337,12 @@
<script>
var contentLangs=['en'];
</script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490333" defer></script>
</div>
<div id="R-homelinks" class="default-animation">
<hr class="padding">
@ -505,13 +505,13 @@
setTimeout( githubButtonsInit, 400 );
});
</script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490231"></script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490333"></script>
</div>
</div>
</div>
</aside>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490333" defer></script>
</body>
</html>

52
basics/installation/index.print.html
View file

@ -23,22 +23,22 @@
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/basics/installation/index.html" rel="alternate" hreflang="art-pir">
<link href="https://mcshelby.github.io/hugo-theme-relearn/basics/installation/index.html" rel="canonical" type="text/html" title="Installation :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/basics/installation/index.xml" rel="alternate" type="application/rss+xml" title="Installation :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490232" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490232" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490232"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490232"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490333" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490333" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490333"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490333"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -95,7 +95,7 @@
</header>
<h1 id="installation">Installation</h1>
<p>The following steps are here to help you initialize your new website. If you don&rsquo;t know Hugo at all, we strongly suggest you learn more about it by following this <a href="https://gohugo.io/overview/quickstart/" target="_blank">great documentation for beginners</a>.</p>
<p>The following steps are here to help you initialize your new website. If you don&rsquo;t know Hugo at all, we strongly suggest you learn more about it by following this <a href="https://gohugo.io/overview/quickstart/" rel="external" target="_blank">great documentation for beginners</a>.</p>
<div class="box notices cstyle tip">
<div class="box-label"><i class="fa-fw fas fa-lightbulb"></i> Tip</div>
@ -111,14 +111,14 @@
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl"><span class="nb">cd</span> my-new-site</span></span></code></pre></div><p>Every upcoming command will be executed from inside your new site&rsquo;s root.</p>
<h2 id="install-the-theme">Install the theme</h2>
<h3 id="from-download">From Download</h3>
<p>You can <a href="https://github.com/McShelby/hugo-theme-relearn/archive/main.zip" target="_blank">download the theme as .zip</a> file and extract it into them <code>themes/hugo-theme-relearn</code> directory.</p>
<p>You can <a href="https://github.com/McShelby/hugo-theme-relearn/archive/main.zip" rel="external" target="_blank">download the theme as .zip</a> file and extract it into them <code>themes/hugo-theme-relearn</code> directory.</p>
<h3 id="with-hugos-module-system">With Hugo&rsquo;s Module System</h3>
<p>Install the Relearn theme by following <a href="https://gohugo.io/hugo-modules/use-modules/#use-a-module-for-a-theme" target="_blank">this documentation</a> using Hugo&rsquo;s module system.</p>
<p>This theme&rsquo;s repository is: <a href="https://github.com/McShelby/hugo-theme-relearn.git" target="_blank">https://github.com/McShelby/hugo-theme-relearn.git</a></p>
<p>Install the Relearn theme by following <a href="https://gohugo.io/hugo-modules/use-modules/#use-a-module-for-a-theme" rel="external" target="_blank">this documentation</a> using Hugo&rsquo;s module system.</p>
<p>This theme&rsquo;s repository is: <a href="https://github.com/McShelby/hugo-theme-relearn.git" rel="external" target="_blank">https://github.com/McShelby/hugo-theme-relearn.git</a></p>
<h3 id="using-git-or-git-submodules">Using Git or Git Submodules</h3>
<p>If you install the theme from your git repository or GitHub, you have several options.</p>
<p>If you use the <code>head</code> of the <code>main</code> branch, you are using the development version. Usually it is fully functional but can break from time to time. We try to fix newly introduced bugs in this version as soon as possible.</p>
<p>Additionally you can checkout one of the tagged versions. These tagged versions correspond to an official <a href="https://github.com/McShelby/hugo-theme-relearn/releases" target="_blank">releases from the GitHub repository</a>.</p>
<p>Additionally you can checkout one of the tagged versions. These tagged versions correspond to an official <a href="https://github.com/McShelby/hugo-theme-relearn/releases" rel="external" target="_blank">releases from the GitHub repository</a>.</p>
<p>Besides the usual version tags (eg <code>1.2.3</code>) there are also tags for the main version (eg. <code>1.2.x</code>), major version (eg. <code>1.x</code>) and the latest (just <code>x</code>) released version making it easier for you to pin the theme to a certain version.</p>
<h2 id="basic-configuration">Basic Configuration</h2>
<p>When building the website, you can set a theme by using <code>--theme</code> option. However, we suggest you modify the configuration file <code>hugo.toml</code> and set the theme as the default.</p>
@ -184,8 +184,8 @@
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-md" data-lang="md"><span class="line"><span class="cl"><span class="gh"># Basics
</span></span></span><span class="line"><span class="cl"><span class="gh"></span>
</span></span><span class="line"><span class="cl">Discover what this Hugo theme is all about and the core concepts behind it.</span></span></code></pre></div><p>renders as</p>
<p><a href="#R-image-e9db4020aa998614e168d6f3be3aa3e2" class="lightbox-link"><img alt="A Chapter" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/installation/chapter.png?width=60pc" style=" height: auto; width: 60pc;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-e9db4020aa998614e168d6f3be3aa3e2"><img alt="A Chapter" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/installation/chapter.png?width=60pc"></a></p>
<p><a href="#R-image-03daf2d1558847d4ade9d0334710d9a2" class="lightbox-link"><img alt="A Chapter" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/installation/chapter.png?width=60pc" style=" height: auto; width: 60pc;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-03daf2d1558847d4ade9d0334710d9a2"><img alt="A Chapter" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/installation/chapter.png?width=60pc"></a></p>
<p>Begin by creating your first chapter page with the following command:</p>
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">hugo new --kind chapter basics/_index.md</span></span></code></pre></div><p>By opening the given file, you should see the property <code>archetype=chapter</code> on top, meaning this page is a <em>chapter</em>.</p>
<p>The <code>weight</code> number will be used to generate the subtitle of the chapter page, set the number to a consecutive value starting at 1 for each new chapter level.</p>
@ -205,7 +205,7 @@
<h2 id="build-the-website">Build the Website</h2>
<p>When your site is ready to deploy, run the following command:</p>
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">hugo</span></span></code></pre></div><p>A <code>public</code> folder will be generated, containing all content and assets for your website. It can now be deployed on any web server.</p>
<p>Now it&rsquo;s time to deploy your page by simply uploading your project to some webserver or by using one of <a href="https://gohugo.io/hosting-and-deployment/" target="_blank">Hugo&rsquo;s many deployment options</a>.</p>
<p>Now it&rsquo;s time to deploy your page by simply uploading your project to some webserver or by using one of <a href="https://gohugo.io/hosting-and-deployment/" rel="external" target="_blank">Hugo&rsquo;s many deployment options</a>.</p>
<footer class="footline">
</footer>
@ -214,8 +214,8 @@
</div>
</main>
</div>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490333" defer></script>
</body>
</html>

96
basics/migration/index.html
View file

@ -23,21 +23,21 @@
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/basics/migration/index.html" rel="alternate" hreflang="art-pir">
<link href="/hugo-theme-relearn/basics/migration/index.xml" rel="alternate" type="application/rss+xml" title="What&#39;s New :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/basics/migration/index.print.html" rel="alternate" type="text/html" title="What&#39;s New :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490231" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490231" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490231"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490231"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490333" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490333" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490333"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490333"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -193,7 +193,7 @@
<p>By that you can now call the dependency mechanism in your own overriden partials by giving it a distinct <code>location</code> parameter. In addition your injected files can now be spread to multiple locations which wasn&rsquo;t previously possible.</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> Additional styling was added for the native HTML elements <code>&lt;mark&gt;</code> and <code>&lt;kbd&gt;</code>. To use them you must allow the <a href="https://gohugo.io/getting-started/configuration-markup/#rendererunsafe" target="_blank">usage of HTML</a> in your <code>hugo.toml</code>. The <a href="/hugo-theme-relearn/cont/markdown/index.html#standard-and-extensions">Markdown documentation</a> was enhanced for this.</p>
<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> Additional styling was added for the native HTML elements <code>&lt;mark&gt;</code> and <code>&lt;kbd&gt;</code>. To use them you must allow the <a href="https://gohugo.io/getting-started/configuration-markup/#rendererunsafe" rel="external" target="_blank">usage of HTML</a> in your <code>hugo.toml</code>. The <a href="/hugo-theme-relearn/cont/markdown/index.html#standard-and-extensions">Markdown documentation</a> was enhanced for this.</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 scroll forward and backward thru all headings of a page by using <kbd>ALT</kbd> <kbd>🡑</kbd> and <kbd>ALT</kbd> <kbd>🡓</kbd>. This also works for the <code>PRINT</code> output format.</p>
@ -212,7 +212,7 @@
<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> It is now possible to <a href="/hugo-theme-relearn/basics/customization/index.html#change-the-main-areas-max-width">adjust the max width of the main area</a>, eg. in case you want to use the full page width for your content.</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> Images and Codefences are now respecting <a href="https://gohugo.io/content-management/markdown-attributes/" target="_blank">Hugo&rsquo;s Markdown attributes</a>.</p>
<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> Images and Codefences are now respecting <a href="https://gohugo.io/content-management/markdown-attributes/" rel="external" target="_blank">Hugo&rsquo;s Markdown attributes</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> The theme has updated its Mermaid dependency to 10.6.0. This adds support for <a href="/hugo-theme-relearn/shortcodes/mermaid/index.html#block-diagram">block diagrams</a>.</p>
@ -230,7 +230,7 @@
<p>Anyways, users are strongly advised to migrate as the <code>attachments</code> shortcode will not receive support anymore. Migration instructions are listed on the <a href="/hugo-theme-relearn/shortcodes/attachments/index.html#migration"><code>attachments</code> shortcode page</a>.</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> If you run Hugo with <a href="https://gohugo.io/methods/page/gitinfo/" target="_blank">GitInfo</a> configured, the default page footer now prints out name, email address and date of the last commit. If you want to turn this off you either have to run Hugo without GitInfo (which is the default) or overwrite the <code>content-footer.html</code> partial.</p>
<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> If you run Hugo with <a href="https://gohugo.io/methods/page/gitinfo/" rel="external" target="_blank">GitInfo</a> configured, the default page footer now prints out name, email address and date of the last commit. If you want to turn this off you either have to run Hugo without GitInfo (which is the default) or overwrite the <code>content-footer.html</code> partial.</p>
</li>
</ul>
<h2 id="5240">5.24.0 (2024-02-28)</h2>
@ -260,7 +260,7 @@
<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/basics/customization/index.html#partials">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" target="_blank"><code>figure</code> shortcode</a>.</p>
<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="_blank"><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>
@ -409,7 +409,7 @@
</div>
</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> Taxonomy <a href="https://gohugo.io/content-management/taxonomies#add-custom-metadata-to-a-taxonomy-or-term" target="_blank">term pages</a> now add the breadcrumb for each listed page. If this gets too crowded for you, you can turn the breadcrumbs off in your <code>hugo.toml</code> by adding <code>disableTermBreadcrumbs=true</code>.</p>
<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> Taxonomy <a href="https://gohugo.io/content-management/taxonomies#add-custom-metadata-to-a-taxonomy-or-term" rel="external" target="_blank">term pages</a> now add the breadcrumb for each listed page. If this gets too crowded for you, you can turn the breadcrumbs off in your <code>hugo.toml</code> by adding <code>disableTermBreadcrumbs=true</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> Taxonomy and term pages are now allowed to contain content. This is added inbetween the title and the page list.</p>
@ -624,7 +624,7 @@
<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> Restored compatibility with Hugo <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.0</span></span> or higher. This does not change the minimum required Hugo version.</p>
<p>The <a href="/hugo-theme-relearn/shortcodes/attachments/index.html"><code>attachments</code> shortcode</a> has compatibility issues with newer Hugo versions. You must switch to leaf bundles or are locked to Hugo &lt; <code>0.112.0</code> for now.</p>
<p>It is <a href="https://github.com/McShelby/hugo-theme-relearn/issues/22" target="_blank">planned to refactor</a> the <code>attchments</code> shortcode in the future. This will make it possible to use the shortcode in branch bundles again but not in simple pages anymore. This will most likely come with a breaking change.</p>
<p>It is <a href="https://github.com/McShelby/hugo-theme-relearn/issues/22" rel="external" target="_blank">planned to refactor</a> the <code>attchments</code> shortcode in the future. This will make it possible to use the shortcode in branch bundles again but not in simple pages anymore. This will most likely come with a breaking change.</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/tabs/index.html"><code>tabs</code> shortcode</a> has changed behavior if you haven&rsquo;t set the <code>groupid</code> parameter.</p>
@ -647,7 +647,7 @@
</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> To give you more flexibility in customizing your article layout a new partial <code>content-header.html</code> is introduced.</p>
<p>This came out of the requirement to customize the position of article tags, which by default are displayed above the title. A second requirement was to also show additional <a href="https://gohugo.io/content-management/taxonomies/" target="_blank">taxonomies</a> not supported by the theme natively. While Hugo supports tags and categories by default, the theme only displays tags.</p>
<p>This came out of the requirement to customize the position of article tags, which by default are displayed above the title. A second requirement was to also show additional <a href="https://gohugo.io/content-management/taxonomies/" rel="external" target="_blank">taxonomies</a> not supported by the theme natively. While Hugo supports tags and categories by default, the theme only displays tags.</p>
<p>So how to adjust the position of tags starting from the theme&rsquo;s default where tags are only shown above the title?</p>
<ol>
<li>Hide tags above title: Overwrite <code>content-header.html</code> with an empty file.</li>
@ -664,7 +664,7 @@
<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 <code>swagger</code> shortcode was deprecated in favor for the <a href="/hugo-theme-relearn/shortcodes/openapi/index.html"><code>openapi</code> shortcode</a>. You don&rsquo;t need to change anything yet as the old name will be used as a fallback. It is planned to remove the <code>swagger</code> shortcode in the next major release.</p>
<p>Additionally, the implemantion of this shortcode was switched from RapiDoc to <a href="https://github.com/swagger-api/swagger-ui" target="_blank">SwaggerUI</a>.</p>
<p>Additionally, the implemantion of this shortcode was switched from RapiDoc to <a href="https://github.com/swagger-api/swagger-ui" rel="external" target="_blank">SwaggerUI</a>.</p>
</li>
</ul>
<hr>
@ -674,16 +674,16 @@
<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> In the effort to comply with WCAG standards, the implementation of the collapsible menu was changed (again). While Internet Explorer 11 has issues in displaying it, the functionality 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> Support for the great <a href="https://github.com/estruyf/vscode-front-matter" target="_blank">VSCode Front Matter extension</a> which provides on-premise CMS capabilties to Hugo.</p>
<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 the great <a href="https://github.com/estruyf/vscode-front-matter" rel="external" target="_blank">VSCode Front Matter extension</a> which provides on-premise CMS capabilties to Hugo.</p>
<p>The theme provides Front Matter snippets for its shortcodes. Currently only English and German is supported. Put a reference into your <code>frontmatter.json</code> like this</p>
<div class="tab-panel" data-tab-group="1f0d4d964c360ca4a6173218673f9cdd">
<div class="tab-panel" data-tab-group="a2defc778d1482763eb7afdfd40c4862">
<div class="tab-nav">
<div class="tab-nav-title">&#8203;</div>
<button
data-tab-item="frontmatterjson"
class="tab-nav-button tab-panel-style cstyle initial active" tabindex="-1"
onclick="switchTab('1f0d4d964c360ca4a6173218673f9cdd','frontmatterjson')"
onclick="switchTab('a2defc778d1482763eb7afdfd40c4862','frontmatterjson')"
>
<span class="tab-nav-text">frontmatter.json</span>
</button>
@ -715,16 +715,16 @@
<h2 id="5110">5.11.0 (2023-02-07)</h2>
<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 theme removed the popular <a href="https://jquery.com" target="_blank">jQuery</a> library from its distribution.</p>
<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 theme removed the popular <a href="https://jquery.com" rel="external" target="_blank">jQuery</a> library from its distribution.</p>
<p>In case you made changes to the theme that are dependend on this library you can place a copy of jQuery into your <code>static/js</code> directory and load it from your own <code>layouts/partials/custom-header.html</code> like this:</p>
<div class="tab-panel" data-tab-group="ac05704bfd7bab1dabfc78369b0a6ec2">
<div class="tab-panel" data-tab-group="6ac23a491f544ba9265c33e574449a7c">
<div class="tab-nav">
<div class="tab-nav-title">&#8203;</div>
<button
data-tab-item="layoutspartialscustom-headerhtml"
class="tab-nav-button tab-panel-style cstyle initial active" tabindex="-1"
onclick="switchTab('ac05704bfd7bab1dabfc78369b0a6ec2','layoutspartialscustom-headerhtml')"
onclick="switchTab('6ac23a491f544ba9265c33e574449a7c','layoutspartialscustom-headerhtml')"
>
<span class="tab-nav-text">layouts/partials/custom-header.html</span>
</button>
@ -750,7 +750,7 @@
<p>This is not supported for Internet Explorer 11, which still displays in the <code>relearn-light</code> variant.</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 JavaScript code for handling image lightboxes (provided by <a href="https://noelboss.github.io/featherlight" target="_blank">Featherlight</a>) was replaced by a CSS-only solution.</p>
<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 JavaScript code for handling image lightboxes (provided by <a href="https://noelboss.github.io/featherlight" rel="external" target="_blank">Featherlight</a>) was replaced by a CSS-only solution.</p>
<p>This also changed the <a href="/hugo-theme-relearn/cont/markdown/index.html#lightbox">lightbox effects</a> parameter from <code>featherlight=false</code> to <code>lightbox=false</code>. Nevertheless you don&rsquo;t need to change anything as the old name will be used as a fallback.</p>
</li>
<li>
@ -760,7 +760,7 @@
<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> Translation into Czech. This language is not supported for search.</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> <a href="https://github.com/McShelby/hugo-theme-relearn/tags" target="_blank">GitHub releases</a> are also now tagged for the main version (eg. <code>1.2.x</code>), major version (eg. <code>1.x</code>) and the latest (just <code>x</code>) release making it easier for you to pin the theme to a certain version.</p>
<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> <a href="https://github.com/McShelby/hugo-theme-relearn/tags" rel="external" target="_blank">GitHub releases</a> are also now tagged for the main version (eg. <code>1.2.x</code>), major version (eg. <code>1.x</code>) and the latest (just <code>x</code>) release making it easier for you to pin the theme to a certain version.</p>
</li>
</ul>
<hr>
@ -780,7 +780,7 @@
<p>To <a href="/hugo-theme-relearn/cont/menushortcuts/index.html#shortcuts-to-pages-inside-of-your-project">get rid</a> of this undesired behavior you have two choices:</p>
<ol>
<li>
<p>Make the page file a <a href="https://gohugo.io/content-management/page-bundles/#headless-bundle" target="_blank">headless branch bundle</a> (contained in its own subdirectory and called <code>_index.md</code>) and add the following frontmatter configuration to the file (see exampleSite&rsquo;s <code>content/showcase/_index.en.md</code>). This causes its content to <strong>not</strong> be ontained in the sitemap.</p>
<p>Make the page file a <a href="https://gohugo.io/content-management/page-bundles/#headless-bundle" rel="external" target="_blank">headless branch bundle</a> (contained in its own subdirectory and called <code>_index.md</code>) and add the following frontmatter configuration to the file (see exampleSite&rsquo;s <code>content/showcase/_index.en.md</code>). This causes its content to <strong>not</strong> be ontained in the sitemap.</p>
<div class="tab-panel" data-tab-group="config-code">
<div class="tab-nav">
@ -990,7 +990,7 @@
<p>You can revert back to the old behavior by defining <code>externalLinkTarget=&quot;_self&quot;</code> in the <code>params</code> section of your <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> The theme now supports <a href="https://gohugo.io/hugo-modules/" target="_blank">Hugo&rsquo;s module system</a>.</p>
<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 theme now supports <a href="https://gohugo.io/hugo-modules/" rel="external" target="_blank">Hugo&rsquo;s module system</a>.</p>
</li>
</ul>
<hr>
@ -1311,7 +1311,7 @@
<hr>
<h2 id="310">3.1.0 (2022-03-15)</h2>
<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> <a href="/hugo-theme-relearn/shortcodes/attachments/index.html"><code>attachment</code></a> and <a href="/hugo-theme-relearn/shortcodes/notice/index.html"><code>notice</code></a> shortcodes have a new parameter to override the default icon. Allowed values are all <a href="https://fontawesome.com/v5/search?m=free" target="_blank">Font Awesome 5 Free</a> icons.</li>
<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> <a href="/hugo-theme-relearn/shortcodes/attachments/index.html"><code>attachment</code></a> and <a href="/hugo-theme-relearn/shortcodes/notice/index.html"><code>notice</code></a> shortcodes have a new parameter to override the default icon. Allowed values are all <a href="https://fontawesome.com/v5/search?m=free" rel="external" target="_blank">Font Awesome 5 Free</a> icons.</li>
</ul>
<hr>
<h2 id="300">3.0.0 (2022-02-22)</h2>
@ -1376,8 +1376,8 @@
</tr>
</tbody>
</table>
<p>If you&rsquo;ve linked from a page of one language to a page of another language, conversion is a bit more difficult but <a href="https://gohugo.io/content-management/cross-references/#link-to-another-language-version" target="_blank">Hugo got you covered</a> as well.</p>
<p>Also, the old themes implementation allowed refs to non-existing content. This will cause Hugos implementation to show the error below and abort the generation. If your project relies on this old behavior, you can <a href="https://gohugo.io/content-management/cross-references/#link-to-another-language-version" target="_blank">reconfigure the error handling</a> of Hugos implementation.</p>
<p>If you&rsquo;ve linked from a page of one language to a page of another language, conversion is a bit more difficult but <a href="https://gohugo.io/content-management/cross-references/#link-to-another-language-version" rel="external" target="_blank">Hugo got you covered</a> as well.</p>
<p>Also, the old themes implementation allowed refs to non-existing content. This will cause Hugos implementation to show the error below and abort the generation. If your project relies on this old behavior, you can <a href="https://gohugo.io/content-management/cross-references/#link-to-another-language-version" rel="external" target="_blank">reconfigure the error handling</a> of Hugos implementation.</p>
<p>In the best case your usage of the old implementation is already standard compliant and you don&rsquo;t need to change anything. You&rsquo;ll notice this very easily once you&rsquo;ve started <code>hugo server</code> after an upgrade and no errors are written to the console.</p>
<p>You may see errors on the console after the update in the form:</p>
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">ERROR 2021/11/19 22:29:10 <span class="o">[</span>en<span class="o">]</span> REF_NOT_FOUND: Ref <span class="s2">&#34;basics/configuration/_index.md&#34;</span>: <span class="s2">&#34;hugo-theme-relearn\exampleSite\content\_index.en.md:19:22&#34;</span>: page not found</span></span></code></pre></div><p>In this case, you must apply one of two options:</p>
@ -1435,7 +1435,7 @@
<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 frontmatter <code>ordersectionsby</code> option to change immediate children sorting in menu and <code>children</code> shortcode. Possible values are <code>title</code> or <code>weight</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> Alternate content of a page is now advertised in the HTML meta tags. See <a href="https://gohugo.io/templates/rss/#reference-your-rss-feed-in-head" target="_blank">Hugo documentation</a>.</p>
<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> Alternate content of a page is now advertised in the HTML meta tags. See <a href="https://gohugo.io/templates/rss/#reference-your-rss-feed-in-head" rel="external" target="_blank">Hugo documentation</a>.</p>
</li>
</ul>
<hr>
@ -1476,7 +1476,7 @@
<h2 id="200">2.0.0 (2021-08-28)</h2>
<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> Syntax highlighting was switched to the <a href="https://gohugo.io/content-management/syntax-highlighting/" target="_blank">built in Hugo mechanism</a>. You may need to configure a new stylesheet or decide to roll you own as described on in the Hugo documentation</p>
<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> Syntax highlighting was switched to the <a href="https://gohugo.io/content-management/syntax-highlighting/" rel="external" target="_blank">built in Hugo mechanism</a>. You may need to configure a new stylesheet or decide to roll you own as described on in the Hugo documentation</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> In the predefined stylesheets there was a typo and <code>--MENU-HOME-LINK-HOVERED-color</code> must be changed to <code>--MENU-HOME-LINK-HOVER-color</code>. You don&rsquo;t need to change anything in your custom color stylesheet as the old name will be used as a fallback.</p>
@ -1528,7 +1528,7 @@
<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.65.0</span></span> The requirement for the Hugo version of this theme is the same as for the Learn theme version 2.5.0 on 2021-07-01.</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> Initial fork of the <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn theme</a> based on Learn 2.5.0 on 2021-07-01. This introduces no new features besides a global rename to <code>Relearn</code> and a new logo. For the reasons behind forking the Learn theme, see <a href="https://github.com/matcornic/hugo-theme-learn/issues/442#issuecomment-907863495" target="_blank">this comment</a> in the Learn issues.</p>
<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> Initial fork of the <a href="https://github.com/matcornic/hugo-theme-learn" rel="external" target="_blank">Learn theme</a> based on Learn 2.5.0 on 2021-07-01. This introduces no new features besides a global rename to <code>Relearn</code> and a new logo. For the reasons behind forking the Learn theme, see <a href="https://github.com/matcornic/hugo-theme-learn/issues/442#issuecomment-907863495" rel="external" target="_blank">this comment</a> in the Learn issues.</p>
</li>
</ul>
@ -1623,12 +1623,12 @@
<script>
var contentLangs=['en'];
</script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490333" defer></script>
</div>
<div id="R-homelinks" class="default-animation">
<hr class="padding">
@ -1791,13 +1791,13 @@
setTimeout( githubButtonsInit, 400 );
});
</script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490231"></script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490333"></script>
</div>
</div>
</div>
</aside>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490333" defer></script>
</body>
</html>

84
basics/migration/index.print.html
View file

@ -23,22 +23,22 @@
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/basics/migration/index.html" rel="alternate" hreflang="art-pir">
<link href="https://mcshelby.github.io/hugo-theme-relearn/basics/migration/index.html" rel="canonical" type="text/html" title="What&#39;s New :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/basics/migration/index.xml" rel="alternate" type="application/rss+xml" title="What&#39;s New :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490232" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490232" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490232"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490232"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490333" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490333" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490333"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490333"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -119,7 +119,7 @@
<p>By that you can now call the dependency mechanism in your own overriden partials by giving it a distinct <code>location</code> parameter. In addition your injected files can now be spread to multiple locations which wasn&rsquo;t previously possible.</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> Additional styling was added for the native HTML elements <code>&lt;mark&gt;</code> and <code>&lt;kbd&gt;</code>. To use them you must allow the <a href="https://gohugo.io/getting-started/configuration-markup/#rendererunsafe" target="_blank">usage of HTML</a> in your <code>hugo.toml</code>. The <a href="/hugo-theme-relearn/cont/markdown/index.html#standard-and-extensions">Markdown documentation</a> was enhanced for this.</p>
<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> Additional styling was added for the native HTML elements <code>&lt;mark&gt;</code> and <code>&lt;kbd&gt;</code>. To use them you must allow the <a href="https://gohugo.io/getting-started/configuration-markup/#rendererunsafe" rel="external" target="_blank">usage of HTML</a> in your <code>hugo.toml</code>. The <a href="/hugo-theme-relearn/cont/markdown/index.html#standard-and-extensions">Markdown documentation</a> was enhanced for this.</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 scroll forward and backward thru all headings of a page by using <kbd>ALT</kbd> <kbd>🡑</kbd> and <kbd>ALT</kbd> <kbd>🡓</kbd>. This also works for the <code>PRINT</code> output format.</p>
@ -138,7 +138,7 @@
<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> It is now possible to <a href="/hugo-theme-relearn/basics/customization/index.html#change-the-main-areas-max-width">adjust the max width of the main area</a>, eg. in case you want to use the full page width for your content.</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> Images and Codefences are now respecting <a href="https://gohugo.io/content-management/markdown-attributes/" target="_blank">Hugo&rsquo;s Markdown attributes</a>.</p>
<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> Images and Codefences are now respecting <a href="https://gohugo.io/content-management/markdown-attributes/" rel="external" target="_blank">Hugo&rsquo;s Markdown attributes</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> The theme has updated its Mermaid dependency to 10.6.0. This adds support for <a href="/hugo-theme-relearn/shortcodes/mermaid/index.html#block-diagram">block diagrams</a>.</p>
@ -156,7 +156,7 @@
<p>Anyways, users are strongly advised to migrate as the <code>attachments</code> shortcode will not receive support anymore. Migration instructions are listed on the <a href="/hugo-theme-relearn/shortcodes/attachments/index.html#migration"><code>attachments</code> shortcode page</a>.</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> If you run Hugo with <a href="https://gohugo.io/methods/page/gitinfo/" target="_blank">GitInfo</a> configured, the default page footer now prints out name, email address and date of the last commit. If you want to turn this off you either have to run Hugo without GitInfo (which is the default) or overwrite the <code>content-footer.html</code> partial.</p>
<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> If you run Hugo with <a href="https://gohugo.io/methods/page/gitinfo/" rel="external" target="_blank">GitInfo</a> configured, the default page footer now prints out name, email address and date of the last commit. If you want to turn this off you either have to run Hugo without GitInfo (which is the default) or overwrite the <code>content-footer.html</code> partial.</p>
</li>
</ul>
<h2 id="5240">5.24.0 (2024-02-28)</h2>
@ -186,7 +186,7 @@
<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/basics/customization/index.html#partials">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" target="_blank"><code>figure</code> shortcode</a>.</p>
<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="_blank"><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>
@ -335,7 +335,7 @@
</div>
</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> Taxonomy <a href="https://gohugo.io/content-management/taxonomies#add-custom-metadata-to-a-taxonomy-or-term" target="_blank">term pages</a> now add the breadcrumb for each listed page. If this gets too crowded for you, you can turn the breadcrumbs off in your <code>hugo.toml</code> by adding <code>disableTermBreadcrumbs=true</code>.</p>
<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> Taxonomy <a href="https://gohugo.io/content-management/taxonomies#add-custom-metadata-to-a-taxonomy-or-term" rel="external" target="_blank">term pages</a> now add the breadcrumb for each listed page. If this gets too crowded for you, you can turn the breadcrumbs off in your <code>hugo.toml</code> by adding <code>disableTermBreadcrumbs=true</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> Taxonomy and term pages are now allowed to contain content. This is added inbetween the title and the page list.</p>
@ -550,7 +550,7 @@
<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> Restored compatibility with Hugo <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.0</span></span> or higher. This does not change the minimum required Hugo version.</p>
<p>The <a href="/hugo-theme-relearn/shortcodes/attachments/index.html"><code>attachments</code> shortcode</a> has compatibility issues with newer Hugo versions. You must switch to leaf bundles or are locked to Hugo &lt; <code>0.112.0</code> for now.</p>
<p>It is <a href="https://github.com/McShelby/hugo-theme-relearn/issues/22" target="_blank">planned to refactor</a> the <code>attchments</code> shortcode in the future. This will make it possible to use the shortcode in branch bundles again but not in simple pages anymore. This will most likely come with a breaking change.</p>
<p>It is <a href="https://github.com/McShelby/hugo-theme-relearn/issues/22" rel="external" target="_blank">planned to refactor</a> the <code>attchments</code> shortcode in the future. This will make it possible to use the shortcode in branch bundles again but not in simple pages anymore. This will most likely come with a breaking change.</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/tabs/index.html"><code>tabs</code> shortcode</a> has changed behavior if you haven&rsquo;t set the <code>groupid</code> parameter.</p>
@ -573,7 +573,7 @@
</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> To give you more flexibility in customizing your article layout a new partial <code>content-header.html</code> is introduced.</p>
<p>This came out of the requirement to customize the position of article tags, which by default are displayed above the title. A second requirement was to also show additional <a href="https://gohugo.io/content-management/taxonomies/" target="_blank">taxonomies</a> not supported by the theme natively. While Hugo supports tags and categories by default, the theme only displays tags.</p>
<p>This came out of the requirement to customize the position of article tags, which by default are displayed above the title. A second requirement was to also show additional <a href="https://gohugo.io/content-management/taxonomies/" rel="external" target="_blank">taxonomies</a> not supported by the theme natively. While Hugo supports tags and categories by default, the theme only displays tags.</p>
<p>So how to adjust the position of tags starting from the theme&rsquo;s default where tags are only shown above the title?</p>
<ol>
<li>Hide tags above title: Overwrite <code>content-header.html</code> with an empty file.</li>
@ -590,7 +590,7 @@
<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 <code>swagger</code> shortcode was deprecated in favor for the <a href="/hugo-theme-relearn/shortcodes/openapi/index.html"><code>openapi</code> shortcode</a>. You don&rsquo;t need to change anything yet as the old name will be used as a fallback. It is planned to remove the <code>swagger</code> shortcode in the next major release.</p>
<p>Additionally, the implemantion of this shortcode was switched from RapiDoc to <a href="https://github.com/swagger-api/swagger-ui" target="_blank">SwaggerUI</a>.</p>
<p>Additionally, the implemantion of this shortcode was switched from RapiDoc to <a href="https://github.com/swagger-api/swagger-ui" rel="external" target="_blank">SwaggerUI</a>.</p>
</li>
</ul>
<hr>
@ -600,16 +600,16 @@
<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> In the effort to comply with WCAG standards, the implementation of the collapsible menu was changed (again). While Internet Explorer 11 has issues in displaying it, the functionality 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> Support for the great <a href="https://github.com/estruyf/vscode-front-matter" target="_blank">VSCode Front Matter extension</a> which provides on-premise CMS capabilties to Hugo.</p>
<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 the great <a href="https://github.com/estruyf/vscode-front-matter" rel="external" target="_blank">VSCode Front Matter extension</a> which provides on-premise CMS capabilties to Hugo.</p>
<p>The theme provides Front Matter snippets for its shortcodes. Currently only English and German is supported. Put a reference into your <code>frontmatter.json</code> like this</p>
<div class="tab-panel" data-tab-group="1f0d4d964c360ca4a6173218673f9cdd">
<div class="tab-panel" data-tab-group="a2defc778d1482763eb7afdfd40c4862">
<div class="tab-nav">
<div class="tab-nav-title">&#8203;</div>
<button
data-tab-item="frontmatterjson"
class="tab-nav-button tab-panel-style cstyle initial active" tabindex="-1"
onclick="switchTab('1f0d4d964c360ca4a6173218673f9cdd','frontmatterjson')"
onclick="switchTab('a2defc778d1482763eb7afdfd40c4862','frontmatterjson')"
>
<span class="tab-nav-text">frontmatter.json</span>
</button>
@ -641,16 +641,16 @@
<h2 id="5110">5.11.0 (2023-02-07)</h2>
<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 theme removed the popular <a href="https://jquery.com" target="_blank">jQuery</a> library from its distribution.</p>
<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 theme removed the popular <a href="https://jquery.com" rel="external" target="_blank">jQuery</a> library from its distribution.</p>
<p>In case you made changes to the theme that are dependend on this library you can place a copy of jQuery into your <code>static/js</code> directory and load it from your own <code>layouts/partials/custom-header.html</code> like this:</p>
<div class="tab-panel" data-tab-group="ac05704bfd7bab1dabfc78369b0a6ec2">
<div class="tab-panel" data-tab-group="6ac23a491f544ba9265c33e574449a7c">
<div class="tab-nav">
<div class="tab-nav-title">&#8203;</div>
<button
data-tab-item="layoutspartialscustom-headerhtml"
class="tab-nav-button tab-panel-style cstyle initial active" tabindex="-1"
onclick="switchTab('ac05704bfd7bab1dabfc78369b0a6ec2','layoutspartialscustom-headerhtml')"
onclick="switchTab('6ac23a491f544ba9265c33e574449a7c','layoutspartialscustom-headerhtml')"
>
<span class="tab-nav-text">layouts/partials/custom-header.html</span>
</button>
@ -676,7 +676,7 @@
<p>This is not supported for Internet Explorer 11, which still displays in the <code>relearn-light</code> variant.</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 JavaScript code for handling image lightboxes (provided by <a href="https://noelboss.github.io/featherlight" target="_blank">Featherlight</a>) was replaced by a CSS-only solution.</p>
<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 JavaScript code for handling image lightboxes (provided by <a href="https://noelboss.github.io/featherlight" rel="external" target="_blank">Featherlight</a>) was replaced by a CSS-only solution.</p>
<p>This also changed the <a href="/hugo-theme-relearn/cont/markdown/index.html#lightbox">lightbox effects</a> parameter from <code>featherlight=false</code> to <code>lightbox=false</code>. Nevertheless you don&rsquo;t need to change anything as the old name will be used as a fallback.</p>
</li>
<li>
@ -686,7 +686,7 @@
<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> Translation into Czech. This language is not supported for search.</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> <a href="https://github.com/McShelby/hugo-theme-relearn/tags" target="_blank">GitHub releases</a> are also now tagged for the main version (eg. <code>1.2.x</code>), major version (eg. <code>1.x</code>) and the latest (just <code>x</code>) release making it easier for you to pin the theme to a certain version.</p>
<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> <a href="https://github.com/McShelby/hugo-theme-relearn/tags" rel="external" target="_blank">GitHub releases</a> are also now tagged for the main version (eg. <code>1.2.x</code>), major version (eg. <code>1.x</code>) and the latest (just <code>x</code>) release making it easier for you to pin the theme to a certain version.</p>
</li>
</ul>
<hr>
@ -706,7 +706,7 @@
<p>To <a href="/hugo-theme-relearn/cont/menushortcuts/index.html#shortcuts-to-pages-inside-of-your-project">get rid</a> of this undesired behavior you have two choices:</p>
<ol>
<li>
<p>Make the page file a <a href="https://gohugo.io/content-management/page-bundles/#headless-bundle" target="_blank">headless branch bundle</a> (contained in its own subdirectory and called <code>_index.md</code>) and add the following frontmatter configuration to the file (see exampleSite&rsquo;s <code>content/showcase/_index.en.md</code>). This causes its content to <strong>not</strong> be ontained in the sitemap.</p>
<p>Make the page file a <a href="https://gohugo.io/content-management/page-bundles/#headless-bundle" rel="external" target="_blank">headless branch bundle</a> (contained in its own subdirectory and called <code>_index.md</code>) and add the following frontmatter configuration to the file (see exampleSite&rsquo;s <code>content/showcase/_index.en.md</code>). This causes its content to <strong>not</strong> be ontained in the sitemap.</p>
<div class="tab-panel" data-tab-group="config-code">
<div class="tab-nav">
@ -916,7 +916,7 @@
<p>You can revert back to the old behavior by defining <code>externalLinkTarget=&quot;_self&quot;</code> in the <code>params</code> section of your <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> The theme now supports <a href="https://gohugo.io/hugo-modules/" target="_blank">Hugo&rsquo;s module system</a>.</p>
<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 theme now supports <a href="https://gohugo.io/hugo-modules/" rel="external" target="_blank">Hugo&rsquo;s module system</a>.</p>
</li>
</ul>
<hr>
@ -1237,7 +1237,7 @@
<hr>
<h2 id="310">3.1.0 (2022-03-15)</h2>
<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> <a href="/hugo-theme-relearn/shortcodes/attachments/index.html"><code>attachment</code></a> and <a href="/hugo-theme-relearn/shortcodes/notice/index.html"><code>notice</code></a> shortcodes have a new parameter to override the default icon. Allowed values are all <a href="https://fontawesome.com/v5/search?m=free" target="_blank">Font Awesome 5 Free</a> icons.</li>
<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> <a href="/hugo-theme-relearn/shortcodes/attachments/index.html"><code>attachment</code></a> and <a href="/hugo-theme-relearn/shortcodes/notice/index.html"><code>notice</code></a> shortcodes have a new parameter to override the default icon. Allowed values are all <a href="https://fontawesome.com/v5/search?m=free" rel="external" target="_blank">Font Awesome 5 Free</a> icons.</li>
</ul>
<hr>
<h2 id="300">3.0.0 (2022-02-22)</h2>
@ -1302,8 +1302,8 @@
</tr>
</tbody>
</table>
<p>If you&rsquo;ve linked from a page of one language to a page of another language, conversion is a bit more difficult but <a href="https://gohugo.io/content-management/cross-references/#link-to-another-language-version" target="_blank">Hugo got you covered</a> as well.</p>
<p>Also, the old themes implementation allowed refs to non-existing content. This will cause Hugos implementation to show the error below and abort the generation. If your project relies on this old behavior, you can <a href="https://gohugo.io/content-management/cross-references/#link-to-another-language-version" target="_blank">reconfigure the error handling</a> of Hugos implementation.</p>
<p>If you&rsquo;ve linked from a page of one language to a page of another language, conversion is a bit more difficult but <a href="https://gohugo.io/content-management/cross-references/#link-to-another-language-version" rel="external" target="_blank">Hugo got you covered</a> as well.</p>
<p>Also, the old themes implementation allowed refs to non-existing content. This will cause Hugos implementation to show the error below and abort the generation. If your project relies on this old behavior, you can <a href="https://gohugo.io/content-management/cross-references/#link-to-another-language-version" rel="external" target="_blank">reconfigure the error handling</a> of Hugos implementation.</p>
<p>In the best case your usage of the old implementation is already standard compliant and you don&rsquo;t need to change anything. You&rsquo;ll notice this very easily once you&rsquo;ve started <code>hugo server</code> after an upgrade and no errors are written to the console.</p>
<p>You may see errors on the console after the update in the form:</p>
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-shell" data-lang="shell"><span class="line"><span class="cl">ERROR 2021/11/19 22:29:10 <span class="o">[</span>en<span class="o">]</span> REF_NOT_FOUND: Ref <span class="s2">&#34;basics/configuration/_index.md&#34;</span>: <span class="s2">&#34;hugo-theme-relearn\exampleSite\content\_index.en.md:19:22&#34;</span>: page not found</span></span></code></pre></div><p>In this case, you must apply one of two options:</p>
@ -1361,7 +1361,7 @@
<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 frontmatter <code>ordersectionsby</code> option to change immediate children sorting in menu and <code>children</code> shortcode. Possible values are <code>title</code> or <code>weight</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> Alternate content of a page is now advertised in the HTML meta tags. See <a href="https://gohugo.io/templates/rss/#reference-your-rss-feed-in-head" target="_blank">Hugo documentation</a>.</p>
<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> Alternate content of a page is now advertised in the HTML meta tags. See <a href="https://gohugo.io/templates/rss/#reference-your-rss-feed-in-head" rel="external" target="_blank">Hugo documentation</a>.</p>
</li>
</ul>
<hr>
@ -1402,7 +1402,7 @@
<h2 id="200">2.0.0 (2021-08-28)</h2>
<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> Syntax highlighting was switched to the <a href="https://gohugo.io/content-management/syntax-highlighting/" target="_blank">built in Hugo mechanism</a>. You may need to configure a new stylesheet or decide to roll you own as described on in the Hugo documentation</p>
<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> Syntax highlighting was switched to the <a href="https://gohugo.io/content-management/syntax-highlighting/" rel="external" target="_blank">built in Hugo mechanism</a>. You may need to configure a new stylesheet or decide to roll you own as described on in the Hugo documentation</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> In the predefined stylesheets there was a typo and <code>--MENU-HOME-LINK-HOVERED-color</code> must be changed to <code>--MENU-HOME-LINK-HOVER-color</code>. You don&rsquo;t need to change anything in your custom color stylesheet as the old name will be used as a fallback.</p>
@ -1454,7 +1454,7 @@
<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.65.0</span></span> The requirement for the Hugo version of this theme is the same as for the Learn theme version 2.5.0 on 2021-07-01.</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> Initial fork of the <a href="https://github.com/matcornic/hugo-theme-learn" target="_blank">Learn theme</a> based on Learn 2.5.0 on 2021-07-01. This introduces no new features besides a global rename to <code>Relearn</code> and a new logo. For the reasons behind forking the Learn theme, see <a href="https://github.com/matcornic/hugo-theme-learn/issues/442#issuecomment-907863495" target="_blank">this comment</a> in the Learn issues.</p>
<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> Initial fork of the <a href="https://github.com/matcornic/hugo-theme-learn" rel="external" target="_blank">Learn theme</a> based on Learn 2.5.0 on 2021-07-01. This introduces no new features besides a global rename to <code>Relearn</code> and a new logo. For the reasons behind forking the Learn theme, see <a href="https://github.com/matcornic/hugo-theme-learn/issues/442#issuecomment-907863495" rel="external" target="_blank">this comment</a> in the Learn issues.</p>
</li>
</ul>
@ -1465,8 +1465,8 @@
</div>
</main>
</div>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490333" defer></script>
</body>
</html>

50
basics/requirements/index.html
View file

@ -23,21 +23,21 @@
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/basics/requirements/index.html" rel="alternate" hreflang="art-pir">
<link href="/hugo-theme-relearn/basics/requirements/index.xml" rel="alternate" type="application/rss+xml" title="Requirements :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/basics/requirements/index.print.html" rel="alternate" type="text/html" title="Requirements :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490231" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490231" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490231"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490231"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490333" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490333" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490333"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490333"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -106,7 +106,7 @@
<h1 id="requirements">Requirements</h1>
<p>Thanks to the simplicity of Hugo, this page is as empty as this theme needs requirements.</p>
<p>Just download at least version <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> of the <a href="https://gohugo.io/getting-started/installing/" target="_blank">Hugo binary</a> for your OS (Windows, Linux, Mac).</p>
<p>Just download at least version <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> of the <a href="https://gohugo.io/getting-started/installing/" rel="external" target="_blank">Hugo binary</a> for your OS (Windows, Linux, Mac).</p>
<figure><a href="https://gohugo.io"><img src="/hugo-theme-relearn/basics/requirements/magic.gif"
alt="Magic"></a><figcaption>
<p>It&rsquo;s a kind of magic</p>
@ -210,12 +210,12 @@
<script>
var contentLangs=['en'];
</script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490333" defer></script>
</div>
<div id="R-homelinks" class="default-animation">
<hr class="padding">
@ -378,13 +378,13 @@
setTimeout( githubButtonsInit, 400 );
});
</script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490231"></script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490333"></script>
</div>
</div>
</div>
</aside>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490333" defer></script>
</body>
</html>

38
basics/requirements/index.print.html
View file

@ -23,22 +23,22 @@
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/basics/requirements/index.html" rel="alternate" hreflang="art-pir">
<link href="https://mcshelby.github.io/hugo-theme-relearn/basics/requirements/index.html" rel="canonical" type="text/html" title="Requirements :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/basics/requirements/index.xml" rel="alternate" type="application/rss+xml" title="Requirements :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490232" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490232" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490232"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490232"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490333" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490333" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490333"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490333"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -91,7 +91,7 @@
<h1 id="requirements">Requirements</h1>
<p>Thanks to the simplicity of Hugo, this page is as empty as this theme needs requirements.</p>
<p>Just download at least version <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> of the <a href="https://gohugo.io/getting-started/installing/" target="_blank">Hugo binary</a> for your OS (Windows, Linux, Mac).</p>
<p>Just download at least version <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> of the <a href="https://gohugo.io/getting-started/installing/" rel="external" target="_blank">Hugo binary</a> for your OS (Windows, Linux, Mac).</p>
<figure><a href="https://gohugo.io"><img src="/hugo-theme-relearn/basics/requirements/magic.gif"
alt="Magic"></a><figcaption>
<p>It&rsquo;s a kind of magic</p>
@ -111,8 +111,8 @@
</div>
</main>
</div>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490333" defer></script>
</body>
</html>

94
basics/topbar/index.html
View file

@ -23,21 +23,21 @@
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/basics/topbar/index.html" rel="alternate" hreflang="art-pir">
<link href="/hugo-theme-relearn/basics/topbar/index.xml" rel="alternate" type="application/rss+xml" title="Topbar Modification :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/basics/topbar/index.print.html" rel="alternate" type="text/html" title="Topbar Modification :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490231" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490231" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490231" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490231" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490231" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490231"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490231"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490333" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/ie.css?1712490333" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490333"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490333"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -133,8 +133,8 @@
<h1 id="topbar-modification">Topbar Modification</h1>
<p>The theme comes with a reasonably configured topbar.</p>
<p><a href="#R-image-65f11a70813f9a5727855f37d56d4b8f" class="lightbox-link"><img alt="Topbar on mobile devices" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/topbar/topbar-closed.png" style=" height: auto; width: auto;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-65f11a70813f9a5727855f37d56d4b8f"><img alt="Topbar on mobile devices" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/topbar/topbar-closed.png"></a></p>
<p><a href="#R-image-00745bc708eb0c34ad28a55603fd76f1" class="lightbox-link"><img alt="Topbar on mobile devices" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/topbar/topbar-closed.png" style=" height: auto; width: auto;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-00745bc708eb0c34ad28a55603fd76f1"><img alt="Topbar on mobile devices" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/topbar/topbar-closed.png"></a></p>
<p>Nevertheless, your requirements may differ from this configuration. Luckily the theme got you covered as the themebar, its buttons and the functionality behind these buttons is fully configurable by you.</p>
<div class="box notices cstyle tip">
@ -146,29 +146,29 @@
</div>
<h2 id="areas">Areas</h2>
<p>The default configuration comes with three predefined areas that may contain an arbitrary set of buttons.</p>
<p><a href="#R-image-e531b3d029f9e8bac27c6cb8f76f77fb" class="lightbox-link"><img alt="Topbar with default areas marked" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/topbar/topbar-areas.png" style=" height: auto; width: auto;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-e531b3d029f9e8bac27c6cb8f76f77fb"><img alt="Topbar with default areas marked" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/topbar/topbar-areas.png"></a></p>
<p><a href="#R-image-212beb771e81d2959870a40962ef6c0a" class="lightbox-link"><img alt="Topbar with default areas marked" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/topbar/topbar-areas.png" style=" height: auto; width: auto;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-212beb771e81d2959870a40962ef6c0a"><img alt="Topbar with default areas marked" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/topbar/topbar-areas.png"></a></p>
<ul>
<li><a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/start.html" target="_blank"><strong>start</strong></a>: shown between menu and breadcrumb</li>
<li><a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/end.html" target="_blank"><strong>end</strong></a>: shown on the opposite breadcrumb side in comparison to the <em>start</em> area</li>
<li><a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/more.html" target="_blank"><strong>more</strong></a>: shown when pressing the <span class="btn cstyle transparent"><span><i class="fa-fw fas fa-ellipsis-v"></i></span></span> <em>more</em> button in the topbar</li>
<li><a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/start.html" rel="external" target="_blank"><strong>start</strong></a>: shown between menu and breadcrumb</li>
<li><a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/end.html" rel="external" target="_blank"><strong>end</strong></a>: shown on the opposite breadcrumb side in comparison to the <em>start</em> area</li>
<li><a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/more.html" rel="external" target="_blank"><strong>more</strong></a>: shown when pressing the <span class="btn cstyle transparent"><span><i class="fa-fw fas fa-ellipsis-v"></i></span></span> <em>more</em> button in the topbar</li>
</ul>
<p>While you can not add additional areas in the topbar, you are free to configure addtional buttons that behave like the <em>more</em> button, providing further user defined areas.</p>
<h2 id="buttons">Buttons</h2>
<p>The theme ships with the following predefined buttons (from left to right in the screenshot)</p>
<ul>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-bars"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/sidebar.html" target="_blank"><strong>sidebar</strong></a>: opens the sidebar flyout if in mobile layout</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-list-alt"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/toc.html" target="_blank"><strong>toc</strong></a>: opens the table of contents in an overlay</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-pen"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/edit.html" target="_blank"><strong>edit</strong></a>: browses to the editable page if the <code>editURL</code> <a href="/hugo-theme-relearn/basics/configuration/index.html">parameter is set</a></li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-print"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/print.html" target="_blank"><strong>print</strong></a>: browses to the chapters printable page if <a href="/hugo-theme-relearn/basics/customization/index.html#activate-print-support">print support</a> was activated</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-chevron-left"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/prev.html" target="_blank"><strong>prev</strong></a>: browses to the previous page if there is one</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-chevron-right"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/next.html" target="_blank"><strong>next</strong></a>: browses to the next page if there is one</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-ellipsis-v"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/more.html" target="_blank"><strong>more</strong></a>: opens the overlay for the <em>more</em> area</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-bars"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/sidebar.html" rel="external" target="_blank"><strong>sidebar</strong></a>: opens the sidebar flyout if in mobile layout</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-list-alt"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/toc.html" rel="external" target="_blank"><strong>toc</strong></a>: opens the table of contents in an overlay</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-pen"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/edit.html" rel="external" target="_blank"><strong>edit</strong></a>: browses to the editable page if the <code>editURL</code> <a href="/hugo-theme-relearn/basics/configuration/index.html">parameter is set</a></li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-print"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/print.html" rel="external" target="_blank"><strong>print</strong></a>: browses to the chapters printable page if <a href="/hugo-theme-relearn/basics/customization/index.html#activate-print-support">print support</a> was activated</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-chevron-left"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/prev.html" rel="external" target="_blank"><strong>prev</strong></a>: browses to the previous page if there is one</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-chevron-right"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/next.html" rel="external" target="_blank"><strong>next</strong></a>: browses to the next page if there is one</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-ellipsis-v"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/more.html" rel="external" target="_blank"><strong>more</strong></a>: opens the overlay for the <em>more</em> area</li>
</ul>
<p>Not all buttons are displayed at every given time. This is configurable (see below if interested).</p>
<h2 id="redefining-areas">Redefining Areas</h2>
<p>Each predefined area and button comes in their own file. By that it is easy for you to overwrite an area file in your installation reusing only the buttons you like.</p>
<p>Eg. you can redefine the predefined <em>end</em> area by adding the file <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/end.html" target="_blank"><code>layouts/partials/topbar/area/end.html</code></a> in your installation (not in the theme itself) to remove all but the <em>more</em> button.</p>
<p>Eg. you can redefine the predefined <em>end</em> area by adding the file <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/end.html" rel="external" target="_blank"><code>layouts/partials/topbar/area/end.html</code></a> in your installation (not in the theme itself) to remove all but the <em>more</em> button.</p>
<p>The below example sets an explicit value for the <code>onempty</code> parameter, overriding the specific default value for this button (these defaults vary depending on the button). The parameter causes the <em>more</em> button to always be displayed instead of hiding once its content is empty.</p>
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go"><span class="line"><span class="cl"><span class="p">{{</span> <span class="nx">partial</span> <span class="s">&#34;topbar/button/more.html&#34;</span> <span class="p">(</span><span class="nx">dict</span>
</span></span><span class="line"><span class="cl"> <span class="s">&#34;page&#34;</span> <span class="p">.</span>
@ -196,8 +196,8 @@
</ul>
<h4 id="hiding-and-disabling-stuff">Hiding and Disabling Stuff</h4>
<p>While hiding a button dependend on the screen size can be configured with the above described <em>hide</em> action, you may want to hide the button on certain other conditions aswell.</p>
<p>For example, the <em>print</em> button in its default configuration should only be displayed if print support was configured. This is done in your button template by checking the conditions first before displaying the button (see <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/print.html" target="_blank"><code>layouts/partials/topbar/button/print.html</code></a>).</p>
<p>Another prefered condition for hiding a button is, if the displayed overlay is empty. This is the case for the <em>toc</em> (see <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/toc.html" target="_blank"><code>layouts/partials/topbar/button/toc.html</code></a>) aswell as the <em>more</em> button (see <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/more.html" target="_blank"><code>layouts/partials/topbar/button/more.html</code></a>) and controlled by the parameter <code>onempty</code>.</p>
<p>For example, the <em>print</em> button in its default configuration should only be displayed if print support was configured. This is done in your button template by checking the conditions first before displaying the button (see <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/print.html" rel="external" target="_blank"><code>layouts/partials/topbar/button/print.html</code></a>).</p>
<p>Another prefered condition for hiding a button is, if the displayed overlay is empty. This is the case for the <em>toc</em> (see <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/toc.html" rel="external" target="_blank"><code>layouts/partials/topbar/button/toc.html</code></a>) aswell as the <em>more</em> button (see <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/more.html" rel="external" target="_blank"><code>layouts/partials/topbar/button/more.html</code></a>) and controlled by the parameter <code>onempty</code>.</p>
<p>This parameter can have one of the following values:</p>
<ul>
<li><code>disable</code>: the button displayed in disabled state if the overlay is empty</li>
@ -206,8 +206,8 @@
<p>If you want to disable a button containing <em>no overlay</em>, this can be achieved by an empty <code>href</code> parameter. An example can be seen in the <em>prev</em> button (see <code>layouts/partials/topbar/button/prev.html</code>) where the URL for the previous site may be empty.</p>
<h2 id="reference">Reference</h2>
<h3 id="button">Button</h3>
<p>Contains the basic button functionality and is used as a base implementation for all other buttons (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/func/button.html" target="_blank"><code>layouts/partials/topbar/func/button.html</code></a>).</p>
<p>Call this from your own button templates if you want to implement a button without an overlay like the <em>print</em> button (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/print.html" target="_blank"><code>layouts/partials/topbar/button/print.html</code></a>) or with an overlay containing arbitrary content like the <em>toc</em> button (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/toc.html" target="_blank"><code>layouts/partials/topbar/button/toc.html</code></a>).</p>
<p>Contains the basic button functionality and is used as a base implementation for all other buttons (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/func/button.html" rel="external" target="_blank"><code>layouts/partials/topbar/func/button.html</code></a>).</p>
<p>Call this from your own button templates if you want to implement a button without an overlay like the <em>print</em> button (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/print.html" rel="external" target="_blank"><code>layouts/partials/topbar/button/print.html</code></a>) or with an overlay containing arbitrary content like the <em>toc</em> button (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/toc.html" rel="external" target="_blank"><code>layouts/partials/topbar/button/toc.html</code></a>).</p>
<p>For displaying an area in the button&rsquo;s overlay, see <a href="/hugo-theme-relearn/basics/topbar/index.html#area-button">Area-Button</a>.</p>
<h4 id="parameter">Parameter</h4>
<table>
@ -277,8 +277,8 @@
</tbody>
</table>
<h3 id="area-button">Area-Button</h3>
<p>Contains the basic functionality to display area overlay buttons (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/func/area-button.html" target="_blank"><code>layouts/partials/topbar/func/area-button.html</code></a>).</p>
<p>Call this from your own button templates if you want to implement a button with an area overlay like the <em>more</em> button (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/more.html" target="_blank"><code>layouts/partials/topbar/button/more.html</code></a>).</p>
<p>Contains the basic functionality to display area overlay buttons (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/func/area-button.html" rel="external" target="_blank"><code>layouts/partials/topbar/func/area-button.html</code></a>).</p>
<p>Call this from your own button templates if you want to implement a button with an area overlay like the <em>more</em> button (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/more.html" rel="external" target="_blank"><code>layouts/partials/topbar/button/more.html</code></a>).</p>
<h4 id="parameter-1">Parameter</h4>
<table>
<thead>
@ -337,7 +337,7 @@
</tbody>
</table>
<h3 id="predefined-buttons">Predefined Buttons</h3>
<p>The predefined buttons by the theme (all other buttons besides the <em>more</em> and <em>toc</em> button in <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button" target="_blank"><code>layouts/partials/topbar/button</code></a>).</p>
<p>The predefined buttons by the theme (all other buttons besides the <em>more</em> and <em>toc</em> button in <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button" rel="external" target="_blank"><code>layouts/partials/topbar/button</code></a>).</p>
<p>Call these from your own redefined area templates if you want to use default button behavior.</p>
<p>The <code>&lt;varying&gt;</code> parameter values are different for each button and configured for standard behavior as seen on this page.</p>
<h4 id="parameter-2">Parameter</h4>
@ -373,7 +373,7 @@
</tbody>
</table>
<h3 id="predefined-overlay-buttons">Predefined Overlay-Buttons</h3>
<p>The predefined buttons by the theme that open an overlay (the <em>more</em> and <em>toc</em> button in <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button" target="_blank"><code>layouts/partials/topbar/button</code></a>).</p>
<p>The predefined buttons by the theme that open an overlay (the <em>more</em> and <em>toc</em> button in <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button" rel="external" target="_blank"><code>layouts/partials/topbar/button</code></a>).</p>
<p>Call these from your own redefined area templates if you want to use default button behavior utilizing overlay functionality.</p>
<p>The <code>&lt;varying&gt;</code> parameter values are different for each button and configured for standard behavior as seen on this page.</p>
<h4 id="parameter-3">Parameter</h4>
@ -505,12 +505,12 @@
<script>
var contentLangs=['en'];
</script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1712490333" defer></script>
</div>
<div id="R-homelinks" class="default-animation">
<hr class="padding">
@ -673,13 +673,13 @@
setTimeout( githubButtonsInit, 400 );
});
</script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490231"></script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1712490333"></script>
</div>
</div>
</div>
</aside>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490231" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490333" defer></script>
</body>
</html>

82
basics/topbar/index.print.html
View file

@ -23,22 +23,22 @@
<link href="https://mcshelby.github.io/hugo-theme-relearn/pir/basics/topbar/index.html" rel="alternate" hreflang="art-pir">
<link href="https://mcshelby.github.io/hugo-theme-relearn/basics/topbar/index.html" rel="canonical" type="text/html" title="Topbar Modification :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/basics/topbar/index.xml" rel="alternate" type="application/rss+xml" title="Topbar Modification :: Hugo Relearn Theme">
<link href="/hugo-theme-relearn/images/logo.svg?1712490231" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/images/logo.svg?1712490332" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490232" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490232" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490232" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490232" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490232" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490232"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490232"></script>
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1712490333" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1712490333" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1712490333" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1712490333" rel="stylesheet">
<link href="/hugo-theme-relearn/css/ie.css?1712490333" rel="stylesheet">
<script src="/hugo-theme-relearn/js/url.js?1712490333"></script>
<script src="/hugo-theme-relearn/js/variant.js?1712490333"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -91,8 +91,8 @@
<h1 id="topbar-modification">Topbar Modification</h1>
<p>The theme comes with a reasonably configured topbar.</p>
<p><a href="#R-image-65f11a70813f9a5727855f37d56d4b8f" class="lightbox-link"><img alt="Topbar on mobile devices" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/topbar/topbar-closed.png" style=" height: auto; width: auto;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-65f11a70813f9a5727855f37d56d4b8f"><img alt="Topbar on mobile devices" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/topbar/topbar-closed.png"></a></p>
<p><a href="#R-image-00745bc708eb0c34ad28a55603fd76f1" class="lightbox-link"><img alt="Topbar on mobile devices" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/topbar/topbar-closed.png" style=" height: auto; width: auto;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-00745bc708eb0c34ad28a55603fd76f1"><img alt="Topbar on mobile devices" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/topbar/topbar-closed.png"></a></p>
<p>Nevertheless, your requirements may differ from this configuration. Luckily the theme got you covered as the themebar, its buttons and the functionality behind these buttons is fully configurable by you.</p>
<div class="box notices cstyle tip">
@ -104,29 +104,29 @@
</div>
<h2 id="areas">Areas</h2>
<p>The default configuration comes with three predefined areas that may contain an arbitrary set of buttons.</p>
<p><a href="#R-image-e531b3d029f9e8bac27c6cb8f76f77fb" class="lightbox-link"><img alt="Topbar with default areas marked" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/topbar/topbar-areas.png" style=" height: auto; width: auto;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-e531b3d029f9e8bac27c6cb8f76f77fb"><img alt="Topbar with default areas marked" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/topbar/topbar-areas.png"></a></p>
<p><a href="#R-image-212beb771e81d2959870a40962ef6c0a" class="lightbox-link"><img alt="Topbar with default areas marked" class="bg-white border lazy lightbox noshadow figure-image" loading="lazy" src="/hugo-theme-relearn/basics/topbar/topbar-areas.png" style=" height: auto; width: auto;"></a>
<a href="javascript:history.back();" class="lightbox-back" id="R-image-212beb771e81d2959870a40962ef6c0a"><img alt="Topbar with default areas marked" class="bg-white border lazy lightbox noshadow lightbox-image" loading="lazy" src="/hugo-theme-relearn/basics/topbar/topbar-areas.png"></a></p>
<ul>
<li><a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/start.html" target="_blank"><strong>start</strong></a>: shown between menu and breadcrumb</li>
<li><a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/end.html" target="_blank"><strong>end</strong></a>: shown on the opposite breadcrumb side in comparison to the <em>start</em> area</li>
<li><a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/more.html" target="_blank"><strong>more</strong></a>: shown when pressing the <span class="btn cstyle transparent"><span><i class="fa-fw fas fa-ellipsis-v"></i></span></span> <em>more</em> button in the topbar</li>
<li><a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/start.html" rel="external" target="_blank"><strong>start</strong></a>: shown between menu and breadcrumb</li>
<li><a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/end.html" rel="external" target="_blank"><strong>end</strong></a>: shown on the opposite breadcrumb side in comparison to the <em>start</em> area</li>
<li><a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/more.html" rel="external" target="_blank"><strong>more</strong></a>: shown when pressing the <span class="btn cstyle transparent"><span><i class="fa-fw fas fa-ellipsis-v"></i></span></span> <em>more</em> button in the topbar</li>
</ul>
<p>While you can not add additional areas in the topbar, you are free to configure addtional buttons that behave like the <em>more</em> button, providing further user defined areas.</p>
<h2 id="buttons">Buttons</h2>
<p>The theme ships with the following predefined buttons (from left to right in the screenshot)</p>
<ul>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-bars"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/sidebar.html" target="_blank"><strong>sidebar</strong></a>: opens the sidebar flyout if in mobile layout</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-list-alt"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/toc.html" target="_blank"><strong>toc</strong></a>: opens the table of contents in an overlay</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-pen"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/edit.html" target="_blank"><strong>edit</strong></a>: browses to the editable page if the <code>editURL</code> <a href="/hugo-theme-relearn/basics/configuration/index.html">parameter is set</a></li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-print"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/print.html" target="_blank"><strong>print</strong></a>: browses to the chapters printable page if <a href="/hugo-theme-relearn/basics/customization/index.html#activate-print-support">print support</a> was activated</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-chevron-left"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/prev.html" target="_blank"><strong>prev</strong></a>: browses to the previous page if there is one</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-chevron-right"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/next.html" target="_blank"><strong>next</strong></a>: browses to the next page if there is one</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-ellipsis-v"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/more.html" target="_blank"><strong>more</strong></a>: opens the overlay for the <em>more</em> area</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-bars"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/sidebar.html" rel="external" target="_blank"><strong>sidebar</strong></a>: opens the sidebar flyout if in mobile layout</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-list-alt"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/toc.html" rel="external" target="_blank"><strong>toc</strong></a>: opens the table of contents in an overlay</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-pen"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/edit.html" rel="external" target="_blank"><strong>edit</strong></a>: browses to the editable page if the <code>editURL</code> <a href="/hugo-theme-relearn/basics/configuration/index.html">parameter is set</a></li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-print"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/print.html" rel="external" target="_blank"><strong>print</strong></a>: browses to the chapters printable page if <a href="/hugo-theme-relearn/basics/customization/index.html#activate-print-support">print support</a> was activated</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-chevron-left"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/prev.html" rel="external" target="_blank"><strong>prev</strong></a>: browses to the previous page if there is one</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-chevron-right"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/next.html" rel="external" target="_blank"><strong>next</strong></a>: browses to the next page if there is one</li>
<li><span class="btn cstyle transparent"><span><i class="fa-fw fas fa-ellipsis-v"></i></span></span> <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/more.html" rel="external" target="_blank"><strong>more</strong></a>: opens the overlay for the <em>more</em> area</li>
</ul>
<p>Not all buttons are displayed at every given time. This is configurable (see below if interested).</p>
<h2 id="redefining-areas">Redefining Areas</h2>
<p>Each predefined area and button comes in their own file. By that it is easy for you to overwrite an area file in your installation reusing only the buttons you like.</p>
<p>Eg. you can redefine the predefined <em>end</em> area by adding the file <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/end.html" target="_blank"><code>layouts/partials/topbar/area/end.html</code></a> in your installation (not in the theme itself) to remove all but the <em>more</em> button.</p>
<p>Eg. you can redefine the predefined <em>end</em> area by adding the file <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/area/end.html" rel="external" target="_blank"><code>layouts/partials/topbar/area/end.html</code></a> in your installation (not in the theme itself) to remove all but the <em>more</em> button.</p>
<p>The below example sets an explicit value for the <code>onempty</code> parameter, overriding the specific default value for this button (these defaults vary depending on the button). The parameter causes the <em>more</em> button to always be displayed instead of hiding once its content is empty.</p>
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go"><span class="line"><span class="cl"><span class="p">{{</span> <span class="nx">partial</span> <span class="s">&#34;topbar/button/more.html&#34;</span> <span class="p">(</span><span class="nx">dict</span>
</span></span><span class="line"><span class="cl"> <span class="s">&#34;page&#34;</span> <span class="p">.</span>
@ -154,8 +154,8 @@
</ul>
<h4 id="hiding-and-disabling-stuff">Hiding and Disabling Stuff</h4>
<p>While hiding a button dependend on the screen size can be configured with the above described <em>hide</em> action, you may want to hide the button on certain other conditions aswell.</p>
<p>For example, the <em>print</em> button in its default configuration should only be displayed if print support was configured. This is done in your button template by checking the conditions first before displaying the button (see <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/print.html" target="_blank"><code>layouts/partials/topbar/button/print.html</code></a>).</p>
<p>Another prefered condition for hiding a button is, if the displayed overlay is empty. This is the case for the <em>toc</em> (see <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/toc.html" target="_blank"><code>layouts/partials/topbar/button/toc.html</code></a>) aswell as the <em>more</em> button (see <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/more.html" target="_blank"><code>layouts/partials/topbar/button/more.html</code></a>) and controlled by the parameter <code>onempty</code>.</p>
<p>For example, the <em>print</em> button in its default configuration should only be displayed if print support was configured. This is done in your button template by checking the conditions first before displaying the button (see <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/print.html" rel="external" target="_blank"><code>layouts/partials/topbar/button/print.html</code></a>).</p>
<p>Another prefered condition for hiding a button is, if the displayed overlay is empty. This is the case for the <em>toc</em> (see <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/toc.html" rel="external" target="_blank"><code>layouts/partials/topbar/button/toc.html</code></a>) aswell as the <em>more</em> button (see <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/more.html" rel="external" target="_blank"><code>layouts/partials/topbar/button/more.html</code></a>) and controlled by the parameter <code>onempty</code>.</p>
<p>This parameter can have one of the following values:</p>
<ul>
<li><code>disable</code>: the button displayed in disabled state if the overlay is empty</li>
@ -164,8 +164,8 @@
<p>If you want to disable a button containing <em>no overlay</em>, this can be achieved by an empty <code>href</code> parameter. An example can be seen in the <em>prev</em> button (see <code>layouts/partials/topbar/button/prev.html</code>) where the URL for the previous site may be empty.</p>
<h2 id="reference">Reference</h2>
<h3 id="button">Button</h3>
<p>Contains the basic button functionality and is used as a base implementation for all other buttons (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/func/button.html" target="_blank"><code>layouts/partials/topbar/func/button.html</code></a>).</p>
<p>Call this from your own button templates if you want to implement a button without an overlay like the <em>print</em> button (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/print.html" target="_blank"><code>layouts/partials/topbar/button/print.html</code></a>) or with an overlay containing arbitrary content like the <em>toc</em> button (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/toc.html" target="_blank"><code>layouts/partials/topbar/button/toc.html</code></a>).</p>
<p>Contains the basic button functionality and is used as a base implementation for all other buttons (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/func/button.html" rel="external" target="_blank"><code>layouts/partials/topbar/func/button.html</code></a>).</p>
<p>Call this from your own button templates if you want to implement a button without an overlay like the <em>print</em> button (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/print.html" rel="external" target="_blank"><code>layouts/partials/topbar/button/print.html</code></a>) or with an overlay containing arbitrary content like the <em>toc</em> button (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/toc.html" rel="external" target="_blank"><code>layouts/partials/topbar/button/toc.html</code></a>).</p>
<p>For displaying an area in the button&rsquo;s overlay, see <a href="/hugo-theme-relearn/basics/topbar/index.html#area-button">Area-Button</a>.</p>
<h4 id="parameter">Parameter</h4>
<table>
@ -235,8 +235,8 @@
</tbody>
</table>
<h3 id="area-button">Area-Button</h3>
<p>Contains the basic functionality to display area overlay buttons (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/func/area-button.html" target="_blank"><code>layouts/partials/topbar/func/area-button.html</code></a>).</p>
<p>Call this from your own button templates if you want to implement a button with an area overlay like the <em>more</em> button (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/more.html" target="_blank"><code>layouts/partials/topbar/button/more.html</code></a>).</p>
<p>Contains the basic functionality to display area overlay buttons (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/func/area-button.html" rel="external" target="_blank"><code>layouts/partials/topbar/func/area-button.html</code></a>).</p>
<p>Call this from your own button templates if you want to implement a button with an area overlay like the <em>more</em> button (<a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button/more.html" rel="external" target="_blank"><code>layouts/partials/topbar/button/more.html</code></a>).</p>
<h4 id="parameter-1">Parameter</h4>
<table>
<thead>
@ -295,7 +295,7 @@
</tbody>
</table>
<h3 id="predefined-buttons">Predefined Buttons</h3>
<p>The predefined buttons by the theme (all other buttons besides the <em>more</em> and <em>toc</em> button in <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button" target="_blank"><code>layouts/partials/topbar/button</code></a>).</p>
<p>The predefined buttons by the theme (all other buttons besides the <em>more</em> and <em>toc</em> button in <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button" rel="external" target="_blank"><code>layouts/partials/topbar/button</code></a>).</p>
<p>Call these from your own redefined area templates if you want to use default button behavior.</p>
<p>The <code>&lt;varying&gt;</code> parameter values are different for each button and configured for standard behavior as seen on this page.</p>
<h4 id="parameter-2">Parameter</h4>
@ -331,7 +331,7 @@
</tbody>
</table>
<h3 id="predefined-overlay-buttons">Predefined Overlay-Buttons</h3>
<p>The predefined buttons by the theme that open an overlay (the <em>more</em> and <em>toc</em> button in <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button" target="_blank"><code>layouts/partials/topbar/button</code></a>).</p>
<p>The predefined buttons by the theme that open an overlay (the <em>more</em> and <em>toc</em> button in <a href="https://github.com/McShelby/hugo-theme-relearn/blob/main/layouts/partials/topbar/button" rel="external" target="_blank"><code>layouts/partials/topbar/button</code></a>).</p>
<p>Call these from your own redefined area templates if you want to use default button behavior utilizing overlay functionality.</p>
<p>The <code>&lt;varying&gt;</code> parameter values are different for each button and configured for standard behavior as seen on this page.</p>
<h4 id="parameter-3">Parameter</h4>
@ -379,8 +379,8 @@
</div>
</main>
</div>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490232" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1712490333" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1712490333" defer></script>
</body>
</html>