Guide d'installation

Date : 7 juin 2024

Actualisation : 31 janvier 2025

Guide d’installation des outils de la chaîne d’édition structurée Métopes version 3.1.x.

Les ressources disponibles sans restriction d'accès ainsi que la documentation sont hébergées à l’adresse suivante : https://www.metopes.fr/tools/current/ :

• Modèle de stylage pour MS Word : https://www.metopes.fr/tools/current/MSWord_template.zip ;

• Environnements TEI pour XMLMind XMLEditor 9.5.1. Professional Edition (installation décrite infra) ;

• Scripts d’import pour Adobe InDesign :

  • Windows : https://www.metopes.fr/tools/current/packager_windows.zip ;

  • Mac os : https://www.metopes.fr/tools/current/packager_macos.zip.

1. Prérequis logiciels

1.1. Systèmes

• Windows : Windows 7, Windows 10, Windows 11 ;

• Mac OS : Mac OS 10.15 (Catalina), 11 (Big Sur), 12 (Monterey), 13 (Ventura), 14 (Sonoma), 15 (Sequoia).

1.2. Logiciels requis

• Microsoft Word

  • Windows : 2013, 2016, 2019, 2021 ;

  • Mac OS : 2016, 2019, 2021.

• LibreOffice, version 7.4.7.2 (recommandée) stable.

• Adobe InDesign®, versions CS4 (6.0) à CC 2024 Max (19.x).

1.3. Logiciel distribué : XMLmind XML Editor Professional Edition 9.5.1

Cette version 9.5.1 propose un addon pour le traitement de textes bidirectionnels (right-to-left) et embarque des addons complémentaires mobilisables dans certains contextes de production (Apache FOP pour la production de PDF d’épreuvages, MathML support pour l’édition d’équations, JEuclid image toolkit pour la génération d’images à partir de formules mathématiques...).

1.4. Logiciels additionnels

• Java JRE (nécessaire pour l’import InDesign). Pour tester votre version : https://www.java.com/fr/download/ ;

• .NET Framework (Windows, nécessaire pour l’import InDesign) ;

• Calibre et/ou Sigil pour l’édition d’epub.

1.5. Polices recommandées

Des polices Unicode doivent impérativement être utilisées pour l’encodage et le stylage des fichiers (format d’entrée) et la production de tous les formats (exports) de la chaîne éditoriale.

2. Modèle de stylage Microsoft Word

Le modèle de stylage Commons-Publishing-Metopes.dotm est unique pour les systèmes Mac OS et Windows et indépendant de la langue du système sur lequel il est utilisé.

2.1. Compatibilités

• Windows : 2013 ;

• Windows & Mac OS : 2016, 2019, 2021.

2.2. Emplacement et liaison du modèle aux unités éditoriales

Le modèle peut être placé dans la bibliothèque utilisateur pour une utilisation en tant que modèle global ou dans tout autre dossier pour une liaison à chaque document.

Modèle global

Configurer le modèle en tant que modèle global permet de le conserver en mémoire et de le mobiliser sans avoir à le lier à chaque document (il conviendra toujours d'autoriser l'activation des macros).

Deux conditions à cela :

• le nom du modèle doit toujours être préfixé par la chaîne Commons ;

• placer le modèle dans la librairie utilisateur.

Les chemins d'accès aux emplacements des modèles (par défaut) sont :

• Windows : C:\Users\nom_utilisateur\AppData\Roaming\Microsoft\Templates ;

• Mac OS : ~/Library/Group Containers/UBF8T346G9.Office/User Content/Templates.

Modèle lié au document

Le modèle peut aussi être lié à chaque document, en suivant la méthode pré-existante : onglet Développeur > Compléments Word : Joindre…

N.B. : un modèle lié au document est prioritaire sur le modèle global.

2.3. Personnalisation

Peuvent être modifiés :

