From cb6f3467cd4417d29356c422c12650a2838877c8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=B6ren=20Weber?= Date: Sun, 6 Oct 2024 20:52:53 +0200 Subject: [PATCH] #docs: call it front matter #567 --- .../content/configuration/appearance/topbar/_index.en.md | 2 +- .../configuration/modifications/imageeffects.en.md | 6 +++--- .../content/configuration/modifications/taxonomy.en.md | 2 +- .../configuration/sidebar/shortcutmenu/_index.en.md | 4 ++-- exampleSite/content/content/frontmatter/_index.en.md | 4 ++-- exampleSite/content/content/layouts/_index.en.md | 8 ++++---- exampleSite/content/content/markdown.en.md | 2 +- exampleSite/content/frontmatter/_index.en.md | 4 ++-- exampleSite/content/introduction/releasenotes/2/0.en.md | 2 +- exampleSite/content/introduction/releasenotes/2/4.en.md | 2 +- exampleSite/content/introduction/releasenotes/3/2.en.md | 2 +- exampleSite/content/introduction/releasenotes/5/0.en.md | 4 ++-- exampleSite/content/introduction/releasenotes/5/20.en.md | 2 +- exampleSite/content/introduction/releasenotes/5/22.en.md | 4 ++-- exampleSite/content/introduction/releasenotes/5/24.en.md | 6 +++--- exampleSite/content/introduction/releasenotes/5/27.en.md | 2 +- exampleSite/content/introduction/releasenotes/5/9.en.md | 4 ++-- exampleSite/content/introduction/releasenotes/6/0.en.md | 4 ++-- exampleSite/content/introduction/releasenotes/6/1.en.md | 2 +- exampleSite/content/shortcodes/children/_index.en.md | 2 +- exampleSite/content/shortcodes/highlight.en.md | 2 +- exampleSite/content/shortcodes/mermaid.en.md | 2 +- exampleSite/content/tags/the-hidden/_index.en.md | 2 +- layouts/_default/baseof.html | 2 +- layouts/partials/title.gotmpl | 2 +- 25 files changed, 39 insertions(+), 39 deletions(-) diff --git a/exampleSite/content/configuration/appearance/topbar/_index.en.md b/exampleSite/content/configuration/appearance/topbar/_index.en.md index 1c49727617..00c91163dd 100644 --- a/exampleSite/content/configuration/appearance/topbar/_index.en.md +++ b/exampleSite/content/configuration/appearance/topbar/_index.en.md @@ -23,7 +23,7 @@ This page is about how to configure supported options for the topbar. If you wan {{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} If `editURL` is set to a URL, an edit button will be shown in the topbar. If the button is hidden, also the keyboard shortcut is disabled. -The value can contain the macro `${FilePath}` which will be replaced by the file path of your displayed page. If no `${FilePath}` is given in the value, the value is treated as if the `${FilePath}` was appended at the end of the value. This can be overridden in the pages frontmatter. +The value can contain the macro `${FilePath}` which will be replaced by the file path of your displayed page. If no `${FilePath}` is given in the value, the value is treated as if the `${FilePath}` was appended at the end of the value. This can be overridden in the pages front matter. Eg. this site is using `editURL="https://github.com/McShelby/hugo-theme-relearn/edit/main/exampleSite/content/${FilePath}"` diff --git a/exampleSite/content/configuration/modifications/imageeffects.en.md b/exampleSite/content/configuration/modifications/imageeffects.en.md index d5967c037d..75d4f3fec8 100644 --- a/exampleSite/content/configuration/modifications/imageeffects.en.md +++ b/exampleSite/content/configuration/modifications/imageeffects.en.md @@ -15,7 +15,7 @@ The theme supports non-standard [image effects](content/markdown#image-effects). | lightbox | The image will be clickable to show it enlarged | | shadow | Draws a shadow around the image to make it appear hovered/glowing | -As [described](content/markdown#image-effects), you can add this to the URL query parameter, but this may be cumbersome to be done consistently for the whole page. Instead, you can configure the defaults in your `hugo.toml` as well as overriding these default in the pages frontmatter. +As [described](content/markdown#image-effects), you can add this to the URL query parameter, but this may be cumbersome to be done consistently for the whole page. Instead, you can configure the defaults in your `hugo.toml` as well as overriding these default in the pages front matter. Explicitly set URL query parameter will override the defaults in effect for a page or your site. @@ -62,7 +62,7 @@ This ends up in the following HTML where the parameter are converted to CSS clas ## Extending -{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} As you can see in the above example, the `bg-white` parameter is not initially supported in the themes default settings. The theme allows you to define arbitrary parameter by just adding them to the URL query parameter or set them in your page's frontmatter or `hugo.toml`. +{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} As you can see in the above example, the `bg-white` parameter is not initially supported in the themes default settings. The theme allows you to define arbitrary parameter by just adding them to the URL query parameter or set them in your page's front matter or `hugo.toml`. {{< multiconfig file=hugo >}} [params] @@ -75,5 +75,5 @@ This ends up in the following HTML where the parameter are converted to CSS clas {{< /multiconfig >}} {{% notice note %}} -If no extended parameter like `bg-white` in the example is set on the URL, a `class="nobg-white"` in the HTML will only be generated if a default value was set in the page's frontmatter or `hugo.toml` . +If no extended parameter like `bg-white` in the example is set on the URL, a `class="nobg-white"` in the HTML will only be generated if a default value was set in the page's front matter or `hugo.toml` . {{% /notice %}} diff --git a/exampleSite/content/configuration/modifications/taxonomy.en.md b/exampleSite/content/configuration/modifications/taxonomy.en.md index efadac2e63..a773663f82 100644 --- a/exampleSite/content/configuration/modifications/taxonomy.en.md +++ b/exampleSite/content/configuration/modifications/taxonomy.en.md @@ -48,7 +48,7 @@ You can display the terms of your custom taxonomy somewhere in your page (often | Name | Default | Notes | |-----------------------|-----------------|-------------| | **page** | _<empty>_ | Mandatory reference to the page. | -| **taxonomy** | _<empty>_ | The plural name of the taxonomy to display as used in your frontmatter. | +| **taxonomy** | _<empty>_ | The plural name of the taxonomy to display as used in your front matter. | | **class** | _<empty>_ | Additional CSS classes set on the outermost generated HTML element.

