Content on Hugo Relearn Theme https://mcshelby.github.io/hugo-theme-relearn/cont/index.html Recent content in Content on Hugo Relearn Theme Hugo -- gohugo.io en Pages organization https://mcshelby.github.io/hugo-theme-relearn/cont/pages/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://mcshelby.github.io/hugo-theme-relearn/cont/pages/index.html In Hugo, pages are the core of your site. Once it is configured, pages are definitely the added value to your documentation site. Folders Organize your site like any other Hugo project. Typically, you will have a content folder with all your pages. content ├── level-one │ ├── level-two │ │ ├── level-three │ │ │ ├── level-four │ │ │ │ ├── _index.md <-- /level-one/level-two/level-three/level-four │ │ │ │ ├── page-4-a. Frontmatter https://mcshelby.github.io/hugo-theme-relearn/cont/frontmatter/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://mcshelby.github.io/hugo-theme-relearn/cont/frontmatter/index.html Each Hugo page has to define a frontmatter. All Frontmatter Options The values reflect example options. The defaults can be taken from the annotated example below. ​ toml yaml json +++ LastModifierDisplayName = '' LastModifierEmail = '' alwaysopen = '' collapsibleMenu = true customMathJaxURL = '' customMermaidURL = '' customOpenapiURL = '' description = '' disableBreadcrumb = false disableMathJax = true disableMermaid = true disableNextPrev = false disableOpenapi = true disableToc = false editURL = '' headingPost = '' headingPre = '' hidden = false highlightWrap = true images = ['images/hero. Archetypes https://mcshelby.github.io/hugo-theme-relearn/cont/archetypes/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://mcshelby.github.io/hugo-theme-relearn/cont/archetypes/index.html Using the command: hugo new [relative new content path], you can start a content file with the date and title automatically set. While this is a welcome feature, active writers need more: archetypes. These are preconfigured skeleton pages with default frontmatter. The Relearn theme defines some few archetypes of pages but you are free to define new ones to your liking. All can be used at any level of the documentation, the only difference being the layout of the content. Markdown syntax https://mcshelby.github.io/hugo-theme-relearn/cont/markdown/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://mcshelby.github.io/hugo-theme-relearn/cont/markdown/index.html Let’s face it: Writing content for the web is tiresome. WYSIWYG editors help alleviate this task, but they generally result in horrible code, or worse yet, ugly web pages. Markdown is a better way to write HTML, without all the complexities and ugliness that usually accompanies it. Some of the key benefits are: Markdown is simple to learn, with minimal extra characters so it’s also quicker to write content. Less chance of errors when writing in Markdown. Image Effects https://mcshelby.github.io/hugo-theme-relearn/cont/imageeffects/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://mcshelby.github.io/hugo-theme-relearn/cont/imageeffects/index.html The theme supports non-standard image effects. As described, you can add this to the URL query parameter, but this may be cumbersome to do it consistently for the whole page. Instead, you can configure the defaults in your hugo.toml aswell as overriding these default in the pages frontmatter. Explicitly set URL query parameter will override the defaults in effect for a page. Without any settings in your hugo.toml this defaults to Menu extra shortcuts https://mcshelby.github.io/hugo-theme-relearn/cont/menushortcuts/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://mcshelby.github.io/hugo-theme-relearn/cont/menushortcuts/index.html You can define additional menu entries or shortcuts in the navigation menu without any link to content. Basic configuration Edit the website configuration hugo.toml and add a [[menu.shortcuts]] entry for each link your want to add. Example from the current website: hugo. toml yaml json [menu] [[menu.shortcuts]] identifier = 'ds' name = "<i class='fab fa-fw fa-github'></i> GitHub repo" url = 'https://github.com/McShelby/hugo-theme-relearn' weight = 10 [[menu.shortcuts]] name = "<i class='fas fa-fw fa-camera'></i> Showcases" url = 'showcase/' weight = 11 [[menu. Multilingual and i18n https://mcshelby.github.io/hugo-theme-relearn/cont/i18n/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://mcshelby.github.io/hugo-theme-relearn/cont/i18n/index.html The Relearn theme is fully compatible with Hugo multilingual mode. Available languages: Arabic, Simplified Chinese, Traditional Chinese, Czech, Dutch, English, Finnish, French, German, Hindi, Hungarian, Indonesian, Italian, Japanese, Korean, Polish, Portuguese, Russian, Spanish, Swahili, Turkish, Vietnamese. Feel free to contribute! Full support for languages written right to left Automatic menu generation from multilingual content In-browser language switching Basic configuration After learning how Hugo handle multilingual websites, define your languages in your hugo. Taxonomy https://mcshelby.github.io/hugo-theme-relearn/cont/taxonomy/index.html Mon, 01 Jan 0001 00:00:00 +0000 https://mcshelby.github.io/hugo-theme-relearn/cont/taxonomy/index.html The Relearn theme supports Hugo’s default taxonomies tag and category out of the box. Configuration Just add tags and/or categories to any page. They can be given as a single string or an array of strings. ​ toml yaml json +++ categories = ['taxonomy', 'content'] tags = 'tutorial' title = 'Taxonomy' +++ --- categories: - taxonomy - content tags: tutorial title: Taxonomy --- { "categories": [ "taxonomy", "content" ], "tags": "tutorial", "title": "Taxonomy" } Behavior The tags are displayed at the top of the page in alphabetical order.