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

deploy: b2a91ca5cc

Browse source
This commit is contained in:
McShelby 2024-04-24 21:05:57 +00:00
parent 9d6e652ad8
commit 1bee5cb1aa
284 changed files with 7432 additions and 8205 deletions

66
basics/migration/index.html
View file

@ -20,7 +20,7 @@
<meta property="og:image" content="https://mcshelby.github.io/hugo-theme-relearn/images/hero.png">
<meta itemprop="name" content="What&#39;s New :: Hugo Relearn Theme">
<meta itemprop="description" content="This document shows you what&rsquo;s new in the latest release and flags it with one of the following badges.">
<meta itemprop="wordCount" content="7973">
<meta itemprop="wordCount" content="8012">
<meta itemprop="image" content="https://mcshelby.github.io/hugo-theme-relearn/images/hero.png">
<title>What&#39;s New :: Hugo Relearn Theme</title>
<link href="https://mcshelby.github.io/hugo-theme-relearn/basics/migration/index.html" rel="alternate" hreflang="x-default">
@ -28,19 +28,18 @@
<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?1713987513" 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?1713987513" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1713987513" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1713987513" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1713987513" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1713987513" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1713987513" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1713987513" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1713987513" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1713987513" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1713987513" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1713987513" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1713987513" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1713987513" rel="stylesheet" media="print">
<script src="/hugo-theme-relearn/js/variant.js?1713987513"></script>
<link href="/hugo-theme-relearn/images/logo.svg?1713992749" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1713992749" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1713992749" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1713992749" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1713992749" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1713992749" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1713992749" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1713992749" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1713992749" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1713992749" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1713992749" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1713992749" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1713992749" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1713992749" rel="stylesheet" media="print">
<script src="/hugo-theme-relearn/js/variant.js?1713992749"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -76,8 +75,7 @@
</div>
<div class="topbar-button topbar-button-toc" data-content-empty="hide" data-width-s="show" data-width-m="show" data-width-l="show"><button class="topbar-control" onclick="toggleTopbarFlyout(this)" type="button" title="Table of Contents (CTRL&#43;ALT&#43;t)"><i class="fa-fw fas fa-list-alt"></i></button>
<div class="topbar-content">
<div class="topbar-content-wrapper">
<nav class="TableOfContents">
<div class="topbar-content-wrapper"><nav class="TableOfContents">
<ul>
<li><a href="#600">6.0.0.beta (XXXX-XX-XX)</a></li>
<li><a href="#5270">5.27.0 (2024-04-07)</a></li>
@ -130,7 +128,7 @@
<li><a href="#110">1.1.0 (2021-07-02)</a></li>
<li><a href="#100">1.0.0 (2021-07-01)</a></li>
</ul>
</nav>
</nav>
</div>
</div>
</div>
@ -194,6 +192,11 @@
<p>Say, your chroma stylesheet is named <code>chroma-monokai.css</code>, you have to add the following inside your variant stylesheet:</p>
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-css" data-lang="css"><span class="line"><span class="cl"><span class="nt">--CODE-theme</span><span class="o">:</span> <span class="nt">monokai</span><span class="o">;</span></span></span></code></pre></div></li>
<li>
<p><span class="badge cstyle warning badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-exclamation-triangle"></i></span><span class="badge-content">Breaking</span></span> The parameter <code>description</code> in your <code>hugo.toml</code> will now been ignored.</p>
<p>With the newly introduces unified handling of descriptions throughout the theme, the only place the old parameter would have been used was your home page.</p>
<p>For migration, move the <code>description</code> parameter of your <code>hugo.toml</code> into the frontmatter section of your home page.</p>
</li>
<li>
<p><span class="badge cstyle warning badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-exclamation-triangle"></i></span><span class="badge-content">Breaking</span></span> The frontmatter option <code>menuTitle</code> is now unsupported in favor for Hugo’s own <code>linkTitle</code>.</p>
<p>Additionally, if set <code>linkTitle</code> will now be used instead of <code>title</code> to generate the breadcrumb.</p>
</li>
@ -207,7 +210,6 @@
<li>
<p><span class="badge cstyle note badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-exclamation-circle"></i></span><span class="badge-content">Change</span></span> The <a href="/hugo-theme-relearn/shortcodes/children/index.html"><code>children</code> shortcode</a> was fixed to adhere to its documentation generating the description based on this rule: When no description or summary exists for the page, the first 70 words of the content is taken.</p>
<p>Previously, the summary erroneously was ignored which now can lead to different output if you set <code>description=true</code> as a parameter.</p>
<p>In addition, all places where descriptions are printed, now behave in the same way.</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 <a href="/hugo-theme-relearn/shortcodes/include/index.html"><code>include</code> shortcode</a> is now able to resolve links to resources as well as to files in the file system (the old behavior). You can configure to generate warnings or errors during build by setting <code>include.errorlevel</code> to either <code>warning</code> or <code>error</code> in your <code>hugo.toml</code> if a path can not be resolved.</p>
@ -719,13 +721,13 @@
<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="_self">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="c4b6c19cb66a820e9f12db98d55a8c95">
<div class="tab-panel" data-tab-group="a9b39e4b99725c652a839ee6387c9efa">
<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('c4b6c19cb66a820e9f12db98d55a8c95','frontmatterjson')"
onclick="switchTab('a9b39e4b99725c652a839ee6387c9efa','frontmatterjson')"
>
<span class="tab-nav-text">frontmatter.json</span>
</button>
@ -760,13 +762,13 @@
<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="_self">jQuery</a> library from its distribution.</p>
<p>In case you made changes to the theme that are depending 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="dcbc7b8d046e56bf6e72580e072b1efe">
<div class="tab-panel" data-tab-group="866814ba1860a74fdd4683ecf8dae625">
<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('dcbc7b8d046e56bf6e72580e072b1efe','layoutspartialscustom-headerhtml')"
onclick="switchTab('866814ba1860a74fdd4683ecf8dae625','layoutspartialscustom-headerhtml')"
>
<span class="tab-nav-text">layouts/partials/custom-header.html</span>
</button>
@ -1648,12 +1650,12 @@
<script>
var contentLangs=['en'];
</script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1713987513" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1713987513" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1713987513" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1713987513" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1713987513" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1713987513" defer></script>
<script src="/hugo-theme-relearn/js/auto-complete.js?1713992749" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.min.js?1713992749" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.stemmer.support.min.js?1713992749" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.multi.min.js?1713992749" defer></script>
<script src="/hugo-theme-relearn/js/lunr/lunr.en.min.js?1713992749" defer></script>
<script src="/hugo-theme-relearn/js/search.js?1713992749" defer></script>
</div>
<div id="R-homelinks" class="default-animation">
<hr class="padding">
@ -1817,13 +1819,13 @@
setTimeout( githubButtonsInit, 400 );
});
</script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1713987513"></script>
<script async src="/hugo-theme-relearn/js/github-buttons.js?1713992749"></script>
</div>
</div>
</div>
</aside>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1713987513" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1713987513" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1713987513" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1713992749" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1713992749" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1713992749" defer></script>
</body>
</html>

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

