This commit is contained in:
McShelby 2022-12-23 11:24:54 +00:00
parent cf9b67e4d3
commit aee00c5024
336 changed files with 11562 additions and 11538 deletions
basics/customization

View file

@ -10,21 +10,21 @@
<title>Customization :: Hugo Relearn Theme</title>
<link href="../../basics/customization/index.xml" rel="alternate" type="application/rss+xml" title="Customization :: Hugo Relearn Theme">
<link href="../../basics/customization/index.print.html" rel="alternate" type="text/html" title="Customization :: Hugo Relearn Theme">
<link href="../../images/logo.svg?1671762360" rel="icon" type="image/svg+xml">
<link href="../../images/logo.svg?1671794687" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="../../css/fontawesome-all.min.css?1671762360" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="../../css/fontawesome-all.min.css?1671762360" rel="stylesheet"></noscript>
<link href="../../css/featherlight.min.css?1671762360" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="../../css/featherlight.min.css?1671762360" rel="stylesheet"></noscript>
<link href="../../css/auto-complete.css?1671762360" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="../../css/auto-complete.css?1671762360" rel="stylesheet"></noscript>
<link href="../../css/perfect-scrollbar.min.css?1671762360" rel="stylesheet">
<link href="../../css/nucleus.css?1671762360" rel="stylesheet">
<link href="../../css/fonts.css?1671762360" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="../../css/fonts.css?1671762360" rel="stylesheet"></noscript>
<link href="../../css/theme.css?1671762360" rel="stylesheet">
<link href="../../css/theme-relearn-light.css?1671762360" rel="stylesheet" id="variant-style">
<link href="../../css/ie.css?1671762360" rel="stylesheet">
<link href="../../css/variant.css?1671762360" rel="stylesheet">
<link href="../../css/print.css?1671762360" rel="stylesheet" media="print">
<script src="../../js/url.js?1671762360"></script>
<script src="../../js/variant.js?1671762360"></script>
<link href="../../css/fontawesome-all.min.css?1671794687" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="../../css/fontawesome-all.min.css?1671794687" rel="stylesheet"></noscript>
<link href="../../css/featherlight.min.css?1671794687" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="../../css/featherlight.min.css?1671794687" rel="stylesheet"></noscript>
<link href="../../css/auto-complete.css?1671794687" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="../../css/auto-complete.css?1671794687" rel="stylesheet"></noscript>
<link href="../../css/perfect-scrollbar.min.css?1671794687" rel="stylesheet">
<link href="../../css/nucleus.css?1671794687" rel="stylesheet">
<link href="../../css/fonts.css?1671794687" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="../../css/fonts.css?1671794687" rel="stylesheet"></noscript>
<link href="../../css/theme.css?1671794687" rel="stylesheet">
<link href="../../css/theme-relearn-light.css?1671794687" rel="stylesheet" id="variant-style">
<link href="../../css/ie.css?1671794687" rel="stylesheet">
<link href="../../css/variant.css?1671794687" rel="stylesheet">
<link href="../../css/print.css?1671794687" rel="stylesheet" media="print">
<script src="../../js/url.js?1671794687"></script>
<script src="../../js/variant.js?1671794687"></script>
<script>
// hack to let hugo tell us how to get to the root when using relativeURLs, it needs to be called *url= for it to do its magic:
// https://github.com/gohugoio/hugo/blob/145b3fcce35fbac25c7033c91c1b7ae6d1179da8/transform/urlreplacers/absurlreplacer.go#L72
@ -42,7 +42,7 @@
var baseUriFull='https:\/\/McShelby.github.io\/hugo-theme-relearn/';
window.variants && variants.init( [ 'relearn-light', 'relearn-dark', 'learn', 'neon', 'blue', 'green', 'red' ] );
</script>
<script src="../../js/jquery.min.js?1671762360" defer></script>
<script src="../../js/jquery.min.js?1671794687" defer></script>
<style>
#body img.bg-white {
background-color: white;
@ -67,7 +67,7 @@
</a>
</div>
<div id="top-github-link">
<a class="github-link" title='Edit (CTRL+ALT+w)' href="https://github.com/McShelby/hugo-theme-relearn/edit/main/exampleSite/content/basics/customization/_index.en.md" target="blank">
<a class="github-link" title='Edit (CTRL+ALT+w)' href="https://github.com/McShelby/hugo-theme-relearn/edit/main/exampleSite/content/basics/customization/_index.en.md" target="_blank">
<i class="fas fa-pen fa-fw"></i>
</a>
</div>
@ -109,8 +109,8 @@
<article class="default">
<h1 id="customization">Customization</h1>
<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" rel="noopener">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" rel="noopener">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/" 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>This theme defines the following partials :</p>
<ul>
<li><code>header.html</code>: the header of the page. See <a href="#output-formats">output-formats</a></li>
@ -165,13 +165,13 @@ You could use an <code>img</code> HTML tag and reference an image created under
<div class="box notices cstyle tip">
<div class="box-label"><i class="fa-fw fas fa-lightbulb"></i> Tip</div>
<div class="box-content">
<p>If you want to switch the syntax highlighting theme together with your color variant, generate a syntax highlighting stylesheet and configure your installation <a href="https://gohugo.io/content-management/syntax-highlighting/" target="_blank" rel="noopener">according to Hugo&rsquo;s documentation</a>, and <code>@import</code> this stylesheet in your color variant stylesheet. For an example, take a look into <code>theme-relearn-light.css</code> and <code>config.toml</code> of the exampleSite.</p>
<p>If you want to switch the syntax highlighting theme together with your color variant, generate a syntax highlighting stylesheet and configure your installation <a href="https://gohugo.io/content-management/syntax-highlighting/" target="_blank">according to Hugo&rsquo;s documentation</a>, and <code>@import</code> this stylesheet in your color variant stylesheet. For an example, take a look into <code>theme-relearn-light.css</code> and <code>config.toml</code> of the exampleSite.</p>
</div>
</div>
<h3 id="roll-your-own">Roll your own</h3>
<p>If you are not happy with the shipped variants you can either copy and rename one of the shipped files from <code>themes/hugo-theme-relearn/static/css</code> to <code>static/css</code>, edit them afterwards to your liking in a text editor and configure the <code>themeVariant</code> parameter in your <code>config.toml</code> or just use the <a href="../../basics/generator/">interactive variant generator</a>.</p>
<h3 id="output-formats">Output formats</h3>
<p>Certain parts of the theme can be changed for support of your own <a href="https://gohugo.io/templates/output-formats/" target="_blank" rel="noopener">output formats</a>. Eg. if you define a new output format <code>PLAINTEXT</code> in your <code>config.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/" target="_blank">output formats</a>. Eg. if you define a new output format <code>PLAINTEXT</code> in your <code>config.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>
<footer class="footline">
</footer>
@ -251,12 +251,12 @@ You could use an <code>img</code> HTML tag and reference an image created under
<script>
var contentLangs=['en'];
</script>
<script src="../../js/auto-complete.js?1671762361" defer></script>
<script src="../../js/lunr.min.js?1671762361" defer></script>
<script src="../../js/lunr.stemmer.support.min.js?1671762361" defer></script>
<script src="../../js/lunr.multi.min.js?1671762361" defer></script>
<script src="../../js/lunr.en.min.js?1671762361" defer></script>
<script src="../../js/search.js?1671762361" defer></script>
<script src="../../js/auto-complete.js?1671794688" defer></script>
<script src="../../js/lunr.min.js?1671794688" defer></script>
<script src="../../js/lunr.stemmer.support.min.js?1671794688" defer></script>
<script src="../../js/lunr.multi.min.js?1671794688" defer></script>
<script src="../../js/lunr.en.min.js?1671794688" defer></script>
<script src="../../js/search.js?1671794688" defer></script>
</div>
<div id="content-wrapper" class="highlightable">
<ul class="topics collapsible-menu">
@ -372,13 +372,13 @@ You could use an <code>img</code> HTML tag and reference an image created under
<a class="github-button" href="https://github.com/McShelby/hugo-theme-relearn" data-icon="octicon-star" data-show-count="true" aria-label="Star McShelby/hugo-theme-relearn on GitHub">Star</a>
<a class="github-button" href="https://github.com/McShelby/hugo-theme-relearn/fork" data-icon="octicon-repo-forked" data-show-count="true" aria-label="Fork McShelby/hugo-theme-relearn on GitHub">Fork</a>
<p>Built with <a href="https://github.com/McShelby/hugo-theme-relearn" title="love"><i class="fas fa-heart"></i></a> by <a href="https://gohugo.io/">Hugo</a></p>
<script async src="../../js/buttons.js?1671762361"></script>
<script async src="../../js/buttons.js?1671794688"></script>
</div>
</div>
</aside>
<script src="../../js/clipboard.min.js?1671762361" defer></script>
<script src="../../js/perfect-scrollbar.min.js?1671762361" defer></script>
<script src="../../js/featherlight.min.js?1671762361" defer></script>
<script src="../../js/theme.js?1671762361" defer></script>
<script src="../../js/clipboard.min.js?1671794688" defer></script>
<script src="../../js/perfect-scrollbar.min.js?1671794688" defer></script>
<script src="../../js/featherlight.min.js?1671794688" defer></script>
<script src="../../js/theme.js?1671794688" defer></script>
</body>
</html>

