~ubuntu-branches/ubuntu/intrepid/kde-l10n-ca/intrepid

« back to all changes in this revision

Viewing changes to docs/kdesdk/kate-plugins/filetemplates.docbook

  • Committer: Bazaar Package Importer
  • Author(s): Jonathan Riddell
  • Date: 2008-01-06 08:12:06 UTC
  • Revision ID: james.westby@ubuntu.com-20080106081206-uw248cwxfxui6j4f
Tags: upstream-4.0.0
Import upstream version 4.0.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<chapter id="filetemplates">
 
2
  <chapterinfo>
 
3
 
 
4
    <title
 
5
>Plantilles de fitxer</title>
 
6
 
 
7
    <authorgroup>
 
8
      <author
 
9
><firstname
 
10
>Anders</firstname
 
11
> <surname
 
12
>Lund</surname
 
13
> <affiliation
 
14
> <address
 
15
>&Anders.Lund.mail;</address>
 
16
        </affiliation>
 
17
      </author>
 
18
&traductor.Antoni.Bella; 
 
19
    </authorgroup>
 
20
<date
 
21
>10 de gener del 2006</date
 
22
> <releaseinfo
 
23
>0.1</releaseinfo
 
24
> <keywordset>
 
25
      <keyword
 
26
>KDE</keyword>
 
27
      <keyword
 
28
>kate</keyword>
 
29
      <keyword
 
30
>kdeaddons</keyword>
 
31
      <keyword
 
32
>plantilla</keyword>
 
33
      <keyword
 
34
>macro</keyword>
 
35
    </keywordset>
 
36
  </chapterinfo>
 
37
 
 
38
  <title
 
39
>Introducció</title>
 
40
 
 
41
  <para
 
42
>El connector per a plantilles de fitxer us permetrà crear fitxers basats en d'altres fitxers. Podeu usar qualsevol fitxer com a plantilla, creant-se una còpia del fitxer amb una &URL; buida, o usar una plantilla de fitxer especial que pot contenir macros que completin la informació, tal com el nom i l'adreça de correu electrònic, la data actual, variables d'entorn i la posició en que s'haurà de situar el cursor en el nou fitxer.</para>
 
43
  <para
 
44
>A més, les plantilles que es trobin en la carpeta de plantilles es presentaran en l'ítem de menú <menuchoice
 
45
><guimenu
 
46
>Fitxer</guimenu
 
47
><guimenuitem
 
48
>Nou des de la plantilla</guimenuitem
 
49
></menuchoice
 
50
>.</para
 
51
> <para
 
52
>El connector també proveeix un mètode per a crear una plantilla nova d'una manera fàcil a partir d'un document obert.</para>
 
53
  <para
 
54
>La carpeta de plantilles formen part del sistema de fitxers de &kde; i almenys consisteix en KDEDIR/share/applications/kate/plugins/katefiletemplates/templates i KDEHOME/share/applications/kate/plugins/katefiletemplates/templates. Si la vostra variable d'entorn KDEDIRS conté directoris addicionals, es realitzarà la recerca de forma similar. Si es troben plantilles amb el mateix nom, es triarà la que es trobi en la carpeta local (KDEHOME).</para>
 
55
  <sect1 id="katefiletemplates-menu">
 
56
    <title
 
57
>Estructura del menú</title>
 
58
 
 
59
    <variablelist>
 
60
      <varlistentry>
 
61
        <term>
 
62
          <menuchoice
 
63
><guimenu
 
64
>Fitxer</guimenu
 
65
> <guimenu
 
66
>Nou des de la plantilla</guimenu
 
67
> <guimenuitem
 
68
>Qualsevol fitxer...</guimenuitem
 
69
> </menuchoice>
 
70
        </term>
 
71
        <listitem
 
72
><para
 
73
>Mostra un diàleg per obrir un fitxer que us permetrà usar qualsevol fitxer com a plantilla. Si el fitxer escollit te l'extensió <filename
 
