LaTeX, Breve guida ai pacchetti di uso più comune

Enrico Gregorio

LATEX

Breve guida ai pacchetti di uso pi comune

Edizione di novembre 2006

Introduzione

Una breve guida non pu sostituire i pi ampi manuali disponibili con ogni distribuzionemoderna di LATEX. Vuole invece dare una rapida indicazione di come poter usare i principalicomandi e ambienti messi a disposizione dai pacchetti descritti.

Non trattiamo qui dellinstallazione; i primi sedici pacchetti che verranno analizzati devonoessere presenti in tutte le distribuzioni fin dallinizio. Lunico di questi che richiede un inter-vento dellutente babel, per caricare in memoria le regole di sillabazione delle lingue; si facciariferimento al manuale della distribuzione per capire come si fa.

Di tutti i comandi specificata la sintassi, cio gli argomenti opzionali e obbligatori. Une-spressione come abcde un segnaposto per il vero argomento da dare; in tutti i casi dovrebbeessere chiaro che tipo di argomento richiesto. Per esempio, testo indica qualunque lista dicaratteri che sia comprensibile da LATEX in quel contesto; invece dimen indica che va inseritauna lunghezza esplicita oppure un parametro dimensionale come \parindent o simili.

Per ogni pacchetto sono specificate le opzioni disponibili e quali siano quelle usate se non nevengono dichiarate esplicitamente. Una notazione come

\usepackage[opzione,...]{pippo}significa che il pacchetto pippo pu prendere pi opzioni. Il carattere | fra due opzioni ocomandi significa che si pu scegliere fra due forme alternative oppure che si tratta di opzioni chesi escludono a vicenda. Questo dovrebbe risultare chiaro dalla descrizione.

Si noteranno certe omissioni come color, graphicx o fancyhdr; future edizioni potranno trattarli.Lordine in cui i pacchetti sono trattati : babel, poi i pacchetti obbligatori in ogni installazionedi LATEX, quindi altri.

Suggerimenti o critiche sone bene accetti, scrivete a

Enrico Gregorio univr it

specificando nelloggetto del messaggio

Commenti alla breve guida

Queste note sono tratte dalle documentazioni pubblicamente disponibili dei pacchetti qui descritti. doveroso citarne gli autori:

Johannes Braams per babel; Claudio Beccari per la versione italiana di babel; David Carlisle per afterpage, array, bm, dcolumn, enumerate, ifthen, indentfirst, longtable, showkeys,

tabularx

Frank Mittelbach per array, bm, multicol, varioref Kresten Krab Thorup e Frank Jensen (con Chris Rowley) per calc; Kent McPherson per layout; Rainer Schpf, Bernd Raichle e Chris Rowley per verbatim; Axel Sommerfeldt per caption; Anselm Lingnau per float; Steven Douglas Cochran per subfig; Bernd Schandl per paralist.

Cambiamenti rispetto alla versione 2005: correzione di errori di stampa; aggiunta del capitolo su subfig; aggiunta del capitolo su paralist; descrizione del comando \floatevery nel capitolo su float.

1

Indice

1 babel 41.1 Opzioni . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.2 Comandi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.3 Comandi specifici per litaliano . . . . . . . . . . . . . . . . . . . . . . . . 6

2 afterpage 7

3 array 83.1 Specificatori . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83.2 Comandi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

4 bm 114.1 Comandi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114.2 Esempi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

5 calc 125.1 Introduzione . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125.2 Operazioni . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125.3 Comandi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

6 dcolumn 146.1 Esempi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146.2 Osservazione . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

7 enumerate 157.1 Descrizione . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157.2 Uso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

8 ifthen 178.1 Comandi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178.2 I test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

9 indentfirst 19

10 layout 2010.1 Opzioni . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

11 longtable 2211.1 Opzioni . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2211.2 Descrizione . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2211.3 Lambiente longtable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2311.4 Parametri . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2311.5 Argomenti opzionali a \begin{longtable} . . . . . . . . . . . . . . . . . 2311.6 Comandi per terminare le righe della tabella . . . . . . . . . . . . . . . . . 2411.7 Comandi per la didascalia . . . . . . . . . . . . . . . . . . . . . . . . . . . 2411.8 Comandi impiegabili allinizio di una riga . . . . . . . . . . . . . . . . . . 25

2

Indice

12 multicol 2612.1 Opzioni . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612.2 Comandi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612.3 Parametri . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

13 showkeys 2913.1 Opzioni . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

14 tabularx 30

15 varioref 3115.1 Opzioni . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3115.2 Comandi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3115.3 I comandi che producono i testi variabili . . . . . . . . . . . . . . . . . . . 33

16 verbatim 3516.1 Ambienti . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3516.2 Creare nuovi ambienti di tipo verbatim . . . . . . . . . . . . . . . . . . . 35

17 caption 3617.1 Opzioni . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3617.2 Comandi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3917.3 Altri pacchetti . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

18 float 4118.1 Stili . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4118.2 Comandi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4118.3 Largomento di posizione H . . . . . . . . . . . . . . . . . . . . . . . . . . 42

19 subfig 4319.1 Opzioni . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4319.2 Comandi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

20 paralist 4620.1 Opzioni . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4620.2 Ambienti . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4720.3 Comandi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4820.4 Parametri . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

3

1babel

\usepackage[lingua,...]{babel}

1.1 OpzioniLultima lingua specificata quella principale del documento; le lingue vanno scelte

nellelenco che segue. Notare che english pu significare USenglish oppure UKenglish,secondo quanto stabilito dal file language.dat della propria distribuzione. La linguaenglish sempre disponibile, le altre vanno abilitate nella configurazione della distribu-zione. Si noti che ngerman e naustrian usano la Nuova Ortografia.

acadianafrikaansalbanianamericanaustralianaustrianbahasabahasaibahasambasquebrazilbrazilianbretonbritishbulgariancanadiancanadiencatalan

croatianczechdanishdutchenglishesperantoestonianfinnishfrancaisfrenchfrenchbgaliciangermangermanbgreekhebrewhungarianicelandic

indonindonesianinterlinguairishitalianlatinlowersorbianmagyarmalaymeyalunaustriannewzealandngermannorsknynorskpolishpolutonikogreekportuges

portugueseromanianrussiansaminscottishserbianslovakslovenespanishswedishturkishukrainianuppersorbianwelshUKenglishUSenglish

Sebbene le opzioni possano essere dichiarate globalmente, si raccomanda, quando sidichiarino pi lingue, di passarle esplicitamente a babel.

Il pacchetto babel pu agire:

1. sulla sillabazione;

2. sulle convenzioni tipografiche;

3. sulle parole chiave e sulle date;

4. sulle abbreviazioni per comandi;

5. sui comandi specifici della lingua.

1.2 Comandi

\selectlanguage{lingua}La lingua deve essere stata specificata nelle opzioni date a babel (o fra le opzioni globalia \documentclass).

Dal comando in poi in vigore la lingua data come argomento, in tutti gli aspettimenzionati prima. una dichiarazione locale, cio vale solo nellambiente in cui si trovae non ai livelli superiori.

4

1. babel

\foreignlanguage{lingua}{testo}Compone il testo nella lingua dichiarata usando i comandi specifici, le abbreviazioni ela sillabazione.

\languagenameContiene il nome della lingua corrente.

\useshorthands{carattere}Abilita il carattere come prefisso per le abbreviazioni.

\defineshorthand{sequenza}{testo}Definisce sequenza (uno o due caratteri) come abbreviazione per testo.

\aliasshorthand{carattere}{carattere}Definisce il primo carattere come sinonimo del secondo. Il primo carattere deve esserestato dichiarato nel preambolo usando \useshorthands.

\languageshorthands{lingua}Abilita le abbreviazioni definite nella lingua, che deve essere stata dichiarata fra leopzioni date a babel.

\shorthandson | \shorthandsoffAbilita (disabilita) le abbreviazioni. Per esempio, vanno usati prima e dopo di ambientio comandi del pacchetto xy se la lingua corrente usa, per esempio, " come prefisso per leabbreviazioni.

\iflanguage{lingua}{testo 1}{testo 2}Compone testo 1 se la lingua corrente lingua, altrimenti testo 2. Si veda un esempioa pagina 14.

\begin{otherlanguage}{lingua} equivalente a \selectlanguage, ma il cambiamento di lingua locale allambientestesso.

\begin{otherlanguage*}{lingua}Comanda luso di sillabazione, convenzioni tipografiche, abbreviazioni e comandi specificidella lingua, ma non agisce sulle parole chiave e sulle date.

\begin{hyphenrules}{lingua}Abilita la sillabazione nella lingua. Quasi tutte le distribuzioni definiscono una pseudo-lingua nohyphenation, nella quale non definito alcuno schema di sillabazione. Dunque,dopo \begin{hyphenrules}{nohyphenation}, nessuna parola viene spezzata se non cisono comandi di sillabazione espliciti.

\addto\captionslingua{testo}Comanda di aggiungere alle definizioni specifiche della lingua il testo. Per esempio,volendo sostituire Bibliografia con Letture suggerite, si pu scrivere, nel preambolo:

\addto\captionsitalian{%\renewcommand{\bibname}{Letture suggerite}}

5

1. babel

1.3 Comandi specifici per litalianoRiportiamo i comandi per le parole chiave e il loro valore in italiano.

\abstractname Sommario \indexname Indice analitico\alsoname vedi anche \listfigurename Elenco delle figure\appendixname Appendice \listtablename Elenco delle tabelle\bibname Bibliografia \pagename Pag.\ccname e p. c. \partname Parte\chaptername Capitolo \prefacename Prefazione\contentsname Indice \proofname Dimostrazione\enclname Allegati \refname Riferimenti bibliografici\figurename Figura \seename vedi\glossaryname Glossario \tablename Tabella\headtoname Per

"Inserisce un punto di sillabazione, utile per indicare sillabazioni etimologiche (per esempio,iper"attivo)

"|Va usato nellimprobabile caso che la sillabazione etimologica sia richiesta prima di unalettera accentata.

""Inserisce le virgolette alte aperte. Utile per chi non ha il carattere accento grave sullapropria tastiera.

"< | ">Inseriscono i caporali, cio le virgolette francesi e . Se le si vuole usare, si raccomandaluso della codifica T1 con \usepackage[T1]{fontenc}.

"/Equivalente a \slash, cio una barra dopo la quale ammesso spezzare la riga.

\unitUtile per comporre unit di misura. Per esempio $2\unit{m}$ produce 2m. Funzionasia in modo matematico che in modo testo.

\ap{testo} | \ped{testo}Compongono il testo rispettivamente come apice o pedice. Per esempio, 7\ap{mo}produce 7mo.

6

2afterpage

\usepackage{afterpage}

\afterpage{testo}Il testo viene eseguito appena la pagina corrente stata composta e scritta nel documentodvi o pdf.

Per esempio, se si vuole lasciare una pagina completamente bianca dopo la paginacorrente, si pu dare

\afterpage{\null\thispagestyle{empty}\clearpage}

7