View file

@ -10,22 +10,22 @@
<title>Customization :: Hugo Relearn Theme</title>
<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="../../basics/customization/index.xml" rel="alternate" type="application/rss+xml" title="Customization :: Hugo Relearn Theme">
<link href="../../images/logo.svg?1671762360" rel="icon" type="image/svg+xml">
<link href="../../images/logo.svg?1671794687" rel="icon" type="image/svg+xml">
<!-- https://github.com/filamentgroup/loadCSS/blob/master/README.md#how-to-use -->
<link href="../../css/fontawesome-all.min.css?1671762362" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="../../css/fontawesome-all.min.css?1671762362" rel="stylesheet"></noscript>
<link href="../../css/featherlight.min.css?1671762362" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="../../css/featherlight.min.css?1671762362" rel="stylesheet"></noscript>
<link href="../../css/auto-complete.css?1671762362" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="../../css/auto-complete.css?1671762362" rel="stylesheet"></noscript>
<link href="../../css/perfect-scrollbar.min.css?1671762362" rel="stylesheet">
<link href="../../css/nucleus.css?1671762362" rel="stylesheet">
<link href="../../css/fonts.css?1671762362" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="../../css/fonts.css?1671762362" rel="stylesheet"></noscript>
<link href="../../css/theme.css?1671762362" rel="stylesheet">
<link href="../../css/theme-relearn-light.css?1671762362" rel="stylesheet" id="variant-style">
<link href="../../css/ie.css?1671762362" rel="stylesheet">
<link href="../../css/variant.css?1671762362" rel="stylesheet">
<link href="../../css/print.css?1671762362" rel="stylesheet" media="print">
<link href="../../css/format-print.css?1671762362" rel="stylesheet">
<script src="../../js/url.js?1671762362"></script>
<script src="../../js/variant.js?1671762362"></script>
<link href="../../css/fontawesome-all.min.css?1671794688" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="../../css/fontawesome-all.min.css?1671794688" rel="stylesheet"></noscript>
<link href="../../css/featherlight.min.css?1671794688" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="../../css/featherlight.min.css?1671794688" rel="stylesheet"></noscript>
<link href="../../css/auto-complete.css?1671794688" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="../../css/auto-complete.css?1671794688" rel="stylesheet"></noscript>
<link href="../../css/perfect-scrollbar.min.css?1671794688" rel="stylesheet">
<link href="../../css/nucleus.css?1671794688" rel="stylesheet">
<link href="../../css/fonts.css?1671794688" rel="stylesheet" media="print" onload="this.media='all';this.onload=null;"><noscript><link href="../../css/fonts.css?1671794688" rel="stylesheet"></noscript>
<link href="../../css/theme.css?1671794688" rel="stylesheet">
<link href="../../css/theme-relearn-light.css?1671794688" rel="stylesheet" id="variant-style">
<link href="../../css/ie.css?1671794688" rel="stylesheet">
<link href="../../css/variant.css?1671794688" rel="stylesheet">
<link href="../../css/print.css?1671794688" rel="stylesheet" media="print">
<link href="../../css/format-print.css?1671794688" rel="stylesheet">
<script src="../../js/url.js?1671794688"></script>
<script src="../../js/variant.js?1671794688"></script>
<script>
// hack to let hugo tell us how to get to the root when using relativeURLs, it needs to be called *url= for it to do its magic:
// https://github.com/gohugoio/hugo/blob/145b3fcce35fbac25c7033c91c1b7ae6d1179da8/transform/urlreplacers/absurlreplacer.go#L72
@ -43,7 +43,7 @@
var baseUriFull='https:\/\/McShelby.github.io\/hugo-theme-relearn/';
window.variants && variants.init( [ 'relearn-light', 'relearn-dark', 'learn', 'neon', 'blue', 'green', 'red' ] );
</script>
<script src="../../js/jquery.min.js?1671762362" defer></script>
<script src="../../js/jquery.min.js?1671794688" defer></script>
<style>
#body img.bg-white {
background-color: white;
@ -75,8 +75,8 @@
<article class="default">
<h1 id="customization">Customization</h1>
<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" rel="noopener">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" rel="noopener">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/" 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>This theme defines the following partials :</p>
<ul>
<li><code>header.html</code>: the header of the page. See <a href="#output-formats">output-formats</a></li>
@ -131,13 +131,13 @@ You could use an <code>img</code> HTML tag and reference an image created under
<div class="box notices cstyle tip">
<div class="box-label"><i class="fa-fw fas fa-lightbulb"></i> Tip</div>
<div class="box-content">
<p>If you want to switch the syntax highlighting theme together with your color variant, generate a syntax highlighting stylesheet and configure your installation <a href="https://gohugo.io/content-management/syntax-highlighting/" target="_blank" rel="noopener">according to Hugo&rsquo;s documentation</a>, and <code>@import</code> this stylesheet in your color variant stylesheet. For an example, take a look into <code>theme-relearn-light.css</code> and <code>config.toml</code> of the exampleSite.</p>
<p>If you want to switch the syntax highlighting theme together with your color variant, generate a syntax highlighting stylesheet and configure your installation <a href="https://gohugo.io/content-management/syntax-highlighting/" target="_blank">according to Hugo&rsquo;s documentation</a>, and <code>@import</code> this stylesheet in your color variant stylesheet. For an example, take a look into <code>theme-relearn-light.css</code> and <code>config.toml</code> of the exampleSite.</p>
</div>
</div>
<h3 id="roll-your-own">Roll your own</h3>
<p>If you are not happy with the shipped variants you can either copy and rename one of the shipped files from <code>themes/hugo-theme-relearn/static/css</code> to <code>static/css</code>, edit them afterwards to your liking in a text editor and configure the <code>themeVariant</code> parameter in your <code>config.toml</code> or just use the <a href="../../basics/generator/">interactive variant generator</a>.</p>
<h3 id="output-formats">Output formats</h3>
<p>Certain parts of the theme can be changed for support of your own <a href="https://gohugo.io/templates/output-formats/" target="_blank" rel="noopener">output formats</a>. Eg. if you define a new output format <code>PLAINTEXT</code> in your <code>config.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/" target="_blank">output formats</a>. Eg. if you define a new output format <code>PLAINTEXT</code> in your <code>config.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>
<footer class="footline">
</footer>
@ -145,9 +145,9 @@ You could use an <code>img</code> HTML tag and reference an image created under
</div>
</main>
</div>
<script src="../../js/clipboard.min.js?1671762362" defer></script>
<script src="../../js/perfect-scrollbar.min.js?1671762362" defer></script>
<script src="../../js/featherlight.min.js?1671762362" defer></script>
<script src="../../js/theme.js?1671762362" defer></script>
<script src="../../js/clipboard.min.js?1671794689" defer></script>
<script src="../../js/perfect-scrollbar.min.js?1671794689" defer></script>
<script src="../../js/featherlight.min.js?1671794689" defer></script>
<script src="../../js/theme.js?1671794689" defer></script>
</body>
</html>