From 469e504c7e6668b49048af51e25ef245572bef5d Mon Sep 17 00:00:00 2001 From: Ryan Watters Date: Mon, 3 Jul 2017 14:42:38 -0500 Subject: [PATCH] Explain use of disableKinds to remove default taxonomy Fixes rdwatters/hugo-docs-concept#158 --- config.toml | 2 +- content/content-management/taxonomies.md | 10 +++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/config.toml b/config.toml index 80ec52f77..71f4b1f84 100644 --- a/config.toml +++ b/config.toml @@ -81,7 +81,7 @@ twitter = "GoHugoIO" ## As of v0.20, all content files include a default "categories" value that's the same as the section. This was a cheap future-proofing method and should/could be changed accordingly. [taxonomies] tag = "tags" - + category = "categories" # High level items diff --git a/content/content-management/taxonomies.md b/content/content-management/taxonomies.md index ab9fa92b2..731f350e8 100644 --- a/content/content-management/taxonomies.md +++ b/content/content-management/taxonomies.md @@ -84,13 +84,13 @@ Moonrise Kingdom <- Content ## Hugo Taxonomy Defaults -Hugo natively supports taxonomies, which means there are architectural patterns for rendering your project's taxonomies baked into Hugo's core. +Hugo natively supports taxonomies, which means there are architectural patterns for rendering your project's taxonomies baked into Hugo's core. -{{% note %}} -Users of versions older than v0.20 may notice that Hugo built `/tags` and `/categories` as long as these fields were called in at least a single content file. A previous hack involved setting these values to empty strings. This is *not* a proper workaround. +Without adding a single line to your site's configuration file, Hugo will automatically create taxonomies for `tags` and `categories`. If you do not want Hugo to create these taxonomies---even though the values may be added to your content files' front matter---set `disableKinds` in your site's configuration to the following: -As of v0.20, Hugo does *not* automatically generate default taxonomies for your site. If your site configuration contains no key-values in the taxonomies field, Hugo will not build anything. -{{% /note %}} +```toml +disableKinds = ["taxonomy","taxonomyTerm"] +``` ### Default Destinations