mirror of https://github.com/texmacs/doc.git
136 lines
5.8 KiB
Tcl
136 lines
5.8 KiB
Tcl
<TeXmacs|1.0.1.18>
|
|
|
|
<style|tmdoc>
|
|
|
|
<\body>
|
|
<expand|tmdoc-title|Opzioni di configurazione per i plugin>
|
|
|
|
Come spiegato in precedenza, il file <value|scheme> di configurazione
|
|
<verbatim|<em|mioplugin>/progs/init-<em|mioplugin>.scm>, relativo a un
|
|
plugin con nome <verbatim|<em|mioplugin>>, contiene istruzioni del tipo
|
|
|
|
<\expand|scheme-fragment>
|
|
(plugin-configure <em|mioplugin>
|
|
|
|
\ \ <em|configuration-options>)
|
|
</expand>
|
|
|
|
Di seguito sono elencate le opzioni possibili per
|
|
<verbatim|<em|configuration-options>>:
|
|
|
|
<\expand|description-dash>
|
|
<expand|item*|<verbatim|<with|font series|medium|(:require
|
|
<em|condition>)>>>questa opzione serve per specificare una
|
|
<verbatim|<em|condizione>> che deve essere soddisfatta per garantire il
|
|
funzionamento corretto del plugin. Tipicamente si va a verificare se nel
|
|
sistema sono presenti alcuni file binari o alcune librerie necessarie per
|
|
il funzionamento. Se questa condizione fallisce <TeXmacs> continuerà a
|
|
lavorare come se il plugin non esistesse. In questo caso la parte di
|
|
configurazione successiva del plugin non verrà letta. Per questa ragione
|
|
l'opzione <verbatim|:require> viene di norma scritta per prima nella
|
|
lista delle opzioni di configurazione;
|
|
|
|
<expand|item*|<verbatim|<with|font series|medium|(:versions
|
|
<em|version-cmd>)>>>questa opzione serve per specificare un'espressione
|
|
<value|scheme> <verbatim|<em|version-cmd>> che valuta la versione del
|
|
plugin;
|
|
|
|
<expand|item*|<verbatim|<with|font series|medium|(:setup
|
|
<em|cmd>)>>>questo comando viene eseguito solo quando la versione del
|
|
plugin cambia da una esecuzione di <TeXmacs> all'altra. Ciò capita
|
|
principalmente quando viene installata una nuova versione di <TeXmacs> o
|
|
viene aggiunta qualche altra applicazione accessoria;
|
|
|
|
<expand|item*|<verbatim|<with|font series|medium|(:initialize
|
|
<em|cmd>)>>>questa espressione esegue l'espressione <value|scheme>
|
|
<verbatim|<em|cmd>>. Tipicamente viene inserita subito dopo l'opzione
|
|
<verbatim|:require> in modo che il plugin venga configurato solamente una
|
|
volta appurata la sua esistenza. Per plugin che richiedono numerose
|
|
istruzioni per essere programmati è importante che il file
|
|
<verbatim|<em|mioplugin>/progs/init-<em|mioplugin>.scm> sia piccolo in
|
|
quanto esso viene eseguito ad ogni avvio di <TeXmacs>. Per ridurre il
|
|
tempo di caricamento di <TeXmacs> la maggior parte dei comandi
|
|
<value|scheme> possono essere inseriti in moduli separati, alcuni dei
|
|
quali possono essere caricati attraverso comandi di inizializzazione;
|
|
|
|
<expand|item*|<verbatim|<with|font series|medium|(:launch
|
|
<em|shell-cmd>)>>>questa opzione specifica che il plugin riesce a
|
|
valutare espressioni su una pipe; ciò avviene utilizzando un'applicazione
|
|
accessoria lanciata da riga di comando con il comando
|
|
<verbatim|<em|shell-cmd>>;
|
|
|
|
<expand|item*|<verbatim|<with|font series|medium|(:link <em|lib-name>
|
|
<em|export-struct> <em|options>)>>>questa opzione è simile a
|
|
<verbatim|:launch>, salvo che ora l'applicazione esterna viene collegata
|
|
dinamicamente. Per ulteriori informazioni si rimanda alla sezione
|
|
relativa ai <apply|hyper-link|link dinamici|../interface/interface-dynlibs.it.tm>;
|
|
|
|
<expand|item*|<verbatim|<with|font series|medium|(:session
|
|
<em|menu-nome>)>>>questa opzione indica che il plugin supporta una
|
|
valutazione per sessioni interattive da shell. Un oggetto de tipo
|
|
<verbatim|<em|menu-oggetto>> verrà inserito nel menu
|
|
<apply|menu|Insert|Session> per lanciare questo tipo di sessioni;
|
|
|
|
<expand|item*|<verbatim|<with|font series|medium|(:serializer
|
|
,<em|fun-nome>)>>>se il plugin si può utilizzare in modalità di
|
|
valutazione allora questa opzione specifica la funzione <value|scheme>
|
|
\ <verbatim|<em|fun-nome>> utilizzata per trasformare gli alberi
|
|
<TeXmacs> in stringhe;
|
|
|
|
<expand|item*|<verbatim|<with|font series|medium|(:commander
|
|
,<em|fun-nome>)>>>questo comando è simile all'opzione
|
|
<verbatim|:serializer> con la differenza che esso viene usato per
|
|
trasformare comandi speciali in stringhe;
|
|
|
|
<expand|item*|<verbatim|<with|font series|medium|(:tab-completion
|
|
,<em|flag>)>>>questo comando indica se il plugin supporta o meno i
|
|
completamenti tramite tabulatore.
|
|
</expand>
|
|
|
|
<apply|tmdoc-copyright|1998--2003|Joris van der Hoeven, Andrea Centomo>
|
|
|
|
<expand|tmdoc-license|Permission is granted to copy, distribute and/or
|
|
modify this document under the terms of the GNU Free Documentation License,
|
|
Version 1.1 or any later version published by the Free Software Foundation;
|
|
with no Invariant Sections, with no Front-Cover Texts, and with no
|
|
Back-Cover Texts. A copy of the license is included in the section entitled
|
|
"GNU Free Documentation License".>
|
|
</body>
|
|
|
|
<\initial>
|
|
<\collection>
|
|
<associate|paragraph width|150mm>
|
|
<associate|odd page margin|30mm>
|
|
<associate|shrinking factor|4>
|
|
<associate|page right margin|30mm>
|
|
<associate|page top margin|30mm>
|
|
<associate|reduction page right margin|25mm>
|
|
<associate|page type|a4>
|
|
<associate|reduction page bottom margin|15mm>
|
|
<associate|even page margin|30mm>
|
|
<associate|reduction page left margin|25mm>
|
|
<associate|page bottom margin|30mm>
|
|
<associate|reduction page top margin|15mm>
|
|
<associate|language|italian>
|
|
</collection>
|
|
</initial>
|
|
|
|
<\references>
|
|
<\collection>
|
|
<associate|idx-1|<tuple|<uninit>|?>>
|
|
<associate|toc-1|<tuple|<uninit>|?>>
|
|
<associate|idx-2|<tuple|1|?>>
|
|
<associate|toc-2|<tuple|<uninit>|?>>
|
|
<associate|idx-3|<tuple|1|?>>
|
|
</collection>
|
|
</references>
|
|
|
|
<\auxiliary>
|
|
<\collection>
|
|
<\associate|idx>
|
|
<tuple|<tuple|<with|font family|<quote|ss>|Testo>|<with|font
|
|
family|<quote|ss>|Sessione>>|<pageref|idx-1>>
|
|
</associate>
|
|
</collection>
|
|
</auxiliary>
|