Manuel de KXsldbg
Copyright © 2002, 2003 Keith Isdale
Permission est accordée de copier, distribuer et/ou modifier ce document selon les termes de la Licence de Documentation Libre GNU (GNU Free Documentation License), version 1.1 ou toute version ultérieure publiée par la Free Software Foundation sans section invariante, sans texte de première de couverture, ni texte de quatrième de couverture. Une copie de la licence est fournie dans la section intitulée " GNU Free Documentation License ".
KXsldbg fournit une interface graphique utilisateur pour xsldbg qui gère le débogage des scripts XSLT.
Table des matières
KXsldbg permet d'accéder à la plupart des commandes de xsldbg pour
ajouter et modifier des points d'arrêt
afficher des valeurs d'expressions
afficher des informations sur les points d'arrêt, les templates, les variables, les piles d'appels, les feuilles de styles et les entités qui ont été trouvés
se déplacer dans le source XSL™ et les documents XML™ en utilisant des XPaths
chercher les identifiants publics et systèmes dans le catalogue XML™ en cours
Vous lancer la configuration en cliquant sur -> dans la barre de menu.
La boîte de dialogue de configuration
Pour pouvoir lancer une feuille de styles, il vous faut spécifier :
le fichier source XSL™
le fichier de données XML™
le fichier de sortie
En utilisant le bouton pour choisir le fichier désiré. Assurez-vous que le fichier de sortie ne soit pas le même que les autres fichiers.
Pour poursuivre avec les exemples, sélectionnez les fichiers suivants du dossier example :
Fichier source XSL™ : xslddoc.xsl
Fichier de données XML™ : xsldoc.xml
Fichier de sortie : dump.txt
Vous pouvez sélectionner zéro options ou plus dans la boîte de dialogue Options. Chaque option a une bulle d'aide contenant un conseil sur son effet.
Vous pouvez sélectionner zéro paramètre ou plus par la section « paramètres libxslt » de la boîte de dialogue. Cela vous permet de fournir les valeurs des paramètres de la feuille de styles.
Par exemple, si vous avez une feuille de styles appelée addparam.xsl vous pouvez ajouter un paramètre appelé monparam avec la valeur de Bonjour tous le monde !. Pour modifier la valeur d'un paramètre existant, il suffit de l'ajouter à nouveau avec la nouvelle valeur désirée. Pour visualiser addparam.xsl, utilisez le bouton de la souris et choisissez un éditeur de textes pour voir le fichier.
Pour que les modifications que vous avez effectué prennent effet, pressez le bouton . Pour ignorer toutes les modifications, pressez sur le bouton .
Vous pouvez fermer la boîte de dialogue en utilisant le bouton fournit en haut à droite de la fenêtre. Si vous avez besoin de modifier la configuration, il suffit d'ouvrir la boîte de dialogue de configuration comme vu précédemment.
Une vue textuelle du fichier en cours à corriger.
Il y a quatre marqueurs colorés qui peuvent être affichés en début de ligne du texte :
indique un point d'arrêt actif
indique un point d'arrêt désactivé
indique l'emplacement actuel du débogueur
indique la position du curseur texte
Vous pouvez définir, désactiver ou supprimer un point d'arrêt au début d'un nœud XML™ en utilisant le bouton de la souris
Vous pouvez déplacer le curseur dans le texte en utilisant les touches suivantes :
| Les touches fléchées : Flèche gauche, Flèche droite, Flèche vers le haut, Flèche vers le bas. |
| Les touches saut de page : Saut de page arrière ou Saut de page avant |
La plupart de ce qui est généré par KXsldbg est capturé et présenté soit dans les boîtes de dialogue des contrôleurs soit dans la fenêtre de sortie de KXsldbg. Les exceptions à ces règles sont :
un message d'erreur qui vient de KXsldbg est affiché dans une boîte de message.
le résultat de l'évaluation d'une expression est affiché dans une boîte de message.
le résultat de recherches est envoyé dans le fichier indiqué dans la fenêtre de sortie de KXsldbg.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
La principale façon de travailler avec les points d'arrêt se fait par la fenêtre principale. Voir la section intitulée « Utiliser la fenêtre principale »
Une fois que vous avez démarrer la feuille de styles, vous pouvez utiliser l'élément de menu ->. Puis cliquez sur l'onglet « Points d'arrêt ». Voir ci-dessous pour un exemple.
Vous pouvez ajouter un point d'arrêt en fournissant :
un fichier et un numéro de ligne
un nom de template
un nom de template et un mode
un mode
puis en pressant le bouton .
Un nom de fichier peut être un chemin absolu vers un fichier local ou un fichier partiel (par exemple xsldoc.xsl).
Un template ou un mode peut être un nom pleinement qualifié où la partie non locale est optionnel par exemple xsl:montemplate correspond à montemplate.
D'abord, cliquez sur le point d'arrêt que vous voulez supprimer dans la liste des points en cours avec le bouton de la souris. Puis cliquez sur le bouton .
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Si la boîte de dialogue n'est pas affichée, utilisez l'élément de menu ->.
Les variables locales et globales sont affichées dans des onglets séparés dans la boîte de dialogue contrôleur. Une variable locale est une variable déclarée dans un template en utilisant xsl:param.
L'onglet variables globales
Un clic sur un élément variable de la liste affichée déplacera le curseur de la fenêtre principale dans le fichier et à la ligne indiqués.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Tous les éléments de la pile d'appels qui ont été trouvés sont listés ici. Plus l'appel est vieux, plus le numéro du groupe sera bas. Il aura xsl:param. Voir l'exemple ci-dessous.
Un clic sur un élément de la pile d'appels dans la liste affichée déplacera le curseur de la fenêtre principale dans le fichier et à la ligne indiqué.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Si la boîte de dialogue n'est pas affichée, utilisez l'élément de menu ->. Pour utiliser les sources, cliquez sur l'onglet sources de la boîte de dialogue affichée.
Tous les templates qui ont été trouvés sont listés ici. Veuillez noter que les règles d'export de XSLT sont appliquées. Par conséquent, il peut y avoir plus d'un template avec les mêmes détails de correspondance et de mode.
Un clic sur un élément template de la liste affichée déplacera le curseur de la fenêtre principale dans fichier et à la ligne indiqués.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Si la boîte de dialogue n'est pas affichée, utilisez l'élément de menu ->. Pour utiliser les sources, cliquez sur l'onglet sources de la boîte de dialogue affichée.
Tous les fichiers sources XSLT qui sont inclus par le fichier XSLT ou l'un des fichiers de même niveau sont listés ici.
Un clic sur un élément source de la liste affichée déplacera le curseur de la fenêtre principale au début du fichier indiqué.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Si la boîte de dialogue de contrôle n'est pas affichée, utilisez le menu ->. Pour travailler avec les entités, cliquez sur l'onglet Entités de la boîte de dialogue ainsi affichée.
Toutes les entités XML™ externes inclus par le fichier de données ou un des fichiers de même niveau sont listées ici. Par exemple, j'ai lancé KXsldbg avec test13.xsl sur test13.xml (que l'on peut trouver dans le dossier tests de la distribution source de xsldbg) pour que vous puissiez voir des entités.
En cliquant sur une entité de la liste déplacera le curseur de la fenêtre principale en début du fichier indiqué.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Plusieurs outils sont disponibles par l'intermédiaire du menu outils. L'outil principal est l'outil contrôleur.
L'outil contrôleur est le conteneur de tous les boîtes de dialogue individuelles pour travailler avec :
les points d'arrêt
les templates
les variables
les éléments de pile d'appel
les fichiers sources
les entités XML™
En cliquant sur le menu , une boîte de dialogue est affiché pour pouvoir définir la vitesse de progression.
Pour arrêter la progression, utilisez soit la touche W soit l'élément de menu .
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
KXsldbg © 2003 Keith Isdale
Documentation © 2003 Keith Isdale
Merci pour :
le créateur de libxml et de libxslt.
Robert Jacolin pour des retours sur des versions plus anciennes de KXsldbg.
Igor Zlatkovic pour la création de binaire WIN32 de libxml/xslt et de xsldbg.
Cette documentation est soumise aux termes de la Licence de Documentation Libre GNU (GNU Free Documentation License).
Ce programme est soumis aux termes de la Licence Générale Publique GNU (GNU General Public License).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team