2019-10-21 04:22:28 -04:00
|
|
|
---
|
|
|
|
title: "hugo mod"
|
|
|
|
slug: hugo_mod
|
|
|
|
url: /commands/hugo_mod/
|
|
|
|
---
|
|
|
|
## hugo mod
|
|
|
|
|
|
|
|
Various Hugo Modules helpers.
|
|
|
|
|
|
|
|
### Synopsis
|
|
|
|
|
|
|
|
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).
|
|
|
|
This is not needed if you only operate on modules inside /themes or if you have vendored them via "hugo mod vendor".
|
|
|
|
|
|
|
|
|
|
|
|
Note that Hugo will always start out by resolving the components defined in the site
|
2022-01-04 11:12:09 -05:00
|
|
|
configuration, provided by a _vendor directory (if no --ignoreVendorPaths flag provided),
|
2019-10-21 04:22:28 -04:00
|
|
|
Go Modules, or a folder inside the themes directory, in that order.
|
|
|
|
|
|
|
|
See https://gohugo.io/hugo-modules/ for more information.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Options
|
|
|
|
|
|
|
|
```
|
2022-03-26 05:05:30 -04:00
|
|
|
-b, --baseURL string hostname (and path) to the root, e.g. https://spf13.com/
|
2019-10-21 04:22:28 -04:00
|
|
|
-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
|
|
|
|
-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.)
|
2022-02-28 02:12:35 -05:00
|
|
|
--enableGitInfo add Git revision, date, author, and CODEOWNERS info to the pages
|
2019-10-21 04:22:28 -04:00
|
|
|
--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
|
|
|
|
-l, --layoutDir string filesystem path to layout directory
|
|
|
|
--minify minify any supported output format (HTML, XML etc.)
|
|
|
|
--noChmod don't sync permission mode of files
|
|
|
|
--noTimes don't sync modification time of files
|
2022-01-07 06:37:07 -05:00
|
|
|
--panicOnWarning panic on first WARNING log
|
2021-07-05 04:13:41 -04:00
|
|
|
--poll string set this to a poll interval, e.g --poll 700ms, to use a poll based approach to watch for file system changes
|
2022-02-15 07:03:36 -05:00
|
|
|
--printI18nWarnings print missing translations
|
2022-02-15 06:57:49 -05:00
|
|
|
--printMemoryUsage print memory usage to screen at intervals
|
|
|
|
--printPathWarnings print warnings on duplicate target paths etc.
|
2022-02-15 09:26:18 -05:00
|
|
|
--printUnusedTemplates print warnings on unused templates.
|
2019-10-21 04:22:28 -04:00
|
|
|
--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/)
|
|
|
|
--trace file write trace to file (not useful in general)
|
|
|
|
```
|
|
|
|
|
|
|
|
### Options inherited from parent commands
|
|
|
|
|
|
|
|
```
|
2022-05-08 10:57:29 -04:00
|
|
|
--clock string set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00
|
2020-10-06 10:22:20 -04:00
|
|
|
--config string config file (default is path/config.yaml|json|toml)
|
|
|
|
--configDir string config dir (default "config")
|
|
|
|
--debug debug output
|
|
|
|
-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
|
2019-10-21 04:22:28 -04:00
|
|
|
```
|
|
|
|
|
|
|
|
### SEE ALSO
|
|
|
|
|
|
|
|
* [hugo](/commands/hugo/) - hugo builds your site
|
2020-03-09 15:19:32 -04:00
|
|
|
* [hugo mod clean](/commands/hugo_mod_clean/) - Delete the Hugo Module cache for the current project.
|
2019-10-21 04:22:28 -04:00
|
|
|
* [hugo mod get](/commands/hugo_mod_get/) - Resolves dependencies in your current Hugo Project.
|
|
|
|
* [hugo mod graph](/commands/hugo_mod_graph/) - Print a module dependency graph.
|
|
|
|
* [hugo mod init](/commands/hugo_mod_init/) - Initialize this project as a Hugo Module.
|
2020-10-06 10:22:20 -04:00
|
|
|
* [hugo mod npm](/commands/hugo_mod_npm/) - Various npm helpers.
|
2019-10-21 04:22:28 -04:00
|
|
|
* [hugo mod tidy](/commands/hugo_mod_tidy/) - Remove unused entries in go.mod and go.sum.
|
|
|
|
* [hugo mod vendor](/commands/hugo_mod_vendor/) - Vendor all module dependencies into the _vendor directory.
|
2020-03-09 15:19:32 -04:00
|
|
|
* [hugo mod verify](/commands/hugo_mod_verify/) - Verify dependencies.
|
2019-10-21 04:22:28 -04:00
|
|
|
|