summaryrefslogtreecommitdiffstats
path: root/tde-i18n-da/docs/tdeaddons/kate-plugins/filetemplates.docbook
blob: b9c3ac80829793ab59108a3f402a7f276e217e73 (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
<chapter id="filetemplates">
  <chapterinfo>

    <title
>Filskabeloner</title>

    <authorgroup>
      <author
><firstname
>Anders</firstname
> <surname
>Lund</surname
> <affiliation
> <address
>&Anders.Lund.mail;</address>
        </affiliation>
      </author>
&erik.kjaer.pedersen.role; 
    </authorgroup>
<date
>2006-01-10</date
> <releaseinfo
>0.1</releaseinfo
> <keywordset>
      <keyword
>KDE</keyword>
      <keyword
>kate</keyword>
      <keyword
>tdeaddons</keyword>
      <keyword
>skabelon</keyword>
      <keyword
>makro</keyword>
    </keywordset>
  </chapterinfo>

  <title
>Indledning</title>

  <para
>Filskabelon-plugin tillader dig at lave filer baseret på andre filer. Du kan bruge en vilkårlig fil som skabelon, hvilket vil lave en kopi af filen med en tom &URL;, eller bruge en speciel skabelonfil som kan indeholder makroer til at udfylde information s[som dit navn og e-mail-adresse, dagens dato og så videre, og placere markøren et godt sted i den nye fil.</para>
  <para
>Derudover vil skabeloner der er i skabelonmapper blive præsenteret under menupunktet <menuchoice
><guimenu
>Fil</guimenu
><guimenuitem
>Ny ud fra skabelon</guimenuitem
></menuchoice
>.</para
> <para
>Dette plugin sørger også for en metode til nemt at lave en ny skabelon ud fra et åbent dokument.</para>
  <para
>Skabelonmapper en en del af &kde;'s filsystem, og består af i det mindste  KDEDIR/share/applications/kate/plugins/katefiletemplates/templates og KDEHOME/share/applications/kate/plugins/katefiletemplates/templates. Hvis din KDEDIRS miljøvariabel indeholder yderligere mapper, gennemsøges disse også for en lignende undermappe. Hvis skabeloner med samme navn bliver fundet, så vælges den i den lokale (KDEHOME)-mappe.</para>
  <sect1 id="katefiletemplates-menu">
    <title
>Menustruktur</title>

    <variablelist>
      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Fil</guimenu
> <guimenu
>Ny fra skabelon</guimenu
> <guimenuitem
>Vilkårlig fil...</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>Præsentere dig for en 'Åbn fil'-dialog der lader dig bruge en vilkårlig fil som skabelon. Hvis den valgte fil har endelsen <filename
>katetemplate</filename
> vil den blive fortolket for skabeloninformation og makroer.</para
></listitem>
      </varlistentry>

      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Fil</guimenu
> <guimenu
>Ny fra skabelon</guimenu
> <guimenuitem
>Brug nylige</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>Præsentere en liste af filer der er blevet brugt som skabeloner for nylig, repræsenteret ved deres &URL;.</para
></listitem>
      </varlistentry>

      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Fil</guimenu
> <guimenuitem
>Ny fra skabelon</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>De tilbageværende undermenuer indeholder link til skabeloner. Klik på et menupunkt for at lave en fil som beskrevet i menupunktets tekst.</para
></listitem>
      </varlistentry>

      <!-- Settings menu -->

      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Opsætning</guimenu
><guimenuitem
>Håndtér skabeloner...</guimenuitem
></menuchoice
></term>
        <listitem
><para
>Dette vil starte en dialog med en liste af alle skabeloner fundet indeni skabelonmapperne, sammen med valgmuligheder for at tilføje, redigere eller fjerne skabeloner.</para
></listitem>
      </varlistentry>
    </variablelist>
  </sect1>

  <sect1 id="katefiletemplates-use">
    <title
>Brig en &kate;-skabelon</title>
    <para
>Når der laves en fil ud fra en skabelon der indeholder makroer, vil nogle makroer ses som redigerbare variabler i teksten. Sådanne variabler ses som understregede ord i teksten.</para>
    <para
>Den første variabel vil blive valgt, så skal blot skrive for at redigere den. Hvis dokumentets tekst indeholder flere dugaver af den samme variabel, bliver de også ændret mens du redigerer. For at gå til den næste redigerbare  variabel, så tryk på TAB-tasten. Når den sidste  variabel er redigeret, droppes listen og din TAB-tast virker igen som normalt.</para>
  </sect1>

  <sect1 id="katefiletemplates-create">
    <title
>Lav dine egen skabeloner</title>
    <para
>For at lave en ny skabelon, bruges punktet <menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Håndtér skabeloner</guimenuitem
></menuchoice
> til at starte skabelonhåndteringsdialogen. I den klikkes på <guibutton
>Ny...</guibutton
> for at startet Filskabelon-guiden. Du vil blive spurgt om der er en fil du vil lave om til en skabelon og bedt om skabeloninformationsindstillinger, og en skabelonfil vil blive lavet for dig.</para
> <para
>Alternativt kan du lave en skabelon manuelt ved at tilføje skabeloninformation foroven i en vilkårlig fil, tilføje tekst og makroer og og gemme den med endelsen <filename
>katetemplate</filename
>.</para>
    <para
>Skabelonmenuen blive automatisk opdateret hvis du valgte at gemme din skabelon i skabelonmappen.</para>
  </sect1>

  <sect1 id="katefiletemplates-edit">
    <title
>Redigering af skabeloner</title>
    <para
>For at redigere en skabelon bruges <menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Håndtér skabeloner...</guimenuitem
></menuchoice
>. Vælg skabelonen du ønsker at arbejde med og klik på <guibutton
>Redigér...</guibutton
>, så vil skabelonfilen blive åbnet. Luk dialogen, redigér skabelonfilen som ønsket, gem den og luk den. Ændringer af skabelonerne får øjeblikkelig virkning, du kan aktivere skabelonen for at teste dine ændringer efter du har gemt den.</para>
  </sect1>

  <sect1 id="katefiletemplates-format">
    <title
>&kate;'s skabelonformat</title>
    <para
>Hvis du bruger filer med endelsen <filename
>katetemplate</filename
>, vil de blive fortolket for skabeloninformation, makroer og markørposition.</para>

    <sect2 id="katefiletemplates-template-info">
      <title
>Skabeloninformation</title>
      <para
>Mens filen læses holder tolkeren linjer der begynder med udtrykket <constant
>katetemplate:</constant
> og gennemsøger dem for skabeloninformation på formen VARIABLENAME=VALUE. Den første linje der ikke starter med <constant
>katetemplate:</constant
> vil blive opfattet som skabelonens indhold. VALUE kan indeholde et vilkårligt tegn bortset fra lighedstegnet (=). Lovlige variabelnavne er: <variablelist>
          <varlistentry>
            <term
><varname
>Skabelon</varname
></term>
            <listitem
><para
>Dette er skabelonnavnet, vist i menuen <menuchoice
><guimenu
>Fil</guimenu
><guimenuitem
>Ny ud fra skabelon</guimenuitem
></menuchoice
>.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Gruppe</varname
></term>
            <listitem
><para
>Gruppen placerer skabelone i en undermenu for menuen <menuchoice
><guimenu
>Fil</guimenu
><guimenuitem
>Ny ud fra skabelon</guimenuitem
></menuchoice
>.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><varname
>Navn</varname
></term>
            <listitem
><para
>Dette er navnet der vil blive sat for dokumentet, og vist i fillisten og titellinjen. Hvis navnet indeholder <userinput
>%N</userinput
> vil det blive erstattet med et tal, der øges hvis flere dokumenter har samme navn.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Fremhæv</varname
></term>
            <listitem
><para
>Dette plugin vil forsøge at sætte fremhævning for det nye dokument til værdien for denne variabel. Værdien skal være navnet, som fundet i <menuchoice
><guimenu
>Værktøjer</guimenu
><guimenuitem
>Fremhævning</guimenuitem
> </menuchoice
>.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Beskrivelse</varname
></term>
            <listitem
><para
>En kort informativ beskrivelse af skabelonen. Dette bruges for øjeblikket til at sætte en 'Have er dette'-streng for menupunktet, men kan bruges til flere formål i fremtiden.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
>Forfatter</term>
            <listitem
><para
>En streng der identificerer forfatteren, for eksempel på formen <userinput
>Navn &lt;e-mail-adresse&gt;</userinput
>. Dette bruges for øjeblikket til at sætte en 'Have er dette'-streng for menupunktet, men kan bruges til flere formål i fremtiden.. </para
></listitem>
          </varlistentry>
        </variablelist>
      </para>

    </sect2>

    <sect2 id="katetemplates-macros">
      <title
>Skabelonmakroer</title>

      <para
>Når skabelonens indhold fortolkes, bliver makroer på formen <userinput
>%{NAME}</userinput
> eller <userinput
>${NAME}</userinput
>  udvidet. Hvis du bruger <userinput
>$</userinput
>-præfikset, vil de udvidede makroer blive behandlet som en redigerbar variabel når et  dokument oprettes ud fra skabelonen, hvorimod hvis du bruger  <userinput
>%</userinput
> sker dette ikke, medmindre udvidelsen er mislykket.</para>
      <para
>Følgende makroer udvides: <variablelist>
          <varlistentry
><term
>time</term>
            <listitem
><para
>Udvides til det nuværende tidspunkt på dit lokale format.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
>date</term>
            <listitem
><para
>Udvides til nuværende dato på kort format.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
>datetime</term>
            <listitem
><para
>Udvider til dato og tidspunkt, formateret som en streng ifølge dine lokale indstillinger.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
>year</term>
            <listitem
><para
>Det nuværende år som et fircifret tal.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
>month</term>
            <listitem
><para
>Det fulde navn på måneden, ifølge de lokale indstillinger.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
>day</term>
            <listitem
><para
>Udvides til månedens nuværende dag.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
>hostname</term>
            <listitem
><para
>Udvides til 'hostname' for din computer.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
>index</term>
            <listitem
><para
>Udvides til 'i'.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
>fullname</term>
            <listitem
><para
>Udvides til dit fulde navn, som defineret i din ejeradresse i &kde;'s standard-adressebog.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
>firstname</term>
            <listitem
><para
>Udvides til dit fornavn, som defineret i din ejeradresse i &kde;'s standard-adressebog.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
>lastname</term>
            <listitem
><para
>Udvides til dit efternavn, som defineret i din ejeradresse i &kde;'s standard-adressebog.</para>
            </listitem>
          </varlistentry>
          <!-- <varlistentry>
            <term
>username</term>
            <listitem
><para
>Expands to your username.</para
></listitem>
          </varlistentry
> -->
          <varlistentry>
            <term
>email</term>
            <listitem
><para
>Udvides til din e-mail-navn, som defineret i din ejeradresse i &kde;'s standard-adressebog.</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
>Enhver makro der ikke er i ovenstående liste behandles som en redigerbar variabel uanset præfiks. Hvis den samme variabel forekommer flere gange i skabelonen, kan de redigeres på en gang efter et dokument er oprettet ud fra skabelonen.</para>
    </sect2>

    <sect2 id="katefiletemplates-cursor">
      <title
>Indstilling af markørens position</title>
      <para
>Den specielle makro <userinput
>${cursor}</userinput
> bliver erstattet med en lodret linje og tilføjet til slutningen af redigerbare variabler, uafhængig af dens placering i teksten.</para>
    </sect2>

  </sect1>

  <sect1 id="katefiletemplates-thanks-and-acknowledgements">
    <title
>Tak og anerkendelser</title>

    <para
>&kate;-plugin <quote
>Fil-skabeloner</quote
> ophavsret 2004 &Anders.Lund; &Anders.Lund.mail;. </para>

    <para
>Dokumentation ophavsret 2004 &Anders.Lund; </para>

    &erik.kjaer.pedersen.credit; 
&underGPL; </sect1>
</chapter>

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