Comment ajouter des polices personnalisées au serveur de documents ONLYOFFICE

Pour utiliser une police personnalisée dans ONLYOFFICE Docs, installez ses fichiers de police sur la machine ou le conteneur exécutant le serveur de documents, régénérez la liste des polices du serveur et vérifiez le résultat dans un éditeur et un document exporté. La procédure exacte de persistance des fichiers dépend de l'environnement d'installation de votre serveur : Linux ou conteneur Docker.

Une modification réussie signifie que la police apparaît sous son nom de famille dans le sélecteur de polices de l'éditeur et s'affiche correctement dans un document de test. La présence du nom dans le menu est une première vérification utile, mais ne garantit pas le bon fonctionnement de tous les styles, langues ou options d'exportation. Avant d'utiliser la police dans des documents de production, testez le texte normal et gras, les jeux de caractères nécessaires, ainsi qu'un aperçu PDF ou avant impression.

Qu’est-ce qui change lorsque vous installez une police de caractères ?

ONLYOFFICE Docs utilise les polices disponibles sur le serveur de documents hôte et génère des métadonnées de police pour ses éditeurs. Les guides d'installation du fournisseur répertorient les familles TrueType et OpenType, notamment les formats .ttf, .otf, .ttcet associés, ainsi que les formats WOFF. La compatibilité des types de fichiers ne garantit pas un comportement identique pour chaque fichier de police ou fonctionnalité ; il est donc recommandé de tester la police et le document que vous prévoyez d'utiliser.

L'installation de la police côté serveur permet aux éditeurs connectés d'utiliser la police via le serveur de documents. Elle n'installe pas la police sur l'ordinateur de chaque utilisateur ni sur les autres serveurs de traitement de documents. Si un fichier téléchargé ou ouvert séparément est visualisé dans un logiciel ne disposant pas de la police, ce dernier peut utiliser une autre police. ONLYOFFICE précise également que les documents peuvent s'afficher avec une police de substitution la plus proche lorsque le serveur ne dispose pas de la police utilisée dans le document, ce qui peut modifier les sauts de ligne ou la mise en page.

Utilisez les fichiers de polices pour lesquels vous êtes autorisé à déployer sur un serveur. Conservez ces fichiers et leurs conditions de licence avec vos documents de déploiement, notamment si la police est soumise à des restrictions d'utilisation sur serveur, de redistribution ou d'intégration dans des documents.

Choisissez la méthode d'installation appropriée

  • Installation du paquet Linux : copiez les fichiers de police dans le répertoire des polices système du serveur de documents, puis exécutez le script de génération de polices d’ONLYOFFICE. Cette méthode est appropriée si vous gérez directement l’hôte.
  • Conteneur Docker : montez un répertoire hôte persistant dans le répertoire des polices du conteneur, ou copiez des polices dans un conteneur en cours d'exécution pour un test ponctuel. Régénérez les métadonnées des polices à l'intérieur du conteneur. Un montage de type « bind » est conservé lors de la recréation du conteneur ; une copie ponctuelle dans le conteneur, en revanche, ne l'est généralement pas.
  • Déploiement géré ou intégré : si une autre plateforme ou un outil d’installation gère le conteneur du serveur de documents, appliquez le montage persistant via la configuration de ce déploiement. Toute modification apportée à un conteneur en cours d’exécution peut être perdue lors d’une mise à jour ou d’un remplacement.

Les guides de polices actuellement publiés par ONLYOFFICE présentent la même procédure principale pour l'édition Community sous Linux et Docker, et proposent un guide Linux distinct pour l'édition Enterprise. Les chemins d'accès, les permissions et l'orchestration des conteneurs peuvent varier selon votre version et votre méthode d'installation ; il est donc recommandé d'utiliser la configuration existante de votre déploiement plutôt que de la remplacer par un exemple provenant d'un autre environnement.

Ajouter des polices sur une installation Linux

1. Préparez et installez les fichiers de police

Obtenez les fichiers de famille de polices requis, y compris les variantes gras et italique si la famille les propose. Conservez les familles de polices standard dans un répertoire clairement nommé. Par exemple, un administrateur peut placer une famille de polices sous `/usr/local/polices` /usr/share/fonts/, l'emplacement système indiqué dans les instructions Linux d'ONLYOFFICE :

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

Remplacez les noms de fichiers d'exemple par vos propres fichiers. Évitez de renommer les fichiers de police pour modifier leur nom de famille ; les éditeurs utilisent les métadonnées stockées dans chaque fichier. Assurez-vous que les processus du serveur de documents peuvent lire ces fichiers. Si vous gérez les polices via un système de gestion de paquets ou de configuration, utilisez ce système afin que les fichiers restent disponibles après la maintenance.

2. Régénérer la liste des polices ONLYOFFICE

Exécutez le script de génération de polices du fournisseur après avoir installé les fichiers :

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

