← Back to branch summary

~ubuntu-branches/ubuntu/hardy/texmacs/hardy

« back to all changes in this revision

Viewing changes to TeXmacs/doc/about/contribute/documentation/tmdoc-style.it.tm

  • Committer: Bazaar Package Importer
  • Author(s): Ralf Treinen
  • Date: 2004-04-19 20:34:00 UTC
  • Revision ID: james.westby@ubuntu.com-20040419203400-g4e34ih0315wcn8v
Tags: upstream-1.0.3-R2
Import upstream version 1.0.3-R2

Show diffs side-by-side

added added

removed removed

Lines of Context:
TeXmacs/doc/about/contribute/documentation/tmdoc-style.it.tm
 
1
<TeXmacs|1.0.1.18>
 
2
 
 
3
<style|tmdoc>
 
4
 
 
5
<\body>
 
6
  <expand|tmdoc-title|Usare lo stile tmdoc>
 
7
 
 
8
  Oltre alle macro relative alle <apply|hyper-link|informazioni sul
 
9
  copyright|copyright.it.tm> e agli <apply|hyper-link|spostamenti|traversal.it.tm>
 
10
  all'interno della documentazione di cui abbiamo parlato in precedenza, lo
 
11
  stile <tmstyle|tmdoc> offre un certo numero di macro e di funzioni che, se
 
12
  necessario, possono essere di volta in volta attivate:
 
13
 
 
14
  <\description>
 
15
    <expand|item*|<markup|key>>questa macro viene utilizzata per indicare
 
16
    comandi da tastiera come <key|C-x C-s>. Le macro specializzate
 
17
    <markup|kbd-gen>, <markup|kbd-text>, <markup|kbd-math>,
 
18
    <markup|kbd-symb>, <markup|kbd-big>, <markup|kbd-large>, <markup|kbd-ia>,
 
19
    <markup|kbd-exec> e <markup|kbd-table> vengono utilizzate per comandi da
 
20
    tastiera corrispondenti ad uno specifico tipo di azione o di modalit�. Ad
 
21
    esempio, <markup|kbd-math> corrisponde al comando da tastiera per
 
22
    l'inserimento di espressioni matematiche come <expand|kbd-math|f> che
 
23
    indica l'inizio di una frazione.
 
24
 
 
25
    <expand|item*|<markup|menu>>questa funzione, che si riferisce ad un
 
26
    arbitrario numero di argomenti, permette di scrivere dei menu come
 
27
    <apply|menu|File> o <apply|menu|Document|Language>. La funzione esegue
 
28
    automaticamente la traduzione delle voci del menu che vengono inserite.
 
29
 
 
30
    <expand|item*|<markup|markup>>questa macro viene utilizzata per indicare
 
31
    macro o funzioni come <markup|section>.
 
32
 
 
33
    <expand|item*|<markup|tmstyle>>questa macro indica il nome di un file di
 
34
    stile di <TeXmacs> come <tmstyle|article>.
 
35
 
 
36
    <expand|item*|<markup|tmpackage>>questa macro indica il nome di un
 
37
    pacchetto <TeXmacs> come ad esempio il pacchetto <tmpackage|std-markup>.
 
38
 
 
39
    <expand|item*|<markup|tmdtd>>questa macro indica il nome di un <TeXmacs>
 
40
    <abbr|d.t.d.> come <tmdtd|number-env>.
 
41
  </description>
 
42
 
 
43
  Osserviamo che nessun nome di macro deve essere tradotto in lingua
 
44
  straniera! Oltre a questo si ricorda di non tradurre mai le voci dei menu,
 
45
  le quali vengono tradotte automaticamente in modo da garantire la
 
46
  sincronizzazione tra la traduzione dei manuali e la localizzazione dei menu
 
47
  di <TeXmacs>. Nel caso di marcatori, stili e pacchetti <abbr|d.t.d.>, �
 
48
  importante non alterarne il nome originale in quanto, il pi� delle volte,
 
49
  esso corrisponde al nome di un file.
 
50
 
 
51
  Le seguenti macro e funzioni, pensate per realizzare link e per gestire gli
 
52
  indici, verranno implementate in futuro:
 
53
 
 
54
  <\description>
 
