16 Extensions
16.2 Extension XML Editor
L’extension XML Editor ajoute un éditeur de fichiers XML à TXM67.
Cet éditeur se lance actuellement sur un fichier pré-existant sur le disque dur, avec la commande « Fichier / Open XML File... ».
À l’ouverture, le fichier est présenté en mode « Design » ou tabulé, comme dans la figure 16.2.
Illustration 16.1: édition du fichier source "tdm80j.xml" en mode Design
En cliquant sur l’onglet « Source » on bascule dans le mode syntaxique XML comme dans la figure 16.2.
Illustration 16.2: édition du fichier source "tdm80j.xml" en mode syntaxique XML
16.2.1 Services du mode syntaxique XML
16.2.1.1 Repérage au sein de la syntaxe XML
Les différents éléments XML sont présentés avec leur propre couleur : nom des balises, nom d'attributs, valeurs d'attributs, contenu textuel, commentaires, etc.) pour faciliter le repérage ainsi que la détection d’erreurs de syntaxe (par exemple un commentaire XML mal fermé « <!--- … --> » provoquera une colorisation particulière d'une large portion du fichier XML). La colorisation est paramétrable dans les préférences de TXM, voir plus bas.
L’enchâssement courant du curseur au sein de la hiérarchie des balises est indiqué par un chemin de fer situé en bas à gauche de la fenêtre d’édition.
Des boutons de fermeture/ouverture (⊖/⊕) situés en début de ligne de chaque balise ouvrante permettent de réduire temporairement tout le contenu de certains éléments XML.
16.2.1.2 Saisie assistée d’éléments XML
En fonction du schéma ou de la DTD éventuelle du fichier, de la position du curseur et de ce qui vient d'être saisi, l’éditeur propose automatiquement de compléter la saisie.
Par exemple :
-
l’ajout de la balise fermante après la saisie d’une balise ouvrante ;
-
l’ajout du guillemet fermant une valeur d’attribut ;
-
la complétion du nom d'une balise fermante ;
-
etc.
Le copier/coller d'éléments XML est accéléré par un double-clic adapté :
-
1 double-clic = sélection de la totalité d'une valeur d'attribut ;
-
2 double-clics = sélection du nom de l’attribut et de sa valeur ;
-
3 double-clics = sélection de l'ensemble de la balise.
L’éditeur gère un jeu de patrons récurrents de balises à insérer rapidement.
16.2.1.3 Formatage automatique
L’éditeur peut :
-
indenter automatiquement les balises de l'ensemble du document ou seule une portion sélectionnée → commande « Source > Format » du menu contextuel ;
-
« nettoyer le document » pour une correction automatique de la syntaxe XML → commande « Source > Cleanup Document... » du menu contextuel.
16.2.1.4 Validation de la syntaxe
Commande « Validate » du menu contextuel (à décrire).
16.2.2 Gestion des déclarations XML
16.2.2.1 Association d'une DTD à un fichier XML
Il est possible, mais pas nécessaire, d'associer une DTD au fichier en cours d'édition.
Dans un fichier XML, la déclaration suivante :
<!DOCTYPE balise-racine PUBLIC "IdDoc" "C:\mesdtd\Doc.dtd">
associera la DTD d'identifiant public « IdDoc » au fichier.
Le chemin d'accès au fichier de DTD est obtenu par le biais du catalogue XML s'il définit l'identifiant « IdDoc » ou directement à partir de la déclaration du chemin d'accès « C:\mesdtd\Doc.dtd ».
On peut également réaliser l'association avec la déclaration suivante :
<!DOCTYPE balise-racine SYSTEM "IdDoc.dtd">
associant la DTD d'identifiant système « IdDoc.dtd » au fichier. L'identifiant système « IdDoc.dtd » doit alors être déclaré dans le catalogue XML.
16.2.2.2 Association d'un schéma à un fichier XML
Dans un fichier XML, la déclaration suivante :
<document
xmlns="http://txm.org"
xsi:schemaLocation="http://textometrie.org C:\messchemas\document.xsd">
<corps>
...
indiquera le chemin d'accès au fichier de schéma XML directement au processeur XML par le biais de l'attribut xsi:schemaLocation.
On peut également réaliser l'association avec la déclaration suivante :
<document
xmlns="http://txm.org"
xsi:schemaLocation="http://textometrie.org document.xsd">
<corps>
...
associant le schéma d'identifiant système « document.xsd » au fichier. L'identifiant système « document.xsd » doit alors être déclaré dans le catalogue XML.
16.2.2.3 Accès distant aux DTD et schéma XML
Dans le cas d'une déclaration distante comme :
<!DOCTYPE balise-racine PUBLIC "IdDoc" "http://textometrie.org/xml/catalog/dtd/Doc.dtd">
Si vous êtes connecté à Internet par le biais d'un pare-feu et que vous ne pouvez pas établir votre configuration SOCKS, vous devez télécharger les fichiers vous-même et les installer sur votre machine, puis utiliser des déclarations locales.
16.2.2.4 Resynchronisation de l'éditeur XML après une mise à jour du catalogue XML
Après avoir édité des entrées dans le catalogue XML, vous pouvez avoir à resynchroniser l'éditeur XML avec la nouvelle version du catalogue en utilisant le bouton « Reload Dependencies » de la barre d'outils.
16.2.3 Paramétrage de la colorisation des balises XML
Il est possible de régler le style d'affichage des différents types d'éléments XML par le biais des préférences « XML > XML Files > Editor > Syntax coloring ». Pour chaque type d'élément, il est possible de choisir sa couleur d'affichage, celle de son arrière plan ainsi que sa mise en gras éventuelle. Pour rétablir le style par défaut d'un type d'élément, on peut le sélectionner dans le champ « Syntax Element » et cliquer sur « Restorer [au style par] défaut ».
67 il s’agit d’une version augmentée de l’éditeur de texte intégré (voir section Éditer un fichier texte page 1), avec des services liés à la syntaxe XML.