Pachetti: ovvero come ampliare le potenzialità di LaTeX

Coloro che usano già LaTeX avranno sicuramente compreso quanto sia semplice migliorare e/o personalizzare le impostazioni di base del programma originale.

Questa semplicità, unita alla tradizionale passione per la programmazione che contraddistigue gli utenti di LaTeX, ha fatto sì che nel corso degli anni siano state sviluppate parecchie estensioni del programma: i pacchetti (packages), capaci di soddisfare quasi ogni esigenza (se non tutte!).

Cosa sono?

Fondamentalmente un pacchetto è un file di stile (con estensione .sty), scritto in linguaggio LaTeX, contenente una serie di istruzioni che permettono di svolgere le più disparate (e spesso utilissime) operazioni.

Ad esempio, nel linguaggio standard che LaTeX usa non è possibile ruotare un ambiente table di 90° in modo che la tabella ed il rispettivo \caption (didascalia) siano allineati orizzontalmente invece che verticalmente, rispetto alla pagina. Sebastian Rathz e Leonor Barroca hanno sviluppato un pacchetto (rotating.sty) che permette di ruotare la tabella e le relative intestazioni secondo l'inclinazione voluta.

Come sapere se ne ho bisogno?

Se per ottenere il risultato sperato (ad esempio, modificare i margini della pagina oppure scrivere una lettera nello stile italiano) dovete faticare troppo, probabilmente qualcuno, trovatosi nella stessa vostra condizione, ha già pensato di creare un pacchetto per semplificarsi (e semplificarvi) il lavoro.

Viceversa, può esservi recapitato un file sorgente e alla compilazione LaTeX ritorna un errore del tipo
Can't find file rotating.sty
significa che l'autore del file usa quel pacchetto (in questo caso, rotating.sty) che nella vostra distribuzione [La]TeX non è presente. In questo caso seguite le istruzioni della sezione Come installarli?

Come scoprire qual è il pacchetto che fa al caso mio?

Questo è l'unico passaggio in cui valgono gusto, abilità personale, un pizzico di fortuna e un po' di furbizia: cercando sul motore di ricerca in questo stesso sito (usufruendo dell'archivio dei pacchetti o cercando all'interno delle pagine online) oppure nell'intero World Wide Web, si trovano molti riferimenti a soluzioni diverse che portano a risultati simili. Se vi trovate di fronte alla scelta fra uno o più modi di agire, potete fidarvi di voi stessi, di amici oppure potete chiedere un consiglio sul Forum.

Nell'esempio sulla modifica dei margini, però, troverete poca variabilità: tutti consigliano geometry per la semplicità d'uso e configurazione. Il pacchetto per scrivere lettere in italiano letteracdp, invece, è poco noto.

Come installarli?

