Update CLI documentation (#2092)

content/en/commands/hugo.md

@@ -39,6 +39,7 @@ hugo [flags]
       --enableGitInfo              add Git revision, date, author, and CODEOWNERS info to the pages
   -e, --environment string         build environment
       --forceSyncStatic            copy all files when static is changed.
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --gc                         enable to run some cleanup tasks (remove unused cache files) after the build
   -h, --help                       help for hugo
       --ignoreCache                ignores the cache directory

content/en/commands/hugo_completion.md

@@ -28,6 +28,7 @@ See each sub-command's help for details on how to use the generated script.
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_completion_bash.md

@@ -51,6 +51,7 @@ hugo completion bash
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_completion_fish.md

@@ -42,6 +42,7 @@ hugo completion fish [flags]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_completion_powershell.md

@@ -39,6 +39,7 @@ hugo completion powershell [flags]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_completion_zsh.md

@@ -53,6 +53,7 @@ hugo completion zsh [flags]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_config.md

@@ -30,6 +30,7 @@ hugo config [command] [flags]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_config_mounts.md

@@ -26,6 +26,7 @@ hugo config mounts [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_convert.md

@@ -34,6 +34,7 @@ hugo convert [command] [flags]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_convert_toJSON.md

@@ -31,6 +31,7 @@ hugo convert toJSON [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_convert_toTOML.md

@@ -31,6 +31,7 @@ hugo convert toTOML [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_convert_toYAML.md

@@ -31,6 +31,7 @@ hugo convert toYAML [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_deploy.md

@@ -41,6 +41,7 @@ hugo deploy [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_env.md

@@ -30,6 +30,7 @@ hugo env [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_gen.md

@@ -26,6 +26,7 @@ hugo gen [command] [flags]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_gen_chromastyles.md

@@ -35,6 +35,7 @@ hugo gen chromastyles [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_gen_doc.md

@@ -36,6 +36,7 @@ hugo gen doc [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_gen_man.md

@@ -33,6 +33,7 @@ hugo gen man [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_import.md

@@ -32,6 +32,7 @@ hugo import [command] [flags]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_import_jekyll.md

@@ -33,6 +33,7 @@ hugo import jekyll [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_list.md

@@ -32,6 +32,7 @@ hugo list [command] [flags]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_list_all.md

@@ -30,6 +30,7 @@ hugo list all [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_list_drafts.md

@@ -30,6 +30,7 @@ hugo list drafts [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_list_expired.md

@@ -30,6 +30,7 @@ hugo list expired [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_list_future.md

@@ -30,6 +30,7 @@ hugo list future [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_mod.md

@@ -37,6 +37,7 @@ See https://gohugo.io/hugo-modules/ for more information.
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_mod_clean.md

@@ -32,6 +32,7 @@ hugo mod clean [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_mod_get.md

@@ -56,6 +56,7 @@ hugo mod get [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_mod_graph.md

@@ -33,6 +33,7 @@ hugo mod graph [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_mod_init.md

@@ -37,6 +37,7 @@ hugo mod init [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_mod_npm.md

@@ -30,6 +30,7 @@ hugo mod npm [command] [flags]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_mod_npm_pack.md

@@ -40,6 +40,7 @@ hugo mod npm pack [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_mod_tidy.md

@@ -26,6 +26,7 @@ hugo mod tidy [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_mod_vendor.md

@@ -32,6 +32,7 @@ hugo mod vendor [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_mod_verify.md

@@ -31,6 +31,7 @@ hugo mod verify [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_new.md

@@ -37,6 +37,7 @@ hugo new [command] [flags]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_new_content.md

@@ -40,6 +40,7 @@ hugo new content [path] [flags]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_new_site.md

@@ -20,9 +20,8 @@ hugo new site [path] [flags]
 ### Options
 
 ```
-      --force           init inside non-empty directory
+      --force   init inside non-empty directory
-  -f, --format string   config file format (default "toml")
+  -h, --help    help for site
-  -h, --help            help for site
 ```
 
 ### Options inherited from parent commands
@@ -34,6 +33,7 @@ hugo new site [path] [flags]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_new_theme.md

@@ -32,6 +32,7 @@ hugo new theme [path] [flags]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_server.md

@@ -82,6 +82,7 @@ hugo server [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)

content/en/commands/hugo_version.md

@@ -30,6 +30,7 @@ hugo version [flags] [args]
       --debug                      debug output
   -d, --destination string         filesystem path to write files to
   -e, --environment string         build environment
+      --format string              preferred file format (toml, yaml or json) (default "toml")
       --ignoreVendorPaths string   ignores any _vendor for module paths matching the given Glob pattern
       --log                        enable Logging
       --logFile string             log File path (if set, logging enabled automatically)