<chapter id="xmltools">
<chapterinfo>

<title>&XML; soovitaja</title>

<authorgroup>
<author><firstname>Daniel</firstname> <surname>Naber</surname> <affiliation> <address>&Daniel.Naber.mail;</address>
</affiliation>
</author>
</authorgroup> <date>2006-05-17</date> <releaseinfo>3.5.2</releaseinfo> <abstract> <para>See plugin toetab &XML;-failide kirjutamist, pakkudes välja lubatud siltide nimekirja 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">$TDEDIR/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 ava seadistustedialoog menüükäsuga <menuchoice><guimenu>Seadistused</guimenu> <guimenuitem>&kate; seadistamine...</guimenuitem></menuchoice>. Seejärel vali <guilabel>Kate XML soovitaja</guilabel>, mille leiab sektsioonis <guilabel>Rakendus</guilabel>/<guilabel>Pluginad</guilabel>, ja sulge dialoog. Pärast seda vali <menuchoice><guimenu>XML</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. Arvesta, et praegu ei ole seda võimalik kasutada tipptaseme elemendi lisamiseks (&eg; <quote>&lt;html&gt;</quote>).</para></listitem>
</varlistentry>

<varlistentry>
<term>" (jutumärk)</term>
<listitem><para>See toob esile võimalike atribuutide väärtuste nimekirja (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 ehk ampersand)</term>
<listitem><para>See toob esile võimalike olemite nimekirja.</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>$TDEDIR/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><shortcut> <keycombo action="simul">&Ctrl;<keycap>Return</keycap></keycombo> </shortcut> <guimenu>XML</guimenu> <guimenuitem>Lisa 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><shortcut> <keycombo action="simul">&Ctrl;<keycap>&lt;</keycap></keycombo> </shortcut> <guimenu>XML</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</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>Autorid ja litsents</title>

<para>&kate; plugin <quote>XML soovitaja</quote>: autoriõigus 2001, 2002: &Daniel.Naber; &Daniel.Naber.mail;. </para>

<para>Dokumentatsiooni autoriõigus 2001, 2002: &Daniel.Naber; </para>

<para>Tõlge eesti keelde: Marek Laane 2002 <email>bald@starman.ee</email></para> 
&underGPL; </sect1>
</chapter>
