Handboek van KXSLDbg. Keith Isdale Vertaler/Nalezer: Tom Albers Vertaler/Nalezer: Freek de Kruijf

Transcriptie

1 Keith Isdale Vertaler/Nalezer: Tom Albers Vertaler/Nalezer: Freek de Kruijf

2 2

3 Inhoudsopgave 1 Inleiding Mogelijkheden KXSLDbg gebruiken Een KXSLDbg-sessie instellen Hoe te beginnen Met opties werken Met parameters werken Wijzigingen toepassen Het hoofdvenster gebruiken Met het hoofdvenster werken Met de uitvoer van KXSLDbg werken Breekpunten instellen en wijzigen Een breekpunt toevoegen Details bij argumenten Een breekpunt verwijderen Alle breekpunten verwijderen Een breekpunt in- of uitschakelen Met variabelen werken Met de aanroepstapel werken Met sjablonen werken Met XSLT-bronbestanden (bronnen) werken Met XML-databestanden (entiteiten) werken Diversen Het Inspectorhulpmiddel Uitvoeren door lopen XML-entiteiten opzoeken Dankbetuigingen en licentie 16

4 Samenvatting KXSLDbg biedt een grafische interface als frontend voor xsldbg, waarmee u XSLT-scripts kunt debuggen.

5 Hoofdstuk 1 Inleiding 1.1 Mogelijkheden Met KXSLDbg kunt u het merendeel van de opdrachten van xsldbg gebruiken om Breekpunten te zetten en te wijzigen De waarde van XPaden weer te geven Informatie over de aanwezige sjablonen, variabelen, aanroepstapel, stijlbladen en entiteiten weer te geven Breekpunten en variabelen te zetten en te wijzigen Door XSL-bronnen en XML-documenten te bladeren met XPaden PUBLIC- en SYSTEM-ID s in de huidige XML-catalogus op te zoeken Variabelen instellen en veranderen De tekst in het hoofdvenster weergeven met behulp van de Kate-bibliotheek 5

6 Hoofdstuk 2 KXSLDbg gebruiken 2.1 Een KXSLDbg-sessie instellen U start het instellen met Debuggen Instellen in de menubalk. Het dialoogvenster Instellen Hoe te beginnen Om een stijlblad uit te kunnen voeren moet u het volgende opgeven: het XSL-bronbestand het XML-databestand Uitvoerbestand 6

7 Met de knop... kunt u het gewenste bestand kiezen. XSL-bron en XML-data mogen verwijzen naar een URI met ftp:// of file://. Het Uitvoerbestand moet een lokaal beschrijfbaar bestand zijn. Om de voorbeelden te volgen, kiest u de volgende bestanden in de voorbeeldmap <KDE-MAP>/sh are/apps/kxsldbg: XSL-bron: testdoc.xsl XML-data: testdoc.xml Uitvoerbestand: /tmp/xsldbg_output.txt Met opties werken U kunt opties kiezen uit de sectie Opties. Elke optie heeft een ballontekst die u informatie geeft over het effect van die optie Met parameters werken U kunt parameters toevoegen via de sectie LibXSLT-parameters. Hiermee kunt u parameterwaarden aan het stijlblad meegeven. U kunt bijvoorbeeld op de knop Toevoegen klikken en een parameter Name invoeren van mypar am met een parameter Waarde van Hallo World!. Om de naam of waarde van een bestaande parameter bij te werken kies het dan met de linkermuisknop Wijzigingen toepassen Als u wilt dat de wijzigingen in werking treden, moet u de knop OK kiezen en de dialoog te sluiten. Om wijzigingen ongedaan te maken kiest u de knop Annuleren. Als u de instellingen weer wilt wijzigen opent u het instellingenvenster als hiervoor. 7

