From 0286144b14ef7ce2a943999fc616c3c24be83c57 Mon Sep 17 00:00:00 2001
From: tdro <tdro@noreply.example.com>
Date: Sat, 28 May 2022 17:53:31 -0400
Subject: config: Set caches

---
 content/canory/messages/cache.md | 35 +++++++++++++++++++++++++++++++++++
 content/canory/messages/gates.md |  2 +-
 content/canory/messages/hugo.md  |  2 +-
 3 files changed, 37 insertions(+), 2 deletions(-)
 create mode 100644 content/canory/messages/cache.md

(limited to '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"
 +++
 
-- 
cgit v1.2.3