LinuxDoc+Emacs+Ispell-HOWTO di Philippe Martin (feloy@wanadoo.fr) 27 Febbraio 1998 Questo documento è dedicato a tutti coloro che scrivono o traducono gli HOWTO di Linux o qualunque altro documento per il Linux Documenta­ tion Project (anche ILDP, ovviamente!). Può fornire loro suggerimenti su come usare i vari applicativi tra cui Emacs e Ispell. Traduzione a cura di Christopher Gabriel, cgabriel@pluto.linux.it, ultima revisione 12 Ottobre 1998. ______________________________________________________________________ Indice Generale 1. Presentazione 1.1 Copyright 1.2 Ringraziamenti 1.3 Commenti 1.4 Versioni 2. Introduzione 2.1 SGML 2.2 La tipologia LinuxDoc 2.3 SGML-Tools 3. Il vostro primo documento 3.1 Da un documento di testo 4. Configurare Emacs 4.1 Caratteri accentati 4.1.1 La visualizzazione di caratteri 8-bit 4.1.2 Digitare caratteri 8-bit 4.1.2.1 La libreria iso-acc 4.1.2.2 Il tasto (CPARAMMeta)CPARAM 4.1.3 La visualizzazione di caratteri SGML a 8-bit 4.2 Modalità SGML 4.3 Modalità PSGML 4.4 Miscellanea 4.4.1 Modalità auto-fill 5. Ispell 5.1 Impostare il dizionario predefinito 5.2 Selezionare un dizionario per determinati file 5.3 Correzione ortografica dei vostri documenti 5.4 Dizionario personale VS dizionario nel file locale 5.5 Correzione ortografica durante la digitazione 6. Trucchetti Sporchi 6.1 Inserire automaticamente un header 6.1.1 Inserendo un file 6.1.2 Avviando una routine 7. Una funzione insert-sgml-header ______________________________________________________________________ 11.. PPrreesseennttaazziioonnee 11..11.. CCooppyyrriigghhtt Copyright Philippe Martin 1998 You may redistribute and/or modify this document as long as you comply with the terms of the GNU General Public Licence, version 2 or later. L'unica licenza valida è quella originale in lingua inglese. Di seguito ne trovate una traduzione abbastanza fedele che però non ha alcun valore. Copyright Philippe Martin 1998 Potete redistribuire e/o modificare questo documento nelle modalità e limiti come descritti nella Licenza Pubblica Generale GNU, versione 2 o successive. 11..22.. RRiinnggrraazziiaammeennttii Ringrazio vivamente Sébastien Blondeel, che mi ha chiesto molto sulla configurazione di Emacs. Le sue intelligenti domande mi hanno permesso di capire meglio certe cose e di renderle disponibili a voi attraverso questo documento. 11..33.. CCoommmmeennttii Non esitate a dirmi qualunque cosa che pensate possa rendere questo documento migliore. Esaminerò le vostre critiche attentamente. Non esitate neppure a pormi domande riguardanti qualunque argomento trattato in questo documento. Sarò molto felice di rispondervi, visto che molto probabilmente questo mi permetterà di migliorare il mio lavoro (-- Nota del traduttore: Se questo italiano è orribile, allora mandatele a me!--) . 11..44.. VVeerrssiioonnii Questo documento prenderà in esame le seguenti versioni: · Sgml-tools versione 0.99, · Emacs versione 19.34, · Ispell versione 3.1, · Tutte le librerie di Emacs a cui fa riferimento questo documento sono distribuite con la versione di Emacs di cui sopra, ad eccetto di iso-sgml, che è fornito assieme a XEmacs, e psgml, che è una libreria a se stante. 22.. IInnttrroodduuzziioonnee 22..11.. SSGGMMLL _S_t_a_n_d_a_r_d _G_e_n_e_r_a_l_i_s_e_d _M_a_r_k_-_u_p _L_a_n_g_u_a_g_e, o SSGGMMLL, è un linguaggio per definire la tipologia di un documento. Per esempio, potete definire il tipo di documento _r_i_c_e_t_t_a, con una prima parte per la presentazione degli ingredienti, una seconda che introduce gli accessori, una terza che descrive le istruzioni passo passo per cuocere la torta, e una immagine finale che mostra il risultato, la torta pronta da mangiare. Questo è chiamato _D_o_c_u_m_e_n_t _T_y_p_e _D_e_f_i_n_i_t_i_o_n _(_D_T_D_), Definizione di Tipo di Documento. Non servirà a descrivere l'aspetto del prodotto finale, definisce solamente cosa può contenere. Per usare nuovamente lo stesso esempio, sono sicuro che leggendo la mia idea di ricetta, riconoscerete le vostre ricette, o le vostre preferite. In ogni caso, attualmente hanno aspetto differente: le mie hanno una piccola immagine di una tazza nell'angolo in alto a sinistra, e gli ingredienti elencati nel giardino posteriore, fra la piscina e il barbecue. Le vostre? Grazie a questa definizione standard, chiunque può scrivere un documento, senza doversi preoccupare di come apparirà al lettore. 22..22.. LLaa ttiippoollooggiiaa LLiinnuuxxDDoocc Questa tipologia è usata per scrivere, come potete avere indovinato, documenti relativi a Linux. Questi documenti sono usualmente strutturati in questo modo: un titolo di inizio, seguito dal nome dell'autore, la versione del documento e la data. Successivamente è presente una breve descrizione (non avete quindi bisogno di girellare per tutto il documento per capire di cosa si parla o per realizzare che quello che c'è scritto non vi interessa ), poi l'indice che mostra la struttura di tutto il documento, che vi permette di accedere direttamente alla sezione che più vi interessa. È presente la lista dei capitoli, delle sezioni dei paragrafi. Attraverso questi, si può inserire piccole parti di programmi, cambiare i font per enfatizzare parole o frasi, inserire liste, fare riferimenti ad altre parti del documento etc. Per scrivere questo tipo di documento, dovete specificare nel punto giusto il titolo, l'autore, la data, la versione, e ancora i capitoli e le sezioni, definire quando deve essere visualizzata una lista di oggetti, quali sono i suoi elementi etc. 22..33.. SSGGMMLL--TToooollss Gli SSGGMMLL--TToooollss permettono di creare dal documento con le vostre specifiche il risultato finale, nel formato che preferite. Se volete inserirlo nella vostra libreria privata, sceglierete _P_o_s_t_S_c_r_i_p_t. Se volete condividerlo attraverso il World Wide Web, sarà allora _H_T_M_L. Se dovete leggerlo con Windows, potete trasformarlo in _R_T_F in modo tale da renderlo leggibile con qualunque Word Processor. Oppure potete utilizzare tutti e tre questi formati, cosí sarete pronti a qualunque evenienza. Gli SGML-Tools sono disponibili via FTP anonimo a ftp://ftp.lip6.fr/pub/sgml-tools/ 33.. IIll vvoossttrroo pprriimmoo ddooccuummeennttoo 33..11.. DDaa uunn ddooccuummeennttoo ddii tteessttoo Se desiderate convertire un documento di solo testo in SGML per crearlo in altri formati, questo fa al caso vostro: 1. Aggiungete le seguenti linee all'inizio del file:
Qui metteteci il titolo nome dell'autore, email dell'autore etc versione e data 2. Se volete aggiungere una breve descrizione del documento circondate il paragrafo con i tag e . 3. Dopodiché inserite il tag , che signifiva _T_a_b_l_e _o_f _C_o_n_t_e_n_t_s, ovvero l'_I_n_d_i_c_e. 4. All'inizio di ogni nuovo capitolo, sostituite la linea contenente il numero e il titolo del capitolo con: Titolo del nuovo Capitolo e aggiungete il tag all fine del capitolo stesso. NNoottaa :: Non dovete inserire il numero del capitolo, questo viene inserito automaticamente. 5. Procede allo stesso modo per le sezioni. Dovete cancellare i loro numeri e circondate il titolo con il tag e terminate con . 6. Potete definite fino a 4 livelli di sezione nidificati, usando ande dove n= 2, 3, o 4. 7. All'inizio di ogni paragrafo, inserite il tag

. 8. Se dovete enfatizzare alcune parti del testo, usate il tag e (_i_t_a_l_i_c_o), e (ggrraasssseettttoo), o e (macchina da scrivere). 9. Per inserire una lista come la seguente: Questa è una lista di quattro elementi: - qui va la prima linea - seguita dalla seconda - ancora un'altra, per favore - ok, basta così. dovete sostituirla con: Questa è una lista di quattro elementi: qui va la prima linea seguita dalla seconda ancora un'altra, per favore ok, basta così. 10. Quando un intero blocco è parte di codice di un programma, e qualunque altra cosa deve essere evidenziata, tipo: 10 REM Oh mio Dio cosa è questo? 20 REM Penso che ormai sia scomparso! 30 PRINT "Sono tornato baby"; 40 PRINT "per salvare il mondo." 50 INPUT "Da chi? chi sei tu? ",M$ 60 IF M$="Bill" THEN PRINT "Verso la saggezza.":GOTO PARADISE 70 ELSE PRINT "Non hai via di scampo...":GOTO RICHMOND 11. In questo modo, il vostro documento SGML formattato avrà un aspetto decente. Se lo volete rifinire ulteriormenete, potete leggervi il manuale utente degli SSGGMMLL--TToooollss, che fornisco ulteriori dettagli sul tipo di documento LLiinnuuxxDDoocc. 44.. CCoonnffiigguurraarree EEmmaaccss 44..11.. CCaarraatttteerrii aacccceennttaattii Se volete scrivere documenti in francese o in qualunque altra lingua dell'Europa occidentale, avete bisogno del set di caratteri a 8-bit. Di seguito come configurare Emacs per fargli accettare questi caratteri. 44..11..11.. LLaa vviissuuaalliizzzzaazziioonnee ddii ccaarraatttteerrii 88--bbiitt Per permetter a Emacs di visualizzare caratteri a 8-bit, dovete aggiungere le seguenti linee nel vostro file .emacs: (standard-display-european 1) (load-library "iso-syntax") Se state usando Emacs su di un terminale che non ha il supporto per i caratteri 8-bit, potete usare la libreria iso-ascii ((load-library "iso-ascii")), che permette ad Emacs di visualizzare questo tipo di caratteri con la migliore approssimazione. 44..11..22.. DDiiggiittaarree ccaarraatttteerrii 88--bbiitt Se la vostra tastiera vi permette di digitare caratteri accentati, allora nessun problema. Se invece non è così ecco alcuni rimedi: 44..11..22..11.. LLaa lliibbrreerriiaa iissoo--aacccc La libreria iso-acc di Emacs vi permette di digitare caratteri 8-bit da una tastiera a 7-bit. Per utilizzarla, inserite il seguente codice nel vostro file .emacs: (load-library "iso-acc") Quindi, mentre state usando Emacs e aprendo il file che volete editare, digitate Meta-x iso-accents-mode. Potete inserire la éé della parola francese _c_a_f_é digitando '' e e. Solitamente potete inserire una lettera accentata digitando prima l'accento, e poi la lettera da accentare ( maiuscola o minuscola). I seguenti sono accenti che potete usare: ` : Grave ^ : Circonflesso " : Dieresi ~ : Tilde, cedilla, e altri casi particolari / : Per barrare una lettera etc. Se avete bisogno di uno di questi caratteri e non della lettera accentata, inseritelo facendo seguire uno spazio. Per esempio, per inserire _l_'_é_l_é_p_h_a_n_t, premete l ' _<_s_p_c_> ' e l ' e ... Potete trovare tutte le combinazioni possibili nel file iso-acc.el. 44..11..22..22.. IIll ttaassttoo_<_M_e_t_a_> Alcuni terminali vi permettono di digitare caratteri a 8-bit con il tasto_<_M_e_t_a_> (oppure _<_A_l_t_>). Per esempio, premendo _<_M_e_t_a_-_i_> otterrete il carattere éé. Ma Emacs riserva al tasto _<_M_e_t_a_> altri usi, e io so che non esiste nessuna libreria che permette di usarlo per i caratteri accentati. Questa è una soluzione: (global-set-key "\ei" '(lambda () (interactive) (insert ?\351))) _ ___ Una linea di questo genere, se inserita nel vostro .emacs, permetterà di digitare éé usando la combinazione _<_M_e_t_a_>-i. Potete ridefinire in questo modo la combinazione che permetterà di inserire ii nel tasto giusto e 335511 nel giusto codice (il collegamento con il codice viene estratto dalla tabella del set di caratteri ISO-8859-1). AAtttteennzziioonnee!! Qualche impostazione di localizzazione può ridefinire queste combinazioni. 44..11..33.. LLaa vviissuuaalliizzzzaazziioonnee ddii ccaarraatttteerrii SSGGMMLL aa 88--bbiitt Lavorando con SGML, potete accentare i caratteri con delle macro. Per esempio, il tasto éé è &&eeaaccuuttee;;. Generalmente, le applicazioni che devono leggere SGML possono gestire caratteri a 8-bit e non c'è bisogno di usare queste macro. Ma alcune di queste non sono in grado di farlo. Ma, visto che c'è un modo per risolvere questo problema, sarebbe fastidioso vedere queste applicazioni non funzionare correttamente, no? La libreria iso-sgml vi permette di digitare caratteri accentati sotto Emacs, come normale, ma quando il file sarà salvato su disco, allora questi caratteri saranno convertiti nel loro equivalente SGML. È quindi molto semplice, grazie a questa libreria, digitare e rileggere il proprio documento con Emacs, e sarete sicuri che qualunque applicazione che non supporta i caratteri 8-bit potrà accettarlo. Per usare questa libreria, dovete soltanto aggiungere le seguenti linee nel vostro file .emacs: (setq sgml-mode-hook '(lambda () "Default per SGML-mode" (load-library "iso-sgml"))) 44..22.. MMooddaalliittàà SSGGMMLL Una volta caricato un file che ha una estensione di tipo ..ssggmmll, Emacs entra automaticamente in modalità SGML, o ssggmmll--mmooddee. Se non è così, potete sempre avviarla manualmente digitando Meta-x sgml-mode, oppure automaticamente aggiungendo queste righe nel vostro .emacs: (setq auto-mode-alist (append '(("\.sgml$" . sgml-mode)) auto-mode-alist)) Questa modalità vi permette di scegliere come inserire i caratteri a 8-bit per esempi. Con Meta-x sgml-nome-8bit-mode (o la voce di menu _S_G_M_L_/_T_o_g_g_l_e _8_-_b_i_t _i_n_s_e_r_t_i_o_n), potete scegliere di digitare i caratteri a 8-bit così come sono, oppure in forma SGML, per esempio &&......;;. Per­ mette inoltre di nascondere o mostare i tag SGML, con Meta-x sgml- hide-tags e Meta-x sgml-show-tags. 44..33.. MMooddaalliittàà PPSSGGMMLL La modalità PSGML aiuta moltissimo a editare documenti SGML con Emacs. La documentazione psgml-linuxdoc spiega come installare questa modalità e usarla con _L_i_n_u_x_D_o_c. 44..44.. MMiisscceellllaanneeaa 44..44..11.. MMooddaalliittàà aauuttoo--ffiillll In modalità normale, quando digitate un paragrafo e arrivate alla fine della linea, dovete usare il tasto _<_I_n_v_i_o_> da soli per poter raggiungere la linea successiva, oppure la linea continuerà per tutto il paragrafo. Se proseguite con alcune linee oltre una larghezza ragionevole, non sarete in grado di vedere il resto della linea con alcuni editors. La modalità aauuttoo--ffiillll automatizza questa procedura, peraltro noiosa: quando arrivate a una determinata colonna (solitamente la settantesima), sarete automaticamente spostati nelle linea successiva. Il testo seguente descrive come utilizzare questa modalità, e impostare la larghezza delle vostre linee a 80: (setq sgml-mode-hook '(lambda () "Default per SGML mode." (auto-fill-mode) (setq fill-column 80))) 55.. IIssppeellll Se volete controllare l'ortografia dei vostri documenti all'interno di Emacs, allora potete usare il pacchetto IIssppeellll e la sua modalità Emacs. 55..11.. IImmppoossttaarree iill ddiizziioonnaarriioo pprreeddeeffiinniittoo Potete impostare Emacs in modo tale che quando un file viene caricato scelga automaticamente quale dizionario usare (potete selezionarne diversi). Il primo, sicuramente il piú importante, è il dizionario distribuito con Ispell. Potete scegliere fra varie lingue. Il secondo è il vostro dizionario personale, dove Ispell inserirà le parole che non può trovare nel dizionario principale ma che devono essere ricordate. Se desiderate usare come dizionario predefinito quello Francese che è distribuito con Ispell, e se volete usare il file .ispell-dico-perso, che si trova nella vostra directory home, come dizionario personale, inserite le seguenti linee nel vostro file .emacs: (setq sgml-mode-hook '(lambda () "Defaut per SGML mode." (setq ispell-personal-dictionary "~/.ispell-dico-perso") (ispell-change-dictionary "francais") )) 55..22.. SSeelleezziioonnaarree uunn ddiizziioonnaarriioo ppeerr ddeetteerrmmiinnaattii ffiillee Potreste avere qualche problema se non si fate la correzione ortografica dei vostri documenti sempre con la lingua. Se traducete documenti, è normale che passiate da un linguaggio (e dizionario) all'altro molto spesso. Non sono a conoscenza di una funzione Lisp che permetta di selezionare, sia automaticamente oppure con un click del mouse, il dizionario principale e quello personale associato al linguaggio che viene utilizzato (se qualcuno lo sa, per favore me lo dica!). In ogni caso, è possibile indicare, alla fine del file, quale dizionario volete che venga utilizzato per quel determinato documento. È sufficiente aggiungere queste specifiche come commenti, in modo tale che Ispell possa leggerli quando viene avviata la correzione ortografica. Ecco un esempio per la lingua inglese: Se avete precedentemente definito, nel vostro file .emacs, che il vostro dizionario è, per esempio, quello francese, allora potete aggiungere queste linee alla fine di ogni file scritto in inglese. 55..33.. CCoorrrreezziioonnee oorrttooggrraaffiiccaa ddeeii vvoossttrrii ddooccuummeennttii Per eseguire la correzione ortografica del vostro documento, usate, in qualcunque punto del documento, il comando Meta-x ispell-buffer. Potete in ogni caso eseguire questo controllo in una singola sezione del documento: · Marcare l'inizio della sezione con Ctrl-Spc (mark-set-command), · Muovetevi fino alla fine della sezione da correggere, · digitate Meta-x ispell-region. A questo punto Emacs avvia Ispell. Appena incontra una parola sconosciuta, questa viene mostrata evidenziata e aspetta che immettiate un comando: · ssppaazziioo accetta la parola, questa volta soltanto · ii accetta la parola e la inserisce nel dizionario personale · aa accetta la parola per questa sessione di Ispell · AA accetta la parola per questo file, e la inserisce nel dizionario personale · rr permette di correggere la parola manualmente · RR permette di correggere tutte le ricorrenze della parola che è stata corretta · xx arresta la correzione, e riporta il cursore dove si era lasciato inizialmente · XX arresta la correzione e lascia il cursore dove si trova, permettendo di correggere il file; sarete in grado di continuare la correzione in un secondo tempo usando Meta-x ispell-continue · ?? accede alla guida in linea. Se Ispell trova una o più parole nel dizionario simili a quella sconosciuta, le mostrerà in una piccola finestra, ognuna preceduta da un numero. Basta premere questo numero per sostituire la parola sbagliata con quella corrispondente. 55..44.. DDiizziioonnaarriioo ppeerrssoonnaallee VVSS ddiizziioonnaarriioo nneell ffiillee llooccaallee Il tasto ii vi permette di inserire una parola nel vostro dizionario personale, come AA permette di inserirla nel dizionario in file locale. Il dizionario nel file locale è una sequenza di parole inserite alla fine del file, come commento, rilette da Ispell ogni volta che viene eseguito sul quel file specifico. In questo modo è possibile accetare alcune parole nel file in questione, ma non in altri. Dal mio punto di vista credo che sia meglio che il dizionario personale venga utilizzato per parole che non sono contenute nel dizionario principale ma che sono tipiche del linguaggio (come le parole accentate), con in piú parole comuni come nomi propri o altre (come _L_i_n_u_x), se non sono troppo simili ad altre presenti in quello principale; aggiungere troppe parole nel dizionario personale, come nomi propri, può essere "pericoloso", poiché possono essere viste come parole della lingua in uso (immaginate Ispell alle prese con qualcosa del genere: `_W_h_e_n _t_h_e _g_o_i_n_g _g_e_t_s _t_o_f_, _t_h_e _t_o_f _g_e_t _g_o_i_n_g'). (-- _T_o_f è l'abbreviazione francese per il nome proprio _C_h_r_i_s_t_o_p_h_e!.--) 55..55.. CCoorrrreezziioonnee oorrttooggrraaffiiccaa dduurraannttee llaa ddiiggiittaazziioonnee Ispell può controllare l'ortografia mentre state digitando il vostro documento. Dovete utilizzare iissppeellll--mmiinnoorr--mmooddee per questo. Per avviarlo o arrestarlo, digitate Meta-x ispell-minor-mode. Ispell emetterà un _b_e_e_p ogni volta che digiterete una parola che non è nei due dizionari. Se questi _b_e_e_p vi stanno annoiando (oppure il vostro compagno di stanza si è stancato di voi.. ), potete rimpiazzarli con un flash sullo schermo, con il comando Meta-x set-variable RET visible-bell RET t RET. Potete anche aggiungere le seguenti linee nel vostro file .emacs e Emacs non parlerà mai piú: (setq visible-bell t) 66.. TTrruucccchheettttii SSppoorrcchhii 66..11.. IInnsseerriirree aauuttoommaattiiccaammeennttee uunn hheeaaddeerr Emacs permette di associare delle procedure ad eventi specifici (aprire un file, salvarlo, avviare una nuova modalità etc ). La libreria aauuttooiinnsseerrtt utilizza questa caratteristica: quando aprite un nuovo file con Emacs, questa libreria inserisce, dipendentemente dal tipo di file, un header _s_t_a_n_d_a_r_d. Nel nostro caso, questo header _s_t_a_n_d_a_r_d può definire il tipo di documento (LinuxDoc), il titolo, l'autore, e la data. Descriverò adesso due modi per fare questo. Potete creare un template che contenga le informazioni da inserire, oppure potete avviare una routine eelliisspp. 66..11..11.. IInnsseerreennddoo uunn ffiillee Per prima cosa dovete permettere a Emacs di avviare la auto-insert quando un file viene aperto, quindi di leggere la libreria auto-insert che dichiara la auto-insert-alist che necessita di cambiamenti. Questa lista definisce gli header da inserire per ogni tipo di file. Per default, il file da inserire deve trovarsi nella cartella ~/insert/, ma è possibile definire la variabile auto-insert-directory se volete mettere i vostri file da qualche altra parte. Aggiungere le seguenti linee al vostro .emacs per il inserire il file ~/emacs/sgml-insert.sgml ogni volta che aprite un nuovo documento SGML: (add-hook 'find-file-hooks 'auto-insert) (load-library "autoinsert") (setq auto-insert-directory "~/emacs/") (setq auto-insert-alist (append '((sgml-mode . "sgml-insert.sgml")) auto-insert-alist)) A questo punto potete scrivere nel file ~/emacs/sgml-insert.sgml il vostro header personalizzato, quindi riavviare Emacs e aprire qualche nuovo file .sgml. Emacs dovrebbe chiedervi la conferma per l'inserimento automatico, e se rispondete 'Yes', inserire il nuovo header. 66..11..22.. AAvvvviiaannddoo uunnaa rroouuttiinnee Questo funziona come prima, ma invece di impostare la auto-insert- alist in un file da inserire, dovete impostare una funzione da eseguire. Questo è il procedimento, assumendo come esempio che volete scrivere una funziona in un file chiamato ~/emacs/sgml-header.el (non è il caso di appesantire il vostro .emacs con questo tipo di funzioni, oppure diventerà troppo grande): (add-hook 'find-file-hooks 'auto-insert) (load-library "autoinsert") (add-to-list 'load-path "~/emacs") (load-library "sgml-header") (setq auto-insert-alist (append '(((sgml-mode . "SGML Mode") . insert-sgml-header)) auto-insert-alist)) Troverete nella ``appendice'' un esempio di una funzione insert-sgml- header. 77.. UUnnaa ffuunnzziioonnee iinnsseerrtt--ssggmmll--hheeaaddeerr Questa funzione permette all'utente di inserire un header personalizzato in un documento per il Linux Documentation Project all'interno di un file. Può essere richiamata automaticamente quando viene aperto un nuovo file, oppure in modo esplicito dall'utente. Questa funzione attende un input dell'utente attraverso il _m_i_n_i_- _b_u_f_f_e_r, per alcune informazioni, di cui alcune sono necessarie, altre invece no. Per prima cosa il titolo. Se non viene inserito, la funziona esce immediatamente, e niente viene inserito. Segue poi la data, l'autore, la sua email e home-page (le ultime due sono opzionali). Successivamente c'è una richiesta per il nome del traduttore. Se non volete inserire niente, basta premere _I_n_v_i_o, e nessun altra domanda circa un ipotetico traduttore verrà richiesta. Se invece ne esiste uno, verrà richiesta la sua email e home-page (come sempre opzionali). Questa funzione quindi inserirà nel file corrente tutte le informazioni da voi inserite, inclusi naturalmente tutti i tag necessari. Inserirà anche quelli per l'abstract e per il primo capitolo. Infine posizionerà il cursore dove l'abstract deve essere inserito. (defun insert-sgml-header () "Inserisce gli header per un documento LinuxDoc" (interactive) (let (title author email home translator email-translator home-translator date starting-point) (setq title (read-from-minibuffer "Titolo: ")) (if (> (length title) 0) (progn (setq date (read-from-minibuffer "Data: ") author (read-from-minibuffer "Autore: ") email (read-from-minibuffer "E-mail autore: ") home (read-from-minibuffer "Home page autore: http://") translator (read-from-minibuffer "Traduttore: ")) (insert "\n

\n") (insert title) (insert "\n\nAutore: ") (insert author) (insert "\n") (if (> (length email) 0) (progn (insert "\n"))) (if (> (length home) 0) (progn (insert "\n"))) (if (> (length translator) 0) (progn (setq email-translator (read-from-minibuffer "E-mail traduttore: ") home-translator (read-from-minibuffer "Home page traduttore: http://")) (insert "Traduzione : ") (insert translator) (insert "\n") (if (> (length email-translator) 0) (progn (insert "\n"))) (if (> (length home-translator) 0) (progn (insert "\n"))))) (insert "\n\n") (insert date) (insert "\n\n\n\n") (setq point-beginning (point)) (insert "\n\n\n\n\n

\n\n\n\n\n

\n") (goto-char point-beginning) ))))