Het handboek van xsldbg
Copyright © 2002, 2003 Keith Isdale
Het is toegestaan dit document te kopiëren, te verdelen en/of te wijzigen onder de voorwaarden van de GNU vrije-documentatie-licentie, versie 1.1 of een latere versie, gepubliceerd door de Free Software Foundation; zonder invariante paragrafen, zonder vooromslagteksten, en zonder achteromslagteksten. Een kopie van de licentie vindt u hier: de paragraaf "GNU vrije-documentatielicentie".
xsldbg is een hulpmiddel met als doel u te helpen stijlbladen te begrijpen. Het voornaamste verschil met andere stijlblad-debuggers is de mogelijkheid om interessante items te zoeken en om de uitvoering van een stijlblad te volgen.
Inhoudsopgave
Lijst van tabellen
xsldbg is een tekstgebaseerd hulpmiddel voor het debuggen van stijlbladen (de zogenaamde eXtensible Stylesheet Language) en heeft opdrachten die lijken op die van de debugger gdb in Unix/Linux. Er zijn drie belangrijke manieren beschikbaar voor het uitvoeren van stijlbladen.
| Het gehele stijlblad uitvoeren. |
| Naar de volgende xsl-instructie stappen. |
| Doorgaan tot het volgende breekpunt, of het stijlblad opnieuw gestart is. |
Op systemen waar readline beschikbaar is, kunt u de toetsen terug/vooruit om door de geschiedenis van ingevoerde opdrachten te bladeren. Op alle systemen kan de laatst ingevoerde opdrachtherhaald worden door op de toets <ENTER> te drukken.
Als uw besturingssysteem het ondersteunt worden bestandsnamen uitgebreid.
Een aantal opdrachten accepteren meer dan één argument. U kuntaanhalingstekens gebruiken om complexe expressies als één argument te laten gebruiken. Bijvoorbeeld break "* | @" maakt het mogelijk om een breekpunt op het sjabloon met de naam "* | @" te plaatsen.
De volgende tabel beschrijft de termen die in de opdrachtengids gebruikt worden.
| SJABLOONNAAM : Een geldige sjabloonnaam die alleen ASCII-tekens0x00 tot en met 0x7F bevat. Mogelijk een volledig gekwalificeerde naam zoals "xsl:templateName". |
| BESTANDSNAAM : Een geldige bestandsnaam op het lokale systeem van de gebruiker. Het voorvoegsel "~" mag op *nix en CYGWIN gebruikt worden. Onder RISC OS mogen omgevingsvariabelen gebruikt worden. |
| URI : Een 'Uniform Resource Identifier' zoals gedefinieerd door RFC 2396 |
| MODUSNAAM : De sjabloonmodus, kan een volledig gekwalificeerde naam zijn als "xsl:modeName". |
| QNAAM : Een volledig gekwalificeerde naam als "xsl:localPart" |
| REGELNR : Een geldig regelnummer in het bijbehorende bestand <BESTANDSNAAM> |
| AANTAL_FRAMES : Een geldig aantal frames om de huidige positie mee te wijzigen. |
| BREEKPUNT_ID : Een geldig breekpuntnummer. |
| OBSERVATIE_ID : Een geldige observatie-expressie zoals aangegeven door de opdracht showwatch |
| SNELHEID: de snelheid om mee door de code te lopen, getal van 0 tot en met 9 |
| (Commentaar): een opmerking over de betekenis of het gebruik van de opdracht |
| { opt1 | opt2 | opt3 .. enz} : Kies een van de opties. |
| XPAD : Een xpad-selectie van knopen |
| PARAM_ID : Een geldig parameternummer zoals aangegeven door de opdracht showparam |
| PAD : Een pad om de huidige werkmap in te veranderen. Op sommigebesturingssystemen wordt het voorvoegsel "~" vervangen door het pad naar uw persoonlijke map. |
| TEKST : Vrije tekst (geen restricties) |
| OPDRACHT : Een geldige opdracht voor xsdbg |
| QNAAM : Een geldige naam van een variabele of parameter |
| BRON : Het stijlblad dat uitgevoerd wordt of moet worden. Zie <BESTANDSNAAM> en <URI> |
| DATA : De xml-data (document) die door het stijlblad verwerkt wordt of moet worden. Zie <BESTANDSNAAM> en <URI> |
| DEVICE_PAD : Een geldige terminal op het besturingssysteem |
| TTY_NIVEAU : Een geldig invoer-/uitvoer-niveau om te gebruiken |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
| Hulp :help |
| Uitvoering : {bye|exit| quit}, step, stepup, stepdown, next, continue, run, trace, setoption, options |
| Parameters van libxslt : addparam, delparam, showparam, output, setoption, options |
| Sjablonen : templates, where, frame |
| Breekpunten : break, showbreak, delete, enable |
| Expressies bekijken (xpath) : cat |
| Knopen bekijken : ls, dir, du, cat, pwd |
| Variabelen bekijken : globals, locals, cat, addwatch |
| Variabelen zetten : set |
| Knopen selecteren : source, data, cd |
| Zoeken :search |
| Besturingssysteem :chdir, shell, tty |
| Bestanden : output, entities, system, public |
| Uitgeschakelde bestandsopdrachten : validate, load, save, write, 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
Een parameter voor libxslt toevoegen; equivalent aan het meegeven van --param <QNAAM>:<XPAD> op de opdrachtregel.
Een expressie voor observatie toeveogen. Zie showwatch voor het weergeven van waarden.
Afkorting: watch
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
Afbreken in een sjabloon, een bepaalde locatie in een stijlblad of xml-bestand dat geladen is door xsldbg, of de huidige knoop. Nieuw in xsldbg 3.1.4: In gdb-compatibiliteitsmodus kunnen breekpunten op een bepaalde regel in een bestand gezet worden, en later geactiveerd worden.
Afkorting: b
xsldbg probeert de complete URL te raden, gegeven een
| bestandsnaam zonder pad. |
| bestandsnaam in dezelfde map als het "bovenste" geladen stijlblad |
| een bestandsnaam relatief aan de huidige werkmap van xsldbg. |
break -l xsldoc.xsl 26
Deze opdracht werkt met gedeeltelijke of gehele QNAAM-sjablonen en/of modi. Bijvoorbeeld "template" komt overeen met elke QNAAM waarvan het lokale deel "template" is.
Een namespace in de opgegeven QNAAM wordt uitgebreid zoals opgegeven in de namespaces die gedefinieerd zijn in het XSL-bronbestand, bijvoorbeeld "xsl:test1" wordt uitgebreid naar "http://www.w3.org/199/XSL/Transform:test1".
Een opgevraagd breekpunt moet mogelijk verwerkt worden om de URL en het regelnummer te verkrijgen. Dit wordt automatisch gedaan nadat het eerste sjabloon ingeladen is door xsldbg. Breekpunten worden kort na de start van elke uitvoering opnieuw gevalideerd.
Automatische validatie van breekpunten wordt gedaan als gdb-modus ingeschakeld is - de standaardinstelling van xsldbg.
Tabel 3.4. Gebruik van break
| break -l <BESTANDSNAAM> <REGELNR> (Om een breekpunt op een bepaalde regel in het opgegeven bestand te zetten) |
| break -l <URI> <REGELNR> (Om een breekpunt op een bepaalde regel in de opgegeven URI te zetten) |
| break <SJABLOONNAAM> (Afbreken op een opgegeven of overeenkomend sjabloon.) |
| break <SJABLOONNAAM> <MODUSNAAM> (Afbreken op het opgegeven sjabloon met een bepaalde modus.) > |
| break "" <MODUSNAAM> (Afbreken op elk sjabloon met de opgegeven modus.) |
| break * (Afbreken op elk sjabloon.) |
| break \* (Afbreken op het sjabloon "*". Een andere naam die '*' bevat wordt niet speciaal behandeld.) |
| break (Afbreken op de huidige knoop - inclusief xml data-knopen!) |
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
Het resultaat van een xpath-expressie op een knoop relatief aan de huidige weergeven.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Naar een pad overschakelen dat gespecificeerd door een xpath.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Van huidige werkmap veranderen.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Doorgaan met het uitvoeren van het stijlblad en stoppen op het eerstvolgende tegengekomen breekpunt.
Afkorting: c
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Overschakelen naar weergave van de huidige knoop als xml-data. Of de gebruikte xml-data veranderen.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Een sjabloonbreekpunt verwijderen.
Afkorting: d
Tabel 3.11. Gebruik van delete
| delete (Een breekpunt op de huidige knoop verwijderen.) |
| delete <BREEKPUNT_ID> (Een breekpunt op de opgegeven plaats verwijderen.) |
| delete -l <BESTANDSNAAM> <REGELNR> (Breekpunt op de opgegeven regel van een bestand verwijderen.) |
| delete -l <URI> <REGELNR> (Breekpunt op de opgegeven regel van een URI verwijderen.) |
| delete <TEMMPLATENAME> (Breekpunt bij het opgegeven sjabloon verwijderen.) |
| delete * (Alle breekpunten verwijderen.) |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Een parameter voor libxslt verwijderen
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Een geobserveerde expressie verwijderen of alle expressies verwijderen zoals ze door de opdracht "showwatch" getoond worden.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Een lijst van knopen weergeven op een soortgelijke manier als de shell-opdracht dir.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Een breekpunt uitschakelen
Tabel 3.15. Gebruik van disable
| disable (Het breekpunt op de huidige knoop verwijderen) |
| disable <BREEKPUNT_ID> (Breekpunt met het opgegeven nummer verwijderen) |
| disable -l <BESTANDSNAAM> <REGELNR> (Breekpunt op de opgegeven regel in een bestand verwijderen) |
| disable -l <URI> <REGELNR> (Breekpunt op de opgegeven regel in een URI verwijderen) |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Een samenvatting van subknopen in een boomstructuur-formaat weergeven.
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
Een breekpunt in- of uitschakelen (enable/disable omschakelen)
Afkorting: e
Tabel 3.18. Gebruik van enable
| enable (Breekpunt op de huidige knoop in-/uitschakelen) |
| enable <BREEKPUNT_ID> (Opgegeven breekpunt in-/uitschakelen) |
| enable -l <BESTANDSNAAM> <REGELNR> (Breekpunt op de opgegeven regel in een bestand in-/uitschakelen) |
| enable -l <URI> <REGELNR> (Breekpunt op de opgegeven regel in een URI in-/uitschakelen) |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Een lijst weergeven van de externe algemeen ingelezen entiteiten die aanwezig zijn in het databestand (document).
Afkorting: 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
Het stackframe op een bepaalde diepte weergeven
Afkorting: 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
Een lijst weergeven van de globale stijlblad-variabelen of -parameters. De waarde van een globale variabele weergeven.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Een overzicht of hulp over een opdracht weergeven
Afkorting: 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
Een lijst van lokale stijlblad-variabelen of -parameters weergeven. De waarde van een lokale variabele weergeven.
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
Een xsl:call-template of xsl:apply-templates overslaan. Deze opdracht heeft hetzelfde effect als de opdracht "step" gevolgd door "up".
Afkorting: 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
Een lokaal beschrijfbaar bestand opgeven om uitvoer van resultaten in op te slaan.
Afkorting: o
Tabel 3.30. Gebruik van output
| output <BESTANDSNAAM> (Een lokaal, beschrijfbaar bestand. Het voorvoegsel "~" kan in *nix en CYGWIN gebruikt worden, net als omgevingsvariabelen onde RISC OS.) |
| output <URI> (De <URI> mag alleen het protocol "file://" gebruiken. Deze wordt vervolgens omgezet in een geschikte bestandsnaam voor het besturingssysteem.) |
| output - (Naar standaarduitvoer schrijven. Alleen gebruiken als u met de opdrachtregel van xsldbgwerkt.) |
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
De waarde waarnaar een publieke ID verwijst weergeven.
Afkorting: 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
Uitvoering van het stijlblad zo snel mogelijk stoppen.
Afkorting: 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
Een databank met alle informatie doorzoeken die uit de geladen stijlbladen gehaald is.
Alle uitvoerbestanden worden opgeslagen in de waarde van de optie "searchresultspath" als die een waarde heeft, of in dezelfde map als het stijlblad zich in bevindt. searchresults.xml wordt normaliter verwerkt door search.xsl, maar wordt door searchhtml.xsl verwerkt als de optie "preferhtml" aan staat.
Als de opdracht search uitgevoerd wordt, wordt een xml-bestand (searchresults.xml) aangemaakt. U kunt dit bestand dan met uw eigen stijlblad verwerken om de gegevens op andere manieren weer te geven. Als de optie "preferhtml" niet aan staat, wordt searchresult.txt op het scherm weergegeven.
Afhankelijk van de hoeveelheid data die verzameld is, duurt het een tijd om deze opdracht uit te voeren.
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
Een optie voor de uitvoering van het stijlblad instellen
U zult de opdracht run moeten gebruiken om de wijzigingen door te voeren.
Tabel 3.38. Gebruik van setoption
| setoption <OPTION_NAME> <INTEGER_VALUE> | ||||||||||||||||||||||||
| <OPTION_NAME> kan zijn: | ||||||||||||||||||||||||
|
| ||||||||||||||||||||||||
| Waarbij de waarde waar is als deze NIET gelijk aan 0 is. | ||||||||||||||||||||||||
| En waarbij de waarde niet waar is als deze WEL gelijk aan 0 is. | ||||||||||||||||||||||||
| stdout Alle foutmeldingen op standaarduitvoer in plaats van standaardfoutuitvoer weergeven. | ||||||||||||||||||||||||
| setoption <OPTION_NAME> "<STRING_VALUE>" (<STRING_VALUE> mag geen dubbele aanhalingstekens bevatten) | ||||||||||||||||||||||||
| setoption <OPTION_NAME> <STRING_VALUE> (<STRING_VALUE> mag geen spaties of dubbele aanhalingstekens bevatten) | ||||||||||||||||||||||||
| <OPTION_NAME> kan zijn: | ||||||||||||||||||||||||
|
|
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Een shell-opdracht uitvoeren
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Een lijst van sjabloonbreekpunten weergeven.
Afkorting: show
Als er een modus op een sjabloonbreekpunt beschikbaar is wordt deze toegevoegd aan het einde van de sjabloonnaam voor het breekpunt. Voorbeelduitvoer:
| Breakpoint 3 enabled for template :"*" in file test1.xsl : line 105 |
| Breakpoint 2 enabled for template :"* testMode" in file test1.xsl : line 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
De huidige geobserveerde expressie weergeven
Afkorting: watches
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
De huidige knoop in het stijlblad weergeven. Of een anderstijlblad gebruiken.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Stappen tot de volgende instructie in het stijlblad.
Afkorting: s
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Naar beneden stappen, naar een nieuwer "aanroepframe"
Afkorting: down
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Omhoog stappen naar een ouder "aanroepframe"
Afkorting: up
Dit is geen nauwkeurige opdracht, xsldbg zal zo dichtbij mogelijk stoppen.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Een lijst van geladen stijlbladen weergeven
Afkorting: style
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
De waarde waarnaar een systeembestand verwijst weergeven
Afkorting: sys
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Een lijst van beschikbare sjablonen weergeven of naar een sjabloon zoeken
Afkorting: t
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Een uitvoering van het stijlblad nalopen en het bestand en tussenliggende stappen weergeven.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Een terminal openen. Het niveau van tty-doorsluizing instellen.
Tabel 3.51. Gebruik van tty
| tty <DEVICE_PAD> ( <DEVICE_PAD> is een geldige terminal op het besturingssysteem. Probeert de terminal te openen.) | |||||
| tty <TTY_NIVEAU> (Het niveau van tty- doorsluizing instellen, waarbij <TTY_NIVEAU> een geldig invoer-/ uitvoerniveau is.)
|
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Het uitvoerbestand van het stijlblad valideren (Uitgeschakeld)
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Door de code lopen op een aantal snelheden
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Een spoor van sjabloonaanroepen weergeven (framestack) en de huidige werkmap weergeven
Afkorting: 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
Programma copyright 2004 Keith Isdale (k_isdale tpg com au)
Op- of aanmerkingen over de vertalingen van de toepassing en haar documentatie kunt u melden op http://www.kde.nl/bugs.
Dit document is vertaald in het Nederlands door Alexander S. Koning.
Deze documentatie valt onder de bepalingen van de GNU vrije-documentatie-licentie.
Deze toepassing valt onder de bepalingen van de GNU General Public License.
De auteurs van libxml en libxsl.
Johannes Sixt voor hulp met het toevoegen van ondersteuning voor xsldbg aan KDbg
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Zie de component kxsldbg in de module kdewebdev in een nabije KDE cvs.
xsldbg is een onderdeel van het KDE-project http://www.kde.org/.
xsldbg is een onderdeel van de module kdewebdev. Deze module kunt u vinden op de FTP-site van het KDE-project: ftp://ftp.kde.org/pub/kde/.
Om xsldbg goed te kunnen gebruiken heeft u KDE libxslt, libexslt en libxml nodig, die op een standaard KDE-installatie aanwezig zijn.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
xsldbg wordt normaal gesproken gecompileerd als deel van de component kxsldbg in de module kdewebdev
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
xsldbg wordt ingesteld door middel van argumenten op de opdrachtregel en het commando setoption
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