summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDan Allen <dan.j.allen@gmail.com>2017-02-10 23:50:35 -0700
committerDan Allen <dan.j.allen@gmail.com>2017-02-11 00:01:29 -0700
commitea5cffbc6cde2c305ce57cd3d162064291455206 (patch)
tree3c2c94eda54ad50cebe56b699a2de209106dbf5a
parent7c3e9d7d92b87608355d63f1f7ce1af20e57a54d (diff)
document in theming guide that Asciidoctor PDF subsets the font when embedding
-rw-r--r--docs/theming-guide.adoc5
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/theming-guide.adoc b/docs/theming-guide.adoc
index 361bf84c..cb716578 100644
--- a/docs/theming-guide.adoc
+++ b/docs/theming-guide.adoc
@@ -734,6 +734,11 @@ When you execute Asciidoctor PDF, you need to specify the directory where the fo
WARNING: Currently, all fonts referenced by the theme need to be present in the directory specified by the `pdf-fontsdir` attribute.
+When Asciidoctor PDF creates the PDF, it only embeds the glyphs from the font that are needed to render the characters present in the document.
+In other words, Asciidoctor PDF automatically subsets the font.
+However, if you're storing the fonts in a repository, you may want to subset the font (for instance, by using FontForge) to reduce the space the font occupies in that storage.
+This is simply a personal preference.
+
You can add any number of fonts to the catalog.
Each font must be assigned a unique key, as shown here: