diff options
author | Thomas Jost <schnouki@schnouki.net> | 2018-09-06 15:45:29 +0200 |
---|---|---|
committer | Bjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com> | 2018-09-06 20:29:21 +0200 |
commit | be3ae3ec92da972a55112af39ce2e1c45121b9a5 (patch) | |
tree | 1803d19915b15c8a1a9d83e9b0a795b6f7b15390 /docs/content | |
parent | 2cf8fe2ea218d37776af72893691e772737750e3 (diff) |
hugolib: Do not FirstUpper taxonomy titles
Doing so was probably a mistake. This may be a breaking change for some people,
but it's easy to restore the previous behaviour in the layouts.
Fixes #5172
Diffstat (limited to 'docs/content')
-rw-r--r-- | docs/content/en/content-management/taxonomies.md | 9 |
1 files changed, 8 insertions, 1 deletions
diff --git a/docs/content/en/content-management/taxonomies.md b/docs/content/en/content-management/taxonomies.md index 629fab94d..8260cfc1f 100644 --- a/docs/content/en/content-management/taxonomies.md +++ b/docs/content/en/content-management/taxonomies.md @@ -139,7 +139,7 @@ If you want to disable all taxonomies altogether, see the use of `disableKinds` By default, taxonomy names are normalized. -Therefore, if you want to have a taxonomy term with special characters such as `Gérard Depardieu` instead of `Gerard Depardieu`, set the value for `preserveTaxonomyNames` to `true` in your [site config][config]. Hugo will then preserve special characters in taxonomy values but will still title-ize the values for titles and normalize them in URLs. +Therefore, if you want to have a taxonomy term with special characters such as `Gérard Depardieu` instead of `Gerard Depardieu`, set the value for `preserveTaxonomyNames` to `true` in your [site config][config]. Hugo will then preserve special characters in taxonomy values but will still normalize them in URLs. Note that if you use `preserveTaxonomyNames` and intend to manually construct URLs to the archive pages, you will need to pass the taxonomy values through the [`urlize` template function][]. @@ -149,6 +149,12 @@ You can add content and front matter to your taxonomy list and taxonomy terms pa Much like regular pages, taxonomy list [permalinks](/content-management/urls/) are configurable, but taxonomy term page permalinks are not. {{% /note %}} +{{% warning "`preserveTaxonomyNames` behaviour change" %}} +Before 0.49, Hugo would title-ize the taxonomy values for titles even if `preserveTaxonomyNames` was active. This no longer the case, which (for instance) makes it possible to have fully lower-case values. + +If you actually need to title-ize these values, you can do so using the [`title` template function][]. +{{% /warning %}} + ## Add Taxonomies to Content Once a taxonomy is defined at the site level, any piece of content can be assigned to it, regardless of [content type][] or [content section][]. @@ -205,6 +211,7 @@ If you need to add custom metadata to your taxonomy terms, you will need to crea You can later use your custom metadata as shown in the [Taxonomy Terms Templates documentation](/templates/taxonomy-templates/#displaying-custom-metadata-in-taxonomy-terms-templates). +[`title` template function]: /functions/title/ [`urlize` template function]: /functions/urlize/ [content section]: /content-management/sections/ [content type]: /content-management/types/ |