Abilita il controllo ortografico multilingue in Collabora Online CODE

Per eseguire il controllo ortografico di più lingue in Collabora Online, è necessario aggiungere il codice di ciascuna lingua richiesta alle dictionariesimpostazioni del contenitore CODICE, riavviare il contenitore e assegnare la lingua corretta a ciascun passaggio di testo. Entrambi gli aspetti sono importanti: il server deve rendere disponibili i dizionari e il documento deve contrassegnare i passaggi in inglese, francese o altre lingue con la relativa lingua. La semplice aggiunta di una lingua al contenitore non identifica automaticamente tutte le lingue presenti in un documento.

Cosa bisogna configurare?

Ci sono due contesti distinti da considerare:

• Dizionari del server: l'immagine Docker di CODE abilita per impostazione predefinita un elenco limitato di dizionari. La sua dictionariesvariabile d'ambiente modifica l'elenco delle lingue del dizionario configurate da CODE. Il manuale dell'SDK 25.04 di Collabora documenta i codici lingua separati da spazi, eventualmente seguiti da un codice paese, e osserva che limitare l'elenco aiuta a evitare un utilizzo non necessario delle risorse e un avvio più lento.
• Lingua del documento: Collabora utilizza la lingua assegnata al testo per selezionare il dizionario ortografico. Un documento può contenere lingue diverse in sezioni o paragrafi differenti, pertanto ogni passaggio deve essere etichettato correttamente.

Ad esempio, un documento con passaggi in inglese (Stati Uniti) e francese richiede che entrambi i codici siano abilitati sul server e che il testo in inglese e in francese abbia l'impostazione della lingua corrispondente. La lingua dell'interfaccia utente o il layout della tastiera non sostituiscono nessuna delle due impostazioni. Consultare il manuale dell'SDK di Collabora Online 25.04 e l' argomento della guida di Collabora sulla selezione della lingua del documento .

Configurare i dizionari di lingua in CODE Docker

Esempio di Docker Compose

Aggiungi i codici delle impostazioni locali desiderate come stringa separata da spazi nell'ambiente del servizio Collabora. Questo esempio mantiene l'elenco su inglese americano, inglese britannico e francese:

services:
  collabora:
    image: collabora/code
    restart: unless-stopped
    environment:
      dictionaries: "en_US en_GB fr_FR"
      domain: "cloud\.example\.com"
      username: "collabora_admin"
      password: "replace-with-a-long-unique-password"
    ports:
      - "127.0.0.1:9980:9980"

Sostituisci il pattern del dominio, le credenziali, il tag dell'immagine e la mappatura delle porte in modo che corrispondano alla tua implementazione. Mantieni le impostazioni esistenti del proxy inverso e della connessione a Nextcloud; questo frammento illustra solo dove dovrebbe trovarsi l'elenco del dizionario. Se utilizzi già un file Compose, modifica il servizio Collabora esistente anziché creare un secondo contenitore.

I codici lingua sopra riportati seguono quelli documentati da Collabora, dove una localizzazione può includere un codice paese. Utilizza codici corrispondenti alle lingue dei documenti utilizzate dai tuoi utenti. Non dare per scontato che ogni possibile codice abbia un dizionario utilizzabile in ogni immagine CODE: il manuale dell'SDK descrive la modifica dell'elenco configurato, mentre la build installata e i relativi dizionari determinano comunque quali sono effettivamente disponibili. Consulta la documentazione della versione dell'immagine CODE in esecuzione prima di aggiungere localizzazioni meno comuni.

Applica la modifica

1. Esegui un backup o conferma il file Compose corrente in modo da poter annullare la modifica.
2. Aggiorna il dictionariesvalore con solo le lingue necessarie ai tuoi utenti. Mantieni le altre variabili d'ambiente di Collabora.
3. Ricrea il servizio in modo che Docker passi l'ambiente aggiornato al container. Per una distribuzione Compose, esegui il comando docker compose up -d --force-recreate collaboradalla directory contenente il file Compose.
4. Controlla l'output di avvio con docker compose logs --tail=100 collabora. Cerca errori di avvio o di caricamento del dizionario; non considerare un semplice stato di successo del contenitore come prova dell'avvenuta installazione di un determinato dizionario.

