← Back to branch summary

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

« back to all changes in this revision

Viewing changes to TeXmacs/doc/devel/plugin/plugin-write.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/devel/plugin/plugin-write.it.tm
 
1
<TeXmacs|1.0.1.18>
 
2
 
 
3
<style|tmdoc>
 
4
 
 
5
<\body>
 
6
  <expand|tmdoc-title|Scrivere un proprio plugin>
 
7
 
 
8
  Per scrivere un proprio plugin, ad esempio <verbatim|<em|mioplugin>>, si
 
9
  inizia creando la directory
 
10
 
 
11
  <\verbatim>
 
12
    \ \ \ \ $TEXMACS_HOME_PATH/plugins/<em|mioplugin>
 
13
  </verbatim>
 
14
 
 
15
  in cui sistemare tutti i file (si ricorda che <verbatim|$TEXMACS_HOME_PATH>
 
16
  per default � <verbatim|$HOME/.TeXmacs>). Opzionalmente � possibile creare
 
17
  le seguenti sottodirectory:
 
18
 
 
19
  <\expand|description-dash>
 
20
    <expand|item*|<verbatim|bin>>per file binari
 
21
 
 
22
    <expand|item*|<verbatim|doc>>per la documentazione (non ancora
 
23
    supportata).
 
24
 
 
25
    <expand|item*|<verbatim|langs>>per il supporto linguistico, come ad
 
26
    esempio il dizionario (non ancora supportata).
 
27
 
 
28
    <expand|item*|<verbatim|lib>>per le librerie
 
29
 
 
30
    <expand|item*|<verbatim|packages>>per i pacchetti di stile
 
31
 
 
32
    <expand|item*|<verbatim|progs>>per i programmi in <value|scheme>
 
33
 
 
34
    <expand|item*|<verbatim|src>>per i file sorgente
 
35
 
 
36
    <expand|item*|<verbatim|styles>>per i file di stile
 
37
  </expand>
 
38
 
 
39
  L'idea � che i file presenti in queste sottodirectory vengano
 
40
  automaticamente riconosciuti all'avvio di <TeXmacs>. Ad esempio se �
 
41
  prevista una sottodirectory <verbatim|bin> allora la stringa
 
42
 
 
43
  <\verbatim>
 
44
    \ \ \ \ $TEXMACS_HOME_PATH/plugins/<em|mioplugin>/bin
 
45
  </verbatim>
 
46
 
 
47
  verr� automaticamente aggiunta, all'avvio, alla variabile ambientale
 
48
  <verbatim|PATH>. Osserviamo come la struttura della sottodirectory di un
 
49
  plugin sia molto simile alla struttura della sottodirectory di
 
50
  <verbatim|$TEXMACS_PATH>.
 
51
 
 
52
  <\example>
 
53
    Il tipo pi� semplice di plugin consiste solo di file di dati, ossia di
 
54
    una collezione di file di stile e di pacchetti. Per creare un plugin di
 
55
    questo genere � sufficiente creare le sottodirectory:
 
56
 
 
57
    <\verbatim>
 
58
      \ \ \ \ $TEXMACS_HOME_PATH/plugins/<em|mioplugin>
 
59
 
 
60
      \ \ \ \ $TEXMACS_HOME_PATH/plugins/<em|mioplugin>/styles
 
61
 
 
62
      \ \ \ \ $TEXMACS_HOME_PATH/plugins/<em|mioplugin>/packages
 
63
    </verbatim>
 
64
 
 
65
    e sistemare i file di stile e i pacchetti nelle ultime due
 
66
    sottodirectory. Dopo aver rilanciato <TeXmacs> i file di stile e i
 
67
    pacchetti appariranno automaticamente nei menu
 
68
    <apply|menu|Document|Style> e <apply|menu|Document|Use package>.
 
69
  </example>
 
70
 
 
71
  Per plugin pi� complessi, che richiedono l'aggiunta di parti di codice in
 
72
  <value|scheme> o in <name|C++>, � necessario scrivere un file di
 
73
  configurazione in <value|scheme>
 
74
 
 
75
  <\verbatim>
 
76
    \ \ \ \ $TEXMACS_HOME_PATH/plugins/<em|mioplugin>/progs/init-<em|mioplugin>.scm
 
77
  </verbatim>
 
78
 
 
79
  che dovrebbe contenere istruzioni del tipo
 
80
 
 
81
  <\expand|scheme-fragment>
 
82
    (plugin-configure <em|myplugin>
 
83
 
 
84
    \ \ <em|configuration-options>
 
85
  </expand>
 
86
 
 
87
  dove le opzioni <verbatim|<em|configuration-options>> descrivono le
 
88
  principali azioni da eseguire all'inizio, incluso il controllo del
 
89
  funzionamento del plugin stesso. Nella sezione seguente descriveremo alcuni
 
90
  semplici plugin e la loro configurazione. Molti altri esempi sono contenuti
 
91
  nella directory
 
92
 
 
93
  <\verbatim>
 
94
    \ \ \ \ $TEXMACS_PATH/examples/plugins
 
95
  </verbatim>
 
96
 
 
97
  Alcuni di questi verranno comunque descritti in dettaglio nel capitolo
 
98
  relativo alla stesura di nuove interfacce.
 
99
 
 
100
  <apply|tmdoc-copyright|1998--2003|Joris van der Hoeven, Andrea Centomo>
 
101
 
 
102
  <expand|tmdoc-license|Permission is granted to copy, distribute and/or
 
103
  modify this document under the terms of the GNU Free Documentation License,
 
104
  Version 1.1 or any later version published by the Free Software Foundation;
 
105
  with no Invariant Sections, with no Front-Cover Texts, and with no
 
106
  Back-Cover Texts. A copy of the license is included in the section entitled
 
107
  "GNU Free Documentation License".>
 
108
</body>
 
109
 
 
110
<\initial>
 
111
  <\collection>
 
112
    <associate|paragraph width|150mm>
 
113
    <associate|odd page margin|30mm>
 
114
    <associate|shrinking factor|4>
 
115
    <associate|page right margin|30mm>
 
116
    <associate|page top margin|30mm>
 
117
    <associate|reduction page right margin|25mm>
 
118
    <associate|page type|a4>
 
119
    <associate|reduction page bottom margin|15mm>
 
120
    <associate|even page margin|30mm>
 
121
    <associate|reduction page left margin|25mm>
 
122
    <associate|page bottom margin|30mm>
 
123
    <associate|reduction page top margin|15mm>
 
124
    <associate|language|italian>
 
125
  </collection>
 
126
</initial>
 
127
 
 
128
<\references>
 
129
  <\collection>
 
130
    <associate|idx-1|<tuple|1|?>>
 
131
    <associate|toc-1|<tuple|<uninit>|?>>
 
132
    <associate|idx-2|<tuple|1|?>>
 
133
    <associate|toc-2|<tuple|<uninit>|?>>
 
134
    <associate|idx-3|<tuple|1|?>>
 
135
  </collection>
 
136
</references>
 
137
 
 
138
<\auxiliary>
 
139
  <\collection>
 
140
    <\associate|idx>
 
141
      <tuple|<tuple|<with|font family|<quote|ss>|Documento>|<with|font
 
142
      family|<quote|ss>|Stile>>|<pageref|idx-1>>
 
143
 
 
144
      <tuple|<tuple|<with|font family|<quote|ss>|Documento>|<with|font
 
145
      family|<quote|ss>|Usa pacchetto>>|<pageref|idx-2>>
 
146
    </associate>
 
147
  </collection>
 
148
</auxiliary>