Lettertypen toevoegen aan ONLYOFFICE Document Server: Docker versus Linux

Om aangepaste lettertypen toe te voegen aan ONLYOFFICE Document Server, plaatst u de gelicentieerde lettertypebestanden in een map die toegankelijk is voor de server en voert u het commando uit /usr/bin/documentserver-generate-allfonts.sh. Voor Docker-implementaties is een bind-mounted lettertypemap meestal de voorkeur boven het kopiëren van bestanden naar een draaiende container, omdat deze behouden blijft bij het opnieuw aanmaken van de container.

De juiste installatiemethode hangt af van waar ONLYOFFICE Docs draait, hoe vaak u het opnieuw installeert en of u een korte serviceonderbreking kunt accepteren terwijl de lettertypecatalogus wordt vernieuwd.

Kies een methode voor het installeren van lettertypen.

Het officiële Docker- document met instructies voor lettertypen beschrijft het kopiëren van bestanden en het opnieuw opbouwen van de lettertypenlijst. De Docker- documentatie over bind mounts legt uit waarom het mounten van een specifieke hostmap ervoor zorgt dat bestanden beschikbaar blijven, ongeacht de vervanging van de container. Dit zijn verschillende implementatiekeuzes, geen verschillende lettertypeformaten.

Bereid de lettertypebestanden voor en bevestig de doelserver.

1. Identificeer de actieve ONLYOFFICE-implementatie.

Voer dit uit docker psop de Docker-host als de editor in containers draait. Zoek de naam van de Document Server-container in de NAMESkolom; in de onderstaande voorbeelden wordt gebruikt onlyoffice-documentserver. Vervang deze waarde als die van u anders is. Een Nextcloud- of ownCloud-integratie verandert normaal gesproken niets aan het feit dat de lettertypen op de ONLYOFFICE Docs-server geïnstalleerd moeten zijn, en niet alleen op de opslagserver of de computer waarop het document wordt bekeken.

docker ps

2. Verzamel gelicentieerde lettertypebestanden

Kies complete, correct gelicentieerde lettertypefamilies, inclusief de diktes en stijlen die uw documenten daadwerkelijk gebruiken. ONLYOFFICE vermeldt TrueType- en OpenType-formaten zoals .ttfen .otf, plus andere ondersteunde lettertype-extensies, in de Linux-documentatie voor lettertypen . Gebruik voor een voorspelbare eerste implementatie gewone TTF- of OTF-bestanden en controleer het toegestane server- en clientgebruik in de lettertypelicentie.

Voor het Docker-voorbeeld moet je de bestanden op de Docker-host klaarzetten /srv/onlyoffice/custom-fonts. De voorbeeldbestandsnamen Inter-Regular.ttfzijn Inter-Bold.ttfslechts ter illustratie; gebruik de bestanden die je mag installeren.

