Basics on Hugo Relearn Theme https://McShelby.github.io/hugo-theme-relearn/basics/index.html Recent content in Basics on Hugo Relearn Theme Hugo -- gohugo.io en What's New https://McShelby.github.io/hugo-theme-relearn/basics/migration/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://McShelby.github.io/hugo-theme-relearn/basics/migration/index.html This document shows you what’s new in the latest release and flags it with one of the following badges. For a detailed list of changes, see the history page. 0.112.4 The minimum required Hugo version. Breaking A change that requires action by you after upgrading to assure the site is still functional. Change A change in default behavior that may requires action by you if you want to revert it. Requirements https://McShelby.github.io/hugo-theme-relearn/basics/requirements/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://McShelby.github.io/hugo-theme-relearn/basics/requirements/index.html Thanks to the simplicity of Hugo, this page is as empty as this theme needs requirements. Just download at least version 0.112.4 of the Hugo binary for your OS (Windows, Linux, Mac). Installation https://McShelby.github.io/hugo-theme-relearn/basics/installation/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://McShelby.github.io/hugo-theme-relearn/basics/installation/index.html The following steps are here to help you initialize your new website. If you don’t know Hugo at all, we strongly suggest you learn more about it by following this great documentation for beginners. Create your project Hugo provides a new command to create a new website. hugo new site <new_project>Install the theme Install the Relearn theme by following this documentation using Hugo’s module system. This theme’s repository is: https://github.com/McShelby/hugo-theme-relearn.git Configuration https://McShelby.github.io/hugo-theme-relearn/basics/configuration/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://McShelby.github.io/hugo-theme-relearn/basics/configuration/index.html On top of Hugo’s global configuration options, the Relearn theme lets you define further options unique to the theme in your config.toml. The defaults are written in the comments of each option. Note that some of these options are explained in detail in other sections of this documentation. ​ config.toml [params] # If an option value is said to be not set, you can achieve the same behavior # by given it an empty string value. Branding https://McShelby.github.io/hugo-theme-relearn/basics/branding/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://McShelby.github.io/hugo-theme-relearn/basics/branding/index.html The Relearn theme provides configuration options to change your your site’s colors, favicon and logo. This allows you to easily align your site visuals to your desired style. Most of these options are exposed thru so called color variants. A color variant lets you customize various visual effects of your site like almost any color, used fonts, color schemes of print, syntax highligtning, Mermaid and the OpenAPI shortcode, etc. It contains of a CSS file and optional configuration options in your config. Customization https://McShelby.github.io/hugo-theme-relearn/basics/customization/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://McShelby.github.io/hugo-theme-relearn/basics/customization/index.html Serving your page from a subfolder If your site is served from a subfolder, eg. https://example.com/mysite/, you have to set the following lines to your config.toml baseURL = "https://example.com/mysite/" canonifyURLs = true relativeURLs = trueWithout canonifyURLs=true URLs in sublemental pages (like sitemap.xml, rss.xml) will be generated falsly while your HTML files will still work. See https://github.com/gohugoio/hugo/issues/5226. Serving your page from the filesystem If you want your page served from the filesystem by using URLs starting with file:// you’ll need the following configuration in your config. Stylesheet generator https://McShelby.github.io/hugo-theme-relearn/basics/generator/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://McShelby.github.io/hugo-theme-relearn/basics/generator/index.html This interactive tool may help you to generate your own color variant stylesheet. Show usage instructions 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. 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 and the page will update accordingly. Topbar Modification https://McShelby.github.io/hugo-theme-relearn/basics/topbar/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://McShelby.github.io/hugo-theme-relearn/basics/topbar/index.html The theme comes with a reasonably configured topbar. 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. Tip All mentioned file names below can be clicked and show you the implementation for a better understanding. Areas The default configuration comes with three predefined areas that may contain an arbitrary set of buttons. History https://McShelby.github.io/hugo-theme-relearn/basics/history/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://McShelby.github.io/hugo-theme-relearn/basics/history/index.html Changelog 5.23.2 (2023-11-03) Enhancements [feature] taxonomy: improve taxonomy page #712 [feature] taxonomy: warn on missing term title #709 Fixes [bug] taxonomy: fix sorting of terms on content pages #710 5.23.1 (2023-10-30) Enhancements [feature] taxonomy: improve term page #705 Fixes [bug] variant: fix typo in chroma-learn.css #708 [bug] links: ignore local markdown links linking to files with extension #707 5.23.0 (2023-10-29) Enhancements [feature] taxonomy: allow for content on term pages #701 [feature] theme: write full file path on warnings #699 [feature] theme: show anchor link and copy to clipboard button on mobile #697 [feature][change] config: adjust to changes in Hugo 0.