diff options
author | Erica Mays <erica@emays.dev> | 2023-06-10 13:25:07 -0400 |
---|---|---|
committer | Bjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com> | 2023-06-12 21:33:35 +0200 |
commit | 258884f44fc3ea6e4954936ddeb24e739eb8f58a (patch) | |
tree | 3f96e643dd97f0ebe275f49daa780dae7954d20a /docs | |
parent | 254c2b323cbc74b0decb29e5f7331f4b03914a9e (diff) |
cache: Set default cache path based on $USER
Change the default cache directory to `$TMPDIR/hugo_cache_$USER`, so
that multi-user systems do not have caches that interfere with each
other. The other cache-choosing logic (e.g. Netlify exceptions,
configuration options) are not affected.
Fixes #7391
Diffstat (limited to 'docs')
-rw-r--r-- | docs/content/en/commands/hugo.md | 2 | ||||
-rw-r--r-- | docs/content/en/commands/hugo_config.md | 2 | ||||
-rw-r--r-- | docs/content/en/commands/hugo_config_mounts.md | 2 | ||||
-rw-r--r-- | docs/content/en/commands/hugo_mod_clean.md | 2 | ||||
-rw-r--r-- | docs/content/en/commands/hugo_mod_graph.md | 2 | ||||
-rw-r--r-- | docs/content/en/commands/hugo_mod_init.md | 2 | ||||
-rw-r--r-- | docs/content/en/commands/hugo_mod_npm_pack.md | 2 | ||||
-rw-r--r-- | docs/content/en/commands/hugo_mod_tidy.md | 2 | ||||
-rw-r--r-- | docs/content/en/commands/hugo_mod_vendor.md | 2 | ||||
-rw-r--r-- | docs/content/en/commands/hugo_mod_verify.md | 2 | ||||
-rw-r--r-- | docs/content/en/commands/hugo_new_content.md | 2 | ||||
-rw-r--r-- | docs/content/en/commands/hugo_server.md | 2 | ||||
-rw-r--r-- | docs/content/en/getting-started/configuration.md | 2 | ||||
-rw-r--r-- | docs/content/en/templates/data-templates.md | 2 |
14 files changed, 14 insertions, 14 deletions
diff --git a/docs/content/en/commands/hugo.md b/docs/content/en/commands/hugo.md index 73d443169..8f3569abd 100644 --- a/docs/content/en/commands/hugo.md +++ b/docs/content/en/commands/hugo.md @@ -27,7 +27,7 @@ hugo [flags] -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/ + --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache_$USER/ --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 --config string config file (default is hugo.yaml|json|toml) diff --git a/docs/content/en/commands/hugo_config.md b/docs/content/en/commands/hugo_config.md index 42cd188b7..e3204ba1f 100644 --- a/docs/content/en/commands/hugo_config.md +++ b/docs/content/en/commands/hugo_config.md @@ -19,7 +19,7 @@ hugo config [command] [flags] ``` -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/ + --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache_$USER/ -c, --contentDir string filesystem path to content directory --format string preferred file format (toml, yaml or json) (default "toml") -h, --help help for config diff --git a/docs/content/en/commands/hugo_config_mounts.md b/docs/content/en/commands/hugo_config_mounts.md index e4c4cf8c5..70f975142 100644 --- a/docs/content/en/commands/hugo_config_mounts.md +++ b/docs/content/en/commands/hugo_config_mounts.md @@ -15,7 +15,7 @@ hugo config mounts [flags] [args] ``` -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/ + --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache_$USER/ -c, --contentDir string filesystem path to content directory -h, --help help for mounts -t, --theme strings themes to use (located in /themes/THEMENAME/) diff --git a/docs/content/en/commands/hugo_mod_clean.md b/docs/content/en/commands/hugo_mod_clean.md index 7878fe178..bb6b735b3 100644 --- a/docs/content/en/commands/hugo_mod_clean.md +++ b/docs/content/en/commands/hugo_mod_clean.md @@ -20,7 +20,7 @@ hugo mod clean [flags] [args] ``` --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/ + --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache_$USER/ -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*" diff --git a/docs/content/en/commands/hugo_mod_graph.md b/docs/content/en/commands/hugo_mod_graph.md index fa1d66602..26c89371e 100644 --- a/docs/content/en/commands/hugo_mod_graph.md +++ b/docs/content/en/commands/hugo_mod_graph.md @@ -21,7 +21,7 @@ hugo mod graph [flags] [args] ``` -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/ + --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache_$USER/ --clean delete module cache for dependencies that fail verification -c, --contentDir string filesystem path to content directory -h, --help help for graph diff --git a/docs/content/en/commands/hugo_mod_init.md b/docs/content/en/commands/hugo_mod_init.md index af1575b73..0def6b91c 100644 --- a/docs/content/en/commands/hugo_mod_init.md +++ b/docs/content/en/commands/hugo_mod_init.md @@ -26,7 +26,7 @@ hugo mod init [flags] [args] ``` -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/ + --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache_$USER/ -c, --contentDir string filesystem path to content directory -h, --help help for init -t, --theme strings themes to use (located in /themes/THEMENAME/) diff --git a/docs/content/en/commands/hugo_mod_npm_pack.md b/docs/content/en/commands/hugo_mod_npm_pack.md index 623649909..65404e009 100644 --- a/docs/content/en/commands/hugo_mod_npm_pack.md +++ b/docs/content/en/commands/hugo_mod_npm_pack.md @@ -29,7 +29,7 @@ hugo mod npm pack [flags] [args] ``` -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/ + --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache_$USER/ -c, --contentDir string filesystem path to content directory -h, --help help for pack -t, --theme strings themes to use (located in /themes/THEMENAME/) diff --git a/docs/content/en/commands/hugo_mod_tidy.md b/docs/content/en/commands/hugo_mod_tidy.md index 31558a55b..f58204a2b 100644 --- a/docs/content/en/commands/hugo_mod_tidy.md +++ b/docs/content/en/commands/hugo_mod_tidy.md @@ -15,7 +15,7 @@ hugo mod tidy [flags] [args] ``` -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/ + --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache_$USER/ -c, --contentDir string filesystem path to content directory -h, --help help for tidy -t, --theme strings themes to use (located in /themes/THEMENAME/) diff --git a/docs/content/en/commands/hugo_mod_vendor.md b/docs/content/en/commands/hugo_mod_vendor.md index 42d19b36e..d6e8ca0a1 100644 --- a/docs/content/en/commands/hugo_mod_vendor.md +++ b/docs/content/en/commands/hugo_mod_vendor.md @@ -21,7 +21,7 @@ hugo mod vendor [flags] [args] ``` -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/ + --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache_$USER/ -c, --contentDir string filesystem path to content directory -h, --help help for vendor -t, --theme strings themes to use (located in /themes/THEMENAME/) diff --git a/docs/content/en/commands/hugo_mod_verify.md b/docs/content/en/commands/hugo_mod_verify.md index 861ef5752..b71243246 100644 --- a/docs/content/en/commands/hugo_mod_verify.md +++ b/docs/content/en/commands/hugo_mod_verify.md @@ -19,7 +19,7 @@ hugo mod verify [flags] [args] ``` -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/ + --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache_$USER/ --clean delete module cache for dependencies that fail verification -c, --contentDir string filesystem path to content directory -h, --help help for verify diff --git a/docs/content/en/commands/hugo_new_content.md b/docs/content/en/commands/hugo_new_content.md index fdacc6596..c566b1e55 100644 --- a/docs/content/en/commands/hugo_new_content.md +++ b/docs/content/en/commands/hugo_new_content.md @@ -26,7 +26,7 @@ hugo new content [path] [flags] ``` -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/ + --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache_$USER/ -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 diff --git a/docs/content/en/commands/hugo_server.md b/docs/content/en/commands/hugo_server.md index d328ee685..19055825a 100644 --- a/docs/content/en/commands/hugo_server.md +++ b/docs/content/en/commands/hugo_server.md @@ -33,7 +33,7 @@ hugo server [command] [flags] -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/ + --cacheDir string filesystem path to cache directory. Defaults: $TMPDIR/hugo_cache_$USER/ --cleanDestinationDir remove files from destination not found in static directories -c, --contentDir string filesystem path to content directory --disableBrowserError do not show build errors in the browser diff --git a/docs/content/en/getting-started/configuration.md b/docs/content/en/getting-started/configuration.md index 2ab9e6a33..05465967a 100644 --- a/docs/content/en/getting-started/configuration.md +++ b/docs/content/en/getting-started/configuration.md @@ -807,7 +807,7 @@ You can override any of these cache settings in your own `hugo.toml`. ### The keywords explained `:cacheDir` -: This is the value of the `cacheDir` config option if set (can also be set via OS env variable `HUGO_CACHEDIR`). It will fall back to `/opt/build/cache/hugo_cache/` on Netlify, or a `hugo_cache` directory below the OS temp dir for the others. This means that if you run your builds on Netlify, all caches configured with `:cacheDir` will be saved and restored on the next build. For other CI vendors, please read their documentation. For an CircleCI example, see [this configuration](https://github.com/bep/hugo-sass-test/blob/6c3960a8f4b90e8938228688bc49bdcdd6b2d99e/.circleci/config.yml). +: This is the value of the `cacheDir` config option if set (can also be set via OS env variable `HUGO_CACHEDIR`). It will fall back to `/opt/build/cache/hugo_cache/` on Netlify, or a `hugo_cache_$USER` directory below the OS temp dir for the others. This means that if you run your builds on Netlify, all caches configured with `:cacheDir` will be saved and restored on the next build. For other CI vendors, please read their documentation. For an CircleCI example, see [this configuration](https://github.com/bep/hugo-sass-test/blob/6c3960a8f4b90e8938228688bc49bdcdd6b2d99e/.circleci/config.yml). `:project` : The base directory name of the current Hugo project. This means that, in its default setting, every project will have separated file caches, which means that when you do `hugo --gc` you will not touch files related to other Hugo projects running on the same PC. diff --git a/docs/content/en/templates/data-templates.md b/docs/content/en/templates/data-templates.md index ee44fb60e..c9b676a7d 100644 --- a/docs/content/en/templates/data-templates.md +++ b/docs/content/en/templates/data-templates.md @@ -209,7 +209,7 @@ The expression `{{ index $r number }}` must be used to output the nth-column fro ### Cache URLs -Each downloaded URL will be cached in the default folder `$TMPDIR/hugo_cache/`. The variable `$TMPDIR` will be resolved to your system-dependent temporary directory. +Each downloaded URL will be cached in the default folder `$TMPDIR/hugo_cache_$USER/`. The variable `$TMPDIR` will be resolved to your system-dependent temporary directory. With the command-line flag `--cacheDir`, you can specify any folder on your system as a caching directory. |