• la mise en forme des styles (un modèle par collection, revue...) ;

  Le modèle de stylage MS Word fait appel à la police Calibri Light.

• le nom du modèle, à condition de conserver le préfixe Commons ;

Ne peuvent être modifiés :

• les noms de styles ;

• les niveaux hiérarchiques associés aux styles de titres.

2.4. Macros

Le modèle embarque des macros qu’il convient d'autoriser d'activer lors de l’opération de liaison au document.

2.5. Configuration de l'environnement

La configuration de l'environnement est désormais déléguée à la commande "Config. env." qui permet :

• d'activer l'utilisation du modèle de stylage (quelque soit sa méthode de liaison — cf supra) ;

• de configurer votre environnement de travail (passage en mode brouillon, affichage des caractères masqués, des notes…) ;

• d'établir les propriétés du document (techniquement et éditorialement nécessaires à la conversion du document) ;

• de renseigner la langue et le type du document.

3. Libre Office

LibreOffice est utilisé comme plateforme de conversion et doit être installé sur le poste utilisateur ; le logiciel est activé en tâche de fond et sans interface graphique pour opérer la conversion des fichiers stylés en fichiers XML-TEI.

La version requise pour Métopes 3.1 est la version 7.4.7.2. disponible à partir du lien suivant : https://downloadarchive.documentfoundation.org/libreoffice/old/7.4.7.2/.

3.1. Prérequis logiciels et téléchargement

• Prérequis logiciels et matériels : https://fr.libreoffice.org/get-help/system-requirements/

• Téléchargement : https://downloadarchive.documentfoundation.org/libreoffice/old/7.4.7.2/

3.2. Installation

Suivre les procédures d’installation sur le site du développeur officiel : https://fr.libreoffice.org/get-help/install-howto/

4. Éditeur XMLMind XMLEditor Profesionnal Edition 9.5.1.

4.1. Installation logicielle

Suivre les procédures d’installation sur le site du développeur : http://www.xmlmind.com/xmleditor/_distrib/doc/help/installing_xxe.html

4.2. Préférences générales

Renseigner d'abord les préférences afin de pouvoir procéder à l'installation des environnnements Métopes.