Se la tua distribuzione utilizza docker runinvece, aggiorna il relativo -e dictionaries="en_US en_GB fr_FR"argomento e ricrea quel container con le stesse opzioni di rete, volume, proxy e sicurezza. La modifica dell'ambiente su un container in esecuzione non modifica l'ambiente con cui è stato avviato.

Assegna una lingua a ciascun brano

Una volta che il server è pronto, apri un documento in Nextcloud e seleziona il testo di cui vuoi controllare la lingua. Nei controlli della lingua di Collabora, scegli la lingua per la selezione o il paragrafo; per un documento interamente in una sola lingua, usa l'opzione che applica la lingua a tutto il testo. Le etichette dei comandi possono variare leggermente a seconda della versione e del layout dello schermo, ma l'importante è impostare la lingua del testo del documento anziché modificare solo la lingua dell'interfaccia. La guida di Collabora spiega che la lingua del documento determina il dizionario utilizzato per il controllo ortografico, il thesaurus e la sillabazione.

Per un documento multilingue, applicare la lingua a blocchi. Ad esempio, selezionare il paragrafo in francese e impostare Francese (Francia), quindi selezionare i paragrafi in inglese e impostare Inglese (Stati Uniti). Se il nuovo testo eredita la lingua sbagliata, posizionare il cursore in quel paragrafo e modificarne la lingua prima di digitare, oppure selezionare e rietichettare il testo in seguito. Una parola che sembra scritta male potrebbe semplicemente essere testo contrassegnato con la lingua sbagliata.

Il controllo ortografico può essere disabilitato per una selezione o una lingua. Nel menu Lingua di Collabora, l'opzione "Nessuno" esclude il testo selezionato dal controllo ortografico e dalla sillabazione. Se il testo è nella lingua corretta ma non viene sottoposto a correzione ortografica, verificare lo stato del controllo ortografico per quella lingua e controllare se la selezione è esclusa. La pagina di aiuto di Collabora Language descrive le opzioni linguistiche e l'opzione "Nessuno".

Verifiche rapide in caso di lingua mancante

Il manuale di amministrazione di Nextcloud descrive l'URL del server Collabora nella configurazione di Office. Mantieni questa impostazione di integrazione separata dalla modifica del dizionario; se la connessione funzionava già in precedenza, normalmente non dovresti aver bisogno di modificarla per le lingue con controllo ortografico. Fai riferimento alla documentazione di configurazione di Nextcloud per Office .

Verifica il risultato in un documento reale

Crea o apri un documento di prova e digita una parola volutamente errata in ciascuna lingua abilitata. Imposta ogni passaggio di esempio nella lingua desiderata, quindi verifica che il correttore ortografico segnali l'errore intenzionale. Digita anche una parola scritta correttamente in ciascuna lingua per assicurarti che non venga trattata come testo straniero. Ripeti l'operazione con un secondo utente se la disponibilità delle lingue varia a seconda dell'account o del documento.

Se una lingua continua a non funzionare, riducete il test a una sola lingua alla volta, controllate i log di CODE e confrontate il codice con la documentazione per la versione esatta dell'immagine. L'elenco predefinito di parole consentite nel dizionario di Collabora e il contenuto delle immagini possono cambiare tra una versione e l'altra; non si devono presumere le impostazioni predefinite documentate nel manuale della versione 25.04 per ogni tag successivo. Una volta che l'ortografia funziona correttamente in ogni passaggio esplicitamente contrassegnato, mantenete l'elenco di lingue più piccolo che soddisfi le esigenze dei vostri utenti.