aboutsummaryrefslogtreecommitdiff
path: root/MANUAL.txt
diff options
context:
space:
mode:
authorJohn MacFarlane <jgm@berkeley.edu>2021-03-05 11:56:41 -0800
committerJohn MacFarlane <jgm@berkeley.edu>2021-03-05 11:56:41 -0800
commitdf00cf05cbf817b7d8e7de0a4a220dd70f8a9608 (patch)
tree98ac261dccf4c7b13055b4571f189e15095b590a /MANUAL.txt
parent6dd7520cc4b3816ae13ec486ce0909b9b881d240 (diff)
downloadpandoc-df00cf05cbf817b7d8e7de0a4a220dd70f8a9608.tar.gz
Allow `${.}` in defaults files paths...
to refer to the directory where the default file is. This will make it possible to create moveable "packages" of resources in a directory. Closes #5871.
Diffstat (limited to 'MANUAL.txt')
-rw-r--r--MANUAL.txt13
1 files changed, 13 insertions, 0 deletions
diff --git a/MANUAL.txt b/MANUAL.txt
index f06293dd3..8e98ee1eb 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -1684,6 +1684,19 @@ user data directory that is current when the defaults file is
parsed, regardless of the setting of the environment
variable `USERDATA`.
+`${.}` will resolve to the directory containing the default
+file itself. This allows you to refer to resources contained
+in that directory:
+
+``` yaml
+epub-cover-image: ${.}/cover.jpg
+epub-metadata: ${.}/meta.xml
+resource-path:
+- . # the working directory from which pandoc is run
+- ${.}/images # the images subdirectory of the directory
+ # containing this defaults file
+```
+
This environment variable interpolation syntax *only* works in
fields that expect file paths.