https://mcshelby.github.io/hugo-theme-relearn/basics/index.html Recent content in Basics on Hugo Relearn Theme Hugo -- gohugo.io en 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. 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). It’s a kind of magic 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 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 hugo.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. ​ hugo.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. 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 hugo. 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 Usage scenarios The theme is usable in different scenarios, requiring the following mandatory settings in your hugo.toml. All settings not mentioned can be set to your liking. Public Webserver from Root baseURL = "https://example.com/"Public Webserver from Subdirectory baseURL = "https://example.com/mysite/" relativeURLs = falsePrivate Webserver (LAN) The same settings as with any of the public webserver usage scenarios or baseURL = "/" relativeURLs = trueFile System baseURL = "/" relativeURLs = true Warning Using a baseURL with a subdirectory and relativeURLs=true are mutally exclusive due to the fact, that Hugo does not apply the baseURL correctly. 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. 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. 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.24.3 (2024-02-28) Fixes [bug] theme: avoid crash on 404 if author settings want to warn #785 5.24.2 (2024-02-24) Enhancements [feature] image: adjust to Hugo 0.123 #777 Fixes [bug] link: resolve fragments #775 5.24.1 (2024-02-18) Enhancements [feature] link: make resolution reporting configurable #774 5.24.0 (2024-02-17) Enhancements [feature] theme: compatibility with Hugo 0.123 #771 [feature] topbar: support editURL in frontmatter #764 [feature] menu: use –MENU-WIDTH-S to adjust mobile flyout #761 [feature] figure: support built-in shortcode #746 [feature] theme: make heading a template #744 [feature] taxonomy: make arrow nav browse thru terms #742 [feature] theme: switch from config.