xsldbg-håndbogen
Ophavsret © 2002, 2003 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".
xsldbg er et værktøj der skal hjælpe dig til at forstå stilark. Det som gør det anderledes end andre stilark-fejlrettere, er muligheden for at søge efter interessante elementer i stilarket og spore stilark-kørsel.
Indholdsfortegnelse
Tabelliste
xsldbg er et tekstbaseret værktøj til at fejlrette stilark (eXtensible Stylesheet Language) og har kommandoer der ligner dem i UNIX/Linux fejlretteren gdb. Det har tre primære metoder at udføre stilark på.
| Køre hele stilarket |
| Enkelt trin til næste xsl-instruktion. |
| Fortsæt indtil næste stoppunkt eller når stilarket begynder forfra. |
På systemer med et readline-bibliotek til rådighed, kan du bruge tilbage/fremad-knapperne til at navigere i kommandohistorikken. På alle systemer kan den sidst brugte kommando gentages ved blot at trykke på <ENTER>-tasten.
Hvis dit operativsystem understøtter det kan filnavne udvides.
Mange kommandoer kan tage mere end et argument. Du kan bruge anførselstegn til at lade flere komplekse udtryk blive opfattet som et enkelt, f.eks. break "* | @" ville lade dig sætte et stoppunkt på skabelonen med navnet "* | @"
Den følgende tabel beskriver termerne der bruges i den efterfølgende kommandoguide.
| SKABELON_NAVN : Et gyldigt skabelonnavn indeholder kun ASCII-tegn 0x00 til 0x7F og kan kan være et fuldgyldigt navn som "xsl:skabelonNavn". |
| FILNAVN : Et gyldigt navn på en lokal fil på brugerens system. Det kan have et "~"-præfiks på *nix og CYGWIN-platforme, eller miljøvariable på RISC OS. |
| URI : En Uniform Ressource Identifier som defineret i RFC 2396 |
| TILSTANDS_NAVN : Skabelonens tilstand som kan være et fuldgyldigt navn som "xsl:tilstandsNavn". |
| QNAVN : Et fuldgyldigt navn som "xsl:lokalPart" |
| LINENO : Et gyldigt linjenummer i et tilhørende <FILNAVNAVN> |
| ANTAL_RAMMER : Et gyldigt antal rammer at ændre placering med |
| STOPPUNKT_ID : Et gyldigt stoppunkts-nummer |
| OVERVÅGNINGS_ID : Et gyldigt overvågningsnummer som angivet af showwatch-kommandoen |
| HASTIGHED : hastigheden hvormed koden gennemgåes, mellem 0 og 9 |
| (Kommentar): en kommentar om kommandoens betydning eller anvendelse |
| { opt1 | opt2 | opt2 .. etc} : Vælg en af de foregående opt's |
| XPATH : et xpath-udvalg af knudepunkter |
| PARAM_ID : et gyldigt parametertal som angivet af showparam-kommandoen |
| PATH : En sti at ændre arbejdsmappe med. På nogle operativsystemer vil et "~"-præfiks erstatte stien til din hjemmemappe |
| TEKST : Fri tekst (ingen relationer) |
| KOMMANDO : En gyldig kommando til xsldbg |
| QNAME : Et gyldig variabel/parameternavn |
| KILDE : Stilarket der bruge/eksekveres. Se <FILNAVN> og <URI> |
| DATA : XML-data(dokument) der skal bearbejdes af stilarket. Se <FILNAVN> og <URI> |
| ENHEDS_STI : En gyldig terminal på operativsystemet |
| TTY_NIVEAU : Er et gyldigt niveau bruge inddata/uddata på |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
| Hjælp hjælp |
| Kører relateret : {farvel|exit| afslut}, trin, træd op, træd ned, næste, fortsæt, kør, spor, indstil, indstillinger |
| Libxslt parameter-relateret : tilføjparam, sletparam, visparam, uddata, indstil, indstillinger |
| Skabelonrelateret : skabeloner, hvor, ramme |
| Stoppunkt-relateret : afbryd, vis afbryd, slet, aktivér |
| Udtryksvisning(xpath) : cat |
| Knudevisning : ls, dir, du, cat, pwd |
| Variabelvisning : globale, locale, cat, addwatch |
| Variabelindstillinger : set |
| Knudemarkering : kilde, data, cd |
| Søgning : søg |
| Operativsystemrelateret : chdir, skal, tty |
| Filrelateret : uddata, entiteter, system, offentlig |
| Deaktiverede filkommandoer : validér, indlæs, gem, skriv, free |
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
Tilføj en libxslt-parameter. Svarer til at bruge --param <QNAME>:<XPATH> på kommandolinjen.
Tilføj et udtryk der skal overvåges. Se på visovervågning virker for at vise overvågningsværdier.
Genvejsnavn: overvåg
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
Afbryd ved en skabelon, på et sted i et stilark eller en xml-fil indlæst af xsldbg eller i den aktuelle knude. Nyt i xsldbg 3.1.4: Når du er i gdb-kompatibilitetstilstand kan forældreløse stoppunkter sættes i en bestemt fil og linjenummer og ændre til en aktiv senere.
Genvejsnavn: b
Xsldbg forsøger at gætte at gætte den fuldstændiga URL givet et
| filnavn uden angiven søgesti |
| et filnavn i samme mappe som "øverste" skabelon som blev indlæst |
| et filnavn relativt til xsldbgs nuværende arbejdsmappe |
break -l xsldoc.xsl 26
Denne kommando matcher en partiel eller fuldstændig QNAME-skabelon og/eller tilstandsnavn som angives. For eksempel matcher "skabelon" et hvilket som helst QNAME med en lokal del af "skabelon".
Alle navnerum i angivet QNAME expanderes som angives af navnerumerna definerede i XSL-kildekodsfilen, t.ex. expanderes "xsl:test1" til "http://www.w3.org/199/XSL/Transform:test1"
En ønsket stoppunkt skal først løses op i dens tilhørende URL og linjenummer- Dette gøres automatisk efter den første skabelon er set af xsldbg. Stoppunkter valideres igen, et kort stykke tid efter hvert kørselsstart.
Automatisk stoppunktsvalidering bruges når gdb-tilstand er aktiveret, standardopførselen i xsldbg.
Tabel 3.4. Anvendelse af break
| break -l <FILENAME> <LINENO> (For at sætte et stoppunkt i en angivet fil, på et givet linjenummer) |
| break -l <URL> <LINENO> (For at sætte et stoppunkt i en angivet URL, på et angivet linjenummer) |
| break <TEMPLATE_NAME> (For at afbryde i en navngiven eller matchende skabelon.) |
| break <TEMPLATE_NAME> <MODE_NAME> (For at afbryde i en navngiven skabelon med givet tilstand.) > |
| break "" <MODE_NAME> (For at afbryde i alle skabeloner som har et givet tilstandsnavn) |
| break * (For at afbryde i alle fundne skabeloner.) |
| break \* (For at afbryde i skabelon "*". Andre navn som indeholder '*' behandles ikke specielt.) |
| break (For at sætte et stoppunkt i nuværende knudepunkt. Ja, det omfatter XML-dataknudepunkter.) |
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
Udskriv resultatet af et Xpath-udtryk relativt til nuværende knudepunkt.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Skift til søgestien som angives af en Xpath.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Ændr arbejdsmappen
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Fortsæt med at køre stilarket og stop ved eventuelle stoppunkter.
Genvejsnavn: c
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Skift til visning af det nuværende knudepunkt i XML-data, eller ændr de anvendte XML-data.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Slet et skabelon-stoppunkt.
Genvejsnavn: d
Tabel 3.11. Anvendelse af Delete
| delete (For at fjerne stoppunktet i det nuværende knudepunkt) |
| delete <STOPPUNKT_ID> (For at fjerne stoppunktet med angivet stoppunktsnummer) |
| delete -l <FILENAME> <LINENO> (Fjern i angivet fil, på linjenummer) |
| delete -l <URL> <LINENO> (Fjern i angiven URL, på linjenummer) |
| delete <SKABELONNAVN> (For at fjerne stoppunktet i navngiven skabelon.) |
| delete * (For at fjerne alle stoppunkter.) |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Slet en libxslt-parameter
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Slet et overvågningsudtryk, eller fjern alle overvågningsudtryk som vises af kommandoen "showwatch".
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Udskriv en liste af knudepunkter på samme måde som en dir skalkommando.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Deaktivér et stoppunkt
Tabel 3.15. Anvendelse af Disable
| disable (For at deaktivere stoppunktet i det aktuelle knudepunkt) |
| disable <STOPPUNKT_ID> (For at deaktivere stoppunktet med angivet stoppunktsnummer) |
| disable -l <FILENAME> <LINENO> (Deaktivér stoppunkt i angivet fil, på angivet linjenummer) |
| disable -l <URI> <LINENO> (Deaktivér stoppunkt i angivet URI, på angivet linjenummernummer) |
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
Aktivér eller deaktivér et stoppunkt (skifter mellem aktiv/inaktiv)
Genvejsnavn: e
Tabel 3.18. Anvendelse af Enable
| enable (For at aktivere eller deaktivere stoppunktet i det aktuelle knudepunkt) |
| enable <STOPPUNKT_ID> (For at aktivere eller deaktivere stoppunktet med angivet stoppunktsnummer) |
| enable -l <FILENAME> <LINENO> (Aktivér eller deaktivér stoppunkt i angiven fil, på angivet linjenummer) |
| enable -l <URI> <LINENO> (Aktivér eller deaktivér stoppunkt i angiven URI, på angivet linjenummer) |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Udskriv liste med eksterne Generelle fortolkede entiteter der bruges i datafilen (dokument).
Genvejsnavn: ent
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
Udskriv stakrammen ved en given dybde
Genvejsnavn: f
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
Udskriv en liste af globale stilarkvariable eller parametre. Udskriv værdien på en global variabel.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Vis hjælp om kommando eller oversigt
Genvejsnavn: h
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
Udskriv en en liste med lokale stilarks-variable eller parametre. Udskriv værdien på en lokal variabel.
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
Spring over en xsl:kald-skabelon eller xsl:anvendelses-skabeloner. Kommandoen har samme effekt som at indtaste kommandoerne "step" og derefter "up".
Genvejsnavn: n
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
Angiv en lokal, skrivbar fil som skal bruges til udskrivning af resultater.
Genvejsnavn: o
Tabel 3.30. Anvendelse af Output
| output <FILENAME> (Filnavnet på en lokal skrivbar fil, som kan have præfikset "~" på Unix-lignende og CYGWIN platforme, eller miljøvariabler på RISC OS.) |
| output <WEBBADRESS> (<URI> må kun benytte protokollen "file://". Den konverteres sidenhen til et filnavn som passer til operativsystemet) |
| output - (Send til stdout. Skal kun bruges når xsldbgs kommandoprompt benyttes) |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Udskriv værdien som et offentligt ID afbilder via den aktuelle mappe
Genvejsnavn: pub
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
Afslut behandling af stilark så snart som muligt.
Genvejsnavn: q
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
Søg i en database med al information samlet ind fra de indlæste stilark
Alle udskriftsfiler opbevares i værdien på alternativet "searchresultspath" hvis den er angivet, eller samme mappe som det tilhørende stilark. Filen searchresults.xml omdannes normalt af search.xsl, men omdannes ved hjælp af searchhtml. XSL hvis indstillingen "preferhtml" er aktiveret.
Når søgkommandoen udføres, oprettes en XML-fil (searchresults.xml). Derefter kan du behandle filen med dit eget stilark for at præsentere data på andre måder. Hvis indstillingen "preferhtml" ikke er aktiveret, udskrives searchresult.txt på skærmen.
Afhængigt af om mængden af data som indsamles, kan det tage et stykke tid udføre denne kommando.
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
Sæt en indstilling til udførsel af stilark
Du skal bruge kommandoen run for at aktivere ændringer.
Tabel 3.38. Brug af indstil
| indstil <OPTION_NAME> <HELTALS_VÆRDI> | ||||||||||||||||||||||||
| Hvor <OPTION_NAME> kan være en den ene eller den anden | ||||||||||||||||||||||||
|
| ||||||||||||||||||||||||
| Når værdien er sand hvis den ikke er lig med nul | ||||||||||||||||||||||||
| Når værdien er falsk hvis den ikke er lig med nul. | ||||||||||||||||||||||||
| stdout Udskriv alle fejlmeddelelser til stdout. Normalt havner alle fejlmeddelelser på stdout. | ||||||||||||||||||||||||
| setoption <OPTION_NAME> "<STRING_VALUE>" (Må ikke indeholde dobbelte citationstegn i <STRING_VALUE>) | ||||||||||||||||||||||||
| setoption <OPTION_NAME> <STRING_VALUE> (Må hverken indeholde mellemrum eller dobbelte citationstegn i <STRING_VALUE>) | ||||||||||||||||||||||||
| Hvor <OPTION_NAME> kan være en den ene eller den anden | ||||||||||||||||||||||||
|
|
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kør skal-kommando
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Til at vise en liste over skabelon-stoppunkter.
Genvejsnavn: vis
Hvis en tilstand findes i et skabelonstoppunkt vil den blive tilføjet i stoppunktets navns slutning. Et eksempel på udskriften er:
| Stoppunkt 3 aktiveret i skabelonen :"*" i filen test1.xsl : linje 105 |
| Stoppunkt 2 aktiveret i skabelon :"* testMode" i filen test1.xsl : linje 109 |
| Breakpoint 1 enabled for template :"* http://www.w3.org/1999/XSL/Transform:testMode" in file test1.xsl : line 113 |
| Total of 3 breakpoints present |
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
Vis det aktuelle overvågede udtryk
Genvejsnavn: overvågninger
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Skift til visning af aktuel knudepunkt i stilarket, eller udskift stilarket
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
Træd ned i en nyere "kalderamme".
Genvejsnavn: ned
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Gå et trin op til en ældre "kalderamme".
Genvejsnavn: op
Dette er ikke nogen præcis kommando, xsldbg stopper så tæt på som muligt.
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
Udskriv værdien som en systemfil afbilder via den nuværende mappe.
Genvejsnavn: sys
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Udskriv en liste med tilgængelige skabeloner. Søg efter en skabelon
Genvejsnavn: t
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Spor en kørsel af stilarket, udskriv filen og linjerne af mellemliggende trin.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Åbn en terminalemulering. Sæt tty-omdirigeringsniveuaet.
Tabel 3.51. Brug af tty
| tty <DEVICE_PATH> (<DEVICE_PATH> er en gyldig terminal i operativsystemet. Forsøger kun åbne terminalen. | |||||
| tty <TTY-LEVEL> (Sæt tty-omdirigeringsniveauet, hvor <TTY_LEVEL> er et gyldigt inddata/uddata-niveau at bruge.)
|
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Validerer udskriftfilen som oprettes af stilarket (deaktiveret)
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Gå gennem koden i forskellige hastighedsintervaller.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Udskriv en sporing af skabeloner (rammestak) og udskriv arbejdsmappen.
Genvejsnavn: w
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
xsldbg
Program ophavsret 2004 Keith Isdale (k_isdale tpg com au)
Dansk oversættelse Erik Kjær Pedersen (erik AT binghamton.edu)
Dokumentation er udgivet under betingelserne i GNU Free Documentation License.
Dette program er udgivet under betingelserne i GNU General Public License.
Forfatterne til libxml og libxsl.
Johannes Sixt for at hjælpe med tilføjelse af xsldbg-understøttelse til KDbg
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Indholdsfortegnelse
Se kxsldbg-komponenten i kdewebdev modulet KDE's SVN.
xsldbg er en del af KDE-projektet http://www.kde.org/.
xsldbg findes i kdewebdev-pakken på ftp://ftp.kde.org/pub/kde/, hoved FTP-stedet for KDE-projektet.
For at bruge xsldbg ordentligt, skal du have KDE libxslt, libexslt og libxml installeret. Disser er tilgængelige på almindelige KDE-installationer.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
xsldbg er normalt oversat som en del af ksxldbg-komponenten i kdewebdev-modulet
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
xsldbg indstillet med argumenter som skrives på kommandolinjen og dens setoption kommando
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
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team