Keith Isdale Översättare: Stefan Asserhäll
2
Innehåll 1 Inledning 5 1.1 Funktioner.......................................... 5 2 Använda KXSLDbg 6 2.1 Anpassa en KXSLDbg-session............................... 6 2.1.1 Komma igång.................................... 6 2.1.2 Arbeta med alternativ............................... 7 2.1.3 Arbeta med parametrar.............................. 7 2.1.4 Verkställa ändringar................................ 7 2.2 Använda huvudfönstret.................................. 8 2.2.1 Arbeta med huvudfönstret............................ 8 2.2.2 Arbeta med KXSLDbg-utdata........................... 8 2.3 Sätta och ändra brytpunkter................................ 8 2.3.1 Lägga till en brytpunkt............................... 9 2.3.2 Detaljinformation om argument......................... 9 2.3.3 Ta bort en brytpunkt................................ 9 2.3.4 Ta bort alla brytpunkter.............................. 9 2.3.5 Aktivera eller inaktivera en brytpunkt...................... 10 2.4 Arbeta med variabler.................................... 10 2.5 Arbeta med anropsstacken................................. 11 2.6 Arbeta med mallar..................................... 11 2.7 Arbeta med XSLT-källkodsfiler (Källkod)........................ 12 2.8 Arbeta med XML-datafiler (instanser).......................... 13 2.9 Diverse............................................ 13 2.9.1 Inspektörverktyget................................. 13 2.9.2 Köra genom att gå igenom............................ 14 2.9.3 Slå upp XML-instanser............................... 14 3 Tack till och licens 16
Sammanfattning KXSLDbg tillhandahåller ett grafiskt gränssnitt till xsldbg, som stöder felsökning i XSLTskript.
Kapitel 1 Inledning 1.1 Funktioner 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 Sätta och ändra variabler Ritar upp texten i huvudfönstret med Kate-biblioteken 5
Kapitel 2 Använda KXSLDbg 2.1 Anpassa en KXSLDbg-session Du börjar inställningen genom att klicka på Felsök Anpassa i menyraden. Inställningsdialogrutan. 2.1.1 Komma igång För att kunna köra en stilmall måste du ange: XSL-källkod XML-data Utdatafil 6
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/kx sldbg: XSL-källkod: testdoc.xsl XML-data: testdoc.xml Utdatafil: /tmp/xsldbg_output.txt 2.1.2 Arbeta med alternativ Du kan välja valfritt antal alternativ i rutan Alternativ Varje alternativ har ett verktygstips med information om vilken effekt det har. 2.1.3 Arbeta med parametrar Du kan lägga till valfri mängd parametrar via XSLT-biblioteksparametrar i dialogrutan. Det gör det möjligt att ange parametervärden till stilmallen. Det går till exempel att klicka på knappen Lägg till och skriva in Namn på parametern min-pa rameter med Värde Hej allihop!. Markera en befintlig parameter med vänster musknapp för att uppdatera namnet eller värdet. 2.1.4 Verkställa ändringar För att ändringarna du har gjort ska få effekt, tryck på knappen Ok och stäng dialogrutan. För att ignorera alla ändringar tryck på knappen Avbryt. Om du behöver ändra inställningarna, öppna bara dialogrutan igen som tidigare beskrivits. 7
2.2 Använda huvudfönstret En textvy av den aktuella filen som felsöks. 2.2.1 Arbeta med huvudfönstret 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 Inställningar Anpassa editor, på sidan Färger. Du kan sätta, inaktivera eller ta bort en brytpunkt genom att använda tangenter, menyn Felsök 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. 2.2.2 Arbeta med KXSLDbg-utdata 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. 2.3 Sätta och ändra brytpunkter Det huvudsakliga sättet att arbeta med brytpunkter är via huvudfönstret. Se Avsnitt 2.2 8
När stilmallen väl har startats kan du använda menyalternativet Felsök Inspektera... Klicka därefter på fliken Brytpunkter. Se nedan för ett exempel. 2.3.1 Lägga till en brytpunkt Du kan lägga till en brytpunkt genom att ange något av: 1. en fil och ett radnummer 2. ett mallnamn 3. ett mallnamn och lägesnamn 4. ett lägesnamn Och därefter trycka på knappen Lägg till. 2.3.2 Detaljinformation om argument 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 när den icke-lokala delen inte behövs, t.ex. xsl:min-mall motsvaras av min-mall. 2.3.3 Ta bort en brytpunkt Vänsterklicka först på brytpunkten som du vill ta bort i listan med aktuella brytpunkter. Klicka därefter på knappen Ta bort. 2.3.4 Ta bort alla brytpunkter Klicka på knappen Ta bort alla. 9
2.3.5 Aktivera eller inaktivera en brytpunkt Vänsterklicka först på brytpunkten som du vill aktivera i listan med aktuella brytpunkter. Klicka därefter på knappen Aktivera. 2.4 Arbeta med variabler Om inspektörsdialogrutan inte visas, använd menyalternativet Felsök Inspektera... 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 Ange uttryck. Fliken Variabler Genom att klicka på en variabel i listan som visas, flyttas markören i huvudfönstret till filen och radnumret som anges. 10
2.5 Arbeta med anropsstacken 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. 2.6 Arbeta med mallar Om inspektörsdialogrutan inte visas, använd menyalternativet Felsök Inspektera... 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. 11
Genom att klicka på en mall i listan som visas, flyttas markören i huvudfönstret till filen och radnumret som anges. 2.7 Arbeta med XSLT-källkodsfiler (Källkod) Om inspektörsdialogrutan inte visas, använd menyalternativet Felsök Inspektera... 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. 12
Genom att klicka på en källkodsfil i listan som visas, flyttas markören i huvudfönstret till början på filen som anges. 2.8 Arbeta med XML-datafiler (instanser) Om inspektörsdialogrutan inte visas, använd menyalternativet Felsök Inspektera... 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. 2.9 Diverse Flera verktyg är tillgängliga via menyn Felsök. Det huvudsakliga verktyget är inspektörverktyget. 2.9.1 Inspektörverktyget Inspektörverktyget innehåller alla enskilda dialogrutor för att arbeta med: Brytpunkter Mallar Variabler Poster i anropsstacken XSL-källkodsfiler XML-poster 13
2.9.2 Köra genom att gå igenom Genom att klicka på menyalternativet Gå igenom stilmall... i menyn Felsök visas en dialogruta för att välja genomgångshastighet. För att stoppa genomgången, använd tangenten K eller välj menyalternativet Stoppa genomgång av stilmall. 2.9.3 Slå upp XML-instanser För att slå upp ett System i aktuell XML-katalog, använd menyalternativet Slå upp SystemID..., och skriv sedan in värdet att söka i dialogrutan som visas. För att slå upp ett PublicID, använd menyalternativet Slå upp PublicID, och skriv sedan in värdet att söka i dialogrutan som visas. 14
15
Kapitel 3 Tack till och licens KXSLDbg (c) 2004 Keith Isdale Dokumentation (c) 2004 Keith Isdale TACK TILL: De som skrivit libxml och libxslt. Robert Jacolin för återkoppling om tidigare versioner av KXSLDbg. Igor Zlatkovic för att ha skapat binärfiler för Win32 av libxml/xslt och xsldbg. Översättning Stefan Asserhäll stefan.asserhall@bredband.net Den här dokumentationen licensieras under villkoren i GNU Free Documentation License. Det här programmet licensieras under villkoren i GNU General Public License. 16