74
>katetemplate</filename
 
75
> serà analitzat per obtenir la informació de la plantilla així com les macros.</para
 
76
></listitem>
 
77
      </varlistentry>
 
78
 
 
79
      <varlistentry>
 
80
        <term>
 
81
          <menuchoice
 
82
><guimenu
 
83
>Fitxer</guimenu
 
84
> <guimenu
 
85
>Nou des de la plantilla</guimenu
 
86
> <guimenuitem
 
87
>Usa recent</guimenuitem
 
88
> </menuchoice>
 
89
        </term>
 
90
        <listitem
 
91
><para
 
92
>Mostra una llista amb els últims fitxers usats com a plantilles, representats per la seva &URL;.</para
 
93
></listitem>
 
94
      </varlistentry>
 
95
 
 
96
      <varlistentry>
 
97
        <term>
 
98
          <menuchoice
 
99
><guimenu
 
100
>Fitxer</guimenu
 
101
> <guimenuitem
 
102
>Nou des de la plantilla</guimenuitem
 
103
> </menuchoice>
 
104
        </term>
 
105
        <listitem
 
106
><para
 
107
>La resta dels submenús contenen enllaços a les plantilles. Feu clic en una de les opcions per a crear un fitxer com el descrit pel text de l'ítem del menú.</para
 
108
></listitem>
 
109
      </varlistentry>
 
110
 
 
111
      <!-- Settings menu -->
 
112
 
 
113
      <varlistentry>
 
114
        <term>
 
115
          <menuchoice
 
116
><guimenu
 
117
>Arranjament</guimenu
 
118
><guimenuitem
 
119
>Gestiona plantilles...</guimenuitem
 
120
></menuchoice
 
121
></term>
 
122
        <listitem
 
123
><para
 
124
>Això carregarà un diàleg amb una llista de totes les plantilles trobades en el directori de plantilles, amb opcions per afegir, editar i eliminar plantilles.</para
 
125
></listitem>
 
126
      </varlistentry>
 
127
    </variablelist>
 
128
  </sect1>
 
129
 
 
130
  <sect1 id="katefiletemplates-use">
 
131
    <title
 
132
>Usar una plantilla al &kate;</title>
 
133
    <para
 
134
>Quan es crea un fitxer des d'una plantilla aquest pot contenir macros, algunes macros apareixen com a variables editables en el text. Les variables es mostren com a paraules subratllades en el text.</para>
 
135
    <para
 
136
>La primera variable serà seleccionada, i tot seguit podeu editar-la. Si el document de text conté més instàncies de la mateixa variable, seran canviades a la vegada que l'editeu. Per abastar la següent variable editable feu clic de la tecla &Tab;. Quan s'hagi editat l'última variable, s'abandonarà la llista i la tecla &Tab; funcionarà de manera normal.</para>
 
137
  </sect1>
 
138
 
 
139
  <sect1 id="katefiletemplates-create">
 
140
    <title
 
141
>Crear les vostres plantilles</title>
 
142
    <para
 
143
>Per a crear una nova plantilla, useu l'opció <menuchoice
 
144
><guimenu
 
145
>Arranjament</guimenu
 
146
> <guimenuitem
 
147
>Gestiona plantilles</guimenuitem
 
148
></menuchoice
 
149
> que inicia el diàleg de gestió de plantilles. Tot seguit, feu clic a <guibutton
 
150
>Nova...</guibutton
 
151
> per iniciar l'assistent de fitxers de plantilla. Se us demanarà per un nom de fitxer opcional i se us demanarà per les preferències per a la plantilla, creant-se una plantilla de fitxer.</para
 
152
> <para
 
153
>Alternativament, podeu crear una plantilla manualment afegint la informació sobre la mateixa a la part superior de qualsevol fitxer, afegiu text i macros, i deseu-lo amb l'extensió <filename
 
