8 — Référence
Ce chapitre ne raconte rien : il récapitule. Tous les raccourcis, tous les boutons, tous les menus et tous les gestes de Debug XML Tool, en tables, avec la condition qui les rend disponibles et le chapitre qui les explique.
À garder ouvert à côté de l'application le temps de prendre ses marques.
8.1 Raccourcis clavier
Globaux
Actifs quel que soit l'endroit où se trouve le focus.
| Raccourci | Action | Disponible |
|---|---|---|
| F5 | Lancer la transformation | IDLE |
| F8 | Reprendre l'exécution | PAUSED |
| F10 | Step Over | PAUSED |
| F11 | Step Into | PAUSED |
| Shift+F11 | Step Out | PAUSED |
| Ctrl+F10 | Exécuter jusqu'au curseur | PAUSED |
| Shift+F9 | Arrêter l'exécution | RUNNING ou PAUSED |
| Ctrl+S | Enregistrer le fichier actif | un onglet ouvert |
| Ctrl+N | Nouveau fichier | toujours |
| Ctrl+Shift+F | Rechercher dans les fichiers (place le curseur dans le champ) | toujours |
| Ctrl + + / Ctrl + = | Augmenter la taille de police d'un point | toujours |
| Ctrl + − | Diminuer la taille de police d'un point | toujours |
| Ctrl + 0 | Revenir à la taille de police par défaut | toujours |
Les trois raccourcis de police fonctionnent aussi bien avec le pavé numérique.
Dans l'éditeur
Actifs quand le curseur est dans le code.
| Raccourci | Action | Portée |
|---|---|---|
| F12 | Aller à la définition | .xsl / .xslt |
| Shift+F12 | Rechercher les références | .xsl / .xslt |
| F2 | Renommer le symbole | .xsl / .xslt |
| Shift+Alt+F | Formater le document | tous |
| Ctrl+Espace | Complétion — et rappel de l'historique dans le champ XPath | tous |
| Ctrl+Z | Annuler | tous |
8.2 La barre d'outils
Dans l'ordre réel d'apparition. Tous les boutons sont en icône seule : survolez pour lire le libellé ci-dessous.
| # | Bouton | Actif | Chapitre |
|---|---|---|---|
| 1 | Nouveau fichier (Ctrl+N) | toujours | Éditer §2.1 |
| 2 | Ouvrir dossier workspace | toujours | Prise en main §0.1 |
| 3 | Fermer le workspace | si un workspace est ouvert | Prise en main §0.1 |
| 4 | Scénarios de transformation | toujours | Transformer & exporter §3.7 |
| 5 | Paramètres de transformation (⚙) | toujours | Transformer & exporter §3.2 |
| 6 | Lancer la transformation (F5) | IDLE | Transformer & exporter §3.1 |
| 7 | Step Into (F11) | PAUSED | Déboguer §4.3 |
| 8 | Step Over (F10) | PAUSED | Déboguer §4.3 |
| 9 | Step Out (Shift+F11) | PAUSED | Déboguer §4.3 |
| 10 | Exécuter jusqu'au curseur (Ctrl+F10) | PAUSED | Déboguer §4.3 |
| 11 | Reprendre l'exécution (F8) | PAUSED | Déboguer §4.3 |
| 12 | Arrêter l'exécution (Shift+F9) | RUNNING ou PAUSED | Déboguer §4.5 |
| 13 | Valider le fichier actif | toujours | Valider & comparer §7.1 |
| 14 | Valider un XML contre un schéma (XSD ou DTD) | toujours — ouvre un menu ; grisé le temps d'une validation | Valider & comparer §7.2 |
| 15 | Formater le document (Shift+Alt+F) | toujours | Éditer §2.4 |
| 16 | Comparer deux fichiers (diff XML structurel) | toujours | Valider & comparer §7.5 |
| 17 | Exécuter avec le Profiler Saxon | IDLE | Analyser §5.1 |
| 18 | sélecteur de langue | toujours | L'interface §1.8 |
| 19 | Paramètres | toujours | §8.7 |
À l'extrémité droite : le badge d'état (IDLE / RUNNING / PAUSED) et le message de
statut.
Le menu du bouton schéma
| Entrée | Sous-titre | Effet |
|---|---|---|
| XSD | Valider contre un schéma XSD | ouvre Validation XSD — et mémorise l'association |
| DTD | Valider contre une DTD | ouvre Validation DTD — et mémorise l'association |
| Associer un schéma | Lier un XSD/DTD au fichier actif | lie sans valider |
8.3 Quand les commandes de débogage sont actives
L'activation des boutons vous dit à elle seule où en est l'exécution.
| Commande | IDLE | RUNNING | PAUSED |
|---|---|---|---|
| Lancer la transformation (F5) | ✅ | ⛔ | ⛔ |
| Exécuter avec le Profiler | ✅ | ⛔ | ⛔ |
| Step Into / Over / Out | ⛔ | ⛔ | ✅ |
| Exécuter jusqu'au curseur | ⛔ | ⛔ | ✅ |
| Reprendre | ⛔ | ⛔ | ✅ |
| Arrêter | ⛔ | ✅ | ✅ |
8.4 Menu contextuel de l'explorateur
Clic droit dans le panneau de gauche. Le menu s'adapte à ce que vous avez désigné.
| Entrée | Cible | Chapitre |
|---|---|---|
| Ouvrir | un fichier | Prise en main §0.2 |
| Définir comme XML source | .xml | Prise en main §0.3 |
| Définir comme XSL principal | .xsl / .xslt | Prise en main §0.3 |
| Nouveau fichier… | un dossier | Éditer §2.1 |
| Nouveau dossier… | un dossier | — |
| Supprimer | fichier ou dossier | confirmation requise |
| Valider le dossier | un dossier | Valider & comparer §7.3 |
| Valider le workspace | la zone vide | Valider & comparer §7.3 |
| Hiérarchie/dépendances | .xsl / .xslt / .xsd | Naviguer & refactorer §6.6 |
| Comparer avec… | un fichier | Valider & comparer §7.5 |
| Utiliser comme catalogue XML | .xml | Valider & comparer §7.4 |
| Exécuter les tests XSpec | .xspec | Valider & comparer §7.7 |
| Générer un squelette XSpec | .xsl / .xslt | Valider & comparer §7.7 |
La suppression demande confirmation — « Supprimer définitivement « … » ? Cette action est irréversible. » — et porte réellement sur le disque.
8.5 Menu contextuel de l'éditeur
Clic droit dans le code.
| Entrée | Raccourci | Portée | Chapitre |
|---|---|---|---|
| Aller à la définition | F12 | .xsl | Naviguer & refactorer §6.1 |
| Rechercher les références | Shift+F12 | .xsl | Naviguer & refactorer §6.2 |
| Renommer le symbole | F2 | .xsl | Naviguer & refactorer §6.3 |
| Voir la sortie générée | — | .xsl, après une transformation back-mappée | Analyser §5.6 |
S'y ajoutent les entrées standard de l'éditeur : couper, copier, coller, formater, palette de commandes.
8.6 Gestes souris
| Geste | Effet | Où |
|---|---|---|
| Double-clic sur un fichier | l'ouvre dans un onglet | explorateur |
| Glisser-déposer d'un dossier | l'ouvre comme workspace | écran d'accueil |
| Clic dans la marge | pose ou retire un point d'arrêt | éditeur, .xsl |
| Ctrl + clic sur un symbole | va à sa définition | éditeur, .xsl |
| Ctrl + clic dans une sortie | surligne l'instruction XSLT qui l'a produite, et le nœud source | onglet de sortie |
| Simple clic sur une ligne de panneau | ouvre le fichier et sélectionne la ligne | Recherche, Références, Problèmes, XSpec, Watch XPath (valeur de type nœud) |
| Double-clic sur une ligne de panneau | ouvre le fichier et surligne la ligne | Pile d'appels, XPath, Profileur, Templates, Hiérarchie, Comparaison, plan STRUCTURE XSL |
Le geste de navigation n'est pas le même partout, et ce n'est pas un oubli : les panneaux de recherche et de diagnostic naviguent au simple clic, comme un « Rechercher dans les fichiers » classique, parce qu'on y parcourt une liste de résultats. Les panneaux d'inspection demandent un double-clic, parce qu'on y sélectionne d'abord pour lire.
8.7 Menu Paramètres
| Section | Réglage | Valeurs |
|---|---|---|
| Apparence | Thème | Sombre / Clair |
| Apparence | Langue | français, anglais, espagnol, russe, chinois |
| Apparence | Taille de police | valeur numérique — aussi Ctrl + + / Ctrl + − / Ctrl + 0 |
| Éditeur | Retour à la ligne | bascule |
| Éditeur | Minimap | bascule |
| Éditeur | Surligner la ligne courante | bascule |
| Préférences | Validation en direct | bascule — Éditer §2.5 |
| Préférences | Back-mapping de la sortie | bascule — Analyser §5.7 |
| Préférences | Catalogues XML… | ouvre un dialogue — Valider & comparer §7.4 |
Le changement de thème et de langue est immédiat, sans redémarrage.
8.8 Les onglets du panneau bas
Treize onglets, en icône seule. Chacun peut être détaché à droite par un clic droit sur son en-tête, et rattaché en bas de la même façon — un seul détaché à la fois.
| Onglet | Ce qu'il montre | Ce qui le remplit | Chapitre |
|---|---|---|---|
| Console | messages, trace, erreurs | toute action | L'interface §1.7 |
| Variables | variables XSLT et nœud courant | une pause du débogueur | Déboguer §4.4 |
| XPath Evaluator | évaluation d'expressions | saisie, à la pause ou non | Déboguer §4.4 |
| Pile d'appels | chaîne des templates | une pause du débogueur | Déboguer §4.4 |
| Watch XPath | expressions réévaluées à chaque arrêt | vos expressions surveillées | Déboguer §4.4 |
| Profileur | temps par template, points chauds, arbre d'appels | le bouton ⏱ | Analyser §5.1 |
| Templates | templates déclenchés ou non | une exécution profilée | Analyser §5.4 |
| Recherche | résultats dans tout le workspace | Ctrl+Shift+F | Naviguer & refactorer §6.4 |
| Références | usages d'un symbole | Shift+F12 | Naviguer & refactorer §6.2 |
| Hiérarchie | graphe des includes / imports | menu Hiérarchie/dépendances | Naviguer & refactorer §6.6 |
| Problèmes | fichiers en erreur d'un lot | Valider le dossier / le workspace | Valider & comparer §7.3 |
| Comparaison | différences entre deux fichiers | le bouton Comparer | Valider & comparer §7.5 |
| XSpec | résultats des tests unitaires | Exécuter les tests XSpec | Valider & comparer §7.7 |
Un panneau vide indique toujours ce qui le remplira — Lancez le profileur (⏱) pour analyser les performances, Clic droit sur un dossier de l'explorateur pour le valider, Aucune variable — le débogueur n'est pas en pause.
8.9 Où s'affiche quoi
Trois zones reçoivent des messages, et la distinction est constante :
| Zone | Reçoit | Exemple |
|---|---|---|
| Message d'état (barre d'outils) | les diagnostics de configuration et le résumé de la dernière action | Erreur : aucun fichier XML trouvé dans le workspace |
| Console (panneau bas) | ce que fait le moteur : trace d'exécution, xsl:message, validations, catalogues | --- Transformation terminee en 136 ms --- |
| Éditeur (soulignements) | les erreurs imputables au fichier affiché | une balise non fermée |
Si un lancement ne produit rien, regardez le message d'état avant la console : c'est là que vont les erreurs de configuration.
Une erreur qui vient d'un autre fichier — un schéma associé cassé, un module xsl:include
fautif — ne souille pas votre document : elle part en console, préfixée [Validation] Diagnostic externe.
8.10 Messages d'état les plus fréquents
| Message | Cause | Que faire |
|---|---|---|
| Aucun workspace ouvert | aucun dossier de travail | Ouvrir dossier workspace |
| Erreur : configurez un fichier XSLT via ⚙ ou ouvrez un .xsl dans l'éditeur | l'onglet actif n'est pas une feuille de style | ouvrez le .xsl ou désignez-le par clic droit |
| Erreur : aucun fichier XML trouvé dans le workspace | pas de .xml dans le dossier | ouvrez un workspace qui en contient |
| Erreur : fichier XSLT introuvable — … | le fichier désigné a été déplacé | redésignez-le |
| Ouvrez un fichier XML pour l'associer à un schéma | l'onglet actif n'est pas un .xml | activez l'onglet du document |
| Aucun schéma disponible | ni XSD ni DTD dans le workspace | ajoutez le schéma au dossier |
| Validation XSD échouée : 3 problème(s) | le document ne respecte pas son schéma | les erreurs sont soulignées dans le document |
| Erreur : un nom de mode est requis pour le mode initial. | point d'entrée « Mode initial » sans nom | saisissez le mode, ou revenez au document source |
8.11 Types de fichiers
| Extension | Édition | Assistance |
|---|---|---|
.xml | ✅ | complétion pilotée par le schéma, validation, structure, comparaison |
.xsl / .xslt | ✅ | complétion XSLT, débogage, profilage, navigation, renommage, plan |
.xsd | ✅ | validation, structure, hiérarchie |
.dtd | ✅ | validation |
.xspec | ✅ | exécution des tests |
| autre | ✅ | coloration syntaxique déduite du nom, sans assistance dédiée |
Ni JSON, ni XQuery, ni édition graphique de type Author/WYSIWYG.
8.12 Limites, récapitulatif
Rassemblées ici pour référence ; chacune est expliquée à sa place.
Moteur
- Transformation par Saxon-HE : pas de transformation schema-aware, pas de streaming.
- La validation XSD suit la norme W3C XML Schema 1.0.
Débogage et analyse
- Le surlignage « aller à la source » porte sur la ligne entière, pas sur une plage de colonnes.
- La couverture des templates est relative au document d'entrée : un template non déclenché sur ce XML n'est pas du code mort absolu, et un template inliné par l'optimiseur peut apparaître non déclenché.
- Le back-mapping est indisponible sur l'export PDF.
Navigation et refactoring
- Navigation par symboles et renommage : onglets
.xsl/.xsltseulement, et jamais les templatesmatch— leur résolution est l'affaire du débogueur. - Renommage et remplacement ne sont annulables que dans les onglets ouverts.
- La recherche ignore les fichiers de plus de 2 Mo et tronque au-delà de 5 000 résultats.
Validation et comparaison
- La validation par lot reflète le disque, ignore les fichiers de plus de 2 Mo, plafonne à
10 000 problèmes, et valide les modules
xsl:includeisolément (faux positifs possibles). - La comparaison tient l'ordre des éléments pour significatif, se replie en mode textuel au-delà de 10 Mo, plafonne à 5 000 différences, et ne fait ni diff de dossiers ni fusion.
- Les catalogues ne résolvent que vers des fichiers locaux.
- Un scénario XSpec ne se débogue pas encore pas-à-pas.
8.13 Ce que l'application retient
D'une session à l'autre, sans rien vous demander :
| Retenu | Portée |
|---|---|
| Le dernier workspace ouvert | application |
| La taille et la position de la fenêtre | application |
| Thème, langue, taille de police | application |
| Validation en direct, back-mapping | application |
| Vos scénarios de transformation | workspace |
| Vos expressions de surveillance (Watch XPath) | workspace |
| Les associations fichier XML ↔ schéma | workspace |
| Les catalogues XML déclarés | workspace |
Deux workspaces différents ont donc leurs propres scénarios, leurs propres watches et leurs propres catalogues — sans interférence.
Et ensuite
Vous avez fait le tour. Pour revenir sur un point :
- Prise en main — du dossier vide au premier point d'arrêt.
- L'interface — les cinq zones de la fenêtre.
- Éditer — complétion, formatage, validation au fil de la frappe.
- Transformer & exporter — formats, paramètres, scénarios.
- Déboguer — points d'arrêt, pas-à-pas, inspection.
- Analyser — profileur, couverture, back-mapping.
- Naviguer & refactorer — définitions, références, renommage.
- Valider & comparer — lot, catalogues, comparaison, XSpec.