diff options
| author | Dan Allen <dan@opendevise.com> | 2021-03-04 12:44:53 -0700 |
|---|---|---|
| committer | Dan Allen <dan@opendevise.com> | 2021-03-04 12:46:09 -0700 |
| commit | af875f7840930d6a91d630afb66391cfd7df9d71 (patch) | |
| tree | a78f8c03a340ba48fb79b5e1ba537a3f51d99f8f | |
| parent | 8635bbbc14f70455778a6c5b31eadc64001b7ee7 (diff) | |
clarify how to use GEM_FONTS_DIR to refer to bundled fonts in a custom theme [skip ci]
| -rw-r--r-- | docs/theming-guide.adoc | 5 |
1 files changed, 3 insertions, 2 deletions
diff --git a/docs/theming-guide.adoc b/docs/theming-guide.adoc index efc11b08..c1a4b37c 100644 --- a/docs/theming-guide.adoc +++ b/docs/theming-guide.adoc @@ -752,8 +752,9 @@ A sans-serif font that provides a very complete set of Unicode glyphs. Cannot be styled as italic, bold or bold_italic. Used as the fallback font in the `default-with-fallback-font` theme. -TIP: If you want to specify the location of custom fonts using the `pdf-fontsdir` attribute, yet still be able to use the bundled fonts, you need to refer to the bundled fonts using the `GEM_FONTS_DIR` token. -To do so, you can either a) prefix the path of the bundled font in the theme file with the segment `GEM_FONTS_DIR` (e.g., `GEM_FONTS_DIR/mplus1p-regular-fallback.ttf`, or b) use relative paths in the theme file and include `GEM_FONT_DIR` in the value of the `pdf-fontsdir` attribute separated by the location of your custom fonts using a semi-colon (e.g., `"path/to/your/fonts;GEM_FONTS_DIR"`). +TIP: The default themes in 1.5.x do not include the `GEM_FONTS_DIR` prefix in the path of the bundled font files. +Therefore, if you want to specify the location of custom fonts using the `pdf-fontsdir` attribute, yet still be able to use the bundled fonts, you need to refer to the bundled fonts using the `GEM_FONTS_DIR` token. +To do so, you can either a) redeclare the bundle fonts in your theme and prefix the path with the segment `GEM_FONTS_DIR` (e.g., `GEM_FONTS_DIR/mplus1p-regular-fallback.ttf`, or b) include `GEM_FONT_DIR` in the value of the `pdf-fontsdir` attribute separated by the location of your custom fonts using a semi-colon (e.g., `"path/to/your/fonts;GEM_FONTS_DIR"`). === Custom Fonts |