55
    <expand|item*|<markup|simple-link>>questa macro ha come argomento un
 
56
    hyperlink URL <with|mode|math|x>, dove <with|mode|math|x> rappresenta
 
57
    nome e destinazione dell'hyperlink;
 
58
 
 
59
    <expand|item*|<markup|hyper-link>>questa macro definisce un normale
 
60
    hyperlink;
 
61
 
 
62
    <expand|item*|<markup|concept-link>>questa macro ha come argomento un
 
63
    concetto. Successivamente potrebbe essere creato automaticamente un
 
64
    appropriato hyperlink a partire da essa e da altra documentazione;
 
65
 
 
66
    <expand|item*|<markup|only-index>>indice di una stringa;
 
67
 
 
68
    <expand|item*|<markup|def-index>>definizione di un nuovo concetto: il
 
69
    testo viene scritto in italico e indicizzato;
 
70
 
 
71
    <expand|item*|<markup|re-index>>comparsa di un concetto definito in
 
72
    precedenza: il testo viene scritto in roman e inserito nell'indice.
 
73
  </description>
 
74
 
 
75
  In conclusione elenchiamo i seguenti tag di uso frequente:
 
76
 
 
77
  <\description>
 
78
    <expand|item*|<markup|icon>>link ad una icona in una directory centrale
 
79
    come \ <verbatim|$TEXMACS_PATH/doc/images/pixmaps>
 
80
 
 
81
    <expand|item*|<markup|screenshot>>link a una schermata. Le schermate sono
 
82
    attualmente contenuta nella directory centrale
 
83
    <verbatim|$TEXMACS_PATH/doc/images/screenshots>
 
84
 
 
85
    <expand|item*|<markup|scheme>>il linguaggio <value|scheme>;
 
86
 
 
87
    <expand|item*|<markup|cpp>>il linguaggio <value|cpp>;
 
88
 
 
89
    <expand|item*|<markup|framed-fragment>>per visualizzare una parte di
 
90
    codice in un riquadro;
 
91
 
 
92
    <expand|item*|<markup|scheme-fragment>>per un codice <value|scheme>
 
93
    multi-paragrafo;
 
94
 
 
95
    <expand|item*|<markup|cpp-fragment>>per un codice <value|cpp>
 
96
    multi-paragrafo;
 
97
 
 
98
    <expand|item*|<markup|tm-fragment>>per una parte di codice <TeXmacs> in
 
99
    formato <value|scheme>;
 
100
 
 
101
    <expand|item*|<markup|scheme-code>>per una parte di codice
 
102
    <value|scheme>;
 
103
 
 
104
    <expand|item*|<markup|cpp-code>>per una parte di codice <value|cpp>;
 
105
 
 
106
    <expand|item*|<markup|descriptive-table>>per tavole descrittive che
 
107
    possono essere utilizzate per realizzare liste di comandi da tastiera, di
 
108
    marcatori, ecc....
 
109
  </description>
 
110
 
 
111
  Lo stile <tmstyle|tmdoc> eredita numerose macro dallo stile
 
112
  <tmstyle|generic> percui, se necessario, � possibile utilizzare macro come
 
113
  <markup|em>, <markup|verbatim>, <markup|itemize>, <abbr|e cos� di seguito>.
 
114
 
 
115
  <apply|tmdoc-copyright|1998--2003|Joris van der Hoeven, Andrea Centomo>
 
116
 
 
117
  <expand|tmdoc-license|Permission is granted to copy, distribute and/or
 
118
  modify this document under the terms of the GNU Free Documentation License,
 
119
  Version 1.1 or any later version published by the Free Software Foundation;
 
120
  with no Invariant Sections, with no Front-Cover Texts, and with no
 
121
  Back-Cover Texts. A copy of the license is included in the section entitled
 
122
  "GNU Free Documentation License".>
 
123
</body>
 
124
 
 
125
<\initial>
 
126
  <\collection>
 
127
    <associate|paragraph width|150mm>
 
128
    <associate|odd page margin|30mm>
 
129
    <associate|shrinking factor|4>
 
130
    <associate|page right margin|30mm>
 
131
    <associate|page top margin|30mm>
 
132
    <associate|reduction page right margin|25mm>
 