8 2.2 Het hoofdvenster gebruiken Een tekstweergave van het bestand dat gedebugd wordt Met het hoofdvenster werken De status van een bepaald breekpunt wordt aangegeven met de bijbehorende tekst en een achtergrondkleur. U kunt de gewenste kleuren instellen: zie de pagina Kleuren in het dialoogvenster Instellingen Editor instellen. U kunt een breekpunt zetten, uitschakelen of verwijderen met toetsen, het menu Debuggen of de knoppen op de werkbalk. U kunt de cursor door de tekst verplaatsen met de volgende toetsen: Pijltoetsen: Links, Rechts, Omhoog of Omlaag. Paginatoetsen: Page Up en Page Down Met de uitvoer van KXSLDbg werken De meeste uitvoer van KXSLDbg wordt opgevangen en weergegeven in het inspector-dialoog of het uitvoervenster van KXSLDbg. Uitzonderingen hierop zijn: Een foutmelding van KXSLDbg wordt weergegeven in een meldingsvenster. Het resultaat van een geëvalueerde expressie wordt weergegeven in een meldingsvenster. Het resultaat wordt naar het bestand gestuurd dat in het uitvoervenster van KXSLDbg wordt aangegeven. 8

9 2.3 Breekpunten instellen en wijzigen De belangrijkste manier om met breekpunten te werken is via het hoofdvenster. Zie Section 2.2 Nadat u het stijlblad gestart hebt, kunt u het menu-item Debug Inspecteren... kiezen. Klik daarna op het tabblad Breekpunten. Zie hieronder voor een voorbeeld Een breekpunt toevoegen U kunt een breekpunt toevoegen door een van onderstaande op te geven: 1. een bestand en een regelnummer 2. een sjabloonnaam 3. een sjabloonnaam en een modusnaam 4. een modusnaam En dan op de knop Toevoegen te klikken Details bij argumenten Een bestandsnaam mag een absoluut pad naar een lokaal bestand zijn, of een gedeeltelijke naam (bijv. xsldoc.xsl). Een sjabloon- of modusnaam is een gekwalificeerde naam (QName) waarbij het niet-lokale deel optioneel is bijv. xsl:mijnsjabloon klopt met mijnsjabloon Een breekpunt verwijderen Klik eerst met de linkermuisknop op het breekpunt dat u wilt verwijderen. Klik dan op de knop Verwijderen. 9

10 2.3.4 Alle breekpunten verwijderen Klik op de knop Alle verwijderen Een breekpunt in- of uitschakelen Klik eerst met de linkermuisknop op het breekpunt dat u wilt inschakelen. Klik dan op de knop Inschakelen. 2.4 Met variabelen werken Als het dialoogvenster van de inspector niet zichtbaar is, kiest u het menu-item Debug Inspecteren... Lokale en globale variabelen worden in een tab op het dialoogvenster getoond. Het volgende voorbeeld laat een XSLT-codesegment zien dat een globale en een lokale variabele declareert. <xsl: variable name =" globalvariable " select =" foo "/> <xsl: template match ="/"/ > <xsl:param name =" localvariable " select =" bar "/> </xsl: template match ="/"/ > Als u met de muis op een variabele klikt wordt er informatie over die variabele getoond onderaan het dialoogvenster. Als een variabele een select-expressie heeft, bijvoorbeeld <xsl: variable name =" changeable " select =" oldvalue " /> dan kan een nieuw XPad gekozen worden door een nieuwe waarde in te voeren bij Variabeleexpressie en vervolgens de knop Expressie instellen te kiezen. Het tabblad Variabelen 10

