Maak aangepaste lettertypen beschikbaar in Collabora CODE Docker

Om een ​​aangepast lettertype te gebruiken in Collabora Online CODE dat in Docker draait, bewaar je de lettertypebestanden op de host en koppel je dezelfde map aan zowel de systeemlettertypemap van de container als de systeemmap van het document. De systeemmap levert bestanden aan geïsoleerde documentprocessen; als je lettertypen alleen in de systeemmap koppelt, /usr/share/fontskan een lettertypefamilie wel in het lettertypemenu verschijnen, maar wordt deze niet in het document weergegeven. Deze handleiding maakt gebruik van Docker Compose en het huidige CODE-imagepad /opt/cool/systemplate; controleer het pad als je een andere image gebruikt.

Kies een lettertypebron die u kunt onderhouden.

Een alleen-lezen bind mount is meestal de eenvoudigste optie voor één Docker-host. Hiermee blijven de lettertypebestanden behouden wanneer de CODE-container opnieuw wordt aangemaakt of geüpgraded, en kunt u precies controleren welke bestanden de container kan lezen. Gebruik lettertypebestanden die u mag installeren en distribueren naar de server. Kopieer niet de volledige lettertypedirectory van een desktopsysteem, tenzij u de licenties hebt gecontroleerd en die bestanden echt nodig hebt.

Gebruik niet-gecomprimeerde lettertypebestanden in formaten die door uw omgeving worden ondersteund, meestal TrueType ( .ttf) of OpenType ( .otf). Voeg de stijlen toe die uw documenten nodig hebben, zoals normaal, vet, cursief en vet cursief. Houd familienamen en bestandsnamen duidelijk en zorg ervoor dat de gebruiker van de container elke map en elk bestand kan lezen. Een lettertype dat slechts één stijl bevat, kan ertoe leiden dat Collabora een andere stijl gebruikt wanneer een document om vet of cursief vraagt.

Maak eerst een aparte hostmap aan en kopieer de geautoriseerde bestanden daarin:

sudo mkdir -p /srv/collabora/fonts
sudo cp BrandSans-Regular.ttf BrandSans-Bold.ttf /srv/collabora/fonts/
sudo chmod -R a+rX /srv/collabora/fonts

Vervang de voorbeeldbestandsnamen door uw daadwerkelijke lettertypebestanden. De leesrechten zijn belangrijk omdat het CODE-proces in de huidige images als een account zonder beheerdersrechten wordt uitgevoerd. Zorg ervoor dat het directorypad stabiel blijft; de Compose bind mounts zullen hiernaar verwijzen.

Koppel lettertypen aan zowel de lettertypestructuur van de host als aan de systeemplaat.

Voeg in uw bestaande collaboraservice in docker-compose.ymlde volgende volume-items toe. Behoud uw bestaande image, poorten, domein-whitelist, SSL-instellingen, geheimen en herstartbeleid; het onderstaande fragment toont alleen de lettertype-mounts.

services:
  collabora:
    volumes:
      - /srv/collabora/fonts:/usr/share/fonts/truetype/more:ro
      - /srv/collabora/fonts:/opt/cool/systemplate/usr/share/fonts/truetype/more:ro

Het eerste doel zorgt ervoor dat de lettertypen beschikbaar zijn voor de reguliere lettertypeherkenning van de container. Het tweede doel plaatst ze in de sjabloon die wordt gebruikt om geïsoleerde documentomgevingen voor te bereiden. De SDK-handleiding van Collabora beschrijft dit patroon met twee locaties voor Docker-volumes. Koppel het volume niet aan de volledige /usr/share/fontsof systeemmap: dit kan lettertypen verbergen die al door de image worden geleverd.

Het pad naar de systeemmap is versieafhankelijk. De huidige CODE 26.04-imagemetadata identificeert dit /opt/cool/systemplateals het pad naar de systeemmap, en de huidige documentatie van Collabora gebruikt die locatie. Als u een oudere image of een leverancierspecifieke build gebruikt, raadpleeg dan de documentatie of opstartconfiguratie van die image voordat u het doelpad wijzigt.

Maak de container opnieuw aan en bevestig de detectie van het lettertype.

Nadat je het Compose-bestand hebt opgeslagen en de lettertypebestanden op de host hebt geplaatst, maak je de CODE-service opnieuw aan, zodat Docker de bind mounts toepast:

docker compose up -d --force-recreate collabora
docker compose exec -T collabora fc-list

Zoek in de uitvoer naar de naam van de lettertypefamilie of het pad naar het gekoppelde bestand. Om de lijst te verkleinen, kunt u de uitvoer doorsturen grepmet de familienaam die het lettertype zelf rapporteert, bijvoorbeeld:

docker compose exec -T collabora fc-list | grep -i "Brand Sans"

Als de opdracht geen overeenkomst meldt, controleer dan het hostpad, de bestandsrechten, de mount-inspringing en de containerlogboeken. U kunt de effectieve mounts inspecteren met docker inspectde opdracht op de actieve container, of de opdracht gebruiken docker compose configom fouten in de YAML-inspringing op te sporen. Het uitvoeren van de opdracht docker compose downis normaal gesproken niet nodig om de volumewijziging toe te passen; het opnieuw aanmaken van de service is voldoende.

Controleer of het lettertype correct wordt weergegeven in een echt document.

Open een testdocument via de normale Nextcloud- of WOPI-integratie, selecteer een kort tekstfragment en kies de aangepaste lettertypefamilie in de lettertypekiezer. Typ een nieuwe regel in dat lettertype, sla het bestand op, sluit het en open het opnieuw. Controleer de normale en vetgedrukte tekst en vergelijk de regeleinden of pagina-indeling met het brondocument. Een lettertypefamilie die in het menu verschijnt, is slechts een controle; de ​​zichtbare tekst na het opnieuw openen van het bestand is de daadwerkelijke weergavecontrole.

• Het lettertype verschijnt wel in het menu, maar de tekst verdwijnt of valt weg: controleer of de tweede mount de systeemmap met lettertypen als doel heeft en of deze dezelfde bestanden bevat.
• Het lettertype ontbreekt in het menu: controleer of de bestanden geldig en leesbaar zijn en inspecteer vervolgens fc-listde uitvoer en de opstartlogboeken van de container.
• Het lettertype werkt tot een image-update: controleer of beide mounts in Compose aanwezig blijven en of uw hostdirectory zich niet in een tijdelijk containerpad bevindt.
• Slechts enkele tekens worden weergegeven: het geselecteerde lettertype bevat mogelijk niet al deze tekens. Voeg een lettertype toe dat de vereiste schrifttekens ondersteunt of gebruik een geschikt alternatief.

Een bind mount zorgt ervoor dat lettertypen onafhankelijk blijven van de CODE-image, maar garandeert geen identieke lay-out op elke client of in elk document. Lettertypevervanging, ontbrekende tekens, verschillende lettertypeversies en documentspecifieke opmaak kunnen nog steeds de regelterugloop beïnvloeden. Raadpleeg voor meer informatie over de configuratie de documentatie van Collabora over lettertype-installatie , de handleiding voor de CODE Docker-image en de handleiding van de Collabora Online SDK . Controleer het Docker-voorbeeld in de handleiding en de documentatie over de huidige image opnieuw wanneer u van CODE-versie wisselt.