xerif

h1. Fonts For Non-Latin Script Systems

The fallback fonts for foreign script systems are stored in a "separated repository":https://subversion.le-tex.de/common/xerif-fonts/

h2. Folder structure

The folder where the tex-Rendering takes place, needs to have the following generalized structure:

<pre>

<render folder>

  |– fonts

  |     |– Noto

  |     |     |– Sans

  |     |     |    |– NotoSans-Regular.ttf

  |     |     |    |– NotoSans-Bold.ttf

  |     |     |    |– (etc.)

  |     |     |– Serif

  |     |     |    |– NotoSerif-Regular.ttf

  |     |     |    |– NotoSerif-Bold.ttf

  |     |     |    |– (etc.)

  |     |     |– <further Noto fallback fonts>

  |     |– Junicode

  |     |     |– Junicode.ttf

  |     |     |– Junicode-Bold.ttf

  |     |     |– Junicode-Italic.ttf

  |     |     |– Junicode-BoldItalic.ttf

  |     |– <further publisher specific font folders>

  |– logos

  |     |– <publisher logo>

  |     |– <creative commons licence logos>

  |– <publisher>.sty

  |– cocotex.cls

  |– coco-script.cls

  |– <further coco-xyz.sty>

  |– index.sh

  |– <further skripts and configuration files>

  |– <document-to-render>.tex

</pre>

h2. Mandatory and Optional Common Fallback Fonts

The following font folders from the @xerif-fonts@ repository need to be copied *for all projects* as they are *global* fallbacks and are loaded automatically, whether they are actually needed or not:

* @./Noto/Sans/@

* @./Noto/Serif/@

* @./Junicode/@

If they are missing, LaTeX *will* throw error messages!

The [Noto folder of the xerif-fonts repository](https://subversion.le-tex.de/common/xerif-fonts/Noto) also contains language specific Noto variants, like `Noto/Hebrew`, `Noto/Arabic` and so forth. They need to be copied iff

* the language occurs in the document options in the argument of the script option

** if, for instance, the document class in the tex file reads<pre>\documentclass[…,script={Arabic,Hebrew}]{cocotex}</pre>then the folders @Noto/Arabic@ and @Noto/Hebrew@ need to be copied, as well, **unless**

* a publisher selects a different fallback font for certain script systems

** Transcript, for instance, selects SBL-Hebrew over Noto/Hebrew; in this case, for transcript projects, the @SBL/Hebrew@ folder (which is also included in the @xerif-fonts@ repository) needs to be copied, instead of the @Noto/Hebrew@ folder.

h2. Publisher Specific Fonts

While the xerif-fonts repository is considered global and available to all projects, some publisher repositories contain their own @fonts@ folder. The fonts and folders in this directory also need to be copied into the @fonts@ folder of the rendering project. 

**Publisher fonts always take priority over the common xerif-fonts**