Hoe voeg je aangepaste lettertypen toe aan OnlyOffice Document Server?

Om een ​​aangepast lettertype beschikbaar te maken in ONLYOFFICE Docs, installeert u de lettertypebestanden op de machine of container waarop Document Server draait, genereert u de lettertypenlijst van de server opnieuw en controleert u het resultaat in een editor en een geëxporteerd document. De exacte stappen voor het persistent opslaan van de bestanden hangen af ​​van of uw server direct op Linux is geïnstalleerd of in Docker draait.

Een succesvolle wijziging betekent dat het lettertype onder de naam van de lettertypefamilie in de lettertypekiezer van de editor verschijnt en correct wordt weergegeven in een testdocument. Het zien van een naam in het menu is een nuttige eerste controle, maar het garandeert niet dat elke stijl, taal of exportmethode werkt. Controleer normale en vetgedrukte tekst, eventuele benodigde tekensets en een PDF- of afdrukvoorbeeld voordat u het lettertype voor productiedocumenten gebruikt.

Wat verandert er als je een lettertype installeert?

ONLYOFFICE Docs gebruikt lettertypen die beschikbaar zijn op de documentserver en genereert lettertypemetadata voor de editors. De installatiehandleidingen van de leverancier vermelden TrueType- en OpenType-families, waaronder .ttf, .otf, .ttcen gerelateerde formaten, evenals WOFF-formaten. Ondersteunde bestandstypen garanderen niet dat elk lettertypebestand of elke lettertypefunctie zich identiek gedraagt; test het specifieke lettertype en document dat u wilt gebruiken.

De servergebaseerde lettertype-installatie stelt verbonden editors in staat het lettertype via Document Server te gebruiken. Het lettertype wordt niet op elke computer van de gebruiker of op andere documentverwerkingsservers geïnstalleerd. Als een gedownload of afzonderlijk geopend bestand wordt bekeken in software die het lettertype niet ondersteunt, kan die software een ander lettertype gebruiken. ONLYOFFICE merkt ook op dat documenten kunnen worden weergegeven met een zo goed mogelijk alternatief wanneer de server het in het document gebruikte lettertype niet heeft, wat gevolgen kan hebben voor de regelafbrekingen of de pagina-indeling.

Gebruik lettertypebestanden die u geautoriseerd bent om op een server te implementeren. Bewaar de bestanden en de bijbehorende licentievoorwaarden bij uw implementatiegegevens, vooral als er beperkingen gelden voor het gebruik, de herdistributie of het insluiten van het lettertype in documenten.

Kies de juiste installatiemethode.

• Installatie van het Linux-pakket: kopieer de lettertypebestanden naar de systeemmap voor lettertypen op de documentserver en voer vervolgens het lettertypegeneratiescript van ONLYOFFICE uit. Dit is geschikt wanneer u de host rechtstreeks beheert.
• Docker-container: koppel een permanente hostdirectory aan de lettertypedirectory van de container, of kopieer lettertypen naar een draaiende container voor een kortstondige test. Genereer de lettertypemetadata opnieuw in de container. Een bind-mount blijft behouden na het opnieuw aanmaken van de container; een eenmalige kopie naar de container doorgaans niet.
• Beheerde of geïntegreerde implementatie: als een ander platform of een installatietool de Document Server-container beheert, pas dan de permanente koppeling toe via de configuratie van die implementatie. Het bewerken van een actieve container kan tijdens een update of vervanging verloren gaan.

De momenteel gepubliceerde lettertypehandleidingen van ONLYOFFICE tonen dezelfde hoofdworkflow voor de Community Edition op Linux en Docker, en publiceren een aparte Linux-handleiding voor de Enterprise Edition. Paden, machtigingen en containerorkestratie kunnen variëren afhankelijk van uw versie en installatiemethode, dus gebruik de bestaande configuratie van uw implementatie in plaats van deze te vervangen door een voorbeeld uit een andere omgeving.

Lettertypen toevoegen aan een Linux-installatie

1. Bereid de lettertypebestanden voor en installeer ze.

