Pentru a face un font personalizat disponibil în ONLYOFFICE Docs, instalați fișierele sale de fonturi pe mașina sau containerul care rulează Document Server, regenerați lista de fonturi a serverului și verificați rezultatul într-un editor și într-un document exportat. Pasul exact de persistență a fișierelor depinde de faptul dacă serverul dvs. este instalat direct pe Linux sau rulează în Docker.
O modificare reușită înseamnă că fontul apare cu numele său de familie în selectorul de fonturi al editorului și se afișează așa cum era de așteptat într-un document de test. Vizualizarea unui nume în meniu este o primă verificare utilă, dar nu dovedește că fiecare stil, limbă sau cale de exportare funcționează. Verificați textul obișnuit și aldin, orice seturi de caractere necesare și un PDF sau o previzualizare a imprimării înainte de a utiliza fontul pentru documentele de producție.
Ce se schimbă când instalezi un font?
ONLYOFFICE Docs utilizează fonturi disponibile pentru gazda Document Server și creează metadate ale fonturilor pentru editorii săi. Ghidurile de instalare ale furnizorului listează familiile TrueType și OpenType, inclusiv .ttf, .otf, .ttcși formate conexe, precum și formate WOFF. Tipurile de fișiere acceptate nu garantează că fiecare fișier de font sau caracteristică a fontului se va comporta identic; testați fontul și documentul specific pe care intenționați să le utilizați.
Instalarea fonturilor pe server permite editorilor conectați să utilizeze fontul prin intermediul Document Server. Nu instalează fontul pe computerul fiecărui utilizator sau pe alte servere de procesare a documentelor. Dacă un fișier descărcat sau deschis separat este vizualizat într-un software căruia îi lipsește fontul, acel software îl poate înlocui cu un alt font. ONLYOFFICE menționează, de asemenea, că documentele pot fi afișate cu cel mai apropiat înlocuitor atunci când serverul nu are un font utilizat în document, ceea ce poate modifica sfârșiturile de linie sau aspectul paginii.
Folosește fișiere de fonturi pe care ești autorizat să le implementezi pe un server. Păstrează fișierele și termenii licenței aferente împreună cu înregistrările de implementare, mai ales dacă fontul are restricții privind utilizarea pe server, redistribuirea sau încorporarea în documente.
Alegeți metoda de instalare potrivită
- Instalarea pachetului Linux: copiați fișierele de fonturi în directorul de fonturi de sistem de pe mașina cu serverul de documente, apoi rulați scriptul de generare a fonturilor ONLYOFFICE. Acest lucru este potrivit atunci când gestionați direct gazda.
- Container Docker: montează un director gazdă persistent în directorul de fonturi al containerului sau copiază fonturile într-un container care rulează pentru un test de scurtă durată. Regeneră metadatele fonturilor din interiorul containerului. O montare bind supraviețuiește recreării containerului; o copie unică în container, în general, nu.
- Implementare gestionată sau integrată: dacă o altă platformă sau un instrument de instalare gestionează containerul Document Server, aplicați montarea persistentă prin configurația implementării respective. Editarea unui container care rulează singur se poate pierde în timpul unei actualizări sau înlocuiri.
Ghidurile de fonturi publicate în prezent de ONLYOFFICE prezintă același flux principal pentru Community Edition pe Linux și Docker și publică un ghid Linux separat pentru Enterprise Edition. Căile, permisiunile și orchestrarea containerelor pot varia în funcție de versiunea și metoda de instalare, așadar utilizați configurația existentă a implementării, în loc să o înlocuiți cu un exemplu dintr-un alt mediu.
Adăugarea de fonturi pe o instalare Linux
1. Pregătiți și instalați fișierele de fonturi
Obțineți fișierele familiei necesare, inclusiv variantele reale bold și italic, dacă familia le furnizează. Păstrați o familie obișnuită împreună într-un director denumit clar. De exemplu, un administrator ar putea plasa o familie de fonturi sub /usr/share/fonts/, locația de sistem utilizată în instrucțiunile Linux ale ONLYOFFICE:
sudo mkdir -p /usr/share/fonts/custom/brand-sans
sudo cp BrandSans-*.ttf /usr/share/fonts/custom/brand-sans/
Înlocuiți numele de fișiere exemplu cu fișierele pe care le aveți efectiv. Evitați redenumirea fișierelor de fonturi ca modalitate de a le schimba numele de familie; editorii utilizează metadatele stocate în fiecare fișier de fonturi. Asigurați-vă că procesele serverului de documente pot citi fișierele. Dacă gestionați fonturile printr-un pachet sau un sistem de gestionare a configurației, utilizați acel proces, astfel încât fișierele să rămână prezente după întreținere.
2. Regenerați lista de fonturi ONLYOFFICE
Rulați scriptul de generare a fonturilor al furnizorului după instalarea fișierelor:
sudo /usr/bin/documentserver-generate-allfonts.sh
Permiteți scriptului să se termine și verificați rezultatul pentru erori. Acest pas actualizează datele fonturilor utilizate de Document Server; simpla copiere a unui fișier de fonturi pe gazdă s-ar putea să nu îl facă să apară într-un editor care rulează deja. Nu eliminați fonturile existente ale serverului ca parte a acestei proceduri. Furnizorul avertizează că ștergerea fonturilor de sistem poate afecta aspectul și afișarea documentului.
Adăugați fonturi la o implementare Docker
1. Faceți directorul de fonturi persistent
Pentru o implementare gestionată cu Docker Compose, adăugați o montare bind la serviciul Document Server existent. Creați un director gazdă pentru fișiere, apoi mapați-l la directorul de fonturi personalizate al containerului. Imaginea Docker a ONLYOFFICE se declară /usr/share/fonts/truetype/customca volum, iar instrucțiunile sale pentru fonturi Docker permit, de asemenea, copierea fonturilor sub /usr/share/fonts/.
services:
onlyoffice-documentserver:
image: onlyoffice/documentserver:<your-pinned-version>
volumes:
- /srv/onlyoffice/fonts:/usr/share/fonts/truetype/custom
Acesta este un fragment de cod care va fi integrat în fișierul Compose curent, nu o configurație completă de înlocuire. Păstrați versiunea existentă a imaginii, rețelele, variabilele de mediu, volumele de date, secretele și numele serviciului. Pregătiți fișierele de fonturi pe gazdă la /srv/onlyoffice/fontsși asigurați-vă că containerul le poate citi.
Aplicarea unui fișier Compose modificat poate recrea containerul Document Server și poate întrerupe sesiunile de editare active. Verificați procedura de implementare, faceți o copie de rezervă a configurației Compose și programați modificarea în mod corespunzător. Dacă containerul este gestionat de un dispozitiv sau de o integrare, utilizați metoda de configurare acceptată în loc să editați un fișier Compose generat.
2. Recreați sau reporniți, apoi generați metadate de font
Aplicați montarea utilizând fluxul de lucru Compose normal pentru implementarea dvs. Apoi, rulați scriptul de generare a fonturilor în interiorul containerului Document Server propriu-zis. Pentru un container numit onlyoffice-documentserver, comanda este:
docker exec onlyoffice-documentserver /usr/bin/documentserver-generate-allfonts.sh
Folosește numele sau ID-ul containerului afișat de docker ps. Dacă dorești doar să verifici un font înainte de a face configurarea persistentă, furnizorul documentează copierea fișierelor de fonturi într-un container care rulează cu docker cp, urmată de rularea aceluiași script în interiorul acestuia. Tratamentul este un test: fișierele copiate într-un container pot dispărea atunci când containerul este înlocuit.
Verificați fontul într-un editor și în rezultat
- Deschideți un document într-un editor conectat la acest server de documente și deschideți selectorul de fonturi. Căutați numele de familie al fontului așa cum este înregistrat în metadatele sale.
- Creați un document de test scurt cu text obișnuit, text îngroșat și caractere din alfabetele lingvistice de care aveți nevoie. Confirmați că este selectată grosimea corectă, în loc de un stil sintetic sau substituit.
- Salvați, redeschideți și exportați sau previzualizați previzualizarea imprimării documentului de test. Comparați sfârșiturile de rând, numărul de pagini, spațierea și acoperirea glifelor cu rezultatul așteptat.
- Repetați verificarea în editorul de documente sau în aplicația pe care o utilizează utilizatorii. Un font disponibil pe server nu garantează că o aplicație locală fără legătură sau un alt server îl are.
Pentru instalările mai vechi, metadatele fonturilor stocate în memoria cache a browserului pot întârzia afișarea datelor de către utilizatori. Ghidurile publicate de ONLYOFFICE precizează că, pentru versiunea 8.1.3 sau o versiune anterioară, trebuie golită memoria cache a browserului și redeschisă pagina după adăugarea fonturilor; pentru versiunile ulterioare, acest pas nu este necesar. Mai întâi verificați fișierele de pe server și metadatele generate, apoi utilizați sfaturile privind memoria cache numai atunci când se potrivesc cu versiunea dvs.
Dacă lipsește fontul sau aspectul se modifică
- Fontul lipsește din selector: confirmați dacă fișierul se află în directorul de fonturi de pe gazda Document Server sau în containerul corect, este lizibil și are un tip de fișier acceptat. Rulați din nou scriptul de generare a fonturilor și citiți rezultatul. În Docker, verificați montarea din interiorul containerului; o cale gazdă singură nu dovedește că volumul este atașat la serviciul activ.
- Numele familiei arată diferit: verificați metadatele familiei încorporate în font. Un nume de fișier precum
BrandSans-Bold.ttfpoate fi instalat corect în timp ce meniul afișează numele familiei definit în interiorul fontului.
- Fontul apare, dar textul este greșit: testați dacă fontul include caracterele necesare și fișierele de stil reale. Un font poate apărea în selector, dar să nu aibă o glifă sau o grosime utilizată de document.
- Rearanjarea documentelor după modificare: comparați familia de fonturi și stilul exacte utilizate înainte și după. Dacă fontul original lipsește pe un alt computer sau serviciu de export, un înlocuitor poate modifica aspectul. Instalați fontul licențiat oriunde are loc randarea sau utilizați o alternativă sigură pentru documente și revizuiți din nou paginile.
- Fontul dispare după o actualizare: verificați dacă instalarea a fost efectuată doar într-un container de unică folosință. Mutați fișierele într-un director gazdă persistent și atașați-l prin configurația de implementare înainte de a recrea serviciul.
Adăugarea de fonturi personalizate este cea mai utilă atunci când este necesară aceeași familie de fonturi în documentele partajate și exporturile controlate. Are limite: instalarea pe server nu acordă drepturi de utilizare a fonturilor, nu adaugă glife lipsă la un font și nu garantează redarea identică la nivel de pixel în software-ul care utilizează un set de fonturi diferit. Păstrați directorul de fonturi personalizate sub controlul versiunilor sau gestionarea configurației, documentați versiunea Document Server și reluați verificările de verificare după actualizări.
Referințe oficiale