From 689e957d5bc63b19eb0fb1e82d9f581f97d06f2c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=B6ren=20Weber?= Date: Fri, 19 May 2023 22:42:51 +0200 Subject: [PATCH] docs: clarify tags positioning #513 --- exampleSite/content/basics/migration/_index.en.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/exampleSite/content/basics/migration/_index.en.md b/exampleSite/content/basics/migration/_index.en.md index ce70764c41..8a17e8ac87 100644 --- a/exampleSite/content/basics/migration/_index.en.md +++ b/exampleSite/content/basics/migration/_index.en.md @@ -24,17 +24,17 @@ This document shows you what's new in the latest release. For a detailed list of Hugo's default taxonmies `tags` and `categories` are already contained in the theme's i18n files. If you have self-defined taxonomies, you can add translations by adding them to your own i18n files. If you don't provide translations, the singualar and plural forms are taken as configured in your `config.toml`. -- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The new parameter `breadcrumbSeparator` is now available in your `config.toml` to change the - well - separator of the breadcrumb items. An appropriate default is in place if you do not configure anything. - - {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} To give you more flexibility in customizing your article layout a new partial `content-header.html` is introduced. - This came out of the requirement to customize the position of article tags, which by default is displayed above the title. A second requirement was to also show additional [taxonomies](https://gohugo.io/content-management/taxonomies/) not supported by the theme nativly. While Hugo supports tags and categories by default, the theme only displays tags. + This came out of the requirement to customize the position of article tags, which by default are displayed above the title. A second requirement was to also show additional [taxonomies](https://gohugo.io/content-management/taxonomies/) not supported by the theme natively. While Hugo supports tags and categories by default, the theme only displays tags. - So how does it work starting from the theme's default where tags are only shown above the title? + So how to adjust the position of tags starting from the theme's default where tags are only shown above the title? 1. Hide tags above title: Overwrite `content-header.html` with an empty file. - 2. Show tags below title: Overwrite `heading-post.html` and add `{{- partial "tags.html" . }}` to it. - 3. Show tags below article: Overwrite `content-footer.html` and add `{{- partial "tags.html" . }}` to it. + 2. Show tags between title and content: Overwrite `heading-post.html` and add `{{- partial "tags.html" . }}` to it. + 3. Show tags below content: Overwrite `content-footer.html` and add `{{- partial "tags.html" . }}` to it. + +- {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} The new parameter `breadcrumbSeparator` is now available in your `config.toml` to change the - well - separator of the breadcrumb items. An appropriate default is in place if you do not configure anything. ---