Squashed 'docs/' changes from 1798dc0d5..1d5548d73 - hugo - [fork] hugo port for 9front
HTML git clone git@git.drkhsh.at/hugo.git
DIR Log
DIR Files
DIR Refs
DIR Submodules
DIR README
DIR LICENSE
---
DIR commit dfb1895e4b82b2249d9baaed37ac7ae5e855a126
DIR parent d3927310d5b2404c3238f9b899db3329ea516490
HTML Author: Bjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com>
Date: Thu, 1 Jun 2023 10:51:24 +0200
Squashed 'docs/' changes from 1798dc0d5..1d5548d73
1d5548d73 build.cachebusters
3c966904d netlify: Hugo 0.112.5
b32c3a811 Bump min Go version to 1.19 when building from source (#2095)
9dea2d2f9 netlify: Hugo 0.112.4
b3fb4a1bc docs: Regenerate CLI docs
291ecd301 docs: Regen CLI docs
c886958e2 Merge commit 'd3927310d5b2404c3238f9b899db3329ea516490'
git-subtree-dir: docs
git-subtree-split: 1d5548d7355be39364404a67eee7186d5ea71930
Diffstat:
M content/en/commands/hugo.md | 1 -
M content/en/commands/hugo_completio… | 1 -
M content/en/commands/hugo_completio… | 1 -
M content/en/commands/hugo_completio… | 1 -
M content/en/commands/hugo_completio… | 1 -
M content/en/commands/hugo_completio… | 1 -
M content/en/commands/hugo_config.md | 8 ++++++--
M content/en/commands/hugo_config_mo… | 7 +++++--
M content/en/commands/hugo_convert.md | 1 -
M content/en/commands/hugo_convert_t… | 1 -
M content/en/commands/hugo_convert_t… | 1 -
M content/en/commands/hugo_convert_t… | 1 -
M content/en/commands/hugo_deploy.md | 1 -
M content/en/commands/hugo_env.md | 1 -
M content/en/commands/hugo_gen.md | 1 -
M content/en/commands/hugo_gen_chrom… | 1 -
M content/en/commands/hugo_gen_doc.md | 1 -
M content/en/commands/hugo_gen_man.md | 1 -
M content/en/commands/hugo_import.md | 1 -
M content/en/commands/hugo_import_je… | 1 -
M content/en/commands/hugo_list.md | 1 -
M content/en/commands/hugo_list_all.… | 1 -
M content/en/commands/hugo_list_draf… | 1 -
M content/en/commands/hugo_list_expi… | 1 -
M content/en/commands/hugo_list_futu… | 1 -
M content/en/commands/hugo_mod.md | 1 -
M content/en/commands/hugo_mod_clean… | 11 +++++++----
M content/en/commands/hugo_mod_get.md | 1 -
M content/en/commands/hugo_mod_graph… | 9 ++++++---
M content/en/commands/hugo_mod_init.… | 7 +++++--
M content/en/commands/hugo_mod_npm.md | 1 -
M content/en/commands/hugo_mod_npm_p… | 7 +++++--
M content/en/commands/hugo_mod_tidy.… | 7 +++++--
M content/en/commands/hugo_mod_vendo… | 7 +++++--
M content/en/commands/hugo_mod_verif… | 9 ++++++---
M content/en/commands/hugo_new.md | 1 -
M content/en/commands/hugo_new_conte… | 14 +++++++++-----
M content/en/commands/hugo_new_site.… | 3 +--
M content/en/commands/hugo_new_theme… | 1 -
M content/en/commands/hugo_server.md | 1 -
M content/en/commands/hugo_version.md | 1 -
M content/en/getting-started/configu… | 46 +++++++++++++++++++++++++++++++
M content/en/installation/common/05-… | 2 +-
M netlify.toml | 8 ++++----
44 files changed, 111 insertions(+), 64 deletions(-)
---
DIR diff --git a/content/en/commands/hugo.md b/content/en/commands/hugo.md
@@ -39,7 +39,6 @@ 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
DIR diff --git a/content/en/commands/hugo_completion.md b/content/en/commands/hugo_completion.md
@@ -28,7 +28,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_completion_bash.md b/content/en/commands/hugo_completion_bash.md
@@ -51,7 +51,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_completion_fish.md b/content/en/commands/hugo_completion_fish.md
@@ -42,7 +42,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_completion_powershell.md b/content/en/commands/hugo_completion_powershell.md
@@ -39,7 +39,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_completion_zsh.md b/content/en/commands/hugo_completion_zsh.md
@@ -53,7 +53,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_config.md b/content/en/commands/hugo_config.md
@@ -18,7 +18,12 @@ hugo config [command] [flags]
### Options
```
- -h, --help help for config
+ -b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/
+ --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
+ -c, --contentDir string filesystem path to content directory
+ --format string preferred file format (toml, yaml or json) (default "toml")
+ -h, --help help for config
+ -t, --theme strings themes to use (located in /themes/THEMENAME/)
```
### Options inherited from parent commands
@@ -30,7 +35,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_config_mounts.md b/content/en/commands/hugo_config_mounts.md
@@ -14,7 +14,11 @@ hugo config mounts [flags] [args]
### Options
```
- -h, --help help for mounts
+ -b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/
+ --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
+ -c, --contentDir string filesystem path to content directory
+ -h, --help help for mounts
+ -t, --theme strings themes to use (located in /themes/THEMENAME/)
```
### Options inherited from parent commands
@@ -26,7 +30,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_convert.md b/content/en/commands/hugo_convert.md
@@ -34,7 +34,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_convert_toJSON.md b/content/en/commands/hugo_convert_toJSON.md
@@ -31,7 +31,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_convert_toTOML.md b/content/en/commands/hugo_convert_toTOML.md
@@ -31,7 +31,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_convert_toYAML.md b/content/en/commands/hugo_convert_toYAML.md
@@ -31,7 +31,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_deploy.md b/content/en/commands/hugo_deploy.md
@@ -41,7 +41,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_env.md b/content/en/commands/hugo_env.md
@@ -30,7 +30,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_gen.md b/content/en/commands/hugo_gen.md
@@ -26,7 +26,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_gen_chromastyles.md b/content/en/commands/hugo_gen_chromastyles.md
@@ -35,7 +35,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_gen_doc.md b/content/en/commands/hugo_gen_doc.md
@@ -36,7 +36,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_gen_man.md b/content/en/commands/hugo_gen_man.md
@@ -33,7 +33,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_import.md b/content/en/commands/hugo_import.md
@@ -32,7 +32,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_import_jekyll.md b/content/en/commands/hugo_import_jekyll.md
@@ -33,7 +33,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_list.md b/content/en/commands/hugo_list.md
@@ -32,7 +32,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_list_all.md b/content/en/commands/hugo_list_all.md
@@ -30,7 +30,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_list_drafts.md b/content/en/commands/hugo_list_drafts.md
@@ -30,7 +30,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_list_expired.md b/content/en/commands/hugo_list_expired.md
@@ -30,7 +30,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_list_future.md b/content/en/commands/hugo_list_future.md
@@ -30,7 +30,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_mod.md b/content/en/commands/hugo_mod.md
@@ -37,7 +37,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_mod_clean.md b/content/en/commands/hugo_mod_clean.md
@@ -18,9 +18,13 @@ hugo mod clean [flags] [args]
### Options
```
- --all clean entire module cache
- -h, --help help for clean
- --pattern string pattern matching module paths to clean (all if not set), e.g. "**hugo*"
+ --all clean entire module cache
+ -b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/
+ --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
+ -c, --contentDir string filesystem path to content directory
+ -h, --help help for clean
+ --pattern string pattern matching module paths to clean (all if not set), e.g. "**hugo*"
+ -t, --theme strings themes to use (located in /themes/THEMENAME/)
```
### Options inherited from parent commands
@@ -32,7 +36,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_mod_get.md b/content/en/commands/hugo_mod_get.md
@@ -56,7 +56,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_mod_graph.md b/content/en/commands/hugo_mod_graph.md
@@ -20,8 +20,12 @@ hugo mod graph [flags] [args]
### Options
```
- --clean delete module cache for dependencies that fail verification
- -h, --help help for graph
+ -b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/
+ --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
+ --clean delete module cache for dependencies that fail verification
+ -c, --contentDir string filesystem path to content directory
+ -h, --help help for graph
+ -t, --theme strings themes to use (located in /themes/THEMENAME/)
```
### Options inherited from parent commands
@@ -33,7 +37,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_mod_init.md b/content/en/commands/hugo_mod_init.md
@@ -25,7 +25,11 @@ hugo mod init [flags] [args]
### Options
```
- -h, --help help for init
+ -b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/
+ --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
+ -c, --contentDir string filesystem path to content directory
+ -h, --help help for init
+ -t, --theme strings themes to use (located in /themes/THEMENAME/)
```
### Options inherited from parent commands
@@ -37,7 +41,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_mod_npm.md b/content/en/commands/hugo_mod_npm.md
@@ -30,7 +30,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_mod_npm_pack.md b/content/en/commands/hugo_mod_npm_pack.md
@@ -28,7 +28,11 @@ hugo mod npm pack [flags] [args]
### Options
```
- -h, --help help for pack
+ -b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/
+ --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
+ -c, --contentDir string filesystem path to content directory
+ -h, --help help for pack
+ -t, --theme strings themes to use (located in /themes/THEMENAME/)
```
### Options inherited from parent commands
@@ -40,7 +44,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_mod_tidy.md b/content/en/commands/hugo_mod_tidy.md
@@ -14,7 +14,11 @@ hugo mod tidy [flags] [args]
### Options
```
- -h, --help help for tidy
+ -b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/
+ --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
+ -c, --contentDir string filesystem path to content directory
+ -h, --help help for tidy
+ -t, --theme strings themes to use (located in /themes/THEMENAME/)
```
### Options inherited from parent commands
@@ -26,7 +30,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_mod_vendor.md b/content/en/commands/hugo_mod_vendor.md
@@ -20,7 +20,11 @@ hugo mod vendor [flags] [args]
### Options
```
- -h, --help help for vendor
+ -b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/
+ --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
+ -c, --contentDir string filesystem path to content directory
+ -h, --help help for vendor
+ -t, --theme strings themes to use (located in /themes/THEMENAME/)
```
### Options inherited from parent commands
@@ -32,7 +36,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_mod_verify.md b/content/en/commands/hugo_mod_verify.md
@@ -18,8 +18,12 @@ hugo mod verify [flags] [args]
### Options
```
- --clean delete module cache for dependencies that fail verification
- -h, --help help for verify
+ -b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/
+ --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
+ --clean delete module cache for dependencies that fail verification
+ -c, --contentDir string filesystem path to content directory
+ -h, --help help for verify
+ -t, --theme strings themes to use (located in /themes/THEMENAME/)
```
### Options inherited from parent commands
@@ -31,7 +35,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_new.md b/content/en/commands/hugo_new.md
@@ -37,7 +37,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_new_content.md b/content/en/commands/hugo_new_content.md
@@ -25,10 +25,15 @@ hugo new content [path] [flags]
### Options
```
- --editor string edit new content with this editor, if provided
- -f, --force overwrite file if it already exists
- -h, --help help for content
- -k, --kind string content type to create
+ -b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/
+ --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
+ -c, --contentDir string filesystem path to content directory
+ --editor string edit new content with this editor, if provided
+ -f, --force overwrite file if it already exists
+ --format string preferred file format (toml, yaml or json) (default "toml")
+ -h, --help help for content
+ -k, --kind string content type to create
+ -t, --theme strings themes to use (located in /themes/THEMENAME/)
```
### Options inherited from parent commands
@@ -40,7 +45,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_new_site.md b/content/en/commands/hugo_new_site.md
@@ -20,7 +20,7 @@ hugo new site [path] [flags]
### Options
```
- --force init inside non-empty directory
+ -f, --force init inside non-empty directory
-h, --help help for site
```
@@ -33,7 +33,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_new_theme.md b/content/en/commands/hugo_new_theme.md
@@ -32,7 +32,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_server.md b/content/en/commands/hugo_server.md
@@ -82,7 +82,6 @@ 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)
DIR diff --git a/content/en/commands/hugo_version.md b/content/en/commands/hugo_version.md
@@ -30,7 +30,6 @@ 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)
DIR diff --git a/content/en/getting-started/configuration.md b/content/en/getting-started/configuration.md
@@ -499,6 +499,18 @@ The `build` configuration section contains global build-related configuration op
useResourceCacheWhen="fallback"
writeStats = false
noJSConfigInAssets = false
+ [[build.cachebusters]]
+ source = "assets/watching/hugo_stats\\.json"
+ target = "styles\\.css"
+ [[build.cachebusters]]
+ source = "(postcss|tailwind)\\.config\\.js"
+ target = "css"
+ [[build.cachebusters]]
+ source = "assets/.*\\.(js|ts|jsx|tsx)"
+ target = "js"
+ [[build.cachebusters]]
+ source = "assets/.*\\.(.*)$"
+ target = "$1"
{{< /code-toggle >}}
@@ -513,6 +525,40 @@ writeStats
noJSConfigInAssets
: Turn off writing a `jsconfig.json` into your `/assets` folder with mapping of imports from running [js.Build](https://gohugo.io/hugo-pipes/js). This file is intended to help with intellisense/navigation inside code editors such as [VS Code](https://code.visualstudio.com/). Note that if you do not use `js.Build`, no file will be written.
+cachebusters
+: See [Configure Cache Busters](#configure-cache-busters)
+
+## Configure Cache Busters
+
+{{< new-in "0.112.0" >}}
+
+The `build.cachebusters` configuration option was added to support development using Tailwind 3.x's JIT compiler where a `build` config may look like this:
+
+{{< code-toggle file="hugo" >}}
+[build]
+writeStats = true
+ [[build.cachebusters]]
+ source = "assets/watching/hugo_stats\\.json"
+ target = "styles\\.css"
+ [[build.cachebusters]]
+ source = "(postcss|tailwind)\\.config\\.js"
+ target = "css"
+ [[build.cachebusters]]
+ source = "assets/.*\\.(js|ts|jsx|tsx)"
+ target = "js"
+ [[build.cachebusters]]
+ source = "assets/.*\\.(.*)$"
+ target = "$1"
+{{< /code-toggle >}}
+
+Some key points in the above are `writeStats = true`, which writes a `hugo_stats.json` file on each build with HTML classes etc. that's used in the rendered output. Changes to this file will trigger a rebuild of the `styles.css` file. You also need to add `hugo_stats.json` to Hugo's server watcher. See [Hugo Starter Tailwind Basic](https://github.com/bep/hugo-starter-tailwind-basic) for a running example.
+
+source
+: A regexp matching file(s) relative to one of the virtual component directories in Hugo, typically `assets/...`.
+
+target
+: A regexp matching the keys in the resource cache that should be expired when `source` changes. You can use the matching regexp groups from `source` in the expression, e.g. `$1`.
+
## Configure Server
This is only relevant when running `hugo server`, and it allows to set HTTP headers during development, which allows you to test out your Content Security Policy and similar. The configuration format matches [Netlify's](https://docs.netlify.com/routing/headers/#syntax-for-the-netlify-configuration-file) with slightly more powerful [Glob matching](https://github.com/gobwas/glob):
DIR diff --git a/content/en/installation/common/05-build-from-source.md b/content/en/installation/common/05-build-from-source.md
@@ -3,7 +3,7 @@
To build Hugo from source you must:
1. Install [Git]
-1. Install [Go] version 1.18 or later
+1. Install [Go] version 1.19 or later
1. Update your PATH environment variable as described in the [Go documentation]
> The install directory is controlled by the GOPATH and GOBIN environment variables. If GOBIN is set, binaries are installed to that directory. If GOPATH is set, binaries are installed to the bin subdirectory of the first directory in the GOPATH list. Otherwise, binaries are installed to the bin subdirectory of the default GOPATH ($HOME/go or %USERPROFILE%\go).
DIR diff --git a/netlify.toml b/netlify.toml
@@ -3,7 +3,7 @@ publish = "public"
command = "hugo --gc --minify"
[context.production.environment]
-HUGO_VERSION = "0.112.3"
+HUGO_VERSION = "0.112.5"
HUGO_ENV = "production"
HUGO_ENABLEGITINFO = "true"
@@ -11,20 +11,20 @@ HUGO_ENABLEGITINFO = "true"
command = "hugo --gc --minify --enableGitInfo"
[context.split1.environment]
-HUGO_VERSION = "0.112.3"
+HUGO_VERSION = "0.112.5"
HUGO_ENV = "production"
[context.deploy-preview]
command = "hugo --gc --minify --buildFuture -b $DEPLOY_PRIME_URL"
[context.deploy-preview.environment]
-HUGO_VERSION = "0.112.3"
+HUGO_VERSION = "0.112.5"
[context.branch-deploy]
command = "hugo --gc --minify -b $DEPLOY_PRIME_URL"
[context.branch-deploy.environment]
-HUGO_VERSION = "0.112.3"
+HUGO_VERSION = "0.112.5"
[context.next.environment]
HUGO_ENABLEGITINFO = "true"