<chapter id="katefiletemplates">
<chapterinfo>

<title
>Failimallid</title>

<authorgroup>
<author
><firstname
>Anders</firstname
> <surname
>Lund</surname
> <affiliation
> <address
><email
>anders@alweb.dk</email
></address>
</affiliation>
</author>
</authorgroup
> <date
>Esmaspäev, 16. veebruar 2004</date
> <releaseinfo
>0.1</releaseinfo
> <abstract
> <para
></para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kate</keyword>
<keyword
>kdeaddons</keyword>
<keyword
>mall</keyword>
<keyword
>makro</keyword>
</keywordset>
</chapterinfo>

<title
>Sissejuhatus</title>

<para
>Failimallide plugin lubab olemasolevate failide baasil luua uusi faile. Mallina saab kasutada iga faili: 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
>Mallikataloogides asuvaid malle saab näha menüükäsuga <menuchoice
><guimenu
>Fail</guimenu
><guimenuitem
>Mallist...</guimenuitem
></menuchoice
></para>
<para
>Plugin lubab ka hõlpsasti luua uue malli avatud dokumendi põhjal.</para>
<para
>Mallikataloogid on osa &kde; failisüsteemist ning neiks on vähemalt KDEDIR/share/applications/kate/plugins/katefiletemplates/templates ja KDEHOME/share/applications/kate/plugins/katefiletemplates/templates. Kui sinu keskkonnamuutujas KDEDIRS on veel katalooge, otsitakse ka neist samasuguseid alamkatalooge. Kui leitakse ühenimelised mallid, valitakse neist kohalikus kataloogis (KDEHOME) leiduv.</para>
<sect1 id="katefiletemplates-menu">
<title
>Menüü struktuur</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>Fail</guimenu
> <guimenu
>Uus mallist</guimenu
> <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>

<varlistentry>
<term>
<menuchoice
><guimenu
>Fail</guimenu
> <guimenu
>Uus mallist</guimenu
> <guimenuitem
>Kasuta hiljutist</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Näitab hiljuti mallina kasutatud failide loendit, tuues ära nende URL-id.</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>

</sect1>
<sect1 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 salveesta mallikataloogi uue malli.</para>
</sect1>

<sect1 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, muuta 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>
</sect1>

<sect1 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>

<sect2 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
>Template</varname
></term>
<listitem
><para
>See on malli nimi, mida näidatakse menüüs <menuchoice
><guimenu
>Fail</guimenu
><guimenuitem
>Mallist</guimenuitem
></menuchoice
>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><varname
>Group</varname
></term>
<listitem
><para
>Grupp asetab malli menüü <menuchoice
><guimenu
>Fail</guimenu
><guimenuitem
>Mallist</guimenuitem
></menuchoice
> alammenüüsse.</para
></listitem>
</varlistentry>
<varlistentry
><term
><varname
>Name</varname
></term>
<listitem
><para
>Dokumendi nimi, mida näidatakse nii faililoendis 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õstmine 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>

</sect2>

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

<para
>Malli sisu parsides, avatakse makrod kujul <userinput
>%STRING</userinput
>. Toetatud on järgmised makrod: <variablelist>
<varlistentry
><term
>%time</term>
<listitem
><para
>Näitab käesolevat aega kohalikul kujul, nagu selle tagastab <userinput
>QTime::currentTime().toString()</userinput
>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>%date</term>
<listitem
><para
>Näitab käesolevat kuupäeva pikal kujul, nagu selle tagastab <userinput
>QDate::currentDate().toString()</userinput
>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>%datetime</term>
<listitem
><para
>Näitab käesolevat kuupäeva ja kellaaega kohalikul kujul, nagu selle tagastab <userinput
>QDateTime::currentDateTime().toString()</userinput
>.</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
>%{date(VORMINDUSSTRING)}</term>
<listitem
><para
>Näitab kuupäeva/kellaaega kujul, mille määrab ära <userinput
>VORMINDUSSTRING</userinput
>. Viimane on tekstistring, mis tunnustab järgmisi asendusi:</para>
<table
><title
>Kuupäeva vormindamise olemid</title
><tgroup cols="2"
><tbody>
<row
><entry
><para
>h</para
></entry
><entry
><para
>tund ilma alustava nullita (0 - 23 või 1 - 12, kui sees on AM/PM)</para
></entry
></row>
<row
><entry
>hh<para
></para
></entry
><entry
><para
>tund alustava nulliga (00 - 23 või 01 - 12, kui sees on AM/PM) </para
></entry
></row>
<row
><entry
><para
>m</para
></entry
><entry
><para
>minut ilma alustava nullita (0 - 59) </para
></entry
></row>
<row
><entry
><para
>mm</para
></entry
><entry
><para
>minut alustava nulliga (00 - 59) </para
></entry
></row>
<row
><entry
><para
>s</para
></entry
><entry
><para
>sekund ilma alustava nullita (0 - 59)</para
></entry
></row>
<row
><entry
><para
>ss</para
></entry
><entry
><para
>sekund alustava nulliga (00 - 59) </para
></entry
></row>
<row
><entry
><para
>z</para
></entry
><entry
><para
>millisekundid ilma alustavate nullideta (0 - 999) </para
></entry
></row>
<row
><entry
><para
>zzz</para
></entry
><entry
><para
>millisekundid alustavate nullidega (000 - 999) </para
></entry
></row>
<row
><entry
><para
>AP</para
></entry
><entry
><para
>AM/PM kasutamine. AP asemele tuleb kas "AM" või "PM". </para
></entry
></row>
<row
><entry
><para
>ap</para
></entry
><entry
><para
>am/pm kasutamine. ap asemele tuleb kas "am" või "pm". </para
></entry
></row>