3array

\usepackage{array}

Ogni estensione qui indicata vale sia per lambiente tabular che per array; questiambienti hanno un argomento obbligatorio che consiste di una successione di specificatoriper ciascuna colonna. possibile ripetere una successione di specificatori spec un certonumero num di volte con la costruzione *{num}{spec}.

3.1 Specificatori

lSpecifica una colonna con allineamento a sinistra (come in LATEX normale).

cSpecifica una colonna con allineamento al centro (come in LATEX normale).

rSpecifica una colonna con allineamento a destra (come in LATEX normale).

p{dimen}Specifica una colonna in cui le celle sono composte come paragrafi di larghezza dimen(LATEX normale). La cella allineata alla riga a cui appartiene rispetto alla linea di basesuperiore (come in LATEX normale). analogo a scrivere \parbox[t]{dimen}.

m{dimen}Specifica una colonna in cui le celle sono composte come paragrafi di larghezza dimen.La cella centrata rispetto alla riga a cui appartiene (array). analogo a scrivere\parbox[c]{dimen}.

b{dimen}Specifica una colonna in cui le celle sono composte come paragrafi di larghezza dimen.La cella allineata alla riga a cui appartiene rispetto alla linea di base inferiore (array). analogo a scrivere \parbox[b]{dimen}.

@{testo}Specifica che fra le colonne in cui si trova sia composto il testo, senza interporre lusualespazio fra le colonne (come in LATEX normale).

!{testo}Specifica che fra le colonne in cui si trova sia composto il testo, interponendo anchelusuale spazio fra le colonne (array).

|Specifica che fra le colonne in cui si trova sia composta una linea verticale (come in LATEXnormale).

8

3. array

>{testo}Pu essere usato prima di uno specificatore l, c, r, p, m o b. Indica che prima delcontenuto di ogni cella della colonna sia eseguito il testo (si vedano gli esempi con\newcolumntype).

