KXSLDbg-håndbogen. Keith Isdale Oversætter: Erik Kjær Pedersen

Transkript

1 Keith Isdale Oversætter: Erik Kjær Pedersen

2 2

3 Indhold 1 Indledning Funktioner Nyligt tilføjede egenskaber Brug af KXSLDbg Indstilling af KXSLDbg-session Sådan kommer vi i gang Arbejde med valgmuligheder Arbejde med parametre Anvend ændringer Brug af hovedvinduet Arbejde med hovedvinduet Arbejde med KXSLDbg-uddata Sæt og ændr stoppunkter Tilføj et stoppunkt Detaljeinformation om argument: Slet et stoppunkt Slet alle stoppunkter Aktivér eller deaktivér et stoppunkt Arbejde med variabler Arbejde med kaldstakken Arbejde med skabeloner Arbejde med XSLT-kildefiler (kilder) Arbejde med XML datafiler (entiteter) Diverse værktøjer Inspektørværktøjet Kør ved at gennemgå Slå XML-entiteter op Medvirkende og licenser 15

4 Resumé KXSLDbg sørger for en grafisk grænseflade for xsldbg, som hjælper med fejlsøgning i XSLTscripter.

5 Kapitel 1 Indledning 1.1 Funktioner KXSLDbg giver adgang til de fleste xsldbg-kommandoer til at Sætte og ændre stoppunkter Vise værdien af XPaths Vise information om de tilstedeværende skabeloner, variable, kaldstak-indgange, stilark og entiteter. Sæt og ændr stoppunkter og variable Flytte omkring i XSL-kildekoden og XML-dokumentet via Xpath Slå PUBLIC og SYSTEM ID op i aktuel XML-mappe 1.2 Nyligt tilføjede egenskaber KXSLDbg kan nu Sætte og ændre variable Vise teksten i hovedvindue ved brug af Kate-bibliotekerne 5

6 Kapitel 2 Brug af KXSLDbg 2.1 Indstilling af KXSLDbg-session Du begynder indstillingen ved at klikke på Fejlsøg Indstil i menulinjen. Indstillingsdialogen Sådan kommer vi i gang For at kunne køre en stilskabelon skal du angive: XSL-kildekode XML-data Uddatafil 6

7 Ved at bruge knappen... til at vælge den ønskede fil. XSL kilden og >XML data kan referere til URI der indeholder ftp:// eller file://. Uddatafil skal referere til en skrivbar lokal fil. For at følge med i eksemplerne skal du vælge følgende filer i eksemplet. <KDE PREFIX>/share/a pps/kxsldbg mappen XSL-kildekode: testdoc.xsl XML-data: testdoc.xml Uddatafil: /tmp/xsldbg_output.txt Arbejde med valgmuligheder Du kan vælge ingen eller nogle valgmuligheder i Tilvalgs-dialogen. Hvert tilvalg har et værktøjsvink med information om hvilken effekt det har Arbejde med parametre Du kan tilføje nul eller flere parametre via LibXSLT parametre-delen i dialogen. Dette gør det muligt at angive parameterværdier til stilarket. F.eks. kan du tilføje et parameternavn af minparam med en parameterværdi, Hello World! og klikke på Tilføj-knappen. For at opdatere værdien i en eksisterende parameter, skal du bare navigere til den værdi du ønsker at ændre med knapperne Forrige eller Næste, angive en ny parameterværdi og så klikke på knappen Anvend Anvend ændringer For at ændringerne du har lavet skal få virkning, trykkes på knappen Anvend. For at ignorere alle ændringer trykkes på knappen Annullér. Du kan lukke dialogen med symbolet X som vises længst oppe til højre i vinduet. Hvis du behøver at ændre indstillingerne, åbnes dialogen blot igen som tidligere beskrevet. 7

8 2.2 Brug af hovedvinduet En tekstvisning af den aktuelle fil som fejlsøges Arbejde med hovedvinduet Et givet stoppunkts tilstand indikeres via den relevante tekst, med en anderledes baggrundsfarve. Du kan vælge den ønskede farve sådan: Opsætning Indstil Editor, på siden Farver. Du kan sætte, deaktivere eller fjerne et stoppunkt ved at bruge taster, Fejlret-menuen eller knapperne på værktøjslinjen. Du kan flytte markøren rundt i teksten med følgende taster: Piletaster: Venstre pil, Højre pil, Opad pil eller Nedad pil. Sidetaster: Page Up eller Page Down Arbejde med KXSLDbg-uddata Det meste uddata fra KXSLDbg fanges og præsenteres enten i inspektørens dialog eller i KXSLDbgs udskriftsvindue. Undtagelsen for denne regel er: En fejlmeddelelse som kommer fra KXSLDbg vises i en meddelelsesdialog. Resultatet af evaluering af et udtryk vises i en meddelelsesdialog. Uddata fra en søgning sendes til filen som angives i KXSLDbgs udskriftsvindue. 8

