Pour corriger l'orthographe dans plusieurs langues avec Collabora Online, ajoutez le code de langue souhaité au dictionariesparamètre du conteneur CODE, redémarrez ce dernier et attribuez la langue appropriée à chaque passage de texte. Les deux conditions sont essentielles : le serveur doit rendre les dictionnaires disponibles et le document doit indiquer la langue (anglais, français ou autre) dans le texte. L'ajout d'une langue au conteneur ne suffit pas à identifier automatiquement toutes les langues présentes dans le document.
Il y a deux paramètres distincts à prendre en compte :
dictionariesvariable d’environnement modifie la liste des langues configurées par CODE. Le manuel du SDK Collabora 25.04 décrit les codes de langue séparés par des espaces, éventuellement suivis d’un code pays, et précise que limiter cette liste permet d’éviter une utilisation inutile des ressources et un temps de démarrage réduit.Par exemple, un document contenant des passages en anglais (États-Unis) et en français nécessite l'activation des deux codes sur le serveur, et ses textes en anglais et en français doivent comporter le paramètre de langue correspondant. La langue de l'interface utilisateur ou la disposition du clavier ne remplacent pas ces paramètres. Consultez le manuel du SDK Collabora Online 25.04 et la rubrique d'aide Collabora relative à la sélection de la langue du document .
Ajoutez les codes de langue souhaités sous forme de chaîne de caractères séparée par des espaces dans l'environnement du service Collabora. Cet exemple limite la liste à l'anglais américain, l'anglais britannique et le français :
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"
Remplacez le modèle de domaine, les identifiants, l'étiquette d'image et le mappage de port par les paramètres correspondants à votre déploiement. Conservez les paramètres de proxy inverse et de connexion Nextcloud existants ; cet extrait illustre uniquement l'emplacement de la liste du dictionnaire. Si vous utilisez déjà un fichier Compose, modifiez le service Collabora existant au lieu de créer un second conteneur.
Les codes de langue ci-dessus sont conformes à la documentation de Collabora, où une locale peut inclure un code pays. Utilisez les codes correspondant aux langues des documents dont vos utilisateurs ont besoin. Ne présumez pas que chaque code possible possède un dictionnaire utilisable dans chaque image CODE : le manuel du SDK explique comment modifier la liste configurée, mais la version installée et ses dictionnaires déterminent ce qui est réellement disponible. Consultez la documentation de la version de l’image CODE que vous utilisez avant d’ajouter des locales moins courantes.
dictionariesvaleur en n'indiquant que les langues dont vos utilisateurs ont besoin. Conservez les autres variables d'environnement Collabora.docker compose up -d --force-recreate collaboradepuis le répertoire contenant le fichier Compose.docker compose logs --tail=100 collabora. Recherchez les erreurs de démarrage ou de chargement de dictionnaire ; ne considérez pas un statut de conteneur réussi comme la seule preuve qu'un dictionnaire particulier est installé.Si votre déploiement utilise docker runune autre méthode, mettez à jour son -e dictionaries="en_US en_GB fr_FR"argument et recréez ce conteneur avec les mêmes options de réseau, de volume, de proxy et de sécurité. Modifier l'environnement d'un conteneur en cours d'exécution ne modifie pas l'environnement avec lequel il a été démarré.
Une fois le serveur prêt, ouvrez un document dans Nextcloud et sélectionnez le texte dont vous souhaitez vérifier la langue. Dans les options de langue de Collabora, choisissez la langue de la sélection ou du paragraphe ; pour un document monolingue, utilisez l’option permettant d’appliquer la langue à tout le texte. Les libellés des commandes peuvent légèrement varier selon les versions et les mises en page, mais l’important est de définir la langue du texte du document et non de modifier uniquement la langue de l’interface. L’aide de Collabora explique que la langue du document détermine le dictionnaire utilisé pour la correction orthographique, le thésaurus et la césure.
Pour un document multilingue, appliquez la langue par blocs. Par exemple, sélectionnez le paragraphe en français et définissez-le sur « Français (France) », puis sélectionnez les paragraphes en anglais et définissez-les sur « Anglais (États-Unis) ». Si du texte est automatiquement marqué dans une langue incorrecte, placez le curseur dans ce paragraphe et modifiez sa langue avant de saisir du texte, ou sélectionnez-le et modifiez-le après coup. Un mot qui semble mal orthographié peut simplement être marqué dans la mauvaise langue.
La correction orthographique peut également être désactivée pour une sélection ou une langue. Dans le menu Langues de Collabora, l'option « Aucun » exclut le texte sélectionné de la correction orthographique et de la césure. Si le texte est dans la langue appropriée mais ne reçoit aucune marque orthographique, vérifiez l'état de la correction orthographique pour cette langue et assurez-vous que la sélection n'est pas exclue. La page d'aide Langues de Collabora décrit les options de langue et l'option « Aucun ».
| Ce que vous voyez | Que vérifier |
|---|---|
| Une seule langue reçoit des marques d'orthographe | Vérifiez que tous les codes nécessaires sont présents dictionaries, recréez le code, puis testez le texte explicitement balisé avec chaque langue. |
| Une langue est disponible dans le menu, mais aucun mot n'est coché. | Sélectionnez la langue du passage choisi et vérifiez que la correction orthographique est activée et non pas désactivée. La simple présence du menu ne prouve pas que le dictionnaire fonctionne. |
| Les modifications n'ont aucun effet après la modification de Composer | Vérifiez que vous avez bien recréé le service Collabora et que le conteneur en cours d'exécution est celui géré par le projet Compose modifié. |
| Nextcloud ne peut pas ouvrir les documents après la recréation | Vérifiez les journaux du service Collabora et du proxy, et assurez-vous que le paramètre Office de Nextcloud pointe toujours vers l'URL du serveur Collabora. La configuration du dictionnaire ne répare pas une connexion WOPI ou de proxy inverse. |
Le manuel d'administration de Nextcloud décrit l'URL du serveur Collabora dans la configuration Office. Ne modifiez pas ce paramètre d'intégration ; si la connexion fonctionnait déjà, vous n'aurez normalement pas besoin de la modifier pour les langues nécessitant une correction orthographique. Consultez la documentation de configuration de Nextcloud Office .
Créez ou ouvrez un document de test et saisissez un mot volontairement mal orthographié dans chaque langue disponible. Définissez chaque passage de test dans la langue souhaitée, puis vérifiez que le correcteur orthographique signale bien l'erreur intentionnelle. Saisissez également un mot correctement orthographié dans chaque langue pour vous assurer qu'il n'est pas considéré comme du texte étranger. Répétez l'opération avec un deuxième utilisateur si la disponibilité des langues varie selon le compte ou le document.
Si une langue pose toujours problème, réduisez le test à une langue à la fois, consultez les journaux CODE et comparez le code avec la documentation correspondant à la version exacte de l'image. La liste blanche du dictionnaire et le contenu des images par défaut de Collabora peuvent changer d'une version à l'autre ; les valeurs par défaut documentées dans le manuel de la version 25.04 ne doivent pas être utilisées pour toutes les versions ultérieures. Une fois l'orthographe correcte dans chaque passage explicitement balisé, conservez la liste de langues la plus restreinte répondant aux besoins de vos utilisateurs.
Configurez correctement les dictionnaires Docker de CODE et les passages de documents étiquetés afin que l'anglais, le français et les autres langues prises en charge bénéficient d'une correction orthographique appropriée.
Ajustez le seuil d'inactivité par vue dans coolwsd et distinguez-le de l'assombrissement des onglets en arrière-plan, du déchargement des documents, de la sauvegarde automatique et de l'expiration de la connexion.
Interrompez les vérifications de mise à jour du code planifiées, examinez les services distants optionnels et utilisez les contrôles réseau sortants sans interrompre l'édition des documents.
Activez l'édition sécurisée de documents dans Seafile en configurant l'URL de découverte de Collabora, le protocole HTTPS et l'accès WOPI pour votre déploiement.
Testez le presse-papiers système, ajustez les autorisations du navigateur et identifiez les cas où une intégration Collabora intégrée nécessite une modification de la politique iframe.
Montez les fichiers de polices dans Docker et le système de Collabora afin que les polices personnalisées apparaissent dans l'éditeur et s'affichent correctement dans les documents.
Sauvegardez coolwsd.xml et ses sources de déploiement, restaurez-les en toute sécurité et vérifiez le code avant que les utilisateurs ne reprennent l'édition.
Autorisez l'origine exacte Nextcloud ou autre WOPI dans CODE, puis vérifiez la liste blanche des hôtes actifs et distinguez-la de la restriction d'adresse IP source de Nextcloud.
Analysez les connexions du navigateur, WOPI et WebSocket de Collabora pour déterminer pourquoi un document ne s'ouvre pas, puis appliquez la solution correspondant à votre configuration Nextcloud.
Déployez des réplicas Collabora CODE avec Helm, conservez chaque document sur un pod via l'affinité WOPI et vérifiez l'entrée, le placement des nœuds et l'édition Nextcloud.