If set to `tags` you will get the visuals for displaying the _tags_ taxonomy, otherwise it will be a simple list of links as for the _categories_ taxonomy. | | **style** | `primary` | The style scheme used if **class** is `tags`.

- by severity: `caution`, `important`, `info`, `note`, `tip`, `warning`
- by brand color: `primary`, `secondary`, `accent`
- by color: `blue`, `cyan`, `green`, `grey`, `magenta`, `orange`, `red`
- by special color: `default`, `transparent`, `code` | | **color** | see notes | The [CSS color value](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value) to be used if **class** is `tags`. If not set, the chosen color depends on the **style**. Any given value will overwrite the default.

- for severity styles: a nice matching color for the severity
- for all other styles: the corresponding color | diff --git a/exampleSite/content/configuration/sidebar/shortcutmenu/_index.en.md b/exampleSite/content/configuration/sidebar/shortcutmenu/_index.en.md index 154d0694b9..b8e1947ba7 100644 --- a/exampleSite/content/configuration/sidebar/shortcutmenu/_index.en.md +++ b/exampleSite/content/configuration/sidebar/shortcutmenu/_index.en.md @@ -132,7 +132,7 @@ When using a multilingual website, you can set different menus for each language If you have shortcuts to pages inside of your project and you don't want them to show up in your navigation menu, you have two choices: -1. Make the page file for the shortcut a [headless branch bundle](https://gohugo.io/content-management/page-bundles/#headless-bundle) (contained in its own subdirectory and called `_index.md`) and add the following frontmatter configuration to the file (see exampleSite's `content/showcase/_index.en.md`). This causes its content to **not** be contained in the sitemap. +1. Make the page file for the shortcut a [headless branch bundle](https://gohugo.io/content-management/page-bundles/#headless-bundle) (contained in its own subdirectory and called `_index.md`) and add the following front matter configuration to the file (see exampleSite's `content/showcase/_index.en.md`). This causes its content to **not** be contained in the sitemap. {{< multiconfig fm=true file="content/showcase/_index.en.md" >}} title = "Showcase" @@ -142,7 +142,7 @@ If you have shortcuts to pages inside of your project and you don't want them to publishResources = true {{< /multiconfig >}} -2. Store the page file for the shortcut below a parent headless branch bundle and add the following frontmatter to he **parent** (see exampleSite's `content/more/_index.en.md`). **Don't give this page a `title`** as this will cause it to be shown in the breadcrumbs - a thing you most likely don't want. +2. Store the page file for the shortcut below a parent headless branch bundle and add the following front matter to he **parent** (see exampleSite's `content/more/_index.en.md`). **Don't give this page a `title`** as this will cause it to be shown in the breadcrumbs - a thing you most likely don't want. {{< multiconfig fm=true file="content/more/_index.en.md" >}} [_build] diff --git a/exampleSite/content/content/frontmatter/_index.en.md b/exampleSite/content/content/frontmatter/_index.en.md index 7998461256..6fa3e0f73b 100644 --- a/exampleSite/content/content/frontmatter/_index.en.md +++ b/exampleSite/content/content/frontmatter/_index.en.md @@ -39,7 +39,7 @@ The example reflect example values. The defaults can be taken from the [annotate ### Add Icon to a Menu Entry -In the page frontmatter, add a `menuPre` param to insert any HTML code before the menu label. The example below uses the GitHub icon. +In the page front matter, add a `menuPre` param to insert any HTML code before the menu label. The example below uses the GitHub icon. {{< multiconfig fm=true >}} title = "GitHub repo" @@ -93,7 +93,7 @@ You may want to structure your pages in a hierarchical way but don't want to gen To stay with the initial example: Suppose you want `level-one` appear in the sidebar but don't want to generate a page for it. So the entry in the sidebar should not be clickable but should show an expander. -For this, open `content/level-one/_index.md` and add the following frontmatter +For this, open `content/level-one/_index.md` and add the following front matter {{< multiconfig fm=true >}} collapsibleMenu = true diff --git a/exampleSite/content/content/layouts/_index.en.md b/exampleSite/content/content/layouts/_index.en.md index dbc8fb59da..e2ef0956c1 100644 --- a/exampleSite/content/content/layouts/_index.en.md +++ b/exampleSite/content/content/layouts/_index.en.md @@ -3,7 +3,7 @@ title = "Layouts" weight = 2 +++ -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](https://gohugo.io/content/layouts/). These are preconfigured skeleton pages with default frontmatter. +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](https://gohugo.io/content/layouts/). These are preconfigured skeleton pages with default front matter. 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. @@ -60,7 +60,7 @@ The `weight` number will be used to generate the subtitle of the chapter page, s ### Default {#archetypes-default} -A **Default** page is any other content page. If you set an unknown archetype in your frontmatter, this archetype will be used to generate the page. +A **Default** page is any other content page. If you set an unknown archetype in your front matter, this archetype will be used to generate the page. ![Default page](pages-default.png?width=60pc) @@ -92,7 +92,7 @@ If you are in need of further archetypes you can define your own or even redefin ### Template -Define a template file in your project at `archetypes/.md` and make sure it has at least the frontmatter parameter for that archetype like +Define a template file in your project at `archetypes/.md` and make sure it has at least the front matter parameter for that archetype like ````toml {title="<kind>.md"} +++ @@ -110,7 +110,7 @@ hugo new --kind /_index.md To define how your archetypes are rendered, define corresponding partial files in your projects directory `layouts/partials/archetypes/`. -If you use an unknown archetype in your frontmatter, the `default` archetype will be used to generate the page. +If you use an unknown archetype in your front matter, the `default` archetype will be used to generate the page. Related to each archetype, several _hook_ partial files in the form of `.html` can be given inside each archetype directory. If a partial for a specific hook is missing, no output is generated for this hook. diff --git a/exampleSite/content/content/markdown.en.md b/exampleSite/content/content/markdown.en.md index d6e38afadd..0846c81f13 100644 --- a/exampleSite/content/content/markdown.en.md +++ b/exampleSite/content/content/markdown.en.md @@ -722,7 +722,7 @@ Images can also be linked by reference ID to later define the URL location. This ### Image Effects -{{% badge color="#7dc903" icon="fa-fw fas fa-puzzle-piece" %}}Relearn{{% /badge %}} This theme allows additional non-standard formatting by setting query parameter at the end of the image URL. The default [behavior is configurable](configuration/modifications/imageeffects) through your `hugo.toml` or frontmatter parameter. +{{% badge color="#7dc903" icon="fa-fw fas fa-puzzle-piece" %}}Relearn{{% /badge %}} This theme allows additional non-standard formatting by setting query parameter at the end of the image URL. The default [behavior is configurable](configuration/modifications/imageeffects) through your `hugo.toml` or front matter parameter. #### Resizing diff --git a/exampleSite/content/frontmatter/_index.en.md b/exampleSite/content/frontmatter/_index.en.md index 3fa71370ae..1edaa68346 100644 --- a/exampleSite/content/frontmatter/_index.en.md +++ b/exampleSite/content/frontmatter/_index.en.md @@ -1,4 +1,4 @@ +++ -title = "Frontmatter" -singulartitle = "Frontmatter" +title = "Front Matter" +singulartitle = "Front Matter" +++ diff --git a/exampleSite/content/introduction/releasenotes/2/0.en.md b/exampleSite/content/introduction/releasenotes/2/0.en.md index f6e43e67eb..6806ac7ec7 100644 --- a/exampleSite/content/introduction/releasenotes/2/0.en.md +++ b/exampleSite/content/introduction/releasenotes/2/0.en.md @@ -24,7 +24,7 @@ weight = -0 ### New -- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} You can define the expansion state of your menus in the frontmatter. Please see further [documentation](content/frontmatter#override-expand-state-rules-for-menu-entries) for possible values and default behavior. +- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} You can define the expansion state of your menus in the front matter. Please see further [documentation](content/frontmatter#override-expand-state-rules-for-menu-entries) for possible values and default behavior. - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} New partials for defining pre/post content for menu items and the content. See [documentation](configuration/modifications/partials/) for further reading. diff --git a/exampleSite/content/introduction/releasenotes/2/4.en.md b/exampleSite/content/introduction/releasenotes/2/4.en.md index 70a7c2bc40..a81a0643fa 100644 --- a/exampleSite/content/introduction/releasenotes/2/4.en.md +++ b/exampleSite/content/introduction/releasenotes/2/4.en.md @@ -18,6 +18,6 @@ weight = -4 - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} You can define the expansion state of your menus for the whole site by setting the `alwaysopen` option in your `hugo.toml`. Please see further [documentation](content/frontmatter#override-expand-state-rules-for-menu-entries) for possible values and default behavior. -- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} New frontmatter `ordersectionsby` option to change immediate children sorting in menu and `children` shortcode. Possible values are `title` or `weight`. +- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} New front matter `ordersectionsby` option to change immediate children sorting in menu and `children` shortcode. Possible values are `title` or `weight`. - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} Alternate content of a page is now advertised in the HTML meta tags. See [Hugo documentation](https://gohugo.io/templates/rss/#reference-your-rss-feed-in-head). diff --git a/exampleSite/content/introduction/releasenotes/3/2.en.md b/exampleSite/content/introduction/releasenotes/3/2.en.md index b3fb4e70a3..b4af962f1b 100644 --- a/exampleSite/content/introduction/releasenotes/3/2.en.md +++ b/exampleSite/content/introduction/releasenotes/3/2.en.md @@ -16,7 +16,7 @@ weight = -2 - {{% badge style="note" title=" " %}}Change{{% /badge %}} In this release the Mermaid JavaScript library will only be loaded on demand if the page contains a Mermaid shortcode or is using Markdown codefences. This changes the behavior of `disableMermaid` config option as follows: If a Mermaid shortcode or Markdown codefence is found, the option will be ignored and Mermaid will be loaded regardlessly. - The option is still useful in case you are using scripting to set up your graph. In this case no shortcode or Markdown codefence is involved and the library is not loaded by default. In this case you can set `disableMermaid=false` in your frontmatter to force the library to be loaded. See the [theme variant generator](configuration/appearance/generator) of the exampleSite for an example. + The option is still useful in case you are using scripting to set up your graph. In this case no shortcode or Markdown codefence is involved and the library is not loaded by default. In this case you can set `disableMermaid=false` in your front matter to force the library to be loaded. See the [theme variant generator](configuration/appearance/generator) of the exampleSite for an example. ### New diff --git a/exampleSite/content/introduction/releasenotes/5/0.en.md b/exampleSite/content/introduction/releasenotes/5/0.en.md index 31b52ae6ed..2af38a038f 100644 --- a/exampleSite/content/introduction/releasenotes/5/0.en.md +++ b/exampleSite/content/introduction/releasenotes/5/0.en.md @@ -24,12 +24,12 @@ weight = -0 - for your home page, add the frontmatter parameter `archetype = "home"` and remove the leading heading - - for all files containing the deprecated frontmatter parameter `chapter = true`, replace it with `archetype = "chapter"` and remove the leading headings + - for all files containing the deprecated front matter parameter `chapter = true`, replace it with `archetype = "chapter"` and remove the leading headings - {{% badge style="note" title=" " %}}Change{{% /badge %}} The frontmatter options `pre` / `post` were renamed to `menuPre` / `menuPost`. The old options will still be used if the new options aren't set. Therefore you don't need to change anything after the upgrade. ### New -- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} Adding new partials `heading-pre.html` / `heading-post.html` and according frontmatter options `headingPre` / `headingPost` to modify the way your page`s main heading gets styled. +- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} Adding new partials `heading-pre.html` / `heading-post.html` and according front matter options `headingPre` / `headingPost` to modify the way your page`s main heading gets styled. - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The new shortcode `math` is available to add beautiful math and chemical formulae. See the [documentation](shortcodes/math) for available features. This feature will not work with Internet Explorer 11. diff --git a/exampleSite/content/introduction/releasenotes/5/20.en.md b/exampleSite/content/introduction/releasenotes/5/20.en.md index bad6a71ba6..0f94a14f5d 100644 --- a/exampleSite/content/introduction/releasenotes/5/20.en.md +++ b/exampleSite/content/introduction/releasenotes/5/20.en.md @@ -33,7 +33,7 @@ weight = -20 For existing variants nothing has changed visually. -- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The default values for the [image effects](content/markdown#image-effects) are [now configurable](configuration/modifications/imageeffects) for your whole site via `hugo.toml` or for each page through frontmatter. +- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The default values for the [image effects](content/markdown#image-effects) are [now configurable](configuration/modifications/imageeffects) for your whole site via `hugo.toml` or for each page through front matter. - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} This release fixes a long-standing bug where Mermaid graphs could not be displayed if they were initially hidden - like in collapsed `expand` or inactive `tabs`. diff --git a/exampleSite/content/introduction/releasenotes/5/22.en.md b/exampleSite/content/introduction/releasenotes/5/22.en.md index e90eab7446..8517c312f7 100644 --- a/exampleSite/content/introduction/releasenotes/5/22.en.md +++ b/exampleSite/content/introduction/releasenotes/5/22.en.md @@ -20,11 +20,11 @@ weight = -22 This feature may require you to make changes to your existing installation if you are already using _[shortcuts to pages inside of your project](configuration/sidebar/shortcutmenu/#how-to-display-pages-only-in-the-shortcuts-menu)_ with a _headless branch parent_. - In this case it is advised to remove the `title` from the headless branch parent's frontmatter, as it will otherwise appear in your breadcrumbs. + In this case it is advised to remove the `title` from the headless branch parent's front matter, as it will otherwise appear in your breadcrumbs. ### New -- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} It is now possible to overwrite the setting for `collapsibleMenu` of your `hugo.toml` inside of a page's frontmatter. +- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} It is now possible to overwrite the setting for `collapsibleMenu` of your `hugo.toml` inside of a page's front matter. - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} If a Mermaid graph is zoomable a button to reset the view is now added to the upper right corner. The button is only shown once the mouse is moved over the graph. diff --git a/exampleSite/content/introduction/releasenotes/5/24.en.md b/exampleSite/content/introduction/releasenotes/5/24.en.md index b9cad0ce00..d23ac211b9 100644 --- a/exampleSite/content/introduction/releasenotes/5/24.en.md +++ b/exampleSite/content/introduction/releasenotes/5/24.en.md @@ -16,7 +16,7 @@ weight = -24 - {{% badge style="note" title=" " %}}Change{{% /badge %}} The topbar button received a way to add text next to the icon. For this, the original `title` option was renamed to `hint` while the new `title` option is now displayed next to the icon. -- {{% badge style="note" title=" " %}}Change{{% /badge %}} The frontmatter option `menuTitle` is now deprecated in favor for Hugo's own `linkTitle`. You don't need to change anything as the old `menuTitle` option is still supported. +- {{% badge style="note" title=" " %}}Change{{% /badge %}} The front matter option `menuTitle` is now deprecated in favor for Hugo's own `linkTitle`. You don't need to change anything as the old `menuTitle` option is still supported. - {{% badge style="note" title=" " %}}Change{{% /badge %}} The light themes have a bit more contrast for content text and headings. Also the syntaxhighlighting was changed to the more colorful MonokaiLight. This brings the syntaxhighlighting in sync with the corresponding dark theme variants, which are using Monokai. If you dislike this, you can create your own color variant file as [described here](configuration/appearance/branding#modify-shipped-variants). @@ -42,9 +42,9 @@ weight = -24 - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} Improvements for accessibility when tabbing through the page for images, links and tab handles. -- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The `editURL` config parameter is now [overwritable in your pages frontmatter](content/frontmatter). In addition it received more versatility by letting you control where to put the file path into the URL. This is achieved by replacing the variable `${FilePath}` in your URL by the pages file path. You don't need to change anything in your existing configuration as the old way without the replacement variable still works. +- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The `editURL` config parameter is now [overwritable in your pages front matter](content/frontmatter). In addition it received more versatility by letting you control where to put the file path into the URL. This is achieved by replacing the variable `${FilePath}` in your URL by the pages file path. You don't need to change anything in your existing configuration as the old way without the replacement variable still works. -- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The themes [config](configuration/options) and [frontmatter](content/frontmatter) options received a comprehensive documentation update. In addition the theme switched from `config.toml` to `hugo.toml`. +- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The themes [config](configuration/options) and [front matter](content/frontmatter) options received a comprehensive documentation update. In addition the theme switched from `config.toml` to `hugo.toml`. - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} Restored compatibility with Hugo versions {{% badge color="fuchsia" icon="fa-fw fab fa-hackerrank" title=" " %}}0.121.0{{% /badge %}} or higher for the [`highlight` shortcode](shortcodes/highlight). This does not change the minimum required Hugo version. diff --git a/exampleSite/content/introduction/releasenotes/5/27.en.md b/exampleSite/content/introduction/releasenotes/5/27.en.md index f4ded92f40..8ded034116 100644 --- a/exampleSite/content/introduction/releasenotes/5/27.en.md +++ b/exampleSite/content/introduction/releasenotes/5/27.en.md @@ -30,4 +30,4 @@ weight = -27 - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} You now can scroll forward and backward through all headings of a page by using ALT 🡑 and ALT 🡓. This also works for the `PRINT` output format. -- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The breadcrumbs used in the topbar, search results and the taxonomy term lists are now using the pages frontmatter `linktitle` instead of `title` if set. +- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The breadcrumbs used in the topbar, search results and the taxonomy term lists are now using the pages front matter `linktitle` instead of `title` if set. diff --git a/exampleSite/content/introduction/releasenotes/5/9.en.md b/exampleSite/content/introduction/releasenotes/5/9.en.md index 17f87c1674..f4fba32b8f 100644 --- a/exampleSite/content/introduction/releasenotes/5/9.en.md +++ b/exampleSite/content/introduction/releasenotes/5/9.en.md @@ -16,7 +16,7 @@ weight = -9 To [get rid](configuration/sidebar/shortcutmenu/#how-to-display-pages-only-in-the-shortcuts-menu) of this undesired behavior you have two choices: - 1. Make the page file a [headless branch bundle](https://gohugo.io/content-management/page-bundles/#headless-bundle) (contained in its own subdirectory and called `_index.md`) and add the following frontmatter configuration to the file (see exampleSite's `content/showcase/_index.en.md`). This causes its content to **not** be ontained in the sitemap. + 1. Make the page file a [headless branch bundle](https://gohugo.io/content-management/page-bundles/#headless-bundle) (contained in its own subdirectory and called `_index.md`) and add the following front matter configuration to the file (see exampleSite's `content/showcase/_index.en.md`). This causes its content to **not** be ontained in the sitemap. {{< multiconfig fm=true >}} title = "Showcase" @@ -26,7 +26,7 @@ weight = -9 publishResources = true {{< /multiconfig >}} - 2. Store the page file for below a parent headless branch bundle and add the following frontmatter to he **parent** (see exampleSite's `content/more/_index.en.md`). **Don't give this page a `title`** as this will cause it to be shown in the breadcrumbs - a thing you most likely don't want. + 2. Store the page file for below a parent headless branch bundle and add the following front matter to he **parent** (see exampleSite's `content/more/_index.en.md`). **Don't give this page a `title`** as this will cause it to be shown in the breadcrumbs - a thing you most likely don't want. {{< multiconfig fm=true >}} [_build] diff --git a/exampleSite/content/introduction/releasenotes/6/0.en.md b/exampleSite/content/introduction/releasenotes/6/0.en.md index a48701a4fb..a251429c60 100644 --- a/exampleSite/content/introduction/releasenotes/6/0.en.md +++ b/exampleSite/content/introduction/releasenotes/6/0.en.md @@ -26,13 +26,13 @@ weight = -0 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. - For migration, move the `description` parameter of your `hugo.toml` into the frontmatter section of your home page. + For migration, move the `description` parameter of your `hugo.toml` into the front matter section of your home page. - {{% badge style="warning" title=" " %}}Breaking{{% /badge %}} Search support for the `json` outputformat [deprecated in 5.4.0](introduction/releasenotes/5/#5-4-0) was removed. Change it to `search` for the homepage in your `hugo.toml`. See the docs for [detailed configuration](configuration/sidebar/search/). -- {{% badge style="warning" title=" " %}}Breaking{{% /badge %}} The frontmatter option `menuTitle` [deprecated in 5.24.0](introduction/releasenotes/5/#5-24-0) was removed in favor for Hugo's own `linkTitle`. +- {{% badge style="warning" title=" " %}}Breaking{{% /badge %}} The front matter option `menuTitle` [deprecated in 5.24.0](introduction/releasenotes/5/#5-24-0) was removed in favor for Hugo's own `linkTitle`. Additionally, if set, `linkTitle` will now be used instead of `title` to generate the breadcrumb. diff --git a/exampleSite/content/introduction/releasenotes/6/1.en.md b/exampleSite/content/introduction/releasenotes/6/1.en.md index 2e2aa4a085..a78aa9f527 100644 --- a/exampleSite/content/introduction/releasenotes/6/1.en.md +++ b/exampleSite/content/introduction/releasenotes/6/1.en.md @@ -18,7 +18,7 @@ weight = -1 - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The [`openapi` shortcode](shortcodes/openapi) 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 `openapi.errorlevel` to either `warning` or `error` in your `hugo.toml` if a path can not be resolved. -- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} Shortcodes supporting an `errorlevel` configuration can now have overridden values in the [frontmatter](content/frontmatter/) section of each individual page. +- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} Shortcodes supporting an `errorlevel` configuration can now have overridden values in the [front matter](content/frontmatter/) section of each individual page. - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The theme now comes with its own overridden version of the `relref` shortcode. diff --git a/exampleSite/content/shortcodes/children/_index.en.md b/exampleSite/content/shortcodes/children/_index.en.md index 8e7e33cbe7..3ab212ce81 100644 --- a/exampleSite/content/shortcodes/children/_index.en.md +++ b/exampleSite/content/shortcodes/children/_index.en.md @@ -39,7 +39,7 @@ The `children` shortcode lists the child pages of the current page and its desce | **showhidden** | `false` | When `true`, child pages hidden from the menu will be displayed as well. | | **description** | `false` | When `true` shows a short text under each page in the list. When no description or summary exists for the page, the first 70 words of the content is taken - [read more info about summaries on gohugo.io](https://gohugo.io/content/summaries/). | | **depth** | `1` | The depth of descendants to display. For example, if the value is `2`, the shortcode will display two levels of child pages. To get all descendants, set this value to a high number eg. `999`. | -| **sort** | `auto` | The sort criteria of the displayed list.

- `auto` defaults to [`ordersectionsby` of the pages frontmatter](content/frontmatter)
    or to [`ordersectionsby` of the site configuration](configuration/options)
    or to `weight`
- `weight`
- `title`
- `linktitle`
- `modifieddate`
- `expirydate`
- `publishdate`
- `date`
- `length`
- `default` adhering to Hugo's default sort criteria| +| **sort** | `auto` | The sort criteria of the displayed list.

- `auto` defaults to [`ordersectionsby` of the pages front matter](content/frontmatter)
    or to [`ordersectionsby` of the site configuration](configuration/options)
    or to `weight`
- `weight`
- `title`
- `linktitle`
- `modifieddate`
- `expirydate`
- `publishdate`
- `date`
- `length`
- `default` adhering to Hugo's default sort criteria| ## Examples diff --git a/exampleSite/content/shortcodes/highlight.en.md b/exampleSite/content/shortcodes/highlight.en.md index bcc9bcb757..5dfe124f36 100644 --- a/exampleSite/content/shortcodes/highlight.en.md +++ b/exampleSite/content/shortcodes/highlight.en.md @@ -85,7 +85,7 @@ The [`tab` shortcode](shortcodes/tab/) is also capable of displaying code but wi |-----------------------|--------- | -----------------|-------------| | **type** | 1 | _<empty>_ | The language of the code to highlight. Choose from one of the [supported languages](https://gohugo.io/content-management/syntax-highlighting/#list-of-chroma-highlighting-languages). Case-insensitive. | | **title** | | _<empty>_ | **Extension**. Arbitrary title for code. This displays the code like a [single tab](shortcodes/tab) if `hl_inline=false` (which is Hugo's default). | -| **wrap** | | see notes | **Extension**. When `true` the content may wrap on long lines otherwise it will be scrollable.