11 Als u op een variabele in de lijst klikt wordt de cursor in het hoofdvenster verplaatst naar het aangegeven bestand en regelnummer. 2.5 Met de aanroepstapel werken Alle items op de aanroepstapel worden hier weergegeven. Hoe ouder het item op de aanroepstapel, hoe lager het framenummer. Zie hieronder voor een voorbeeld. Als u op een item van de aanroepstapel klikt wordt de cursor in het hoofdvenster verplaatst naar het aangegeven bestand en regelnummer. 2.6 Met sjablonen werken Als het dialoogvenster van de inspector niet zichtbaar is, kies dan het menu-item Debug Inspecteren... Om met sjablonen te werken klikt u op het tabblad Sjablonen van het venster. Alle gevonden sjablonen worden hier weergegeven. Let u erop dat de exporteerregels van XSLT gelden. Dus er mag niet meer dan één sjabloon met dezelfde overeenkomst- en modusdetails zijn. 11

12 Als u op een sjabloon in de lijst klikt wordt de cursor in het hoofdvenster verplaatst naar het aangegeven bestand en regelnummer. 2.7 Met XSLT-bronbestanden (bronnen) werken Als het dialoogvenster van de inspector niet zichtbaar is, kiest u het menu-item Debug Inspecteren... U kunt met bronnen werken door dit aan te geven op het tabblad Bronnen van het getoonde venster. Alle XSLT-bronbestanden die worden meegenomen door het XSLT-bestand of één van de nevenliggende bestanden worden hier weergegeven. 12

13 Als u op een bron in de lijst klikt, wordt de cursor in het hoofdvenster verplaatst naar het begin van het aangegeven bestand. 2.8 Met XML-databestanden (entiteiten) werken Als de inspectiedialoog is niet wordt getoond gebruik dan het menu-item Debug Inspecteren... Om met items te werken klik op het tabblad Entiteiten van de getoonde dialoog. Alle externe XML-entiteiten die ingevoegd zijn via het DATA-bestand of een van de nevenliggende bestanden worden hier weergegeven. Voor dit voorbeeld is KXSLDbg uitgevoerd op test doc.xsl met testdoc.xml (uit <KDEMAP>/share/apps/kxsldbg) opdat u wat entiteiten kunt zien. 13

14 Als u op een entiteit in de lijst klikt wordt de cursor in het hoofdvenster verplaatst naar het begin van het aangegeven bestand. 2.9 Diversen Er zijn diverse hulpmiddelen beschikbaar via het menu Debug. Het belangrijkste hulpmiddel is de inspector Het Inspectorhulpmiddel De inspector is het hulpmiddel dat alle dialoogvensters bevat voor: Breekpunten Sjablonen Variabelen Items op de aanroepstapel XSL-bronbestanden XML-entiteiten Uitvoeren door lopen Door op Door stijlblad lopen... te klikken in het menu Debug wordt een dialoog getoond om de loopsnelheid te kiezen. 14

15 Om te stoppen met lopen kunt u de toets K gebruiken of het menu-item Stoppen met lopen door het stijlblad kiezen XML-entiteiten opzoeken Om een System-ID in de huidige XML-catalogus op te zoeken, kiest u System-ID opzoeken en voert u de te zoeken waarde in in het dialoogvenster. Om een PUBLIC-ID op te zoeken kiest u Public-ID opzoeken en voert u de op te zoeken waarde in in het dialoogvenster. 15

16 Hoofdstuk 3 Dankbetuigingen en licentie KXSLDbg (c) 2004 Keith Isdale Documentatie (c) 2004 Keith Isdale MET DANK AAN: De auteurs van libxml en libxslt. Robert Jacolin voor terugkoppeling over eerdere versies van KXSLDbg. Igor Zlatkovic voor het maken van WIN32-applicaties van libxml/xslt en xsldbg. Op- of aanmerkingen over de vertalingen van de toepassing en haar documentatie kunt u melden op Dit document is vertaald in het Nederlands door Tom Albers tomalbers@kde.nl. Dit document is vertaald in het Nederlands door Freek de Kruijf freekdekruijf@kde.nl. Deze documentatie valt onder de bepalingen van de GNU vrije-documentatie-licentie. Deze toepassing valt onder de bepalingen van de GNU General Public License. 16