So fügen Sie benutzerdefinierte Schriftarten zum ONLYOFFICE-Dokumentenserver hinzu

Um eine benutzerdefinierte Schriftart in ONLYOFFICE Docs verfügbar zu machen, installieren Sie deren Schriftdateien auf dem Rechner oder Container, auf dem der Dokumentenserver ausgeführt wird. Generieren Sie anschließend die Schriftliste des Servers neu und überprüfen Sie das Ergebnis in einem Editor und einem exportierten Dokument. Der genaue Schritt zum Speichern der Dateien hängt davon ab, ob Ihr Server direkt unter Linux installiert ist oder in Docker läuft.

Eine erfolgreiche Änderung bedeutet, dass die Schriftart im Schriftauswahlmenü des Editors unter ihrem Familiennamen erscheint und in einem Testdokument wie erwartet dargestellt wird. Das Anzeigen des Namens im Menü ist ein hilfreicher erster Test, garantiert aber nicht, dass alle Stile, Sprachen oder Exportpfade funktionieren. Überprüfen Sie daher vor der Verwendung der Schriftart in Produktionsdokumenten normalen und fettgedruckten Text, alle benötigten Zeichensätze sowie eine PDF- oder Druckvorschau.

Was ändert sich, wenn Sie eine Schriftart installieren?

ONLYOFFICE Docs verwendet die auf dem Dokumentenserver verfügbaren Schriftarten und erstellt Metadaten für die Bearbeiter. Die Installationsanleitungen des Anbieters listen TrueType- und OpenType-Familien auf, darunter .ttf, .otf, .ttcund verwandte Formate sowie WOFF-Formate. Die unterstützten Dateitypen garantieren nicht, dass sich jede Schriftartdatei oder -funktion identisch verhält; testen Sie daher die jeweilige Schriftart und das Dokument, das Sie verwenden möchten.

Die serverseitige Schriftartinstallation ermöglicht es verbundenen Redakteuren, die Schriftart über den Dokumentenserver zu verwenden. Die Schriftart wird dabei nicht auf den Rechnern der einzelnen Benutzer oder auf anderen Dokumentenverarbeitungsservern installiert. Wird eine heruntergeladene oder separat geöffnete Datei in einer Software angezeigt, die die Schriftart nicht enthält, kann diese Software eine andere Schriftart verwenden. ONLYOFFICE weist außerdem darauf hin, dass Dokumente mit einer möglichst ähnlichen Schriftart angezeigt werden können, wenn die im Dokument verwendete Schriftart auf dem Server nicht vorhanden ist. Dies kann zu Änderungen an Zeilenumbrüchen oder dem Seitenlayout führen.

Verwenden Sie nur Schriftartdateien, für deren Bereitstellung auf einem Server Sie berechtigt sind. Bewahren Sie die Dateien und deren Lizenzbedingungen in Ihren Bereitstellungsunterlagen auf, insbesondere wenn die Schriftart Einschränkungen hinsichtlich Servernutzung, Weiterverbreitung oder Einbettung in Dokumente unterliegt.

Wählen Sie die richtige Installationsmethode

• Linux-Paketinstallation: Kopieren Sie die Schriftdateien in das Systemschriftverzeichnis auf dem Dokumentenserver und führen Sie anschließend das Schriftgenerierungsskript von ONLYOFFICE aus. Dies ist erforderlich, wenn Sie den Host direkt verwalten.
• Docker-Container: Binden Sie ein persistentes Host-Verzeichnis in das Schriftartenverzeichnis des Containers ein oder kopieren Sie Schriftarten für einen kurzzeitigen Test in einen laufenden Container. Generieren Sie die Schriftarten-Metadaten im Container neu. Eine Bind-Mount-Verbindung bleibt auch nach einem Neustart des Containers erhalten; ein einmaliges Kopieren in den Container hingegen in der Regel nicht.
• Verwaltete oder integrierte Bereitstellung: Wenn der Dokumentenserver-Container von einer anderen Plattform oder einem Installationstool verwaltet wird, wenden Sie die dauerhafte Einbindung über die Konfiguration dieser Bereitstellung an. Änderungen an einem laufenden Container können bei einem Update oder Austausch verloren gehen.

Die aktuell veröffentlichten Schriftartenleitfäden von ONLYOFFICE zeigen für die Community Edition unter Linux und Docker denselben Hauptablauf und bieten für die Enterprise Edition einen separaten Linux-Leitfaden an. Pfade, Berechtigungen und Container-Orchestrierung können je nach Version und Installationsmethode variieren. Verwenden Sie daher die bestehende Konfiguration Ihrer Bereitstellung, anstatt sie durch ein Beispiel aus einer anderen Umgebung zu ersetzen.

Schriftarten unter einer Linux-Installation hinzufügen

1. Schriftartdateien vorbereiten und installieren

