Schritt 3: Erstellung der Metric-Dateien

Schriftarten-Sammlungen

Für jeden verwendeten nicht-Standardfonts, muss eine Datei mit Font-Metric-Informationen erstellt werden. Apache FOP benötigt diese Infos während der XSL-FO -> PDF-Konvertierung. Sie können die Metric-Dateien mit den t1metrics und ttfmetrics targets Ihres Buildsystems generieren. Rufen Sie die Befehlszeile auf und wechseln Sie in das Verzeichnis manual/src/build. Geben Sie folgendes Kommando ein (alles in einer Zeile!):

build ttfmetrics
  -Dff=D:\Path\To\fontfile.ttf -Dmf=filename.xml -Dsfx=xx

Um die TTF-Metric-Datei zu erstellen, oder

build t1metrics
  -Dff=D:\Path\To\fontfile.pfm -Dmf=filename.xml -Dsfx=xx

für eine Type 1-Metric-Datei.

Bitte beachten Sie:

Sie müssen den kompletten Pfad zu Ihrem Font angeben, jedoch nur einen Dateinamen für die Metric-Datei. Letztere wird ersetzt in manual/config/xx, mit xx, Ihrem Sprachcode.
Wählen Sie einen Dateinamen für Ihre Metric-Datei. Sinnvollerweise sollte der Name jedoch so gewählt werden, dass er Ihrem Font zugeordnet werden kann.
Für das t1metrics target, müssen Sie die .pfm-Datei verwenden, nicht die .pfb.
Das zweite Zeichen von t1metrics ist die Zahl 1 (eins), nicht der Buchstabe el.
Alternativ zum Parameter sfx können Sie auch folgendes eingeben: -Dmf=xx/filename.xml.

Bitte berücksichtigen Sie, dass Sie diesen Schritt für jede Schriftart wiederholen müssen, die Sie hinzufügen. Wenn die fett- und/oder kursiv-Variationen in verschiedenen Dateien stecken, müssen Sie auch je eine eigene Metric-Datei erstellen.

Wichtig

Metric-Dateien, die mit FOP 0.20.5 erstellt wurden (was Teil des Build-Tools bis April 2007 war), sind nicht mit der aktuellen FOP-Version (0.93 or higher) nutzbar. Wenn Sie solch alte Dateien in Ihrem Verzeichnisbaum besitzen, regenieren Sie diese mit der jüngsten Tool-Version. Bitte beachten Sie, dass Durchführung eines CVS-Updates, die aktuellen Metric-Dateien beinhalten kann.

Schriftarten-Sammlungen

Einige TrueType-Fonts werden in .ttc-Dateien gepackt (TrueType collections). Das ttcmetrics target ermöglicht Ihnen die Metric-Dateien für diese Fonts folgendermaßen zu erstellen:

build ttcmetrics -Dcf=D:\Path\To\collection.ttc 
                   -Dfn=fontname -Dmf=filename.xml -Dsfx=xx

Der ff (font file) Parameter wurde durch cf (collection file) ersetzt. Zusätzlich gibt es den fn (font name) Parameter. Um herauszufinden, welche Fonts in einer Sammlung existieren, rufen Sie das ttcmetrics target mit nur dem ersten Parameter auf, wie folgt:

build ttcmetrics -Dcf=D:\Path\To\collection.ttc

Die Ausgabe wird in einer Ausnahmebehandlung (exception) und einem 20 Zeilen langen Java Stack Trace resultieren. Vorher jedoch, finden Sie eine Liste aller fonts, die die Sammlung beinhaltet.