.. /*  
    * This file is part of the SavaPage project <https://www.savapage.org>.
    * Copyright (c) 2026 Datraverse B.V.
    * Author: Rijk Ravestein.
    *
    * SPDX-FileCopyrightText: (c) 2020 Datraverse B.V. <info@datraverse.com>
    * SPDX-License-Identifier: CC-BY-SA-4.0
    *
    * For more information, please contact Datraverse B.V. at this
    * address: info@datraverse.com
    */

.. _ch-i18n-internal-fonts:

Internal Fonts
--------------

.. contents:: |RST_TABLE_OF_CONTENTS|
   :depth: 2
   :local:

.. _ch-i18n-internal-fonts-intro:

Introduction
~~~~~~~~~~~~

The Unicode range of the displayed text in PDF documents must be covered
by the embedded font.

Unfortunately, at present there is no native *outline* font that can
display all Unicode characters. The one exception is :ref:`GNU Unifont <ch-i18n-font-unifont>`,
which *does* support the full 65,536 Unicode code point range.
However, the glyphs originate from a *bitmap* of 16 pixels high and either 
8 or 16 pixels wide, which gives the font a coarser look.

|PRODUCT_NAME| contains internal fonts covering specific
`Unicode Scripts <https://www.unicode.org/charts/>`__. 
These fonts can be selected to customize PDF output to the content locale.

.. _ch-i18n-font-default:

Default Font
~~~~~~~~~~~~

The default font for PDF output is `DejaVu Sans <https://dejavu-fonts.org>`__, 
which supports a broad set of Unicode scripts:

-  Latin (including European and African alphabets, IPA, ...)

-  Greek (including polytonic)

-  Cyrillic

-  Armenian

-  Georgian

-  Hebrew

-  Arabic

-  N'ko

-  Lao

-  Canadian Aboriginal Syllabics

-  Ogham

-  Tifinagh

-  Lisu

Next to that, DejaVu also contains a lot of mathematical and other
symbols, arrows, braille patterns, etc.

.. tip::

   Coverage of the default font can be seen in
   `DejaVuSans.pdf <https://www.savapage.org/docs/fonts/DejaVuSans.pdf>`__.

.. _ch-i18n-font-cjk:

CJK Font
~~~~~~~~

Support for Chinese, Japanese and Korean (CJK) is provided by the
`Droid Sans "fallback" font <https://www.droidfonts.com/droidfonts>`__.
This font contains over 43,000 glyphs and includes support for Simplified Chinese (GB2312), 
Traditional Chinese (Big 5), Japanese (JIS 0208) and Korean (KSC 5601). The font
uses the Simplified Chinese ideographs for shared Unicode code points.

.. tip::

   Coverage of the CJK font can be seen in
   `DroidSansFallbackFull.pdf <https://www.savapage.org/docs/fonts/DroidSansFallbackFull.pdf>`__.

.. _ch-i18n-font-unifont:

Unifont
~~~~~~~

`GNU Unifont <https://savannah.gnu.org/projects/unifont>`__ is a Unicode
font with a glyph for every visible Unicode Basic Multilingual Plane
code point. The Unicode Basic Multilingual Plane covers the first 65,536
(or 2^16) Unicode code points. GNU Unifont originates from a bitmap font
with glyphs of 16 pixels high and either 8 or 16 pixels wide. Therefore
it has a coarser look than native outline fonts.