Adăugați fonturi pe serverul de documente ONLYOFFICE: Docker vs Linux

Pentru a adăuga fonturi personalizate la ONLYOFFICE Document Server, plasați fișierele de fonturi licențiate într-un director accesibil serverului și rulați comanda /usr/bin/documentserver-generate-allfonts.sh. Pentru implementările Docker, un director de fonturi montat prin bind este de obicei preferabil copierii fișierelor într-un container care rulează, deoarece acesta supraviețuiește recreării containerului.

Metoda corectă de instalare depinde de locul în care rulează ONLYOFFICE Docs, de frecvența cu care îl reconstruiți și de posibilitatea de a accepta o scurtă întrerupere a serviciului în timp ce catalogul de fonturi este actualizat.

Alegeți o metodă de instalare a fonturilor

Instrucțiunile oficiale pentru fonturi Docker documentează copierea fișierelor și reconstrucția listei de fonturi. Referința de montare bind din Docker explică de ce montarea unui folder gazdă dedicat face ca fișierele să fie disponibile în diferitele înlocuiri de containere. Acestea sunt opțiuni de implementare diferite, nu formate de fonturi diferite.

Pregătiți fișierele de fonturi și confirmați serverul țintă

1. Identificați implementarea ONLYOFFICE activă

Executați docker pspe gazda Docker dacă editorul rulează în containere. Găsiți numele containerului Document Server în NAMEScoloană; exemplele de mai jos utilizează onlyoffice-documentserver. Înlocuiți acea valoare dacă a dvs. diferă. O integrare Nextcloud sau ownCloud nu modifică în mod normal faptul că fonturile trebuie instalate pe serverul ONLYOFFICE Docs, nu doar pe serverul de stocare sau pe computerul care vizualizează documentul.

docker ps

2. Colectați fișiere de fonturi licențiate

Alegeți familii de fonturi complete, licențiate corespunzător, inclusiv grosimile și stilurile utilizate efectiv în documentele dvs. ONLYOFFICE listează formatele TrueType și OpenType, cum ar fi .ttfși .otf, plus alte extensii de fonturi acceptate, în documentația sa de fonturi Linux . Pentru o primă implementare previzibilă, utilizați fișiere TTF sau OTF obișnuite și verificați utilizarea permisă a serverului și a clientului în licența de fonturi.

Pentru exemplul Docker, instalați fișierele /srv/onlyoffice/custom-fontspe gazda Docker. Numele de fișiere din exemplu Inter-Regular.ttfși Inter-Bold.ttfsunt ilustrative; utilizați fișierele pe care aveți dreptul să le instalați.

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

Executați aceste comenzi din directorul care conține fișierele de fonturi. Verificați conținutul folderului înainte de a continua. Pe un sistem gestionat, adaptați proprietatea și permisiunile la politica dvs. de securitate, în loc să faceți folderul accesibil tuturor.

Recomandat pentru Docker: montați directorul de fonturi în mod persistent

3. Adăugați o montare bind la serviciul Compose existent

În fișierul Compose curent, găsiți serviciul care rulează imaginea ONLYOFFICE Document Server. Adăugați următoarea intrare în volumeslista existentă; păstrați celelalte volume, porturi, acreditări și variabile de mediu deja configurate:

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

Calea sursă se află pe gazda Docker; destinația se află în interiorul containerului. Sufixul :rorestricționează scrierea containerului în directorul de fonturi. Montați customdirectorul dedicat în loc să înlocuiți întregul /usr/share/fontsarbore, ceea ce ar putea ascunde fonturile furnizate de imagine. Fișierul Dockerfile oficial ONLYOFFICE declară directorul de fonturi TrueType personalizat ca volum în etapele de imagine Community și Enterprise.

Revizuiți configurația Compose revizuită, apoi aplicați-o cu docker compose up -ddin directorul proiectului. Aceasta poate recrea serviciul: programați modificarea atunci când editorii pot închide documentele în siguranță. Dacă utilizați o docker runimplementare simplă, adăugați argumentul echivalent doar pentru citire --mount type=bind,src=/srv/onlyoffice/custom-fonts,dst=/usr/share/fonts/truetype/custom,readonlyatunci când recreați containerul.

4. Verificați dacă containerul poate vedea fișierele de fonturi

După ce serviciul rulează, verificați directorul montat și, dacă este disponibil, lista fontconfig. Numele de familie raportat de fontconfig poate diferi de numele fișierului.

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

