KXSLDbg-håndbogen
Ophavsret © 2002, 2003, 2004 Keith Isdale
Tilladelse er hermed givet til at kopiere, videregive og/eller ændre dette dokument under betingelserne i GNU's Fri Dokumentation License, Version 1.1 eller en vilkårlig senere version publiceret af Free Software Foundation; uden invariante afsnit, uden tekster før omslaget, og uden tekster efter omslaget. En kopi af licensen er inkluderet i afsnittet ved navn " Medvirkende og licens".
KXSLDbg sørger for en grafisk grænseflade for xsldbg, som hjælper med fejlsøgning i XSLT-scripter.
Indholdsfortegnelse
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
KXSLDbg kan nu
Sætte og ændre variable
Vise teksten i hovedvindue ved brug af Kate-bibliotekerne
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Du begynder indstillingen ved at klikke på -> i menulinjen.
Indstillingsdialogen.
For at kunne køre en stilskabelon skal du angive:
XSL-kildekode
XML-data
Uddatafil
Ved at bruge knappen til at vælge den ønskede fil. XSL kilden og >XML data kan referere til URI der indeholder http://, 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/apps/kxsldbg mappen
XSL-kildekode: testdoc.xsl
XML-data: testdoc.xml
Uddatafil: /tmp/xsldbg_output.txt
Du kan vælge ingen eller nogle valgmuligheder i -dialogen. Hvert tilvalg har et værktøjsvink med information om hvilken effekt det har.
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å -knappen. For at opdatere værdien i en eksisterende parameter, skal du bare navigere til den værdi du ønsker at ændre med knapperne eller , angive en ny parameterværdi og så klikke på knappen .
For at ændringerne du har lavet skal få virkning, trykkes på knappen . For at ignorere alle ændringer trykkes på knappen .
Du kan lukke dialogen med symbolet som vises længst oppe til højre i vinduet. Hvis du behøver at ændre indstillingerne, åbnes dialogen blot igen som tidligere beskrevet.
En tekstvisning af den aktuelle fil som fejlsøges.
Et givet stoppunkts tilstand indikeres via den relevante tekst, med en anderledes baggrundsfarve. Du kan vælge den ønskede farve sådan: ->, på siden Farver.
Du kan sætte, deaktivere eller fjerne et stoppunkt ved at bruge taster, -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 |
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.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Den primære måde at arbejde med stoppunkter er via hovedvinduet. Se “Brug af hovedvinduet”
Når stilarket er startet, kan du bruge menupunktet ->. Klik derefter på fanebladet Stoppunkter. Se et eksempel herunder.
Du kan tilføje et stoppunkt ved at angive et af følgende:
En fil og et linjenummer
Et skabelonnavn
Et skabelonnavn og et tilstandsnavn
Et tilstandsnavn
Og derefter trykke på knappen .
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.
Venstreklik først på stoppunktet som du vil slette i listen med aktuelle stoppunkter. Klik derefter på -knappen.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Hvis inspektørdialogen ikke vises brug menupunktet->.
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å -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.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
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.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Hvis inspektørdialogen ikke vises brug menupunktet->. 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.
Klik på en skabelonindgang i den viste liste vil få markøren i hovedvinduet til at gå til starten af den angivne fil.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Hvis inspektørdialogen ikke vises brug menupunktet->. 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.
Klik på en kildeindgang i den viste liste vil få markøren i hovedvinduet til at gå til starten af den angivne fil.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Hvis inspektordialogen ikke vises brug menupunktet ->. 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.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
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 indeholder alle de enkelte dialoger til at arbejde med:
Stoppunkter
Skabeloner
Variabler
Indgange i kaldstakken
XSL kildekodefiler
XML-entiteter
Ved at klikke på menupunktet vises en dialog for at vælge gangshastighed.
For at stoppe gangen, bruges enten tasten W eller menupunktet .
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
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.
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