{prima}]{spec}[{$}c

3. array

Largomento opzionale num il numero di argomenti; si pu usare la stessa sintassidi \newcommand, indicando i parametri da sostituire con #1, #2 e cos via. Diamo diseguito un esempio; ovviamente si possono trovare applicazioni migliori.

\newcolumntype{v}[1]{>{#1: \hfill}l}\begin{tabular}{v{Nazione}|v{Valore}}Italia & 640 \\Germania & 231 \\Francia & 100 \\Turchia & 91 \\Spagna & 1003\end{tabular}

Nazione: Italia Valore: 640Nazione: Germania Valore: 231Nazione: Francia Valore: 100Nazione: Turchia Valore: 91Nazione: Spagna Valore: 1003

\showcolsScrive a terminale e sul log la lista degli specificatori definiti con \newcolumntype.

\firsthlineVa usato al posto di \hline per una linea orizzontale sopra la tabella, permettendo diallineare la tabella rispetto alla riga di base superiore (usando \begin{tabular}[t]).

\lasthlineVa usato al posto di \hline per una linea orizzontale sopra la tabella, permettendo diallineare la tabella rispetto alla riga di base inferiore (usando \begin{tabular}[b]).

\tabularnewlineEquivalente al comando \\ di fine riga dellallineamento.

\arraybackslashSupponiamo di volere una tabella in cui lultima colonna sia formata da paragrafi sban-dierati a destra. La soluzione di scrivere

\begin{tabular}{...>{\raggedright}p{4cm}}

non funziona, perch il comando \\ viene ridefinito da \raggedright. Potremmo termi-nare ogni cella con il comando \tabularnewline, ma c un modo migliore:

\begin{tabular}{...>{\raggedright\arraybackslash}p{4cm}}

cura il problema: rid il valore corretto a \\ dopo la ridefinizione di \raggedright.Naturalmente, gli eventuali capo riga manuali nella cella devono essere dati con \newline.

10

4bm

\usepackage{bm}

Non si abusi della possibilit di scrivere simboli matematici in carattere nero fornitada questo pacchetto. La tradizione tipografica dice che i caratteri neri usati come simbolimatematici sono diritti (con \mathbf).

4.1 Comandi

\bm{formula}Scrive la formula (che deve essere materiale adatto al modo matematico) in caratterenero. Per esempio,

\[\alpha\ne\bm{\alpha}\]

produce 6=

Il comando pu risultare utile quando si debba comporre una formula in un titolo dicapitolo o sezione e la classe usi il nero per queste parti.

\DeclareBoldMathCommand[versione]{comando}{formula}Il comando non deve essere gi definito. Dopo questo, comando comporr la formula(tipicamente un solo simbolo) come se fosse \bm{formula}. Per esempio

\DeclareBoldMathCommand{\balpha}{\alpha}

risulta pi efficiente di scrivere ogni volta \bm{\alpha}. Largomento versione opzionale,se omesso, vale bold; se disponibile una versione heavy (poche famiglie di caratteri celhanno) si pu usare quella. sconsigliabile (perch?) usare la versione normal.

\bmdefine{comando}{formula} equivalente a \DeclareBoldMathCommand[bold]{comando}{formula}.

\hmdefine{comando}{formula} equivalente a \DeclareBoldMathCommand[heavy]{comando}{formula}.

4.2 Esempi bene fare attenzione. Scrivendo

$1 g \bm{g}$$2 \mathrm{g \bm{g}}$$3 {g} \bm{{g}}$$4 \mathrm{{g} \bm{{g}}}$$5 \mathrm{g} \bm{\mathrm{g}}$

si ottiene

1gg 2gg 3gg 4gg 5gg

11

5calc

\usepackage{calc}

5.1 IntroduzioneI calcoli aritmetici con LATEX non sono molto facili e richiedono spesso il passaggio

attraverso registri temporanei. Il pacchetto calc fornisce strumenti per facilitare i calcolidiretti.

Supponiamo, per esempio, di avere una figura di larghezza non troppo grande chevogliamo inserire in modo che occupi tutta una riga. Tuttavia non desideriamo che di-venti troppo grande e laltezza superi quella della gabbia tipografica. Siccome la figura generata da un programma esterno, non ne conosciamo a priori le dimensioni.

Il problema diventa complicato perch in TEX non ammesso dividere per una di-mensione (si pu fare, ma con un trucco da maghi). Ecco come si pu operare concalc:

\newdimen{\Xsize}\newdimen{\Ysize}\newdimen{\finalYsize}\setlength{\Xsize}{\widthof{\includegraphics{figura}}}\setlength{\Ysize}{\heightof{\includegraphics{figura}}}\setlength{\finalYsize}{\Ysize*\ratio{\textwidth}{\Xsize}}

A questo punto possibile confrontare \finalYsize con una dimensione prefissata (peresempio \textheight) e operare di conseguenza (si veda come nella descrizione di ifthen).

5.2 OperazioniLe operazioni ammesse sono somma, sottrazione, moltiplicazione e divisione con interi

o reali a virgola mobile. In certi casi il risultato soggetto al troncamento della partedecimale.

Scriviamo la sintassi dei comandi ammessi.

espressione tipo termine tipo| espressione tipopi o menotermine tipo

termine tipo fattore tipo| termine tipoper o divisofattore intero| termine tipoper o divisonumero reale

fattore tipo tipo| fattore dimensionale | (espressione tipo)

fattore dimensionale comando dimensionale{testo}comando dimensionale \widthof | \heightof | \depthofpi o meno + | -per o diviso * | /numero reale \real{costante decimale}

| \ratio{espressione dimensionale}{espressione dimensionale}In questa descrizione formale, tipo sta per intero (o intera) oppure dimensionale.

Per esempio, le prime due righe descrivono il significato sia di espressione intera sia diespressione dimensionale. Per essere pi espliciti, queste sono espressioni intere:

2 * (3 + 5) -46 + 31*4+2*3

12

5. calc

mentre queste sono espressioni dimensionali:

2cm - 3pt + 4cm*\real{1.3} - \textwidth + \widthof{pippo}\textheight*\ratio{\textwidth}{6dd}

Dove richiesta una dimensione se ne pu dare una esplicita oppure una implicita conuno dei parametri dimensionali di LATEX. Si noti che \real e \ratio devono compariresempre dopo loperatore di moltiplicazione o divisione, e si pu solo moltiplicare unadimensione per un numero, non viceversa. Gli spazi in unespressione sono ignorati epossono utilmente essere impiegati per aumentare la leggibilit.

Ogni volta che LATEX deve leggere una dimensione o un numero intero, si pu usareuna di queste espressioni, cio con \setcounter o \setlength. La cosa funziona anchecon i comandi o gli ambienti che richiedono una dimensione, come \makebox, \parbox ominipage.

5.3 Comandi

\real{costante decimale}Un qualunque numero decimale esplicito; la parte decimale deve essere separata con ilpunto.

\ratio{espressione dimensionale}{espressione dimensionale}Si veda la descrizione formale.

\widthof | \heightof | \depthof{testo}Ciascuno dei comandi prende ad argomento un testo che viene composto (e poi scartato).Il primo calcola la larghezza del risultato, il secondo laltezza, il terzo la profondit, ciodi quanto il testo si estende sotto la linea di base.

\widthof{p} 5.5542 pt\heightof{p} 4.3045 pt\depthof{p} 1.94397 pt

Per fare un esempio meno banale: si vuole comporre una minipage larga come unariga di un testo variabile, aumentato di un centimetro.

\newenvironment{varmp}[1]{\begin{minipage}{\widthof{#1}+1cm}}{\end{minipage}}

13

6dcolumn

\usepackage{dcolumn}

Lo scopo di dcolumn di facilitare linserimento di cifre con parte decimale in unatabella (tabular o array). Il pacchetto carica automaticamente array.

D{sep-in}{sep-out}{numero} uno specificatore di colonne con tre argomenti. Il primo il carattere da usare neldocumento .tex per indicare la separazione fra le colonne, il secondo quello usato neldocumento composto. Il terzo argomento il numero di cifre decimali. I numeri sarannoallineati rispetto al separatore della parte frazionaria; nel caso il terzo argomento sianegativo, il separatore sar al centro della colonna. Si veda losservazione alla fine delcapitolo.

6.1 EsempiSupponiamo di voler comporre una tabella a tre colonne, nella quale la seconda e la

terza consistono di numeri decimali; il numero massimo di cifre decimali nella seconda 3,nella terza non specificato.

\begin{tabular}{l|D{.}{,}{3}|D{.}{\cdot}{-1}|}

Italia & 640.3 & 1.22 \\Germania & 231.12 & 2 \\Francia & 100.1 & 3.12334 \\Turchia & 91.399 & 90 \\Spagna & 1003.121 & 10.03\end{tabular}

Italia 640,3 122Germania 231,12 2Francia 100,1 312334Turchia 91,399 90Spagna 1003,121 1003

Si noti come viene trattata correttamente la mancanza di una parte frazionaria.Facciamo un altro esempio, per mostrare come si possa scrivere una tabella che funzioni

con lo stesso codice in italiano e in inglese, dove si usano separatori decimali diversi. Nelcodice che segue si vede che come sep-in si pu usare un carattere qualunque.

\newcolumntype{U}{D{?}{\iflanguage{english}{.}{,}}{2}}\newcommand{\tabella}{\begin{tabular}{|l|U|}Germania & 2?31 \\Spagna & 100?3\end{tabular}}\selectlanguage{english}\tabella\qquad\selectlanguage{italian}\tabella

Germania 2.31Spagna 100.3

Germania 2,31Spagna 100,3

6.2 OsservazioneNel terzo argomento possibile scrivere numerocaratterenumero per indicare il

massimo numero di cifre nella parte intera e nella parte frazionaria. Questo utile nel casosi desideri intestare la colonna impiegando un comando \multicolumn. Qui carattereindica un qualunque carattere che non sia una cifra; si consiglia di usare un punto.

14

7enumerate

\usepackage{enumerate}

7.1 DescrizioneTalvolta utile avere a disposizione la possibilit di costruirsi liste numerate parti-

colari. Il meccanismo normale messo a disposizione da LATEX permette solo di cambiareglobalmente il modo di comporre le liste numerate, con ottime ragioni. Daltra parte, nontutte le liste sono uguali; si potrebbe usare largomento opzionale di \item, ma questasarebbe una forzatura che costringerebbe a scrivere esplicitamente i numeri.

Il pacchetto enumerate aggiunge allambiente enumerate un argomento opzionale chedetermina il modo di comporre letichetta numerata delle liste in modo automatico. Ilpacchetto riserva cinque caratteri speciali: 1 i I a A.

1 | i | I | a | AIndica che il numero sia composto, rispettivamente, con cifre arabiche, numeri romaniminuscoli, numeri romani maiuscoli, lettere minuscole o lettere maiuscole.

\labelMenzioniamo qui il comando anche se non modificato. Il comando \label pu esseredato dopo un \item, ma genera solo il numero (nella forma indicata, cio in cifre arabiche,come numero romano o come lettera). Il prefisso testo 1 e il suffisso testo 2 vannoaggiunti esplicitamente con

testo 1\ref{etichetta}testo 2.

7.2 UsoIl comando di inizio dellambiente enumerate pu essere seguito da un argomento

opzionale

\begin{enumerate}[testo 1caratteretesto 2]dove carattere uno dei cinque detti in precedenza, che non deve comparire nascostotra parentesi graffe. Letichetta che precede ciascun elemento della lista sar compostacome

testo 1numerotesto 2e il numero come stabilito dalla corrispondenza descritta sopra. Se il carattere indicato a oppure A, la lista non pu avere pi di 26 elementi. Eventuali dichiarazioni contenutenel prefisso o nel suffisso sono locali alletichetta.

Primo esempio: vogliamo comporre una lista che enunci le propriet richieste a unastruttura per farne uno spazio vettoriale; per comodit del lettore vogliamo che i numerisiano preceduti dalla sigla SV e il tutto sia fra parentesi tonde.

\begin{enumerate}[(SV1)]

Secondo esempio: vogliamo scrivere parecchie liste del tipo visto nel primo esempio,con varie sigle. Definiremo un ambiente appropriato, al quale daremo come argomento lasigla.

\newenvironment{assiomi}[1]{\begin{enumerate}[({#1}1)]}{\end{enumerate}}

15

7. enumerate

Si noti come il riferimento al primo argomento, cio #1, viene interpretato correttamente,ma viene messo tra parentesi graffe per evitare che eventuali caratteri dei cinque specialipossano dare problemi. La cosa non era necessaria nel primo esempio, perch le lettereS e V non sono fra i caratteri riservati.

Terzo esempio: vogliamo definirci liste personalizzate per indicare (1) condizioni cheseguono da unipotesi; (2) condizioni equivalenti; (3) condizioni da soddisfare per unadefinizione. Vogliamo indicare le prime con cifre arabe, le seconde con lettere minuscole,le terze con lettere maiuscole, tra parentesi tonde. Cerchiamo di farlo nel modo piastratto possibile: trattandosi di un articolo da inviare per la pubblicazione, dobbiamoessere in grado di modificare la resa tipografica senza agire sul documento, ma solo sulpreambolo. Una piccola complicazione che le etichette devono apparire con caratterediritto anche in ambiente corsivo.

\newenvironment{roster}[1]{\begin{enumerate}[\upshape(#1)]}{\end{enumerate}}

\newenvironment{concl}{\begin{roster}{1}}{\end{roster}}\newenvironment{eqcond}{\begin{roster}{a}}{\end{roster}}\newenvironment{defcond}{\begin{roster}{A}}{\end{roster}}

Si noti che stato definito un nuovo ambiente generico e poi i tre ambienti particolari sonostati definiti tramite quello. Se la rivista ci dovesse chiedere una modifica, per esempiodi racchiudere i numeri o le lettere tra parentesi quadre, sar sufficiente agire su unasola riga del documento. Leffetto della dichiarazione \upshape non si propaga oltre lacomposizione delletichetta.

Quarto esempio: vogliamo che il numero dellelemento compaia a pedice della sigla, maabbiamo il problema che il numero degli elementi pu essere superiore a nove. Scrivendo

\begin{enumerate}[(SV$_{1}$)]

il carattere 1 non viene interpretato come speciale. Scrivendo

\begin{enumerate}[(SV$_1$)]

il decimo elemento verrebbe etichettato come (SV10) e cos sarebbe per i successivi. Lasoluzione di scrivere

\begin{enumerate}[(SV$_\bgroup1\egroup$)]

Il trucco funziona perch enumerate non riconosce i comandi \bgroup e \egroup comeparentesi graffe, ma per LATEX la costruzione $a_\bgroup10\egroup$ equivalente a$a_{10}$.

16

8ifthen

\usepackage{ifthen}

In molte situazioni conveniente poter impiegare comandi che hanno significati diversiin contesti diversi. Il pacchetto ifthen fornisce uninterfaccia ai comandi primitivi di TEXche riguardano i condizionali e le variabili booleane.

8.1 Comandi

\ifthenelse{test}{vero}{falso}Valuta test, che restituisce vero o falso ed esegue di conseguenza vero o falso.

\whiledo{test}{comandi}Esegue comandi fino a che il test restituisce il valore vero.

\newboolean{nome}Crea una variabile booleana alla quale ci si riferisce con nome che deve essere unasuccessione di lettere. Se la variabile esiste gi, il comando produce un errore.

\provideboolean{nome}Crea una variabile booleana alla quale ci si riferisce con nome che deve essere unasuccessione di lettere. ignorato se la variabile esiste gi.

\setboolean{nome}{valore}Assegna alla variabile booleana nome il valore valore che pu essere solo true oppurefalse. Quando una variabile creata, le viene assegnato il valore false.

8.2 I testI test sono costruiti a partire dalle espressioni elementari che elenchiamo di seguito.

numeroopnumeroEspressione elementare per costruire un test. Ciascun numero pu essere un interoesplicito o implicito (tramite \value{contatore} o \pageref{etichetta}); op deveessere . Restituisce vero se i due interi sono nella relazione indicata. D errorese non si usano numeri.

\isodd{numero}Espressione elementare per costruire un test. Restituisce vero se il numero di-spari. Il numero pu essere un intero esplicito oppure \value{contatore} o anche\pageref{etichetta}). Restituisce falso altrimenti (anche se numero non un nu-mero, per esempio quando un riferimento a una pagina non ancora noto). Attenzione:\isodd{11xx} restituisce vero!

\isundefined{comando}Espressione elementare per costruire un test. Restituisce vero se il comando non definito.

17

8. ifthen

\equal{stringa}{stringa}Espressione elementare per costruire un test. Restituisce vero se le due stringhe sonouguali.

\lengthtest{dimenopdimen}Espressione elementare per costruire un test. Il primo e il terzo argomento devono esserelunghezze (o anche parametri che contengono lunghezze, come \parindent); op deveessere . Restituisce vero se le lunghezze soddisfano la relazione indicata.

\boolean{nome}Espressione elementare per costruire un test. Restituisce il valore della variabile boo-leana nome.

Un test si ottiene combinando espressioni elementari tramite i comandi \AND, \OR e\NOT e le parentesi $ e $. Si possono usare anche \and, \or e \not, ma consigliabileusare le prime forme per maggiore leggibilit.

$\isodd{\value{page}}\AND\value{page}>31$\OR\value{page}

9indentfirst

\usepackage{indentfirst}

Il pacchetto non definisce alcun nuovo comando; il suo unico effetto di imporre ilrientro (indent) anche al primo paragrafo dopo un comando di sezione come \chapter o\section, secondo luso europeo continentale.

La tabella qui sotto relativa al capitolo precedente, ma serve anche a riempire lospazio su questa pagina.

Tabella 9.1 Esempio di tabella dei caratteri, usando Zapf Dingbats0 = 1 = 2 = 3 = 4 = 5 = 6 = 7 =8 = 9 = 10 = 11 = 12 = 13 = 14 = 15 =16 = 17 = 18 = 19 = 20 = 21 = 22 = 23 =24 = 25 = 26 = 27 = 28 = 29 = 30 = 31 =32 = 33 = ! 34 = " 35 = # 36 = $ 37 = % 38 = & 39 = '40 = ( 41 = ) 42 = * 43 = + 44 = , 45 = - 46 = . 47 = /48 = 0 49 = 1 50 = 2 51 = 3 52 = 4 53 = 5 54 = 6 55 = 756 = 8 57 = 9 58 = : 59 = 60 = 61 = = 62 = > 63 = ?64 = @ 65 = A 66 = 67 = 68 = D 69 = E 70 = F 71 = G72 = H 73 = I 74 = J 75 = K 76 = L 77 = M 78 = N 79 = O80 = P 81 = Q 82 = R 83 = S 84 = T 85 = U 86 = V 87 = W88 = X 89 = Y 90 = Z 91 = [ 92 = \ 93 = ] 94 = ^ 95 = _96 = ` 97 = a 98 = b 99 = c 100 = d 101 = e 102 = f 103 = g104 = h 105 = i 106 = j 107 = k 108 = l 109 = m 110 = n 111 = o112 = p 113 = q 114 = r 115 = s 116 = t 117 = u 118 = v 119 = w120 = x 121 = y 122 = z 123 = { 124 = | 125 = } 126 = ~ 127 =128 = 129 = 130 = 131 = 132 = 133 = 134 = 135 =136 = 137 = 138 = 139 = 140 = 141 = 142 = 143 =144 = 145 = 146 = 147 = 148 = 149 = 150 = 151 =152 = 153 = 154 = 155 = 156 = 157 = 158 = 159 =160 = 161 = 162 = 163 = 164 = 165 = 166 = 167 = 168 = 169 = 170 = 171 = 172 = 173 = 174 = 175 = 176 = 177 = 178 = 179 = 180 = 181 = 182 = 183 = 184 = 185 = 186 = 187 = 188 = 189 = 190 = 191 = 192 = 193 = 194 = 195 = 196 = 197 = 198 = 199 = 200 = 201 = 202 = 203 = 204 = 205 = 206 = 207 = 208 = 209 = 210 = 211 = 212 = 213 = 214 = 215 = 216 = 217 = 218 = 219 = 220 = 221 = 222 = 223 = 224 = 225 = 226 = 227 = 228 = 229 = 230 = 231 = 232 = 233 = 234 = 235 = 236 = 237 = 238 = 239 = 240 = 241 = 242 = 243 = 244 = 245 = 246 = 247 = 248 = 249 = 250 = 251 = 252 = 253 = 254 = 255 =

19

10layout

\usepackage[opzione,...]{layout}

10.1 OpzioniUn primo gruppo di opzioni permette di scegliere la lingua per le descrizioni.

braziliandutchenglish

francaisfrenchgerman

italianngermanportuguese

spanish

silent | verboseLa prima quella normale; con la seconda i dati appaiono sul terminale e nel log.

integers | realsLa prima quella normale; con la seconda i valori delle dimensioni vengono espressi conla parte decimale invece che essere troncati.

\layoutLunico comando definito da questo pacchetto produce uno schema della forma della pagi-na, con indicate le dimensioni dei vari elementi: gabbia, margini, altezza e distanza dellatestatina e cos via. Se il documento scritto in una classe che prevede lopzione twoside,sono prodotti due schemi per le pagine pari e dispari. Tutte le dimensioni sono mostratein punti tipografici.

\layout*Il comando \layout tiene in memoria i vari parametri. Se si sono modificati i valori, sipu usare \layout* per ricalcolare lo schema.

20

10. layout

Testatina

Corpo

Piedino

Note amargine

i8 -

i7

?

6

i1 -

-i3 i10 --i9

6

?

i11

i2?

6

6?

i46

?

i56

?

i6

1 un pollice + \hoffset 2 un pollice + \voffset3 \oddsidemargin = 32.25894pt 4 \topmargin = -2.74657pt5 \headheight = 12.0pt 6 \headsep = 12.0pt7 \textheight = 658.0pt 8 \textwidth = 373.45pt9 \marginparsep = 11.0pt 10 \marginparwidth = 57.0pt

11 \footskip = 30.0pt \marginparpush = 5.0pt (non mostrato)\hoffset = 0.0pt \voffset = 0.0pt\paperwidth = 597.50787pt \paperheight = 845.04684pt

21

11longtable

\usepackage[opzione,...]{longtable}

11.1 Opzioni

errorshowAl terminale vengono mostrati solo gli errori nella composizione di una tabella e gliavvertimenti compaiono solo nel log.

pausing

Ogni avvertimento si comporta come un errore; utile per il debugging di una tabellaparticolarmente complicata.

11.2 DescrizioneIn molte situazioni ci si trova a dover comporre una tabella troppo grande per una

sola pagina: si pensi a un lungo elenco di variabili con i valori preassegnati o alla listadelle nazioni indipendenti con vari dati per ciascuna.

Il pacchetto longtable pu risolvere il problema. Ne esiste uno simile, chiamato super-tabular, ma non del tutto compatibile con array e altri pacchetti.

Una tabella che occupa pi pagine deve essere composta in modo asincrono. Il pac-chetto raccoglie a ogni compilazione le larghezze delle celle di ogni pagina e alla successivacerca di usare le larghezze giuste su tutte le pagine. Possono essere necessarie alcunecompilazioni successive per ottenere il risultato finale.

Ogni tabella composta con longtable si compone di varie parti:

unintestazione iniziale;

unintestazione normale;

un piede finale;

un piede normale;

il corpo della tabella;

le didascalie.

Lintestazione iniziale pu coincidere con lintestazione normale, cos come il piede finalepu coincidere con il piede normale. Ciascuno di questi elementi pu mancare, ma consigliabile che compaiano almeno le intestazioni o i piedi per aiutare il lettore a capireche la stessa tabella occupa pi di una pagina.

Le didascalie, se presenti, possono essere uguali in ciascuna pagina o diverse sulla primae quelle successive. Vanno specificate insieme allintestazione (e possono sostituirla).

La struttura di una longtable descritta nella tabella 11.1 a pagina 25; si veda piavanti per la sintassi precisa del comando \caption. Il pacchetto compone la tabella uncerto numero di righe alla volta, specificate nel contatore LTchunks. Se si verificano pro-blemi di memoria, si pu provare a diminuirne il valore (con \setcounter); occorre pertenere presente che tale valore deve essere maggiore del numero di righe nellintestazionee nel piede.

22

11. longtable

Ricordiamo che non obbligatorio che sia presente la didascalia. In questo caso bene specificare unintestazione; quella iniziale e quella normale possono coincidere, madi solito si adotta una strategia del tipo

\hlineintestazione iniziale\\\hline\endfirsthead\hlineintestazione iniziale (segue)\\\hline\endhead

11.3 Lambiente longtable

\begin{longtable}[carattere]{preambolo}Si veda pi avanti per largomento opzionale. Il preambolo costruito esattamente comeper tabular e si possono usare le estensioni messe a disposizione da array se questo statocaricato.

11.4 Parametri

\LTleftSpazio a sinistra della tabella. Lunghezza elastica, valore usuale \fill.

\LTright

Spazio a destra della tabella. Lunghezza elastica, valore usuale \fill.

\LTpre

Spazio verticale prima della tabella. Lunghezza elastica, valore usuale \bigskipamount.

\LTpost

Spazio verticale dopo la tabella. Lunghezza elastica, valore usuale \bigskipamount.

\LTcapwidth

Larghezza della \parbox che contiene la didascalia. Valore usuale 4 in.

LTchunksizeNumero di righe per blocco. Contatore, valore usuale 20.

11.5 Argomenti opzionali a \begin{longtable}Senza argomenti opzionali, la tabella sistemata secondo il valore di \LTleft e

\LTright. Quindi, se non sono stati modificati, la tabella centrata.

[c]Centrare la tabella.

[l]Tabella al margine sinistro.

[r]Tabella al margine destro.

23

11. longtable

11.6 Comandi per terminare le righe della tabella

\\Termina una riga.

\\[dimen]Termina una riga e aggiunge in seguito uno spazio verticale come specificato da dimen(come in tabular).

\\*Come \\ ma non permette un cambio pagina dopo la riga.

\tabularnewlineAlternativa a \\ da usare quando si sia specificato un comando del tipo di \raggedright,\raggedleft o \centering, che ridefinisce \\.

\killLa riga omessa, ma usata nel calcolo delle dimensioni delle celle.

\endheadSpecifica le righe che devono apparire allinizio di ogni pagina.

\endfirstheadSpecifica le righe che appaiono allinizio della tabella.

\endfootSpecifica le righe che devono apparire alla fine di ogni pagina.

\endlastfootSpecifica le righe che devono apparire alla fine dellultima pagina.

11.7 Comandi per la didascalia

\caption{testo}

La didascalia sar Tabella ?: testo; testo viene riportato anche nellelenco delletabelle. Tipicamente il comando va nellintestazione iniziale.

\caption[testo 1]{testo 2}La didascalia sar Tabella ?: testo 2; testo 1 viene riportato nellelenco delle tabelle.Va nellintestazione iniziale; si usa se il testo della didascalia troppo lungo.

\caption[]{testo}La didascalia sar Tabella ?: testo; non sar riportata nellelenco delle tabelle; ilnumero qui rappresentato da ? non cambia rispetto alla prima didascalia. Tipicamentequesto comando va nellintestazione normale.

\caption*{testo}La didascalia sar testo; non sar riportata nellelenco delle tabelle. Pu sostituire ilprecedente nellintestazione normale se non si vuole riportare in ogni pagina il numerodella tabella.

24

11. longtable

11.8 Comandi impiegabili allinizio di una riga

\pagebreak | \newpageForza un cambio di pagina.

\pagebreak[numero]Specifica un valore fra 0 e 4 di desiderabilit di un cambio pagina.

\nopagebreakProibisce un cambio di pagina.

\nopagebreak[numero]Specifica un valore fra 0 e 4 di non desiderabilit di un cambio pagina.

Tabella 11.1 Struttura di una longtable. Sono indicate tutte le parti, ma va ricordato che nonsono obbligatorie. Non si abusi delle possibilit offerte; per esempio, la didascalia non semprenecessaria.

\begin{longtable}{preambolo}prima riga dellintestazione iniziale\\...ultima riga dellintestazione iniziale\\\caption{testo}\endfirstheadprima riga dellintestazione normale\\...ultima riga dellintestazione normale\\\caption{testo}\endheadprima riga del piede finale\\...ultima riga del piede finale\endlastfootprima riga del piede normale\\...ultima riga del piede normale\endfootprima riga della tabella\\...ultima riga della tabella\end{longtable}

25

12multicol

\usepackage[opzione,...]{multicol}

Scrivere documenti in cui si alternino passi a una colonna e passi a due colonne non possibile, se non in una forma primitiva: a ogni cambio, si va a pagina nuova. Il pacchettomulticol una cura molto valida: possibile alternare, nella stessa pagina, tratti a una,a due o a pi colonne, con bilanciamento finale. Il numero massimo di colonne dieci,dovrebbero bastare. Si faccia attenzione che, per ottenere un risultato veramente ottimo, necessario lavorare parecchio sui parametri di bilanciamento.

Un avvertimento: figure e tabelle inserite in un ambiente multicols con figure* otable* hanno come primo punto possibile di uscita la pagina successiva: impossibile farein modo che uno di questi ambienti capiti nella stessa pagina se non inserendolo prima odopo lambiente multicols. Se questo non vi va, evitate di usare multicol.

12.1 Opzioni

errorshow | infoshow | balancingshow | markshow | debugshowQueste opzioni servono per mostrare sul terminale e sul log i calcoli e varie altre cose.Utili quando sembra che non si riesca a ottenere il risultato previsto.

gridLe colonne sono composte in modo che le righe corrispondano a quelle di una grigliainvisibile. Se non si specifica questa opzione, il bilanciamento delle colonne pu crearedisparit fra le righe. Attenzione: i parametri di spaziatura dei comandi di sezione e altridevono essere studiati con cura affinch questo possa funzionare.

12.2 Comandi

\begin{multicols}{numero}[testo][dimen]Il numero deve essere compreso fra due e dieci (inclusi). Il testo dato come argomentoopzionale viene composto a larghezza intera, prima del contenuto dellambiente, senza chesia possibile un cambio di pagina prima dellinizio del testo a pi colonne. Gli ambientimulticols possono essere annidati, ma non sempre con risultati ottimali. Il secondoargomento opzionale serve a indicare di quanto spazio abbiamo bisogno perch il testodellambiente e lintestazione compaiano nella pagina corrente (si veda la discussione sulparametro \premulticols).

\begin{multicols*}{numero}[testo][dimen]Il risultato lo stesso, ma non viene eseguito alcun bilanciamento fra le colonne, chequindi hanno laltezza massima possibile per riempire la pagina. Non ha senso usarequesto ambiente dentro una minipage.

\flushcolumns

una dichiarazione valida da quando si carica il pacchetto. Le colonne vengono bilanciatein modo che le linee di base finali di ciascuna colonna (eccetto lultima) siano allineate.

\raggedcolumns

il contrario di \flushcolumns: le linee di base delle colonne non sono necessariamenteallineate.

26

12. multicol

\columnbreakIndica a LATEX che la riga in cui compare il comando lultima della colonna (va usatosolo in fase di revisione), per ottenere il migliore risultato.

12.3 ParametriPrima di discuterli, ricordiamo che non buona pratica giocare con i parametri senza

sapere ci che si fa. E, in ogni caso, gli aggiustamenti vanno fatti quando il testo inversione definitiva.

\premulticols

Questo parametro contiene lo spazio richiesto perch un ambiente multicols possa comin-ciare nella pagina corrente. Se lo spazio rimanente sulla pagina minore, viene emessoun comando di cambio pagina. Se viene specificato il secondo argomento opzionale amulticols, il valore dato usato al posto di \premulticols; usare con cautela.

\postmulticols

Se dopo un ambiente multicols lo spazio rimanente sulla pagina minore di questoparametro, viene emesso un comando di cambio pagina.

\multicolsep

Spazio verticale che viene inserito prima e dopo un ambiente multicols quando non cisiano cambi pagina.

\columnsep

Spazio orizzontale fra le colonne. La larghezza delle colonne determinata da questoparametro e dal valore corrente di \linewidth.

\columnseprule

Larghezza della linea da inserire per separare le colonne. Il valore usuale 0 pt. Un valoreconsigliabile, se si desidera la linea, 0.4 pt.

\multicolbaselineskip

una lunghezza elastica che viene aggiunta a \baselineskip per la composizione deltesto in un ambiente multicols. Non giocarci se non si sa quello che si sta facendo.

\multicoltoleranceValore di \tolerance da usare per comporre i paragrafi negli ambienti multicols. Il suovalore deve essere cambiato fuori da questi ambienti; usualmente 9999. Chi non conosceil ruolo di \tolerance non ci giochi; pu essere modificato localmente assegnando il valoredi \tolerance allinizio dellambiente.

\multicolpretolerance

Valore di \pretolerance da usare per comporre i paragrafi negli ambienti multicols. Ilsuo valore deve essere cambiato fuori da questi ambienti; usualmente 1. Chi non cono-sce il ruolo di \pretolerance non ci giochi pu essere modificato localmente assegnandoil valore di \pretolerance allinizio dellambiente.

collectmoreLintero contenuto in questo contatore (usualmente 0) indica quante righe di testo vannoconsiderate in pi o in meno per ogni colonna, eccetto lultima, rispetto a quanto sarebbeconsiderato dalla procedura di impaginazione.

27

12. multicol

unbalanceQuesto contatore deve avere un valore non negativo. Quando ha valore positivo, la proce-dura di impaginazione crea colonne con un numero di righe superiore al normale propriodel valore di questo contatore. Viene riportato a zero alla fine di ogni ambiente multicols.

columnbadnessLa procedura di impaginazione scarta ogni soluzione in cui le colonne (eccetto lultima)abbiano un valore di \vbadness che ecceda il valore di questo contatore. Il valore usuale 10 000, cio la procedura accetta tutte le soluzioni tranne quelle in cui la colonna siaoverfull. Questo pu portare a colonne con ampi spazi bianchi; si pu, in fase di revisione,provare a ridurre questo valore. Valori troppo bassi potrebbero forzare la procedura amettere tutto il testo nella prima colonna.

finalcolumnbadnessSe la \vbadness dellultima colonna minore del valore di questo contatore, usual-mente 9999, lultima colonna stessa viene allungata in modo da essere bilanciata conle altre.

28

13showkeys

\usepackage[opzione,...]{showkeys}

Permette di vedere le etichette assegnate tramite \label o \biblabel e quelle richia-mate con \ref o \cite. quindi molto utile quando si stia preparando un documentocon molti riferimenti incrociati.

13.1 Opzioni

notciteNon vengono mostrate le etichette richiamate con \cite.

notrefNon vengono mostrate le etichette richiamate con \ref.

draft

il comportamento usuale del pacchetto: mostra le etichette.

finalNessuna etichetta viene mostrata. Si consiglia per di eliminare il caricamento del pac-chetto quando si prepara la versione finale del documento, perch in alcuni casi la suapresenza pu influenzare limpaginazione.

colorColora le etichette. Il colore usuale un grigio leggero, che pu essere modificato asse-gnando significati diversi ai colori refkey e labelkey. Con questa opzione viene caricatoil pacchetto color. Un modo di ridefinire i colori pu essere

\definecolor{labelkey}{rgb}{1,0,0}

che mostrer le etichette in rosso.

29

14tabularx

\usepackage[infoshow,debugshow]{tabularx}

LATEX mette a disposizione lambiente tabular* per costruire tabelle di una fissatalarghezza. Tuttavia lo fa aumentando lo spazio fra le colonne. Il pacchetto tabularx inve-ce aumenta la larghezza di certe colonne indicate con il nuovo specificatore X. Il pacchettocarica array.

Le due opzioni possibili sono equivalenti e mostrano al terminale e nel log i calcolieseguiti per stabilire le dimensioni delle colonne.

\begin{tabularx}{dimen}{preambolo}Comincia una tabella la cui larghezza dimen; le colonne specificate con gli usualicaratteri (l, c, r, p, m, b) avranno la loro larghezza naturale. Si sottrae a dimen lasomma di queste larghezze e la somma degli spazi tra colonne; la larghezza che rimaneviene divisa equamente tra le colonne specificate con X.

XUna colonna specificata cos analoga a una colonna di tipo p, ma non si deve assegnarleuna larghezza che invece verr calcolata automaticamente.

\tracingtabularx

una dichiarazione equivalente alle opzioni date al pacchetto. Utile se si vuole capire checosa non va in una certa tabella quando non sembra fare ci che desideriamo: si apre ungruppo, si d il comando, si compone la tabella e si chiude il gruppo.

30

15varioref

\usepackage[lingua | draft | final]{varioref}

Quando il riferimento a una figura o una tabella fuori testo appare in una paginadiversa da dove sono quegli oggetti, utile indicare anche il numero di pagina. La possibilesoluzione

\newcommand{\fullref}[1] {\ref{#1} a pagina \pageref{#1}}

non soddisfacente perch, dopo tutto, la figura potrebbe capitare proprio nella stessapagina e si dovrebbe modificare il testo del documento per tenerne conto. Il pacchettovarioref cerca di risolvere il problema.

Attenzione: ogni uso dei comandi \vref e \vpageref genera due comandi interni; cipu provocare problemi con la memoria di TEX. Si usi il comando \fullref se si sicuriche loggetto riferito lontano.

15.1 Opzioni

linguaUna delle lingue accettate da babel. Non per tutte il supporto completo. Per litalianolo quasi.

draft | finalLa prima lopzione usuale. Eventuali situazioni a rischio vengono segnalate con unavvertimento. Con lopzione final queste situazioni producono un errore.

Le situazioni a rischio sono rare, ma possono capitare. Se il riferimento a una figuracapita vicino a un cambio pagina, aggiungere al numero della figura le parole nella paginaseguente potrebbe far scattare il cambio di pagina e il riferimento potrebbe cadere sullastessa pagina della figura! La soluzione per questi casi particolari deve essere trovata voltaper volta.

Il pacchetto cerca anche di evitare ripetizioni della stessa formula. Si cerchi di nonabusare delle possibilit offerte, impiegandole solo quando veramente necessario per lachiarezza.

15.2 Comandi

\fullref{etichetta}Produce il numero a cui si riferisce letichetta seguito da a pagina num, dove num il numero di pagina dove compare loggetto a cui ci si riferisce.

\vref{etichetta}Se loggetto a cui ci si riferisce cade nella stessa pagina, il comando equivalente a \ref.Altrimenti diventa come

\ref{etichetta} nella pagina precedente\ref{etichetta} nella pagina a fronte\ref{etichetta} nella pagina successiva\ref{etichetta} a pagina~\pageref{etichetta}

a seconda dei casi. La locuzione a fronte viene usata se la classe del documento usalopzione twoside e loggetto riferito cade sulla stessa coppia di pagine affacciate rispettoal richiamo. Se oggetto e riferimento cadono su pagine che differiscono di pi di uno, viene

31

15. varioref

usato il quarto modo. Lo stesso accade in ogni caso quando la numerazione delle paginenon con numeri arabi.

\vpageref[testo 1][testo 2]{etichetta}Se loggetto a cui ci si riferisce cade nella stessa pagina, viene prodotto il testo contenutonel comando \reftextcurrent. Altrimenti si comporta in modo analogo a \vref. Percapire luso, compreso quello dei due argomenti opzionali, facciamo un esempio.

... si veda lesempio \vpageref{es:pippo} che mostra ...

Verr prodotto il testo seguente, a seconda dei casi.

. . . si veda lesempio in questa pagina che mostra . . .

. . . si veda lesempio nella pagina precedente che mostra . . .

. . . si veda lesempio nella pagina a fronte che mostra . . .

. . . si veda lesempio nella pagina successiva che mostra . . .

. . . si veda lesempio a pagina xx che mostra . . .

Possiamo non essere soddisfatti del testo nel primo caso, magari preferiamo dire lesempioseguente se lesempio cade nella stessa pagina.

... si veda lesempio \vpageref[seguente]{es:pippo} che mostra ...

Questo produrr il testo che mostriamo, a seconda dei casi (manca, ovviamente, il caso incui loggetto riferito viene prima).

. . . si veda lesempio seguente che mostra . . .




Potremmo per non gradire lesempio seguente e preferire il seguente esempio.

... si veda \vpageref[il seguente esempio][lesempio]{es:pippo}che mostra ...

Questo produce uno dei testi che mostriamo.

. . . si veda il seguente esempio che mostra . . .




\vrefrange{etichetta 1}{etichetta 2}Se vogliamo riferirci a una serie di figure o di risultati, o di equazioni, o di tabelle, comun-que di oggetti a cui abbiamo assegnato unetichetta, possiamo dare questo comando chegenerer i riferimenti al primo (quello contrassegnato con etichetta 1) allultimo (quel-lo contrassegnato con etichetta 2) separati da un trattino medio e aggiunger anche iriferimenti alla serie di pagine in cui compaiono (ne scriver una sola se il caso, con ilsistema visto per \vref). Per esempio,

... si vedano le figure \vrefrange{fig:pippo}{fig:pluto}

potrebbe generare

. . . si vedano le figure da 3.2 a 3.4 alle pagine 2426

oppure

. . . si vedano le figure da 3.2 a 3.4 a pagina 24

32

15. varioref

oppure ancora

. . . si vedano le figure da 3.2 a 3.4 nella pagina precedente

o altre variazioni.

\vpagerefrange[testo]{etichetta 1}{etichetta 2} analogo al precedente, si confrontino le differenze fra \vref e \vpageref. Largomentoopzionale serve per il testo da comporre nel caso gli oggetti riferiti appaiano nella stessapagina in cui c il richiamo tramite il comando.

\vrefpagenum{comando}{etichetta}Il primo argomento un nome di comando (con la barra rovescia), il secondo unetichetta.Leffetto di definire il comando come il numero di pagina dove compare loggettocontrassegnato da etichetta. Attenzione: non c alcun controllo se il comando sia gidefinito, usare con cautela. Vediamo un esempio duso (che impiega ifthen).

\newcommand{\divertimento}[2]{%\vrefpagenum{\firstnum}{#1}%\vrefpagenum{\secondnum}{#2}%\ifthenelse{\equal\firstnum\secondnum}%{le equazioni \ref{#1} e \ref{#2} \vpageref{#1}}%{lequazione \ref{#1} \vpageref{#1}% elequazione \ref{#2} \vpageref{#2}}%

}

nel preambolo e

... \divertimento{pippo}{pluto}

potrebbe dare

. . . le equazioni 3 e 4 nella pagina precedente

oppure

. . . lequazione 3 a pagina 24 e lequazione 4 alla pagina a fronte

\vref* | \vpageref* | \vpagerefrange*Per un errore di progettazione, i comandi con lo stesso nome ma senza asterisco produconoautomaticamente uno spazio insecabile alla loro sinistra. Ci li rende inutili se vogliamo,per esempio, un riferimento tra parentesi. In questo caso si deve usare la variante conlasterisco.

15.3 I comandi che producono i testi variabiliElenchiamo i comandi che possibile modificare, indicando la loro definizione usuale

in italiano. Per ridefinirli, occorre usare

\addto\extrasitalian{\renewcommand{comando}[numero]{definizione}...}

dove comando il nome del comando, numero il numero di argomenti e definizione iltesto della definizione. Indicheremo solo il numero di argomenti e la definizione usuale.Si usi lo stesso schema.

33

15. varioref

\reftextfaceafterContiene il testo per i riferimenti alla pagina a fronte successiva. Non ha argomenti.

\reftextvario{a fronte}{nella pagina successiva}

\reftextfacebeforeContiene il testo per i riferimenti alla pagina a fronte precedente. Non ha argomenti.

\reftextvario{a fronte}{nella pagina precedente}

\reftextafterContiene il testo per i riferimenti alla pagina successiva. Non ha argomenti.

nella pagina \reftextvario{seguente}{successiva}

\reftextbeforeContiene il testo per i riferimenti alla pagina precedente. Non ha argomenti.

nella pagina precedente

\reftextcurrentContiene il testo per i riferimenti alla stessa pagina. Non ha argomenti.

in questa pagina

\reftextfarawayContiene il testo per i riferimenti a una pagina lontana. Ha un argomento.

a pagina~\pageref{#1}

\reftextpagerangeQuesto comando ha due argomenti. Non ben definito nella versione italiana. Si consigliadi definirlo (se si usano \vrefrange o \vpagerefrange) usando, come definizione

alle pagine~\pageref{#1}--\pageref{#2}

\reftextlabelrangeQuesto comando ha due argomenti. Non ben definito nella versione italiana. Si consigliadi definirlo (se si usano \vrefrange o \vpagerefrange) usando, come definizione

da \ref{#1} a~\ref{#2}

34

16verbatim

\usepackage{verbatim}

Lambiente verbatim fornito dal nucleo di LATEX ha certi difetti che lo rendono pocoflessibile: per esempio complicato ottenere che il testo da rendere verbatim (latino,significa parola per parola) sia in corpo minore.

Un difetto maggiore che il contenuto di ciascun ambiente verbatim deve essere rac-colto completamente in memoria prima di venire elaborato; ci pu facilmente provocareproblemi.

16.1 Ambienti

\begin{verbatim} | \begin{verbatim*}Il testo compreso fra questo comando e il corrispondente \end{verbatim} viene resocos com, senza interpretare alcun carattere speciale, compresa la barra rovescia. Sifaccia attenzione che, a differenza dellambiente fornito dal nucleo di LATEX, ci che segue\end{verbatim} sulla stessa riga del documento .tex viene scartato (con messaggio diavviso). Fra \end e {verbatim} pu esserci uno spazio, ma non un a capo. La variante * analoga, ma gli spazi vengono stampati come .

\begin{comment}Il testo compreso fra questo comando e il corrispondente \end{comment} viene ignora-to. Ha le stesse limitazioni di verbatim per quanto riguarda testo che compaia dopo\end{comment} sulla stessa riga. utile per commentare intere sezioni di testo che nonvogliamo far comparire nel documento finale, ma che vogliamo mantenere nel sorgente.

\verbatiminput{nome}Il contenuto del file nome viene inserito come se si trovasse allinterno di un ambienteverbatim, cio senza che siano interpretati i caratteri speciali. Pu servire, per esempio,per citare il codice di un programma.

16.2 Creare nuovi ambienti di tipo verbatim

\verbatim, \endverbatimQuesti comandi possono essere impiegati per definire ambienti personalizzati. Si supponga,per esempio, di voler citare alcune righe di codice in corpo minore, in modo che che questerighe comincino a una distanza fissata dal margine sinistro, diciamo il doppio del rientrousuale.

\newenvironment{codice}{\par\medskip\noindent\hspace{2\parindent}%\minipage{\textwidth-2\parindent}\small\verbatim}

{\endverbatim\endminipage\par\medskip}

Si noti che abbiamo usato la sintassi permessa da calc. Questo non obbligatorio; ob-bligatorio usare comandi e non ambienti allinterno di queste definizioni. Per esempiolambiente minipage sostituito da \minipage e \endminipage. Si noti come lultimocomando della prima parte sia \verbatim e il primo della seconda parte sia \endverbatim.

35

17caption

\usepackage[variabile=valore,...]{caption}[2004/07/16]

Uno dei punti tipograficamente meno validi degli stili standard di LATEX quello delledidascalie a figure o tabelle fuori testo. Con il pacchetto caption possibile modificarnelaspetto. Il pacchetto anche compatibile con float, che permette di definire nuovi oggettiflottanti.

Attenzione: una vecchia versione di questo pacchetto potrebbe essere ancora in giro,se la distribuzione che usate non aggiornata. Per evitare di trovarsi errori misteriosi, meglio chiamare questo pacchetto con largomento opzionale indicato come ultimo; solocaption dalla versione 3 in poi sar ammesso.

La didascalia a pagina 25 composta in corpo minore rispetto al testo normale, conletichetta in nero e margini laterali uguali al rientro dei paragrafi. stato usato caption.

Una didascalia formata da tre parti:

unetichetta, che dice se stiamo commentando una figura o una tabella e ne riportail numero;

il corpo, cio il testo del commento;

lo spazio di separazione con il testo del documento.

17.1 OpzioniLe opzioni al pacchetto vanno date nella forma variabile=valore. Se dopo il segno

di uguale compaiono stringhe tra parentesi graffe, quelle sono i valori ammissibili fra cuiscegliere.

format={default,hang}

Se non si specifica lopzione, il valore default. Dando il valore hang, il testo delladidascalia verr allineato a sinistra con il margine destro delletichetta.

format=defaultFigura 17.1: Notte e giorno faticar, per chi nulla sa gradir, piova e vento sopportar,mangiar male, mal dormir! Voglio fare il gentiluomo e non voglio pi servir! Ah, che carogalantuomo, vuol star dentro con la bella e io a far la sentinella!

format=hang

Figura 17.2: Notte e giorno faticar, per chi nulla sa gradir, piova e vento sopportar, man-giar male, mal dormir! Voglio fare il gentiluomo e non voglio pi servir! Ah,che caro galantuomo, vuol star dentro con la bella e io a far la sentinella!

indention=dimenAggiunge un rientro di dimen dalla seconda riga della didascalia. Pu essere anchenegativo.

format=default,indention=2em

Figura 17.3: Notte e giorno faticar, per chi nulla sa gradir, piova e vento sopportar,mangiar male, mal dormir! Voglio fare il gentiluomo e non voglio pi servir! Ah, checaro galantuomo, vuol star dentro con la bella e io a far la sentinella!

36

17. caption

format=hang,indention=-2em

Figura 17.4: Notte e giorno faticar, per chi nulla sa gradir, piova e vento sopportar, man-giar male, mal dormir! Voglio fare il gentiluomo e non voglio pi servir! Ah, checaro galantuomo, vuol star dentro con la bella e io a far la sentinella!

labelformat={empty,simple,parens}

Con empty non ci sar alcuna etichetta; non ha senso usato da solo, si vedano le altrevariabili come labelsep. Con simple si ha lusuale Figura ?. Con parens, il numerodella figura viene messo fra parentesi.

labelformat=parens

Figura (17.5): Notte e giorno faticar, per chi nulla sa gradir, piova e vento sopportar,mangiar male, mal dormir! Voglio fare il gentiluomo e non voglio pi servir! Ah, che carogalantuomo, vuol star dentro con la bella e io a far la sentinella!

labelsep={none,colon,period,space,quad,newline}

Si specifica come separare letichetta dal testo; con none non si ha nulla (ha senso conlabelformat=empty); con colon si hanno gli usuali due punti, con period un pun-to, con space un normale spazio fra parole, con quad uno spazio quadratone. Connewline il testo della didascalia comincia una riga sotto; in tal caso meglio usare lopzionesinglelinecheck=false.

labelsep=newline

Figura 17.6Notte e giorno faticar, per chi nulla sa gradir, piova e vento sopportar, mangiar male, maldormir! Voglio fare il gentiluomo e non voglio pi servir! Ah, che caro galantuomo, vuolstar dentro con la bella e io a far la sentinella!

justification={justified,centerlast}

Con justified il testo composto giustificato ( lopzione usuale). Con centerlastlultima riga di testo centrata.

Esistono anche i valori centerfirst, raggedright, RaggedRight e raggedleft per iquali rimandiamo alla documentazione.

justification=centerlast

Figura 17.7: Notte e giorno faticar, per chi nulla sa gradir, piova e vento sopportar,mangiar male, mal dormir! Voglio fare il gentiluomo e non voglio pi servir! Ah, che caro

galantuomo, vuol star dentro con la bella e io a far la sentinella!

singlelinecheck={true,false}

Usuale il valore true. Se la variabile ha questo valore, una didascalia breve vienecentrata, indipendentemente dal valore di justification. Sinonimi per true sono yese 1. Sinonimi per false sono no e 0.

singlelinecheck=false

Figura 17.8: Didascalia breve

singlelinecheck=true

Figura 17.9: Didascalia breve

font=insieme di valoriQuesta variabile ha come valore un insieme. Si possono specificare la grandezza e la formadel carattere da usare per la didascalia. Il suo valore influenza sia letichetta che il testo.

37

17. caption

I valori per la grandezza sono nellinsieme

{scriptsize,footnotesize,small,normalsize,large,Large}

che si spiegano da soli. I valori per la forma sono nellinsieme

{up,it,sl,sc,md,bf,rm,sf,tt}

Con up si specifica un carattere diritto; con it un carattere corsivo; con sl un carattereinclinato; con sc un carattere maiuscoletto. Con md si chiede un peso medio, con bf ilneretto. Con rm si sceglie il carattere usuale, con sf uno senza grazie, con tt quello aspaziatura fissa.

evidente che non tutte queste opzioni hanno senso. opportuno scegliere, peresempio, small, ed possibile chiedere il corsivo.

font={small,it}

Figura 17.10: Notte e giorno faticar, per chi nulla sa gradir, piova e vento sopportar, mangiarmale, mal dormir! Voglio fare il gentiluomo e non voglio pi servir! Ah, che caro galantuomo,vuol star dentro con la bella e io a far la sentinella!

labelfont=insieme di valoriVale lo stesso discorso di prima, ma il valore di questa variabile influenza solo letichetta.

textfont=insieme di valoriVale lo stesso discorso di prima, ma il valore di questa variabile influenza solo il testo.

Si user quindi font per fissare le caratteristiche comuni, le altre due per quellespecifiche.

font=small,labelfont=bf,textfont=it


font={small,it},labelfont=bf


margin=dimenSpecifica la larghezza del margine bianco a sinistra e a destra della didascalia.

margin=2pc,font=small,labelfont=bf

Figura 17.13: Notte e giorno faticar, per chi nulla sa gradir, piova e vento sopportar,mangiar male, mal dormir! Voglio fare il gentiluomo e non voglio pi servir! Ah, checaro galantuomo, vuol star dentro con la bella e io a far la sentinella!

width=dimenSpecifica la larghezza della riga per la didascalia.

width=24pc

Figura 17.14: Notte e giorno faticar, per chi nulla sa gradir, piovae vento sopportar, mangiar male, mal dormir! Voglio fare il genti-luomo e non voglio pi servir! Ah, che caro galantuomo, vuol stardentro con la bella e io a far la sentinella!

parskip=dimenSpecifica la distanza fra due paragrafi nella didascalia. Si consiglia, per, di non essereprolissi.

38

17. caption

hangindent=dimenSimile a indention, pi utile se la didascalia ha pi di un paragrafo.

style=default

possibile definire stili di didascalie in modo analogo agli stili di pagina. Il pacchettodefinisce solo quello indicato.

aboveskip=dimenSpecifica la spaziatura sopra la didascalia. Il valore usuale per le classi di LATEX 10mathrmpt.

belowskip=dimenSpecifica la spaziatura sopra la didascalia. Il valore usuale per le classi di LATEX 0mathrmpt.

position={top,bottom}I parametri di spaziatura vengono scambiati se si usa il valore top.

tableposition=topVa data come opzione se si preferisce, come da certe usanze tipografiche, porre la didascaliadelle tabelle in testa.

17.2 Comandi

\caption[testo 1]{testo 2} ridefinito rispetto a quello del nucleo di LATEX. Un argomento opzionale vuoto evitache la tabella o figura compaia nella lista relativa.

\caption*{testo}Il testo forma la didascalia, senza etichetta; la figura o tabella non comparir nella listarelativa. In questo caso non ha senso dare il comando \label.

\captionof{tipo}[testo 1]{testo 2}Compone la didascalia come se si fosse allinterno dellambiente tipo (cio figure otable, oppure un ambiente definito tramite il pacchetto float). Utile se si vuole simulareun oggetto flottante con una minipage per evitare che si sposti dal punto ideale. Tuttaviale figure o tabelle potrebbero risultare fuori ordine, usatelo con cautela.

\captionof*{tipo}{testo}Simile al precedente, ma non assegna un numero, come \caption*.

\ContinuedFloatSe una tabella deve essere spezzata in pi parti, questo comando diventa molto utile. Datosubito dopo \begin{table}, fa in modo che il contatore non sia aumentato dal comando\caption. Sar cura dellutente scrivere una didascalia che indichi come la tabella siauna prosecuzione della precedente.

\captionsetup[tipo]{opzioni}Largomento obbligatorio scritto come quello opzionale del pacchetto. Per esempio,

\usepackage[margin=2pc,font=small]{caption}

39

17. caption

equivalente a

\usepackage{caption}\captionsetup{margin=2pc,font=small}

ma il comando ha un uso pi importante. Largomento opzionale contiene un tipodi oggetto flottante (figure o table), ci che permette di definire stili diversi per ledidascalie dei vari oggetti. Non che sia consigliabile, naturalmente.

Il comando pu anche essere usato nel documento, oltre che nel preambolo, per cam-biare lo stile delle didascalie. Pu essere indicato per le figure o tabelle fuori testo inunappendice, per esempio.

\clearcaptionsetup{tipo}Azzera tutte le personalizzazioni date alle didascalie dellambiente tipo, riportandole aivalori definiti dalla classe.

17.3 Altri pacchettiIl pacchetto caption compatibile con float, listings, longtable, rotating, sidecap e

supertabular. Come gi detto, dopo aver dato il comando \newfloatpippo di float, disponibile

\captionsetup[pippo]{opzioni}e cos disponibile anche

\captionsetup[lstlisting]{opzioni}se si usa listings. Tuttavia non si pu usare in questo modo lambiente sideways di rotating.

40

18float

\usepackage{float}

Gli ambienti figure e table non sempre sono sufficienti alle esigenze di chi scrive.Un documento potrebbe avere bisogno anche di algoritmi, grafici o altro. Il pacchettofloat risponde a questa esigenza e permette anche di modificare il modo con cui gli am-bienti tradizionali vengono composti, introducendo il concetto di stile per questi oggettigalleggianti.

18.1 StiliGli stili predefiniti sono:

plain che corrisponde allo stile usuale delle classi di LATEX;

plaintop che simile al precedente, ma fa s che la didascalia sia sempre sopra alloggetto;

boxed che racchiude loggetto in un riquadro;

ruled che pone la didascalia in alto, separata dal testo precedente e dalloggetto dauna linea; unaltra linea separa loggetto dal testo seguente (lesempio quello dipagina 25).

18.2 Comandi

\newfloat{nome}{pos}{ext}[contatore]Definisce un nuovo tipo di oggetto galleggiante e il relativo ambiente nome. Il secondoargomento specifica i valori di preferenza per il posizionamento delloggetto (di solito si dhtp) che saranno usati in mancanza di indicazioni esplicite. Il terzo argomento specificalestensione per il file ausiliario che serve per compilare la lista, analogamente a lof e lotper le liste di figure e tabelle. Largomento opzionale serve per stabilire rispetto a qualecontatore devono essere numerati questi oggetti; per esempio, nella classe book le figure etabelle vengono numerate secondo il contatore chapter.

\floatstyle{stile}Definisce quale stile (vedi sopra) viene usato per i nuovi oggetti introdotti con \newfloat. una dichiarazione globale.

\floatname{nome}{testo}Dichiara che loggetto galleggiante nome sia etichettato con testo.

\floatstyle{ruled}\newfloat{algorithm}{htp}{loa}[[]chapter]\floatname{algorithm}{Algoritmo}

\floatplacement{nome}{pos}Dichiara un nuovo ordine di preferenza per il piazzamento degli oggetti nome, ancorain termini di h, t, p oppure b.

41

18. float

\restylefloat{nome}Ridisegna loggetto galleggiante secondo lo stile valido in quel momento (e dichiarato con\floatstyle). bene che gli oggetti siano trattati in modo uniforme, cos possibilescrivere

\floatstyle{ruled}\restylefloat{figure}

cio si possono applicare i nuovi stili anche a oggetti definiti dal nucleo di LATEX.

\listof{nome}{testo}Compila in quel punto la lista degli oggetti nome con testo come titolo, per esempio

\listof{algorithm}{Elenco degli algoritmi}

Pu essere usato anche con gli ambienti figure e table.

\floatevery{nome}{testo}Il testo dovrebbe essere una sequenza di comandi da applicare a ciascun ambientenome. Per esempio,

\floatevery{figure}{\centering}

dopo aver dato \restylefloat{figure} permette di non dover scrivere \centering inogni ambiente figure.

18.3 Largomento di posizione HUna delle PPF (proteste pi frequenti) : LATEX non mette le figure dove voglio io;

non voglio che se ne vadano in giro!Il pacchetto float mette a disposizione, come argomento opzionale degli ambienti gal-

leggianti, anche H che sta per proprio qui e in nessun altro posto. Questo non pu essereusato con altri caratteri come h, t, p oppure b (ovviamente) n nellargomento pos di\newfloat.

Se la resa tipografica di un documento nel quale impiegate questo trucco non ottima,non prendetevela n con lautore del pacchetto n con lautore di questa breve guida. Cisono buonissime ragioni perch le figure vadano a spasso; se non fossero figure fuori testo,avrebbero infatti il loro posto.

42

19subfig

\usepackage[opzione,...]{subfig}

Il pacchetto subfig il successore del noto subfigure, scritto dallo stesso autore. Il suoscopo di permettere di affiancare pi figure o tabelle, dando a ciascuna una sottodida-scalia. Richiede la presenza del pacchetto caption, sul quale si appoggia pesantemente.

19.1 OpzioniIl pacchetto subfig accetta tutte le opzioni di caption, ma le usa per la composizione del-

le sottodidascalie. Per evitare di dover scrivere tutte le opzioni come argomento opzionalein \usepackage{subfig}, possibile usare la sintassi di caption secondo lo schema

\captionsetup[subfloat]{opzioni}per modificare la forma di composizione delle sottodidascalie. Rimando al capitolo 17 perle opzioni che fornite dal pacchetto caption e discuter solo quelle specifiche di subfig. Vatenuto presente che il formato della numerazione della sottofigura o sottotabella , se nonmodificato, alfabetico e fra parentesi, quindi del tipo (a), (b) e cos via. I contatori chevengono impegati sono subfigure e subtable.

Le opzioni sono del tipo chiave=valore.

listofformat=Serve per stabilire il formato delle didascalie riportate nellelenco delle tabelle o dellefigure. I valori sono descritti di seguito:

empty per non avere n il numero n il titoletto, ma solo da sottodidascalia;

simple per avere il titoletto seguito dal numero della sottofigura e dalla sottodidascalia;

parens come il precedente ma il numero fra parentesi;

subsimple per avere solo il numero della sottofigura e la sottodidascalia;

subparens come il precedente, ma il numero fra parentesi.

listofindent=Prende come valore una dimensione, il rientro dal margine sinistro delle sottodidascalienellelenco delle tabelle o delle figure.

listofnumwidth=Prende come valore una dimensione, lo spazio riservato al numero delle sottofigure nelle-lenco delle tabelle o delle figure.

Per capire le prossime opzioni, facciamo riferimento alle due situazioni possibili: sotto-didascalia in basso o in alto rispetto alla sottofigura o sottotabella, si veda la Tabella 19.1.

farskip=Prende come argomento una lunghezza elastica, indica lo spazio lasciato fra la sottofigurae lambiente circostante dalla parte opposta rispetto alla didascalia.

nearskip=Prende come argomento una lunghezza elastica, indica lo spazio lasciato fra la sottofigurae lambiente circostante dalla parte della didascalia.

43

19. subfig

Tabella 19.1 Nella colonna di sinistra rappresentata la sequenza di oggetti quando la sottodida-scalia in basso rispetto alla sottofigura o sottotabella, in quella di destra la situazione opposta.Qui farskip, captionskip, nearskip e topadjust sono spazi verticali, mentre subfloat esubcaption rappresentano la sottofigura o sottotabella e la sottodidascalia rispettivamente.

farskip nearskipsubfloat subcaption

captionskip captionskipsubcaption topadjustnearskip subfloat

farskip

captionskip=

Prende come argomento una lunghezza elastica, indica lo spazio lasciato fra la sottofigurae la didascalia.

topadjust=

Prende come argomento una lunghezza elastica, indica uno spazio supplementare lasciatofra la sottofigura e la didascalia quando questa in alto.

19.2 Comandi

\subfloat[didascalia_breve][didascalia]{sottooggetto}Inserisce una sottofigura o sottotabella, che qui viene chiamata sottooggetto, un oggettografico o un ambiente tabular, per esempio. I due argomenti opzionali hanno lo stessoruolo dellargomento opzionale e obbligatorio del comando \caption: il primo, se presen-te, indica ci che va nellelenco relativo (\listoffigures o \listoftables), mentre ilsecondo indica la sottodidascalia da porre nellambiente galleggiante. Tuttavia se sonopresenti e vuoti oppure assenti, indicano precisi comportamenti a LATEX. I casi possibilisono quindi sette:

\subfloat{sottooggetto}: il sottooggetto non ha sottodidascalia n numero;

\subfloat[]{sottooggetto}: il sottooggetto ha una sottodidascalia che consistesolo del numero; questo compare anche nellelenco relativo;

\subfloat[didascalia]{sottooggetto}: il sottooggetto ha una sottodidascalia connumero; il tutto compare anche nellelenco relativo;

\subfloat[][didascalia]{sottooggetto}: il sottooggetto ha una sottodidascaliacon numero, ma non compare nellelenco relativo;

\subfloat[][]{sottooggetto}: il sottooggetto ha una sottodidascalia che consistesolo del numero, ma non compare nellelenco relativo;

\subfloat[didascalia_breve][didascalia]{sottooggetto}: il sottooggetto ha ladidascalia numerata e il contenuto di didascalia_breve compare nellelenco relativocon il numero;

\subfloat[didascalia_breve][]{sottooggetto}: il sottooggetto ha la didascaliache consiste solo del numero e il contenuto di didascalia_breve compare nellelencorelativo con il numero.

Ciascun sottooggetto pu contenere un comando \label per potersi riferire in seguitoa esso.

44

19. subfig

\ContinuedFloatSe una figura o tabella molto grande pu essere spezzata in due o pi ambienti dello stessotipo successivi, dando questo comando allinizio del secondo e di quelli che eventualmenteseguono. Nella didascalia dei successivi conveniente dare il comando \caption conargomento opzionale vuoto e ripetere il comando \label per potersi riferire ai numeri deisottooggetti. Un esempio nella Tabella 19.2 e il risultato si trova nella Figura 19.1. Ilcomando , in realt, del pacchetto caption.

Tabella 19.2 Esempio di figura con quattro sottofigure spezzata in due parti.\begin{figure}[htp]\centering\subfloat[][]{...codice...}\qquad\subfloat[][]{...codice...}\caption{Didascalia che descrive le prime due sottofigure.}\label{fig:exa}\end{figure}\begin{figure}[htp]\ContinuedFloat\centering\subfloat[][]{...codice...}\qquad\subfloat[][]{...codice...}\caption[]{Didascalia che descrive le altre due sottofigure.}\label{fig:exa}\end{figure}

(a) (b)

Figura 19.1: Didascalia che descrive le prime due sottofigure.

(c) (d)

Figura 19.1: Didascalia che descrive le altre due sottofigure.

45

20paralist

\usepackage[opzione,...]{paralist}

Il pacchetto paralist dedicato agli ambienti per comporre liste numerate o puntate.Fra le altre funzionalit ha anche quelle del pacchetto enumerate, che quindi non va caricatoinsieme a quello che descriveremo ora.

20.1 OpzioniNel seguito, se le opzioni sono descritte in coppia la prima quella scelta normalmente

(default), cio non necessario specificarla.

newitem | olditemSi pu dare allambiente itemize come argomento opzionale la marca. Per esempio, con\begin{itemize}[$\star$] verr usato il simbolo ? come marcatore degli elementi dellalista. Con lopzione olditem lambiente rimane invariato.

newenum | oldenumSi pu dare allambiente enumerate come argomento opzionale il modo di comporre ilnumero. La funzionalit equivalente a quella del pacchetto enumerate e si rimanda alcapitolo relativo per la descrizione. Con lopzione oldenum lambiente rimane invariato.

alwaysadjust

Lo spazio riservato per le etichette negli ambienti itemize, enumerate, compactitem ecompactenum ampliato o ridotto a seconda dellampiezza delletichetta stessa.

neveradjust

Lopzione ignorata se viene specificata la precedente. Non modifica lampiezza per leetichette nemmeno per quelle specificate manualmente con gli argomenti opzionali.

neverdecrease

Se si usa lopzione alwaysadjust impedisce che lampiezza delle etichette venga diminuita.Altrimenti comandi come \begin{enumerate} e \begin{enumerate}[[]1.] sarebberocomposti in modo diverso.

defblank

Definisce gli ambienti inparablank e asparablank, si veda pi avanti.

pointlessenum

Sopprime il punto finale nelle numerazioni dellambiente enumerate (senza argomentiopzionali). La numerazione negli ambienti annidati uniforme: sar quindi del tipo 1,1.1, 1.1.1.

pointedenum

Analoga alla precedente, ma la numerazione sar del tipo 1., 1.1., 1.1.1..

46

20. paralist

flushright | flushleftLopzione normale (flushright) mantiene il comportamento usuale delle etichette negliambienti per liste, cio letichetta viene composta allineata a destra rispetto allo spazioassegnato. Con lopzione flushleft lallineamento a sinistra.

cfg | nocfgNormalmente paralist legge, se presente, il file paralist.cfg. Con lopzione nocfg lalettura non viene eseguita.

20.2 AmbientiOltre alla possibile modifica gi descritta degli ambienti itemize e enumerate, ci sono

altri ambienti definiti da questo pacchetto.

\begin{asparaenum}[testo]Produce una lista in cui gli elementi sono composti come se fossero normali paragrafi.Largomento opzionale lo stesso che si pu dare allambiente enumerate. Lesempio sipu vedere nella Tabella 20.1.

Tabella 20.1 Esempi duso degli ambienti del pacchetto paralistQuesto testo appare prima dellalista.\begin{asparaenum}\item Questo il primo elementodella lista, abbastanza lungoper dover andare a capo.

\item Questo il secondoelemento della lista. Andr acapo anche questo.\end{asparaenum}

Questo testo appare dopo lalista.

Questo testo appare prima dellalista.

1. Questo il primo elementodella lista, abbastanza lungo perdover andare a capo.

2. Questo il secondo elemen-to della lista. Andr a capo anchequesto.


Questa lista costituita daelementi che rimangono in unparagrafo:\begin{inparaenum}[(i)]\item questo il primo elementodella lista,\item questo il secondoelemento della lista.\end{inparaenum}


Questa lista costituita da ele-menti che rimangono in un paragra-fo: (i) questo il primo elementodella lista, (ii) questo il secondoelemento della lista.


\begin{inparaenum}[testo]Lambiente produce una lista numerata, con lo stesso argomento opzionale possibile perlambiente enumerate, ma composta allinterno del paragrafo in cui si trova. Si noti che,a differenza di quanto si fa di solito, il comando \item non deve essere preceduto da unariga vuota.

47

20. paralist

\begin{compactenum}[testo]Produce una lista numerata senza le spaziature verticali aggiunte dallusuale ambienteenumerate. Largomento opzionale lo stesso possibile per lambiente enumerate.

\begin{asparaitem}[testo]\begin{inparaitem}[testo]\begin{compactitem}[testo]I tre ambienti sono lanalogo dei precedenti, ma per itemize invece che per enumerate.Largomento opzionale definisce il simbolo per la marcatura degli elementi della lista.

\begin{asparadesc}\begin{inparadesc}\begin{compactdesc}

I tre ambienti sono lanalogo dei precedenti rispetto allambiente description. Ricordareche in questi ambienti il comando \item deve avere largomento opzionale.

\begin{asparablank}\begin{inparablank}

Sono ambienti richiesti allautore da parte di utenti di LyX; chi legge questa guida nonusa LyX e quindi non se ne serve. Sono disponibili solo dando lopzione defblank.

20.3 ComandiI comandi che si descriveranno possono andare in un file paralist.cfg e in questo

modo verranno eseguiti per ogni documento che carichi il pacchetto paralist.

\pointedenum | \pointlessenumSono analoghi alle opzioni che si possono dare al pacchetto, da usare localmente. Peresempio, in un documento in cui in vigore lopzione pointedenum, si pu ottenere unambiente in cui i numeri non siano seguiti dal punto nel modo seguente:

\newenvironment{myenum}{\pointlessenum\begin{enumerate}}{\end{enumerate}}

\paradescriptionlabelLe etichette nellambiente description sono composte secondo la definizione del comando\descriptionlabel. Il comando in oggetto regola il formato delle etichette negli ambientiasparadesc e inparadesc. La sua definizione usuale equivalente a

\newcommand{\paradescriptionlabel}[1]{\normalfont\bfseries #1}

e pu essere modificata con \renewcommand.

\setdefaultitem{testo1}{testo2}{testo3}{testo4}Possiamo, con questo comando, modificare le marche per i vari ambienti di tipo itemizeannidati. La definizione delle classi standard equivalente a

\setdefaultitem{\textbullet}{\normalfont\bfseries\textendash}{\textasteriskcentered}{\textperiodcentered}

I quattro argomenti sono precisamente le marche da usare. Volendo modificarne solo unao pi, possibile lasciare gli altri argomenti vuoti:

\setdefaultitem{}{$\triangleright$}{}{}

48

20. paralist

cambia solo le marche negli ambienti di tipo itemize di secondo livello.

\setdefaultenum{testo1}{testo2}{testo3}{testo4}Possiamo, con questo comando, modificare le numerazioni per i vari ambienti di tipoenumerate annidati. La definizione delle classi standard equivalente a

\setdefaultenum{1.}{(a)}{i.}{A.}

e come per il comando precedente possibile lasciare un argomento vuoto per non modi-ficare la numerazione nel livello corrispondente.

\setdefaultleftmargin{dim1}{dim2}{dim3}{dim4}{dim5}{dim6}Possiamo, con questo comando, modificare il margine sinistro negli ambienti di composi-zione di liste. Ciascu

LaTeX, Breve guida ai pacchetti di uso più comune

Documents

Transcript of LaTeX, Breve guida ai pacchetti di uso più comune