mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-29 05:12:09 -05:00
docs: Regen CLI docs
This commit is contained in:
parent
b95e156940
commit
10d0fcc01f
41 changed files with 348 additions and 309 deletions
|
@ -82,5 +82,5 @@ hugo [flags]
|
||||||
* [hugo mod](/commands/hugo_mod/) - Various Hugo Modules helpers.
|
* [hugo mod](/commands/hugo_mod/) - Various Hugo Modules helpers.
|
||||||
* [hugo new](/commands/hugo_new/) - Create new content for your site
|
* [hugo new](/commands/hugo_new/) - Create new content for your site
|
||||||
* [hugo server](/commands/hugo_server/) - A high performance webserver
|
* [hugo server](/commands/hugo_server/) - A high performance webserver
|
||||||
* [hugo version](/commands/hugo_version/) - Print the version number of Hugo
|
* [hugo version](/commands/hugo_version/) - Print Hugo version and environment info
|
||||||
|
|
||||||
|
|
|
@ -26,6 +26,7 @@ See each sub-command's help for details on how to use the generated script.
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -49,6 +49,7 @@ hugo completion bash
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -40,6 +40,7 @@ hugo completion fish [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -37,6 +37,7 @@ hugo completion powershell [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -18,7 +18,7 @@ to enable it. You can execute the following once:
|
||||||
|
|
||||||
To load completions in your current shell session:
|
To load completions in your current shell session:
|
||||||
|
|
||||||
source <(hugo completion zsh); compdef _hugo hugo
|
source <(hugo completion zsh)
|
||||||
|
|
||||||
To load completions for every new session, execute once:
|
To load completions for every new session, execute once:
|
||||||
|
|
||||||
|
@ -51,6 +51,7 @@ hugo completion zsh [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -12,31 +12,32 @@ Print the site configuration
|
||||||
Print the site configuration, both default and custom settings.
|
Print the site configuration, both default and custom settings.
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo config [flags]
|
hugo config [command] [flags]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
|
||||||
```
|
```
|
||||||
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
-h, --help help for config
|
||||||
-e, --environment string build environment
|
|
||||||
-h, --help help for config
|
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
|
||||||
-s, --source string filesystem path to read files relative from
|
|
||||||
--themesDir string filesystem path to themes directory
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options inherited from parent commands
|
### Options inherited from parent commands
|
||||||
|
|
||||||
```
|
```
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
||||||
--configDir string config dir (default "config")
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--debug debug output
|
--configDir string config dir (default "config")
|
||||||
--log enable Logging
|
--debug debug output
|
||||||
--logFile string log File path (if set, logging enabled automatically)
|
-d, --destination string filesystem path to write files to
|
||||||
--quiet build in quiet mode
|
-e, --environment string build environment
|
||||||
-v, --verbose verbose output
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--verboseLog verbose logging
|
--log enable Logging
|
||||||
|
--logFile string log File path (if set, logging enabled automatically)
|
||||||
|
--quiet build in quiet mode
|
||||||
|
-s, --source string filesystem path to read files relative from
|
||||||
|
--themesDir string filesystem path to themes directory
|
||||||
|
-v, --verbose verbose output
|
||||||
|
--verboseLog verbose logging
|
||||||
```
|
```
|
||||||
|
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
|
|
|
@ -8,7 +8,7 @@ url: /commands/hugo_config_mounts/
|
||||||
Print the configured file mounts
|
Print the configured file mounts
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo config mounts [flags]
|
hugo config mounts [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -24,6 +24,7 @@ hugo config mounts [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -13,30 +13,35 @@ Convert your content (e.g. front matter) to different formats.
|
||||||
|
|
||||||
See convert's subcommands toJSON, toTOML and toYAML for more information.
|
See convert's subcommands toJSON, toTOML and toYAML for more information.
|
||||||
|
|
||||||
|
```
|
||||||
|
hugo convert [command] [flags]
|
||||||
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
|
||||||
```
|
```
|
||||||
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
-h, --help help for convert
|
||||||
-e, --environment string build environment
|
-o, --output string filesystem path to write files to
|
||||||
-h, --help help for convert
|
--unsafe enable less safe operations, please backup first
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
|
||||||
-o, --output string filesystem path to write files to
|
|
||||||
-s, --source string filesystem path to read files relative from
|
|
||||||
--themesDir string filesystem path to themes directory
|
|
||||||
--unsafe enable less safe operations, please backup first
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options inherited from parent commands
|
### Options inherited from parent commands
|
||||||
|
|
||||||
```
|
```
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
||||||
--configDir string config dir (default "config")
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--debug debug output
|
--configDir string config dir (default "config")
|
||||||
--log enable Logging
|
--debug debug output
|
||||||
--logFile string log File path (if set, logging enabled automatically)
|
-d, --destination string filesystem path to write files to
|
||||||
--quiet build in quiet mode
|
-e, --environment string build environment
|
||||||
-v, --verbose verbose output
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--verboseLog verbose logging
|
--log enable Logging
|
||||||
|
--logFile string log File path (if set, logging enabled automatically)
|
||||||
|
--quiet build in quiet mode
|
||||||
|
-s, --source string filesystem path to read files relative from
|
||||||
|
--themesDir string filesystem path to themes directory
|
||||||
|
-v, --verbose verbose output
|
||||||
|
--verboseLog verbose logging
|
||||||
```
|
```
|
||||||
|
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
|
|
|
@ -13,7 +13,7 @@ toJSON converts all front matter in the content directory
|
||||||
to use JSON for the front matter.
|
to use JSON for the front matter.
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo convert toJSON [flags]
|
hugo convert toJSON [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -29,6 +29,7 @@ hugo convert toJSON [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -13,7 +13,7 @@ toTOML converts all front matter in the content directory
|
||||||
to use TOML for the front matter.
|
to use TOML for the front matter.
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo convert toTOML [flags]
|
hugo convert toTOML [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -29,6 +29,7 @@ hugo convert toTOML [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -13,7 +13,7 @@ toYAML converts all front matter in the content directory
|
||||||
to use YAML for the front matter.
|
to use YAML for the front matter.
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo convert toYAML [flags]
|
hugo convert toYAML [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -29,6 +29,7 @@ hugo convert toYAML [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -16,38 +16,39 @@ documentation.
|
||||||
|
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo deploy [flags]
|
hugo deploy [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
|
||||||
```
|
```
|
||||||
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
--confirm ask for confirmation before making changes to the target
|
||||||
--confirm ask for confirmation before making changes to the target
|
--dryRun dry run
|
||||||
--dryRun dry run
|
--force force upload of all files
|
||||||
-e, --environment string build environment
|
-h, --help help for deploy
|
||||||
--force force upload of all files
|
--invalidateCDN invalidate the CDN cache listed in the deployment target (default true)
|
||||||
-h, --help help for deploy
|
--maxDeletes int maximum # of files to delete, or -1 to disable (default 256)
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--target string target deployment from deployments section in config file; defaults to the first one
|
||||||
--invalidateCDN invalidate the CDN cache listed in the deployment target (default true)
|
--workers int number of workers to transfer files. defaults to 10 (default 10)
|
||||||
--maxDeletes int maximum # of files to delete, or -1 to disable (default 256)
|
|
||||||
--workers int number of workers to transfer files. (default 10)
|
|
||||||
-s, --source string filesystem path to read files relative from
|
|
||||||
--target string target deployment from deployments section in config file; defaults to the first one
|
|
||||||
--themesDir string filesystem path to themes directory
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options inherited from parent commands
|
### Options inherited from parent commands
|
||||||
|
|
||||||
```
|
```
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
||||||
--configDir string config dir (default "config")
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--debug debug output
|
--configDir string config dir (default "config")
|
||||||
--log enable Logging
|
--debug debug output
|
||||||
--logFile string log File path (if set, logging enabled automatically)
|
-d, --destination string filesystem path to write files to
|
||||||
--quiet build in quiet mode
|
-e, --environment string build environment
|
||||||
-v, --verbose verbose output
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--verboseLog verbose logging
|
--log enable Logging
|
||||||
|
--logFile string log File path (if set, logging enabled automatically)
|
||||||
|
--quiet build in quiet mode
|
||||||
|
-s, --source string filesystem path to read files relative from
|
||||||
|
--themesDir string filesystem path to themes directory
|
||||||
|
-v, --verbose verbose output
|
||||||
|
--verboseLog verbose logging
|
||||||
```
|
```
|
||||||
|
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
|
|
|
@ -9,13 +9,10 @@ Print Hugo version and environment info
|
||||||
|
|
||||||
### Synopsis
|
### Synopsis
|
||||||
|
|
||||||
Print Hugo version and environment info. This is useful in Hugo bug reports.
|
Print Hugo version and environment info. This is useful in Hugo bug reports
|
||||||
|
|
||||||
If you add the -v flag, you will get a full dependency list.
|
|
||||||
|
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo env [flags]
|
hugo env [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -31,6 +28,7 @@ hugo env [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -7,6 +7,10 @@ url: /commands/hugo_gen/
|
||||||
|
|
||||||
A collection of several useful generators.
|
A collection of several useful generators.
|
||||||
|
|
||||||
|
```
|
||||||
|
hugo gen [command] [flags]
|
||||||
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
|
||||||
```
|
```
|
||||||
|
@ -20,6 +24,7 @@ A collection of several useful generators.
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -14,7 +14,7 @@ Generate CSS stylesheet for the Chroma code highlighter for a given style. This
|
||||||
See https://xyproto.github.io/splash/docs/all.html for a preview of the available styles
|
See https://xyproto.github.io/splash/docs/all.html for a preview of the available styles
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo gen chromastyles [flags]
|
hugo gen chromastyles [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -33,6 +33,7 @@ hugo gen chromastyles [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -10,15 +10,14 @@ Generate Markdown documentation for the Hugo CLI.
|
||||||
### Synopsis
|
### Synopsis
|
||||||
|
|
||||||
Generate Markdown documentation for the Hugo CLI.
|
Generate Markdown documentation for the Hugo CLI.
|
||||||
|
This command is, mostly, used to create up-to-date documentation
|
||||||
|
of Hugo's command-line interface for https://gohugo.io/.
|
||||||
|
|
||||||
This command is, mostly, used to create up-to-date documentation
|
It creates one Markdown file per command with front matter suitable
|
||||||
of Hugo's command-line interface for https://gohugo.io/.
|
for rendering in Hugo.
|
||||||
|
|
||||||
It creates one Markdown file per command with front matter suitable
|
|
||||||
for rendering in Hugo.
|
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo gen doc [flags]
|
hugo gen doc [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -35,6 +34,7 @@ hugo gen doc [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -10,11 +10,11 @@ Generate man pages for the Hugo CLI
|
||||||
### Synopsis
|
### Synopsis
|
||||||
|
|
||||||
This command automatically generates up-to-date man pages of Hugo's
|
This command automatically generates up-to-date man pages of Hugo's
|
||||||
command-line interface. By default, it creates the man page files
|
command-line interface. By default, it creates the man page files
|
||||||
in the "man" directory under the current directory.
|
in the "man" directory under the current directory.
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo gen man [flags]
|
hugo gen man [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -31,6 +31,7 @@ hugo gen man [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -13,6 +13,10 @@ Import your site from other web site generators like Jekyll.
|
||||||
|
|
||||||
Import requires a subcommand, e.g. `hugo import jekyll jekyll_root_path target_path`.
|
Import requires a subcommand, e.g. `hugo import jekyll jekyll_root_path target_path`.
|
||||||
|
|
||||||
|
```
|
||||||
|
hugo import [command] [flags]
|
||||||
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
|
||||||
```
|
```
|
||||||
|
@ -26,6 +30,7 @@ Import requires a subcommand, e.g. `hugo import jekyll jekyll_root_path target_p
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -14,7 +14,7 @@ hugo import from Jekyll.
|
||||||
Import from Jekyll requires two paths, e.g. `hugo import jekyll jekyll_root_path target_path`.
|
Import from Jekyll requires two paths, e.g. `hugo import jekyll jekyll_root_path target_path`.
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo import jekyll [flags]
|
hugo import jekyll [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -31,6 +31,7 @@ hugo import jekyll [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -11,30 +11,35 @@ Listing out various types of content
|
||||||
|
|
||||||
Listing out various types of content.
|
Listing out various types of content.
|
||||||
|
|
||||||
List requires a subcommand, e.g. `hugo list drafts`.
|
List requires a subcommand, e.g. hugo list drafts
|
||||||
|
|
||||||
|
```
|
||||||
|
hugo list [command] [flags]
|
||||||
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
|
||||||
```
|
```
|
||||||
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
-h, --help help for list
|
||||||
-e, --environment string build environment
|
|
||||||
-h, --help help for list
|
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
|
||||||
-s, --source string filesystem path to read files relative from
|
|
||||||
--themesDir string filesystem path to themes directory
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options inherited from parent commands
|
### Options inherited from parent commands
|
||||||
|
|
||||||
```
|
```
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
||||||
--configDir string config dir (default "config")
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--debug debug output
|
--configDir string config dir (default "config")
|
||||||
--log enable Logging
|
--debug debug output
|
||||||
--logFile string log File path (if set, logging enabled automatically)
|
-d, --destination string filesystem path to write files to
|
||||||
--quiet build in quiet mode
|
-e, --environment string build environment
|
||||||
-v, --verbose verbose output
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--verboseLog verbose logging
|
--log enable Logging
|
||||||
|
--logFile string log File path (if set, logging enabled automatically)
|
||||||
|
--quiet build in quiet mode
|
||||||
|
-s, --source string filesystem path to read files relative from
|
||||||
|
--themesDir string filesystem path to themes directory
|
||||||
|
-v, --verbose verbose output
|
||||||
|
--verboseLog verbose logging
|
||||||
```
|
```
|
||||||
|
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
|
|
|
@ -12,7 +12,7 @@ List all posts
|
||||||
List all of the posts in your content directory, include drafts, future and expired pages.
|
List all of the posts in your content directory, include drafts, future and expired pages.
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo list all [flags]
|
hugo list all [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -28,6 +28,7 @@ hugo list all [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -12,7 +12,7 @@ List all drafts
|
||||||
List all of the drafts in your content directory.
|
List all of the drafts in your content directory.
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo list drafts [flags]
|
hugo list drafts [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -28,6 +28,7 @@ hugo list drafts [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -12,7 +12,7 @@ List all posts already expired
|
||||||
List all of the posts in your content directory which has already expired.
|
List all of the posts in your content directory which has already expired.
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo list expired [flags]
|
hugo list expired [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -28,6 +28,7 @@ hugo list expired [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -12,7 +12,7 @@ List all posts dated in the future
|
||||||
List all of the posts in your content directory which will be posted in the future.
|
List all of the posts in your content directory which will be posted in the future.
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo list future [flags]
|
hugo list future [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -28,6 +28,7 @@ hugo list future [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -10,7 +10,6 @@ Various Hugo Modules helpers.
|
||||||
### Synopsis
|
### Synopsis
|
||||||
|
|
||||||
Various helpers to help manage the modules in your project's dependency graph.
|
Various helpers to help manage the modules in your project's dependency graph.
|
||||||
|
|
||||||
Most operations here requires a Go version installed on your system (>= Go 1.12) and the relevant VCS client (typically Git).
|
Most operations here requires a Go version installed on your system (>= Go 1.12) and the relevant VCS client (typically Git).
|
||||||
This is not needed if you only operate on modules inside /themes or if you have vendored them via "hugo mod vendor".
|
This is not needed if you only operate on modules inside /themes or if you have vendored them via "hugo mod vendor".
|
||||||
|
|
||||||
|
@ -26,53 +25,26 @@ See https://gohugo.io/hugo-modules/ for more information.
|
||||||
### Options
|
### Options
|
||||||
|
|
||||||
```
|
```
|
||||||
-b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/
|
-h, --help help for mod
|
||||||
-D, --buildDrafts include content marked as draft
|
|
||||||
-E, --buildExpired include expired content
|
|
||||||
-F, --buildFuture include content with publishdate in the future
|
|
||||||
--cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
|
|
||||||
--cleanDestinationDir remove files from destination not found in static directories
|
|
||||||
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
|
||||||
-c, --contentDir string filesystem path to content directory
|
|
||||||
-d, --destination string filesystem path to write files to
|
|
||||||
--disableKinds strings disable different kind of pages (home, RSS etc.)
|
|
||||||
--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.
|
|
||||||
--gc enable to run some cleanup tasks (remove unused cache files) after the build
|
|
||||||
-h, --help help for mod
|
|
||||||
--ignoreCache ignores the cache directory
|
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
|
||||||
-l, --layoutDir string filesystem path to layout directory
|
|
||||||
--minify minify any supported output format (HTML, XML etc.)
|
|
||||||
--noBuildLock don't create .hugo_build.lock file
|
|
||||||
--noChmod don't sync permission mode of files
|
|
||||||
--noTimes don't sync modification time of files
|
|
||||||
--panicOnWarning panic on first WARNING log
|
|
||||||
--poll string set this to a poll interval, e.g --poll 700ms, to use a poll based approach to watch for file system changes
|
|
||||||
--printI18nWarnings print missing translations
|
|
||||||
--printMemoryUsage print memory usage to screen at intervals
|
|
||||||
--printPathWarnings print warnings on duplicate target paths etc.
|
|
||||||
--printUnusedTemplates print warnings on unused templates.
|
|
||||||
-s, --source string filesystem path to read files relative from
|
|
||||||
--templateMetrics display metrics about template executions
|
|
||||||
--templateMetricsHints calculate some improvement hints when combined with --templateMetrics
|
|
||||||
-t, --theme strings themes to use (located in /themes/THEMENAME/)
|
|
||||||
--themesDir string filesystem path to themes directory
|
|
||||||
--trace file write trace to file (not useful in general)
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options inherited from parent commands
|
### Options inherited from parent commands
|
||||||
|
|
||||||
```
|
```
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
||||||
--configDir string config dir (default "config")
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--debug debug output
|
--configDir string config dir (default "config")
|
||||||
--log enable Logging
|
--debug debug output
|
||||||
--logFile string log File path (if set, logging enabled automatically)
|
-d, --destination string filesystem path to write files to
|
||||||
--quiet build in quiet mode
|
-e, --environment string build environment
|
||||||
-v, --verbose verbose output
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--verboseLog verbose logging
|
--log enable Logging
|
||||||
|
--logFile string log File path (if set, logging enabled automatically)
|
||||||
|
--quiet build in quiet mode
|
||||||
|
-s, --source string filesystem path to read files relative from
|
||||||
|
--themesDir string filesystem path to themes directory
|
||||||
|
-v, --verbose verbose output
|
||||||
|
--verboseLog verbose logging
|
||||||
```
|
```
|
||||||
|
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
|
|
|
@ -11,14 +11,8 @@ Delete the Hugo Module cache for the current project.
|
||||||
|
|
||||||
Delete the Hugo Module cache for the current project.
|
Delete the Hugo Module cache for the current project.
|
||||||
|
|
||||||
Note that after you run this command, all of your dependencies will be re-downloaded next time you run "hugo".
|
|
||||||
|
|
||||||
Also note that if you configure a positive maxAge for the "modules" file cache, it will also be cleaned as part of "hugo --gc".
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo mod clean [flags]
|
hugo mod clean [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -36,6 +30,7 @@ hugo mod clean [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -38,7 +38,7 @@ See https://gohugo.io/hugo-modules/ for more information.
|
||||||
|
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo mod get [flags]
|
hugo mod get [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -54,6 +54,7 @@ hugo mod get [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -14,13 +14,14 @@ Note that for vendored modules, that is the version listed and not the one from
|
||||||
|
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo mod graph [flags]
|
hugo mod graph [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
|
||||||
```
|
```
|
||||||
-h, --help help for graph
|
--clean delete module cache for dependencies that fail verification
|
||||||
|
-h, --help help for graph
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options inherited from parent commands
|
### Options inherited from parent commands
|
||||||
|
@ -30,6 +31,7 @@ hugo mod graph [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -10,16 +10,16 @@ Initialize this project as a Hugo Module.
|
||||||
### Synopsis
|
### Synopsis
|
||||||
|
|
||||||
Initialize this project as a Hugo Module.
|
Initialize this project as a Hugo Module.
|
||||||
It will try to guess the module path, but you may help by passing it as an argument, e.g:
|
It will try to guess the module path, but you may help by passing it as an argument, e.g:
|
||||||
|
|
||||||
hugo mod init github.com/gohugoio/testshortcodes
|
hugo mod init github.com/gohugoio/testshortcodes
|
||||||
|
|
||||||
Note that Hugo Modules supports multi-module projects, so you can initialize a Hugo Module
|
Note that Hugo Modules supports multi-module projects, so you can initialize a Hugo Module
|
||||||
inside a subfolder on GitHub, as one example.
|
inside a subfolder on GitHub, as one example.
|
||||||
|
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo mod init [flags]
|
hugo mod init [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -35,6 +35,7 @@ hugo mod init [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -12,7 +12,7 @@ Various npm helpers.
|
||||||
Various npm (Node package manager) helpers.
|
Various npm (Node package manager) helpers.
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo mod npm [flags]
|
hugo mod npm [command] [flags]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -28,6 +28,7 @@ hugo mod npm [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -22,7 +22,7 @@ so this may/will change in future versions of Hugo.
|
||||||
|
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo mod npm pack [flags]
|
hugo mod npm pack [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -38,6 +38,7 @@ hugo mod npm pack [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -8,7 +8,7 @@ url: /commands/hugo_mod_tidy/
|
||||||
Remove unused entries in go.mod and go.sum.
|
Remove unused entries in go.mod and go.sum.
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo mod tidy [flags]
|
hugo mod tidy [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -24,6 +24,7 @@ hugo mod tidy [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -10,12 +10,11 @@ Vendor all module dependencies into the _vendor directory.
|
||||||
### Synopsis
|
### Synopsis
|
||||||
|
|
||||||
Vendor all module dependencies into the _vendor directory.
|
Vendor all module dependencies into the _vendor directory.
|
||||||
|
If a module is vendored, that is where Hugo will look for it's dependencies.
|
||||||
If a module is vendored, that is where Hugo will look for it's dependencies.
|
|
||||||
|
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo mod vendor [flags]
|
hugo mod vendor [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -31,6 +30,7 @@ hugo mod vendor [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -11,9 +11,8 @@ Verify dependencies.
|
||||||
|
|
||||||
Verify checks that the dependencies of the current module, which are stored in a local downloaded source cache, have not been modified since being downloaded.
|
Verify checks that the dependencies of the current module, which are stored in a local downloaded source cache, have not been modified since being downloaded.
|
||||||
|
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo mod verify [flags]
|
hugo mod verify [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -30,6 +29,7 @@ hugo mod verify [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
|
@ -19,67 +19,38 @@ If archetypes are provided in your theme or site, they will be used.
|
||||||
Ensure you run this within the root directory of your site.
|
Ensure you run this within the root directory of your site.
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo new [path] [flags]
|
hugo new [command] [flags]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
|
||||||
```
|
```
|
||||||
-b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/
|
-h, --help help for new
|
||||||
-D, --buildDrafts include content marked as draft
|
|
||||||
-E, --buildExpired include expired content
|
|
||||||
-F, --buildFuture include content with publishdate in the future
|
|
||||||
--cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
|
|
||||||
--cleanDestinationDir remove files from destination not found in static directories
|
|
||||||
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
|
||||||
-c, --contentDir string filesystem path to content directory
|
|
||||||
-d, --destination string filesystem path to write files to
|
|
||||||
--disableKinds strings disable different kind of pages (home, RSS etc.)
|
|
||||||
--editor string edit new content with this editor, if provided
|
|
||||||
--enableGitInfo add Git revision, date, author, and CODEOWNERS info to the pages
|
|
||||||
-e, --environment string build environment
|
|
||||||
-f, --force overwrite file if it already exists
|
|
||||||
--forceSyncStatic copy all files when static is changed.
|
|
||||||
--gc enable to run some cleanup tasks (remove unused cache files) after the build
|
|
||||||
-h, --help help for new
|
|
||||||
--ignoreCache ignores the cache directory
|
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
|
||||||
-k, --kind string content type to create
|
|
||||||
-l, --layoutDir string filesystem path to layout directory
|
|
||||||
--minify minify any supported output format (HTML, XML etc.)
|
|
||||||
--noBuildLock don't create .hugo_build.lock file
|
|
||||||
--noChmod don't sync permission mode of files
|
|
||||||
--noTimes don't sync modification time of files
|
|
||||||
--panicOnWarning panic on first WARNING log
|
|
||||||
--poll string set this to a poll interval, e.g --poll 700ms, to use a poll based approach to watch for file system changes
|
|
||||||
--printI18nWarnings print missing translations
|
|
||||||
--printMemoryUsage print memory usage to screen at intervals
|
|
||||||
--printPathWarnings print warnings on duplicate target paths etc.
|
|
||||||
--printUnusedTemplates print warnings on unused templates.
|
|
||||||
-s, --source string filesystem path to read files relative from
|
|
||||||
--templateMetrics display metrics about template executions
|
|
||||||
--templateMetricsHints calculate some improvement hints when combined with --templateMetrics
|
|
||||||
-t, --theme strings themes to use (located in /themes/THEMENAME/)
|
|
||||||
--themesDir string filesystem path to themes directory
|
|
||||||
--trace file write trace to file (not useful in general)
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options inherited from parent commands
|
### Options inherited from parent commands
|
||||||
|
|
||||||
```
|
```
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
||||||
--configDir string config dir (default "config")
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--debug debug output
|
--configDir string config dir (default "config")
|
||||||
--log enable Logging
|
--debug debug output
|
||||||
--logFile string log File path (if set, logging enabled automatically)
|
-d, --destination string filesystem path to write files to
|
||||||
--quiet build in quiet mode
|
-e, --environment string build environment
|
||||||
-v, --verbose verbose output
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--verboseLog verbose logging
|
--log enable Logging
|
||||||
|
--logFile string log File path (if set, logging enabled automatically)
|
||||||
|
--quiet build in quiet mode
|
||||||
|
-s, --source string filesystem path to read files relative from
|
||||||
|
--themesDir string filesystem path to themes directory
|
||||||
|
-v, --verbose verbose output
|
||||||
|
--verboseLog verbose logging
|
||||||
```
|
```
|
||||||
|
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
|
|
||||||
* [hugo](/commands/hugo/) - hugo builds your site
|
* [hugo](/commands/hugo/) - hugo builds your site
|
||||||
|
* [hugo new content](/commands/hugo_new_content/) - Create new content for your site
|
||||||
* [hugo new site](/commands/hugo_new_site/) - Create a new site (skeleton)
|
* [hugo new site](/commands/hugo_new_site/) - Create a new site (skeleton)
|
||||||
* [hugo new theme](/commands/hugo_new_theme/) - Create a new theme
|
* [hugo new theme](/commands/hugo_new_theme/) - Create a new site (skeleton)
|
||||||
|
|
||||||
|
|
56
docs/content/en/commands/hugo_new_content.md
Normal file
56
docs/content/en/commands/hugo_new_content.md
Normal file
|
@ -0,0 +1,56 @@
|
||||||
|
---
|
||||||
|
title: "hugo new content"
|
||||||
|
slug: hugo_new_content
|
||||||
|
url: /commands/hugo_new_content/
|
||||||
|
---
|
||||||
|
## hugo new content
|
||||||
|
|
||||||
|
Create new content for your site
|
||||||
|
|
||||||
|
### Synopsis
|
||||||
|
|
||||||
|
Create a new content file and automatically set the date and title.
|
||||||
|
It will guess which kind of file to create based on the path provided.
|
||||||
|
|
||||||
|
You can also specify the kind with `-k KIND`.
|
||||||
|
|
||||||
|
If archetypes are provided in your theme or site, they will be used.
|
||||||
|
|
||||||
|
Ensure you run this within the root directory of your site.
|
||||||
|
|
||||||
|
```
|
||||||
|
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
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options inherited from parent commands
|
||||||
|
|
||||||
|
```
|
||||||
|
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
||||||
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
|
--configDir string config dir (default "config")
|
||||||
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
|
-e, --environment string build environment
|
||||||
|
--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)
|
||||||
|
--quiet build in quiet mode
|
||||||
|
-s, --source string filesystem path to read files relative from
|
||||||
|
--themesDir string filesystem path to themes directory
|
||||||
|
-v, --verbose verbose output
|
||||||
|
--verboseLog verbose logging
|
||||||
|
```
|
||||||
|
|
||||||
|
### SEE ALSO
|
||||||
|
|
||||||
|
* [hugo new](/commands/hugo_new/) - Create new content for your site
|
||||||
|
|
|
@ -20,27 +20,28 @@ hugo new site [path] [flags]
|
||||||
### Options
|
### Options
|
||||||
|
|
||||||
```
|
```
|
||||||
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
--force init inside non-empty directory
|
||||||
-e, --environment string build environment
|
-f, --format string config file format (default "toml")
|
||||||
--force init inside non-empty directory
|
-h, --help help for site
|
||||||
-f, --format string config file format (default "toml")
|
|
||||||
-h, --help help for site
|
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
|
||||||
-s, --source string filesystem path to read files relative from
|
|
||||||
--themesDir string filesystem path to themes directory
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options inherited from parent commands
|
### Options inherited from parent commands
|
||||||
|
|
||||||
```
|
```
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
||||||
--configDir string config dir (default "config")
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--debug debug output
|
--configDir string config dir (default "config")
|
||||||
--log enable Logging
|
--debug debug output
|
||||||
--logFile string log File path (if set, logging enabled automatically)
|
-d, --destination string filesystem path to write files to
|
||||||
--quiet build in quiet mode
|
-e, --environment string build environment
|
||||||
-v, --verbose verbose output
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--verboseLog verbose logging
|
--log enable Logging
|
||||||
|
--logFile string log File path (if set, logging enabled automatically)
|
||||||
|
--quiet build in quiet mode
|
||||||
|
-s, --source string filesystem path to read files relative from
|
||||||
|
--themesDir string filesystem path to themes directory
|
||||||
|
-v, --verbose verbose output
|
||||||
|
--verboseLog verbose logging
|
||||||
```
|
```
|
||||||
|
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
|
|
|
@ -5,41 +5,41 @@ url: /commands/hugo_new_theme/
|
||||||
---
|
---
|
||||||
## hugo new theme
|
## hugo new theme
|
||||||
|
|
||||||
Create a new theme
|
Create a new site (skeleton)
|
||||||
|
|
||||||
### Synopsis
|
### Synopsis
|
||||||
|
|
||||||
Create a new theme (skeleton) called [name] in ./themes.
|
Create a new site in the provided directory.
|
||||||
New theme is a skeleton. Please add content to the touched files. Add your
|
The new site will have the correct structure, but no content or theme yet.
|
||||||
name to the copyright line in the license and adjust the theme.toml file
|
Use `hugo new [contentPath]` to create new content.
|
||||||
as you see fit.
|
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo new theme [name] [flags]
|
hugo new theme [path] [flags]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
|
||||||
```
|
```
|
||||||
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
-h, --help help for theme
|
||||||
-e, --environment string build environment
|
|
||||||
-h, --help help for theme
|
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
|
||||||
-s, --source string filesystem path to read files relative from
|
|
||||||
--themesDir string filesystem path to themes directory
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options inherited from parent commands
|
### Options inherited from parent commands
|
||||||
|
|
||||||
```
|
```
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
||||||
--configDir string config dir (default "config")
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--debug debug output
|
--configDir string config dir (default "config")
|
||||||
--log enable Logging
|
--debug debug output
|
||||||
--logFile string log File path (if set, logging enabled automatically)
|
-d, --destination string filesystem path to write files to
|
||||||
--quiet build in quiet mode
|
-e, --environment string build environment
|
||||||
-v, --verbose verbose output
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--verboseLog verbose logging
|
--log enable Logging
|
||||||
|
--logFile string log File path (if set, logging enabled automatically)
|
||||||
|
--quiet build in quiet mode
|
||||||
|
-s, --source string filesystem path to read files relative from
|
||||||
|
--themesDir string filesystem path to themes directory
|
||||||
|
-v, --verbose verbose output
|
||||||
|
--verboseLog verbose logging
|
||||||
```
|
```
|
||||||
|
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
|
|
|
@ -23,73 +23,73 @@ and push the latest content to them. As most Hugo sites are built in a fraction
|
||||||
of a second, you will be able to save and see your changes nearly instantly.
|
of a second, you will be able to save and see your changes nearly instantly.
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo server [flags]
|
hugo server [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
|
||||||
```
|
```
|
||||||
--appendPort append port to baseURL (default true)
|
--appendPort append port to baseURL (default true)
|
||||||
-b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/
|
-b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/
|
||||||
--bind string interface to which the server will bind (default "127.0.0.1")
|
--bind string interface to which the server will bind (default "127.0.0.1")
|
||||||
-D, --buildDrafts include content marked as draft
|
-D, --buildDrafts include content marked as draft
|
||||||
-E, --buildExpired include expired content
|
-E, --buildExpired include expired content
|
||||||
-F, --buildFuture include content with publishdate in the future
|
-F, --buildFuture include content with publishdate in the future
|
||||||
--cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
|
--cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache/
|
||||||
--cleanDestinationDir remove files from destination not found in static directories
|
--cleanDestinationDir remove files from destination not found in static directories
|
||||||
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
-c, --contentDir string filesystem path to content directory
|
||||||
-c, --contentDir string filesystem path to content directory
|
--disableBrowserError do not show build errors in the browser
|
||||||
-d, --destination string filesystem path to write files to
|
--disableFastRender enables full re-renders on changes
|
||||||
--disableBrowserError do not show build errors in the browser
|
--disableKinds strings disable different kind of pages (home, RSS etc.)
|
||||||
--disableFastRender enables full re-renders on changes
|
--disableLiveReload watch without enabling live browser reload on rebuild
|
||||||
--disableKinds strings disable different kind of pages (home, RSS etc.)
|
--enableGitInfo add Git revision, date, author, and CODEOWNERS info to the pages
|
||||||
--disableLiveReload watch without enabling live browser reload on rebuild
|
--forceSyncStatic copy all files when static is changed.
|
||||||
--enableGitInfo add Git revision, date, author, and CODEOWNERS info to the pages
|
--gc enable to run some cleanup tasks (remove unused cache files) after the build
|
||||||
-e, --environment string build environment
|
-h, --help help for server
|
||||||
--forceSyncStatic copy all files when static is changed.
|
--ignoreCache ignores the cache directory
|
||||||
--gc enable to run some cleanup tasks (remove unused cache files) after the build
|
-l, --layoutDir string filesystem path to layout directory
|
||||||
-h, --help help for server
|
--liveReloadPort int port for live reloading (i.e. 443 in HTTPS proxy situations) (default -1)
|
||||||
--ignoreCache ignores the cache directory
|
--meminterval string interval to poll memory usage (requires --memstats), valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h". (default "100ms")
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--memstats string log memory usage to this file
|
||||||
-l, --layoutDir string filesystem path to layout directory
|
--minify minify any supported output format (HTML, XML etc.)
|
||||||
--liveReloadPort int port for live reloading (i.e. 443 in HTTPS proxy situations) (default -1)
|
--navigateToChanged navigate to changed content file on live browser reload
|
||||||
--meminterval string interval to poll memory usage (requires --memstats), valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h". (default "100ms")
|
--noBuildLock don't create .hugo_build.lock file
|
||||||
--memstats string log memory usage to this file
|
--noChmod don't sync permission mode of files
|
||||||
--minify minify any supported output format (HTML, XML etc.)
|
--noHTTPCache prevent HTTP caching
|
||||||
--navigateToChanged navigate to changed content file on live browser reload
|
--noTimes don't sync modification time of files
|
||||||
--noBuildLock don't create .hugo_build.lock file
|
--panicOnWarning panic on first WARNING log
|
||||||
--noChmod don't sync permission mode of files
|
--poll string set this to a poll interval, e.g --poll 700ms, to use a poll based approach to watch for file system changes
|
||||||
--noHTTPCache prevent HTTP caching
|
-p, --port int port on which the server will listen (default 1313)
|
||||||
--noTimes don't sync modification time of files
|
--printI18nWarnings print missing translations
|
||||||
--panicOnWarning panic on first WARNING log
|
--printMemoryUsage print memory usage to screen at intervals
|
||||||
--poll string set this to a poll interval, e.g --poll 700ms, to use a poll based approach to watch for file system changes
|
--printPathWarnings print warnings on duplicate target paths etc.
|
||||||
-p, --port int port on which the server will listen (default 1313)
|
--printUnusedTemplates print warnings on unused templates.
|
||||||
--printI18nWarnings print missing translations
|
--renderStaticToDisk serve static files from disk and dynamic files from memory
|
||||||
--printMemoryUsage print memory usage to screen at intervals
|
--renderToDisk serve all files from disk (default is from memory)
|
||||||
--printPathWarnings print warnings on duplicate target paths etc.
|
--templateMetrics display metrics about template executions
|
||||||
--printUnusedTemplates print warnings on unused templates.
|
--templateMetricsHints calculate some improvement hints when combined with --templateMetrics
|
||||||
--renderStaticToDisk serve static files from disk and dynamic files from memory
|
-t, --theme strings themes to use (located in /themes/THEMENAME/)
|
||||||
--renderToDisk serve all files from disk (default is from memory)
|
--trace file write trace to file (not useful in general)
|
||||||
-s, --source string filesystem path to read files relative from
|
-w, --watch watch filesystem for changes and recreate as needed (default true)
|
||||||
--templateMetrics display metrics about template executions
|
|
||||||
--templateMetricsHints calculate some improvement hints when combined with --templateMetrics
|
|
||||||
-t, --theme strings themes to use (located in /themes/THEMENAME/)
|
|
||||||
--themesDir string filesystem path to themes directory
|
|
||||||
--trace file write trace to file (not useful in general)
|
|
||||||
-w, --watch watch filesystem for changes and recreate as needed (default true)
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options inherited from parent commands
|
### Options inherited from parent commands
|
||||||
|
|
||||||
```
|
```
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
||||||
--configDir string config dir (default "config")
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--debug debug output
|
--configDir string config dir (default "config")
|
||||||
--log enable Logging
|
--debug debug output
|
||||||
--logFile string log File path (if set, logging enabled automatically)
|
-d, --destination string filesystem path to write files to
|
||||||
--quiet build in quiet mode
|
-e, --environment string build environment
|
||||||
-v, --verbose verbose output
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--verboseLog verbose logging
|
--log enable Logging
|
||||||
|
--logFile string log File path (if set, logging enabled automatically)
|
||||||
|
--quiet build in quiet mode
|
||||||
|
-s, --source string filesystem path to read files relative from
|
||||||
|
--themesDir string filesystem path to themes directory
|
||||||
|
-v, --verbose verbose output
|
||||||
|
--verboseLog verbose logging
|
||||||
```
|
```
|
||||||
|
|
||||||
### SEE ALSO
|
### SEE ALSO
|
||||||
|
|
|
@ -5,14 +5,14 @@ url: /commands/hugo_version/
|
||||||
---
|
---
|
||||||
## hugo version
|
## hugo version
|
||||||
|
|
||||||
Print the version number of Hugo
|
Print Hugo version and environment info
|
||||||
|
|
||||||
### Synopsis
|
### Synopsis
|
||||||
|
|
||||||
All software has versions. This is Hugo's.
|
Print Hugo version and environment info. This is useful in Hugo bug reports.
|
||||||
|
|
||||||
```
|
```
|
||||||
hugo version [flags]
|
hugo version [flags] [args]
|
||||||
```
|
```
|
||||||
|
|
||||||
### Options
|
### Options
|
||||||
|
@ -28,6 +28,7 @@ hugo version [flags]
|
||||||
--config string config file (default is hugo.yaml|json|toml)
|
--config string config file (default is hugo.yaml|json|toml)
|
||||||
--configDir string config dir (default "config")
|
--configDir string config dir (default "config")
|
||||||
--debug debug output
|
--debug debug output
|
||||||
|
-d, --destination string filesystem path to write files to
|
||||||
-e, --environment string build environment
|
-e, --environment string build environment
|
||||||
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
--ignoreVendorPaths string ignores any _vendor for module paths matching the given Glob pattern
|
||||||
--log enable Logging
|
--log enable Logging
|
||||||
|
|
Loading…
Reference in a new issue