1 — L'interface

Debug XML Tool tient dans une seule fenêtre, organisée en cinq zones fixes. Ce chapitre les décrit une à une : ce qu'elles contiennent, ce qui les fait apparaître, et comment les réarranger.

Aucune de ces zones ne s'ouvre par un menu : elles réagissent à ce que vous faites.

1.1 Les cinq zones

┌──────────────────────────────────────────────────────────────────────┐
│  Barre d'outils                              ⚙   [IDLE]  message     │
├───────────────┬──────────────────────────────────┬───────────────────┤
│               │                                  │                   │
│  Explorateur  │            Éditeur               │    Structure      │
│               │        (onglets de fichiers)     │  (fichier actif)  │
│               │                                  │                   │
├───────────────┴──────────────────────────────────┴───────────────────┤
│  Panneau bas — 13 onglets (console, inspection, analyse, validation)  │
└──────────────────────────────────────────────────────────────────────┘

Tant qu'aucun workspace n'est ouvert, la zone centrale affiche l'écran d'accueil : IDE de Débogage XSLT/XML, l'invite « Ouvrez un workspace ( 📂 ) ou glissez-déposez un dossier ici », et un rappel des principaux raccourcis.

1.2 La barre d'outils

Tous les boutons sont en icône seule : survolez-en un pour lire son rôle et son raccourci. Ils se lisent de gauche à droite en quatre groupes.

Workspace et fichiers

Transformation et débogage

Les six commandes de débogage sont grisées hors pause. C'est volontaire : leur activation vous dit à elle seule où en est l'exécution.

Outils

État — à droite de la barre

Deux informations, côte à côte, à l'extrémité droite :

• le badge d'état — IDLE, RUNNING ou PAUSED ;
• un message de statut, qui reprend la dernière action significative : Aucun workspace ouvert, XML source défini : input.xml, Terminé en 136 ms, ou un message d'erreur.

C'est là que s'affichent les diagnostics de configuration — pas dans la console. Si un lancement ne produit rien, regardez d'abord ce message.

Le sélecteur de langue et le bouton Paramètres occupent la fin de la barre (§1.8).

1.3 L'explorateur

L'explorateur affiche l'arborescence de votre workspace, filtrée : seuls apparaissent les fichiers qui concernent l'outil (.xml, .xsl, .xslt, .xsd, .dtd, .xspec…), chacun avec une icône propre à son type. Vos images, vos scripts et vos dossiers cachés ne l'encombrent pas.

• Double-clic sur un fichier : il s'ouvre dans un onglet.
• Clic droit : le menu contextuel, qui concentre l'essentiel des actions par fichier.

Le menu s'adapte à ce que vous avez désigné :

La suppression demande confirmation — « Supprimer définitivement « … » ? Cette action est irréversible. » — et porte réellement sur le disque.

Tant qu'aucun workspace n'est ouvert, l'explorateur affiche Aucun workspace ouvert — ouvrez un dossier pour commencer.

1.4 L'éditeur

Chaque fichier ouvert occupe un onglet. L'onglet actif détermine beaucoup de choses : le contenu du panneau de structure, la cible du bouton Valider, du bouton Formater, et — à défaut de configuration explicite — la feuille de style que lance F5.

Trois éléments à repérer :

• la marge (à gauche des numéros de ligne) reçoit vos points d'arrêt d'un simple clic ;
• le point « • » devant le nom d'un onglet signale des modifications non enregistrées. Il disparaît à l'enregistrement — et aussi si vous annulez toutes vos modifications : il reflète l'écart réel avec le fichier sur disque, pas le fait d'avoir tapé ;
• les soulignements ondulés signalent les erreurs détectées au fil de la frappe (chapitre Éditer).

1.5 Le panneau de structure

Le panneau de droite affiche l'arbre logique du fichier actif. Son contenu dépend du type de fichier, et il bascule automatiquement quand vous changez d'onglet :

Le plan d'une feuille de style est groupé par catégorie, avec le décompte de chacune : Templates match, Templates nommés, Fonctions, Variables / params, Clés, Modules. Les templates match affichent leur motif, leur mode et leur priorité.

Double-cliquez sur une entrée : le nom correspondant est sélectionné dans l'éditeur.

Deux comportements à connaître :

• le plan d'une feuille de style suit vos modifications en direct, sans enregistrer — ajoutez un template, il apparaît dans la seconde ;
• les vues STRUCTURE XML et STRUCTURE XSD sont construites à l'ouverture du fichier ou au changement d'onglet : basculez d'onglet et revenez pour les reconstruire ;
• un fichier mal formé donne XML mal formé — structure indisponible. Une feuille de style sans déclaration de premier niveau donne Aucune déclaration de premier niveau.

Le ✕ de l'en-tête masque le panneau ; il réapparaît au fichier suivant.

Seules les variables et paramètres globaux figurent au plan. Les variables locales à un template en sont volontairement absentes.

1.6 Le panneau bas

Treize onglets, en icône seule : survolez pour lire leur nom.

Un panneau vide vous dit toujours ce qui le remplira plutôt que de rester muet : 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.

Détacher un panneau

Le panneau bas est large mais peu haut — ce qui convient à une console, moins à un arbre d'appels. Tout onglet peut être déplacé dans la colonne de droite, où il gagne en hauteur :

1. Clic droit sur l'onglet ;
2. Détacher à droite.

Le panneau détaché prend un en-tête à son nom et un bouton de retour. Rattacher en bas le remet à sa place.

Un seul panneau peut être détaché à la fois. Si vous en détachez un second, le premier retourne automatiquement en bas et un message furtif vous l'annonce — « … a été rattaché en bas automatiquement ». Rien n'est perdu, rien ne se superpose.

1.7 La console

Premier onglet du panneau bas, sous l'en-tête LOCAL. Elle reçoit :

• les messages xsl:message de vos feuilles de style, au fil de l'exécution ;
• la trace de chaque transformation : fichiers utilisés, format, durée ;
• les décisions d'auto-configuration, préfixées [Auto-config] ;
• les erreurs, préfixées [ERREUR].

Deux boutons dans sa barre : Effacer la console et Copier tout. Un troisième la réduit ou l'agrandit pour libérer de la place à l'éditeur.

Le clic droit dans la console propose Copier (la sélection), Sélectionner tout et Effacer.

La console trace ce que fait le moteur. Les erreurs de configuration — pas de XSLT désigné, aucun XML dans le workspace — s'affichent, elles, dans le message d'état de la barre d'outils (§1.2).

1.8 Adapter l'interface

Le bouton Paramètres (dernière icône de la barre d'outils) ouvre un menu en trois sections.

Le changement de langue et de thème est instantané et bidirectionnel : toute l'interface suit, y compris les textes des panneaux vides et l'éditeur.

1.9 Ce que l'application retient

D'une session à l'autre, sans rien vous demander :

Deux workspaces différents ont donc leurs propres scénarios, leurs propres watches et leurs propres catalogues — sans interférence.

Et ensuite

• É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 des templates, back-mapping.
• Naviguer & refactorer — définitions, références, renommage, recherche dans le workspace.
• Valider & comparer — validation par lot, catalogues, comparaison structurelle, tests XSpec.
• Référence — tous les raccourcis, boutons, menus et gestes, en tables.