The default value can be set in your `hugo.toml` and overwritten via frontmatter. [See below](#setting-wrap-of-long-lines). | +| **wrap** | | see notes | **Extension**. When `true` the content may wrap on long lines otherwise it will be scrollable.

The default value can be set in your `hugo.toml` and overwritten via front matter. [See below](#setting-wrap-of-long-lines). | | **options** | 2 | _<empty>_ | An optional, comma-separated list of zero or more [Hugo supported options](https://gohugo.io/functions/highlight/#options) as well as extension parameter from this table. | | _**<option>**_ | | _<empty>_ | Any of [Hugo's supported options](https://gohugo.io/functions/highlight/#options). | | _**<content>**_ | | _<empty>_ | Your code to highlight. | diff --git a/exampleSite/content/shortcodes/mermaid.en.md b/exampleSite/content/shortcodes/mermaid.en.md index 0f1f179016..a009c7fe9b 100644 --- a/exampleSite/content/shortcodes/mermaid.en.md +++ b/exampleSite/content/shortcodes/mermaid.en.md @@ -60,7 +60,7 @@ Codefence syntax is widely available in other Markdown parsers like GitHub and t | Name | Default | Notes | |-----------------------|------------------|-------------| | **align** | `center` | The vertical alignment.

Allowed values are `left`, `center` or `right`. | -| **zoom** | see notes | Whether the graph is pan- and zoomable.

If not set the value is determined by the [`mermaidZoom` setting](#configuring-pan-and-zoom) of your configurations options or the pages frontmatter or `false` if not set at all.

- `false`: no pan or zoom
- `true`: pan and zoom active | +| **zoom** | see notes | Whether the graph is pan- and zoomable.

If not set the value is determined by the [`mermaidZoom` setting](#configuring-pan-and-zoom) of your configurations options or the pages front matter or `false` if not set at all.

- `false`: no pan or zoom
- `true`: pan and zoom active | | _**<content>**_ | _<empty>_ | Your Mermaid graph. | ## Settings diff --git a/exampleSite/content/tags/the-hidden/_index.en.md b/exampleSite/content/tags/the-hidden/_index.en.md index 8a88e3c256..6f22b47eeb 100644 --- a/exampleSite/content/tags/the-hidden/_index.en.md +++ b/exampleSite/content/tags/the-hidden/_index.en.md @@ -2,7 +2,7 @@ title = "a secret" +++ -This lists all pages that are hidden from the home page. This includes pages that define `hidden=true` in their frontmatter as well as descendents of hidden pages. +This lists all pages that are hidden from the home page. This includes pages that define `hidden=true` in their front matter as well as descendents of hidden pages. When giving term pages, you should give it a title. Otherwise it will print out a warning and will use the urlized title, which may looks weird. diff --git a/layouts/_default/baseof.html b/layouts/_default/baseof.html index f153cd72c0..de03d8838b 100644 --- a/layouts/_default/baseof.html +++ b/layouts/_default/baseof.html @@ -7,7 +7,7 @@ {{- end }} {{- end }} {{- if .Site.Params.description }} - {{- warnf "UNSUPPORTED usage of 'params.description' config parameter found, move it to the frontmatter of your home page; see https://mcshelby.github.io/hugo-theme-relearn/introduction/releasenotes/6/#6-0-0" }} + {{- warnf "UNSUPPORTED usage of 'params.description' config parameter found, move it to the front matter of your home page; see https://mcshelby.github.io/hugo-theme-relearn/introduction/releasenotes/6/#6-0-0" }} {{- end }} diff --git a/layouts/partials/title.gotmpl b/layouts/partials/title.gotmpl index c2c2c2c2a6..606b223285 100644 --- a/layouts/partials/title.gotmpl +++ b/layouts/partials/title.gotmpl @@ -1,7 +1,7 @@ {{- $title := "" }} {{- with .page }} {{- if .Params.menuTitle }} - {{- warnf "%q: UNSUPPORTED frontmatter 'menutitle' found, use 'linktitle' instead; see https://mcshelby.github.io/hugo-theme-relearn/introduction/releasenotes/6/#6-0-0" $.File.Filename }} + {{- warnf "%q: UNSUPPORTED front matter 'menutitle' found, use 'linktitle' instead; see https://mcshelby.github.io/hugo-theme-relearn/introduction/releasenotes/6/#6-0-0" $.File.Filename }} {{- end }} {{- $siteTitle := site.Title }} {{- $title = .Title }}