Come aggiungere font personalizzati al server di documenti ONLYOFFICE

Per rendere disponibile un carattere personalizzato in ONLYOFFICE Docs, installa i relativi file di font sulla macchina o sul container che esegue Document Server, rigenera l'elenco dei font del server e verifica il risultato in un editor e in un documento esportato. La procedura esatta per la persistenza dei file dipende dal fatto che il server sia installato direttamente su Linux o in esecuzione in Docker.

Una modifica riuscita significa che il font appare con il suo nome di famiglia nel selettore font dell'editor e viene visualizzato come previsto in un documento di prova. Vedere un nome nel menu è un utile controllo iniziale, ma non garantisce che ogni stile, lingua o percorso di esportazione funzioni correttamente. Prima di utilizzare il font per i documenti di produzione, verifica il testo normale e in grassetto, eventuali set di caratteri necessari e un'anteprima in PDF o di stampa.

Cosa cambia quando si installa un font?

ONLYOFFICE Docs utilizza i font disponibili sul server di documenti e crea metadati dei font per i suoi editor. Le guide di installazione del fornitore elencano le famiglie TrueType e OpenType, inclusi .ttf, .otf, .ttc, e formati correlati, nonché i formati WOFF. I tipi di file supportati non garantiscono che ogni file di font o funzionalità del font si comporti in modo identico; testa il font e il documento specifici che intendi utilizzare.

L'installazione dei font lato server consente agli editor connessi di utilizzare il font tramite Document Server. Non installa il font su ogni computer dell'utente né su altri server di elaborazione documenti. Se un file scaricato o aperto separatamente viene visualizzato in un software che non dispone del font, tale software potrebbe sostituirlo con un altro font. ONLYOFFICE precisa inoltre che, qualora il server non disponga del font utilizzato nel documento, i documenti potrebbero essere visualizzati con un font sostitutivo il più simile possibile, il che potrebbe comportare modifiche alle interruzioni di riga o al layout di pagina.

Utilizza solo file di font per i quali sei autorizzato a distribuire su un server. Conserva i file e i relativi termini di licenza insieme alla documentazione di distribuzione, soprattutto se il font presenta restrizioni sull'utilizzo sul server, sulla ridistribuzione o sull'incorporamento nei documenti.

Scegliere il metodo di installazione corretto

• Installazione del pacchetto Linux: copiare i file dei font nella directory dei font di sistema sul server dei documenti, quindi eseguire lo script di generazione dei font di ONLYOFFICE. Questa procedura è appropriata quando si gestisce direttamente l'host.
• Contenitore Docker: monta una directory host persistente nella directory dei font del contenitore oppure copia i font in un contenitore in esecuzione per un test di breve durata. Rigenera i metadati dei font all'interno del contenitore. Un bind mount persiste anche dopo la ricreazione del contenitore; una copia una tantum all'interno del contenitore generalmente non lo fa.
• Distribuzione gestita o integrata: se un'altra piattaforma o uno strumento di installazione gestisce il contenitore del Document Server, applicare il montaggio persistente tramite la configurazione di tale distribuzione. La modifica di un contenitore in esecuzione potrebbe andare persa durante un aggiornamento o una sostituzione.

Le guide ai font attualmente pubblicate da ONLYOFFICE mostrano lo stesso flusso principale per la Community Edition su Linux e Docker, e pubblicano una guida Linux separata per la Enterprise Edition. Percorsi, autorizzazioni e orchestrazione dei container possono variare a seconda della versione e del metodo di installazione, quindi è consigliabile utilizzare la configurazione esistente della propria implementazione anziché sostituirla con un esempio proveniente da un altro ambiente.

Aggiungere font a un'installazione Linux

1. Preparare e installare i file dei caratteri

Ottieni i file della famiglia di caratteri necessari, incluse le varianti in grassetto e corsivo, se previste dalla famiglia stessa. Mantieni una famiglia di caratteri standard in una directory dal nome chiaro. Ad esempio, un amministratore potrebbe posizionare una famiglia di caratteri in /usr/share/fonts/, la posizione di sistema utilizzata nelle istruzioni Linux di ONLYOFFICE:

sudo mkdir -p /usr/share/fonts/custom/brand-sans
sudo cp BrandSans-*.ttf /usr/share/fonts/custom/brand-sans/

Sostituisci i nomi dei file di esempio con i file che possiedi effettivamente. Evita di rinominare i file dei font per modificarne il nome di famiglia; gli editor utilizzano i metadati memorizzati all'interno di ciascun file di font. Assicurati che i processi del Document Server possano leggere i file. Se gestisci i font tramite un sistema di gestione dei pacchetti o della configurazione, utilizza tale sistema in modo che i file rimangano presenti anche dopo la manutenzione.

2. Rigenera l'elenco dei caratteri ONLYOFFICE

Eseguire lo script di generazione dei font fornito dal produttore dopo aver installato i file:

sudo /usr/bin/documentserver-generate-allfonts.sh

Attendere il completamento dello script e verificarne l'output per individuare eventuali errori. Questo passaggio aggiorna i dati dei font utilizzati da Document Server; la semplice copia di un file di font sull'host potrebbe non renderlo visibile in un editor già in esecuzione. Non rimuovere i font del server esistenti durante questa procedura. Il fornitore avverte che l'eliminazione dei font di sistema può influire sul layout e sulla visualizzazione del documento.

Aggiungere font a una distribuzione Docker

1. Rendere persistente la directory dei font

Per una distribuzione gestita con Docker Compose, aggiungi un bind mount al servizio Document Server esistente. Crea una directory host per i file, quindi mappala alla directory custom-font del container. L'immagine Docker di ONLYOFFICE dichiara /usr/share/fonts/truetype/customcome volume e le sue istruzioni per i font Docker consentono anche di copiare i font in /usr/share/fonts/.