133
    <associate|page type|a4>
 
134
    <associate|reduction page bottom margin|15mm>
 
135
    <associate|even page margin|30mm>
 
136
    <associate|reduction page left margin|25mm>
 
137
    <associate|page bottom margin|30mm>
 
138
    <associate|reduction page top margin|15mm>
 
139
    <associate|language|italian>
 
140
  </collection>
 
141
</initial>
 
142
 
 
143
<\references>
 
144
  <\collection>
 
145
    <associate|idx-1|<tuple|<uninit>|?>>
 
146
    <associate|idx-2|<tuple|<uninit>|?>>
 
147
    <associate|idx-3|<tuple|<uninit>|?>>
 
148
    <associate|idx-4|<tuple|<uninit>|?>>
 
149
    <associate|idx-5|<tuple|<uninit>|?>>
 
150
    <associate|idx-6|<tuple|<uninit>|?>>
 
151
    <associate|idx-7|<tuple|<uninit>|?>>
 
152
    <associate|idx-8|<tuple|<uninit>|?>>
 
153
    <associate|idx-9|<tuple|<uninit>|?>>
 
154
    <associate|idx-30|<tuple|<uninit>|?>>
 
155
    <associate|idx-20|<tuple|<uninit>|?>>
 
156
    <associate|idx-10|<tuple|<uninit>|?>>
 
157
    <associate|idx-40|<tuple|<uninit>|?>>
 
158
    <associate|idx-21|<tuple|<uninit>|?>>
 
159
    <associate|idx-11|<tuple|<uninit>|?>>
 
160
    <associate|idx-41|<tuple|<uninit>|?>>
 
161
    <associate|idx-31|<tuple|<uninit>|?>>
 
162
    <associate|idx-42|<tuple|<uninit>|?>>
 
163
    <associate|idx-12|<tuple|<uninit>|?>>
 
164
    <associate|idx-22|<tuple|<uninit>|?>>
 
165
    <associate|idx-32|<tuple|<uninit>|?>>
 
166
    <associate|idx-43|<tuple|<uninit>|?>>
 
167
    <associate|idx-33|<tuple|<uninit>|?>>
 
168
    <associate|idx-13|<tuple|<uninit>|?>>
 
169
    <associate|idx-23|<tuple|<uninit>|?>>
 
170
    <associate|idx-44|<tuple|<uninit>|?>>
 
171
    <associate|idx-34|<tuple|<uninit>|?>>
 
172
    <associate|idx-14|<tuple|<uninit>|?>>
 
173
    <associate|idx-24|<tuple|<uninit>|?>>
 
174
    <associate|idx-25|<tuple|<uninit>|?>>
 
175
    <associate|idx-45|<tuple|<uninit>|?>>
 
176
    <associate|idx-35|<tuple|<uninit>|?>>
 
177
    <associate|idx-15|<tuple|<uninit>|?>>
 
178
    <associate|idx-26|<tuple|<uninit>|?>>
 
179
    <associate|idx-16|<tuple|<uninit>|?>>
 
180
    <associate|idx-36|<tuple|<uninit>|?>>
 
181
    <associate|idx-27|<tuple|<uninit>|?>>
 
182
    <associate|idx-17|<tuple|<uninit>|?>>
 
183
    <associate|idx-37|<tuple|<uninit>|?>>
 
184
    <associate|idx-28|<tuple|<uninit>|?>>
 
185
    <associate|idx-18|<tuple|<uninit>|?>>
 
186
    <associate|idx-38|<tuple|<uninit>|?>>
 
187
    <associate|idx-29|<tuple|<uninit>|?>>
 
188
    <associate|idx-19|<tuple|<uninit>|?>>
 
189
    <associate|idx-39|<tuple|<uninit>|?>>
 
190
  </collection>
 
191
</references>
 
192
 
 
193
<\auxiliary>
 
194
  <\collection>
 
195
    <\associate|idx>
 
196
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|brown>|tmdoc>>|<pageref|idx-1>>
 
197
 
 
198
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
199
      green>|key>>|<pageref|idx-2>>
 
200
 
 
201
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
202
      green>|kbd-gen>>|<pageref|idx-3>>
 
