<chapter id="plugins">

<chapterinfo>
<authorgroup>
<author
>&Anders.Lund; &Anders.Lund.mail;</author>
<othercredit role="translator"
><firstname
>Marek</firstname
><surname
>Laane</surname
><affiliation
><address
><email
>bald@starman.ee</email
></address
></affiliation
><contrib
>Tõlge eesti keelde</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>

<title
>Pluginate kasutamine</title>

<para
>Kate kasutab kaht erinevat tüüpi pluginaid: &kate; rakenduse pluginad ja &kate; redaktorikomponendi pluginad. Viimaseid saavad kasutada kõik teised rakendused, mis tarvitavad redaktorikomponenti, näiteks KDevelop, Quanta, Kile, KWrite ja paljud muud, rakenduse pluginad on aga spetsiifilised just &kate;le endale.</para>

<para
>Mõlemat tüüpi pluginate kasutamist saab sisse ja välja lülitada <link linkend="configuring-kate-configdialog"
>seadistustedialoogis</link
>, mis ühtlasi võimaldab mõningate pluginate juures üht-teist seadistada.</para>

<para
>Mitmesuguseid üsna erinevaks otstarbeks mõeldud pluginaid on päris palju ning pluginaid leiab ka veebist. Teatud pluginad on juba kaasa pandud redaktorikomponendiga, need võimaldavad automaatset sulgude lisamist, failide lisamist, andmetööriistu ja teksti eksportimist &HTML;-ina.</para>

<sect1 id="kate-editor-plugins">
<title
>Redaktori komponendi pluginad</title>