Laissez le script s'exécuter jusqu'à la fin et vérifiez sa sortie pour détecter d'éventuelles erreurs. Cette étape met à jour les données de police utilisées par le serveur de documents ; la simple copie d'un fichier de police sur l'hôte peut ne pas suffire à l'afficher dans un éditeur déjà ouvert. Ne supprimez pas les polices serveur existantes dans le cadre de cette procédure. Le fournisseur avertit que la suppression des polices système peut affecter la mise en page et l'affichage des documents.

Ajouter des polices à un déploiement Docker

1. Rendre le répertoire des polices persistant

Pour un déploiement géré avec Docker Compose, ajoutez un montage de liaison au service Document Server existant. Créez un répertoire hôte pour les fichiers, puis mappez-le au répertoire des polices personnalisées du conteneur. L'image Docker d'ONLYOFFICE déclare ce répertoire /usr/share/fonts/truetype/customcomme un volume, et ses instructions de police Docker permettent également de copier les polices sous ce répertoire /usr/share/fonts/.

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

Il s'agit d'un extrait à intégrer à votre fichier Compose actuel, et non d'une configuration de remplacement complète. Conservez votre version d'image, vos réseaux, vos variables d'environnement, vos volumes de données, vos secrets et le nom de votre service. Préparez les fichiers de police sur l'hôte /srv/onlyoffice/fontset assurez-vous que le conteneur peut les lire.

L'application d'un fichier Compose modifié peut entraîner la recréation du conteneur du serveur de documents et l'interruption des sessions d'édition en cours. Vérifiez votre procédure de déploiement, sauvegardez la configuration Compose et planifiez la modification en conséquence. Si le conteneur est géré par un dispositif ou une intégration, utilisez la méthode de configuration prévue à cet effet plutôt que de modifier un fichier Compose généré.

2. Recréez ou redémarrez, puis générez les métadonnées de la police

Appliquez le montage en suivant le flux de travail Compose standard pour votre déploiement. Ensuite, exécutez le script de génération de polices dans le conteneur du serveur de documents. Pour un conteneur nommé onlyoffice-documentserver, la commande est :

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

Utilisez le nom ou l'ID du conteneur affiché docker ps. Si vous souhaitez uniquement tester une police avant de rendre la configuration permanente, le fournisseur indique comment copier les fichiers de police dans un conteneur en cours d'exécution avec la commande `ls -l` docker cp, puis exécuter le même script à l'intérieur de ce conteneur. Cette opération est à considérer comme un test : les fichiers copiés dans un conteneur peuvent disparaître lors du remplacement de ce dernier.

Vérifiez la police dans un éditeur et dans le résultat.

  1. Ouvrez un document dans un éditeur connecté à ce serveur de documents et ouvrez le sélecteur de polices. Recherchez le nom de la famille de polices tel qu'il est indiqué dans ses métadonnées.
  2. Créez un court document de test contenant du texte normal, du texte en gras et des caractères issus des systèmes d'écriture nécessaires. Vérifiez que la graisse appropriée est sélectionnée et non un style synthétique ou de substitution.
  3. Enregistrez, rouvrez et exportez ou prévisualisez avant impression le document de test. Comparez les sauts de ligne, le nombre de pages, l'espacement et la couverture des glyphes avec le résultat attendu.
  4. Répétez la vérification dans l'éditeur de documents ou l'application que vos utilisateurs utilisent réellement. La présence d'une police sur le serveur ne garantit pas sa disponibilité dans une application locale non liée ou sur un autre serveur.

Pour les installations plus anciennes, les métadonnées de police mises en cache côté navigateur peuvent retarder l'affichage. Les guides d'ONLYOFFICE indiquent que pour la version 8.1.3 et les versions antérieures, il est conseillé de vider le cache du navigateur et de rouvrir la page après l'ajout des polices ; pour les versions ultérieures, cette étape n'est pas nécessaire. Commencez par vérifier les fichiers côté serveur et les métadonnées générées, puis tenez compte de ces recommandations concernant le cache uniquement si elles correspondent à votre version.

Si la police est manquante ou si la mise en page change

  • La police est absente du sélecteur : vérifiez que le fichier se trouve bien dans le répertoire des polices sur l’hôte du serveur de documents ou dans le conteneur approprié, qu’il est lisible et qu’il possède un type de fichier compatible. Relancez le script de génération de polices et consultez son résultat. Dans Docker, vérifiez le montage depuis l’intérieur du conteneur ; un chemin d’accès à l’hôte seul ne prouve pas que le volume est connecté au service actif.
  • Le nom de famille peut sembler différent : vérifiez les métadonnées de famille intégrées à la police. Un nom de fichier tel que « police.ms » BrandSans-Bold.ttfpeut être correctement installé alors que le menu affiche le nom de famille défini dans la police.
  • La police s'affiche, mais le texte est incorrect : vérifiez que la police inclut bien les caractères requis et les fichiers de style correspondants. Une police peut apparaître dans le sélecteur, mais ne pas comporter un glyphe ou une graisse utilisés dans le document.
  • Après modification, la mise en page des documents se réorganise : comparez la police et le style exacts utilisés avant et après. Si la police d’origine est absente sur un autre ordinateur ou service d’exportation, une police de substitution peut modifier la mise en page. Installez la police sous licence partout où le rendu est effectué, ou utilisez une alternative compatible avec les documents et vérifiez à nouveau les pages.
  • La police disparaît après une mise à jour : vérifiez si l’installation a été effectuée dans un conteneur éphémère. Déplacez les fichiers vers un répertoire hôte persistant et associez-le via la configuration de déploiement avant de recréer le service.

