Commencez par identifier ce qui est flou.
Si la fenêtre ONLYOFFICE entière semble floue, testez la mise à l'échelle de l'affichage Linux avant de modifier les fichiers de police ou les paramètres de Fontconfig. Si seul le texte à l'intérieur d'un document s'affiche incorrectement, vérifiez si le document utilise une police manquante ou remplacée sur votre ordinateur. Il s'agit de problèmes différents qui nécessitent des solutions différentes.
Fermez et rouvrez ONLYOFFICE après chaque modification, puis examinez le même document à la même taille de fenêtre. Cette simple comparaison vous évite de modifier plusieurs paramètres simultanément et vous permet d'identifier clairement la modification qui a eu un impact. Si vous n'êtes pas certain que le problème provienne de l'éditeur, comparez le texte en petits caractères affiché dans une autre application de bureau sur le même écran.
1. Vérifiez l'échelle d'affichage du bureau et le type de session.
Des contours flous sur les menus, les étiquettes des barres d'outils et le texte des documents indiquent souvent un problème de mise à l'échelle de l'affichage ou du mode d'affichage de l'application. Une mise à l'échelle partielle, comme 125 % ou 150 %, peut être en cause sur certaines configurations Linux (environnement de bureau et carte graphique). Cela ne prouve pas l'existence d'un défaut général d'ONLYOFFICE : le serveur d'affichage, l'environnement de bureau, le format du paquet, le pilote graphique et la version de l'application influent tous sur le résultat.
Pour un test rapide, ouvrez les paramètres d'affichage de votre environnement de bureau et passez temporairement à une échelle standard, comme 100 % ou 200 %, si ces options conviennent à votre écran. Déconnectez-vous puis reconnectez-vous si nécessaire, et relancez ONLYOFFICE. Sous GNOME, l'option correspondante se trouve dans Paramètres > Affichages ; d'autres environnements de bureau utilisent des noms différents et peuvent proposer des niveaux d'échelle différents. Si l'application devient nette à une échelle standard, le flou est probablement lié à une mise à l'échelle fractionnelle ou au chemin d'affichage. Choisissez l'échelle la plus nette possible comme solution de contournement pratique, ou consultez la documentation de votre environnement de bureau pour connaître les options HiDPI prises en charge.
Vous pouvez identifier le type de session depuis un terminal avec la commande `ls` echo "$XDG_SESSION_TYPE". Le résultat est généralement `session` waylandou `session` x11. Cela ne permet pas de diagnostiquer la pile graphique en soi, mais fournit des informations utiles pour comparer le comportement entre les sessions ou signaler un problème reproductible. Ne copiez pas d'anciennes commandes GNOME activant des fonctionnalités expérimentales de mise à l'échelle fractionnelle sans consulter la documentation de votre version de GNOME ; les paramètres disponibles ont évolué.
Un problème signalé dans ONLYOFFICE Desktop Editors décrit un cas particulier sous GNOME 45 Wayland avec un facteur d'échelle fractionnaire de 125 % : l'utilisateur a constaté une interface et un document flous, tandis qu'un comportement différent a été observé sous KDE Wayland. Ce rapport indique que le problème peut dépendre de l'environnement et ne constitue pas une solution garantie pour tous les systèmes Linux. Consultez le rapport ONLYOFFICE concernant le facteur d'échelle fractionnaire de GNOME .
2. Dissocier la mise à l'échelle de l'interface du zoom du document
ONLYOFFICE propose une option de mise à l'échelle de l'interface sous Linux. Son historique de versions indique la prise en charge de valeurs de mise à l'échelle de 125 %, 150 % et 175 %. Les commandes exactes peuvent varier selon la version. Ouvrez les paramètres de l'application et recherchez l'option de mise à l'échelle de l'interface. Si le nom ou l'emplacement diffère, consultez l'aide de votre version installée plutôt que de vous fier à un chemin d'accès d'une version antérieure.
Modifiez uniquement l'échelle de l'interface de l'application pour effectuer un test, puis redémarrez l'éditeur si nécessaire. L'échelle de l'interface modifie la taille des commandes de l'application. Le zoom du document modifie la taille d'affichage de la page dans l'éditeur. Augmenter le zoom du document peut améliorer la lisibilité du texte, mais ne corrigera pas le flou du texte de la barre d'outils ni la faible résolution de la fenêtre entière. À l'inverse, réduire l'échelle de l'interface peut rendre les commandes plus nettes dans une configuration, mais trop petites pour être utilisées. Choisissez un réglage qui conserve une bonne lisibilité et comparez la barre d'outils et la page.
Pour information, le journal des modifications d'ONLYOFFICE Desktop Editors mentionne la prise en charge du redimensionnement de l'interface à 125 % et 175 % sous Linux et, dans une version antérieure, à 150 %. La version indiquée dans le journal des modifications au moment de la consultation de cet article est la 9.4.0, publiée le 19 mai 2026. Cette page ne garantit pas que tous les niveaux de redimensionnement fractionnel fonctionnent de manière identique sur toutes les distributions.
3. Vérifiez si le document utilise une police de caractères de substitution manquante.
Si les menus s'affichent correctement mais qu'un document présente des caractères flous, anormalement larges ou visiblement différents, vérifiez sa police de caractères. Il est possible qu'un document utilise une police non installée sur votre système Linux. L'éditeur doit alors afficher une police de substitution, ce qui peut modifier la forme des caractères, les sauts de ligne, la numérotation des pages et l'espacement. Une mise en page différente n'est pas synonyme d'un affichage flou, mais une police de substitution peut rendre le texte suffisamment illisible pour être confondu avec un problème d'affichage.
Dans un terminal, vérifiez la famille de polices utilisée par le document à l'aide de l'outil de correspondance de Fontconfig. Par exemple :
fc-match Arial
Cette commande affiche la police Fontconfig correspondant à cette famille. Si vous vérifiez un nom de police composé de plusieurs mots, placez-le entre guillemets, comme dans « police.info » fc-match "Liberation Serif". Un résultat de substitution ne signifie pas nécessairement qu'ONLYOFFICE utilise exactement la même police de repli à chaque étape de son processus de rendu ; il s'agit d'une vérification pratique des polices disponibles sur le système de polices Linux.
Installez la police de caractères requise depuis une source fiable et assurez-vous que sa licence vous autorise à l'utiliser. ONLYOFFICE indique l'emplacement des polices par utilisateur, notamment ~/.local/share/fontsdans le répertoire système /usr/share/fonts/. Pour une installation personnelle, copiez un fichier de police compatible dans un sous-dossier de ~/.local/share/fonts, puis actualisez le cache des polices utilisateur avec fc-cache -f. Un paquet de votre distribution ou son gestionnaire de polices graphique peut s'avérer plus sûr et plus simple, en particulier pour les polices système. Évitez de télécharger des ensembles de polices depuis des sites inconnus ou de remplacer les répertoires de polices système.
Après avoir installé une police, fermez complètement puis redémarrez ONLYOFFICE. Les instructions officielles d'ONLYOFFICE concernant l'ajout de polices recommandent également de redémarrer l'éditeur après l'installation. Rouvrez le fichier et vérifiez si la police sélectionnée est désormais disponible dans la liste des polices et si la mise en page du texte correspond à vos attentes.
4. Actualiser la détection des polices uniquement lorsqu'une police a été ajoutée ou modifiée.
Fontconfig gère les informations sur les polices et les fichiers de cache. Si vous venez d'installer, de supprimer ou de mettre à jour des polices, mais que les applications ne prennent toujours pas en compte la modification, actualisez le cache et redémarrez ONLYOFFICE.
fc-cache -f
Sur les systèmes où les polices sont installées globalement, le gestionnaire de paquets de votre distribution peut mettre à jour les caches de polices lors de l'installation. L'exécution de cette commande constitue une actualisation raisonnable, mais elle ne corrigera pas le flou causé par la mise à l'échelle partielle de l'affichage, un compositeur ou un pilote graphique. Ne supprimez pas les répertoires de cache de Fontconfig dans un premier temps. La documentation utilisateur de Fontconfig décrit la configuration et l'emplacement du cache, et précise que certains emplacements par utilisateur plus anciens sont obsolètes.
5. Mettez à jour l'éditeur et comparez avec un document propre.
Si le problème affecte l'ensemble de l'éditeur à une échelle normale, mettez à jour ONLYOFFICE Desktop Editors en utilisant le même canal d'installation compatible que celui que vous utilisez déjà, puis effectuez un nouveau test. La page de démarrage officielle d'ONLYOFFICE contient un lien vers les instructions d'installation pour Linux. Les utilisateurs d'AppImage doivent télécharger une version plus récente d'AppImage pour effectuer la mise à jour, conformément aux instructions officielles d'AppImage . Évitez de mélanger les paquets provenant de différents canaux lors du dépannage ; vérifiez d'abord quelle version vous lancez depuis le menu de votre application ou le terminal.
Créez maintenant un document vierge avec une police courante et comparez-le au fichier affecté. Si le document vierge est net mais qu'un fichier ne l'est pas, examinez attentivement les polices, les images intégrées et le niveau de zoom de ce fichier. Si tous les fichiers et toutes les parties de l'application restent flous, le problème vient probablement de la mise à l'échelle ou du chemin d'affichage graphique sous Linux. Une exportation unique au format PDF peut vous aider à distinguer l'aperçu à l'écran du document final, mais il ne s'agit pas d'un test complet du rendu à l'écran : les visionneuses PDF et les imprimantes utilisent leurs propres méthodes de rendu.
Choisissez la solution qui correspond au symptôme
- Les menus, la barre d'outils et la page ont tous un aspect doux : comparez une échelle de bureau standard avec votre échelle actuelle, puis testez séparément la mise à l'échelle de l'interface d'ONLYOFFICE.
- Un seul document semble incorrect : utilisez cette fonction
fc-matchpour vérifier la police nommée, installez la police sous licence si nécessaire, actualisez la recherche et redémarrez l’éditeur.
- Seul le texte du document est trop petit, et non flou : ajustez le zoom du document pour une meilleure lisibilité ; ne considérez pas le zoom comme une solution pour corriger le rendu des polices système.
- Le flou persiste après ces tests : indiquez la version d’ONLYOFFICE, sa distribution, le type de package, l’environnement de bureau, le type de session, le pourcentage d’échelle, la résolution d’affichage et si le flou affecte les menus, la page ou les deux. N’incluez un fichier d’exemple que s’il ne contient aucune information confidentielle.
Il n'existe pas de paramètre unique de rendu des polices sous Linux qui résolve tous les problèmes. Le critère de référence est une comparaison reproductible : le même texte doit s'afficher correctement à une échelle utilisable, les polices attendues doivent être disponibles et la mise en page du document doit rester correcte. Si la modification de l'échelle du système corrige l'affichage de la fenêtre mais rend d'autres applications inutilisables, conservez cette observation et communiquez les détails de votre environnement au projet ONLYOFFICE ou au support technique de votre distribution, plutôt que d'effectuer des modifications importantes et permanentes de la configuration des polices.
Sources