154
>katetemplate</filename
 
155
>.</para>
 
156
    <para
 
157
>El menú de plantilles s'actualitza automàticament si decidiu desar la plantilla en el directori de plantilles.</para>
 
158
  </sect1>
 
159
 
 
160
  <sect1 id="katefiletemplates-edit">
 
161
    <title
 
162
>Editar plantilles</title>
 
163
    <para
 
164
>Per a editar una plantilla, useu l'opció <menuchoice
 
165
><guimenu
 
166
>Arranjament</guimenu
 
167
><guimenuitem
 
168
>Gestiona plantilles...</guimenuitem
 
169
></menuchoice
 
170
>. Seleccioneu la plantilla amb la que voleu treballar i feu clic a <guibutton
 
171
>Edita...</guibutton
 
172
>, el que farà que s'obri el fitxer de plantilla. Tanqueu el diàleg, editeu el fitxer de plantilla, deseu-lo i tanqueu-lo. Els canvis de la plantilla tindran efecte immediat, podent activar la plantilla per a provar els vostres canvis després de desar-la.</para>
 
173
  </sect1>
 
174
 
 
175
  <sect1 id="katefiletemplates-format">
 
176
    <title
 
177
>El format de la plantilla de &kate;</title>
 
178
    <para
 
179
>Si useu fitxers amb l'extensió <filename
 
180
>katetemplate</filename
 
181
>, seran analitzats per obtenir la informació de la plantilla, macros i una posició del cursor.</para>
 
182
 
 
183
    <sect2 id="katefiletemplates-template-info">
 
184
      <title
 
185
>Informació de la plantilla</title>
 
186
      <para
 
187
>Mentre llegiu el fitxer, l'analitzador desa les línies que comencen amb <constant
 
188
>katetemplate:</constant
 
189
> i hi cerca informació per a la plantilla amb la forma NOMVARIABLE=VALOR. La primera línia que no comenci amb <constant
 
190
>katetemplate:</constant
 
191
> se prendrà per a l'inici del contingut de la plantilla. VALOR pot contenir qualsevol caràcter excepte el signe igual (=). Son noms vàlids de variable: <variablelist>
 
192
          <varlistentry>
 
193
            <term
 
194
><varname
 
195
>Plantilla</varname
 
196
></term>
 
197
            <listitem
 
198
><para
 
199
>Aquest és el nom de la plantilla, el qual es mostra en el menú <menuchoice
 
200
><guimenu
 
201
>Fitxer</guimenu
 
202
><guimenuitem
 
203
>Nou des de la plantilla</guimenuitem
 
204
></menuchoice
 
205
>.</para
 
206
></listitem>
 
207
          </varlistentry>
 
208
          <varlistentry>
 
209
            <term
 
210
><varname
 
211
>Grup</varname
 
212
></term>
 
213
            <listitem
 
214
><para
 
215
>El grup situa la plantilla en un submenú dins del menú <menuchoice
 
216
><guimenu
 
217
>Fitxer</guimenu
 
218
><guimenuitem
 
219
>Nou des de la plantilla</guimenuitem
 
220
></menuchoice
 
221
>.</para
 
222
></listitem>
 
223
          </varlistentry>
 
224
          <varlistentry
 
225
><term
 
226
><varname
 
227
>Nom</varname
 
228
></term>
 
229
            <listitem
 
230
><para
 
231
>Aquest és el nom que serà establert per al document, i que es mostrarà en la llista de fitxers i en la barra de títol. Si el nom conté <userinput
 
232
>%N</userinput
 
233
> això serà substituït amb un número, que s'incrementarà si hi ha més documents amb el mateix nom.</para
 
234
></listitem>
 
235
          </varlistentry>
 
236
          <varlistentry>
 
237
            <term
 
238
><varname
 
239
>Ressaltat</varname
 
240
></term>
 
241
            <listitem
 
