Merge commit '9d31f650da964a52f05fc27b7fb99cf3e09778cf'

53 files changed, 168 insertions, 96 deletions

diff --git a/docs/config/_default/markup.toml b/docs/config/_default/markup.toml
index f237f3526..b4a8e059a 100644
--- a/docs/config/_default/markup.toml
+++ b/docs/config/_default/markup.toml
@@ -1,5 +1,25 @@
 defaultMarkdownHandler = "goldmark"
 
+[goldmark]
+[goldmark.extensions]
+definitionList = true
+footnote = true
+linkify = true
+strikethrough = true
+table = true
+taskList = true
+typographer = true
+[goldmark.parser]
+autoHeadingID = true
+autoHeadingIDType = "github"
+[goldmark.parser.attribute]
+block = true
+title = true
+[goldmark.renderer]
+hardWraps = false
+unsafe = false
+xhtml = false
+
 [highlight]
 style = "trac"
 lineNumbersInTable = true
diff --git a/docs/content/en/commands/hugo.md b/docs/content/en/commands/hugo.md
index ece1dc7aa..42744b708 100644
--- a/docs/content/en/commands/hugo.md
+++ b/docs/content/en/commands/hugo.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo"
 slug: hugo
 url: /commands/hugo/
@@ -81,4 +81,4 @@ hugo [flags]
 * [hugo server](/commands/hugo_server/)	 - A high performance webserver
 * [hugo version](/commands/hugo_version/)	 - Print the version number of Hugo
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_check.md b/docs/content/en/commands/hugo_check.md
index 7016fdd8e..384507179 100644
--- a/docs/content/en/commands/hugo_check.md
+++ b/docs/content/en/commands/hugo_check.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo check"
 slug: hugo_check
 url: /commands/hugo_check/
@@ -37,4 +37,4 @@ Contains some verification checks
 * [hugo](/commands/hugo/)	 - hugo builds your site
 * [hugo check ulimit](/commands/hugo_check_ulimit/)	 - Check system ulimit settings
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_check_ulimit.md b/docs/content/en/commands/hugo_check_ulimit.md
index c56dc6b0b..bfd98bde3 100644
--- a/docs/content/en/commands/hugo_check_ulimit.md
+++ b/docs/content/en/commands/hugo_check_ulimit.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo check ulimit"
 slug: hugo_check_ulimit
 url: /commands/hugo_check_ulimit/
@@ -45,4 +45,4 @@ hugo check ulimit [flags]
 
 * [hugo check](/commands/hugo_check/)	 - Contains some verification checks
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_config.md b/docs/content/en/commands/hugo_config.md
index 7b815c737..d7f0d17b9 100644
--- a/docs/content/en/commands/hugo_config.md
+++ b/docs/content/en/commands/hugo_config.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo config"
 slug: hugo_config
 url: /commands/hugo_config/
@@ -45,4 +45,4 @@ hugo config [flags]
 * [hugo](/commands/hugo/)	 - hugo builds your site
 * [hugo config mounts](/commands/hugo_config_mounts/)	 - Print the configured file mounts
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_config_mounts.md b/docs/content/en/commands/hugo_config_mounts.md
index a15314b7e..a8e6b4499 100644
--- a/docs/content/en/commands/hugo_config_mounts.md
+++ b/docs/content/en/commands/hugo_config_mounts.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo config mounts"
 slug: hugo_config_mounts
 url: /commands/hugo_config_mounts/
@@ -40,4 +40,4 @@ hugo config mounts [flags]
 
 * [hugo config](/commands/hugo_config/)	 - Print the site configuration
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_convert.md b/docs/content/en/commands/hugo_convert.md
index 45d568247..1ea65ad63 100644
--- a/docs/content/en/commands/hugo_convert.md
+++ b/docs/content/en/commands/hugo_convert.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo convert"
 slug: hugo_convert
 url: /commands/hugo_convert/