Pentru fonturile Inter eșantion, a doua comandă ar trebui să listeze o familie potrivită dacă fontconfig le detectează. Dacă fișierele există, dar familia nu apare, verificați permisiunile și rulați docker exec onlyoffice-documentserver fc-cache -f, apoi verificați fc-listdin nou. Fontconfig discovery singură nu populează meniul editorului ONLYOFFICE.

5. Regenerați catalogul de fonturi ONLYOFFICE

Cu fișierele prezente în container, rulați scriptul de generare a fonturilor al serverului de documente:

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

ONLYOFFICE folosește acest pas pentru a actualiza datele și resursele de selecție a fonturilor. Poate afecta serviciile de editare active, așa că rulați-l într-o perioadă de mentenanță adecvată. Variabila de mediu Docker documentată GENERATE_FONTSare, de asemenea, valoarea implicită true, regenerând datele fonturilor la pornirea containerului; acest lucru este util după o repornire, dar nu înlocuiește instalarea fișierelor într-o locație persistentă.

Nu modificați GENERATE_FONTSși nu forțați o repornire doar pentru a masca un volum lipsă. Verificați mai întâi dacă fișierele așteptate sunt într-adevăr montate.

Alternative: copie temporară Docker sau Linux nativ

6. Folosește o copie directă a containerului pentru un test de scurtă durată

Dacă nu puteți modifica imediat parametrul Compose, copiați un fișier în containerul curent și reconstruiți catalogul. Aceasta urmează abordarea Docker documentată de ONLYOFFICE și evită reconstruirea containerului pentru un test rapid:

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

Acest lucru este convenabil pentru depanare, dar mai puțin fiabil ca plan de implementare. O actualizare a imaginii sau un container nou poate elimina fișierul copiat; o repornire a aceluiași container nu este același lucru cu o recreare . Promovați un test reușit la o montare bind sau la o imagine personalizată întreținută separat atunci când fontul este necesar pentru lucrul continuu.

7. Instalați direct pe un server de documente Linux necontainerizat

Pentru o instalare nativă a unui pachet Linux, plasați fișierele în directorul de fonturi de sistem al serverului și rulați același script de regenerare pe gazda respectivă. Aceasta nu este o comandă de rulat pe desktopul unui utilizator obișnuit.

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

Această abordare lasă fișierele de fonturi în instalarea Linux în loc de un volum Docker, dar administratorii trebuie să le păstreze în gestionarea configurației sau în copiile de rezervă atunci când reconstruiesc gazda. Consultați procedura oficială ONLYOFFICE Linux pentru serverul instalat în pachet. Dacă mai multe noduri Document Server deservesc editorii dvs., furnizați aceeași familie și variante pe fiecare nod.

8. Verificați fontul într-un document real

Deschideți o nouă sesiune de editare în aplicația conectată la Document Server. Într-un DOCX de test, selectați familia instalată din meniul derulant de fonturi, introduceți o linie de text normal, text aldin și caractere reprezentative non-engleze dacă fontul este destinat utilizării multilingve. Salvați, închideți, redeschideți și exportați în format PDF. Comparați lățimea textului, încadrarea liniilor, acoperirea glifelor și variantele aldin/italice cu un document de referință cunoscut.

Dacă un font lipsește din meniul derulant, verificați calea serverului, rezultatul lui fc-listși comanda de generare a catalogului în această ordine. Dacă familia apare, dar aspectul se schimbă, verificați dacă documentul solicită familia exactă și dacă există ponderile necesare; în caz contrar, editorul poate înlocui o altă față. Instalarea unui font pe desktopul unui utilizator nu îl adaugă la server.

Există o avertizare specifică versiunii browserului: instrucțiunile de font ale ONLYOFFICE spun să goliți memoria cache a browserului și să redeschideți editorul în versiunea 8.1.3 sau o versiune anterioară . Pe versiunile ulterioare, acest pas suplimentar nu este necesar. Dacă instalarea este mai veche, utilizați pasul documentat pentru memoria cache înainte de a investiga cauze mai complexe.

Corecția este confirmată atunci când familia personalizată rămâne selectabilă după redeschiderea editorului, documentul salvat se redă corect și - pentru Docker - fonturile există în continuare după ce serviciul este recreat din aceeași configurație. Dacă una dintre aceste verificări eșuează, investigați stratul respectiv în loc să copiați în mod repetat fonturile în container.