Verzamel de benodigde lettertypebestanden, inclusief de echte vetgedrukte en cursieve varianten als het lettertype deze bevat. Bewaar een lettertypefamilie bij elkaar in een duidelijk benoemde map. Een beheerder zou bijvoorbeeld een lettertypefamilie kunnen plaatsen in de map /usr/share/fonts/, de systeemlocatie die wordt gebruikt in de Linux-instructies van ONLYOFFICE:

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

Vervang de voorbeeldbestandsnamen door de namen van de bestanden die u daadwerkelijk hebt. Vermijd het hernoemen van lettertypebestanden om de familienaam te wijzigen; editors gebruiken metadata die in elk lettertypebestand is opgeslagen. Zorg ervoor dat de processen van de documentserver de bestanden kunnen lezen. Als u lettertypen beheert via een pakket- of configuratiebeheersysteem, gebruik dan dat proces zodat de bestanden na onderhoud behouden blijven.

2. Genereer de ONLYOFFICE-lettertypelijst opnieuw.

Voer het lettertypegeneratiescript van de leverancier uit nadat u de bestanden hebt geïnstalleerd:

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

Laat het script volledig afmaken en controleer de uitvoer op fouten. Deze stap werkt de lettertypegegevens bij die door de documentserver worden gebruikt; het simpelweg kopiëren van een lettertypebestand naar de host zorgt er mogelijk niet voor dat het in een reeds actieve editor verschijnt. Verwijder geen bestaande serverlettertypen als onderdeel van deze procedure. De leverancier waarschuwt dat het verwijderen van systeemlettertypen de documentlay-out en -weergave kan beïnvloeden.

Voeg lettertypen toe aan een Docker-implementatie.

1. Maak de lettertype-directory permanent.

Voor een implementatie die wordt beheerd met Docker Compose, voegt u een bind mount toe aan de bestaande Document Server-service. Maak een hostdirectory aan voor de bestanden en koppel deze vervolgens aan de custom-font directory van de container. De Docker-image van ONLYOFFICE declareert dit /usr/share/fonts/truetype/customals een volume, en de instructies voor Docker-lettertypen staan ​​ook toe dat lettertypen naar deze directory worden gekopieerd /usr/share/fonts/.

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

Dit is een fragment dat u in uw huidige Compose-bestand kunt invoegen, geen volledige vervangende configuratie. Behoud uw bestaande imageversie, netwerken, omgevingsvariabelen, datavolumes, geheimen en servicenaam. Bereid de lettertypebestanden voor op de host /srv/onlyoffice/fontsen zorg ervoor dat de container ze kan lezen.

Het toepassen van een gewijzigd Compose-bestand kan de Document Server-container opnieuw aanmaken en actieve bewerkingssessies onderbreken. Controleer uw implementatieprocedure, maak een back-up van de Compose-configuratie en plan de wijziging op het juiste moment in. Als de container wordt beheerd door een appliance of integratie, gebruik dan de door die appliance of integratie ondersteunde configuratiemethode in plaats van een gegenereerd Compose-bestand te bewerken.

2. Maak het programma opnieuw aan of herstart het, en genereer vervolgens de lettertypemetadata.

Pas de mount toe met behulp van de normale Compose-workflow voor uw implementatie. Voer vervolgens het script voor het genereren van lettertypen uit in de Document Server-container zelf. Voor een container met de naam onlyoffice-documentserver, is het commando:

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

Gebruik de containernaam of -ID die wordt weergegeven door docker ps. Als u alleen een lettertype wilt controleren voordat u de configuratie permanent maakt, beschrijft de leverancier hoe u lettertypebestanden naar een actieve container kunt kopiëren met docker cp, gevolgd door het uitvoeren van hetzelfde script daarin. Beschouw dit als een test: bestanden die naar een container zijn gekopieerd, kunnen verdwijnen wanneer de container wordt vervangen.

Controleer het lettertype in een editor en in de uitvoer.