@@ -47,4 +47,4 @@ See convert's subcommands toJSON, toTOML and toYAML for more information.
 * [hugo convert toTOML](/commands/hugo_convert_totoml/)	 - Convert front matter to TOML
 * [hugo convert toYAML](/commands/hugo_convert_toyaml/)	 - Convert front matter to YAML
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_convert_toJSON.md b/docs/content/en/commands/hugo_convert_toJSON.md
index d39915674..b02cf472c 100644
--- a/docs/content/en/commands/hugo_convert_toJSON.md
+++ b/docs/content/en/commands/hugo_convert_toJSON.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo convert toJSON"
 slug: hugo_convert_toJSON
 url: /commands/hugo_convert_tojson/
@@ -47,4 +47,4 @@ hugo convert toJSON [flags]
 
 * [hugo convert](/commands/hugo_convert/)	 - Convert your content to different formats
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_convert_toTOML.md b/docs/content/en/commands/hugo_convert_toTOML.md
index 281718857..28ff53359 100644
--- a/docs/content/en/commands/hugo_convert_toTOML.md
+++ b/docs/content/en/commands/hugo_convert_toTOML.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo convert toTOML"
 slug: hugo_convert_toTOML
 url: /commands/hugo_convert_totoml/
@@ -47,4 +47,4 @@ hugo convert toTOML [flags]
 
 * [hugo convert](/commands/hugo_convert/)	 - Convert your content to different formats
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_convert_toYAML.md b/docs/content/en/commands/hugo_convert_toYAML.md
index 2249e2a1b..48aef268e 100644
--- a/docs/content/en/commands/hugo_convert_toYAML.md
+++ b/docs/content/en/commands/hugo_convert_toYAML.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo convert toYAML"
 slug: hugo_convert_toYAML
 url: /commands/hugo_convert_toyaml/
@@ -47,4 +47,4 @@ hugo convert toYAML [flags]
 
 * [hugo convert](/commands/hugo_convert/)	 - Convert your content to different formats
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_deploy.md b/docs/content/en/commands/hugo_deploy.md
index 4bd7fdd93..b3b51426f 100644
--- a/docs/content/en/commands/hugo_deploy.md
+++ b/docs/content/en/commands/hugo_deploy.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo deploy"
 slug: hugo_deploy
 url: /commands/hugo_deploy/
@@ -54,4 +54,4 @@ hugo deploy [flags]
 
 * [hugo](/commands/hugo/)	 - hugo builds your site
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_env.md b/docs/content/en/commands/hugo_env.md
index 124e17408..39b840342 100644
--- a/docs/content/en/commands/hugo_env.md
+++ b/docs/content/en/commands/hugo_env.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo env"
 slug: hugo_env
 url: /commands/hugo_env/
@@ -44,4 +44,4 @@ hugo env [flags]
 
 * [hugo](/commands/hugo/)	 - hugo builds your site
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_gen.md b/docs/content/en/commands/hugo_gen.md
index 69d3c7c42..4146e43c3 100644
--- a/docs/content/en/commands/hugo_gen.md
+++ b/docs/content/en/commands/hugo_gen.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo gen"
 slug: hugo_gen
 url: /commands/hugo_gen/
@@ -40,4 +40,4 @@ A collection of several useful generators.
 * [hugo gen doc](/commands/hugo_gen_doc/)	 - Generate Markdown documentation for the Hugo CLI.
 * [hugo gen man](/commands/hugo_gen_man/)	 - Generate man pages for the Hugo CLI
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_gen_autocomplete.md b/docs/content/en/commands/hugo_gen_autocomplete.md
index ab614c0e7..414b5905b 100644
--- a/docs/content/en/commands/hugo_gen_autocomplete.md
+++ b/docs/content/en/commands/hugo_gen_autocomplete.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo gen autocomplete"
 slug: hugo_gen_autocomplete
 url: /commands/hugo_gen_autocomplete/
@@ -12,13 +12,9 @@ Generate shell autocompletion script for Hugo
 
 Generates a shell autocompletion script for Hugo.
 
-By default, the file is written directly to /etc/bash_completion.d
-for convenience, and the command may need superuser rights, e.g.:
+The script is written to the console (stdout).
 