203
 
 
204
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
205
      green>|kbd-text>>|<pageref|idx-4>>
 
206
 
 
207
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
208
      green>|kbd-math>>|<pageref|idx-5>>
 
209
 
 
210
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
211
      green>|kbd-symb>>|<pageref|idx-6>>
 
212
 
 
213
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
214
      green>|kbd-big>>|<pageref|idx-7>>
 
215
 
 
216
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
217
      green>|kbd-large>>|<pageref|idx-8>>
 
218
 
 
219
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
220
      green>|kbd-ia>>|<pageref|idx-9>>
 
221
 
 
222
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
223
      green>|kbd-exec>>|<pageref|idx-10>>
 
224
 
 
225
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
226
      green>|kbd-table>>|<pageref|idx-11>>
 
227
 
 
228
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
229
      green>|kbd-math>>|<pageref|idx-12>>
 
230
 
 
231
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
232
      green>|menu>>|<pageref|idx-13>>
 
233
 
 
234
      <tuple|<tuple|<with|font family|<quote|ss>|File>>|<pageref|idx-14>>
 
235
 
 
236
      <tuple|<tuple|<with|font family|<quote|ss>|Documento>|<with|font
 
237
      family|<quote|ss>|Lingua>>|<pageref|idx-15>>
 
238
 
 
239
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
240
      green>|markup>>|<pageref|idx-16>>
 
241
 
 
242
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
243
      green>|section>>|<pageref|idx-17>>
 
244
 
 
245
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
246
      green>|tmstyle>>|<pageref|idx-18>>
 
247
 
 
248
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|brown>|article>>|<pageref|idx-19>>
 
249
 
 
250
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
251
      green>|tmpackage>>|<pageref|idx-20>>
 
252
 
 
253
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|brown>|std-markup>>|<pageref|idx-21>>
 
254
 
 
255
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
256
      green>|tmdtd>>|<pageref|idx-22>>
 
257
 
 
258
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
259
      magenta>|number-env>>|<pageref|idx-23>>
 
260
 
 
261
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
262
      green>|simple-link>>|<pageref|idx-24>>
 
263
 
 
264
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
265
      green>|hyper-link>>|<pageref|idx-25>>
 
266
 
 
267
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
268
      green>|concept-link>>|<pageref|idx-26>>
 
269
 
 
270
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
271
      green>|only-index>>|<pageref|idx-27>>
 
272
 
 
273
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
274
      green>|def-index>>|<pageref|idx-28>>
 
275
 
 
276
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
277
      green>|re-index>>|<pageref|idx-29>>
 
278
 
 
279
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
280
      green>|icon>>|<pageref|idx-30>>
 
281
 
 
282
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
283
      green>|screenshot>>|<pageref|idx-31>>
 
284
 
 
285
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
286
      green>|scheme>>|<pageref|idx-32>>
 
287
 
 
288
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
289
      green>|cpp>>|<pageref|idx-33>>
 
290
 
 
291
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
292
      green>|framed-fragment>>|<pageref|idx-34>>
 
293
 
 
294
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
295
      green>|scheme-fragment>>|<pageref|idx-35>>
 
296
 
 
297
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
298
      green>|cpp-fragment>>|<pageref|idx-36>>
 
299
 
 
300
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
301
      green>|tm-fragment>>|<pageref|idx-37>>
 
302
 
 
303
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
304
      green>|scheme-code>>|<pageref|idx-38>>
 
305
 
 
306
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
307
      green>|cpp-code>>|<pageref|idx-39>>
 
308
 
 
309
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
310
      green>|descriptive-table>>|<pageref|idx-40>>
 
311
 
 
312
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|brown>|tmdoc>>|<pageref|idx-41>>
 
313
 
 
314
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|brown>|generic>>|<pageref|idx-42>>
 
315
 
 
316
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
317
      green>|em>>|<pageref|idx-43>>
 
318
 
 
319
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
320
      green>|verbatim>>|<pageref|idx-44>>
 
321
 
 
322
      <tuple|<tuple|<with|font family|<quote|tt>|color|<quote|dark
 
323
      green>|itemize>>|<pageref|idx-45>>
 
324
    </associate>
 
325
  </collection>
 
326
</auxiliary>