Autoriõigus © 2002, 2003, 2004 Keith Isdale
Käesolevat dokumenti võib kopeerida, edasi levitada ja/või muuta vastavalt GNU Vaba Dokumentatsiooni Litsentsi tingimustele, nagu need on avaldanud Vaba Tarkvara Fond; kas Litsentsi versioon 1.1 või ükskõik milline hilisem versioon; kaasa arvatud mittemuudetavad sektsioonid (puudub), esikaane tekstid (puudub), ja tagakaane tekstid (puudub). Litsentsi koopiaga võimaldab tutvuda sektsioon "GNU Vaba Dokumentatsiooni Litsents".
KXSLDbg kujutab endast xsldbg graafilist kasutajaliidest, mis toetab XSLT skriptide silumist.
Sisukord
KXSLDbg abil saab tarvitada enamikku xsldbg käske, mis teeb võimalikuks
Katkestuspunktide määramise ja muutmise
XPath-ide väärtuse näitamise
Info näitamise leitud mallide, muutujate, väljakutsete pinu, laaditabelite ja olemite kohta
Katkestuspunktide ja muutujate määramise ja muutmise
XSL allika ja XML dokumendi liigutamise XPath-i abil
PUBLIC ja SYSTEM ID otsimise parajasti aktiivses XML kataloogis
KXSLDbg suudab nüüd
määrata ja muuta muutujaid
renderdada teksti peaaknas Kate teeke ära kasutades
Seadistamise käivitab menüükäsk ->.
Seadistustedialoog.
Laaditabeli kasutamiseks tuleb määrata:
XSL allikas
XML andmed
Väljundfail
Nupp võimaldab valida vajaliku faili. Väljad XSL allikas ja >XML andmed võivad viidata URI-le, milles võib esineda http://, ftp:// või file://. Väljundfail peab kindlasti olema kirjutamisõigusega kohalik fail.
Asja näitlikustamiseks valime nüüd järgmised failid kataloogis <KDE PREFIX>/share/apps/kxsldbg
:
XSL allikas: testdoc.xsl
XML andmed: testdoc.xml
Väljundfail: /tmp/xsldbg_output.txt
Valikud võimaldab valida null või enam võtit. Iga võtme juures võid näha kohtspikrit, mis kirjeldab selle toimet.
Dialoogi sektsioonis Libxslt parameetrid saab lisada null või enam parameetrit. See lubab pakkuda laaditabelile parameetrite väärtusi.
Näiteks võid sisestada Parameetri nimena myparam
, anda Parameetri väärtuseks 'Tere, maailm!'
ning klõpsata nupule . Olemasoleva parameetri värskendamiseks liigu lihtsalt vajalikule väärtusele nuppudega või , anna uus Parameetri väärtus ning klõpsa nupule .
Tekstivaade aktiivse faili silumisel.
Iga katkestuspunkti olekut näitab vastav tekst ning erinev taustavärv. Sul on võimalik värvid ise määrata: vaata dialoogi -> kaarti Värvid.
Katkestuspunkti saab seada/keelata/kustutada klahvidega, menüüst või tööriistariba nuppudega.
Kursorit saab tekstis liigutada järgmiste klahvidega:
Nooleklahvid: Nool vasakule, Nool paremale, Nool üles või Nool alla. |
Leheküljeklahvid: Page Up või Page Down |
Enamik KXSLDbg väljundist haaratakse ja näidatakse kas inspektorite dialoogis või KXSLDbg väljundiaknas. Erandiks on:
KXSLDbg veateadet näidatakse teatedialoogis.
Avaldise hindamise tulemust näidatakse teatedialoogis.
Otsingutulemus saadetakse KXSLDbg väljundiaknas osutatud failile.
Põhiliselt saab katkestuspunktidega tegelda peaaknas. Vaata “Peaakna kasutamine”
Kui laaditabel on käivitatud, saab kasutada menüükäsku ->. Seejärel klõpsa katkestuspunktide kaardile, mida näitame allpool.
Katkestuspunkti saab lisada, kui anda:
fail ja reanumber
malli nimi
malli nimi ja režiimi nimi
režiimi nimi
Ja seejärel klõpsata nupule .
Faili nimi võib olla kohaliku faili absoluutne asukoht või ka osaline fail (nt. xsldoc.xsl
).
Malli või režiimi nimi on täielikult kvalifitseeritud nimi, kus mittelokaalne osa pole kohustuslik, nt. xsl:mytemplate korral on sobivuseks mytemplate
Esmalt klõpsa katkestuspunktide nimekirjas katkestuspunktile, mida soovid kustutada, ning seejärel nupule .
Kui inspektori dialoogi ei ole näha, kasuta menüükäsku ->.
Kohalikud ja globaalsed muutujad on näha inspektoridialoogi kaardil. Järgnev näide kujutab endast XSLT koodi lõiku, mis deklareerib globaalse ja kohaliku muutuja.
<xsl:variable name="globalvariable" select="'foo'"/> <xsl:template match="/"/> <xsl:param name="localvariable" select="'bar'"/> </xsl:template match="/"/>
Hiirega mõnel nimekirja muutujal klõpsates näeb selle kokkuvõtlikku infot dialoogi allosas. Kui muutujas esineb avaldis, näiteks
<xsl:variable name="changeable" select="'oldValue'" />
siis saab valida uue XPathi, sisestades uue muutuja avaldise ning klõpsates nupule .
Muutujate kaart
Klõps nimekirjas oleval muutujakirjel põhjustab kursori liikumise peaaknas osutatud failile ja reanumbrile.
Siin on ära toodud kõik väljakutsete pinu elemendid. Mida vanem on väljakutsete pinu kirje, seda väiksem on tema raami number. Vaata allpool toodud näidet.
Klõps nimekirjas oleval väljakutsete pinu kirjel viib kursori peaaknas osutatud faili ja reanumbrile.
Kui inspektori dialoogi ei ole näha, kasuta menüükäsku ->. Mallide kasutamiseks klõpsa dialoogis vastavale kaardile.
Siin on ära toodud kõik mallid. Palun arvesta, et kehtivad XSLT ekspordireeglid, nii et nimekirjas võib olla enam kui üks mall ühesuguste sobivuste ja režiimiga.
Klõps nimekirjas oleval mallikirjel põhjustab kursori liikumise peaaknas osutatud faili ja reanumbrile.
Kui inspektori dialoogi ei ole näha, kasuta menüükäsku ->. Allikafailide kasutamiseks klõpsa dialoogis vastavale kaardile.
Siin on näha kõik XSLT faili või mõnesse selle järglasse kaasatud XSLT allikafailid.
Klõps nimekirjas oleval allikafaili kirjel põhjustab kursori liikumise peaaknas osutatud faili algusse.
Kui inspektori dialoogi ei ole näha, kasuta menüükäsku ->. Olemite kasutamiseks klõpsa dialoogis kaardile Olemid.
Siin on ära toodud kõik andmefaili või selle järglaste kaudu teada olevad välised XML olemid. Antud näites olen lasknud KXSLDbg-l faili testdoc.xsl
analüüsida failiga testdoc.xml
(need leiab kataloogist <KDE PREFIX>/share/apps/kxsldbg
), mis pakub mõningaid olemeid.
Klõps nimekirjas oleval olemi kirjel põhjustab kursori liikumise peaaknas osutatud faili algusse.
Tööriistade menüü pakub mitmesuguseid tööriistu, millest peamine on inspekteerimisvahend.
Inspektor sisaldab mitmeid kaarte:
Katkestuspunktid
Mallid
Muutujad
Väljakutsete pinu kirjed
XSL allikafailid
XML olemid
Menüükäsu valimisel ilmub dialoog, kus saab valida läbimise kiiruse.
Läbimise peatamiseks kasuta klahvi W või vali menüükäsk .
KXSLDbg (c) 2004: Keith Isdale
Dokumentatsiooni (c) 2004: Keith Isdale
Tänud:
libxml ja libxslt autorid.
Robert Jacolin tagasiside eest KXSLDbg varaste versioonide kohta.
Igor Zlatkovic libxml/xslt ja xsldbg WIN32 binaarfailide loomise eest.
Käesolev dokumentatsioon on litsenseeritud vastavalt GNU Vaba Dokumentatsiooni Litsentsi tingimustele.
Käesolev programm on litsenseeritud vastavalt GNU Üldise Avaliku Litsentsi tingimustele.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team