242
><para
 
243
>El connector intentarà establir Highlight per als documents nous el valor d'aquesta variable. El valor hauria de ser el nom tal i com es troba en <menuchoice
 
244
><guimenu
 
245
>Eines</guimenu
 
246
> <guimenuitem
 
247
>Ressaltat</guimenuitem
 
248
></menuchoice
 
249
>.</para>
 
250
            </listitem>
 
251
          </varlistentry>
 
252
          <varlistentry>
 
253
            <term
 
254
><varname
 
255
>Descripció</varname
 
256
></term>
 
257
            <listitem
 
258
><para
 
259
>Una petita descripció informativa de la plantilla. Actualment s'usa per establir una cadena Què és això? per a l'ítem de menú, però en el futur es podrà usar per a més propòsits.</para
 
260
></listitem>
 
261
          </varlistentry>
 
262
          <varlistentry
 
263
><term
 
264
>Autor</term>
 
265
            <listitem
 
266
><para
 
267
>Una cadena identificant l'autor, per exemple en el formulari <userinput
 
268
>Nom &lt;adreça de correu electrònic&gt;</userinput
 
269
>. Actualment s'usa per establir una cadena Què és això? per a l'ítem de menú, però en el futur es podrà usar per a més propòsits.</para
 
270
></listitem>
 
271
          </varlistentry>
 
272
        </variablelist>
 
273
      </para>
 
274
 
 
275
    </sect2>
 
276
 
 
277
    <sect2 id="katetemplates-macros">
 
278
      <title
 
279
>Plantilla de macros</title>
 
280
 
 
281
      <para
 
282
>Mentre s'analitza el contingut de la plantilla, s'expandeixen les macros en la forma <userinput
 
283
>%{NAME}</userinput
 
284
> o <userinput
 
285
>${NAME}</userinput
 
286
>. Si useu el prefix <userinput
 
287
>$</userinput
 
288
>, la macro expandida serà tractada com una variable editable quan es crei el document des d'una plantilla, mentre que si useu <userinput
 
289
>%</userinput
 
290
> no, a menys que l'expansió falli.</para>
 
291
      <para
 
292
>S'expandiran les següents macros: <variablelist>
 
293
          <varlistentry
 
294
><term
 
295
>hora</term>
 
296
            <listitem
 
297
><para
 
298
>Expandeix a l'hora actual en el vostre format local.</para
 
299
></listitem>
 
300
          </varlistentry>
 
301
          <varlistentry>
 
302
            <term
 
303
>data</term>
 
304
            <listitem
 
305
><para
 
306
>Expandeix a la data actual en el seu format curt.</para
 
307
></listitem>
 
308
          </varlistentry>
 
309
          <varlistentry>
 
310
            <term
 
311
>datetime</term>
 
312
            <listitem
 
313
><para
 
314
>Expandeix a la data i hora actuals, d'acord al vostre format local.</para
 
315
></listitem>
 
316
          </varlistentry>
 
317
          <varlistentry>
 
318
            <term
 
319
>any</term>
 
320
            <listitem
 
321
><para
 
322
>L'any actual com un número de quatre dígits.</para
 
323
></listitem>
 
324
          </varlistentry>
 
325
          <varlistentry>
 
326
            <term
 
327
>mes</term>
 
328
            <listitem
 
329
><para
 
330
>El nom complet del mes actual, d'acord al vostre format local.</para
 
331
></listitem>
 
332
          </varlistentry>
 
333
          <varlistentry
 
334
><term
 
335
>day</term>
 
336
            <listitem
 
337
><para
 
338
>Expandeix al dia actual del mes.</para>
 
339
            </listitem>
 
340
          </varlistentry>
 
341
          <varlistentry
 
342
><term
 
343
>hostname</term>
 
344
            <listitem
 
345
><para
 
346
>Expandeix al nom del vostre ordinador (hostname).</para>
 
