<metaname="description"content="6.4.0 (2024-10-11) Change Change If you now display a single code block in a notice box, its margin and border will be removed so only the colored notice border is visible. New New It is now possible to have user-defined styles for all shortcodes that accept the style parameter. See the notice shortcode for configuration.">
<metaname="twitter:title"content="Version 6 :: Hugo Relearn Theme">
<metaname="twitter:description"content="6.4.0 (2024-10-11) Change Change If you now display a single code block in a notice box, its margin and border will be removed so only the colored notice border is visible. New New It is now possible to have user-defined styles for all shortcodes that accept the style parameter. See the notice shortcode for configuration.">
<metaproperty="og:title"content="Version 6 :: Hugo Relearn Theme">
<metaproperty="og:description"content="6.4.0 (2024-10-11) Change Change If you now display a single code block in a notice box, its margin and border will be removed so only the colored notice border is visible. New New It is now possible to have user-defined styles for all shortcodes that accept the style parameter. See the notice shortcode for configuration.">
<metaitemprop="name"content="Version 6 :: Hugo Relearn Theme">
<metaitemprop="description"content="6.4.0 (2024-10-11) Change Change If you now display a single code block in a notice box, its margin and border will be removed so only the colored notice border is visible. New New It is now possible to have user-defined styles for all shortcodes that accept the style parameter. See the notice shortcode for configuration.">
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> Change of behavior, may require action</p>
</li>
<li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> New behavior, often introducing new options</p>
</li>
</ul>
<hr>
<p></p>
<h2id="6-4-0">6.4.0 (2024-10-11)</h2>
<h3id="change">Change</h3>
<ul>
<li><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> If you now display a single code block in a <code>notice</code> box, its <ahref="/hugo-theme-relearn/shortcodes/notice/index.html#code-with-collapsed-colored-borders">margin and border will be removed</a> so only the colored notice border is visible.</li>
</ul>
<h3id="new">New</h3>
<ul>
<li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> It is now possible to have user-defined styles for all shortcodes that accept the <code>style</code> parameter. See the <ahref="/hugo-theme-relearn/shortcodes/notice/index.html#defining-own-styles"><code>notice</code> shortcode</a> for configuration.</p>
</li>
<li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> The <ahref="/hugo-theme-relearn/shortcodes/resources/index.html"><code>resources</code> shortcode</a> has a new parameter <code>expanded</code> to make the resource list collapsible.
</p>
</li>
</ul>
<hr>
<p></p>
<h2id="6-3-0">6.3.0 (2024-09-03)</h2>
<h3id="change-1">Change</h3>
<ul>
<li>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> The <ahref="/hugo-theme-relearn/shortcodes/expand/index.html"><code>expand</code> shortcode</a> changed the naming of the <code>open</code> parameter to <code>expanded</code>. You don’t need to change anything yet but may get deprecation warnings.</p>
</li>
<li>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> If the content for the <ahref="/hugo-theme-relearn/shortcodes/notice/index.html"><code>notice</code> shortcode</a> is empty, now only the title bar will be displayed. Previously an empty content box was displayed.</p>
</li>
</ul>
<h3id="new-1">New</h3>
<ul>
<li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> The <ahref="/hugo-theme-relearn/shortcodes/notice/index.html"><code>notice</code> shortcode</a> has a new parameter <code>expanded</code> to make the content collapsible.</p>
</li>
<li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> If you are running Hugo <spanclass="badge cstyle default badge-with-title"><spanclass="badge-title"><iclass="fa-fw fab fa-hackerrank"></i></span><spanclass="badge-content"style="background-color: fuchsia;">0.134.0</span></span> or later, the theme now supports <ahref="/hugo-theme-relearn/authoring/markdown/index.html#obsidian-callouts">Obsidian callouts</a>.</p>
</li>
<li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> The theme has updated its Mermaid dependency to 11.1.0. This adds support for <ahref="/hugo-theme-relearn/shortcodes/mermaid/index.html#packet">packet</a> and <ahref="/hugo-theme-relearn/shortcodes/mermaid/index.html#architecture">architecture</a> diagrams.
</p>
</li>
</ul>
<hr>
<p></p>
<h2id="6-2-0">6.2.0 (2024-08-26)</h2>
<h3id="change-2">Change</h3>
<ul>
<li>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> The heading anchor links are extended in functionality.</p>
<p>If you now click on it, not only is the link copied to the clipboard (previous behavior) but also the heading scrolls to the top of the page.</p>
<p>If you dislike the new behavior, you can deactivate it by setting <code>disableAnchorScrolling=true</code> in your <code>hugo.toml</code>. See the <ahref="/hugo-theme-relearn/configuration/content/headings/index.html">docs for further options</a>.</p>
</li>
</ul>
<h3id="new-2">New</h3>
<ul>
<li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> If you are running Hugo <spanclass="badge cstyle default badge-with-title"><spanclass="badge-title"><iclass="fa-fw fab fa-hackerrank"></i></span><spanclass="badge-content"style="background-color: fuchsia;">0.132.0</span></span> or later, the theme is now capable to print <ahref="/hugo-theme-relearn/authoring/markdown/index.html#github-alerts">GitHub alerts</a>.</p>
</li>
<li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> To support new severity levels for GitHub alerts, all shortcodes that support severity levels with their <code>style</code> parameter were expanded with the new severities <code>caution</code> and <code>important</code> and the <code>color</code> parameter was expanded with <code>cyan</code> and <code>magenta</code>. Please note, that coloring and icons of severities may defer from the <ahref="https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts"rel="external"target="_self">display you see on GitHub</a>.</p>
</li>
<li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> To support new severity levels for GitHub alerts, the new severities and their according colors are also available as CSS variables <code>BOX-MAGENTA-color</code>, <code>BOX-MAGENTA-TEXT-color</code>, <code>BOX-CAUTION-color</code>, <code>BOX-CAUTION-TEXT-color</code>, <code>BOX-CYAN-color</code>, <code>BOX-CYAN-TEXT-color</code>, <code>BOX-IMPORTANT-color</code>, <code>BOX-IMPORTANT-TEXT-color</code>. You don’t need to change anything in your custom color stylesheet as appropriate default colors will be used.
</p>
</li>
</ul>
<hr>
<p></p>
<h2id="6-1-0">6.1.0 (2024-08-02)</h2>
<h3id="change-3">Change</h3>
<ul>
<li>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> The <ahref="/hugo-theme-relearn/shortcodes/include/index.html"><code>include</code> shortcode</a> is now able to resolve links to pages as well as resources or files in the file system (the old behavior).</p>
</li>
<li>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> To make the asset buster mechanism more robust, some internally used stylesheets where restructured. This generally should not affect your page in any negative way.</p>
</li>
</ul>
<h3id="new-3">New</h3>
<ul>
<li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> The <ahref="/hugo-theme-relearn/shortcodes/openapi/index.html"><code>openapi</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>openapi.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>
</li>
<li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Shortcodes supporting an <code>errorlevel</code> configuration can now have overridden values in the <ahref="/hugo-theme-relearn/authoring/frontmatter/reference/index.html">front matter</a> section of each individual page.</p>
</li>
<li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> The theme now comes with its own overridden version of the <code>relref</code> shortcode.</p>
<p>While the usage of <code>relref</code> is obsolete and discouraged by Hugo for a while, existing installations may use it. In configurations using a <code>baseURL</code> with a subdirectory, and having <code>relativeURLs=false</code> (the default) Hugo’s standard <code>relref</code> implementation was failing.</p>
<p>The shortcode is deactivated by default and can be activated by setting</p>
<p>in your <code>hugo.toml</code>. Only do this if your site fulfills <strong>all of the above assumptions</strong>.
</p>
</li>
</ul>
<hr>
<p></p>
<h2id="6-0-0">6.0.0 (2024-04-27)</h2>
<h3id="breaking">Breaking</h3>
<ul>
<li>
<p><spanclass="badge cstyle warning badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-triangle"></i></span><spanclass="badge-content">Breaking</span></span> This release requires you to move your self-defined variant (<code>theme-*.css</code>) and chroma stylesheets (<code>chroma-*.css</code>) from <code>static/css</code> to <code>assets/css</code>.</p>
<p>This was necessary to avoid permission errors on build if running in certain Unix configurations.</p>
<p>In addition it is not allowed anymore to <code>@import</code> your chroma stylesheet from inside of your variant stylesheet.</p>
<p>Say, your chroma stylesheet is named <code>chroma-monokai.css</code>, you have to add the following inside your variant stylesheet:</p>
<p><spanclass="badge cstyle warning badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-triangle"></i></span><spanclass="badge-content">Breaking</span></span> The parameter <code>description</code> in your <code>hugo.toml</code> will now be ignored.</p>
<p>With the newly introduced 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 front matter section of your home page.</p>
</li>
<li>
<p><spanclass="badge cstyle warning badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-triangle"></i></span><spanclass="badge-content">Breaking</span></span> Search support for the <code>json</code> outputformat <ahref="/hugo-theme-relearn/introduction/releasenotes/5/index.html#5-4-0">deprecated in 5.4.0</a> was removed.</p>
<p>Change it to <code>search</code> for the homepage in your <code>hugo.toml</code>. See the docs for <ahref="/hugo-theme-relearn/configuration/sidebar/search/index.html">detailed configuration</a>.</p>
</li>
<li>
<p><spanclass="badge cstyle warning badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-triangle"></i></span><spanclass="badge-content">Breaking</span></span> The front matter option <code>menuTitle</code><ahref="/hugo-theme-relearn/introduction/releasenotes/5/index.html#5-24-0">deprecated in 5.24.0</a> was removed 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>
<li>
<p><spanclass="badge cstyle warning badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-triangle"></i></span><spanclass="badge-content">Breaking</span></span> The <code>swagger</code> shortcode <ahref="/hugo-theme-relearn/introduction/releasenotes/5/index.html#5-13-0">deprecated in 5.13.0</a> was removed in favor for the <ahref="/hugo-theme-relearn/shortcodes/openapi/index.html"><code>openapi</code> shortcode</a> with the same set of parameter.</p>
</li>
<li>
<p><spanclass="badge cstyle warning badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-triangle"></i></span><spanclass="badge-content">Breaking</span></span> Support for Internet Explorer 11 was finally dropped.</p>
</li>
</ul>
<h3id="change-4">Change</h3>
<ul>
<li>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> With the removal of support for Internet Explorer 11, Font Awesome was upgraded to version 6.5.2.</p>
<p>You may experience slight changes for some icons. In addition you have additional ~1700 icons <ahref="https://fontawesome.com/v6/search?m=free"rel="external"target="_self">to chose</a> from.</p>
</li>
<li>
<p><spanclass="badge cstyle note badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-exclamation-circle"></i></span><spanclass="badge-content">Change</span></span> The <ahref="/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>
</li>
</ul>
<h3id="new-4">New</h3>
<ul>
<li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> The <ahref="/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>
</li>
<li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Math is now usable without enclosing it in a shortcode or Markdown codefence by using Hugo’s <ahref="/hugo-theme-relearn/shortcodes/math/index.html#passthrough-configuration">passthrough configuration</a>.</p>
</li>
<li>
<p><spanclass="badge cstyle info badge-with-title"><spanclass="badge-title"><iclass="fa-fw fas fa-plus-circle"></i></span><spanclass="badge-content">New</span></span> Translation into Romanian.
