<chapter id="xmltools">
<chapterinfo>

<title
><acronym
>XML</acronym
> soovitaja</title>

<authorgroup>
<author
> <firstname
>Daniel</firstname
> <surname
>Naber</surname
> <affiliation
> <address
><email
>daniel.naber@t-online.de</email
></address
> </affiliation
> </author>
</authorgroup>
<date
>2002-07-20</date>
<releaseinfo
>0.90.00</releaseinfo>
<abstract>

<para
>See plugin toetab XML-failide kirjutamist, pakkudes välja lubatud siltide loendi ja veel palju muudki.</para>

</abstract>
<keywordset>
<keyword
>KDE</keyword>
<keyword
>kate</keyword>
<keyword
>xml</keyword>
</keywordset>
</chapterinfo>

<title
>Sissejuhatus</title>

<para
>See plugin pakub variante, mis on XML-failis mingis positsioonis vastavalt faili DTD-le lubatud ja mis mitte. Plugin loetleb võimalikud elemendid, atribuudid, atribuudi väärtused ja olemid vastavalt kursori asukohale (nt kõik olemid, kui märk kursorist vasakul on <quote
>&amp;</quote
>). Samuti võimaldab see sulgeda lähima vasakul avatud sildi.</para>

<para
><acronym
>DTD</acronym
> peab eksisteerima XML-vormingus nii, nagu selle on loonud Perli rakendus <command
>dtdparse</command
>. Me nimetame selles vormingus DTD-d <quote
>meta-DTD-ks</quote
>. Mõned meta-DTD-d on juba paketiga kaasas, need asuvad kataloogis <filename class="directory"
>$KDEDIR/share/apps/katexmltools/</filename
>, mis on ühtlasi ka vaikekataloog, kui valid menüükäsu <guimenuitem
>Omista meta-DTD...</guimenuitem
>. Omaenda DTD loomiseks tõmba <command
>dtdparse</command
> internetist: <ulink url="http://dtdparse.sourceforge.net"
>http://dtdparse.sourceforge.net</ulink
>.</para>

<sect1 id="xmltools-how-to-use">
<title
>Kasutamisjuhend</title>

<para
>Käivita Kate ja vali <guilabel
>Kate XML soovitaja</guilabel
>, mida saab teha seadistuste (<menuchoice
><guimenu
>Seadistamine</guimenu
> <guimenuitem
>Kate seadistamine...</guimenuitem
></menuchoice
>) dialoogi sektsioonis <guilabel
>Rakendus</guilabel
>/<guilabel
>Pluginad</guilabel
>. Pärast seda vali <menuchoice
><guimenu
>XML plugin</guimenu
><guimenuitem
>Omista meta-DTD</guimenuitem
></menuchoice
>. Kui dokumendil puudub <quote
>DOCTYPE</quote
> või on see tundmatu, tuleb failisüsteemist valida meta-DTD. Muidu laaditakse aktiivse dokumendiga sobiv DOCTYPE automaatselt.</para>

<para
>Nüüd saab kasutada pluginat kirjutamise ajal:</para>

<variablelist
> <varlistentry
> <term
>&lt; ("vähem kui"-klahv)</term
> <listitem
><para
>See toob esile võimalike elementide loendi, kui kursor ei asu juba sildi sees. Pane tähele, et praegu ei ole seda võimalik kasutada tipptaseme elemendi lisamiseks (nt <quote
>&lt;html&gt;</quote
>).</para
></listitem
> </varlistentry
> <varlistentry
> <term
>" (jutumärk)</term
> <listitem
><para
>See toob esile võimalike atribuutide väärtuste loendi (kui neid on), kui kursor on sildi sees.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>(tühikuklahv)</term
> <listitem
><para
>See toob esile paeguse elemendi võimalikud väärtused, kui kursor on sildi sees.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
>&amp; (ja-märk)</term
> <listitem
><para
>See toob esile võimalike olemite loendi.</para
></listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="xmltools-features-and-limitations">
<title
>Võimalused ja piirangud</title>

<para
>Kõiki funktsioone ja piiranguid saab testida, kui avada &kate;s <filename
>$KDEDIR/share/apps/katexmltools/testcases.xml</filename
> ja järgida juhiseid. Pane tähele, et plugina praegune versioon ei toeta veel mitut vaadet dokumendi kohta.</para>

</sect1>


<sect1 id="xmltools-menu">
<title
>Menüü struktuur</title>

<variablelist
> <varlistentry
> <term
> <menuchoice
> <guimenu
>XML plugin</guimenu
> <guimenuitem
>Sisesta element...</guimenuitem
> </menuchoice
> </term
> <listitem
><para
>See avab dialoogi, mis võimaldab lisada XML-elemendi. Märgid &lt;, &gt; ja lõpusilt lisatakse automaatselt. Kui valisid enne selle menüükäsu kasutamist mingi teksti, ümbritsetakse valitud tekst ava- ja lõpusildiga. Dialoog soovitab ka muid elemente, mida on võimalik lisada kursori asukohta, kui oled menüükäsu <guimenuitem
>Omista meta-DTD</guimenuitem
> abil omistanud dokumendile meta-DTD. </para
></listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <guimenu
>XML plugin</guimenu
> <guimenuitem
>Sulge element</guimenuitem
> </menuchoice
> </term
> <listitem
><para
>See otsib tekstis silti, mis ei ole veel suletud ning lisab vastava lõpusildi. Otsing algab kursori asukohast ja suundub vasakule. Kui midagi ei leita, siis ka midagi ei juhtu.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
> <guimenu
>XML plugin</guimenu
> <guimenuitem
>Omista meta-DTD...</guimenuitem
> </menuchoice
> </term
> <listitem
><para
>See ütleb pluginale, millist meta-DTD-d kasutada aktiivse dokumendi jaoks. Pane tähele, et omistamist ei saa salvestada ja operatsiooni tuleb korrata, kui käivitad &kate; uuesti.</para
></listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="xmltools-thanks-and-acknowledgements">
<title
>Tänusõnad ja tunnustus</title>

<para
> &kate; plugina <quote
>XML soovitaja</quote
> copyright 2001, 2002 Daniel Naber <email
>daniel.naber@t-online.de</email
> </para>

<para
> Dokumentatsiooni copyright 2001, 2002: Daniel Naber </para>

<para
>Tõlge eesti keelde: Marek Laane 2002 <email
>bald@online.ee</email
></para>

<!-- &underFDL; -->
&underGPL;

</sect1>
</chapter>

<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->


