Manuel de KXSLDbg
Copyright © 2002, 2003, 2004 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 les valeurs des XPath
afficher des informations sur les modèles (templates), les variables, les éléments des piles d'appel, les feuilles de style et les entités présents
ajouter et modifier des points d'arrêt et des variables
se déplacer dans le source XSL™ et les documents XML™ en utilisant des XPaths
chercher les identifiants publics et système dans le catalogue XML™ actif
KXSLDbg peut maintenant
ajouter et modifier des variables
effectuer le rendu du texte dans la fenêtre principale en utilisant les bibliothèques de Kate.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Vous lancez la configuration en cliquant sur -> dans la barre de menus.
La boîte de dialogue de configuration
Pour pouvoir lancer une feuille de styles, il vous faut indiquer :
le fichier source XSL™
le fichier de données XML™
le fichier de sortie
Utilisez le bouton pour choisir le fichier désiré. XSL™ source et >XML™ data doivent faire référence à des URI qui contiennent http://, ftp:// ou file://. Le Fichier de sortie doit faire référence à un fichier local accessible en écriture.
Pour poursuivre avec les exemples, sélectionnez les fichiers suivants du dossier d'exemple <PREFIXE DE KDE>/share/apps/kxsldbg.
Fichier source XSL™ : testdoc.xsl
Fichier de données XML™ : testdoc.xml
Fichier de sortie : /tmp/xsldbg_output.txt
Vous pouvez sélectionner une, plusieurs ou aucune options dans la boîte de dialogue Options. Chaque option a une bulle d'aide qui donne une idée de l'effet qu'elle a.
Vous pouvez sélectionner un, plusieurs ou aucun paramètres au moyen de 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, vous pouvez saisir monparam dans Nom du paramètre : avec 'Bonjour tout le monde !' dans Valeur du paramètre : et cliquer sur le bouton . Pour mettre à jour la valeur d'un paramètre existant, naviguez simplement vers la valeur que vous souhaitez modifier avec les boutons et , donnez une nouvelle Valeur du paramètre : puis cliquez sur .
Pour que les modifications que vous avez effectuées prennent effet, actionnez le bouton . Pour ignorer toutes les modifications, actionnez le bouton .
Vous pouvez fermer la boîte de dialogue en utilisant le bouton fourni 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.
L'état d'un point d'arrêt donné est indiqué par une couleur de fond différente pour le texte concerné. Vous pouvez choisir cette couleur : reportez-vous à la boîte de dialogue -> dans la page Couleurs.
Vous pouvez définir, désactiver ou supprimer un point d'arrêt en utilisant les touches, le menu ou les boutons de la barre d'outils.
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 de changement de page : Page précédente ou Page suivante |
La plus grande partie 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 à cette règle 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 est d'utiliser la fenêtre principale. Voir la section intitulée « Utiliser la fenêtre principale »
Une fois que vous avez démarré 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 modèle (template
un nom de modèle et un nom de mode
un nom de mode
puis en actionnant le bouton .
Un nom de fichier peut être un chemin absolu vers un fichier local ou un nom de fichier relatif (par exemple xsldoc.xsl).
Un nom de modèle ou de mode peut être un nom pleinement qualifié où la partie non locale est optionnelle ; par exemple xsl:monmodele correspond à monmodele.
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 un onglet séparé dans la boîte de dialogue du contrôleur. L'exemple suivant montre un segment de code XSLT qui déclare une variable globale et une variable locale.
<xsl:variable name="globalvariable" select="'foo'"/>
<xsl:template match="/"/>
<xsl:param name="localvariable" select="'bar'"/>
</xsl:template match="/"/>
En cliquant sur une variable de la liste, des informations seront affichées en bas de la boîte de dialogue. Si une variable a une expression de sélection, par exemple
<xsl:variable name="changeable" select="'oldValue'" />
alors un nouveau XPath peut être choisi en saisissant une nouvelle valeur pour l'expression de la variable puis en cliquant sur le bouton .
L'onglet variables
En cliquant sur un élément variable de la liste affichée, le curseur de la fenêtre principale se rendra 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 cadre sera bas. Voir l'exemple ci-dessous.
En cliquant sur un élément de la pile d'appels dans la liste affichée, le curseur de la fenêtre principale se rendra 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
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 modèles qui ont été trouvés sont énumérés ici. Veuillez noter que les règles d'exportation de XSLT sont appliquées. Par conséquent, il peut y avoir plus d'un modèle avec les mêmes détails de correspondance et de mode.
En cliquant sur un modèle figurant dans la liste affichée, le curseur de la fenêtre principale se rendra 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
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.
En cliquant sur un élément source de la liste affichée, le curseur de la fenêtre principale se rendra 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 incluses 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 testdoc.xsl sur testdocxml (que l'on peut trouver dans le dossier <KDE PREFIX>/share/apps/kxsldbg pour que vous puissiez voir des entités.
En cliquant sur une entité de la liste, le curseur de la fenêtre principale se rendra 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
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 toutes les boîtes de dialogue individuelles pour travailler avec :
les points d'arrêt
les modèles (templates)
les variables
les éléments de pile d'appel
les fichiers sources XSL™
les entités XML™
En cliquant sur le menu , une boîte de dialogue est affichée 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 © 2004 Keith Isdale
Documentation © 2004 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