L'ajout de polices personnalisées est particulièrement utile lorsque la même famille de polices est requise dans les documents partagés et les exportations contrôlées. Cette fonctionnalité présente toutefois des limites : l'installation sur le serveur n'octroie pas les droits d'utilisation des polices, n'ajoute pas les glyphes manquants et ne garantit pas un rendu identique au pixel près dans les logiciels utilisant un jeu de polices différent. Il est recommandé de conserver le répertoire des polices personnalisées sous un système de contrôle de version ou de gestion de la configuration, de documenter la version du serveur de documents et de relancer les vérifications après chaque mise à jour.

Références officielles

Laisser un commentaire

Comment connecter les éditeurs ONLYOFFICE Desktop à un serveur ownCloud

Comment connecter les éditeurs ONLYOFFICE Desktop à un serveur ownCloud

Connectez les éditeurs de bureau ONLYOFFICE à votre serveur ownCloud, connectez-vous, ouvrez des fichiers cloud, gérez la connexion et résolvez les problèmes de configuration courants.

Comment résoudre le problème de forte utilisation du processeur dans Collabora Online (via loolwsd/coolwsd)

Comment résoudre le problème de forte utilisation du processeur dans Collabora Online (via loolwsd/coolwsd)

Résolvez les problèmes d'utilisation élevée du processeur de Collabora Online en identifiant les processus du kit occupés, en vérifiant les indicateurs et les journaux, en ajustant la concurrence et le nettoyage, et en vérifiant les correctifs en toute sécurité.

Comment personnaliser ONLYOFFICE Docs avec votre logo et vos couleurs

Comment personnaliser ONLYOFFICE Docs avec votre logo et vos couleurs

Découvrez comment personnaliser ONLYOFFICE Docs avec un logo d'en-tête et des couleurs d'interface, y compris les limites de licence, la configuration JSON du thème, les chemins Docker et les tests.

Résolution des problèmes de visibilité du texte en mode sombre dans LibreOffice Calc

Résolution des problèmes de visibilité du texte en mode sombre dans LibreOffice Calc

Corrigez les textes difficiles à lire dans LibreOffice Calc en vérifiant le thème de l'application, la police et les couleurs de remplissage des cellules, les styles et la mise en forme conditionnelle, puis vérifiez le résultat d'impression.

Résoudre l'erreur « Document verrouillé par un utilisateur inconnu » dans LibreOffice

Résoudre l'erreur « Document verrouillé par un utilisateur inconnu » dans LibreOffice

Débloquez en toute sécurité l'avertissement de verrouillage par utilisateur inconnu de LibreOffice. Vérifiez les sessions actives, protégez une copie, supprimez uniquement un verrouillage obsolète vérifié et testez le document.

Corriger le texte arabe et hébreu s'écrivant de droite à gauche dans LibreOffice Writer

Corriger le texte arabe et hébreu s'écrivant de droite à gauche dans LibreOffice Writer

Corrigez les problèmes de mise en page du texte arabe ou hébreu avec l'anglais dans LibreOffice Writer. Activez la mise en page complexe, définissez le sens des paragraphes et vérifiez le résultat.

LibreOffice Calc VLOOKUP vs XLOOKUP: A Beginner-Friendly Functions Guide

LibreOffice Calc VLOOKUP vs XLOOKUP: A Beginner-Friendly Functions Guide

Learn VLOOKUP and XLOOKUP in LibreOffice Calc, including exact matches, left lookups, not-found results, reverse search, INDEX/MATCH alternatives, and common errors.

Comment résoudre l'erreur « Échec de la validation de la preuve WOPI » dans Collabora Online

Comment résoudre l'erreur « Échec de la validation de la preuve WOPI » dans Collabora Online

Résolvez les problèmes de validation des preuves WOPI de Collabora Online en vérifiant les clés de découverte, la rotation des clés, les URL proxy, les horodatages et les listes d'autorisation des hôtes.

Comment activer le suivi des modifications par défaut dans ONLYOFFICE Docs

Comment activer le suivi des modifications par défaut dans ONLYOFFICE Docs

Activez le suivi des modifications pour tous les utilisateurs dans un document ONLYOFFICE, maintenez-le actif après la réouverture et comprenez les limites d'une option par défaut globale.

Comment configurer les délais d'inactivité pour les sessions d'édition Collabora

Comment configurer les délais d'inactivité pour les sessions d'édition Collabora

Comparez les délais d'expiration par vue, hors focus, d'inactivité des documents, de sauvegarde automatique et de proxy de Collabora Online, puis choisissez et vérifiez les paramètres pour votre déploiement.