-	$ sudo hugo gen autocomplete
-
-Add `--completionfile=/path/to/file` flag to set alternative
-file-path and name.
+To write to file, add the `--completionfile=/path/to/file` flag.
 
 Add `--type={bash, zsh, fish or powershell}` flag to set alternative
 shell type.
@@ -62,4 +58,4 @@ hugo gen autocomplete [flags]
 
 * [hugo gen](/commands/hugo_gen/)	 - A collection of several useful generators.
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_gen_chromastyles.md b/docs/content/en/commands/hugo_gen_chromastyles.md
index c296fa65e..d09d046d7 100644
--- a/docs/content/en/commands/hugo_gen_chromastyles.md
+++ b/docs/content/en/commands/hugo_gen_chromastyles.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo gen chromastyles"
 slug: hugo_gen_chromastyles
 url: /commands/hugo_gen_chromastyles/
@@ -49,4 +49,4 @@ hugo gen chromastyles [flags]
 
 * [hugo gen](/commands/hugo_gen/)	 - A collection of several useful generators.
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_gen_doc.md b/docs/content/en/commands/hugo_gen_doc.md
index 86a314044..f2f5dbde3 100644
--- a/docs/content/en/commands/hugo_gen_doc.md
+++ b/docs/content/en/commands/hugo_gen_doc.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo gen doc"
 slug: hugo_gen_doc
 url: /commands/hugo_gen_doc/
@@ -51,4 +51,4 @@ hugo gen doc [flags]
 
 * [hugo gen](/commands/hugo_gen/)	 - A collection of several useful generators.
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_gen_man.md b/docs/content/en/commands/hugo_gen_man.md
index 453428c25..7710ea1c2 100644
--- a/docs/content/en/commands/hugo_gen_man.md
+++ b/docs/content/en/commands/hugo_gen_man.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo gen man"
 slug: hugo_gen_man
 url: /commands/hugo_gen_man/
@@ -47,4 +47,4 @@ hugo gen man [flags]
 
 * [hugo gen](/commands/hugo_gen/)	 - A collection of several useful generators.
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_import.md b/docs/content/en/commands/hugo_import.md
index 27b6f80d4..ec791678f 100644
--- a/docs/content/en/commands/hugo_import.md
+++ b/docs/content/en/commands/hugo_import.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo import"
 slug: hugo_import
 url: /commands/hugo_import/
@@ -43,4 +43,4 @@ Import requires a subcommand, e.g. `hugo import jekyll jekyll_root_path target_p
 * [hugo](/commands/hugo/)	 - hugo builds your site
 * [hugo import jekyll](/commands/hugo_import_jekyll/)	 - hugo import from Jekyll
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_import_jekyll.md b/docs/content/en/commands/hugo_import_jekyll.md
index bb2c0fa2a..23721f846 100644
--- a/docs/content/en/commands/hugo_import_jekyll.md
+++ b/docs/content/en/commands/hugo_import_jekyll.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo import jekyll"
 slug: hugo_import_jekyll
 url: /commands/hugo_import_jekyll/
@@ -47,4 +47,4 @@ hugo import jekyll [flags]
 
 * [hugo import](/commands/hugo_import/)	 - Import your site from others.
 
-###### Auto generated by spf13/cobra on 18-Feb-2021
+###### Auto generated by spf13/cobra on 20-Feb-2021
diff --git a/docs/content/en/commands/hugo_list.md b/docs/content/en/commands/hugo_list.md
index 6609d74d1..d5075ea6b 100644
--- a/docs/content/en/commands/hugo_list.md
+++ b/docs/content/en/commands/hugo_list.md
@@ -1,5 +1,5 @@
 ---
-date: 2021-02-18
+date: 2021-02-20
 title: "hugo list"
 slug: hugo_list
 url: /commands/hugo_list/
@@ -46,4 +46,4 @@ List requires a subcommand, e.g. `hugo list drafts`.
 * [hugo list expired](/commands/hugo_list_expired/)	 - List all posts already expired</