Cum se adaugă fonturi personalizate în Docker-ul CODE din Collabora Online

Pentru a face disponibil un font personalizat în Collabora Online CODE (Collabora Online Development Edition) care rulează în Docker, fișierele de fonturi trebuie să fie disponibile pentru containerul Collabora. Instalarea lor doar pe gazda Docker sau într-un container Nextcloud separat nu le face disponibile pentru serverul de birou. Pentru o singură implementare Compose, o montare bind doar pentru citire este de obicei cea mai simplă opțiune; o imagine personalizată este mai ușor de reprodus într-o flotă gestionată, în timp ce configurarea fonturilor la distanță poate centraliza livrarea dacă o puteți opera în siguranță.

Directoarele exacte de fonturi pot varia în funcție de imagine și versiune. Implementarea Helm actuală din amonte a Collabora montează fonturi personalizate atât în ​​, cât /usr/share/fonts/customși în /opt/cool/systemplate/usr/share/fonts/custom. Aceasta este o referință utilă pentru cele două locații, dar nu este o garanție pentru fiecare etichetă Docker independentă. Verificați căile din imaginea pe care o rulați efectiv înainte de a implementa exemplul de mai jos.

Ce metodă de instalare a fonturilor se potrivește implementării dvs.?

Alegeți în funcție de câte instanțe CODE întrețineți, de modul în care implementați actualizări și de posibilitatea de a opera o gazdă de fonturi securizată.

Dacă instalați Collabora cu diagrama Helm, verificați mai întâi setările diagramei deployment.customFonts: diagrama din amonte oferă deja o opțiune de montare a fonturilor personalizate. Pentru o configurare Docker Compose independentă, continuați cu o montare bind dacă căile imaginilor se potrivesc.

Examinați șablonul de implementare Helm din amonte și cele două locații de montare a fonturilor sale și verificați valorile custom-font ale diagramei .

Înainte de a schimba Docker, ce ar trebui să verificați?

• Format font: Folosiți fișierele de fonturi acceptate de configurația Collabora. Proiectul oficial Collabora fontserver documentează fișierele TrueType ( .ttf) și OpenType ( )..otf
• Licență: Confirmați că licența pentru fonturi permite utilizarea pe server și distribuirea către utilizatori. Nu copiați fonturi dintr-un sistem de operare desktop decât dacă licența permite această utilizare.
• Nume de familie: Numele afișat în meniul de fonturi provine din metadatele interne ale fontului, care pot diferi de numele fișierului său. Testați folosind numele de familie, nu doar numele fișierului.
• Toate instanțele: Dacă un proxy direcționează utilizatorii către mai multe containere Collabora, instalați aceleași fișiere de fonturi pe fiecare instanță. În caz contrar, același document se poate reda diferit în funcție de serverul pe care îl deschide.
• Căile exacte ale imaginii: Verificați directoarele și configurația de pornire a imaginii care rulează. Nu reutilizați orbește căi mai vechi, cum ar fi /opt/loolsau dintr-un pachet fără legătură.

Creați un director gazdă, cum ar fi ./fontslângă fișierul Compose, și plasați în el fișierele permise .ttfsau .otffișierele permise. Păstrați directorul limitat la fonturile pe care intenționați să le expuneți prin Collabora.

Cum adaugi fonturi cu Docker Compose?

Adăugați cele două intrări de volum doar pentru citire la lista serviciului Collabora existent volumes. Păstrați imaginea, porturile, variabilele de mediu și alte setări curente ale serviciului; aceasta este o adăugare, nu un fișier Compose de înlocuire.

services:
  collabora:
    volumes:
      - ./fonts:/usr/share/fonts/custom:ro
      - ./fonts:/opt/cool/systemplate/usr/share/fonts/custom:ro

Directorul sursă din stânga se află pe gazda Docker. Căile din dreapta sunt în interiorul containerului. Sufixul :roface ca fișierele să fie doar citibile pentru container. Aceste căi țintă urmează șablonul Helm actual din amonte al Collabora; pentru Docker CODE independent, verificați mai întâi eticheta exactă. Dacă una dintre locații lipsește sau versiunea dvs. utilizează directoare diferite, utilizați căile acceptate de acea imagine în loc să forțați acest exemplu.

Aplicați modificarea din secțiunea Compunere într-o perioadă de liniște, deoarece recrearea serviciului Collabora poate întrerupe sesiunile de editare active. Dacă serviciul dvs. este numit collabora, executați:

docker compose up -d collabora

Folosește numele serviciului Compose dacă acesta este diferit. Evită o repornire completă a stivei, cu excepția cazului în care și alte servicii necesită o modificare a configurației.

