0 — Prise en main — Manuel

Debug XML Tool est un environnement de développement local et hors-ligne pour éditer et déboguer pas-à-pas des transformations XML / XSLT / XSD / DTD.

Aucune connexion réseau n'est requise, ni au démarrage ni à l'usage. Aucune donnée ne quitte votre poste.

Ce chapitre vous amène d'un dossier de travail à une première transformation exécutée, puis à un premier point d'arrêt. Comptez deux minutes.

0.1 Ouvrir un workspace

Au premier lancement, l'application affiche son écran d'accueil : IDE de Débogage XSLT/XML, avec l'invite « Ouvrez un workspace ( 📂 ) ou glissez-déposez un dossier ici ». Le panneau de gauche indique Aucun workspace ouvert — ouvrez un dossier pour commencer.

Un workspace est simplement un dossier de votre disque : celui qui contient vos feuilles de style et vos fichiers XML.

Deux façons de l'ouvrir :

Cliquez sur Ouvrir dossier workspace (première icône de dossier de la barre d'outils), puis choisissez le dossier ;
ou glissez-déposez le dossier directement sur l'écran d'accueil.

L'explorateur de gauche se remplit. Il n'affiche que les fichiers pertinents (.xml, .xsl, .xslt, .xsd, .dtd, .xspec…), chacun avec une icône propre à son type.

Le dernier workspace ouvert est restauré automatiquement au prochain démarrage, ainsi que la taille et la position de la fenêtre.

Pour fermer le workspace courant, utilisez Fermer le workspace, l'icône voisine. Elle n'est active que lorsqu'un workspace est ouvert.

0.2 Ouvrir un fichier

Double-cliquez sur un fichier dans l'explorateur : il s'ouvre dans un onglet d'éditeur, avec coloration syntaxique et validation au fil de la frappe.

Vous pouvez ouvrir autant de fichiers que nécessaire ; chacun occupe son propre onglet. Un onglet modifié mais non enregistré porte un point « • » devant son nom. Le point disparaît dès que vous enregistrez (Ctrl+S) — ou si vous annulez toutes vos modifications.

0.3 Lancer une première transformation

Prenons un cas courant : une feuille de style main.xsl qui met en forme un catalogue input.xml.

Ouvrez votre feuille de style (main.xsl) par un double-clic. Elle devient l'onglet actif.
Appuyez sur F5 — ou cliquez sur Lancer la transformation (le bouton ▶ de la barre d'outils).

C'est tout. Vous n'avez rien eu à configurer.

Debug XML Tool détermine seul ce qu'il faut exécuter :

la feuille de style est celle de l'onglet actif ;
le document XML source, s'il n'a pas été désigné, est le premier fichier XML trouvé dans le workspace ;
le fichier de sortie est généré à côté du document source.

La console (panneau du bas, premier onglet) trace chacune de ces décisions :

[Auto-config] XML source auto-détecté : input.xml
[Auto-config] Sortie auto-générée : input_out_2026-08-02.html
--- Lancement de la transformation ---
XML : C:\...\input.xml
XSLT : C:\...\main.xsl
Sortie : C:\...\input_out_2026-08-02.html (format: AUTO)
--- Transformation terminee en 136 ms ---

Le résultat s'ouvre dans un nouvel onglet en lecture seule. Les messages xsl:message de votre feuille de style apparaissent dans la console au fil de l'exécution.

Si rien ne se lance

Le diagnostic s'affiche dans le message d'état, à droite de la barre d'outils — pas dans la console.

Message d'état	Cause	Que faire
Erreur : configurez un fichier XSLT via ⚙ ou ouvrez un .xsl dans l'éditeur	l'onglet actif n'est pas une feuille de style	ouvrez votre `.xsl`, ou désignez-le explicitement (ci-dessous)
Erreur : aucun fichier XML trouvé dans le workspace	le dossier ne contient aucun `.xml`	ouvrez un workspace qui en contient
Erreur : fichier XSLT introuvable — …	le fichier désigné a été déplacé ou supprimé	redésignez-le

Désigner explicitement les fichiers

L'auto-détection convient pour démarrer. Dès que votre workspace contient plusieurs documents XML, désignez-les vous-même : clic droit sur un fichier dans l'explorateur, puis

Définir comme XML source sur un .xml ;
Définir comme XSL principal sur un .xsl ou .xslt.

Le bouton Paramètres de transformation (⚙) offre le contrôle complet : format de sortie (Auto / HTML / Texte / XML / PDF), paramètres de la feuille de style, et point d'entrée. Voir le chapitre Transformer & exporter.

0.4 Poser un premier point d'arrêt

C'est ici que Debug XML Tool prend tout son intérêt.

Dans l'onglet de votre feuille de style, cliquez dans la marge à gauche du numéro de ligne, en face d'une instruction — par exemple un <xsl:value-of> à l'intérieur d'un <xsl:for-each>. Un point rouge apparaît.
Appuyez sur F5.

L'exécution démarre puis s'arrête sur votre ligne, qui se surligne en jaune. Le badge d'état de la barre d'outils passe à PAUSED, et les boutons de pas-à-pas s'activent.

Vous pouvez alors inspecter l'état exact de la transformation :

Panneau du bas	Ce qu'il montre
Variables	les variables XSLT locales et le nœud XML courant
Pile d'appels	la chaîne des templates qui ont mené jusqu'ici
XPath Evaluator	évaluez n'importe quelle expression dans le contexte de la pause
Watch XPath	des expressions réévaluées automatiquement à chaque arrêt

Et avancer pas à pas :

Touche	Action
F8	Reprendre — jusqu'au prochain point d'arrêt
F10	Step Over — ligne suivante, sans entrer dans les templates appelés
F11	Step Into — entrer dans le template appelé
Shift+F11	Step Out — ressortir du template courant
Shift+F9	Arrêter

Le chapitre Déboguer détaille chacun de ces gestes, les points d'arrêt conditionnels et l'inspection.

0.5 Où trouver quoi

Zone	Contenu
Barre d'outils (haut)	workspace, lancement et pas-à-pas, validation, format, comparaison, profileur, réglages
Explorateur (gauche)	arborescence du workspace ; le clic droit y ouvre l'essentiel des actions
Éditeur (centre)	vos fichiers en onglets, avec marge à points d'arrêt
Panneau bas	13 onglets : console, inspection, analyse, recherche, validation…
Panneau droit	structure du fichier actif (arbre XML, schéma XSD, ou plan de la feuille de style)

Les onglets du panneau bas sont détachables : clic droit sur un onglet → Détacher à droite pour le placer dans la colonne de droite, Rattacher en bas pour le remettre. Un seul panneau peut être détaché à la fois.

0.6 Régler l'application

Le bouton Paramètres (dernière icône de la barre d'outils) donne accès à :

Thème — Sombre ou Clair ;
Langue — français, anglais, espagnol, russe, chinois ;
Taille de police — également réglable par Ctrl + +, Ctrl + −, Ctrl + 0 ;
Retour à la ligne, Minimap, Surligner la ligne courante ;
Validation en direct, Back-mapping de la sortie, Catalogues XML…

Ces préférences sont conservées d'une session à l'autre.

Et ensuite

Déboguer — le cœur du produit : points d'arrêt, pas-à-pas, inspection.
L'interface — les cinq zones de la fenêtre, les panneaux, les réglages.
Éditer — complétion, formatage, validation, association de schéma.
Transformer & exporter — formats de sortie, paramètres, scénarios réutilisables.
Analyser — profileur, couverture des templates, back-mapping de la sortie.
Naviguer & refactorer — définitions, références, renommage, recherche et remplacement dans le workspace.
Valider & comparer — validation par lot, catalogues XML, comparaison structurelle, tests XSpec.
Référence — tous les raccourcis, boutons, menus et gestes, en tables.