aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--config.json26
-rw-r--r--config.toml26
-rw-r--r--config.yaml20
-rw-r--r--content/canory/messages/cache.md35
-rw-r--r--content/canory/messages/gates.md2
-rw-r--r--content/canory/messages/hugo.md2
6 files changed, 109 insertions, 2 deletions
diff --git a/config.json b/config.json
index 3e6db0c..ad4a10f 100644
--- a/config.json
+++ b/config.json
@@ -245,6 +245,32 @@
"html"
]
},
+ "caches": {
+ "assets": {
+ "dir": ":resourceDir/_gen",
+ "maxAge": -1
+ },
+ "images": {
+ "dir": ":resourceDir/_gen",
+ "maxAge": -1
+ },
+ "getcsv": {
+ "dir": ":resourceDir/caches",
+ "maxAge": "12h"
+ },
+ "getjson": {
+ "dir": ":resourceDir/caches",
+ "maxAge": "12h"
+ },
+ "getresource": {
+ "dir": ":resourceDir/caches",
+ "maxAge": "12h"
+ },
+ "modules": {
+ "dir": ":resourceDir/caches",
+ "maxAge": -1
+ }
+ },
"module": {
"mounts": [
{
diff --git a/config.toml b/config.toml
index 2375ee2..fdfeccc 100644
--- a/config.toml
+++ b/config.toml
@@ -174,6 +174,32 @@ enableRobotsTXT = true
term = ["html", "rss"]
page = ["html"]
+[caches]
+
+ [caches.assets]
+ dir = ":resourceDir/_gen"
+ maxAge = -1
+
+ [caches.images]
+ dir = ":resourceDir/_gen"
+ maxAge = -1
+
+ [caches.getcsv]
+ dir = ":resourceDir/caches"
+ maxAge = "12h"
+
+ [caches.getjson]
+ dir = ":resourceDir/caches"
+ maxAge = "12h"
+
+ [caches.getresource]
+ dir = ":resourceDir/caches"
+ maxAge = "12h"
+
+ [caches.modules]
+ dir = ":resourceDir/caches"
+ maxAge = -1
+
[module]
[[module.mounts]]
diff --git a/config.yaml b/config.yaml
index a71f1d5..a297ded 100644
--- a/config.yaml
+++ b/config.yaml
@@ -168,6 +168,26 @@ outputs:
page:
- html
+caches:
+ assets:
+ dir: :resourceDir/_gen
+ maxAge: -1
+ images:
+ dir: :resourceDir/_gen
+ maxAge: -1
+ getcsv:
+ dir: :resourceDir/caches
+ maxAge: 12h
+ getjson:
+ dir: :resourceDir/caches
+ maxAge: 12h
+ getresource:
+ dir: :resourceDir/caches
+ maxAge: 12h
+ modules:
+ dir: :resourceDir/caches
+ maxAge: -1
+
module:
mounts:
- source: content
diff --git a/content/canory/messages/cache.md b/content/canory/messages/cache.md
new file mode 100644
index 0000000..cb408be
--- /dev/null
+++ b/content/canory/messages/cache.md
@@ -0,0 +1,35 @@
++++
+date = "2022-02-27T20:18:43+00:00"
+lastmod = "2022-02-27T20:18:43+00:00"
+tags = [ "docs", "cache" ]
+author = "canory"
++++
+
+Resource abuse is not good --- cache responsibly. In the `hugo` configuration
+file (config.yaml, config.json, config.toml) set the cache expiry time. The
+default is `12h` (12 hours) for remote fetches and `-1` (forever) for assets,
+images, and modules. The time scales are seconds (`s`), minutes (`m`), and hours
+(`h`). Turn off a cache by setting a max age of `0`.
+
+```yaml {options="hl_lines=9-17",caption="Caching Options"}
+---
+caches:
+ assets:
+ dir: :resourceDir/_gen
+ maxAge: -1
+ images:
+ dir: :resourceDir/_gen
+ maxAge: -1
+ getcsv:
+ dir: :resourceDir/caches
+ maxAge: 12h
+ getjson:
+ dir: :resourceDir/caches
+ maxAge: 12h
+ getresource:
+ dir: :resourceDir/caches
+ maxAge: 12h
+ modules:
+ dir: :resourceDir/caches
+ maxAge: -1
+```
diff --git a/content/canory/messages/gates.md b/content/canory/messages/gates.md
index d264b0b..ecb1aa9 100644
--- a/content/canory/messages/gates.md
+++ b/content/canory/messages/gates.md
@@ -7,7 +7,7 @@ author = "canory"
Satisfy the keepers of the gate by officially verifying ownership of your
property, uh, website. Put the verification code from their web mastery tools
-into your `hugo` configuration file (`config.yaml`, `config.json`,
+into the `hugo` configuration file (`config.yaml`, `config.json`,
`config.toml`).
```yaml
diff --git a/content/canory/messages/hugo.md b/content/canory/messages/hugo.md
index d8c1710..63698d6 100644
--- a/content/canory/messages/hugo.md
+++ b/content/canory/messages/hugo.md
@@ -1,7 +1,7 @@
+++
date = "2022-03-26T04:45:51+00:00"
lastmod = "2022-03-29T22:55:17+00:00"
-tags = [ "docs", "hugo" ]
+tags = [ "docs", "hugo" ]
author = "canory"
+++