Le due maggiori distribuzioni, MiKTeX e TeX Live (quest'ultima dalla versione 2008 in poi) permettono di installare e aggiornare i pacchetti tramite un package manager. Se però il pacchetto che si desidera installare non fa parte della distribuzione, bisogna procedere ad un'installazione manuale.

MiKTeX

Se avete un sistema operativo Windows ed usate MiKTeX, seguite questa procedura:

Avviate il programma MiKTeX Package Manager (Avvio > Programmi > MiKTeX > MiKTeX Package Manager ): apparirà una finesta con l'elenco, in ordine alfabetico, dei pacchetti disponibili nel vostro repository (archivio); in corrispondenza di ciascuno di essi, viene indicato se esso è installato e ne viene fatta una breve descrizione;
Evidenziate il nome dei pacchetti che volete installare;
Premete il tasto "+" che si evidenzierà e attendete che il processo di installazione sia concluso;
Effettuate il refresh del database dei file di MiKTeX (Avvio > Programmi > MiKTeX > MiKTeX Options > General > Refresh now).

Può capitare che non sia il pacchetto a mancarvi, ma che la versione che possedete sia troppo datata. In questo caso usate il programma MiKTeX Update Wizard, che controllerà, tramite una semplice interfaccia grafica, quali pacchetti tra quelli da voi installati sono disponibili con una nuova versione e vi proporrà di aggiornarli.

TeX Live

Il TeX Live Manager può essere usato sia da riga di comando che tramite un'interfaccia grafica.

In entrambi i casi il programma va avviato da terminale, con privilegi di amministratore (come acquisirli dipende dal sistema operativo su cui si lavora), fornendo, se si desidera l'interfaccia grafica, l'opzione --gui. MacTeX (che è la versione di TeX Live per Mac OS X) fornisce anche un'interfaccia grafica nativa per Mac, inclusa nel pacchetto MacTeXtras: TeX Live Utility. Per gli utenti Mac è quindi preferibile usare quest'ultima, che evita il ricorso a X11 e l'avvio da terminale.

Se invece si preferisce fare l'installazione da riga di comando, queste sono le operazioni più comuni da compiere:

tlmgr list elenca tutti i pacchetti disponibili, marcando con i quelli già installati;
tlmgr install <pacchetto1> <pacchetto2> ... installa i pacchetti prescelti;
tlmgr update --list elenca i pacchetti aggiornabili;
tlmgr update --all aggiorna tutti i pacchetti;
tlmgr update <pacchetto1> <pacchetto2> ... aggiorna i pacchetti prescelti;

L'interfaccia grafica rispecchia fedelmente le operazioni del programma da riga di comando. Dopo averla avviata, con tlmgr --gui, bisogna caricare l'elenco dei pacchetti, premendo il tasto Carica, nella parte alta della prima schermata. Anche in questo caso, i pacchetti già installati verranno visualizzati con una i accanto. Per installare i pacchetti prescelti basta selezionarli e premere il tasto Installa selezionati.

Per effettuare l'aggiornamento di uno, più o tutti i pacchetti, bisogna spostarsi nella scheda Aggiornamento e usare i tasti Aggiorna selezionati (dopo aver effettuato una selezione) oppure Aggiorna tutti.

Installazione manuale

Come detto in precedenza, a volte (ma è un caso che si verifica di rado) è necessario installare manualmente alcuni pacchetti non compresi nella propria distribuzione. In questo caso bisogna sapere dove vanno sistemati i file e come aggiornare la base di dati dei pacchetti, in modo che TeX li possa trovare.

Le distribuzioni TeX Live e MiKTeX prevedono tre cartelle in cui trovare i file da usare:

Albero principale: è la cartella in cui sono contenuti i file installati con la distribuzione usata, che sono disponibili per tutti gli utenti. Dal momento che l’albero principale è quello che viene gestito da eventuali aggiornamenti, è bene non modificarlo manualmente: in caso contrario, si rischia che le proprie aggiunte vengano cancellate.
Albero locale: è la cartella che rende i file disponibili a tutti gli utenti senza dover modificare manualmente l’albero principale.
Albero personale: è la cartella in cui il singolo utente può inserire i pacchetti che usa e che non sono inclusi nella distribuzione. La posizione degli alberi dipende dalla particolare distribuzione usata:
Su Windows, se si usa MiKTeX l’albero principale è la cartella C:\Programmi\MiKTeX 2.7\, l’albero locale è radicato in C:\Documents and Settings\All Users\Dati applicazioni\MiKTeX\2.7\, mentre l’albero personale si trova in C:\Documents and Settings\ \Dati applicazioni\MiKTeX\2.7\ o, equivalentemente, in C:\Documents and Settings\ \Impostazioni locali\Dati applicazioni\MiKTeX\2.7\.
Su Mac, l’albero principale si trova in /usr/local/texlive/2007/texmf-dist/, l’albero locale è radicato in /usr/local/texlive/texmf-local/ e l’albero personale è $HOME/Library/texmf/.
Su Linux, la posizione degli alberi dipende dalla particolare distribuzione usata. La radice dell’albero personale in qualsiasi distribuzione può essere controllata con la variabile $TEXMFHOME: il suo valore può essere visualizzato dalla linea di comando con kpsexpand ’$TEXMFHOME’. Allo stesso modo si possono controllare le radici degli alberi principale e locale; le variabili rilevanti sono $TEXMFDIST e $TEXMFLOCAL, il cui valore viene visualizzato lanciando rispettivamente i comandi kpsexpand ’$TEXMFDIST’ e kpsexpand ’$TEXMFLOCAL’. Su una Debian, per esempio, l’albero principale è radicato in /usr/share/texmf-texlive/, l’albero locale in /usr/share/texmf/ e l’albero personale in ~/texmf/.

Per installare un pacchetto è sufficiente:

A. copiare il relativo file .sty nella sotto-cartella /tex/latex/ di uno dei tre alberi (eventualmente creando tale sotto-cartella, se non ci fosse già);
B. per i primi due alberi è necessario aggiornare la base di dati dei pacchetti: a tal fine, se si usa la distribuzione MiKTeX ci si avvale dell’interfaccia grafica (vedi sopra), mentre se si usa TeX Live si lancia dalla linea di comando sudo mktexlsr (è necessario disporre dei privilegi di amministratore). In alternativa, è sufficiente copiare i file necessari nella stessa cartella in cui si trova il file .tex.

Come usarli?

Specificate all'interno del preambolo (prima di \begin{document}) del file .tex il nome del pacchetto che desiderate richiamare (in questo caso \usepackage{rotating}).

Come imparare a usarli al meglio?

Normalmente chi scrive un pacchetto per LaTeX scrive anche un documento in cui viene descritto il funzionamento del pacchetto stesso. La documentazione spesso però risulta essere di due tipi:

la Guida dell'Utente, pensata per chi intende solo usare il pacchetto;
la descrizione delle macro che compongono il pacchetto, ad uso di chi voglia cimentarsi nel suo sviluppo futuro.

A volte, i due tipi di documento sono uniti in un documento solo. Non spaventatevi, quindi, se cercando la Guida Utente trovate molte righe di codice: può darsi che quello che cercate sia in un altro documento.

Questi documenti sono spesso disponibili nello stesso luogo virtuale in cui vi siete muniti del pacchetto oppure vengono scaricati automaticamente nel caso usiate sistemi avanzati di gestione dei pacchetti. In caso contrario, possono essere trovati su un motore di ricerca qualsiasi: nella maggior parte dei casi, hanno lo stesso nome del pacchetto ma sono file oggetto del tipo .dvi, .ps o .pdf. A volte si chiamano guide o help con il nome del pacchetto. Se cercherete nome_pacchetto LaTeX user's guide arriverete al risultato sperato in poco tempo.

Dove si possono reperire?

I pacchetti si possono scaricare facilmente da un qualsiasi CTAN, dove si trovano o in formato .sty o compressi in file .zip (o tar.gz, nel caso di archivi compressi per GNU/Linux) insieme a file di esempio e alle istruzioni per l'uso.

E i files `.ins` e `.dtx`?

In alcuni casi, i pacchetti che si scaricano non contengono direttamente il file .sty (o .cls nel caso di classi) ma uno (o più) file di estensione .ins e .dtx. Di solito c'è sempre un file README che spiega la procedura per l'installazione, comunque in generale basta procedere in questo modo:

Per convenzione il file .dtx contiene la documentazione del pacchetto o della classe, quindi lanciando LaTeX sul .dtx si ottiene il manuale ben formattato e non un semplice e spoglio file di testo.
Lanciando invece LaTeX sul file .ins, si ottiene il file .sty desiderato (o anche più di uno, a seconda dei casi).

Processare il file .ins richiede il pacchetto LaTeX standard docstrip che, fra altre cose, elimina tutti i commenti scritti da chi ha pensato il pacchetto al fine di velocizzarne il caricamento. Una volta estratte guide e pacchetti, i file .dtx e .ins non sono più necessari e quindi possono essere tranquillamente cancellati o spostati in un archivio personale. A questo punto, per ultimare l'installazione, è sufficiente spostare i file .sty ottenuti in una cartella accessibile a LaTeX e effettuare il refresh del database come spiegato poco sopra.

Se vuoi consultare il nostro motore di ricerca per trovare il nome del pacchetto che ti occorre vai alla pagina di ricerca dei pacchetti di GuIT.