Besorgen Sie sich die benötigten Schriftfamiliendateien, einschließlich der Varianten für Fettdruck und Kursivschrift, sofern diese von der Schriftfamilie bereitgestellt werden. Speichern Sie eine reguläre Schriftfamilie in einem aussagekräftig benannten Verzeichnis. Ein Administrator könnte beispielsweise eine Schriftfamilie unter /usr/share/fonts/dem Systemverzeichnis ablegen, das in den Linux-Anweisungen von ONLYOFFICE verwendet wird.

sudo mkdir -p /usr/share/fonts/custom/brand-sans
sudo cp BrandSans-*.ttf /usr/share/fonts/custom/brand-sans/

Ersetzen Sie die Beispieldateinamen durch Ihre tatsächlichen Dateinamen. Vermeiden Sie es, Schriftdateien umzubenennen, um deren Familiennamen zu ändern; Editoren verwenden die in den Schriftdateien gespeicherten Metadaten. Stellen Sie sicher, dass die Prozesse des Dokumentenservers die Dateien lesen können. Wenn Sie Schriften über ein Paket- oder Konfigurationsverwaltungssystem verwalten, verwenden Sie dieses Verfahren, damit die Dateien nach der Wartung erhalten bleiben.

2. Die ONLYOFFICE-Schriftartenliste neu generieren.

Führen Sie nach der Installation der Dateien das Schriftartgenerierungsskript des Anbieters aus:

sudo /usr/bin/documentserver-generate-allfonts.sh

Lassen Sie das Skript vollständig durchlaufen und überprüfen Sie die Ausgabe auf Fehler. Dieser Schritt aktualisiert die vom Dokumentenserver verwendeten Schriftartdaten. Das einfache Kopieren einer Schriftartdatei auf den Host führt möglicherweise nicht dazu, dass sie in einem bereits geöffneten Editor angezeigt wird. Entfernen Sie im Rahmen dieses Vorgangs keine vorhandenen Serverschriftarten. Der Hersteller weist darauf hin, dass das Löschen von Systemschriftarten das Dokumentlayout und die Darstellung beeinträchtigen kann.

Fügen Sie einer Docker-Bereitstellung Schriftarten hinzu

1. Das Schriftartenverzeichnis dauerhaft speichern.

Für eine mit Docker Compose verwaltete Bereitstellung fügen Sie dem bestehenden Document Server-Dienst eine Bind-Mount-Verbindung hinzu. Erstellen Sie ein Hostverzeichnis für die Dateien und ordnen Sie es anschließend dem benutzerdefinierten Schriftartenverzeichnis des Containers zu. Das Docker-Image von ONLYOFFICE deklariert dieses /usr/share/fonts/truetype/customals Volume, und die zugehörigen Docker-Schriftartenanweisungen erlauben auch das Kopieren von Schriftarten unter /usr/share/fonts/.

services:
  onlyoffice-documentserver:
    image: onlyoffice/documentserver:<your-pinned-version>
    volumes:
      - /srv/onlyoffice/fonts:/usr/share/fonts/truetype/custom

Dies ist ein Code-Snippet zum Einfügen in Ihre bestehende Compose-Datei, keine vollständige Ersatzkonfiguration. Behalten Sie Ihre bestehende Image-Version, Netzwerke, Umgebungsvariablen, Datenvolumes, Geheimnisse und den Dienstnamen bei. Bereiten Sie die Schriftartdateien auf dem Host vor /srv/onlyoffice/fontsund stellen Sie sicher, dass der Container sie lesen kann.

Das Anwenden einer geänderten Compose-Datei kann den Dokumentenserver-Container neu erstellen und laufende Bearbeitungssitzungen unterbrechen. Überprüfen Sie Ihr Bereitstellungsverfahren, erstellen Sie eine Sicherungskopie der Compose-Konfiguration und planen Sie die Änderung entsprechend. Wenn der Container von einer Appliance oder Integration verwaltet wird, verwenden Sie deren unterstützte Konfigurationsmethode, anstatt eine generierte Compose-Datei zu bearbeiten.

2. Neu erstellen oder neu starten und anschließend die Schriftart-Metadaten generieren.

Wenden Sie die Einbindung mithilfe des normalen Compose-Workflows für Ihre Bereitstellung an. Führen Sie anschließend das Skript zur Schriftartengenerierung im eigentlichen Document Server-Container aus. Für einen Container mit dem Namen „<Containername>“ onlyoffice-documentserverlautet der Befehl:

docker exec onlyoffice-documentserver   /usr/bin/documentserver-generate-allfonts.sh

Verwenden Sie den Containernamen oder die ID, die angezeigt wird docker ps. Wenn Sie eine Schriftart nur testen möchten, bevor Sie die Konfiguration dauerhaft speichern, beschreibt der Hersteller das Kopieren von Schriftartdateien in einen laufenden Container mit docker cp, gefolgt vom Ausführen desselben Skripts darin. Betrachten Sie dies als Test: In einen Container kopierte Dateien können verloren gehen, wenn der Container ersetzt wird.

Überprüfen Sie die Schriftart im Editor und in der Ausgabe.