sudo mkdir -p /srv/onlyoffice/custom-fonts
sudo cp Inter-Regular.ttf Inter-Bold.ttf /srv/onlyoffice/custom-fonts/
sudo chmod 644 /srv/onlyoffice/custom-fonts/*.ttf

Voer deze opdrachten uit vanuit de map met de lettertypebestanden. Controleer de inhoud van de map voordat u verdergaat. Pas op een beheerd systeem het eigenaarschap en de machtigingen aan uw beveiligingsbeleid aan in plaats van de map voor iedereen beschrijfbaar te maken.

Aanbevolen voor Docker: koppel de lettertypedirectory permanent.

3. Voeg een bind mount toe aan de bestaande Compose-service

Zoek in het huidige Compose-bestand de service die de ONLYOFFICE Document Server-image uitvoert. Voeg de volgende vermelding toe onder de bestaande volumeslijst; behoud de andere volumes, poorten, referenties en omgevingsvariabelen die al geconfigureerd zijn:

services:
  onlyoffice-documentserver:
    volumes:
      - /srv/onlyoffice/custom-fonts:/usr/share/fonts/truetype/custom:ro

Het bronpad bevindt zich op de Docker-host; de bestemming bevindt zich in de container. Het :roachtervoegsel beperkt schrijftoegang van de container tot de lettertypedirectory. Koppel de specifieke customdirectory in plaats van de hele /usr/share/fontsdirectorystructuur te vervangen, wat lettertypen die door de image worden geleverd, zou kunnen verbergen. Het officiële ONLYOFFICE Dockerfile declareert de aangepaste TrueType-lettertypedirectory als een volume in de Community- en Enterprise-imagefasen.

Bekijk de herziene Compose-configuratie en pas deze vervolgens toe docker compose up -dvanuit de projectmap. Dit kan de service opnieuw aanmaken: plan de wijziging in op een moment dat editors documenten veilig kunnen sluiten. Als u een standaardimplementatie gebruikt docker run, voeg dan het overeenkomstige argument voor alleen-lezen toe --mount type=bind,src=/srv/onlyoffice/custom-fonts,dst=/usr/share/fonts/truetype/custom,readonlybij het opnieuw aanmaken van de container.

4. Controleer of de container de lettertypebestanden kan zien.

Nadat de service is gestart, controleer dan de gekoppelde map en, indien beschikbaar, de fontconfig-lijst. De familienaam die door fontconfig wordt gerapporteerd, kan afwijken van de bestandsnaam.

docker exec onlyoffice-documentserver ls -l /usr/share/fonts/truetype/custom
docker exec onlyoffice-documentserver fc-list | grep -i 'Inter'

Voor de voorbeeldlettertypen van Inter zou de tweede opdracht een overeenkomende lettertypefamilie moeten weergeven als fontconfig deze detecteert. Als de bestanden bestaan ​​maar de familie niet verschijnt, controleer docker exec onlyoffice-documentserver fc-cache -fdan de machtigingen en voer de opdracht fc-listopnieuw uit. Fontconfig alleen vult het menu van de ONLYOFFICE-editor niet.

5. Genereer de ONLYOFFICE-lettertypecatalogus opnieuw.

Voer, met de bestanden in de container, het script voor het genereren van lettertypen van de documentenserver uit:

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

ONLYOFFICE gebruikt deze stap om de gegevens en assets voor lettertypeselectie te vernieuwen. Dit kan van invloed zijn op actieve editorservices, dus voer het uit tijdens een geschikte onderhoudsperiode. De gedocumenteerde Docker-omgevingsvariabele GENERATE_FONTSis standaard ingesteld op true, waardoor de lettertypegegevens bij het opstarten van de container opnieuw worden gegenereerd; dit is handig na een herstart, maar is geen vervanging voor het installeren van de bestanden op een permanente locatie.

Wijzig GENERATE_FONTSof forceer geen herstart alleen om een ​​ontbrekend volume te maskeren. Controleer eerst of de verwachte bestanden daadwerkelijk zijn aangekoppeld.

Alternatieven: tijdelijke Docker-kopie of native Linux

6. Gebruik een directe kopie van de container voor een kortstondige test.

Als je Compose niet direct kunt wijzigen, kopieer dan een bestand naar de huidige container en herbouw de catalogus. Dit volgt de gedocumenteerde Docker-aanpak van ONLYOFFICE en voorkomt dat de container opnieuw moet worden opgebouwd voor een snelle test.

docker cp ./Inter-Regular.ttf onlyoffice-documentserver:/usr/share/fonts/truetype/custom/
docker exec onlyoffice-documentserver /usr/bin/documentserver-generate-allfonts.sh

Dit is handig voor het oplossen van problemen, maar minder betrouwbaar als implementatieplan. Een image-update of een nieuwe container kan het gekopieerde bestand verwijderen; een herstart van dezelfde container is niet hetzelfde als het bestand opnieuw aanmaken . Promoot een succesvolle test naar een bind mount of een afzonderlijk beheerde aangepaste image wanneer het lettertype nodig is voor doorlopend werk.

7. Installeer rechtstreeks op een niet-gecontaineriseerde Linux-documentserver.

Voor een native Linux-pakketinstallatie plaatst u de bestanden in de systeemmap voor lettertypen van de server en voert u hetzelfde regeneratiescript op die host uit. Dit is geen opdracht die u op een gewone desktopcomputer moet uitvoeren.

sudo install -d -m 755 /usr/share/fonts/truetype/custom
sudo install -m 644 Inter-Regular.ttf /usr/share/fonts/truetype/custom/
sudo /usr/bin/documentserver-generate-allfonts.sh

Deze aanpak laat de lettertypebestanden in de Linux-installatie staan ​​in plaats van in een Docker-volume, maar beheerders moeten ze bewaren in configuratiebeheer of back-ups bij het opnieuw installeren van de host. Raadpleeg de officiële ONLYOFFICE Linux-procedure voor de server met geïnstalleerde pakketten. Als uw editors meer dan één Document Server-node gebruiken, configureer dan dezelfde lettertypefamilie en varianten op elke node.

8. Controleer het lettertype in een echt document.

Open een nieuwe bewerkingssessie in de toepassing die is verbonden met de documentenserver. Selecteer in een test-DOCX-bestand de geïnstalleerde lettertypefamilie in het vervolgkeuzemenu, voer een regel normale tekst, vetgedrukte tekst en representatieve niet-Engelse tekens in als het lettertype bedoeld is voor meertalig gebruik. Sla het bestand op, sluit het, open het opnieuw en exporteer het naar PDF. Vergelijk de tekstbreedte, regelterugloop, glyphdekking en de vetgedrukte/cursieve varianten met een bekend referentiedocument.

Als een lettertype niet in de dropdownlijst staat, controleer dan in die volgorde het serverpad, de uitvoer van fc-listen de opdracht voor het genereren van de catalogus. Als de lettertypefamilie wel verschijnt, maar de lay-out verschuift, controleer dan of het document de exacte lettertypefamilie vereist en of de benodigde gewichten beschikbaar zijn; anders kan de editor een ander lettertype gebruiken. Het installeren van een lettertype op de desktop van een gebruiker voegt het niet automatisch toe aan de server.

Er is één versie-specifieke waarschuwing voor browsers: de lettertype-instructies van ONLYOFFICE geven aan dat de browsercache gewist moet worden en de editor opnieuw geopend moet worden in versie 8.1.3 of ouder . In latere versies is deze extra stap niet nodig. Als uw installatie ouder is, volg dan de beschreven stappen voor het wissen van de cache voordat u complexere oorzaken onderzoekt.

De oplossing is bevestigd wanneer de aangepaste lettertypefamilie selecteerbaar blijft na het opnieuw openen van de editor, het opgeslagen document correct wordt weergegeven en – voor Docker – de lettertypen nog steeds aanwezig zijn nadat de service opnieuw is aangemaakt met dezelfde configuratie. Als een van deze controles mislukt, onderzoek dan die laag in plaats van herhaaldelijk lettertypen naar de container te kopiëren.