<row
><entry
><para
>d</para
></entry
><entry
><para
>päev numbrina ilma alustava nullita (1 - 31) </para
></entry
></row>
<row
><entry
><para
>dd</para
></entry
><entry
><para
>päev numbrina alustava nulliga (01 - 31) </para
></entry
></row>
<row
><entry
><para
>ddd</para
></entry
><entry
><para
>päeva kohalik lühike nimi ('Esm' - 'Püh').</para
></entry
></row>
<row
><entry
><para
>dddd</para
></entry
><entry
><para
>päeva kohalik pikk nimi ('Esmaspäev' - 'Pühapäev').</para
></entry
></row>
<row
><entry
><para
>M</para
></entry
><entry
><para
>kuu numbrina ilma alustava nullita (1 - 12)</para
></entry
></row>
<row
><entry
><para
>MM</para
></entry
><entry
><para
>kuu numbrina alustava nulliga (01 - 12) </para
></entry
></row>
<row
><entry
><para
>MMM</para
></entry
><entry
><para
>kuu kohalik lühike nimi ('Jaan' - 'Dets').</para
></entry
></row>
<row
><entry
><para
>MMMM</para
></entry
><entry
><para
>kuu kohalik pikk nimi ('Jaanuar' - 'Detsember').</para
></entry
></row>
<row
><entry
><para
>YY</para
></entry
><entry
><para
>Aasta kahekohalise numbrina (00 - 99).</para
></entry
></row>
<row
><entry
><para
>YYYY</para
></entry
><entry
><para
>Aasta neljakohalise numbrina (1752 - 8000).</para
></entry
></row>
</tbody
></tgroup
></table>
<para
>See lubab kuupäeva esitamist väga põhjalikult määrata. Erinevate elementide andmiseks kasuta tavalisi eraldajaid, näiteks <userinput
>h:m:s ap</userinput
>. </para
></listitem>
</varlistentry>
<varlistentry
><term
>%realname</term>
<listitem
><para
>Näitab sinu pärisnime, kui see on saadaval. Parser otsib seda esmalt KDE juhtimiskeskusest e-posti seadistustest, seejärel kasutaja kontoinfost. Kui täielikku nime ei leita, näidatakse sinu kasutajanime.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>%username</term>
<listitem
><para
>Näitab kasutajanime.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>%email</term>
<listitem
><para
>Näitab sinu e-posti aadressi, kui see on saadaval. Parser otsib seda KDE juhtimiskeskusest e-posti seadistustest. Kui seda ei leita, näidatakse siin aadressi kujul <userinput
>$KASUTAJA@$MASIN</userinput
>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
>%organisation</term>
<listitem
><para
>Sinu organisatsioon, nagu see esineb KDE juhtimiskeskuses e-posti seadistustes. Kui seda ei leita, tagastatakse tühi string.</para
></listitem>
</varlistentry>
<!-- LAST ENTRY: %ENV -->
<varlistentry>
<term
>%MUUTUJA</term>
<listitem
><para
>Kõiki muid stringe tõlgendatakse keskkonnamuutujana ja näidatakse antud muutuja väärtust. Kui sellise nimega muutujat ei leita, näidatakse &quot;HOIATUS &lt;MUUTUJA&gt; ei ole määratud&quot;.</para
></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>

<sect2 id="katefiletemplates-cursor">
<title
>Kursori asukoha määramine</title>
<para
>Parser otsib katusemärki (^), millele ei eelneks längkriipsu (\), et määrata kindlaks, kuhu kursor seada. Kui see leitakse, eemaldatakse katusemärk ja selle asemele asetatakse kursor. Kui leitakse rohkem selliseid "päästmata" katusemärke, eemaldatakse nad kõik ning kursor asetatakse viimase asukohta.</para>
<para
>Kui leitakse "päästetud" katusemärk (millele eelneb längkriips), siis längkriips eemaldatakse.</para>
</sect2>

</sect1>

<sect1 id="katefiletemplates-thanks-and-acknowledgements">
<title
>Autorid</title>

<para
>&kate; plugina <quote
>failimallid</quote
> autoriõigus 2004: Anders Lund <email
>anders@alweb.dk</email
>. </para>

<para
>Dokumentatsiooni autoriõigus 2004: Anders Lund </para>

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

<!-- kate: word-wrap on; -->