Handboek van KXSLDbg
Copyright © 2002, 2003, 2004 Keith Isdale
Het is toegestaan dit document te kopiëren, te verdelen en/of te wijzigen onder de voorwaarden van de GNU vrije-documentatie-licentie, versie 1.1 of een latere versie, gepubliceerd door de Free Software Foundation; zonder invariante paragrafen, zonder vooromslagteksten, en zonder achteromslagteksten. Een kopie van de licentie vindt u hier: de paragraaf "GNU vrije-documentatielicentie".
KXSLDbg biedt een grafische interface als frontend voorxsldbg, waarmee u XSLT-scripts kunt debuggen.
Inhoudsopgave
Met KXSLDbg kunt u het merendeel van de opdrachten van xsldbg gebruiken om
Breekpunten te zetten en te wijzigen
De waarde van XPaden weer te geven
Informatie over de aanwezige sjablonen, variabelen, aanroepstapel, stijlbladen en entiteiten weer te geven
Breekpunten en variabelen te zetten en te wijzigen
Door XSL™-bronnen en XML™-documenten te bladeren met XPaden
PUBLIC- en SYSTEM-ID's in de huidige XML™-catalogus op te zoeken
KXSLDbg kan nu
Variabelen instellen en veranderen
De tekst in het hoofdvenster weergeven met behulp van de Kate-bibliotheek
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
U start het instellen met -> in de menubalk.
Het dialoogvenster Instellen.
Om een stijlblad uit te kunnen voeren moet u het volgende opgeven:
het XSL™-bronbestand
het XML™-databestand
het uitvoerbestand
Met de knop kunt u het gewenste bestand kiezen. XSL™-bron en >XML™-data mogen verwijzen naar een URI met http://, ftp:// of file://. Het Uitvoerbestand moet een lokaal beschrijfbaar bestand zijn.
Om de voorbeelden te volgen, kiest u de volgende bestanden in de voorbeeldmap <KDE-MAP>/share/apps/kxsldbg:
XSL™-bron: testdoc.xsl
XML™-data: testdoc.xml
Uitvoerbestand: /tmp/xsldbg_output.txt
U kunt opties kiezen uit het dialoogvenster Opties. Elke optie heeft een ballontekst die u informatie geeft over het effect van die optie.
U kunt parameters toevoegen via de sectie LibXSLT-parameters. Hiermee kunt u parameterwaarden aan het stijlblad meegeven.
U kunt bijvoorbeeld als Parameternaam mijnparam kiezen met alsParameterwaarde 'Hallo wereld!' en vervolgens de knop kiezen. Om de waarde van een bestaande parameter te wijzen kunt u de knoppen en gebruiken, een nieuwe Parameterwaarde invoeren en dan de knop kiezen.
Als u wilt dat de wijzigingen in werking treden, moet u de knop kiezen. Om wijzigingen ongedaan te maken kiest u de knop .
U kunt het dialoogvenster sluiten met de in de rechterbovenhoek van het venster. Als u de instellingen weer wilt wijzigen opent u het instellingenvenster als hiervoor.
Een tekstweergave van het bestand dat gedebugd wordt.
De status van een bepaald breekpunt wordt aangegeven met de bijbehorende tekst en een achtergrondkleur. U kunt de gewenste kleuren instellen: zie de pagina Kleuren in het dialoogvenster ->.
U kunt een breekpunt zetten, uitschakelen of verwijderen met toetsen, het menu of de knoppen op de werkbalk.
U kunt de cursor door de tekst verplaatsen met de volgende toetsen:
| Pijltoetsen: Links, Rechts, Omhoog of Omlaag. |
| Paginatoetsen: Page Up en Page Down |
De meeste uitvoer van KXSLDbg wordt opgevangen en weergegeven in het inspector-dialoog of het uitvoervenster van KXSLDbg. Uitzonderingen hierop zijn:
Een foutmelding van KXSLDbg wordt weergegeven in een meldingsvenster.
Het resultaat van een geëvalueerde expressie wordt weergegeven in een meldingsvenster.
Het resultaat wordt naar het bestand gestuurd dat in het uitvoervenster van KXSLDbg wordt aangegeven.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
De belangrijkste manier om met breekpunten te werken is via het hoofdvenster. Zie de paragraaf “Het hoofdvenster gebruiken”
Als u het stijlblad gestart hebt, kunt u het menu-item -> kiezen. Klik dan op de tab Breekpunten. Zie hieronder voor een voorbeeld.
U kunt een breekpunt toevoegen door een van onderstaande op te geven:
een bestand en een regelnummer
een sjabloonnaam
een sjabloonnaam en een modusnaam
een modusnaam
En dan op de knop te klikken.
Een bestandsnaam mag een absoluut pad naar een lokaal bestand zijn, of een gedeeltelijke naam (bijv. xsldoc.xsl).
Een sjabloon- of modusnaam is een gekwalificeerde naam (QName) waarbij het niet-lokale deel optioneel is bijv. xsl:mijnsjabloon klopt met mijnsjabloon.
Klik eerst met de linkermuisknop op het breekpunt dat u wilt verwijderen. Klik dan op de knop .
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Als het dialoogvenster van de inspector niet zichtbaar is, kiest u ->.
Lokale en globale variabelen worden in een tab op het dialoogvenster getoond. Het volgende voorbeeld laat een XSLT-codesegment zien dat een globale en een lokale variabele declareert.
<xsl:variable name="globalvariable" select="'foo'"/>
<xsl:template match="/"/>
<xsl:param name="localvariable" select="'bar'"/>
</xsl:template match="/"/>
Als u met de muis op een variabele klikt wordt er informatie over die variabele getoond onderaan het dialoogvenster. Als een variabele een select-expressie heeft, bijvoorbeeld
<xsl:variable name="changeable" select="'oldValue'" />
dan kan een nieuw XPad gekozen worden door een nieuwe waarde in te voeren bij Variabele-expressie en vervolgens de knop te kiezen.
Het tabblad Variabelen
Als u op een variabele in de lijst klikt wordt de cursor in het hoofdvenster verplaatst naar het aangegeven bestand en regelnummer.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Alle items op de aanroepstapel worden hier weergegeven. Hoe ouder het item op de aanroepstapel, hoe lager het framenummer. Zie hieronder voor een voorbeeld.
Als u op een item van de aanroepstapel klikt wordt de cursor in het hoofdvenster verplaatst naar het aangegeven bestand en regelnummer.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Als het dialoogvenster van de inspector niet zichtbaar is, kies dan ->. Om met sjablonen te werken kiest u op de tab Sjablonen van het venster.
Alle gevonden sjablonen worden hier weergegeven. Let u erop dat de exporteerregels van XSLT gelden. Dus er mag niet meer dan één sjabloon met dezelfde overeenkomst- en modusdetails zijn.
Als u op een sjabloon in de lijst klikt wordt de cursor in het hoofdvenster verplaatst naar het aangegeven bestand en regelnummer.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Als het dialoogvenster van de inspector niet zichtbaar is, kiest u->. U kunt met bronnen werken door dit aan te geven op het tabblad "Bronnen" van het getoonde venster.
Alle XSLT-bronbestanden die worden meegenomen door het XSLT-bestand of één van de nevenliggende bestanden worden hier weergegeven.
Als u op een bron in de lijst klikt, wordt de cursor in het hoofdvenster verplaatst naar het begin van het aangegeven bestand.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Als het dialoogvenster van de inspector niet zichtbaar is, kiest u ->. Om met entiteiten te werken klikt u op de tab Entiteiten van het venster.
Alle externe XML™-entiteiten die ingevoegd zijn via het DATA-bestand of een van de nevenliggende bestanden worden hier weergegeven. Voor dit voorbeeld is KXSLDbg uitgevoerd op testdoc.xsl met testdoc.xml (uit <KDEMAP>/share/apps/kxsldbg) opdat u wat entiteiten kunt zien.
Als u op een entiteit in de lijst klikt wordt de cursor in het hoofdvenster verplaatst naar het begin van het aangegeven bestand.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Er zijn diverse hulpmiddelen beschikbaar via het menu Hulpmiddelen. Het belangrijkste hulpmiddel is de inspector.
De inspector is het hulpmiddel dat alle dialoogvensters bevat voor:
Breekpunten
Sjablonen
Variabelen
Items op de aanroepstapel
XSL™-bronbestanden
XML™-entiteiten
Door op te klikken wordt een dialoogvenster geopend waarmee u de snelheid kunt instellen.
Om te stoppen met lopen kunt u de toets W gebruiken of het menu-item kiezen.
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
Documentatie © 2004 Keith Isdale
Met dank aan:
De auteurs van libxml en libxslt.
Robert Jacolin voor terugkoppeling over eerdere versies van KXSLDbg.
Igor Zlatkovic voor het maken van WIN32-applicaties van libxml/xslt en xsldbg.
Deze documentatie valt onder de bepalingen van de GNU vrije-documentatie-licentie.
Deze toepassing valt onder de bepalingen van de 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