347
            </listitem>
 
348
          </varlistentry>
 
349
          <varlistentry
 
350
><term
 
351
>index</term>
 
352
            <listitem
 
353
><para
 
354
>Expandeix a 'i'.</para
 
355
></listitem>
 
356
          </varlistentry>
 
357
          <varlistentry
 
358
><term
 
359
>fullname</term>
 
360
            <listitem
 
361
><para
 
362
>Expandeix al vostre nom complet, tal i com està definit per al destinatari propietari en la vostra llibreta d'adreces de &kde;.</para
 
363
></listitem>
 
364
          </varlistentry>
 
365
          <varlistentry
 
366
><term
 
367
>firstname</term>
 
368
            <listitem
 
369
><para
 
370
>Expandeix al vostre primer nom, tal i com està definit per al destinatari propietari en la vostra llibreta d'adreces de &kde;.</para>
 
371
            </listitem>
 
372
          </varlistentry>
 
373
          <varlistentry
 
374
><term
 
375
>lastname</term>
 
376
            <listitem
 
377
><para
 
378
>Expandeix al vostre cognom, tal i com està definit per al destinatari propietari en la vostra llibreta d'adreces de &kde;.</para>
 
379
            </listitem>
 
380
          </varlistentry>
 
381
          <!-- <varlistentry>
 
382
            <term
 
383
>username</term>
 
384
            <listitem
 
385
><para
 
386
>Expands to your username.</para
 
387
></listitem>
 
388
          </varlistentry
 
389
> -->
 
390
          <varlistentry>
 
391
            <term
 
392
>correu electrònic</term>
 
393
            <listitem
 
394
><para
 
395
>Expandeix a la vostra adreça de correu electrònic, tal i com està definit per al destinatari propietari en la vostra llibreta d'adreces de &kde;.</para
 
396
></listitem>
 
397
          </varlistentry>
 
398
          <!--<varlistentry>
 
399
            <term
 
400
>organisation</term>
 
401
            <listitem
 
402
><para
 
403
>This is your organisation, as defined by
 
404
                the owner address in your standard KDE
 
405
                addressbook.</para
 
406
></listitem>
 
407
          </varlistentry
 
408
>-->
 
409
        </variablelist>
 
410
      </para>
 
411
      <para
 
412
>Qualsevol macro que no estigui inclosa en l'anterior llista anterior serà tractada com una variable editable sense importar el prefix. Si la mateixa variable apareix en varies ocasions en la plantilla, serà editada d'una sola vegada després d'haver creat un document a partir d'una plantilla.</para>
 
413
    </sect2>
 
414
 
 
415
    <sect2 id="katefiletemplates-cursor">
 
416
      <title
 
417
>Establir la posició del cursor</title>
 
418
      <para
 
419
>La macro especial <userinput
 
420
>${cursor}</userinput
 
421
> serà substituïda amb una barra vertical i s'afegirà al final de la llista de variables editables, independentment de la seva localització en el text.</para>
 
422
    </sect2>
 
423
 
 
424
  </sect1>
 
425
 
 
426
  <sect1 id="katefiletemplates-thanks-and-acknowledgements">
 
427
    <title
 
428
>Agraïments i reconèixements</title>
 
429
 
 
430
    <para
 
431
>El connector <quote
 
432
>Plantilles de fitxer</quote
 
433
> de &kate; te copyright 2004 de &Anders.Lund; &Anders.Lund.mail;. </para>
 
434
 
 
435
    <para
 
436
>Documentació copyright 2004 de &Anders.Lund; </para>
 
437
 
 
438
    <para
 
439
>Traductor de la documentació: &credits.Antoni.Bella;</para
 
440
 
441
&underGPL; </sect1>
 
442
</chapter>
 
443
 
 
444
<!-- kate: word-wrap on; space-indent on; indent-width 2; -->
 
 
b'\\ No newline at end of file'