services:
  onlyoffice-documentserver:
    image: onlyoffice/documentserver:<your-pinned-version>
    volumes:
      - /srv/onlyoffice/fonts:/usr/share/fonts/truetype/custom

Questo è un frammento da unire al tuo attuale file Compose, non una configurazione di sostituzione completa. Mantieni la versione dell'immagine, le reti, le variabili d'ambiente, i volumi di dati, i segreti e il nome del servizio esistenti. Prepara i file dei font sull'host /srv/onlyoffice/fontse assicurati che il container possa leggerli.

L'applicazione di un file Compose modificato potrebbe ricreare il contenitore del Document Server e interrompere le sessioni di modifica attive. Verifica la procedura di distribuzione, esegui un backup della configurazione di Compose e pianifica la modifica in modo appropriato. Se il contenitore è gestito da un'appliance o da un'integrazione, utilizza il metodo di configurazione supportato da tale appliance anziché modificare un file Compose generato.

2. Ricrea o riavvia, quindi genera i metadati del font

Applica il montaggio utilizzando il normale flusso di lavoro Compose per la tua distribuzione. Quindi esegui lo script di generazione dei font all'interno del contenitore Document Server effettivo. Per un contenitore denominato onlyoffice-documentserver, il comando è:

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

Utilizza il nome o l'ID del contenitore mostrato da docker ps. Se desideri solo verificare un font prima di rendere permanente la configurazione, il fornitore documenta la copia dei file dei font in un contenitore in esecuzione con docker cp, seguita dall'esecuzione dello stesso script al suo interno. Consideralo come un test: i file copiati in un contenitore potrebbero scomparire quando il contenitore viene sostituito.

Verifica il carattere nell'editor e nell'output

1. Apri un documento in un editor connesso a questo server di documenti e apri la finestra di selezione dei caratteri. Cerca il nome della famiglia di caratteri così come è registrato nei relativi metadati.
2. Crea un breve documento di prova con testo normale, testo in grassetto e caratteri degli alfabeti linguistici di cui hai bisogno. Verifica che sia selezionato il peso corretto e non uno stile sintetico o sostitutivo.
3. Salva, riapri ed esporta o visualizza l'anteprima di stampa del documento di prova. Confronta le interruzioni di riga, il numero di pagine, la spaziatura e la copertura dei glifi con il risultato atteso.
4. Ripeti il ​​controllo nell'editor di documenti o nell'applicazione effettivamente utilizzata dai tuoi utenti. La disponibilità di un font sul server non garantisce che sia presente anche in un'applicazione locale non correlata o su un altro server.

Nelle installazioni meno recenti, i metadati dei font memorizzati nella cache del browser possono ritardare la visualizzazione da parte degli utenti. Le guide pubblicate da ONLYOFFICE indicano che per la versione 8.1.3 o precedente, è necessario svuotare la cache del browser e riaprire la pagina dopo aver aggiunto i font; per le versioni successive, questo passaggio non è necessario. Verificate prima i file lato server e i metadati generati, quindi utilizzate il consiglio relativo alla cache solo se corrisponde alla vostra versione.

Se il carattere è mancante o il layout cambia

• Il font non è presente nell'elenco dei font: verificare che il file si trovi nella directory dei font sull'host del Document Server o all'interno del container corretto, che sia leggibile e che abbia un tipo di file supportato. Eseguire nuovamente lo script di generazione dei font e leggerne l'output. In Docker, verificare il mount dall'interno del container; un percorso host da solo non è sufficiente a dimostrare che il volume sia collegato al servizio attivo.
• Il nome della famiglia appare diverso: controlla i metadati della famiglia incorporati nel font. Un nome file come BrandSans-Bold.ttfpotrebbe essere installato correttamente mentre il menu mostra il nome della famiglia definito all'interno del font.
• Il font viene visualizzato, ma il testo è errato: verifica che il font includa i caratteri richiesti e i file di stile effettivi. Un font può apparire nello strumento di selezione ma non contenere un glifo o un peso utilizzato dal documento.
• Dopo la modifica, il documento viene ridisposto: confrontate esattamente la famiglia di caratteri e lo stile utilizzati prima e dopo. Se il carattere originale non è presente su un altro computer o servizio di esportazione, un carattere sostitutivo potrebbe alterare il layout. Installate il carattere con licenza ovunque avvenga il rendering, oppure utilizzate un'alternativa compatibile con il documento e rivedete le pagine.
• Il font scompare dopo un aggiornamento: verifica se l'installazione è stata effettuata solo all'interno di un contenitore temporaneo. Sposta i file in una directory host permanente e collegala tramite la configurazione di distribuzione prima di ricreare il servizio.

L'aggiunta di font personalizzati è particolarmente utile quando è necessario utilizzare la stessa famiglia di font in documenti condivisi ed esportazioni controllate. Tuttavia, presenta dei limiti: l'installazione sul server non concede i diritti di utilizzo dei font, non aggiunge glifi mancanti a un font e non garantisce una resa pixel-identica in software che utilizzano un set di font diverso. È consigliabile mantenere la directory dei font personalizzati sotto controllo di versione o di configurazione, documentare la versione del Document Server ed eseguire nuovamente i controlli di verifica dopo gli aggiornamenti.

Riferimenti ufficiali

• Documentazione ONLYOFFICE Community Edition: Aggiungere font su Linux
• Documentazione ONLYOFFICE Community Edition: Aggiungere font a Docker
• Documentazione ONLYOFFICE Enterprise Edition: Aggiungere font su Linux
• Repository Docker-DocumentServer di ONLYOFFICE