9 2.3 Sæt og ændr stoppunkter Den primære måde at arbejde med stoppunkter er via hovedvinduet. Se Afsnit 2.2 Når stilarket er startet, kan du bruge menupunktet Værktøjer Vis inspektører. Klik derefter på fanebladet Stoppunkter. Se et eksempel herunder Tilføj et stoppunkt Du kan tilføje et stoppunkt ved at angive et af følgende: 1. En fil og et linjenummer 2. Et skabelonnavn 3. Et skabelonnavn og et tilstandsnavn 4. Et tilstandsnavn Og derefter trykke på knappen Tilføj Detaljeinformation om argument: Et filnavn kan være en absolut søgesti til en lokal fil, eller en delvis søgesti (f.eks. xsldoc.xsl). Et skabelon- eller tilstandsnavn er et fuldstændigt kvalificeret navn hvor den ikke-lokale del er valgfri, f.eks. matches xsl:min_mall af min_mall Slet et stoppunkt Venstreklik først på stoppunktet som du vil slette i listen med aktuelle stoppunkter. Klik derefter på Slet-knappen. 9

10 2.3.4 Slet alle stoppunkter Klik på Slet alt-knappen Aktivér eller deaktivér et stoppunkt Venstreklik først på stoppunktet som du vil aktivere i listen med aktuelle stoppunkter. Klik derefter på Aktivér-knappen. 2.4 Arbejde med variabler Hvis inspektørdialogen ikke vises brug menupunktetværktøjer Vis inspektører. Lokale og globale variable vises i separate faneblade i inspektørdialogen. Det følgende eksempel viser et XSLT-kodesegment der erklærer en global og en lokal variabel. <xsl: variabelname =" globalvariabel " vælg =" foo "/> <xsl: skabelon match ="/"/ > <xsl:param name =" localvariabel " vælg =" bar "/> </xsl: skabelon match ="/"/ > Et klik på en varibel i listen med musen, viser opsummerende information i bunden af dialogen. Hvis en variabel har et særligt udtryk, for eksempel <xsl: variabelnavn =" changeable " vælg =" oldvalue " /> så kan en ny XPath vælges ved at indtaste en ny værdi for Variabeludtryk og derefter klikke på Sæt udtryk-knappen. Faneblad til variable Klik på en variabelindgang i den viste liste, vil få markøren i hovedvinduet til at gå til filen og det angivede linjenummer. 10

11 2.5 Arbejde med kaldstakken Alle kaldstak-punkter ses på listen her. Jo ældre kaldstak-indgangen er jo lavere rammenummer vil den have. Se eksempel herunder. Klik på en kaldstak-indgang i den viste liste vil få markøren i hovedvinduet til at gå hen til filen og det angivne linjenummer. 2.6 Arbejde med skabeloner Hvis inspektørdialogen ikke vises brug menupunktetværktøjer Vis inspektører. For at arbejde med skabeloner klikkes på skabelonfanebladet i den viste dialog. Alle skabeloner er på denne liste. Bemærk venligst at eksportreglerne for XSLT gælder. Så der kan ikke være mere end en skabelon med samme tilpasning og tilstandsdetaljer. 11

12 Klik på en skabelonindgang i den viste liste vil få markøren i hovedvinduet til at gå til starten af den angivne fil. 2.7 Arbejde med XSLT-kildefiler (kilder) Hvis inspektørdialogen ikke vises brug menupunktetværktøjer Vis inspektører. For at arbejde med kilder klikkes på kildefanebladet i den viste dialog. Alle XSLT-kildefiler der er inkluderet i XSLT-filen eller en af dens søskende er på denne liste. 12

13 Klik på en kildeindgang i den viste liste vil få markøren i hovedvinduet til at gå til starten af den angivne fil. 2.8 Arbejde med XML datafiler (entiteter) Hvis inspektordialogen ikke vises brug menupunktet Værktøjer Vis inspektorer. For at arbejde med entiteter klik på Entiteter-fanebladet i den viste dialog. Alle eksterne XML-entiteter inkluderet via DATA-fil eller en af dens søskende er på listen her. I dette eksempel har jeg kørt KXSLDbg på testdoc.xsl med testdoc.xml (fundet i <KDE PREFIX >/share/apps/kxsldbg-mappen så du kan se nogle entiteter. klik på en entitetsindgang i den viste liste vil få markøren i hovedvinduet til at gå til starten af den angivne fil. 2.9 Diverse værktøjer Flere værktøjer er tilgængelige via menuen Fejlsøg, hvor det hovedværktøjet er inspektørværktøjet Inspektørværktøjet Inspektørværktøjet indeholder alle de enkelte dialoger til at arbejde med: Stoppunkter Skabeloner Variabler Indgange i kaldstakken 13

14 XSL kildekodefiler XML-entiteter Kør ved at gennemgå Ved at klikke på menupunktet Start kørsel ved gang vises en dialog for at vælge gangshastighed. For at stoppe gangen, bruges enten tasten W eller menupunktet Stop kørsel ved gang Slå XML-entiteter op For at slå op SystemID op i aktuel XML-mappe, bruges menupunktet Slå SystemID op, og derefter indskrives værdien der skal findes i dialogen som vises. For at slå et PublicID op, bruges menupunktet Slå PublicID op, og derefter indskrives værdien der skal findes i dialogen som vises. 14

15 Kapitel 3 Medvirkende og licenser Keith Isdale Oversætter: Erik Kjær Pedersen KXSLDbg (c) 2004 Keith Isdale Dokumentation (c) 2004 Keith Isdale TAK TIL: Dem som skrevet libxml og libxslt. Robert Jacolin for tilbagemelding om tidligere versioner af KXSLDbg. Igor Zlatkovic for at have lavet programfiler for WIN32 for libxml/xslt og xsldbg. Dokumentation er udgivet under betingelserne i GNU Free Documentation License. Dette program er udgivet under betingelserne i GNU General Public License. 15