summaryrefslogtreecommitdiffstats
path: root/tde-i18n-et/docs/kdeaddons/kate-plugins/filetemplates.docbook
blob: 0a6d0ca06499aaa92bd9dbdc6f6c28cc09ddaee4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
<chapter id="filetemplates">
  <chapterinfo>

    <title
>Failimallid</title>

    <authorgroup>
      <author
><firstname
>Anders</firstname
> <surname
>Lund</surname
> <affiliation
> <address
>&Anders.Lund.mail;</address>
        </affiliation>
      </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>
<date
>2006-01-10</date
> <releaseinfo
>0.1</releaseinfo
> <keywordset>
      <keyword
>KDE</keyword>
      <keyword
>kate</keyword>
      <keyword
>tdeaddons</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
>Uus 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-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>
  </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 salvestad 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, 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>
  </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
>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>

    </sect2>

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

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

  </sect1>

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

    <para
>&kate; plugina <quote
>failimallid</quote
> autoriõigus 2004: &Anders.Lund; &Anders.Lund.mail;. </para>

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

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

<!-- kate: word-wrap on; space-indent on; indent-width 2; -->