Skip to content

Commit

Permalink
clarify that color emoji fonts cannot be used with Asciidoctor PDF
Browse files Browse the repository at this point in the history
  • Loading branch information
mojavelinux committed Sep 17, 2023
1 parent 0f644a6 commit 6f307f9
Showing 1 changed file with 3 additions and 0 deletions.
3 changes: 3 additions & 0 deletions docs/modules/theme/pages/fallback-font.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,9 @@ IMPORTANT: When defining the fallback font, you *must specify all four variants*
IMPORTANT: The fallback font only gets used when the primary font is a TrueType or OpenType font (i.e., TTF, DFont, TTC, OTF).
Any glyph missing from an AFM font is simply replaced with the "`not`" glyph (`¬`).

WARNING: You cannot use a color emoji font as a fallback font in Asciidoctor PDF.
The font library used by Asciidoctor PDF does not support color fonts and will cause Asciidoctor to crash.

CAUTION: The `default` theme does not use a fallback font.
However, the built-in `default-with-font-fallbacks` theme does.
In fact, it provides two.
Expand Down

0 comments on commit 6f307f9

Please sign in to comment.