Troubleshooting

If you see an error that LuaTeX can’t find a font  

swift-book-pdf will warn you if LuaTeX can’t find one of the required fonts for typesetting. Learn which fonts are required to typeset the TSPL book.

If you see an error that a font does not support some character  

swift-book-pdf will warn you if a font does not support a typeset character based on the assigned font category. If you’re using a custom font, switch to a font that supports the unsupported character.

If you’re using one of the default fonts supported by swift-book-pdf, open a ticket with details about the font you’re using and the character causing the issue.

Deprecation Note
Fonts Noto Sans CJK and Noto Serif CJK do not support the entire range of Unicode characters required for typesetting, and have been removed from the default fonts list in v1.3 and later. You might encounter typesetting errors if you do not specify another Unicode font with wider glyph support.

Upgrade to v1.3 or later to specify multiple Unicode fonts.

If swift-book-pdf hangs on a log line containing a font name  

Typesetting logs may hang shortly after swift-book-pdf starts creating your PDF document.

Examples of logs you might encounter:

Creating PDF...
  0%|                                                          | 0/4 [00:00<?, ?it/s]
For immediate help type H <return>.
 ...                                              
                                                  
l.169 \setmonofont{Menlo}[Scale=1]

Creating PDF...
  0%|                                                          | 0/4 [00:00<?, ?it/s]
For immediate help type H <return>.
 ...                                              
                                                  
l.172 ...moji{Apple Color Emoji}[Renderer=Harfbuzz]

This behavior indicates that one of the required fonts for typesetting is not accessible by LuaTeX. Learn which fonts are required for typesetting and how to make your fonts available to the typesetter.