1. Save Objectif : renseigner les paramètres pour supprimer l’indentation et garantir la conservation des retours à la ligne correspondant aux paragraphes dans InDesign.

   • Décocher

     • Indent

     • (facultatif) Before saving, make a backup copy of the file

       Évite la création de fichiers de sauvegarde (suffixés d'un ~).

2. Install add-ons Objectif : paramétrage du lien vers le serveur de dépôt des addons Métopes et téléchargement de ces derniers.

   • Cliquer sur Add ;

   • Saisir l'URL suivante : https://www.metopes.fr/tools/current/metopes.xxe_addon ;

   • Valider via OK.

3. Advanced > Cached Data Objectif : le logiciel ne conserve aucune donnée en cache et démarre chaque fois en analysant les environnements disponibles.

   • Décocher les 3 options ;

     • Quick Start cache

     • Document cache

     • Schema cache

4. Tools > Helper applications

   Objectif : permettre l’ouverture automatique des applications dédiées lors de la production de fichiers HTML5 et PDF

   • Copier la ligne disponible dans le champ Defaut viewer de la partie inférieure de la fenêtre (ex. Mac OS : open "%U" ; Windows : start "" "%U") ;

   • Cliquer sur Add pour accéder à l'édition des champs suivants et lier un navigateur :

     • Description: saisir browser

     • MIME type: saisir text/html text/xhtml

     • Helper Application: coller la séquence open "%U" pour Mac OS ou start "" "%U" pour Windows pour mobiliser le navigateur renseigné par défaut dans la configuration de votre poste informatique ou naviguer pour atteindre le navigateur de votre choix.

   • Renouveler la procédure pour renseigner une application d’ouverture automatique des PDF :

     • Description: saisir PDF

     • MIME type: saisir application/pdf

     • Helper Application: coller la séquence open "%U" pour Mac OS ou start "" "%U" pour Windows pour mobiliser le programme renseigné par défaut dans la configuration de votre poste informatique ou naviguer pour atteindre le lecteur de PDF de votre choix.

* Mise à jour logicielle

Objectif : désactiver la recherche des mises à jour du logiciel XMLmind proposées par le développeur et indépendantes des mises à jour des environnements Métopes.

Fermer la fenêtre d'édition des préférences et accéder au menu "Aide" > "Vérifier l’existence de mises à jour". En bas de la fenêtre, décocher l’option « Vérifier automatiquement l’existence de mises à jour » pour ne plus être informé des mises à jour logicielles, indépendantes des outils Métopes.

4.3. Installation des environnements

Installer les environnements/addons

• À partir du menu "Options" > "Install Add-ons…" ;

• Sélectionner :

  • [Configuration] Métopes TEI (3.1.x) [metopes_tei]

    environnement TEI-Métopes principal (schéma TEI, vues CSS d’affichage, barres d’outils, commandes de l'environnement, commandes d’export, note de version, licence)

  • [Configuration] Métopes TEI - PDN Tools (2.1.0) [pdn_tools] (© PDN-Certic)

    ensemble d’utilitaires Java nécessaires au fonctionnement des outils Métopes

  • [Translation] French (français) translation [ fr_translation ]

    traduction française de l’interface du logiciel

• Les environnements sont téléchargés et installés.

• Redémarrer l'application pour que la mise à jour soit effective.

Environnements complémentaires

• Pour la gestion des écritures right-to-left [Other category] Bidi Support : http://www.xmlmind.com/xmleditor/_distrib/doc/bidi/index.html.

• Pour la production automatisée de PDF [XSL-FO processor plug-in] : http://www.xmlmind.com/xmleditor/addons_doc.html#foProcessorPlugin.

• Pour la production d'images d'équations (JEuclid) [Toolkit Image plugin] : http://www.xmlmind.com/xmleditor/addons_doc.html#imageToolkitPlugin.

4.4. Préférences liées aux environnements Métopes

5. Import docx

   Objectif : LibreOffice est utilisé comme plateforme de conversion des fichiers stylés en XML-

   TEI. L’application est activée (sans interface graphique) à chaque transformation.

   • Cliquer sur les points de suspension pour indiquer le chemin vers l’application LibreOffice.

     • Windows : naviguer dans le programme jusqu’à soffice.exe.

       Syntaxe type obtenue : C:\Program Files\LibreOffice <x>\program\soffice.exe

     • Mac OS : atteindre l'application Libre Office.

       Syntaxe type obtenue : /Applications/LibreOffice.app

    

6. FOP (facultatif)

   Objectif : paramétrer l'appel à la police Calibri Light pour laquelle l'épreuvage est optimisé.

   Tip
   

   Cela requiert :

   • que la police soit installée sur votre poste et disponible pour la session utilisateur à partir de laquelle vous travaillez ;

   • le paramétrage des préférences de l’éditeur XML pour mobiliser la bonne déclinaison (Light) de la police.

   N.B. : L’absence de ce paramétrage n’empêche pas la génération du PDF mais altère sa qualité de composition.

• Cliquer sur Ajouter ;

• Définir :

  • la police Calibri Light comme étant la police pour le texte courant normal ;

  • la déclinaison italique de la police Calibri Light comme étant la police pour le texte en italique ;

  • la police Calibri comme étant la déclinaison pour le texte en gras ;

  • la déclinaison italique de la police Calibri comme étant la police pour le texte en gras italique ;

Documentation complémentaire exhaustive : http://www.xmlmind.com/xmleditor/_distrib/doc/help/addonOptions.html#fopOptions.

5. Scripts d'import Adobe InDesign

5.1. Installation par le packager

Le packager déploie les scripts d’import pour InDesign.

• Double-cliquer sur packager_metopes.jar (Windows) ou packager_metopes.app (Mac OS) ;

• Renseigner le chemin d’accès vers le logiciel Adobe InDesign en naviguant sur votre poste à partir de l’icône ;

  Si plusieurs versions d’InDesign sont installées, choisir la ou les versions candidates à l’installation. Si un dossier logs apparaît, penser à le décocher.

• Cliquer sur Installer.

5.2. Configuration manuelle

Windows

• Copier le dossier metopes à partir du dossier du packager packager_metopes\resources ;

• Vers le dossier C:\Users\<user>\AppData\Roaming\Adobe InDesign\Version<x.x>\lang\Scripts\Scripts Panel

  Faire apparaître ce dossier via InDesign :

  • Fenêtre > Utilitaires > Scripts ;

  • clic-droit sur le dossier Utilisateur ;

  • Explorateur de fichiers.

Mac OS

• Afficher le contenu du packager : clic-droit > Afficher le contenu du paquet ;

• Copier le dossier packager_metopes.app/Contents/Java/resources/metopes

• Vers le dossier /Users/<user>/Library/Preferences/Adobe InDesign/Version<x.x>/lang/Scripts /Scripts Panel

  Faire apparaître ce dossier via InDesign :

  • Fenêtre > Utilitaires > Scripts ;

  • clic-droit sur le dossier Utilisateur ;

  • Faire apparaîte dans le Finder.

6. Annexes

6.1. Problèmes d’installation

[import .docx] Chemin d’installation erroné

Vérifier le chemin vers Libre Office, voir section "4.4. Préférences liées aux environnements Métopes".

[import .docx] Échec de la transformation

Vérifier :

• que le nom des dossiers des addons ne contient pas le suffixe "-2", si oui, le supprimer dans les répertoires :

  • Windows : C:\Users\<user>\AppData\Roaming\XMLmind\XMLEditor9\addon

  • Mac OS : /Users/<user>/Library/Application Support/XMLmind/XMLEditor9/addon

• que le fichier ne contient pas d'image insérée sans être liée.

[XMLmind : Mac OS] Accès aux dossiers impossible

Le système de sécurité de l'OS empêche l’application XMLmind d’accéder à certains dossiers (parmis lesquels les dossiers Documents, Bureau, Téléchargements) du poste utilisateur.

Suivre les instructions données par le développeur de l’application dans la rubrique « Workaround #2 » de la page suivante pour résoudre le problème : https://www.xmlmind.com/xmleditor/known_problems.html#problems_on_mac.

[XMLmind] Disparition de la vue stylée

Si la vue centrale n’apparaît pas et que le contenu du fichier XML est affiché sans vue CSS, il faut rétablir manuellement la vue appropriéeà partir du menu "Vue" .

[InDesign : Windows] Fichier uiPalette.xml introuvable

Message d'erreur :

Fichier C:\Users\<user>\AppData\Roaming\Adobe\InDesign\Version <x.x>\<lang>\Scripts\Scripts Panel\metopes\uiPalette.xml introuvable.

Lors du premier déclenchement du script sur le poste, le script génère un fichier ressource pour construire la palette d'options d'import. Cette ressource n'est pas encore disponible lors du premier import.

Résolution : fermer la fenêtre et déclencher de nouveau le script.

[InDesign : Mac OS] Erreur d’exécution de la transformation (absence de JRE)

Le problème peut être causé par l’absence de JDK (intégrant le JRE : Java Runtime Environment). L’installation d’un JDK apporte une solution au problème.

[Windows 10 – import InDesign] – .NET Framework

L’import InDesign nécessite l’installation de .Net Framework. En cas de défaut d’installation sur le poste, un message proposant l’installation apparaît, suivre alors les instructions d’installation.

6.2. Contacts

assistance-metopes@unicaen.fr