<para
>Lehekülje <guilabel
>Laiendused</guilabel
> kaardil <guilabel
>Pluginad</guilabel
> on näha kõik saadaolevad pluginad ning siin saab märkida, milliseid neist kasutada, milliseid mitte. Klõpsuga nupule <guibutton
>Info</guibutton
> avatakse antud plugina <guilabel
>info</guilabel
>dialoog.</para>
<para
>Plugina märkimise korral saab tarvitada nuppu <guibutton
>Seadista</guibutton
> ning vastavat pluginat seadistada.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Automaatsulud</guilabel
></term>
<listitem
><para
>Automaatsulgude plugin tühistab &kate; sisemise <quote
>automaatsulgude</quote
> omaduse. See lisab automaatselt lõpetava sulu <keycap
>}</keycap
> järgmise rea algusse pärast selle rea lõppu jõudmist, millel seisab alustav sulg <keycap
>{</keycap
>, ning klahvi &Enter; vajutamist.</para
></listitem>
</varlistentry>
<!--http://jakob.petsovits.at/topic/kate-->
<!--Right, it's the automatic insertion of a closing brace ("}") after you ended a line with an opening one ("{"). Kate's standard insertion of parentheses, brackets and braces is simply too obtrusive for me, so even if I tried it several times I always had to disable it again because I can't stand it. So here's how AutoBrace works.
You, the developer, are writing a line of code, and want to open a new block delimited by braces. Looks like this:
If you press Enter and AutoBrace is enabled, it will insert your favorite new brace where it belongs. Looks like this:
-->
<varlistentry>
<term
><guilabel
>Andmete tööriistad</guilabel
></term>
<listitem
><para
>Võimaldab kasutada andmetööriistu, näiteks tesaurust ja õigekirja kontrolli (kui need on paigaldatud). Andmetööriistad on saadaval ainult siis, kui tekst on valitud või kui hiire parema nupuga klõpsatakse mõne sõna kohal. Kui andmetööriistu ei pakuta isegi siis, kui tekst on valitud, tuleb need paigaldada. Mõned andmetööriistad kuuluvad paketti &koffice;. Kui see plugin on sisse lülitatud ja andmetööriistad paigaldatud, ilmuvad kontekstimenüüsse vastavad lisakirjed.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Eksport</guilabel
></term>
<listitem
><para
>See käsk võimaldab eksportida aktiivse dokumendi koos kogu esiletõstmise teabega HTML-dokumenti menüükäsu <menuchoice
><guimenu
>Fail</guimenu
><guimenuitem
>Ekspordi HTML-ina</guimenuitem
></menuchoice
> abil. Lisaks võib kasutada käsku <menuchoice
><guimenu
>Redigeerimine</guimenu
><guimenuitem
>Kopeeri HTML-ina</guimenuitem
></menuchoice
> valitud teksti kopeerimiseks HTML-ina süsteemi lõikepuhvrisse.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Ikoonilisaja</guilabel
></term>
<listitem
><para
>Ikoonilisaja plugin on mõeldud peamiselt &kde; arendajatele. See lisab redaktori kontekstimenüüsse kirje <guimenuitem
>Lisa KIcon-Code</guimenuitem
>. Valimise korral avatakse &kde; ikoonivalija (mis näitab rakenduste, toimingute jne. ikoone). Sellel klõpsates lisatakse tekstina failinimi ilma laiendita. See on kasulik ainult ikoonide määramiseks &kde; raamistiku kaudu klassi KIcon() abil. </para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Hullumeelne (mitte ZEN) HTML kodeering (kerge versioon)</guilabel
></term>
<listitem
><para
>Plugin, mis kasutab zen-kodeerimise laadset selektori lõpetamist. Täpsemalt kõneldakse sellest Wikipedias <ulink url="http://en.wikipedia.org/wiki/Zen_Coding"
> Zen Coding</ulink
>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Faili lisamine</guilabel
></term>
<listitem
><para
>See plugin võimaldab lisada kursori asukohta mis tahes loetava faili. Sisselülitamise korral ilmub menüüsse <guimenu
>Tööriistad</guimenu
> lisakirje <guimenuitem
>Faili lisamine</guimenuitem
>.</para
></listitem>
</varlistentry>
<!-- not build any longer in kde 4.5
<varlistentry>
<term
>Python Encoding check</term>
<listitem
><para
>This plugin is always enabled.  
If you are trying to save a python file as non ASCII, without specifying a 
correct source encoding line like &eg; <quote
># -*- coding: utf-8 -*-</quote
>, 
a warning dialog pops up and allows you to add a proper source encoding line for the
current encoding to the file.
</para
></listitem>
</varlistentry>
-->
</variablelist>
<!--
kdelibs/kate/plugins/ has additional plugins
autobookmark not build, its broken!
timedate not build? plugin is for howto-write-a-plugin purposes!
-->

<!-- Scripts tab ??? empty-->
</sect1>

<sect1 id="kate-application-plugins">
<title
>&kate; rakenduse pluginad</title>

<!-- from doc/kate-addons/index.docbook -->
<para
>&kate; pluginad on &kate; redaktori lisafunktsioonid Need võivad lisada menüüsid ja kiirviitu, samuti laiendada &kate; võimalusi. Neid võib paigaldada &kate;le just nii vähe või palju, kui sulle endale meeldib. Ava &kate; seadistustedialoog menüükäsuga <menuchoice
><guimenu
>Seadistused</guimenu
><guimenuitem
>&kate; seadistamine...</guimenuitem
></menuchoice
> Vali soovitud pluginad kaardilt <menuchoice
><guimenu
>Rakendus</guimenu
><guimenuitem
>Pluginad</guimenuitem
></menuchoice
>. </para>

<para
>Saadaolevad rakenduse pluginad on järgmised: </para>
<itemizedlist>
<listitem>
<para
>Failides otsimise tööriistavaade - tööriistavaade, mis võimaldab otsida kõigis avatud või failisüsteemis leiduvates failides</para>
</listitem>
<listitem>
<para
>Tagasijälituse brauser - tagasijälituse liikumistööriista vaade</para>
</listitem>
<listitem>
<para
>Dokumentide kiirlülitaja - võimaldab kiiresti lülituda mõnele teisele avatud dokumendile</para>
</listitem>
<listitem>
<para
>Kaardiriba - lisab Kate peaaknasse kaardiriba</para>
</listitem>
<!--listitem>
<para
>Text Snippets - Configurable Text Snippets</para>
</listitem-->
<listitem>
<para
>Tekstifilter - lihtne teksti filtreerimine</para>
</listitem>
<listitem>
<para
>Sümbolite näitaja - hangib lähtekoodist sümbolid ja näitab neid</para>
</listitem>
<listitem>
<para
>Failisüsteemi sirvija - failisüsteemi sirvija tööriistavaade</para>
</listitem>
<listitem>
<para
>Terminali tööriistavaade - terminalividinat põimiv tööriistavaade</para>
</listitem>
<!--listitem>
<para
>Kate Python Browser Plugin - A Python browser plugin for Kate</para>
</listitem-->
<listitem>
<para
>CTagsi plugin - definitsiooni/deklaratsiooni otsimine CTagsiga</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-filetemplate"
>Failimallid</link
> - uute failide loomine malli põhjal</para>
</listitem>
<listitem>
<para
>Päisefaili avaja - vastava .h/[.cpp|.c] faili avamine</para>
</listitem>
<listitem>
<para
>Välised tööriistad</para>
</listitem>
<listitem>
<para
>Ehitamisplugin - kompileerimine või ehitamine (make) ja veateadete parsimine</para>
</listitem>
<listitem>
<para
>Failide saatmine e-postiga</para>
</listitem>
<listitem>
<para
>Kate jupid - juppide plugin koodilõpetuse toetusega</para>
</listitem>
<listitem>
<para
>KTextEditori Jovie plugin - lisab menüükirje teksti kõnelemiseks</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-xmlcheck"
>&XML; süntaksi kontrollija</link
>- kontrollib -faile xmllint'i abil</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-xmltools"
>&XML;-i lõpetus</link
> - Loetleb &XML;-i elemendid, atribuudid, atribuutide väärtused ja olemid, mida võimaldab DTD</para>
</listitem>
<listitem>
<para
>Taibfy - lisab Kate peaaknasse kaardiriba</para>
</listitem>
</itemizedlist>
</sect1>

<!-- from doc/kate-addons/filetemplates.docbook -->
<sect1 id="kate-application-plugin-filetemplate">
<sect1info>
<authorgroup>
<author
>&Anders.Lund; &Anders.Lund.mail;</author>
</authorgroup>
</sect1info>
<title
>Failimallid</title>

  <para
>Failimallide plugin võimaldab luua faile teiste failide põhjal.</para>
  <para
>Kate esmapaigaldusel tuleb plugin sisse lülitada:</para>
  <orderedlist>
        <listitem>
          <para
>Vali <guimenu
>Seadistused</guimenu
> <guimenuitem
>Kate seadistamine...</guimenuitem
> </para>
        </listitem>
        <listitem>
          <para
>Klõpsa vasakul asuvas puus kirjele <guilabel
>Pluginad</guilabel
>. </para>
        </listitem>
        <listitem>
          <para
>Vali paremal asuvas paneelis <guilabel
>Pluginahaldur</guilabel
> <guilabel
>Failimallid</guilabel
> ja klõpsa seejärel nupule <guibutton
>OK</guibutton
>. </para>
        </listitem>
   </orderedlist>
  <para
>Nüüd võid kasutada iga faili mallinai: sellest luuakse koopia tühja &URL;-iga. Samuti võib kasutada spetsiaalset mallifaili, kus on juba olemas teatud makrod, mis annavad ette mõningase info, näiteks sinu nime ja e-posti aadressi, kuupäeva ja keskkonnamuutujad ning isegi kursori asukoha uues failis.</para>
  <para
>Sa võid ka hõlpsasti luua uue malli avatud dokumendi põhjal.</para>
  <para
>Malle, mida oled salvestanud mallikataloogi, näeb menüüs kirje <menuchoice
><guimenu
>Fail</guimenu
><guimenuitem
>Uus mallist</guimenuitem
></menuchoice
> järel.</para>
  <para
>Mallide kataloog on osa &kde; failisüsteemist ja sisaldab vähemalt</para>
    <itemizedlist>
      <listitem>
	<para>
	 <filename role="directory"
>$<envar
>KDEDIR</envar
>/share/applications/kate/plugins/katefiletemplates/templates</filename>
	</para>
      </listitem>
      <listitem>
       <para>
        <filename role="directory"
>$<envar
>KDEHOME</envar
>/share/applications/kate/plugins/katefiletemplates/templates.</filename>
	</para>
      </listitem>
    </itemizedlist>
    <para
>Kui sinu keskkonnamuutujas <envar
>KDEDIRS</envar
> on veel katalooge, otsitakse ka neist samasuguseid alamkatalooge. Kui leitakse ühenimelised mallid, valitakse neist kohalikus kataloogis (KDEHOME) leiduv.</para>
  <sect2 id="katefiletemplates-menu">
    <title
>Menüü struktuur</title>

    <variablelist>
      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Fail</guimenu
> <guisubmenu
>Uus mallist</guisubmenu
> <guimenuitem
>Suvaline fail...</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>Avab failiavamise dialoogi, kus võid valida malliks suvalise faili. Kui valitul on laiend <filename
>katetemplate</filename
>, parsitakse seda malliinfo ja makrode leidmiseks.</para
></listitem>
      </varlistentry>
      <!-- not in 4.4
      <varlistentry>
        <term>
          <menuchoice>
            <guimenu
>File</guimenu>
            <guisubmenu
>New From Template</guisubmenu>
            <guimenuitem
>Use Recent</guimenuitem>
          </menuchoice>
        </term>
        <listitem
><para
>Presents a list of files recently used as
            templates, represented by their &URL;.</para
></listitem>
      </varlistentry>
      -->
      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Fail</guimenu
> <guimenuitem
>Uus mallist</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>Alammenüü ülejäänud osa sisaldab viitu mallidele. Klõpsa menüükirjel, kui soovid luua sellele vastavat faili.</para
></listitem>
      </varlistentry>

      <!-- Settings menu -->

      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Mallide haldamine...</guimenuitem
></menuchoice
></term>
        <listitem
><para
>Avab dialoogi, kus on ära toodud kõik mallikataloogides leitud mallid, ning kus saab neid lisada, muuta või eemaldada.</para
></listitem>
      </varlistentry>
    </variablelist>
  </sect2>

  <sect2 id="katefiletemplates-use">
    <title
>&kate; mallide kasutamine</title>
    <para
>Luues makrosid sisaldava malli põhjal faili, ilmuvad mõned makrod teksti redigeeritavate muutujatena. Selliseid muutujaid eristatakse allajoonimisega.</para>
    <para
>Esimene muutuja on kohe valitud, nii et sul tuleb selle redigeerimiseks vaid kirjutama asuda. Kui sama muutujat esineb dokumendis rohkemgi, muudetakse ka kohe ka neid. Järgmisele redigeeritavale muutujale saab liikuda tabeldusklahviga (TAB). Pärast viimase muutuja redigeerimist nimekiri kaob ning tabeldusklahv hakkab taas normaalselt tööle.</para>
  </sect2>

  <sect2 id="katefiletemplates-create">
    <title
>Oma mallide loomine</title>
    <para
>Uue malli loomiseks käivita mallihaldur menüükäsuga <menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Mallide haldamine</guimenuitem
></menuchoice
>. Selle avanedes klõpsa nupul <guibutton
>Uus...</guibutton
>, mis käivitab failimalli nõustaja. Sinu käest päritakse faili, mida malliks muuta, võimaldatakse määrata malli info ja seejärel luuaksegi mall.</para
> <para
>Muidugi võib malli ka päris käsitsi luua, lisades malli info mis tahes faili algusse, andes teksti, makrod ja kursori asukoha markeri ning salvestades faili laiendiga <filename
>katetemplate</filename
>.</para>
    <para
>Mallimenüü uuendatakse automaatselt, kui salvestad mallikataloogi uue malli.</para>
  </sect2>

  <sect2 id="katefiletemplates-edit">
    <title
>Mallide muutmine</title>
    <para
>Malli muutmiseks vali menüükäsk <menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Mallide haldamine...</guimenuitem
></menuchoice
> Vali mall, mida soovid muuta, ja klõpsa nupule <guibutton
>Muuda...</guibutton
> Seejärel avatakse mallifail. Sulge dialoog, muuda faili, salvesta ja sulge. Malli tehtud muudatused rakendatakse otsekohe, soovi korral võid selle kohe pärast salvestamist ja sulgemist uuesti avada, et vaadata, kas kõik sai nii, nagu tahtsid.</para>
  </sect2>

  <sect2 id="katefiletemplates-format">
    <title
>&kate; malli vorming</title>
    <para
>Kui kasutad faile laiendiga <filename
>katetemplate</filename
>, parsitakse neid malli info, makrode ja kursori asukoha leidmiseks.</para>

    <sect3 id="katefiletemplates-template-info">
      <title
>Malli info</title>
      <para
>Fali lugedes otsib parser ridu, mille alguses seisab <constant
>katetemplate:</constant
>, sest just neisse peaks olema salvestatud malli info kujul MUUTUJANIMI=VÄÄRTUS. Esimest rida, mille alguses ei seisa <constant
>katetemplate:</constant
>, peetakse malli sisu alguseks. VÄÄRTUS võib olla mis tahes sümbol, välja arvatud võrdusmärk (=). Kindlasti tuntakse ära järgmised muutujad: <variablelist>
          <varlistentry>
            <term
><varname
>Mall</varname
></term>
            <listitem
><para
>See on malli nimi, mida näidatakse menüüs <menuchoice
><guimenu
>Fail</guimenu
><guimenuitem
>Uus mallist</guimenuitem
></menuchoice
>.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Group</varname
></term>
            <listitem
><para
>Grupp asetab malli menüü <menuchoice
><guimenu
>Fail</guimenu
><guimenuitem
>Uus mallist</guimenuitem
></menuchoice
> alammenüüsse.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><varname
>Name</varname
></term>
            <listitem
><para
>Dokumendi nimi, mida näidatakse nii failinimekirjas kui tiitliribal. Kui nimes leidub <userinput
>%N</userinput
>, asendatakse see numbriga, mis samanimeliste dokumentide korral kasvab.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Highlight</varname
></term>
            <listitem
><para
>Plugin püüab uue dokumendi esiletõstu määrata selle muutuja väärtusele. Väärtus peab olema nimi, nagu see esineb menüüs <menuchoice
><guimenu
>Tööriistad</guimenu
><guimenuitem
>Esiletõstmine</guimenuitem
> </menuchoice
>.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Description</varname
></term>
            <listitem
><para
>Malli lühike kirjeldus. Praegu on see kasutatav abivõimaluse 'Mis see on?' jaoks, kuid tulevikus võib-olla muukski.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
>Author</term>
            <listitem
><para
>See string määrab autori, näiteks kujul <userinput
>Nimi &lt;e-posti aadress&gt;</userinput
>. Praegu on see kasutatav abivõimaluse 'Mis see on?' jaoks, kuid tulevikus võib-olla muukski.</para
></listitem>
          </varlistentry>
        </variablelist>
      </para>

    </sect3>

    <sect3 id="katetemplates-macros">
      <title
>Malli makrod</title>

      <para
>Malli sisu parsides avatakse makrod kujul <userinput
>%{NAME}</userinput
> või <userinput
>${NAME}</userinput
>. Kui kasutad prefiksit <userinput
>$</userinput
>, koheldakse avatud makrot redigeeritava muutujana, kui dokument luuakse malli põhjal. <userinput
>%</userinput
> kasutamisel seda ei tehta, kui just avamine ei ebaõnnestu.</para>
      <para
>Toetatud on järgmised makrod: <variablelist>
          <varlistentry
><term
>time</term>
            <listitem
><para
>Näitab käesolevat kellaaega kohalikul kujul.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
>date</term>
            <listitem
><para
>Näitab käesolevat kuupäeva lühivormingus.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
>datetime</term>
            <listitem
><para
>Näitab käesolevat kuupäeva ja kellaaega stringina kohalikul kujul.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
>year</term>
            <listitem
><para
>Käesolev aasta neljakohalise numbrina.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
>month</term>
            <listitem
><para
>Käesoleva kuu täisnimi kohalikul kujul.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
>day</term>
            <listitem
><para
>Näitab käesolevat kuu päeva.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
>hostname</term>
            <listitem
><para
>Näitab arvuti masinanime.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
>index</term>
            <listitem
><para
>Näitab 'i'.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
>fullname</term>
            <listitem
><para
>Näitab sinu täielikku nime, nagu selle määrab sinu standardse &kde; aadressiraamatu omaniku aadress.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
>firstname</term>
            <listitem
><para
>Näitab sinu eesnime, nagu selle määrab sinu standardse &kde; aadressiraamatu omaniku aadress.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
>lastname</term>
            <listitem
><para
>Näitab sinu perekonnanime, nagu selle määrab sinu standardse &kde; aadressiraamatu omaniku aadress.</para>
            </listitem>
          </varlistentry>
          <!-- <varlistentry>
            <term
>username</term>
            <listitem
><para
>Expands to your username.</para
></listitem>
          </varlistentry
> -->
          <varlistentry>
            <term
>email</term>
            <listitem
><para
>Näitab sinu e-posti aadressi, nagu selle määrab sinu standardse &kde; aadressiraamatu omaniku aadress.</para
></listitem>
          </varlistentry>
          <!--<varlistentry>
            <term
>organisation</term>
            <listitem
><para
>This is your organisation, as defined by
                the owner address in your standard KDE
                addressbook.</para
></listitem>
          </varlistentry
>-->
        </variablelist>
      </para>
      <para
>Kõiki muid makrosid tõlgendatakse prefiksist sõltumata redigeeritavate muutujatena. Kui üks ja sama muutuja esineb mallis mitu korda, saab neid redigeerida kohe korraga pärast dokumendi loomist malli põhjal.</para>
    </sect3>

    <sect3 id="katefiletemplates-cursor">
      <title
>Kursori asukoha määramine</title>
      <para
>Spetsiaalne makro <userinput
>${cursor}</userinput
> asendatakse püstjoonega ning lisatakse sõltumata asukohast tekstis redigeeritavate muutujate nimekirja lõppu.</para>
    </sect3>

  </sect2>
  <sect2>
    <title
>Autorid ja litsents</title>
    <para
>&kate; plugina <quote
>failimallid</quote
> autoriõigus 2004: &Anders.Lund; &Anders.Lund.mail;. </para>
    <para
>Dokumentatsiooni autoriõigus 2004: &Anders.Lund;</para>
  </sect2>
</sect1>

<!-- from doc/kate-addons/xmlcheck.docbook -->
<sect1 id="kate-application-plugin-xmlcheck">
<sect1info>
<authorgroup
><author
><firstname
>Daniel</firstname
> <surname
>Naber</surname
> <affiliation
><address
>&Daniel.Naber.mail;</address
></affiliation>
</author
></authorgroup>
</sect1info>

<title
>&XML; süntaksi kontrollija</title>

<para
>See plugin kontrollib, kas &XML;-failid on korrektselt vormistatud.</para>
<para
>See plugin kontrollib aktiivset faili. Hoiatuste ja vigade nimekiri ilmub &kate; põhiakna allserva. Veateatele klõpsates saab hüpata vastavale kohale failis. Kui failil on <quote
>DOCTYPE</quote
>, kasutatakse faili kontrollimiseks selle dokumenditüübiga seotud DTD-d. DTD eeldatakse asuvat suhtelises asukohas aktiivse faili suhtes - &eg; kui dokumenditüüp viitab tüübile <quote
>DTD/xhtml1-transitional.dtd</quote
> ja failinimi on <filename
>/home/juku/test.xml</filename
>, siis eeldatakse, et DTD paikneb asukohas <filename
>/home/juku/DTD/xhtml1-transitional.dtd</filename
>. Kuid toetatud on ka võrgu-DTD, mis on määratud http vahendusel.</para>

<para
>Kui failil puudub dokumenditüüp, kontrollitakse vormistust.</para>

<para
>&XML; süntaksi kontrollimise kohta leiab rohkem infot internetist  <ulink url="http://www.w3.org/XML/"
>W3C ametlikult &XML;-leheküljelt</ulink
>.</para>

<para
>Seesmiselt kutsub see plugin välja käsu <command
>xmllint</command
>, mis on osa paketist libxml2. Kui see käsk ei ole süsteemi korrektselt paigaldatud, ei hakka plugin tööle.</para>

<note
><para
>Kontrollimise ajal on vajalik kirjutada ajutine fail samasse kataloogi, kus asub kontrollitav fail, nii et sul peab olema sellesse kataloogi kirjutamisõigus.</para
></note>

<para
>Plugina sisselülitamiseks ava &kate; seadistustedialoog menüükäsuga <menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>&kate; seadistamine...</guimenuitem
></menuchoice
> Seejärel vali <guilabel
>XML süntaksi kontrollija</guilabel
>, mille leiad kaardilt <guilabel
>Rakendus</guilabel
>/<guilabel
>Pluginad</guilabel
>, ja sulge dialoog. </para>

<sect2 id="xmlcheck-menu">
<title
>Menüü struktuur</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>XML</guimenu
> <guimenuitem
>XML süntaksi kontroll</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>See käivitab ülalkirjeldatud kontrolli.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmlcheck-thanks-and-acknowledgements">
<title
>Autorid ja litsents</title>
<para
>&kate; plugin <quote
>XML süntaksi kontrollija</quote
> autoriõigus 2002: &Daniel.Naber; &Daniel.Naber.mail;. </para>
<para
>Dokumentatsiooni autoriõigus 2002: &Daniel.Naber;</para>

</sect2>
</sect1>

<sect1 id="kate-application-plugin-xmltools">
<sect1info>
<authorgroup
><author
><firstname
>Daniel</firstname
> <surname
>Naber</surname
> <affiliation
><address
>&Daniel.Naber.mail;</address
></affiliation>
</author
></authorgroup>
</sect1info>
<title
>&XML;-i lõpetus</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>

<sect2 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
>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
><keycap
>&lt;</keycap
> ("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
><keycap
>&lt;</keycap
><keycap
>/</keycap
>("vähem kui"-klahv + kaldkriips)</term>
<listitem
><para
>Nende märkide sisestamisel pakutakse aktiivse elemendi sulgemist (lähim kursorist vasakule jääv avatud element). Ettepanekuga nõustumiseks vajuta &Enter;. Erinevalt menüükäsust <guimenuitem
>Sulge element</guimenuitem
> toimib see ainult omistatud DTD puhul.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>"</keycap
> (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
><keycap
>&nbsp;</keycap
> (tühikuklahv)</term>
<listitem
><para
>See toob esile praeguse elemendi võimalikud väärtused, kui kursor on sildi sees.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&amp;</keycap
> (ja-märk ehk ampersand)</term>
<listitem
><para
>See toob esile võimalike olemite nimekirja.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 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.</para>

</sect2>


<sect2 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
>Avab dialoogi, mis võimaldab sisestada &XML;-i elemendi. Märgid &lt;, &gt; ja sulgev silt lisatakse automaatselt. Kui oled menüükäsu kasutamisel valinud teksti, ümbritsetakse valitud tekst alustava ja lõpetava sildiga. Samuti pakub dialoog võimalust lõpetada kõiki elemente, mida on võimalik lisada kursori asukohta, kui oled omistanud meta-DTD, kasutades menüükäsku <guimenuitem
>Omista meta-DTD...</guimenuitem
> </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>

</sect2>

<sect2 id="xmltools-thanks-and-acknowledgements">
<title
>Autorid ja litsents</title>
<para
>&kate; plugina <quote
>&XML; soovitaja</quote
> autoriõigus 2001, 2002: &Daniel.Naber; &Daniel.Naber.mail;. </para>
<para
>KDE SC 4 versiooni autoriõigus 2010: Tomáš Trnka</para>
<para
>Dokumentatsiooni autoriõigus 2001, 2002: &Daniel.Naber;</para>
</sect2>

</sect1>

</chapter>