1. Open een document in een editor die is verbonden met deze documentserver en open de lettertypekiezer. Zoek naar de lettertypefamilienaam zoals die is vastgelegd in de metadata.
2. Maak een kort testdocument met normale tekst, vetgedrukte tekst en tekens uit de benodigde taalscripts. Controleer of het juiste lettertype is geselecteerd en niet een synthetisch of vervangen lettertype.
3. Sla het testdocument op, open het opnieuw en exporteer het of bekijk een afdrukvoorbeeld. Vergelijk de regeleinden, het aantal pagina's, de afstand tussen regels en de tekendekking met het verwachte resultaat.
4. Herhaal de controle in de documenteditor of applicatie die uw gebruikers daadwerkelijk gebruiken. Dat een lettertype op de server beschikbaar is, garandeert niet dat een ongerelateerde lokale applicatie of een andere server het ook heeft.

Bij oudere installaties kan de in de browser opgeslagen metadata van lettertypen de weergave vertragen. De handleidingen van ONLYOFFICE geven aan dat voor versie 8.1.3 of ouder de browsercache moet worden gewist en de pagina opnieuw moet worden geopend na het toevoegen van lettertypen; voor latere versies is deze stap niet nodig. Controleer eerst de serverbestanden en de gegenereerde metadata, en volg het cacheadvies alleen op als dit overeenkomt met uw versie.

Als het lettertype ontbreekt of de lay-out verandert.

• Het lettertype ontbreekt in de selectie: controleer of het bestand zich in de lettertypedirectory op de documentserverhost of in de juiste container bevindt, leesbaar is en een ondersteund bestandstype heeft. Voer het script voor het genereren van lettertypen opnieuw uit en lees de uitvoer. Controleer in Docker de mount vanuit de container; een hostpad alleen bewijst niet dat het volume aan de actieve service is gekoppeld.
• De familienaam ziet er anders uit: controleer de ingebedde familiemetadata van het lettertype. Een bestandsnaam zoals BrandSans-Bold.ttfkan correct geïnstalleerd zijn, terwijl het menu de familienaam weergeeft die in het lettertype is gedefinieerd.
• Het lettertype wordt wel weergegeven, maar de tekst is onjuist: controleer of het lettertype de vereiste tekens en de juiste stijlbestanden bevat. Een lettertype kan wel in de lettertypekiezer verschijnen, maar een glyph of gewicht missen dat in het document wordt gebruikt.
• Documenten worden na de wijziging opnieuw opgemaakt: vergelijk de exacte lettertypefamilie en -stijl die voor en na de wijziging werden gebruikt. Als het oorspronkelijke lettertype op een andere computer of exportservice ontbreekt, kan een vervangend lettertype de lay-out wijzigen. Installeer het gelicentieerde lettertype overal waar de weergave plaatsvindt, of gebruik een documentveilig alternatief en controleer de pagina's opnieuw.
• Het lettertype verdwijnt na een update: controleer of de installatie alleen in een tijdelijke container heeft plaatsgevonden. Verplaats de bestanden naar een permanente hostmap en koppel deze via de implementatieconfiguratie voordat u de service opnieuw aanmaakt.

Het toevoegen van aangepaste lettertypen is vooral handig wanneer dezelfde lettertypefamilie nodig is in gedeelde documenten en gecontroleerde exports. Er zijn echter beperkingen: installatie op de server verleent geen gebruiksrechten voor lettertypen, voegt geen ontbrekende tekens toe aan een lettertype en garandeert geen pixel-identieke weergave in software die een andere lettertypeset gebruikt. Houd de map met aangepaste lettertypen onder versiebeheer of configuratiebeheer, documenteer de versie van de documentserver en voer de verificatiecontroles opnieuw uit na upgrades.

Officiële referenties

• ONLYOFFICE Docs Community Edition: Lettertypen toevoegen op Linux
• ONLYOFFICE Docs Community Edition: Lettertypen toevoegen in Docker
• ONLYOFFICE Docs Enterprise Edition: Lettertypen toevoegen op Linux
• ONLYOFFICE Docker-DocumentServer repository