Handbok KXSLDbg
Copyright © 2002, 2003, 2004 Keith Isdale
Härmed ges tillåtelse att kopiera, distribuera och/eller ändra detta dokument under villkoren i GNU Free Documentation License, Version 1.1 eller någon senare version publicerad av Free Software Foundation; utan invarianta avsnitt, utan framsidestexter och utan baksidestexter. En kopia av licensen inkluderas i avsnittet som heter "GNU Free Documentation License".
KXSLDbg tillhandahåller ett grafiskt gränssnitt till xsldbg, som stöder felsökning i XSLT-skript.
Innehållsförteckning
KXSLDbg ger tillgång till de flesta xsldbg-kommandon, för att:
Sätta och ändra brytpunkter
Visa värdet på Xpath
Visa information om mallar, variabler, poster på anropsstacken, stilmallar och instanser som finns
Sätta och ändra brytpunkter och variabler
Flytta omkring i XSL-källkoden och XML-dokumentet via Xpath
Slå upp PUBLIC och SYSTEM ID i aktuell XML-katalog
KXSLDbg kan nu
Sätta och ändra variabler
Ritar upp texten i huvudfönstret med Kate-biblioteken
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Du börjar inställningen genom att klicka på -> i menyraden.
Inställningsdialogrutan.
För att kunna köra en stilmall måste du ange:
XSL-källkod
XML-data
Utdatafil
Genom att använda knappen för att välja önskad fil. XSL-källa och XML-data kan ange webbadresser som innehåller http://, ftp:// eller file://. Utdatafil måste ange en lokal skrivbar fil.
För att följa med i exemplet, välj följande filer i exempelkatalogen <KDE-PREFIX>/share/apps/kxsldbg:
XSL-källkod: testdoc.xsl
XML-data: testdoc.xml
Utdatafil: /tmp/xsldbg_output.txt
Du kan välja inget eller några alternativ i rutan Alternativ. Varje alternativ har ett verktygstips med information om vilken effekt det har.
Du kan lägga ingen eller några parametrar via XSLT-biblioteksparametrar i dialogrutan. Det gör det möjligt att ange parametervärden till stilmallen.
Du skulle till exempel kunna lägga till ett Parameternamn kallat min_parameter med ett Parametervärde angivet till 'Hej allesamman! och klicka på knappen . För att uppdatera en befintlig parameters värde, navigera bara till värdet du vill ändra med knapparna och , ange ett nytt Parametervärde och klicka därefter på knappen .
För att ändringarna du har gjort ska få effekt, tryck på knappen . För att ignorera alla ändringar tryck på knappen .
Du kan stänga dialogrutan med symbolen som visas längst upp till höger i fönstret. Om du behöver ändra inställningarna, öppna bara dialogrutan igen som tidigare beskrivits.
En textvy av den aktuella filen som felsöks.
Tillståndet för en given brytpunkt anges med relevant text med en annan bakgrundsfärg. Du kan välja önskad färg: Se dialogrutan ->, på sidan Färger.
Du kan sätta, inaktivera eller ta bort en brytpunkt genom att använda tangenter, menyn eller knapparna i verktygsraden.
Du kan flytta omkring markören i texten med följande tangenter:
| Piltangenter: vänsterpil, högerpil, uppåtpil eller neråtpil. |
| Sidtangenter: Page Up eller Page Down. |
Det mesta av utdata från KXSLDbg fångas och presenteras antingen i inspektörens dialogruta eller i KXSLDbgs utmatningsfönster. Undantag till denna regel är:
Ett felmeddelande som kommer från KXSLDbg visas i en meddelandedialogruta.
Resultatet från utvärdering av ett uttryck visas i en meddelandedialogruta.
Utdata från en sökning skickas till filen som anges i KXSLDbgs utmatningsfönster.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Det huvudsakliga sättet att arbeta med brytpunkter är via huvudfönstret. Se “Använda huvudfönstret”
När stilmallen väl har startats, kan du använda menyalternativet ->. Klicka därefter på fliken Brytpunkter. Se nedan för ett exempel.
Du kan lägga till en brytpunkt genom att ange något av:
en fil och ett radnummer
ett mallnamn
ett mallnamn och lägesnamn
ett lägesnamn
Och därefter trycka på knappen .
Ett filnamn kan vara en absolut sökväg till en lokal fil, eller en partiell sökväg (t.ex. xsldoc.xsl).
Ett mall- eller lägesnamn är ett fullständigt kvalificerat namn där den icke-lokala delen är valfri, t.ex. matchas xsl:min_mall av min_mall.
Vänsterklicka först på brytpunkten som du vill ta bort i listan med aktuella brytpunkter. Klicka därefter på knappen .
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Om inspektörsdialogrutan inte visas, använd menyalternativet ->.
Lokala och globala variabler visas under en flik i inspektörsdialogrutan. Följande exempel visar ett XSLT-kodsegement som deklarerar en global och en lokal variabel.
<xsl:variable name="global_variabel" select="'x'"/>
<xsl:template match="/"/>
<xsl:param name="lokal_variabel" select="'y'"/>
</xsl:template match="/"/>
Att klicka med musen på en variabel i listan gör att översiktsinformation visas längst ner i dialogrutan. Om en variabel har ett urvalsuttryck, till exempel
<xsl:variable name="varierande" select="'gammalt_värde'" />
kan en ny Xpath väljas genom att skriva in ett nytt värde i Variabeluttryck och därefter klicka på knappen .
Fliken Variabler
Genom att klicka på en variabel i listan som visas, flyttas markören i huvudfönstret till filen och radnumret som anges.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Alla anropsstackposter som hittas listas här. Ju äldre anropsstackposten är desto lägre nummer har posten. Se nedan för ett exempel.
Genom att klicka på en anropsstackpost i listan som visas, flyttas markören i huvudfönstret till filen och radnumret som anges.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Om inspektörsdialogrutan inte visas, använd menyalternativet ->. För att arbeta med mallar, klicka på mallfliken i dialogrutan som visas.
Alla mallar som hittas listas här. Observera att exportreglerna för XSLT gäller. Alltså kan det finnas mer än en mall med samma värde på namn och läge.
Genom att klicka på en mall i listan som visas, flyttas markören i huvudfönstret till filen och radnumret som anges.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Om inspektörsdialogrutan inte visas, använd menyalternativet ->. För att arbeta med källkod, klicka på källkodsfliken i dialogrutan som visas.
Alla XSLT-källkodsfiler som inkluderas av XSLT-filen eller en av filer på samma nivå listas här.
Genom att klicka på en källkodsfil i listan som visas, flyttas markören i huvudfönstret till början på filen som anges.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Om inspektörsdialogrutan inte visas, använd menyalternativet ->. För att arbeta med instanser, klicka på fliken Instanser i dialogrutan som visas.
Alla externa XML-instanser som inkluderas via datafilen eller en av filerna på samma nivå listas här. I detta exemplet har KXSLDbg körts med testdoc.xsl med testdoc.xml (som finns i katalogen <KDE-PREFIX>/share/apps/kxsldbg) så att du kan se några instanser.
Genom att klicka på en instans i listan som visas, flyttas markören i huvudfönstret till filen och radnumret som anges.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Flera verktyg är tillgängliga via menyn Felsök, där det huvudsakliga verktyget är inspektörverktyget.
Inspektörverktyget innehåller alla enskilda dialogrutor för att arbeta med:
Brytpunkter
Mallar
Variabler
Poster i anropsstacken
XSL-källkodsfiler
XML-instanser
Genom att klicka på menyalternativet visas en dialogruta för att välja genomgångshastighet.
För att stoppa genomgången, använd tangenten W eller välj menyalternativet .
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 (c) 2004 Keith Isdale
Dokumentation (c) 2004 Keith Isdale
Tack till:
De som skrivit libxml och libxslt.
Robert Jacolin för återmatning om tidigare versioner av KXSLDbg.
Igor Zlatkovic för att ha skapat binärfiler för WIN32 av libxml/xslt och xsldbg.
Den här dokumentationen licensieras under villkoren i GNU Free Documentation License.
Det här programmet licensieras under villkoren i 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