KXSLDbg käsiraamat
KXSLDbg käsiraamat
Järgmine

KXSLDbg käsiraamat

Keith Isdale

Tõlge eesti keelde: Marek Laane
Versioon 0.5 (2004-11-18)

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.


Peatükk 1. Sissejuhatus
Sissejuhatus
Eelmine
Järgmine

Peatükk 1. Sissejuhatus

Võimalused

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

Uuemad omadused
Uuemad omadused

Uuemad omadused

KXSLDbg suudab nüüd

  • määrata ja muuta muutujaid

  • renderdada teksti peaaknas Kate teeke ära kasutades



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Eelmine
Järgmine
Esileht


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Peatükk 2. kxsldbg; kasutamine
kxsldbg; kasutamine
Eelmine
Järgmine

Peatükk 2. kxsldbg; kasutamine

KXSLDbg seansi seadistamine

Keith Isdale

Tõlge eesti keelde: Marek Laane

Seadistamise käivitab menüükäsk Silumine->Seadista.


Seadistustedialoog

Seadistustedialoog.


Alustamine

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

Valikute kasutamine

Valikud võimaldab valida null või enam võtit. Iga võtme juures võid näha kohtspikrit, mis kirjeldab selle toimet.

Parameetrite kasutamine

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 Lisa. Olemasoleva parameetri värskendamiseks liigu lihtsalt vajalikule väärtusele nuppudega Eelmine või Järgmine, anna uus Parameetri väärtus ning klõpsa nupule Rakenda.

Muudatuste rakendamine

Kui soovid, et tehtud muudatused ellu rakendataks, klõpsa nupule Rakenda. Muudatuste ignoreerimiseks klõpsa nupule Loobu.

Dialoogi saab sulgeda akna ülal paremal nurgas asuvat ikooni X kasutades. Kui tahad seadistust muuta, ava lihtsalt seadistustedialoog uuesti (seda kirjeldasime eespool).

Peaakna kasutamine
Peaakna kasutamine

Peaakna kasutamine

Keith Isdale

Tõlge eesti keelde: Marek Laane

Tekstivaade aktiivse faili silumisel

Tekstivaade aktiivse faili silumisel.


Töö peaaknas

Iga katkestuspunkti olekut näitab vastav tekst ning erinev taustavärv. Sul on võimalik värvid ise määrata: vaata dialoogi Seadistused->Redaktori seadistamine kaarti Värvid.

Katkestuspunkti saab seada/keelata/kustutada klahvidega, menüüst Silumine 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

KXSLDbg väljundi kasutamine

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.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Katkestuspunktide seadmine ja muutmine
Katkestuspunktide seadmine ja muutmine

Katkestuspunktide seadmine ja muutmine

Keith Isdale

Tõlge eesti keelde: Marek Laane

Põhiliselt saab katkestuspunktidega tegelda peaaknas. Vaata “Peaakna kasutamine”

Kui laaditabel on käivitatud, saab kasutada menüükäsku Tööriistad->Näita inspektoreid. Seejärel klõpsa katkestuspunktide kaardile, mida näitame allpool.


Katkestuspunktide määramine

Katkestuspunkti lisamine

Katkestuspunkti saab lisada, kui anda:

  1. fail ja reanumber

  2. malli nimi

  3. malli nimi ja režiimi nimi

  4. režiimi nimi

Ja seejärel klõpsata nupule Lisa.

Argumendi üksikasjad

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

Katkestuspunkti kustutamine

Esmalt klõpsa katkestuspunktide nimekirjas katkestuspunktile, mida soovid kustutada, ning seejärel nupule Kustuta.

Kõigi katkestuspunktide kustutamine

Klõpsa nupule Kustuta kõik.

Katkestuspunkti lubamine või keelamine

Esmalt klõpsa katkestuspunktide nimekirjas hiire vasak nuppga katkestuspunktile, mida soovid muuta, ning seejärel nupule Luba.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Muutujate kasutamine
Muutujate kasutamine

Muutujate kasutamine

Keith Isdale

Tõlge eesti keelde: Marek Laane

Kui inspektori dialoogi ei ole näha, kasuta menüükäsku Tööriistad->Näita inspektoreid.

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 Määra avaldis.


Muutujate kaart

Muutujate kaart


Klõps nimekirjas oleval muutujakirjel põhjustab kursori liikumise peaaknas osutatud failile ja reanumbrile.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Väljakutsete pinu kasutamine
Väljakutsete pinu kasutamine

Väljakutsete pinu kasutamine

Keith Isdale

Tõlge eesti keelde: Marek Laane

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.


Väljakutsete pinu aken

Klõps nimekirjas oleval väljakutsete pinu kirjel viib kursori peaaknas osutatud faili ja reanumbrile.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Mallide kasutamine
Mallide kasutamine

Mallide kasutamine

Kui inspektori dialoogi ei ole näha, kasuta menüükäsku Tööriistad->Näita inspektoreid. 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.


Mallide aken

Klõps nimekirjas oleval mallikirjel põhjustab kursori liikumise peaaknas osutatud faili ja reanumbrile.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

XSLT allikafailide (lähteteksti) kasutamine
XSLT allikafailide (lähteteksti) kasutamine

XSLT allikafailide (lähteteksti) kasutamine

Keith Isdale

Tõlge eesti keelde: Marek Laane

Kui inspektori dialoogi ei ole näha, kasuta menüükäsku Tööriistad->Näita inspektoreid. 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.


Allikafailide aken

Klõps nimekirjas oleval allikafaili kirjel põhjustab kursori liikumise peaaknas osutatud faili algusse.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

XML andmefailide (olemite) kasutamine
XML andmefailide (olemite) kasutamine

XML andmefailide (olemite) kasutamine

Keith Isdale

Tõlge eesti keelde: Marek Laane

Kui inspektori dialoogi ei ole näha, kasuta menüükäsku Tööriistad->Näita inspektoreid. 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.


Olemite aken

Klõps nimekirjas oleval olemi kirjel põhjustab kursori liikumise peaaknas osutatud faili algusse.



Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Mitmesugused tööriistad
Mitmesugused tööriistad

Mitmesugused tööriistad

Keith Isdale

Tõlge eesti keelde: Marek Laane

Tööriistade menüü pakub mitmesuguseid tööriistu, millest peamine on inspekteerimisvahend.

Inspekteerimisvahend

Inspektor sisaldab mitmeid kaarte:

  • Katkestuspunktid

  • Mallid

  • Muutujad

  • Väljakutsete pinu kirjed

  • XSL allikafailid

  • XML olemid

Laaditabeli läbimine

Menüükäsu Alusta laaditabeli läbimist valimisel ilmub dialoog, kus saab valida läbimise kiiruse.


Läbimise aken

Läbimise peatamiseks kasuta klahvi W või vali menüükäsk Lõpeta laaditabeli läbimine.

XML olemite otsimine

System ID otsimiseks aktiivses XML kataloogis kasuta menüükäsku System ID otsing ning sisesta siis ilmuvas dialoogis väärtus, mida soovid leida.


System ID aken

Public ID otsimiseks kasuta menüükäsku Public ID otsing ning sisesta siis ilmuvas dialoogis väärtus, mida soovid leida.


Public ID aken


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Eelmine
Järgmine
Esileht


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Peatükk 3. Autorid ja litsents
Autorid ja litsents
Eelmine

Peatükk 3. Autorid ja litsents

Keith Isdale

Tõlge eesti keelde: Marek Laane

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.

Eelmine
Esileht


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team

Järgmine
 


Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team