aboutsummaryrefslogtreecommitdiff
path: root/MANUAL.txt
diff options
context:
space:
mode:
authorJohn MacFarlane <[email protected]>2025-05-11 18:10:11 -0700
committerJohn MacFarlane <[email protected]>2025-05-11 18:10:11 -0700
commit1239eaa4bea2074d658c3c9f4ad788c7cfef4873 (patch)
tree1afbedc1c171820fd276ea97aff55f07776b7783 /MANUAL.txt
parent5901d1ca86f0d6ec624751505940b49811013f64 (diff)
Add new option `--variable-json`.
This allows non-string values (booleans, lists, maps) to be given to template variables on the command line. Closes #10341. Supersedes #10342.
Diffstat (limited to 'MANUAL.txt')
-rw-r--r--MANUAL.txt11
1 files changed, 11 insertions, 0 deletions
diff --git a/MANUAL.txt b/MANUAL.txt
index 5025aba82..ef71be2aa 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -789,6 +789,17 @@ header when requesting a document from a URL:
`-V keyword=Joe -V author=Sue` makes `author` contain a list
of strings: `Joe` and `Sue`.
+`--variable-json=`*KEY*[`=`:*JSON*]
+
+: Set the template variable *KEY* to the value specified by a JSON
+ string (this may be a boolean, a string, a list, or a mapping;
+ a number will be treated as a string). For example,
+ `--variable-json foo=false` will give `foo` the boolean false
+ value, while `--variable-json foo='"false"'` will give it the
+ string value `"false"`. Either `:` or `=` may be used to
+ separate *KEY* from *VAL*. If the variable already has a
+ value, this value will be replaced.
+
`--sandbox[=true|false]`
: Run pandoc in a sandbox, limiting IO operations in readers