From 4d2992dce44d796cf406b11a13848d92f27260db Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Sat, 3 Feb 2024 10:36:07 -0800 Subject: [PATCH] MANUAL: Revised docs for fontfallback. Moved ConTeXt-specific docs to the ConTeXt variables section. --- MANUAL.txt | 17 ++++++++--------- 1 file 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)