From 280b2f294ea2a973f61327ac680b36596730bce1 Mon Sep 17 00:00:00 2001 From: Cameron Moore Date: Wed, 9 Dec 2015 10:25:50 -0600 Subject: [PATCH] Document PreserveTaxonomyNames Fixes #1648 --- docs/content/overview/configuration.md | 4 +++- docs/content/taxonomies/usage.md | 14 +++++++++++++- 2 files changed, 16 insertions(+), 2 deletions(-) diff --git a/docs/content/overview/configuration.md b/docs/content/overview/configuration.md index fba39d13c..7047eb550 100644 --- a/docs/content/overview/configuration.md +++ b/docs/content/overview/configuration.md @@ -115,7 +115,9 @@ Following is a list of Hugo-defined variables that you can configure and their c paginatePath: "page" permalinks: # Pluralize titles in lists using inflect - pluralizeListTitles: true + pluralizeListTitles: true + # Preserve special characters in taxonomy names ("Gérard Depardieu" vs "Gerard Depardieu") + preserveTaxonomyNames: false publishdir: "public" # color-codes for highlighting derived from this style pygmentsStyle: "monokai" diff --git a/docs/content/taxonomies/usage.md b/docs/content/taxonomies/usage.md index ce717f3fc..963daf9dc 100644 --- a/docs/content/taxonomies/usage.md +++ b/docs/content/taxonomies/usage.md @@ -53,7 +53,19 @@ Assigning content to an taxonomy is done in the front matter. Simply create a variable with the *plural* name of the taxonomy and assign all terms you want to apply to this content. -**taxonomy values are case insensitive** +## Preserving taxonomy values + +By default, taxonomy names are hyphenated, lower-cased and normalized, and then +fixed and titleized on the archive page. + +However, if you want to have a taxonomy value with special characters +such as `Gérard Depardieu` instead of `Gerard Depardieu`, +you need to set the `preserveTaxonomyNames` [site configuration](/overview/configuration/) variable to `true`. +Hugo will then preserve special characters in taxonomy values +but will still titleize the values for titles and 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. ### Front Matter Example (in TOML)