Non è mia intenzione spiegare qui come si installa Emacs né tanto meno AUCTeX (anche perché questi pacchetti sono forniti dalla maggior parte delle distribuzioni GNU/Linux, l'installazione è quindi molto semplice se si conosce il funzionamento del proprio gestore pacchetti), ma piuttosto illustrare quali sono le opzioni di AUCTeX (e qualcuna propria di Emacs) che ho trovato personalmente utili. Darò per scontato che si abbia un minimo di familiarità con Emacs, con la notazione delle scorciatoie e dei comandi e anche con AUCTeX (qualche volta però ricorderò come eseguire alcune operazioni). Prima di iniziare ricordo che si può consultare il manuale (in inglese) di AUCTeX all'indirizzo http://www.gnu.org/software/auctex/manual/auctex.html oppure direttamente dentro Emacs con
C-h i d m AUCTeX RET. Per la modifica di buona parte delle opzioni seguenti AUCTeX dovrà essere già caricato. Non sono un grande esperto di Emacs, potrei dire a volte delle sciocchezze, spero che mi perdoniate e sono graditi consigli (a ogni modo vi posso assicurare che seguendo questa guida non vi scoppierà il pc :-D).In AUCTeX è possibile eseguire varie operazioni come compilazione, esecuzione di
bibtex, esecuzione di makeindex, cancellazione dei file temporanei, ecc... usando C-c C-c (seguito dal comando che si desidera usare). La cancellazione dei file temporanei viene eseguita usando l'elenco delle estensioni dei file salvato nella variabile LaTeX-clean-intermediate-suffixes. Per modificare questa variabile (come tutte le variabili di Emacs, naturalmente sostituendo il nome dove opportuno) si può usare il comando (ricordo che i comandi possono essere inseriti con M-x, dove M è il cosiddetto tasto Meta e può essere ottenuto con l'ALT, oppure, se non è presente tale tasto, con ESC (rilasciare ESC dopo averlo premuto)):customize-variable RET LaTeX-clean-intermediate-suffixes RETPer aggiungere nuove estensioni selezionare
INS e inserire di fianco a Regexp: l'espressione regolare (per maggiori informazioni sulle espressioni regolari in Emacs si può consultare il manuale di Elisp in Emacs oppure vedere qui) corrispondente all'estensione che si vuole aggiungere. Per esempio io ho aggiunto le estensioni .tex~ (i file di backup creati da Emacs) e .run.xml (file usati per creare la bibliografia con il pacchetto biblatex) con le seguenti espressioni regolari:\.tex~ \.run\.xmlPer rendere definitiva la modifica selezionare
Save for future sessions (bisognerà fare lo stesso ogni volta che si usa customize-variable).Emacs si preoccupa anche di indentare correttamente il codice, compresi i vari ambienti. Si può in particolare impostare l'editor in modo che quando viene premuto il tasto di Invio (o, nella notazione di Emacs,
RET) il cursore si porti, nel rigo successivo, nella giusta posizione richiesta da una corretta indentazione. Per fare ciò bisogna modificare la variabile TeX-newline-function con il comando:customize-variable RET TeX-newline-function RETSelezionare
Value Menu e scegliere newline-and-indent. È possibile anche modificare il comportamento di Emacs nell'indentazione all'interno di determinati ambienti modificando la variabile LaTeX-indent-environment-list, sempre con il comando:customize-variable RET LaTeX-indent-environment-list RETIo, per esempio, ho aggiunto l'ambiente
lstlisting per fare in modo che Emacs non aggiungesse automaticamente il rientro per il testo inserito in questo ambiente. Per fare ciò ho selezionato INS, scritto lstlisting di fianco a Environment: e dopo aver messo la spunta a Function: ho scritto nel relativo spazio current-indentation (proprio come risulta di default per l'ambiente verbatim). Emacs permette anche l'evidenziazione della sintassi di LaTeX, ma in alcuni (rari) casi può andare in difficoltà. Per esempio ho avuto problemi con il già citato ambiente
lstlisting in quanto AUCTeX 11.86 non conosce bene il suo funzionamento (per esempio l'inserimento del simbolo del dollaro $ rovina tutta l'evidenziazione del documento). Per fortuna è possibile spiegargli che lo deve trattare allo stesso modo dell'ambiente verbatim (in pratica tutto ciò che si trova all'interno di questo ambiente non viene interpretato da Emacs per quanto riguarda l'evidenziazione della sintassi) modificando la variabile LaTeX-verbatim-environments:customize-variable RET LaTeX-verbatim-environments RETaggiungete
lstlisting (penso che ormai avrete capito come funziona questo tipo di interfaccia di modifica delle variabili) e il gioco è fatto.In maniera predefinita Emacs compila i documenti in formato DVI. Se invece si vuole impostare in maniera predefinita il formato PDF bisogna modificare il valore della variabile
TeX-PDF-mode:customize-variable RET TeX-PDF-mode RETSelezionare
Toggle fino ad arrivare a on (non-nil).Se si è installata una distribuzione di LaTeX in un percorso non riconosciuto immediatamente da Emacs e AUCTeX bisognerà modificare alcune variabili. Per esempio, io ho installato TeX Live 2010 seguendo questa guida di Enrico Gregorio e tutti i file di LaTeX si trovano in sottocartelle di
/usr/local/texlive/2010/ (in cui Emacs e AUCTeX normalmente non cercano). Fra le variabili che potrebbero dover essere cambiate ci sono TeX-macro-global (contiene, ricorsivamente, le cartelle in cui AUCTeX cercherà i file di stile) e exec-path (contiene i percorsi in cui Emacs cerca i programmi da eseguire). La modifica di queste variabili è simile a quanto visto finora. Per la prima variabile ho aggiunto il percorso /usr/local/texlive/2010/texmf-dist/tex/, mentre per exec-path ho aggiunto /usr/local/texlive/2010/bin/i386-linux/ (su architetture diverse dal 32 bit questo percorso sarà sicuramente diverso. Controllate per bene la posizione in cui avete installato la distribuzione).Per modificare il programma con cui viene aperto il documento di output (sia esso in formato DVI, PDF, HTML, ecc) tramite
C-c C-c View RET bisogna modificare la variabile TeX-view-program-selection. Come al solito per personalizzare la variabile si può usarecustomize-variable RET TeX-view-program-selection RETLe impostazioni viste finora vengono salvate automaticamente da Emacs nel file di inizializzazione
~/.emacs (ricordo che la tilde ~ è un'abbreviazione del percorso della propria cartella home, mentre i file che hanno il nome che inizia con un punto sono nascosti). Tutte queste impostazioni possono essere anche memorizzate modificando manualmente il file .emacs (per poter fare ciò autonomamente bisogna però conoscere il linguaggio Emacs Lisp). Vediamo ora qualche altra utile opzione che imposteremo modificando direttamente il file .emacs (queste comunque possono sempre essere impostate anche utilizzando l'interfaccia di customize-variable).Il manuale di AUCTeX suggerisce di aggiungere a
.emacs le seguenti linee:(setq TeX-auto-save t) (setq TeX-parse-self t)in modo che ottenere supporto per i pacchetti LaTeX che vengono usati nei propri documenti (l'opzione
TeX-parse-self fa effettuare a Emacs il parsing del documento e le informazioni verranno raccolte in una sottocartella della directory del documento modificato chiamata auto/. Se non si desidera affollamento nelle proprie cartelle si potrebbe non voler attivare queste due opzioni).Se si usa frequentemente suddividere i propri documenti LaTeX in più parti da includere nel file principale con i comandi
\input o \include può essere utile aggiungere al file .emacs l'opzione(setq-default TeX-master nil)In questo modo, all'apertura dei documenti LaTeX Emacs chiederà qual è il file principale associato (su cui dovrà, per esempio, eseguire i comandi di compilazione).
Si può far in modo che all'apertura di un documento LaTeX Emacs esegua il controllo ortografico al volo aggiungendo a
.emacs l'opzione(add-hook 'TeX-mode-hook 'flyspell-mode)Inoltre, se si usa spesso LaTeX per comporre documenti matematici potrebbe essere utile aggiungere l'opzione
(add-hook 'TeX-mode-hook 'LaTeX-math-mode)che permette il rapido inserimento di numerosi simboli matematici (vedi manuale). Infine, per fare in modo che il cursore vada a capo dopo l'inserimento di un numero prefissato di caratteri per rigo (ovviamene Emacs è intelligente, non spezza una parola in due, va a capo in modo che il rigo risulti lungo al massimo il numero prefissato di caratteri) si può aggiungere l'opzione
(add-hook 'TeX-mode-hook 'turn-on-auto-fill)Il numero di caratteri per rigo dopo il quale Emacs dovrà andare a capo è salvato nella variabile
fill-column. Lascio per esercizio scoprire come si modifica tale variabile (ok, lascio un indizio: si può usare sempre il solito comando :-D).Per effettuare un controllo della sintassi al volo si può inserire questo codice nel file di inizializzazione:
(require 'flymake) (defun flymake-get-tex-args (file-name) (list "chktex" (list "-q" "-v0" file-name))) (add-hook 'LaTeX-mode-hook 'flymake-mode)I dettagli di questa istruzioni e sue alternative sono illustrati nel post Emacs: effettuare il controllo della sintassi di documenti LaTeX.
