Content on Hugo Relearn Theme https://McShelby.github.io/hugo-theme-relearn/cont/ Recent content in Content on Hugo Relearn Theme Hugo -- gohugo.io en Pages organization https://McShelby.github.io/hugo-theme-relearn/cont/pages/ Mon, 01 Jan 0001 00:00:00 +0000 https://McShelby.github.io/hugo-theme-relearn/cont/pages/ 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. Multilingual and i18n https://McShelby.github.io/hugo-theme-relearn/cont/i18n/ Mon, 01 Jan 0001 00:00:00 +0000 https://McShelby.github.io/hugo-theme-relearn/cont/i18n/ The Relearn theme is fully compatible with Hugo multilingual mode. It provides: Translation strings for default values (English, Piratized English, Arabic, Simplified Chinese, Dutch, French, German, Hindi, Indonesian, Japanese, Korean, Portuguese, Russian, Spanish, Vietnamese, Turkish). Feel free to contribute! Automatic menu generation from multilingual content In-browser language switching Basic configuration After learning how Hugo handle multilingual websites, define your languages in your config.toml file. For example with current English and Piratized English website. Archetypes https://McShelby.github.io/hugo-theme-relearn/cont/archetypes/ Mon, 01 Jan 0001 00:00:00 +0000 https://McShelby.github.io/hugo-theme-relearn/cont/archetypes/ 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. It is pre-configured skeleton pages with default front matter. Please refer to the documentation for types of page to understand the differences. Chapter To create a Chapter page, run the following commands hugo new --kind chapter <name>/_index.md It will create a page with predefined Front-Matter: Markdown syntax https://McShelby.github.io/hugo-theme-relearn/cont/markdown/ Mon, 01 Jan 0001 00:00:00 +0000 https://McShelby.github.io/hugo-theme-relearn/cont/markdown/ 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. Code highlighting https://McShelby.github.io/hugo-theme-relearn/cont/syntaxhighlight/ Mon, 01 Jan 0001 00:00:00 +0000 https://McShelby.github.io/hugo-theme-relearn/cont/syntaxhighlight/ The Relearn theme uses Hugo’s built-in syntax highlighting for code. Markdown syntax Wrap the code block with three backticks and the name of the language. Highlight will try to auto detect the language if one is not provided. ```json [ { "title": "apples", "count": [12000, 20000], "description": {"text": "...", "sensitive": false} }, { "title": "oranges", "count": [17500, null], "description": {"text": "...", "sensitive": false} } ] ``` Renders to: [ { "title": "apples", "count": [12000, 20000], "description": {"text": ". Menu extra shortcuts https://McShelby.github.io/hugo-theme-relearn/cont/menushortcuts/ Mon, 01 Jan 0001 00:00:00 +0000 https://McShelby.github.io/hugo-theme-relearn/cont/menushortcuts/ You can define additional menu entries or shortcuts in the navigation menu without any link to content. Basic configuration Edit the website configuration config.toml and add a [[menu.shortcuts]] entry for each link your want to add. Example from the current website: [[menu.shortcuts]] name = "<i class='fab fa-fw fa-github'></i> GitHub repo" identifier = "ds" url = "https://github.com/McShelby/hugo-theme-relearn" weight = 10 [[menu.shortcuts]] name = "<i class='fas fa-fw fa-camera'></i> Showcases" url = "more/showcase/" weight = 11 [[menu. Icons and logos https://McShelby.github.io/hugo-theme-relearn/cont/icons/ Mon, 01 Jan 0001 00:00:00 +0000 https://McShelby.github.io/hugo-theme-relearn/cont/icons/ The Relearn theme for Hugo loads the Font Awesome library, allowing you to easily display any icon or logo available in the Font Awesome free collection. Finding an icon Browse through the available icons in the Font Awesome Gallery. Notice that the free filter is enabled, as only the free icons are available by default. Once on the Font Awesome page for a specific icon, for example the page for the heart, copy the HTML reference and paste into the Markdown content. Tags https://McShelby.github.io/hugo-theme-relearn/cont/tags/ Mon, 01 Jan 0001 00:00:00 +0000 https://McShelby.github.io/hugo-theme-relearn/cont/tags/ The Relearn theme supports one default taxonomy of Hugo: the tag feature. Configuration Just add tags to any page: +++ tags = ["tutorial", "theme"] title = "Theme tutorial" weight = 15 +++ Behavior The tags are displayed at the top of the page, in their insertion order. Each tag is a link to a Taxonomy page displaying all the articles with the given tag. List all the tags In the config.