Cum poți confirma că respectivul container poate vedea fișierele?

Mai întâi verificați dacă directoarele montate conțin fișierele de fonturi. Înlocuiți-le collaboracu numele containerului utilizat în configurație:

docker exec collabora ls /usr/share/fonts/custom
docker exec collabora ls /opt/cool/systemplate/usr/share/fonts/custom

Vizualizarea fișierelor confirmă montarea Docker, dar nu dovedește că editorul a încărcat fontul. Dacă imaginea include utilitare Fontconfig, puteți inspecta numele de familie descoperite cu fc-list, de exemplu:

docker exec collabora fc-list : family file

Filtrați rezultatul pentru familia așteptată, utilizând un instrument disponibil în containerul dvs. Dacă fc-listnu este instalat, nu adăugați pachete într-un container care rulează ca o soluție permanentă; verificați configurația fontului imaginii sau utilizați o imagine personalizată reproductibilă. Dacă fișierele sunt vizibile, dar nu au fost descoperite, verificați permisiunile, formatul fișierului, metadatele interne ale familiei și ambele căi de montare. Apoi consultați jurnalele pentru imaginea și versiunea exacte pe care le-ați implementat.

Cum testezi fontul în Collabora Online?

1. Deschideți sau creați un document de test prin integrarea normală care lansează editorul Collabora.
2. Deschideți meniul familiei de fonturi și căutați numele intern al familiei fontului.
3. Selectați-l, tastați un scurt exemplu, salvați, închideți și redeschideți documentul.
4. Verificați același document de la un alt utilizator sau browser dacă implementarea dvs. are mai multe instanțe Collabora.

Exemplul de mai jos ilustrează tipul de verificare așteptat: o familie de fonturi apare într-un meniu al editorului. Nu este o captură dintr-o implementare CODE live, iar bara de instrumente poate diferi în funcție de versiune sau integrare.

Dacă familia apare, dar textul este redat într-un font alternativ, asigurați-vă că fața și grosimea selectate există (de exemplu, normal și bold) și confirmați că fontul este prezent în calea systemplate, precum și în directorul general de fonturi. O intrare în meniu în sine nu dovedește că fiecare stil sau fiecare server are fontul respectiv.

Când merită să apelezi la un serviciu de creare de imagini personalizate sau fonturi la distanță?

Creați o imagine personalizată pentru repetabilitate

Un fișier Dockerfile care copiază fișierele de fonturi aprobate în căile utilizate de imaginea CODE aleasă facilitează reproducerea implementărilor: rezumatul imaginii identifică atât versiunea serverului, cât și setul său de fonturi. Costul constă în reconstrucție, scanare și lansare de fiecare dată când actualizați un font sau imaginea de bază. Verificați din nou directoarele țintă după actualizările imaginii de bază și evitați să tratați o instrucțiune de copiere a fonturilor ca fiind universală în toate versiunile CODE.

Utilizarea configurării fonturilor la distanță pentru un catalog partajat

Proiectul fontserver al programului Collabora descrie configurarea fonturilor la distanță și un catalog JSON. Responsabilii săi etichetează acel depozit ca fiind destinat dezvoltării și testării, așadar nu tratați serverul eșantion ca un serviciu pregătit pentru producție. Pentru producție, utilizați un endpoint HTTPS întreținut corespunzător, restricționați și validați fonturile pe care le servește și luați în considerare disponibilitatea rețelei și comportamentul de reîmprospătare a memoriei cache. Această alegere poate reduce gestionarea fișierelor per gazdă, dar adaugă un serviciu a cărui defecțiune sau abatere de configurație poate afecta disponibilitatea fonturilor.

Consultați proiectul oficial Collabora fontserver și documentația de configurare Collabora pentru disponibilitatea fonturilor la distanță înainte de a alege această abordare.

Ce opțiune ar trebui să alegi?

Pentru un container CODE gestionat cu Docker Compose, începeți cu o montare bind doar pentru citire: este simplu să reveniți la versiunea inițială și nu necesită o compilare personalizată. Pentru o flotă întreținută prin CI/CD, preferați o imagine personalizată atunci când doriți ca fiecare implementare să conțină un set de fonturi explicit, revizuibil. Luați în considerare configurarea fonturilor la distanță numai atunci când distribuția centralizată reprezintă un beneficiu operațional semnificativ și puteți oferi un serviciu HTTPS sigur și fiabil. În fiecare caz, verificați căile și testați fontul într-un document real după implementare; lista de fonturi a gazdei nu poate confirma singură că Collabora l-a încărcat.