docs: honing #567

exampleSite/content/configuration/content/linking/index.en.md

@@ -7,7 +7,7 @@ weight = 4
 
 ## Opening Links
 
-By default, external links open in a new tab. To change this, use the `externalLinkTarget` setting with a proper [link target](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#target).
+{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} By default, external links open in a new tab. To change this, use the `externalLinkTarget` setting with a proper [link target](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#target).
 
 For example, this will open links in the same tab
 
@@ -34,7 +34,7 @@ This option also comes for the [include](shortcodes/include#enabling-link-warnin
 
 ## Patching the `relref` Shortcode
 
-While the usage of `relref` is obsolete and discouraged by Hugo for a while, existing installations may still use it.
+{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} While the usage of `relref` is obsolete and discouraged by Hugo for a while, existing installations may still use it.
 
 In configurations using a baseURL **with** a subdirectory **and** having `relativeURLs=false` (the default) Hugo’s standard `relref` implementation was failing.
 

exampleSite/content/configuration/content/titles/index.en.md

@@ -5,12 +5,26 @@ title = "Titles & Breadcrumbs"
 weight = 2
 +++
 
+## Breadcrumbs
+
 {{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} Set `disableRootBreadcrumb=true` to remove the root breadcrumb which often feels redundant. This will also apply to the breadcrumbs of the search results and taxonomy pages.
 
-{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} Further, you can override the breadcrumb separator by using `breadcrumbSeparator='/'`. This separator will also be used in the breadcrumbs of the search results and taxonomy pages.
+{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} You can override the default breadcrumb separator by using `breadcrumbSeparator='/'`. This separator will also be used in the breadcrumbs of the search results and taxonomy pages.
+
+{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} By default the term pages of a taxonomy will display the breadcrumb for each page. Set `disableTermBreadcrumbs=true` to remove the breadcrumb if the term pages look to cluttered.
 
 {{< multiconfig file=hugo >}}
 [params]
   disableRootBreadcrumb = true
   breadcrumbSeparator = '/'
+  disableTermBreadcrumbs = true
+{{< /multiconfig >}}
+
+## Titles
+
+{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} You can override the default title separator by using `titleSeparator='|'`.
+
+{{< multiconfig file=hugo >}}
+[params]
+  titleSeparator = '|'
 {{< /multiconfig >}}

exampleSite/content/configuration/customization/_index.en.md

@@ -1,6 +1,6 @@
 +++
 alwaysopen = false
-description = "Customize files for advanced customization"
+description = "Customize files for advanced usage"
 title = "Customization"
 weight = 5
 +++

exampleSite/content/configuration/customization/_index.pir.md

@@ -1,6 +1,6 @@
 +++
 alwaysopen = false
-description = "Customize files for advanced customization"
+description = "Customize files for advanced usage"
 title = "Customization"
 weight = 5
 +++

exampleSite/content/configuration/options/_index.en.md

@@ -1,5 +1,5 @@
 +++
-description = "Configuration options for the Relearn theme"
+description = "All configuration options for the Relearn theme"
 tags = ["reference"]
 title = "Options Reference"
 weight = 6

exampleSite/content/configuration/options/_index.pir.md

@@ -1,5 +1,5 @@
 +++
-description = "Configuration options for the Relearn theme"
+description = "All configuration options for the Relearn theme"
 tags = ["reference"]
 title = "Options Reference"
 weight = 6

exampleSite/content/configuration/sitemanagement/meta/_index.en.md

@@ -1,12 +1,14 @@
 +++
 description = "What site-wide meta nformation can be set"
+frontmatter = ["description"]
+options = ["author.email", "author.name"]
 title = "Meta Information"
 weight = 3
 +++
 
 ## Site Author Information
 
-The theme uses author details in various parts of your site, like RSS feeds and meta tags.
+{{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} The theme uses author details in various parts of your site, like RSS feeds and meta tags.
 
 {{< multiconfig file=hugo >}}
 [params]
@@ -17,7 +19,7 @@ The theme uses author details in various parts of your site, like RSS feeds and
 
 ## Site Description
 
-The theme shows a site description in various places, such as RSS feeds and meta tags. For this, it uses the `description` field from your home page's front matter.
+{{% badge style="green" icon="fa-fw fab fa-markdown" title=" " %}}Front Matter{{% /badge %}} The theme shows a site description in various places, such as RSS feeds and meta tags. For this, it uses the `description` field from your home page's front matter.
 
 ## Social Media Images
 

exampleSite/content/introduction/releasenotes/7/0.en.md

@@ -19,7 +19,7 @@ weight = -0
   - suffered from poor build performance for sites with 1000 or more pages
   - reinvented the wheel instead of using available Hugo mechanisms
 
-  _What do I gain_, you may ask. A significant performance boost during build! Usually, the build time has been cut at least in half for bigger sites. It is now possible to build even larger sites with 5000 or more pages. This was previously almost impossible due to rapidly increasing build time with the more pages you've introduced. For even bigger sites, the theme now has configurable performance optimizations (at the price of feature limitations).
+  _What do I gain_, you may ask. A significant performance boost during build! Usually, the build time has been cut at least in half for bigger sites. It is now possible to build even larger sites with 5000 or more pages. This was previously almost impossible due to rapidly increasing build time with the more pages you've introduced. For even bigger sites, the theme now has [configurable performance optimizations](configuration/sidebar/navigationmenu#expander-for-nested-sections) - at the price of feature limitations.
 
   If you haven't done customizations to any partials, you can update right away.
 
@@ -27,12 +27,10 @@ weight = -0
 
   Specifically, you will have to adapt your site if you have
 
-  - overwritten the `header.html`, `menu.html` or `footer.html` partials
-  - self-defined output formats that display HTML
-  - defined archetype partials in `layouts/partials/archetypes`
-  - overwritten prev/next topbar buttons
-
-  There is a separate section in the documentation covering these cases.
+  - [overwritten the `header.html`, `menu.html` or `footer.html` partials](configuration/customization/partials)
+  - [self-defined output formats](configuration/customization/outputformats) that display HTML
+  - defined archetype partials in `layouts/partials/archetypes` - now becoming [page designs](configuration/customization/designs)
+  - [overwritten prev/next topbar buttons](configuration/customization/topbar) - needs sync with the implementation changes
 
 - {{% badge style="warning" title=" " %}}Breaking{{% /badge %}} This release changes the way the search index and the dedicated search page are generated. This may require reconfiguration by you to still work as you have intended.
 
@@ -79,11 +77,12 @@ weight = -0
 
   The docs now clearly differentiate between [configuration of your site](configuration), all things [writing page content](content) and the [shortcodes docs](shortcodes) that cover both topics, configuration and usage.
 
-  To give you a better overview of what's possible with the theme, we introduced reference pages for all theme [configuration options](configuration/options) and [front matter](content/frontmatter) and mark each occurrence of such on all pages with badges {{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} and {{% badge style="green" icon="fa-fw fab fa-markdown" title=" " %}}Front Matter{{% /badge %}}.
+  To give you a better overview of what's possible with the theme, we introduced reference pages for all theme [configuration options](configuration/options) and [front matter](content/frontmatter) and mark each occurrence of such on all pages with the badges {{% badge style="cyan" icon="gears" title=" " %}}Option{{% /badge %}} and {{% badge style="green" icon="fa-fw fab fa-markdown" title=" " %}}Front Matter{{% /badge %}}.
 
   Also, a lot of previously undocumented features are now included, namely
 
   - the [hidden pages](configuration/content/hidden) feature
   - options of the [navigation menu](configuration/sidebar/navigationmenu)
-  - configuring the [headings](configuration/content/headings) of your content
+  - configuring [breadcrumb, titles](configuration/content/titles) and [headings](configuration/content/headings) of your content
+  - [options for using links](configuration/content/linking)
   - adding [custom output formats](configuration/customization/outputformats)