1. Öffnen Sie ein Dokument in einem mit diesem Dokumentenserver verbundenen Editor und öffnen Sie die Schriftauswahl. Suchen Sie nach dem in den Metadaten der Schriftart gespeicherten Familiennamen.
2. Erstellen Sie ein kurzes Testdokument mit normalem Text, Fettdruck und Zeichen der benötigten Schriftsysteme. Stellen Sie sicher, dass die korrekte Schriftstärke und nicht ein synthetischer oder ersetzter Stil ausgewählt ist.
3. Speichern Sie das Testdokument, öffnen Sie es erneut und exportieren oder zeigen Sie eine Druckvorschau an. Vergleichen Sie Zeilenumbrüche, Seitenzahl, Abstände und Glyphenabdeckung mit dem erwarteten Ergebnis.
4. Wiederholen Sie die Überprüfung im Dokumenteditor oder der Anwendung, die Ihre Benutzer tatsächlich verwenden. Eine auf dem Server verfügbare Schriftart garantiert nicht, dass sie auch in einer unabhängigen lokalen Anwendung oder auf einem anderen Server vorhanden ist.

Bei älteren Installationen kann die Anzeige der Schriftarten durch zwischengespeicherte Browser-Metadaten verzögert werden. Laut den Anleitungen von ONLYOFFICE sollten Sie bei Version 8.1.3 oder älter nach dem Hinzufügen von Schriftarten den Browser-Cache leeren und die Seite neu öffnen. Bei neueren Versionen ist dieser Schritt nicht erforderlich. Überprüfen Sie zunächst die serverseitigen Dateien und die generierten Metadaten und wenden Sie den Cache-Tipp nur dann an, wenn er zu Ihrer Version passt.

Wenn die Schriftart fehlt oder sich das Layout ändert

• Die Schriftart fehlt in der Auswahlliste: Stellen Sie sicher, dass sich die Datei im Schriftartenverzeichnis auf dem Dokumentenserver-Host oder im richtigen Container befindet, lesbar ist und einen unterstützten Dateityp aufweist. Führen Sie das Skript zur Schriftartgenerierung erneut aus und überprüfen Sie dessen Ausgabe. Überprüfen Sie in Docker die Einbindung innerhalb des Containers; ein Hostpfad allein beweist nicht, dass das Volume mit dem aktiven Dienst verbunden ist.
• Der Familienname sieht anders aus: Überprüfen Sie die eingebetteten Metadaten der Schriftart. Eine Datei mit einem Namen wie „“ BrandSans-Bold.ttfkann korrekt installiert sein, während im Menü der in der Schriftart definierte Familienname angezeigt wird.
• Die Schriftart wird zwar angezeigt, aber der Text ist fehlerhaft: Prüfen Sie, ob die Schriftart die erforderlichen Zeichen und die entsprechenden Formatvorlagen enthält. Eine Schriftart kann in der Auswahlliste erscheinen, aber ein vom Dokument verwendetes Glyphe oder eine Schriftschnittsstärke fehlen.
• Dokumente werden nach der Änderung neu formatiert: Vergleichen Sie Schriftart und -stil vor und nach der Änderung. Falls die Originalschriftart auf einem anderen Rechner oder Exportdienst fehlt, kann eine Ersatzschriftart das Layout verändern. Installieren Sie die lizenzierte Schriftart überall dort, wo die Darstellung erfolgt, oder verwenden Sie eine dokumentenkompatible Alternative und überprüfen Sie die Seiten erneut.
• Die Schriftart verschwindet nach einem Update: Prüfen Sie, ob die Installation nur in einem temporären Container durchgeführt wurde. Verschieben Sie die Dateien in ein dauerhaftes Hostverzeichnis und binden Sie dieses über die Bereitstellungskonfiguration ein, bevor Sie den Dienst neu erstellen.

Das Hinzufügen benutzerdefinierter Schriftarten ist besonders nützlich, wenn dieselbe Schriftfamilie in gemeinsam genutzten Dokumenten und kontrollierten Exporten benötigt wird. Es gibt jedoch Einschränkungen: Die Serverinstallation gewährt keine Nutzungsrechte für die Schriftart, fügt keine fehlenden Glyphen hinzu und garantiert keine pixelgenaue Darstellung in Software, die einen anderen Schriftsatz verwendet. Das Verzeichnis der benutzerdefinierten Schriftarten sollte unter Versionskontrolle oder Konfigurationsmanagement stehen, die Version des Dokumentenservers dokumentiert und die Überprüfungen nach Aktualisierungen erneut durchgeführt werden.

Offizielle Referenzen

• ONLYOFFICE Docs Community Edition: Hinzufügen von Schriftarten unter Linux
• ONLYOFFICE Docs Community Edition: Hinzufügen von Schriftarten in Docker
• ONLYOFFICE Docs Enterprise Edition: Hinzufügen von Schriftarten unter Linux
• ONLYOFFICE Docker-Dokumentenserver-Repository