Merge commit '87de22d7464e239c775fbd48ebce1665d5b1e80d'

docs/content/en/content-management/taxonomies.md

@@ -12,7 +12,7 @@ weight: 150
 aliases: [/taxonomies/overview/,/taxonomies/usage/,/indexes/overview/,/doc/indexes/,/extras/indexes]
 ---
 
-## What is a Taxonomy?
+## What is a taxonomy?
 
 Hugo includes support for user-defined groupings of content called **taxonomies**. Taxonomies are classifications of logical relationships between content.
 
@@ -28,7 +28,7 @@ Value
 : a piece of content assigned to a term
 
 
-## Example Taxonomy: Movie Website
+## Example taxonomy: movie website
 
 Let's assume you are making a website about movies. You may want to include the following taxonomies:
 
@@ -41,7 +41,7 @@ Let's assume you are making a website about movies. You may want to include the
 
 Then, in each of the movies, you would specify terms for each of these taxonomies (i.e., in the [front matter] of each of your movie content files). From these terms, Hugo would automatically create pages for each Actor, Director, Studio, Genre, Year, and Award, with each listing all of the Movies that matched that specific Actor, Director, Studio, Genre, Year, and Award.
 
-### Movie Taxonomy Organization
+### Movie taxonomy organization
 
 To continue with the example of a movie site, the following demonstrates content relationships from the perspective of the taxonomy:
 
@@ -76,11 +76,11 @@ Moonrise Kingdom            <- Value
     ...
 ```
 
-## Hugo Taxonomy Defaults {#default-taxonomies}
+## Default taxonomies
 
 Hugo natively supports taxonomies.
 
-Without adding a single line to your [site config][config] file, Hugo will automatically create taxonomies for `tags` and `categories`. That would be the same as manually [configuring your taxonomies](#configure-taxonomies) as below:
+Without adding a single line to your [site configuration] file, Hugo will automatically create taxonomies for `tags` and `categories`. That would be the same as manually [configuring your taxonomies](#configure-taxonomies) as below:
 
 {{< code-toggle file="hugo" copy=false >}}
 [taxonomies]
@@ -88,7 +88,7 @@ Without adding a single line to your [site config][config] file, Hugo will autom
   category = "categories"
 {{</ code-toggle >}}
 
-If you do not want Hugo to create any taxonomies, set `disableKinds` in your [site config][config] to the following:
+If you do not want Hugo to create any taxonomies, set `disableKinds` in your [site configuration] to the following:
 
 {{< code-toggle file="hugo" copy=false >}}
 disableKinds = ["taxonomy","term"]
@@ -96,18 +96,18 @@ disableKinds = ["taxonomy","term"]
 
 {{% page-kinds %}}
 
-### Default Destinations
+### Default destinations
 
 When taxonomies are used---and [taxonomy templates] are provided---Hugo will automatically create both a page listing all the taxonomy's terms and individual pages with lists of content associated with each term. For example, a `categories` taxonomy declared in your configuration and used in your content front matter will create the following pages:
 
 * A single page at `example.com/categories/` that lists all the [terms within the taxonomy]
 * [Individual taxonomy list pages][taxonomy templates] (e.g., `/categories/development/`) for each of the terms that shows a listing of all pages marked as part of that taxonomy within any content file's [front matter]
 
-## Configure Taxonomies
+## Configure taxonomies
 
-Custom taxonomies other than the [defaults](#default-taxonomies) must be defined in your [site config][config] before they can be used throughout the site. You need to provide both the plural and singular labels for each taxonomy. For example, `singular key = "plural value"` for TOML and `singular key: "plural value"` for YAML.
+Custom taxonomies other than the [defaults](#default-taxonomies) must be defined in your [site configuration] before they can be used throughout the site. You need to provide both the plural and singular labels for each taxonomy. For example, `singular key = "plural value"` for TOML and `singular key: "plural value"` for YAML.
 
-### Example: Adding a custom taxonomy named "series"
+### Example: adding a custom taxonomy named "series"
 
 {{% note %}}
 While adding custom taxonomies, you need to put in the default taxonomies too, _if you want to keep them_.
@@ -120,9 +120,9 @@ While adding custom taxonomies, you need to put in the default taxonomies too, _
   series = "series"
 {{</ code-toggle >}}
 
-### Example: Removing default taxonomies
+### Example: removing default taxonomies
 
-If you want to have just the default `tags` taxonomy, and remove the `categories` taxonomy for your site, you can do so by modifying the `taxonomies` value in your [site config][config].
+If you want to have just the default `tags` taxonomy, and remove the `categories` taxonomy for your site, you can do so by modifying the `taxonomies` value in your [site configuration].
 
 {{< code-toggle file="hugo" copy=false >}}
 [taxonomies]
@@ -143,7 +143,7 @@ The configuration option `preserveTaxonomyNames` was removed in Hugo 0.55.
 You can now use `.Page.Title` on the relevant taxonomy node to get the original value.
 {{% /note %}}
 
-## Add Taxonomies to Content
+## 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].
 
@@ -153,7 +153,7 @@ Assigning content to a taxonomy is done in the [front matter]. Simply create a v
 If you would like the ability to quickly generate content files with preconfigured taxonomies or terms, read the docs on [Hugo archetypes](/content-management/archetypes/).
 {{% /note %}}
 
-### Example: Front Matter with Taxonomies
+### Example: front matter with taxonomies
 
 {{< code-toggle file="content/example.md" fm=true copy=false >}}
 title = "Hugo: A fast and flexible static site generator"
@@ -164,13 +164,13 @@ slug = "hugo"
 project_url = "https://github.com/gohugoio/hugo"
 {{</ code-toggle >}}
 
-## Order Taxonomies
+## Order taxonomies
 
 A content file can assign weight for each of its associate taxonomies. Taxonomic weight can be used for sorting or ordering content in [taxonomy list templates] and is declared in a content file's [front matter]. The convention for declaring taxonomic weight is `taxonomyname_weight`.
 
 The following show a piece of content that has a weight of 22, which can be used for ordering purposes when rendering the pages assigned to the "a", "b" and "c" values of the `tags` taxonomy. It has also been assigned the weight of 44 when rendering the "d" category page.
 
-### Example: Taxonomic `weight`
+### Example: taxonomic `weight`
 
 {{< code-toggle copy=false >}}
 title = "foo"
@@ -186,7 +186,7 @@ By using taxonomic weight, the same piece of content can appear in different pos
 Currently taxonomies only support the [default `weight => date` ordering of list content](/templates/lists/#default-weight--date--linktitle--filepath). For more information, see the documentation on [taxonomy templates](/templates/taxonomy-templates/).
 {{% /note %}}
 
-## Add custom metadata to a Taxonomy or Term
+## Add custom metadata to a taxonomy or term
 
 If you need to add custom metadata to your taxonomy terms, you will need to create a page for that term at `/content/<TAXONOMY>/<TERM>/_index.md` and add your metadata in its front matter. Continuing with our 'Actors' example, let's say you want to add a Wikipedia page link to each actor. Your terms pages would be something like this:
 
@@ -203,4 +203,4 @@ wikipedia: "https://en.wikipedia.org/wiki/Bruce_Willis"
 [taxonomy list templates]: /templates/taxonomy-templates/#taxonomy-list-templates
 [taxonomy templates]: /templates/taxonomy-templates/
 [terms within the taxonomy]: /templates/taxonomy-templates/#taxonomy-terms-templates "See how to order terms associated with a taxonomy"
-[config]: /getting-started/configuration/
+[configuration]: /getting-started/configuration/