@ -20,7 +20,7 @@
<meta property="og:image" content="https://mcshelby.github.io/hugo-theme-relearn/images/hero.png">
<meta itemprop="name" content="What&#39;s New :: Hugo Relearn Theme">
<meta itemprop="description" content="This document shows you what&rsquo;s new in the latest release and flags it with one of the following badges.">
<meta itemprop="wordCount" content="7973">
<meta itemprop="wordCount" content="8012">
<meta itemprop="image" content="https://mcshelby.github.io/hugo-theme-relearn/images/hero.png">
<title>What&#39;s New :: Hugo Relearn Theme</title>
<link href="https://mcshelby.github.io/hugo-theme-relearn/basics/migration/index.html" rel="alternate" hreflang="x-default">
@ -28,20 +28,19 @@
<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?1713987513" 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?1713987514" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1713987514" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1713987514" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1713987514" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1713987514" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1713987514" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1713987514" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1713987514" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1713987514" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1713987514" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1713987514" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1713987514" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1713987514" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1713987514" rel="stylesheet">
<script src="/hugo-theme-relearn/js/variant.js?1713987514"></script>
<link href="/hugo-theme-relearn/images/logo.svg?1713992749" rel="icon" type="image/svg+xml">
<link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1713992750" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fontawesome-all.min.css?1713992750" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/nucleus.css?1713992750" rel="stylesheet">
<link href="/hugo-theme-relearn/css/auto-complete.css?1713992750" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/auto-complete.css?1713992750" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/perfect-scrollbar.min.css?1713992750" rel="stylesheet">
<link href="/hugo-theme-relearn/css/fonts.css?1713992750" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="/hugo-theme-relearn/css/fonts.css?1713992750" rel="stylesheet"></noscript>
<link href="/hugo-theme-relearn/css/theme.css?1713992750" rel="stylesheet">
<link href="/hugo-theme-relearn/css/theme-relearn-auto.css?1713992750" rel="stylesheet" id="R-variant-style">
<link href="/hugo-theme-relearn/css/chroma-relearn-auto.css?1713992750" rel="stylesheet" id="R-variant-chroma-style">
<link href="/hugo-theme-relearn/css/variant.css?1713992750" rel="stylesheet">
<link href="/hugo-theme-relearn/css/print.css?1713992750" rel="stylesheet" media="print">
<link href="/hugo-theme-relearn/css/format-print.css?1713992750" rel="stylesheet">
<script src="/hugo-theme-relearn/js/variant.js?1713992750"></script>
<script>
window.relearn = window.relearn || {};
window.relearn.relBasePath='..\/..';
@ -123,6 +122,11 @@
<p>Say, your chroma stylesheet is named <code>chroma-monokai.css</code>, you have to add the following inside your variant stylesheet:</p>
<div class="highlight wrap-code"><pre tabindex="0" class="chroma"><code class="language-css" data-lang="css"><span class="line"><span class="cl"><span class="nt">--CODE-theme</span><span class="o">:</span> <span class="nt">monokai</span><span class="o">;</span></span></span></code></pre></div></li>
<li>
<p><span class="badge cstyle warning badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-exclamation-triangle"></i></span><span class="badge-content">Breaking</span></span> The parameter <code>description</code> in your <code>hugo.toml</code> will now been ignored.</p>
<p>With the newly introduces unified handling of descriptions throughout the theme, the only place the old parameter would have been used was your home page.</p>
<p>For migration, move the <code>description</code> parameter of your <code>hugo.toml</code> into the frontmatter section of your home page.</p>
</li>
<li>
<p><span class="badge cstyle warning badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-exclamation-triangle"></i></span><span class="badge-content">Breaking</span></span> The frontmatter option <code>menuTitle</code> is now unsupported in favor for Hugo’s own <code>linkTitle</code>.</p>
<p>Additionally, if set <code>linkTitle</code> will now be used instead of <code>title</code> to generate the breadcrumb.</p>
</li>
@ -136,7 +140,6 @@
<li>
<p><span class="badge cstyle note badge-with-title"><span class="badge-title"><i class="fa-fw fas fa-exclamation-circle"></i></span><span class="badge-content">Change</span></span> The <a href="/hugo-theme-relearn/shortcodes/children/index.html"><code>children</code> shortcode</a> was fixed to adhere to its documentation generating the description based on this rule: When no description or summary exists for the page, the first 70 words of the content is taken.</p>
<p>Previously, the summary erroneously was ignored which now can lead to different output if you set <code>description=true</code> as a parameter.</p>
<p>In addition, all places where descriptions are printed, now behave in the same way.</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 <a href="/hugo-theme-relearn/shortcodes/include/index.html"><code>include</code> shortcode</a> is now able to resolve links to resources as well as to files in the file system (the old behavior). You can configure to generate warnings or errors during build by setting <code>include.errorlevel</code> to either <code>warning</code> or <code>error</code> in your <code>hugo.toml</code> if a path can not be resolved.</p>
@ -648,13 +651,13 @@
<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="_self">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="c4b6c19cb66a820e9f12db98d55a8c95">
<div class="tab-panel" data-tab-group="a9b39e4b99725c652a839ee6387c9efa">
<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('c4b6c19cb66a820e9f12db98d55a8c95','frontmatterjson')"
onclick="switchTab('a9b39e4b99725c652a839ee6387c9efa','frontmatterjson')"
>
<span class="tab-nav-text">frontmatter.json</span>
</button>
@ -689,13 +692,13 @@
<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="_self">jQuery</a> library from its distribution.</p>
<p>In case you made changes to the theme that are depending 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="dcbc7b8d046e56bf6e72580e072b1efe">
<div class="tab-panel" data-tab-group="866814ba1860a74fdd4683ecf8dae625">
<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('dcbc7b8d046e56bf6e72580e072b1efe','layoutspartialscustom-headerhtml')"
onclick="switchTab('866814ba1860a74fdd4683ecf8dae625','layoutspartialscustom-headerhtml')"
>
<span class="tab-nav-text">layouts/partials/custom-header.html</span>
</button>
@ -1510,8 +1513,8 @@
</div>
</main>
</div>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1713987514" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1713987514" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1713987514" defer></script>
<script src="/hugo-theme-relearn/js/clipboard.min.js?1713992750" defer></script>
<script src="/hugo-theme-relearn/js/perfect-scrollbar.min.js?1713992750" defer></script>
<script src="/hugo-theme-relearn/js/theme.js?1713992750" defer></script>
</body>
</html>