In den aktuellen Versionen von Stimulsoft Server haben wir wichtige Verbesserungen am Schriftverarbeitungsmechanismus vorgenommen. In diesem Artikel erklären wir ausführlich, wie Sie alle erforderlichen Schriftarten schnell in Ihre Serverkonfiguration einbinden können.
Einführung
Standardmäßig enthält das Docker-Image keine vorinstallierten Systemschriftarten. Wenn ein Bericht eine Schriftart verwendet, die in der Serverumgebung fehlt (wie z. B. Arial), muss der clientseitige Webbrowser die erste verfügbare lokale Schriftart als Ersatz verwenden. Dies führt häufig zu fehlerhaften Element-Layouts, verschobenen Textblöcken und inkorrekter Berichtsformatierung.Einbinden von Schriftarten über Docker Compose
Um benutzerdefinierte Schriftarten in den Container zu übertragen, wird ein lokales Verzeichnis über volumes eingebunden.Schritt-für-Schritt-Anleitung:
- Erstellung des lokalen Ordners: erstellen Sie ein Verzeichnis fonts im selben Ordner auf dem Host-System, in dem sich Ihre Datei docker-compose.yml befindet.
- Vorbereitung der Schriftdateien: legen Sie die erforderlichen Schriftdateien im Format TTF (TrueType Font) oder OTF (OpenType Font) in den erstellten Ordner. Tipp!
Für eine vollständige Abdeckung aller Schriftschnitte empfehlen wir das Hochladen der gesamten Schriftfamilie. Für Arial sind das beispielsweise folgende Dateien:
arial.ttf - normal
arialbd.ttf - fett
ariali.ttf - kursiv
arialbi.ttf - fett kursiv - Aktualisierung der docker-compose.yml-Konfiguration: fügen Sie die Ordner-Einbindung im Bereich volumes des server-Dienstes hinzu:
Wichtig!services: server: image: stimulsoft/server:2026.3.1 ports: - 8080:8080 volumes: - ./fonts:/usr/share/fonts/truetype/custom:ro
Das Flag :ro (read-only) stellt sicher, dass der Container die Dateien ausschließlich im schreibgeschützten Modus verwendet.
Warum sind proprietäre Schriftarten nicht im Docker-Image enthalten?
Beliebte Schriftarten (darunter Arial, Times New Roman, Calibri usw.) sind geistiges Eigentum ihrer Rechteinhaber (insbesondere Microsoft) und durch kommerzielle Lizenzen geschützt. Das Urheberrecht untersagt die Verbreitung und Einbettung dieser Dateien in öffentlich zugänglichen Docker-Images ohne entsprechende Lizenzierung.Aus diesem Grund können wir sie nicht standardmäßig mitliefern - Benutzer müssen diese eigenständig aus ihren vorhandenen Distributionen oder lizenzierten Quellen einbinden.