summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJohn MacFarlane <jgm@berkeley.edu>2024-02-03 10:36:07 -0800
committerJohn MacFarlane <jgm@berkeley.edu>2024-02-03 10:36:07 -0800
commit4d2992dce44d796cf406b11a13848d92f27260db (patch)
treeb388d498a2adb1a6ddae26d55acab2c4920e4982
parent7164a238ddd2da25b302e1ff44970a8c43912911 (diff)
MANUAL: Revised docs for fontfallback.
Moved ConTeXt-specific docs to the ConTeXt variables section.
-rw-r--r--MANUAL.txt17
1 files changed, 8 insertions, 9 deletions
diff --git a/MANUAL.txt b/MANUAL.txt
index ac2b31d3e..d03d10c5c 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -2940,8 +2940,8 @@ Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
`mainfontfallback`, `sansfontfallback`, `monofontfallback`
: fonts to try if a glyph isn't found in `mainfont`, `sansfont`, or `monofont`
- respectively. These are lists. The syntax for the font names depends on the
- PDF engine used, e.g. for `--pdf-engine=lualatex`:
+ respectively. These are lists. The font name must be followed by a colon
+ and optionally a set of options, for example:
---
mainfontfallback:
@@ -2949,13 +2949,7 @@ Pandoc uses these variables when [creating a PDF] with a LaTeX engine.
- "NotoColorEmoji:mode=harf"
...
- Font fallbacks currently only work with `lualatex`[^lltx-ff-notes]
- or `context`[^cntx-ff-notes]
-
-[^lltx-ff-notes]: Use `\fontspec`-compatible font name syntax, and also set `mainfont` YAML metadata.
-
-[^cntx-ff-notes]: Use `\definefallbackfamily`-compatible font name syntax.
- [Emoji fonts are unsupported.](https://github.com/jgm/pandoc/pull/9361#issuecomment-1910564364)
+ Font fallbacks currently only work with `lualatex`.
`babelfonts`
: a map of Babel language names (e.g. `chinese`) to the font
@@ -3073,6 +3067,11 @@ Pandoc uses these variables when [creating a PDF] with ConTeXt.
: font families: take the name of any system font (see
[ConTeXt Font Switching])
+`mainfontfallback`, `sansfontfallback`, `monofontfallback`
+: list of fonts to try, in order, if a glyph is not found in the
+ main font. Use `\definefallbackfamily`-compatible font name syntax.
+ Emoji fonts are unsupported.
+
`margin-left`, `margin-right`, `margin-top`, `margin-bottom`
: sets margins, if `layout` is not used (otherwise `layout`
overrides these)