path: root/README
diff options
authormb21 <>2015-08-20 17:18:14 +0200
committermb21 <>2015-08-20 23:17:47 +0200
commit622df7034c96d1d0ba10b1ad654840ac93baf7f7 (patch)
treeae75659259149f7ed7627df8319277460fc2e39e /README
parenta0ddabb206e7a421a51f4ba148dbecdf0c115ca0 (diff)
`lang` variable is now in BCP47 format
strings are converted for LaTeX and ConTeXt output, closes #1614
Diffstat (limited to 'README')
1 files changed, 16 insertions, 4 deletions
diff --git a/README b/README
index 5a75c5a0b..da9bfea03 100644
--- a/README
+++ b/README
@@ -945,7 +945,19 @@ as `title`, `author`, and `date`) as well as the following:
: body of document
-: language code for HTML or LaTeX documents
+: The `lang` variable should be set by the user to a language
+ code according to [BCP 47] (e.g. `en` or `en-GB`).
+ For some output formats, pandoc will convert it to an approriate
+ format stored in the additional variables `babel-lang`,
+ `polyglossia-lang`, `polyglossia-variant` (LaTeX)
+ and `context-lang` (ConTeXt).
+: Should be set to a list of other languages used in the document
+ in the YAML metadata, according to [BCP 47]. For example:
+ `otherlangs: [en-GB, fr]`.
+ Currently only used by XeTeX through the generated
+ `polyglossia-otherlangs` variable.
: base URL for Slidy documents (defaults to
@@ -3264,8 +3276,8 @@ The following fields are recognized:
~ A string value in `YYYY-MM-DD` format. (Only the year is necessary.)
Pandoc will attempt to convert other common date formats.
- ~ A string value in [RFC5646] format. Pandoc will default to the local
+`lang` (or legacy: `language`)
+ ~ A string value in [BCP 47] format. Pandoc will default to the local
language if nothing is specified.
@@ -3549,7 +3561,7 @@ Xavier Olive.
[marc relators]:
+[BCP 47]:
[InDesign ICML]: