Arte

lorenzo pantieri

&

tommaso gordini

L arte di scrivere con latex '

Un’introduzione a LATEX

nuova edizione

Prefazione di Enrico Gregorio

Gruppo Utilizzatori Italiani di TEX e LATEX

http://www.guit.sssup.it/

Aprile 2011

Lorenzo Pantieri, Tommaso Gordini, L’arte di scrivere con LATEX. Un’introduzione a LATEX, © aprile 2011.

Nota degli autori.

Questo lavoro è stato realizzato con LATEX su Mac usando ArsClassica, una rielaborazione dello stile ClassicThesis di André Miede ispirato a Gli elementi dello stile tipografico di Robert Bringhurst.

I nomi commerciali, i loghi e i marchi registrati che compaiono nella guida appartengono ai rispettivi proprietari. I pacchetti e le loro documentazioni appartengono ai rispettivi autori.

Il frontespizio riproduce una litografia e un’incisione di Maurits Cornelis Escher dal titolo Mano con sfera riflettente e Tassellazione del piano con uccelli (tutte le riproduzioni delle opere di Escher contenute nella guida sono tratte da + escher).

Contatti:

http://www.lorenzopantieri.net/ lorenzo.pantieri@iperbole.bologna.it · Lorenzo Pantieri illinguista1972@gmail.com · Tommaso Gordini

La citazione è un utile sostituto dell’arguzia.

— Oscar Wilde

Dedicato a Monia e alla sua dolce bellezza.

INDICE

prefazione

introduzione

1

xiii xvii

storia e filosofia 1 1.1 Storia 1 1.1.1 TEX 1 1.1.2 Etimologia 2 1.1.3 LATEX 3 1.2 Filosofia 4 1.2.1 Composizione sincrona e asincrona 1.2.2 Le istruzioni di marcatura 5 1.2.3 LATEX: pro e contro 6 1.2.4 Luoghi comuni 8

2

installare latex 11 2.1 Introduzione 11 2.2 LATEX e pdfLATEX 12 2.2.1 La ricerca diretta e inversa 12 2.2.2 dvi: pro e contro 13 2.2.3 pdf: pro e contro 13 2.2.4 Conclusioni 13 2.3 Installare LATEX su Windows 14 2.3.1 MiKTEX 14 2.3.2 TEX Live per Windows 14 2.3.3 Editor per Windows 15 2.4 Installare LATEX su Mac 17 2.4.1 TEX Live per Mac: MacTEX 17 2.4.2 Editor per Mac 17 2.5 Installare LATEX su Linux 17 2.5.1 TEX Live per Linux 17 2.5.2 Editor per Linux 18 2.6 Editor multipiattaforma 18

3

le basi 19 3.1 Il nostro primo documento con LATEX 19 3.1.1 Scrivere il codice 20 3.1.2 Compilare 20 3.1.3 Correggere gli errori 21 3.1.4 Visualizzare 21 3.1.5 Stampare 21 3.2 I file sorgente di LATEX 21 3.2.1 La struttura del file sorgente 22 3.2.2 Spazi e righe vuote 23 3.2.3 Caratteri speciali 24 3.2.4 Comandi, dichiarazioni e ambienti 3.2.5 Commenti 27

4

25

v

indice

vi

3.3 3.4

3.5 3.6

3.7 4

3.2.6 Codici sorgente ordinati 27 Le classi di documento 29 I pacchetti 31 3.4.1 MiKTEX Package Manager 32 3.4.2 TEX Live Manager 32 3.4.3 Installare un pacchetto a mano 34 3.4.4 Come caricarli?

34 3.4.5 Imparare a usarli: la documentazione 3.4.6 E i file .ins e .dtx?

35 3.4.7 I pacchetti di uso più comune 36 Stili di pagina 37 File con cui si ha a che fare 38 3.6.1 File dell’utente 38 3.6.2 File di classi, pacchetti e stili 38 3.6.3 File ausiliari 39 3.6.4 File di output 39 Documenti di grandi dimensioni 40

35

il testo 43 4.1 Scrivere nelle varie lingue 43 4.1.1 La codifica di output: fontenc 43 4.1.2 La codifica di input: inputenc 45 4.1.3 Le scelte tipografiche: babel 46 4.2 La struttura del testo 48 4.3 Comporre i capoversi 48 4.3.1 Dividere le parole in fine di riga 51 4.3.2 Il pacchetto microtype 53 4.3.3 Il rientro della prima riga 53 4.4 Sezionare il documento 53 4.4.1 Materiale iniziale, principale e finale 54 4.4.2 L’indice generale 55 4.4.3 Miniindici 57 4.5 Le proporzioni di pagina 57 4.5.1 Il tormentone dei margini 57 4.5.2 Interlinea e riempimento della pagina 59 4.6 Caratteri particolari e simboli 60 4.6.1 Virgolette, tratti e puntini di sospensione 60 4.6.2 Riferimenti ipertestuali e indirizzi Internet 61 4.6.3 Loghi, caratteri particolari, apici e pedici 65 4.7 Titoli e frontespizi 66 4.8 Riferimenti incrociati 68 4.9 Note a margine e a piè di pagina 69 4.10 Evidenziare le parole 70 4.11 Ambienti 70 4.11.1 Elenchi puntati, numerati e descrizioni 70 4.11.2 Allineare e centrare i capoversi 72 4.11.3 Citazioni 73 4.11.4 Poesie 74 4.11.5 Codici e algoritmi 75 4.12 Acronimi e glossari 77 4.13 Specialità 77 4.14 La revisione finale 79

5

6

indice

la matematica 83 5.1 Formule in linea e in display 84 5.1.1 Formule “in linea” 84 5.1.2 Formule “in display” 84 5.1.3 Modo matematico e modo testuale 86 5.2 Le basi 86 5.2.1 Raggruppamenti 87 5.2.2 Esponenti, indici e radici 87 5.2.3 Somme, prodotti e frazioni 87 5.2.4 Limiti, derivate e integrali 88 5.2.5 Insiemi numerici 89 5.2.6 Lettere greche 89 5.2.7 Simboli che sormontano altri simboli 90 5.2.8 Barre e accenti 90 5.2.9 Punti e frecce 92 5.2.10 Spazi in modo matematico 93 5.3 Operatori 94 5.4 Parentesi 95 5.5 Vettori e matrici 98 5.6 Formule lunghe 99 5.6.1 Spezzare formule senza allineamento: multline 100 5.6.2 Spezzare formule con allineamento: split 100 5.6.3 Raggruppare formule senza allineamento: gather 100 5.6.4 Raggruppare formule con allineamento: align 101 5.6.5 Gli ambienti gathered e aligned 101 5.6.6 Casi e numerazione subordinata 102 5.7 Modificare stile e corpo del font 102 5.8 Enunciati e dimostrazioni 104 5.9 Diagrammi commutativi 108 5.10 Fisica e chimica 108 5.11 Evidenziare formule: il pacchetto empheq 109 5.12 Elenco dei simboli matematici 110 tabelle e figure 117 6.1 Strumenti fondamentali 117 6.2 Oggetti “in testo” e “fuori testo” 119 6.3 Tabelle 120 6.3.1 Indicazioni generali 120 6.3.2 Tabelle standard: tabular e array 122 6.3.3 Celle con testo troppo lungo 123 6.3.4 Colonne di soli numeri: siunitx 125 6.3.5 Celle multicolonna 127 6.3.6 Celle multiriga 128 6.3.7 Spaziare a mano righe e colonne 129 6.3.8 Personalizzare le colonne: array 130 6.3.9 Tabelle colorate 133 6.3.10 Tabelle con note 134 6.3.11 Tabelle grandi 134 6.4 Figure 139 6.4.1 Immagini vettoriali e bitmap 139 6.4.2 Convertire i formati 140 6.4.3 Ritagliare le immagini 140

vii

indice

viii

6.5

6.4.4 Alcuni programmi utili 141 6.4.5 Includere le immagini 142 Oggetti mobili 144 6.5.1 Gli ambienti table e figure 144 6.5.2 Codici tipo 146 6.5.3 Controllare gli oggetti mobili 147 6.5.4 Personalizzare le didascalie: caption 6.5.5 Specialità 150

149

7

la bibliografia 155 7.1 L’ambiente thebibliography 155 7.2 Il pacchetto biblatex 157 7.3 Le basi di biblatex 157 7.3.1 Caratteristiche generali e pacchetti accessori 158 7.3.2 Basi di dati dei riferimenti bibliografici 158 7.3.3 I diversi tipi di record 159 7.3.4 I diversi tipi di campo 161 7.3.5 Stili bibliografici e schemi di citazione 163 7.3.6 Collocare la bibliografia nel documento 166 7.3.7 Comandi per le citazioni 167 7.3.8 Generare la bibliografia 168 7.3.9 Stili bibliografici personalizzati 169 7.4 Specialità 170 7.4.1 Campi speciali 170 7.4.2 Campi omissibili 170 7.4.3 Riferimenti finali e riferimenti cliccabili 170 7.4.4 Bibliografia multilingue 171 7.4.5 Suddividere la bibliografia 171

8

indice analitico 177 8.1 Creare l’indice analitico 177 8.2 Personalizzare l’indice analitico

9

179

personalizzare latex 181 9.1 Comandi, ambienti e pacchetti nuovi 181 9.1.1 Nuovi comandi 181 9.1.2 Spazi dopo i comandi 183 9.1.3 Nuovi ambienti 183 9.1.4 Pacchetti e classi personalizzate 184 9.2 Sfondi colorati per le immagini 185 9.3 Testatine personalizzate 185 9.4 Modificare le voci generate da babel 186 9.5 Font 187 9.5.1 Che cos’è un font? 187 9.5.2 Larghezza: fissa o variabile?

187 9.5.3 Abbellimenti: con grazie o senza? 189 9.5.4 Modificare stile e corpo del font in uso 189 9.5.5 Scegliere i font 191

a norme tipografiche italiane a.1 Accento e apostrofo 195 a.2 Punteggiatura e spaziatura

195 197

a.2.1 Segni di interpunzione 197 a.2.2 Virgolette 197 a.2.3 Parentesi 197 a.2.4 Puntini di sospensione 198 a.2.5 Trattino, tratto e lineetta 198 a.2.6 Barra e asterisco 199 a.3 Stile del font 199 a.3.1 Corsivo 199 a.3.2 Neretto 200 a.3.3 Maiuscoletto 200 a.4 Composizione del testo 200 a.4.1 Parole straniere 200 a.4.2 Numeri 201 a.4.3 Frazioni, percentuali, unitĂ di misura a.4.4 Acronimi 202 b

galleria degli orrori 205 b.1 Testo 205 b.1.1 Caratteri accentati 205 b.1.2 Sillabazione 206 b.1.3 Margini 206 b.1.4 Indirizzi Internet 206 b.2 Le tabelle 207 b.2.1 Regole generali 207 b.2.2 Allineare i numeri alla virgola 209 b.2.3 Tabelle mobili 209 b.3 Le figure 211 b.4 La matematica 212 b.4.1 Formule in display 212 b.4.2 Operatori 215 b.4.3 Parentesi 216 b.4.4 Matrici 217 b.4.5 Integrali multipli 217 b.4.6 Insiemi numerici 218 b.4.7 Riferimenti a una formula 218 b.4.8 Puntini di sospensione 219

c latex per gli umanisti 221 c.1 Scrivere in latino 221 c.1.1 Marche prosodiche 222 c.1.2 Latino medievale 223 c.1.3 Documenti interamente in latino 224 c.2 Scrivere in greco 225 c.2.1 La traslitterazione dei caratteri 226 c.2.2 Scrivere in greco nel sorgente 228 c.2.3 Documenti interamente in greco 230 c.2.4 Il pacchetto teubner 231 acronimi

233

elenco dei siti internet bibliografia

239

237

indice

202

ix

x

indice

indice analitico

243

ELENCO DELLE FIGURE

Figura 1 Figura 2 Figura 3 Figura 4 Figura 5 Figura 6 Figura 7 Figura 8 Figura 9 Figura 10 Figura 11 Figura 12 Figura 13 Figura 14 Figura 15 Figura 16 Figura 17 Figura 18 Figura 19 Figura 20 Figura 21 Figura 22

Donald Knuth 1 Dispensa di matematica degli anni Settanta 2 Leslie Lamport 3 Alcuni editor per LATEX 16 Un breve documento 23 La gestione automatica dei pacchetti 33 Esempio d’uso del pacchetto frontespizio 67 Tabella ottenuta con sidewaystable 136 Figura collocata a mano 149 Esempio d’uso del pacchetto subfig 151 Esempio d’uso del pacchetto sidecap 152 Esempio d’uso del pacchetto wrapfig 153 Alcuni stili bibliografici 165 Bibliografia suddivisa per argomenti 172 Bibliografia suddivisa per tipo di fonte 174 Immagini con sfondo colorato 185 Esempio d’uso del pacchetto fancyhdr 186 Famiglie di font a larghezza variabile 188 Famiglie di font a larghezza fissa 188 Font Utopia 193 Esempio di figura mobile 212 Tastiera italo-greca 226

E L E N C O D E L L E TA B E L L E

Tabella 1 Tabella 2 Tabella 3 Tabella 4 Tabella 5 Tabella 6 Tabella 7 Tabella 8 Tabella 9 Tabella 10 Tabella 11 Tabella 12 Tabella 13 Tabella 14 Tabella 15 Tabella 16

Cronologia di TEX e LATEX 4 Caratteri speciali di LATEX 24 Scorciatoie da tastiera 25 Opzioni delle classi standard 30 Suddivisione tradizionale di un testo scientifico Comandi di sezionamento del documento 54 Loghi di uso frequente 64 Accenti e caratteri particolari 65 Lettere greche minuscole 89 Spazi in modo matematico 93 Operatori predefiniti 95 Lettere greche minuscole 110 Lettere greche maiuscole 110 Accenti in modo matematico 110 Relazioni binarie 111 Operazioni binarie 111

49

xi

xii

elenco delle tabelle

Tabella 17 Tabella 18 Tabella 19 Tabella 20 Tabella 21 Tabella 22 Tabella 23 Tabella 24 Tabella 25 Tabella 26 Tabella 27 Tabella 28 Tabella 29 Tabella 30 Tabella 31 Tabella 32 Tabella 33 Tabella 34 Tabella 35 Tabella 36 Tabella 37 Tabella 38 Tabella 39 Tabella 40 Tabella 41 Tabella 42 Tabella 43 Tabella 44 Tabella 45 Tabella 46 Tabella 47 Tabella 48 Tabella 49 Tabella 50 Tabella 51 Tabella 52 Tabella 53 Tabella 54 Tabella 55 Tabella 56 Tabella 57

Grandi operatori 112 Delimitatori 112 Grandi delimitatori 112 Frecce 113 Simboli misti 114 Simboli non matematici 114 Altri caratteri alfabetici 114 Altre relazioni binarie 115 Altre operazioni binarie 115 Negazioni di simboli 116 Font matematici 116 Tabella che viola le regole generali 120 Tabella che rispetta le regole generali 120 Descrittori standard per le tabelle 122 Tabella con colonna p 123 Tabella ottenuta con il pacchetto tabularx 124 Tabella con colonne della stessa larghezza 125 Tabella con colonna S 126 Tabella con cella multicolonna 128 Tabella con celle multiriga 128 Tabella con celle multiriga e multicolonna 129 Comportamenti di una colonna p 132 Tabella ottenuta con il pacchetto array 133 Tabella con le righe dispari colorate 134 Tabella con font di dimensione ridotta 135 Un esempio di tabella ripartita su piÚ pagine 137 Alcuni programmi utili per lavorare con LATEX 141 Principali chiavi del pacchetto graphicx 142 Indicatori di preferenza per gli oggetti mobili 145 Caratteri di collocazione di wrapfloat 154 Esempi di voci dell’indice analitico 178 Voci italiane di babel 187 Comandi per modificare lo stile del font 189 Comandi per modificare il corpo del font 190 Corpo del font nelle classi standard 191 Alcuni stili Computer Modern 193 Tabella composta scorrettamente 208 Tabella composta secondo le regole 208 Tabella con allineamento alla virgola 210 Esempio di tabella mobile 211 Diacritici e punteggiatura del greco antico 227

P R E FA Z I O N E A L L A P R I M A EDIZIONE

La storia di TEX in Italia è lunga: secondo i resoconti del TEX Users Group, il primo convegno su TEX tenuto in Europa è stato a Como nel maggio 1985 e ne esiste perfino un volume di rendiconti a cura di Dario Lucarella.

Per lunghi anni, però, è mancato un manuale in italiano che spiegasse ai possibili utenti di LATEX come cominciare a scrivere documenti con questo sistema. Da pochi anni è disponibile la traduzione italiana della Not So Short Introduction to LATEX 2ε , che però è ferma a una versione abbastanza antiquata. Si trovano nei meandri di Internet altre guide, alcune scritte fin dall’inizio in italiano, altre tradotte. Tutte, compresa la Not So Short, soffrono di un grave difetto: rispecchiano in gran parte il modo in cui il loro autore ha imparato TEX e LATEX. Ogni utente di LATEX ha sviluppato le proprie tecniche, raccolte qua e là in modo spesso disordinato, e difficilmente si adatta a cambiare anche se ne scopre di nuove e anche più efficienti. Chiunque abbia provato a raccogliere documenti scritti da diverse persone se ne rende conto a una prima occhiata: molti di questi documenti hanno trovato posto nelle raccolte di orrori. Sia chiaro, nessuno è immune dagli orrori, compreso chi scrive: quando penso a come scrivevo codice LATEX anni fa mi vengono i brividi. Quando leggo una guida a LATEX la prima cosa che faccio è cercare gli orrori e inevitabilmente li trovo, così come li si trova molto facilmente nei preamboli che circolano fra chi scrive tesi di laurea o di dottorato.

Non vorrei dare l’impressione di criticare gente che ha speso molto tempo per mettere a disposizione di tutti le proprie conoscenze: ogni guida ha pregi e difetti, solo che i difetti hanno la curiosa tendenza di diffondersi più dei pregi. Anche nel mondo LATEX evidentemente vale il principio che la moneta cattiva scaccia quella buona.

Che dire di questa guida scritta da Lorenzo Pantieri? Che forse è l’unica che affronta alla radice il problema descritto. Ciò che a prima impressione può apparire pignoleria è invece profonda curiosità di andare alla ricerca del modo migliore per risolvere i problemi. Mi riferisco alle innumerevoli domande poste da Lorenzo sul forum del guIt su questioni stilistiche, su come affrontare problemi tipografici o più strettamente riguardanti LATEX. Questa curiosità non è pedanteria fine a sé stessa: è desiderio di esplorare il linguaggio LATEX per trovare sempre la soluzione più efficace.

Il risultato è una guida molto piacevole da leggere, che introduce al linguaggio LATEX in modo chiaro evitando per quanto possibile le complicazioni che spesso si trovano in altri scritti simili. Certo, non è completa: se pensiamo che il LATEX Companion ha più di mille pagine, siamo molto distanti da questo obiettivo, che lo stesso autore dice di non avere. Nessuna guida potrà mai essere completa, visto che LATEX è usato per comporre documenti di generi diversissimi, dalla matematica alla fisica, al diritto o alle edizioni critiche di testi classici. In una guida introduttiva, soprattutto a LATEX, è importante la chiarezza nel-

xiii

la spiegazione dei motivi che impongono all’utente certe scelte, con l’indicazione di dove trovare le soluzioni ai problemi che nella guida stessa sono solo accennati.

Devo menzionare l’eccellente guida scritta con grande competenza da Claudio Beccari, che però è rivolta a un pubblico diverso: sicuramente chi avrà letto L’arte di scrivere con LATEX sarà in grado, se lo desidera, di affrontare gli argomenti più complessi oggetto di quell’opera.

Questa è solo la prima edizione: possiamo essere sicuri che Lorenzo sarà sempre pronto ad aggiunte e correzioni in modo che chi la legge trovi facilmente la risposta ai propri problemi. Sarà un piacere provare a dare una mano sul forum in modo che questa guida diventi ancora migliore e conquisti sempre nuovi lettori contribuendo alla diffusione di TEX e LATEX in Italia.

Padova, 30 marzo 2008

Enrico Gregorio

A P R O P O S I TO D I Q U E S TA NUOVA EDIZIONE

La seconda edizione dell’Arte ha la grande novità di un secondo autore, Tommaso Gordini, la cui pignoleria linguistica è pari alla pignoleria TEXnica di Lorenzo Pantieri. Il risultato è una profonda revisione del testo: anche grazie ai consigli e suggerimenti dei numerosi lettori, questa guida è arrivata a una maturità che la rende indispensabile a chi voglia imparare a maneggiare LATEX con facilità. Gli autori perdoneranno la parola “pignoleria” usata con grande affetto: è caparbietà e ostinazione nella ricerca del modo migliore di trasmettere i concetti al lettore, evitando come la peste i tecnicismi e le parole arcane tanto frequenti nei manuali di software. Credo che l’obiettivo sia stato raggiunto con successo.

Resta solo da augurare agli autori un buon riposo in vista della terza edizione. Il mondo TEX è sempre in fermento: XETEX e LuaTEX promettono nuovi traguardi e possibilità per chi ama comporre i propri testi secondo i canoni dell’arte tipografica tramandata da secoli.

Padova, 16 luglio 2010

xiv

Enrico Gregorio

RINGRAZIAMENTI

Desidero ringraziare innanzitutto i membri dello staff del guIt e poi tutti quelli che hanno discusso con me sul forum del Gruppo, in particolare Fabiano Busdraghi, Gustavo Cevolani, Rosaria D’Addazio, Massimiliano Dominici, Gloria Faccanoni, Gianluca Gorni, Maurizio Himmelmann, Jerónimo Leal, Lapo Filippo Mori, Andrea Tonelli, Emiliano Giovanni Vavassori ed Emanuele Vicentini, per l’insostituibile aiuto fornito nella redazione di questo lavoro, le spiegazioni dettagliate, la pazienza e la precisione nei suggerimenti, le soluzioni fornite, la competenza e la disponibilità: grazie mille, ragazzi!

Rivolgo un ringraziamento davvero particolare al professor Enrico Gregorio, per i suoi impagabili insegnamenti e per avermi concesso l’onore di scrivere la prefazione alla guida.

Un “grazie” altrettanto speciale va al professor Claudio Beccari, per i consigli durante la revisione di un’opera che senza la sua pazienza non avrebbe mai raggiunto la forma attuale.

Ringrazio infine André Miede, per aver realizzato lo stile ClassicThesis (con cui è composto questo lavoro), Daniel Gottschlag, che mi ha dato lo spunto per realizzarne un’originale rielaborazione, e Ivan Valbusa, per aver creato lo stile con cui è composta la bibliografia di questa guida.

Lorenzo Pantieri Un libro come questo non può mai dirsi veramente concluso, e per fortuna il vuoto lasciato dalla fine del lavoro non è così grande. Ai ringraziamenti di Lorenzo, che faccio miei, dovrei aggiungere quelli a un numero imprecisato di persone: lo faccio silenziosamente, e so che non me ne vorranno per non vedere il proprio nome in queste righe.

Voglio però nominare e ringraziare, non necessariamente in quest’ordine, le quattro impigliatesi più saldamente nella rete.

I miei genitori: devo a loro il fatto di capirci (qualche volta) qualcosa.

Direi che hanno fatto un buon lavoro.

Alberto, che per primo mi disse: «infatti non è Word, è làtek!». Non nascondo che lì per lì l’osservazione mi lasciò del tutto indifferente.

Enrico, il saggio Vecchio Lupo che ha una pazienza grande come il sole e che (ancora) non perde il pelo. Il resto lo conosce.

Eleonora, adorabile e impotente compagna in quest’avventura: senza di lei non potreste leggere quello che state leggendo. Questo libro è più suo che mio.

Tommaso Gordini Cesena-Padova, 16 luglio 2010

xv

INTRODUZIONE

Abbiamo visto che la programmazione è un’arte, perché richiede conoscenza, applicazione, abilità e ingegno, ma soprattutto per la bellezza degli oggetti che produce.

— Donald E. Knuth [1973]

LATEX è un programma di composizione tipografica liberamente disponibile, indicato soprattutto nella preparazione di documenti scientifici ai più elevati livelli di qualità. Lo scopo di questo lavoro, rivolto sia a chi muove i primi passi in LATEX sia a quanti già lo conoscono, è di offrire ai suoi utenti italiani le conoscenze essenziali per poterlo usare con successo.

I concetti fondamentali della materia, raccolti da svariati manuali, vengono presentati in un unico documento e nel modo più chiaro e organico possibile; nel contempo, si fornisce un vasto campionario di esempi e si analizzano alcuni problemi tipici della stesura di una pubblicazione scientifica o professionale in italiano, indicando per ciascuno le soluzioni per noi migliori.

Queste derivano principalmente dalle numerose discussioni presenti sul forum del guIt (Gruppo Utilizzatori Italiani di TEX e LATEX, + guit), che resta sempre un eccellente riferimento per tutti i temi trattati in questa guida, la cui lettura, lo ricordiamo, presuppone una familiarità almeno basilare con l’uso del calcolatore e di Internet.

In linea generale, si è seguita la prassi di non scandagliare troppo i vari argomenti: di ciascun pacchetto citato, infatti, si analizzano soltanto le impostazioni più importanti e se ne suggerisce l’uso, indirizzando alla relativa documentazione il lettore che voglia approfondirne la conoscenza.

L’esposizione degli argomenti è articolata come segue: nel primo capitolo si traccia una breve storia di LATEX, indicandone idee di fondo e peculiarità. nel secondo capitolo si spiegano le procedure per installare LATEX sul proprio calcolatore. nel terzo capitolo si presentano alcune nozioni di base indispensabili per comprendere il funzionamento del programma. nel quarto capitolo si forniscono gli elementi per realizzare veri e propri documenti testuali. nel quinto capitolo si esplora uno dei principali punti di forza di LATEX: la composizione di formule matematiche. nel sesto capitolo si presentano i concetti e gli strumenti essenziali per comporre le tabelle, includere le figure in un documento e gestire la collocazione sulla pagina di entrambi gli oggetti.

xvii

xviii

introduzione

nel settimo capitolo si presentano gli strumenti per realizzare e gestire la bibliografia. nell’ottavo capitolo si illustrano le nozioni essenziali per generare l’indice analitico. nel nono capitolo si espongono alcuni suggerimenti per fare in modo che LATEX produca risultati diversi da quelli predefiniti. nell’appendice a si descrivono sinteticamente le principali norme tipografiche per l’italiano. nell’appendice b si raccolgono alcuni esempi tratti dalle più diffuse guide introduttive a LATEX per suggerire come non si dovrebbe (mai) scrivere con questo programma. nell’appendice c, infine, si presentano gli strumenti per scrivere in latino e in greco.

Questo non è un manuale su LATEX, ma piuttosto un tentativo di riordinare in forma scritta appunti accumulatisi nel tempo, via via che divenivamo abituali utenti di questo programma. In qualità di semplici appassionati, non abbiamo nulla da insegnare; d’altra parte abbiamo studiato LATEX e l’abbiamo usato intensamente, acquisendo una certa esperienza che ci piacerebbe condividere con altri utenti.

Se avete idee su argomenti da aggiungere, togliere o modificare in questo documento, o se vi dovesse capitare di notare errori, sia di battitura che di sostanza (ed è probabile che ce ne siano parecchi, e del primo e del secondo tipo), fareste davvero una cosa gradita comunicandocelo, così da poterli correggere nelle versioni successive del lavoro.

In modo particolare, ci interessano i commenti di chi è alle prime armi su quali parti di questa guida sono di più facile comprensione e quali invece potrebbero essere spiegate meglio. È questo lo spirito che ci ha guidato in questo lavoro: speriamo che possiate usare LATEX con il nostro stesso piacere.

1 indice 1.1

1.2

STORIA E FILOSOFIA Storia 1 1.1.1 TEX 1 1.1.2 Etimologia 2 1.1.3 LATEX 3 Filosofia 4 1.2.1 Composizione sincrona e asincrona 1.2.2 Le istruzioni di marcatura 5 1.2.3 LATEX: pro e contro 6 1.2.4 Luoghi comuni 8

4

Questo capitolo presenta una breve storia di TEX e LATEX, e ne indica idee di fondo e peculiarità.

1.1

storia

1.1.1 TEX

TEX è un programma di composizione tipografica realizzato da Donald Ervin Knuth, professore di Informatica all’Università di Stanford (usa), e distribuito con una licenza di software libero.

Nel 1977, Knuth cominciò a scrivere il suo “motore” di tipocomposizione per esplorare le potenzialità degli strumenti di stampa digitale che allora cominciavano a prendere piede in campo editoriale. La qualità tipografica delle proprie pubblicazioni (e soprattutto del capolavoro The Art of Computer Programming, in più volumi ricchi di formule Figura 1: Donald Ervin Knuth (l’imma- matematiche), constatava Knuth, gine è tratta da + knuth). era in crescente peggioramento: a quel tempo, infatti, gran parte della matematica si componeva con la macchina per scrivere, alzando e abbassando il carrello per indici ed esponenti, e cambiando testina

Breve storia di TEX

1

2

storia e filosofia

Figura 2: Pagina di una dispensa di matematica degli anni Settanta del secolo scorso, dattilografata, con aggiunte a mano.

per i simboli (si veda la figura 2). Con TEX, il Professore sperava di porre un freno a questa tendenza.

Il programma ha visto la luce nel 1982, e da allora ha subito costanti aggiornamenti e miglioramenti, tra cui quello del 1989, che gli ha permesso di supportare un numero considerevolmente maggiore di caratteri (anche non latini). TEX è rinomato per essere estremamente stabile ed eseguibile su diversi tipi di calcolatore, ed è stato rivisto per l’ultima volta nel 2008. Il suo numero di versione converge a π (attualmente è 3,141 592 6).

The TEXbook, scritto da Donald Knuth, è il manuale d’uso di TEX e uno dei libri più completi su questo programma. Attualmente, TEX è un marchio registrato della AMS (American Mathematical Society).

TEX non si pronuncia come si scrive!

1.1.2 Etimologia

Knuth ha nascosto un trabocchetto nel nome del programma: TEX, infatti, si pronuncia tèch (aspirando il ch finale) e non com’è scritto, perché è una parola greca scritta in greco maiuscolo (in lettere minuscole si scriverebbe τεχ). Si tratta di un’antichissima radice indoeuropea comune non soltanto ai greci τέκτων (pron. tèkton, “artefice”) e τέχνη (pron. tèchne, insieme “arte” e “mestiere”), per esempio, ma viva ancora oggi negli usatissimi tecnica, politecnico, architetto e in numerose altre parole italiane. L’etimologia appena spiegata illumina la scelta di Knuth: TEX sarebbe stato il nome perfetto per un programma che compone documenti “allo stato dell’arte”.

Knuth dice che «se TEX è ben pronunciato, lo schermo del calcolatore si appanna leggermente». La lettera X, infatti, corrisponde a una forte aspirazione non esistente in italiano, ma presente in molte lingue attualmente parlate sul pianeta: oltre che nel greco, si trova nel tede-

Horoxo Horoxo Prova Prova

1.1 storia

sco Bach, nello scozzese Loch, nello spagnolo Juan e Mexico, nel russo H oroxo (pron. harasciò, “bene”), nel cinese (pron. n˘ı h˘ao, “ciao”), solo per fare qualche esempio.

Lo stesso Knuth, però, ammette le diverse pronunce nazionali (che convergono in un tèk universale), rassicurando gli utenti che non è certo per il fatto di sentire TEX detto come ognuno preferisce che andrà su tutte le furie. Tuttavia, indica nella Grecia il Paese in cui oggi si può ascoltare la pronuncia più corretta di questa parola.

In un ambiente ascii, il logo TEX si rende con TeX.

3

1.1.3 LATEX

LATEX (La(mport)TEX) è un programma di composizione tipografica realizzato da Leslie Lamport e liberamente disponibile, che usa TEX come motore di tipocomposizione.

LATEX non è TEX, però. Per rendere l’idea della differenza tra i due programmi, potremmo paragonare TEX a un corpo, e LATEX al più popolare degli “abiti” (fatto, però, di istruzioni in linguaggio TEX) che nel corso degli anni gli sono stati confezionati addosso per avvicinarlo al pubblico con sembianze “amichevoli”.

LATEX è stato progettato per automatizzare in una volta sola tutte le più comuni operazioni necessarie a realizzare un documento e, tramite impostazioni professionali predefinite, permette agli autori di impaginare e stampare il proprio lavoro Figura 3: Leslie Lamport (l’immagine ai più elevati livelli di qualità tipografica. è tratta da + lamport).

Lamport, che collaborava con Knuth allo sviluppo di TEX, cominciò a scrivere LATEX alla fine degli anni Settanta del secolo scorso, quando TEX non era ancora stato pubblicato. La prima versione pubblica di LATEX risale al 1985, e da allora il programma è stato continuamente aggiornato e migliorato. Per molti anni il suo numero è rimasto fissato a 2.09 e le successive revisioni sono state identificate con le loro date.

Nel 1994, finalmente, un gruppo di programmatori guidato da Frank Mittelbach lo ha aggiornato in modo sostanziale, includendovi tutte le versioni successive alla 2.09 e numerosi altri miglioramenti. Per distinguerla da quella precedente, la nuova edizione è stata battezzata LATEX 2ε , e costituisce l’oggetto di questa guida.

Il futuro LATEX3 si profila come un progetto a lungo termine: i costanti aggiornamenti di LATEX, la cui ultima versione pubblica è del 2009, ne costituiscono le tappe di avvicinamento.

LATEX non è TEX!

Breve storia di LATEX

4

storia e filosofia

Tabella 1: Cronologia di TEX e LATEX.

1977 1978 1982 1984 1985 1994 2008 2009

Knuth comincia a scrivere TEX Lamport comincia a scrivere il primo nucleo di LATEX Prima versione pubblica di TEX Knuth pubblica la prima edizione di The TEXbook Lamport pubblica LATEX 2.09 e la prima edizione di LATEX. A Document Preparation System LATEX 2ε Ultima revisione di TEX Ultima revisione di LATEX

In un ambiente ascii, i loghi LATEX e LATEX 2ε si rendono rispettivamente con LaTeX e LaTeX2e.

1.2

filosofia

1.2.1 Composizione sincrona e asincrona

Composizione “sincrona”

Composizione “asincrona”

Qual è migliore?

La caratteristica che più differenzia LATEX dagli altri elaboratori di testo è il fatto che l’introduzione del testo e la sua composizione avvengono in tempi diversi [Beccari, 2010].

Per modificare un documento scritto con un comune elaboratore di testo (come Microsoft Word), l’autore agisce direttamente sul testo già composto così come gli appare sul monitor, e ogni sua azione si traduce in una variazione immediata di quel testo. Perciò questo tipo di composizione è detto “composizione sincrona”. Per essere davvero sincrono e operare con un ritardo trascurabile tra intervento e visualizzazione, però, il programma deve puntare tutto sulla rapidità della presentazione. Questo rende di fatto impossibile ottenere una composizione perfetta, poiché essa richiede un’elaborazione del testo di partenza molto più accurata. È anche vero, però, che oggi i programmi di videoscrittura sono estremamente rapidi e che la qualità della loro composizione migliora sensibilmente a ogni nuova edizione. Il compromesso fra velocità e qualità, tuttavia, esiste sempre.

La “composizione asincrona”, invece, consiste nell’introdurre in un editor il testo da comporre senza curarsi dell’aspetto grafico, ma concentrandosi unicamente sulla struttura logica, e nel darlo “in pasto” a un compilatore che lo impagina (LATEX, nel nostro caso) solo successivamente. L’autore, naturalmente, può modificare in ogni modo il proprio lavoro anche dopo la compilazione. Tuttavia, LATEX non si limita ad aggiustare il testo nel punto in cui è stato modificato, ma riorganizza sempre la composizione dell’intero capoverso nel migliore dei modi.

Va da sé che questo secondo tipo di composizione è qualitativamente migliore del primo, dato che la velocità di visualizzazione passa in secondo piano a tutto vantaggio della qualità: LATEX elabora il testo sempre nel suo complesso, e per questo può fare le scelte d’impaginazione migliori.

1.2.2 Le istruzioni di marcatura

1.2 filosofia

L’idea forte di Lamport, come si è visto, era quella di creare un linguaggio che permettesse ai suoi utenti di concentrarsi sulla struttura logica del documento e non sul suo aspetto. E LATEX centra in pieno l’obiettivo: l’autore può (quasi deve, diremmo) astrarsi dai dettagli estetici che con un altro elaboratore di testo sarebbe costretto a introdurre a mano, per indirizzare le proprie energie sul contenuto del proprio lavoro e sulla scansione delle sue parti. LATEX pretende dall’utente considerazioni sul “cosa”: «il mio documento sarà composto da un certo numero di capitoli, ciascuno diviso in paragrafi numerati, avrà un indice generale e uno analitico, delle figure e qualche tabella». E questo è tutto. Al “come” pensa LATEX, e lo fa molto bene. Uno stesso testo sorgente, per esempio, può dar vita, in linea teorica, a prodotti finiti radicalmente differenti, soltanto cambiando la classe con cui sono stati scritti, oppure caricando un pacchetto che agisce in modo globale sul testo. (Si è detto in linea teorica perché, nella pratica, qualche aggiustamento manuale si rende di fatto sempre necessario.)

Un testo da compilare con LATEX è scritto in una “lingua” particolare costituita da marcatori (o etichette logiche, mark-up in inglese), ovvero le istruzioni che il programma deve eseguire per trattare la porzione di testo a cui si riferiscono. Le etichette logiche sono, in una parola, i comandi (chiamati anche, nel gergo di LATEX, macro, abbreviazione di macroistruzioni) e gli ambienti. Antesignani e modelli di LATEX in questo senso sono stati alcuni linguaggi di descrizione per testi strutturati nati dalla fine degli anni Sessanta del secolo scorso come soprattutto il gml (1969), del quale LATEX ha adottato alcune idee. Dal gml discendono direttamente l’sgml (1978), l’html (1989) e l’xml (1998).

Nonostante faccia delle etichette logiche uno dei propri punti di forza (per cui molte delle tradizionali operazioni manuali sul testo vengono automatizzate), LATEX offre all’utente anche gli strumenti per regolare finemente (e a mano, questa volta) il risultato durante la revisione finale del documento, passaggio ancora insostituibile. In tipografia, infatti, le variabili sono troppe e troppo variegate per poter essere gestite in una volta sola da un unico programma, e l’autore deve accettarlo, se pretende un prodotto di alta qualità.

Ecco che il file prodotto dall’editor è a tutti gli effetti un codice scritto in un linguaggio di programmazione, dato che contiene sia il testo vero e proprio del documento, sia le istruzioni di marcatura (i comandi) che dicono a LATEX di comporre quello che gli si dà in pasto secondo lo stile particolare del documento che si è scelto di scrivere.

Non si spaventi chi non conosce bene l’inglese: i comandi di LATEX (che specificano l’inizio di un capitolo o una particolare modalità di stampare una formula matematica, per esempio), sono in un inglese molto semplice, e anche là dove ci sono abbreviazioni risultano di solito comprensibilissimi e facilmente memorizzabili.

Un esempio

Per dare l’idea di come appare un documento da compilare con LATEX, di seguito si riportano alcune righe di codice sorgente, cioè l’insieme di testo, numeri e simboli da scrivere nell’editor.

5 Quanto conta la struttura logica del documento

Il concetto di etichetta logica (mark-up)

Ancora qualche regolazione manuale. . .

Il file prodotto dall’editor contiene testo e istruzioni di marcatura.

Il codice sorgente

6

storia e filosofia Due matrici $n\times n$ complesse $A$ e $B$ si dicono \emph{simili} se esiste una matrice $n\times n$ invertibile $T$ tale che \begin{equation} B=T^{-1}AT. \end{equation}

Con LATEX non si può modificare direttamente il documento composto: si corregge il testo sorgente e si ricompila.

Il codice sorgente viene compilato da LATEX che, attraverso TEX, produce il documento tipocomposto (typeset). Se il risultato non è soddisfacente, non si può modificare direttamente il documento a video, ma bisogna correggere il testo sorgente e poi ricompilarlo.

L’esempio che segue riporta a sinistra lo stesso codice sorgente dell’esempio precedente e a destra il risultato della compilazione.

Due matrici $n\times n$ complesse $A$ e $B$ si dicono \emph{simili} se esiste una matrice $n\times n$ invertibile $T$ tale che \begin{equation} B=T^{-1}AT. \end{equation}

Due matrici n × n complesse A e B si dicono simili se esiste una matrice n × n invertibile T tale che B = T −1 AT .

(1.1)

Nei capitoli successivi verranno spiegate tutte le istruzioni usate nell’esempio. Tuttavia, anche il lettore con pochi rudimenti di inglese capisce facilmente quello che il linguaggio di marcatura ha specificato.

Vantaggi di LATEX

1.2.3

LATEX: pro e contro

I vantaggi di LATEX rispetto agli altri elaboratori di testo sono innumerevoli. Di seguito se ne elencano alcuni.

• LATEX compone documenti al massimo grado di professionalità, e presenta caratteristiche di qualità e stabilità sconosciute agli altri elaboratori di testo.

• L’autore pensa a struttura e contenuto del testo, LATEX si occupa della sua impaginazione.

• Strutture complesse come riferimenti incrociati, indici e bibliografie vengono generate con grande efficienza e flessibilità.

• La composizione tipografica di formule matematiche è gestita in maniera impeccabile.

• LATEX è gratuito, multilingue e multipiattaforma (un file sorgente di LATEX è scritto in ascii puro: ciò ne garantisce la più completa compatibilità quando si opera con documenti scambiati tra più autori e provenienti da sistemi operativi differenti; si veda, però, il paragrafo 4.1.2 a pagina 45).

• LATEX ha una struttura modulare che permette di estenderne le capacità per eseguire compiti tipografici non direttamente gestiti dal programma. Per esempio, esistono estensioni per comporre bibliografie conformi a precisi standard.

1.2 filosofia

• Si possono inserire con facilità macchie di caffè nei propri documenti elettronici.

Innegabilmente, LATEX presenta anche alcuni svantaggi:

7

Svantaggi di LATEX

• Con LATEX ci vuole attitudine all’astrazione.

• La gratificazione non è istantanea, ma ritardata.

• LATEX «non lavora bene per chi ha venduto la propria anima» [Oetiker et al., 2010].

• Solo gli esperti possono permettersi di uscire dagli stili predefiniti.

• Il fatto che LATEX raggiunga un’elevatissima qualità soltanto grazie alla composizione asincrona può talvolta rivelarsi un difetto anziché un pregio (almeno se non si considerano i motivi di questo comportamento e se non si adatta di conseguenza il proprio metodo di lavoro). LATEX, infatti, gestisce il capoverso in modo del tutto particolare: rimuoverne anche una sola parola ne determina sempre il riallestimento completo. Con risultati a volte indesiderati: il capoverso potrebbe risultare addirittura di una riga più lungo, se LATEX decidesse che quella è la soluzione migliore, con le ovvie conseguenze se ciò dovesse accadere durante l’ultimissima revisione del documento.

• LATEX non gestisce pagine più grandi di 33 metri quadrati e non dà denaro alle case di software.

In breve, è opportuno usare LATEX quando uno o più fattori tra i seguenti giochi un ruolo importante nel lavoro che si sta scrivendo [Mittelbach, Pignalberi e Walden, 2007]:

Quando è opportuno usare LATEX

• preferenza dell’utente a pensare per strutture logiche; • documenti che richiedono consistenza; • documenti che non hanno un formato interamente definito o che saranno presentati parallelamente in diverse vesti; • documenti che contengono molta matematica; • materiale corposo.

Viceversa, i seguenti fattori fanno pendere l’ago della bilancia verso l’uso di un sistema tradizionale: • preferenza dell’utente a pensare per strutture visive; • utente non del tutto a proprio agio a lavorare con un linguaggio di programmazione (un editor per LATEX aiuta, ma. . . ); • documenti che richiedono più flessibilità visuale che consistenza (volantini, biglietti d’invito, dépliant, brochure, eccetera); • materiale non corposo.

In ultima battuta: prima di affidarsi a LATEX, si consiglia caldamente di vagliare a monte e con la massima attenzione il tipo di prodotto che si intende realizzare.

Quando è opportuno non usare LATEX

8

storia e filosofia

1.2.4 Luoghi comuni

Molte delle persone che si avvicinano a LATEX dopo anni di tormenti alle prese con altri elaboratori di testo si stupiscono quando scoprono che era disponibile da oltre due decenni, pur non avendone mai sentito parlare. Non si tratta certo di una cospirazione ai loro danni, ma solo di «un segreto ben conservato e noto solo a pochi milioni di persone» [Flynn, 2005].

Knuth e Lamport hanno generosamente reso i loro programmi di pubblico dominio fin da subito, e perciò per molto tempo LATEX è vissuto indisturbato tra le mura delle università senza che nessuno sentisse il bisogno di pubblicizzarlo al di fuori. Oggi, tuttavia, LATEX è diventato popolarissimo: innumerevoli editori pubblicano documenti nel suo formato, e centinaia di migliaia di utenti scrivono con esso milioni di documenti.

In questi anni, su LATEX sono fioriti molti luoghi comuni: per evitare possibili incomprensioni, conviene in questa sede esaminarne i più diffusi.

Leggenda: LATEX ha solo un font LATEX può usare, tra gli altri, ogni font di tipo TrueType, OpenType, PostScript e METAFONT. Ciò è più di quanto viene offerto dalla maggior parte degli altri sistemi di composizione tipografica. Il font standard di LATEX è il Computer Modern, e non il Times New Roman, quindi alcuni restano turbati da un documento diverso dal solito.

Leggenda: LATEX è un software solo per Unix Si sente anche dire che LATEX è un software solo per Unix, o solo per Mac, eccetera. È tutto il contrario: LATEX funziona sulla maggior parte dei calcolatori oggi sul mercato (supercomputer e palmari compresi): dai PC con Windows ai Mac ai sistemi Unix/Linux. Se LATEX non gira sul proprio computer, delle due l’una: o la macchina è troppo vecchia, oppure è talmente nuova che non è ancora stata messa a punto una distribuzione che possa esservi installata.

Leggenda: LATEX è obsoleto Proprio il contrario. L’incessante lavoro di migliaia di appassionati in tutto il mondo lo tiene costantemente aggiornato, e quasi ogni giorno si aggiungono agli archivi ufficiali nuove caratteristiche. È dunque indiscutibilmente più aggiornato della maggior parte degli altri sistemi di videoscrittura, e la sua capacità di composizione di capoversi e formule matematiche è tuttora ineguagliata.

Leggenda: LATEX non è wysiwyg

Dipende. Se per wysiwyg (What You See Is What You Get, “ciò che vedi è ciò che ottieni”) si intende un software in grado di ottenere in stampa testo e immagini disposti esattamente come si vede sullo schermo del calcolatore, LATEX è un programma wysiwyg della migliore qualità.

1.2 filosofia

Se invece per wysiwyg si intende un programma di videoscrittura in cui l’autore agisce direttamente sul testo già composto, così come appare a video, e ogni sua azione si traduce in un’immediata variazione del testo composto, LATEX non è wysiwyg, ma wysiwym (What You See Is What You Mean, “ciò che vedi è ciò che intendi”), perché compone il documento in modo asincrono.

Leggenda: LATEX è troppo difficile Questa frase si è sentita dire da fisici in grado di dividere gli atomi, da matematici che sanno dimostrare la trascendenza di π, da uomini d’affari che sanno leggere un foglio di bilancio, da storici che hanno compreso la politica bizantina e da linguisti che sanno decifrare la scrittura lineare B. LATEX non è immediato come i normali elaboratori di testo e richiede un po’ di studio e una certa pratica iniziali (possibilmente su documenti elementari): il suo uso, però, si rivelerà presto molto semplice.

Leggenda: LATEX è solo per matematici e scienziati Niente affatto. Sebbene sia cresciuto nei campi della matematica e dell’informatica, due delle sue maggiori aree di espansione sono quelle umanistica ed economica, specie da quando ha preso piede l’xml, che ha sollevato nuove esigenze nell’ambito della tipocomposizione automatica.

9

2 indice 2.1 2.2

2.3

2.4 2.5 2.6

I N S T A L L A R E LATEX Introduzione 11 LATEX e pdfLATEX 12 2.2.1 La ricerca diretta e inversa 12 2.2.2 dvi: pro e contro 13 2.2.3 pdf: pro e contro 13 2.2.4 Conclusioni 13 Installare LATEX su Windows 14 2.3.1 MiKTEX 14 2.3.2 TEX Live per Windows 14 2.3.3 Editor per Windows 15 Installare LATEX su Mac 17 2.4.1 TEX Live per Mac: MacTEX 17 2.4.2 Editor per Mac 17 Installare LATEX su Linux 17 2.5.1 TEX Live per Linux 17 2.5.2 Editor per Linux 18 Editor multipiattaforma 18

Questo capitolo spiega come installare un sistema LATEX completo sul proprio calcolatore. Verranno prese in considerazione le due distribuzioni più diffuse: MiKTEX (per Windows) e TEX Live (multipiattaforma). Distingueremo tre casi, a seconda che si lavori con: • Windows (dalla versione 2000 in poi); • Mac OS X (dalla versione 10.3 in poi); • Linux.

2.1

introduzione

Gli elementi indispensabili per scrivere un documento con LATEX sono:

I ferri del mestiere

• un editor di testo con cui scrivere il file sorgente .tex; • LATEX, che elabora il file .tex e produce il documento tipocomposto; • un programma per visualizzare il documento finito.

LATEX, che è un semplice “motore”, è del tutto indipendente dall’editor di testo che si usa per scrivere il file sorgente, tanto che per farlo, in teoria, se ne può usare uno qualsiasi. Gli editor dedicati, tuttavia (ne esistono numerosi e adatti a tutte le esigenze), offrono vantaggi

Si raccomanda di usare un editor dedicato.

11

12

Che cos’è una distribuzione?

La “rete di archivi completi per TEX”

Il formato di output

Trovare facilmente un punto del documento

installare latex

sostanziali: basta un clic per compilare il file sorgente, e con alcuni di essi il documento visualizzato si aggiorna praticamente in tempo reale, avvicinandosi molto alla compilazione sincrona.

Una distribuzione di LATEX è una raccolta di file e altro software, autosufficiente per produrre un documento finito: comprende il sistema LATEX vero e proprio, i programmi di visualizzazione e uno o più editor dedicati. Si installa direttamente da Internet oppure da dvd. Si fa presente che il guIt (+ guit) invia a tutti i soci il dvd TEX Collection, che comprende le distribuzioni per i principali sistemi operativi, utilissimo per installarle se non si ha una connessione veloce.

Il luogo di riferimento nel Web per scaricare tantissimo materiale su LATEX (distribuzioni, pacchetti, stili, classi, font, manuali, e naturalmente tutto ciò che viene nominato in questa guida) è ctan (Comprehensive TEX Archive Network, “rete di archivi completi per TEX”, + ctan). La rete ctan è un insieme di server dislocati in tutto il mondo, tutti uguali tra di loro e ciascuno contenente una copia integrale (mirror, “specchio”) del sito ctan originale (il loro elenco si trova su + mirrors). Si può sempre scaricare ciò di cui si ha bisogno, dunque, dal mirror più vicino a casa, per evitare il sovraffollamento della linea e abbreviare i tempi dell’operazione.1

2.2

latex e pdflatex

2.2.1

La ricerca diretta e inversa

Questo paragrafo affronta una questione di primaria importanza: il formato in cui compilare il testo sorgente. Il codice LATEX, infatti, può essere compilato per ottenere in output file .dvi oppure file .pdf. E quando si dice LATEX, s’intende sia il programma LATEX vero e proprio sia il programma pdfLATEX. I file sorgente elaborabili con i due programmi sono generalmente identici, o possono essere resi tali. Le incompatibilità in questo senso hanno generalmente due cause: o uno dei pacchetti caricati è incompatibile con pdfLATEX, nel qual caso si consiglia di evitarlo, ricorrendo a un pacchetto alternativo; oppure il file esterno da includere nel documento ha un’estensione che pdfLATEX non accetta, per cui diventano utilissimi i programmi accessori di cui parleremo nel paragrafo 6.4.1 a pagina 139. I pro e i contro che entrambi i formati presentano dovrebbero guidare l’utente nella scelta dell’uno o dell’altro a seconda dello scopo che si è dato.2

La ricerca diretta e inversa è un tipo di ricerca molto utile durante la revisione, specie nel caso in cui il documento sia particolarmente lungo. Essa permette (con modalità proprie di ogni sistema operativo) 1 Non sempre, però, il server più vicino è anche il più veloce. Il mirror italiano ufficiale dell’Università Tor Vergata di Roma (+ uniroma2) a volte ha tempi di scaricamento proibitivi: impostando come predefinito quello svizzero (+ switch), per esempio, si risolve il problema.

2 Il codice PostScript prodotto dal pacchetto PSTricks, per esempio, fino a qualche tempo fa non si poteva compilare direttamente con pdfLATEX, rendendo obbligatorie la conversione da dvi o l’inclusione di immagini dall’esterno. Oggi alcuni pacchetti (come pst-pdf) hanno risolto il problema.

2.2 latex e pdflatex

di individuare immediatamente sul documento composto il corrispondente punto del codice sorgente e viceversa. Questa modalità è sempre possibile su e da dvi (DeVice Independent), mentre su e da pdf (Portable Document Format) dipende dal rapporto che c’è tra l’editor e il visualizzatore installati sul proprio calcolatore.

Ciascuno dei sistemi operativi considerati in questa guida permette questa ricerca, a patto, però, di installarci una coppia “vincente” di programmi, come:

13

Coppie “vincenti”

• su Windows, l’editor WinEdt (o TEXnicCenter o Emacs + emacs o TexMakerX + texmakerx) abbinato al visualizzatore Sumatra PDF (+ sumatra);

• su Mac, l’editor TEXShop con il proprio visualizzatore integrato, oppure l’editor Aquamacs con il visualizzatore Skim (+ skim);

• su tutte le piattaforme, l’editor TEXworks (integrato nelle due maggiori distribuzioni di LATEX) con il proprio visualizzatore integrato.

2.2.2

dvi: pro e contro

2.2.3

pdf: pro e contro

Se un file dvi presenta il vantaggio della ricerca diretta/inversa, la maggior parte dei visualizzatori di dvi, però, non riproduce correttamente gli effetti di alcuni comandi (specialmente quelli che modificano le figure o che producono simboli) e non sfrutta il pacchetto microtype né i collegamenti ipertestuali di hyperref.

DVI. . .

Un file in formato pdf visualizza correttamente gli effetti di quasi tutti i pacchetti e i comandi di LATEX, sfrutta microtype e hyperref, può essere tranquillamente visualizzato e stampato anche da utenti che non usano LATEX e accetta la protezione con password.

Per creare un pdf, si percorrono essenzialmente due strade, che differiscono per il formato delle immagini richiesto:

. . . o PDF?

• si converte il dvi con dvips e lo si legge o stampa con Ghostscript; • si compila direttamente il file sorgente .tex con pdfLATEX. La migliore delle due è senz’altro la seconda: permette i riferimenti ipertestuali, i segnalibri e le immagini in miniatura, che nella conversione da dvi andrebbero persi. I vantaggi non terminano qui: pdfLATEX è un programma incluso in tutte le più recenti distribuzioni, e la sua esecuzione è pienamente integrata con i moderni editor dedicati.

2.2.4 Conclusioni

Gli editor di ultima generazione tendono a produrre file di output direttamente in pdf, e sempre più numerosi visualizzatori sono attrezzati per la ricerca diretta e inversa su entrambi i formati. D’altro canto, molti utenti di LATEX hanno preso dimestichezza con un tandem di

14

installare latex

programmi consolidato, e alcuni pacchetti molto specialistici rendono ancora inevitabile passare per il dvi.

Perciò si consiglia il lettore come segue: si cerchi, per quanto possibile, di installare un sistema editor/visualizzatore compatibile anche con la ricerca diretta e inversa su e da pdf, e si compili con pdfLATEX. Un file pdf, infatti, pone l’utente al riparo da qualunque problema di incompatibilità: è universalmente accettato per la stampa, la distribuzione elettronica e in numerose altre circostanze.

Agli utenti che non vogliono abbandonare gli strumenti con cui si sentono sicuri, si consiglia ugualmente di compilare con pdfLATEX, e di riservare l’uso del dvi ai momenti in cui è necessaria la ricerca diretta e inversa sul documento composto.

Chi abitualmente usa pacchetti molto particolari (per la grafica, per esempio) non ha scelta e deve ricorrere al dvi.

2.3

installare latex su windows

Le distribuzioni di LATEX per Windows sono due: MiKTEX e TEX Live.

Si consiglia l’installazione completa di MiKTEX.

2.3.1

MiKTEX

2.3.2

TEX Live per Windows

La distribuzione MiKTEX (+ miktex) nasce per Windows ed è disponibile in due versioni: Basic, con una dotazione di pacchetti minima (ma integrabile all’occorrenza) e Complete, che è quella che si consiglia di installare. Si noti che di qui in avanti verrà considerata solo quest’ultima. È sufficiente eseguire il programma Net Installer presente sulla pagina dei download e seguirne le istruzioni fino a scegliere se installare MiKTEX direttamente dalla Rete oppure se prima scaricarla (quasi un gigabyte). In entrambi i casi la distribuzione si installa facilmente come ogni altra applicazione per Windows.

MiKTEX integra TEXworks, un semplice editor dedicato e gestisce i pacchetti in modo molto intuitivo (si veda il paragrafo 3.4.1 a pagina 32), ma non è già predisposta per lavorare con tutte le lingue gestite da LATEX (italiano compreso): per farlo, basta seguire le istruzioni descritte nel paragrafo 4.1.3 a pagina 46.3

Per installare TEX Live su Windows dalla Rete basta, nell’ordine: 1. scaricare la cartella compressa install-tl.zip da + texlive;

2. decomprimerla, aprirla ed eseguire il file install-tl.bat presente al suo interno;

3 Per Windows c’è anche la distribuzione proTEXt (+ protext) basata su MiKTEX, compresa anche nel dvd del guIt e corredata della documentazione per l’installazione e di tutti gli altri programmi necessari.

2.3 installare latex su windows

3. seguire le semplici istruzioni che compariranno e attendere che l’installazione (oltre 2 gigabyte) si concluda.4

15

Si consiglia, ad ogni modo, di leggerne prima e in ogni caso la documentazione, dal 2009 anche in italiano.

TEX Live gestisce i pacchetti mediante il programma TEX Live Manager, integra TEXworks, un semplice editor dedicato ed è già configurata per lavorare con tutte le lingue gestite da LATEX. 2.3.3 Editor per Windows

Gli editor dedicati per Windows sono più numerosi che per gli altri sistemi operativi, e comprendono programmi gratuiti e a pagamento (se ne può trovare una parziale rassegna, in inglese, su + editors).

Non essendo questa la sede per una loro descrizione sistematica, sappia il lettore che tutti, inevitabilmente, hanno pro e contro, ma per un uso di base (com’è quello che s’intende proporre in questa guida) si equivalgono, e la scelta dell’uno o dell’altro è in definitiva una questione di gusto. Per via della loro grande diffusione, ne considereremo qui due: il primo è gratuito ed è indicato per chi è alle prime armi; il secondo, ricco di funzioni avanzate, si consiglia a chi è più esperto.

TEXnicCenter TEXnicCenter (+ texniccenter) è un editor gratuito distribuito con licenza gnu e nato come naturale complemento di MiKTEX. Abbastanza simile a WinEdt, ma complessivamente più semplice da usare, si configura automaticamente per lavorare con la distribuzione di LATEX che trova nel calcolatore. Si consiglia, perciò, di installare prima la distribuzione e poi TEXnicCenter. controllo dell’ortografia italiana TEXnicCenter usa lo stesso dizionario italiano di OpenOffice (+ openoffice). Dopo aver decompresso l’archivio si copiano i due file it_IT.aff e it_IT.dic nella cartella ...\TeXnicCenter\Language\ (la cui posizione esatta dipende dalla scelta operata durante l’installazione). A questo punto si avvia TEXnicCenter e, tramite il menu Tools → Options → Spelling, si abilitano le funzioni language:it, dialect:IT, e come ultima operazione si inserisce in personal dictionary la voce ...\TeXnicCenter\ Language\it_IT.dic.

WinEdt WinEdt (+ winedt) è un editor shareware particolarmente ricco di funzioni per lavorare con LATEX e in grado di gestire numerosi altri linguaggi. L’installazione non presenta alcuna difficoltà, ma forse l’interfaccia grafica sconta la ricchezza di pulsanti con una minore intuitività rispetto ad altri editor.

4 Si noti che il file install-tl.bat imposta automaticamente il download di TEX Live dal server ufficiale italiano, noto per la sua lentezza. Tuttavia, ci si può sempre servire di un altro mirror impostando il download dalla riga di comando.

Configurare TEXnicCenter per l’italiano

16

installare latex

(a) WinEdt (per Windows).

(b) TEXShop (per Mac).

(c) Kile (per Linux).

(d) TEXworks (multipiattaforma).

Figura 4: Alcuni editor per LATEX. Configurare WinEdt per l’italiano

controllo dell’ortografia italiana ne, si seguano le istruzioni seguenti:

Per abilitare questa funzio-

• si crea la cartella it\ in C:\Programmi\WinEdt Team\WInEdt 6\ Dict\ e ci si scarica il dizionario italiano da + winedt;

• si clicca sul menu Options, poi sulla voce Options... e infine sulla voce Dictionary Manager: Word Lists, Spelling... (senza espanderne il menu interno) nella finestra comparsa nel frattempo nella parte sinistra dello schermo; • si clicca sul pulsante Dictionary Manager Dialog sulla barra superiore della finestra per aprire la finestra di dialogo Dictionary Manager; • si sostituiscono la stringa nel box Definition con %B\Dict\it\It .dic e la stringa nel box Dictionaries con it; • si spuntano la voce Enabled e le voci Load on Start, Save on Exit, Add New Words, Use for Completion nel campo Options; • si dà OK.

Si noti che siccome il dizionario italiano distribuito dal sito di WinEdt non contiene lettere accentate, inizialmente le parole che le contengono verranno segnalate come scorrette, ma aggiungendole al dizionario via via che si presentano, questo genere di falsi errori sparisce in breve tempo.

2.4

2.4 installare latex su mac

installare latex su mac

17

La distribuzione di LATEX per Mac OS X è TEX Live, meglio conosciuta su questa piattaforma come MacTEX. 2.4.1 TEX Live per Mac: MacTEX

MacTEX (+ mactex) comprende un sistema LATEX completo e numerosi programmi utili. Dopo averla scaricata (in un unico archivio compresso .mpkg.zip di oltre 1,6 gigabyte), si può installare come ogni altra applicazione per Mac. Non servono ulteriori programmi per visualizzare e stampare i documenti, perché già presenti nel sistema operativo.

MacTEX integra TEXworks, un semplice editor dedicato, e il più potente TEXShop, gestisce i pacchetti in modo molto semplice e intuitivo (si veda il paragrafo 3.4.1 a pagina 32) ed è già automaticamente configurata per lavorare con tutte le lingue gestite da LATEX (italiano compreso).

Installare LATEX su Mac è semplicissimo.

2.4.2 Editor per Mac

Ci sono molti editor dedicati per Mac: da Aquamacs (+ aquamacs), che è la versione di Emacs per Mac, consigliato agli utenti esperti, a TEXShop, senza dubbio l’editor più popolare per completezza e semplicità d’uso.

TEXShop TEXShop (+ texshop) è il più diffuso editor dedicato per Mac, gratuito e distribuito con licenza gnu. Compila con pdfLATEX e visualizza e stampa i pdf di output con un programma interno. È integrato in MacTEX ed è già configurato per lavorare con tutte le lingue gestite da LATEX.

2.5

installare latex su linux

La distribuzione di LATEX disponibile per Linux è TEX Live.

2.5.1 TEX Live per Linux

La distribuzione TEX Live (+ texlive), nativa di Unix/Linux, può essere installata dalla riga di comando (come si fa comunemente su questo sistema operativo) o attraverso interfacce grafiche (gnome e kde). Si installa come qualunque altra applicazione per Linux, senza particolari difficoltà.

TEX Live integra TEXworks, un semplice editor dedicato e gestisce i pacchetti in modo semplice (si veda il paragrafo 3.4.1 a pagina 32).

A differenza di quanto accade sugli altri sistemi operativi, si noti che su Linux TEX Live non comprende i pacchetti delle varie lingue, che vanno installati separatamente tramite il package manager opportuno.

TEX Live si installa su Linux senza particolari difficoltà.

18

installare latex

2.5.2 Editor per Linux

Esistono diversi editor dedicati per Linux. Se Emacs (che gestisce il linguaggio LATEX con l’estensione AUCTeX) è troppo difficile da usare, un’alternativa può essere Kile, semplice nell’installazione e nell’utilizzo.

Kile Kile (+ kile) è il più diffuso editor dedicato per kde, gratuito e distribuito con licenza gnu. L’interfaccia grafica è ricca di pulsanti per gestire un sorgente di LATEX, e interagisce correttamente con altri programmi (come Xfig e Gnuplot). Il dizionario italiano è già integrato nel programma.

2.6

editor multipiattaforma

L’editor che si descrive di seguito è gratuito, multipiattaforma (disponibile, cioè, per tutti e tre i sistemi operativi considerati in questo capitolo) e presenta il non trascurabile vantaggio di poter trattare documenti provenienti da differenti piattaforme.

TEXworks

TEXworks (+ texworks) è un progetto in via di sviluppo che mira a realizzare un semplice ambiente di lavoro per LATEX disponibile per tutti i principali sistemi operativi. Compila con pdfLATEX, e dopo ogni compilazione visualizza automaticamente i pdf di output con un programma interno, che permette a sua volta la compilazione e la ricerca diretta e inversa. L’interfaccia grafica è semplicissima e le funzioni si limitano all’essenziale, ma presto ne verranno introdotte di nuove, tra cui la possibilità di stampare il pdf e visualizzare la struttura di lavori costituiti da più file (per ora, questi sono i limiti più evidenti del programma). TEXworks è integrato in MiKTEX 2.9 e in TEX Live 2010 (anche se su Linux, attualmente, per il solo Ubuntu).

Configurare TEXworks per l’italiano

controllo dell’ortografia italiana TEXworks usa lo stesso dizionario italiano di OpenOffice (+ openoffice). Dopo aver decompresso l’archivio, basta copiare i file ottenuti nella cartella ...\TeXworks\ dictionaries (la cartella TeXworks viene creata automaticamente al primo avvio del programma). Dopo di che, si avvia il programma, si seleziona il pannello Editor del menu Modifica → Preferenze..., e dal menu a discesa di Lingua verifica ortografia si seleziona it_IT, si dà OK e si riavvia TEXworks per rendere operative le modifiche.

3 indice 3.1

3.2

3.3 3.4

3.5 3.6

3.7

LE BASI Il nostro primo documento con LATEX 19 3.1.1 Scrivere il codice 20 3.1.2 Compilare 20 3.1.3 Correggere gli errori 21 3.1.4 Visualizzare 21 3.1.5 Stampare 21 I file sorgente di LATEX 21 3.2.1 La struttura del file sorgente 22 3.2.2 Spazi e righe vuote 23 3.2.3 Caratteri speciali 24 3.2.4 Comandi, dichiarazioni e ambienti 25 3.2.5 Commenti 27 3.2.6 Codici sorgente ordinati 27 Le classi di documento 29 I pacchetti 31 3.4.1 MiKTEX Package Manager 32 3.4.2 TEX Live Manager 32 3.4.3 Installare un pacchetto a mano 34 3.4.4 Come caricarli?

34 3.4.5 Imparare a usarli: la documentazione 35 3.4.6 E i file .ins e .dtx?

35 3.4.7 I pacchetti di uso più comune 36 Stili di pagina 37 File con cui si ha a che fare 38 3.6.1 File dell’utente 38 3.6.2 File di classi, pacchetti e stili 38 3.6.3 File ausiliari 39 3.6.4 File di output 39 Documenti di grandi dimensioni 40

Questo capitolo presenta alcune nozioni fondamentali indispensabili per comprendere il funzionamento di LATEX. La sua lettura, perciò, è propedeutica al resto della guida.

3.1

il nostro primo documento con latex

In questo paragrafo realizzeremo un semplice documento con LATEX, imparando come:

L’ABC di LATEX

• scrivere il codice sorgente; • compilarlo; • interpretare e correggere gli errori che può contenere;

19

20

le basi

• visualizzare il documento; • stamparlo.

«Ciao, mondo!»

3.1.1 Scrivere il codice

Innanzitutto si crea una cartella prova nella quale mettere tutti i file del documento. Dopo di che, con l’editor scelto si scrive il seguente testo (le istruzioni che contiene verranno spiegate nel corso di questo capitolo e in quello successivo):

\documentclass[a4paper]{article} \usepackage[T1]{fontenc} \usepackage[utf8]{inputenc} \usepackage[italian]{babel} \begin{document} Ecco il mio primo documento con \LaTeX. \end{document}

Si registra infine il file con il nome primo.tex (per convenzione, i file sorgente di LATEX hanno l’estensione .tex).

Per compilare, basta un clic.

3.1.2 Compilare

Se si usa un editor dedicato, per compilare il codice basta cliccare l’apposito pulsante. LATEX mostra via via quello che sta facendo, emettendo contemporaneamente un messaggio di questo tipo (è il cosiddetto log, nel gergo di LATEX, che in genere appare nella parte bassa dell’editor): This is pdfTeX, Version 3.1415926 (TeX Live 2010) (primo.tex LaTeX2e <2009/09/24> Babel <v3.8> and hyphenation patterns for english, italian, loaded. (/usr/local/texlive/2009/texmf-dist/tex/latex/base/article.cls Document Class: article v1.4h Standard LaTeX document class (/usr/local/texlive/2010/texmf-dist/tex/latex/base/fontenc.sty (/usr/local/texlive/2010/texmf-dist/tex/latex/base/t1enc.def)) (/usr/local/texlive/2010/texmf-dist/tex/latex/base/inputenc.sty (/usr/local/texlive/2010/texmf-dist/tex/latex/base/utf8.def)) (/usr/local/texlive/2010/texmf-dist/tex/generic/babel/babel.sty (/usr/local/texlive/2010/texmf-dist/tex/generic/babel/italian.ldf (/usr/local/texlive/2010/texmf-dist/tex/generic/babel/babel.def))) [1] (primo.aux) ) Output written on primo.pdf (1 page, 15596 bytes).

Transcript written on primo.log.

LATEX lavora “dietro le quinte”.

Si noti che cliccare il pulsante di compilazione dell’editor equivale a eseguire dalla riga di comando l’istruzione latex primo.tex (se si compila con LATEX) o pdflatex primo.tex (se si compila con pdfLATEX).1 In questo modo, si è consapevoli del fatto che è LATEX/pdfLATEX (e non l’editor) il programma che elabora il codice .tex, che emette i 1 L’interfaccia a riga di comando (che su Windows si chiama Prompt dei comandi, su Mac Terminale e su Linux Terminale o Console) si avvia con modalità proprie di ogni sistema operativo.

3.2 i file sorgente di latex

messaggi e che produce il dvi o il pdf, lavorando “dietro le quinte”.

La compilazione non è dunque semplicemente “il tempo che bisogna attendere per vedere il dvi o il pdf”, ma il processo durante il quale il programma comprende le nostre intenzioni (espresse con i comandi), e le trasforma in un file (tipo)grafico.

3.1.3 Correggere gli errori

Se il codice sorgente contiene un errore (come un comando scritto scorrettamente), la compilazione si arresta e nel log compare un messaggio più o meno di questa forma: ! Undefined control sequence. l.6 Ecco il mio primo documento con \latex ?

Quando trova un errore, LATEX indica: • la natura dell’errore (in questo caso, Undefined control sequence, “sequenza di controllo non definita”, ovvero “comando sconosciuto”) ; • la riga (line) del codice in cui si trova l’errore (l.6) ; • il vero e proprio errore (il comando giusto è \LaTeX , non \latex: attenzione alle maiuscole!).

Per uscire dalla compilazione è sufficiente dare x e Invio. Dopo aver corretto il codice, si registra il file e si ricompila (oppure, con alcuni editor, si ricompila direttamente).

3.1.4 Visualizzare

Se si usa un editor dedicato e il codice sorgente non contiene errori, al termine della compilazione il visualizzatore si attiva automaticamente e mostra il documento finito.2 3.1.5 Stampare

Quest’ultimo, infine, può essere stampato con le modalità proprie del visualizzatore.

3.2

i file sorgente di latex

Un file sorgente di LATEX è un file di testo in ascii puro, che contiene sia il testo vero e proprio del documento, sia i comandi che istruiscono LATEX su come impostarne il formato.

2 Se si opera dalla riga di comando, invece, per visualizzare il documento basta porsi nella cartella di lavoro ed eseguire l’istruzione hnome del programmai primo.dvi oppure hnome del programmai primo.pdf, dove hnome del programmai è il nome del visualizzatore di dvi o di pdf usato.

21

Messaggi d’errore

22 Dichiarazione di classe

le basi

3.2.1 La struttura del file sorgente

LATEX si aspetta di trovare il file sorgente da elaborare strutturato in un certo modo. Elementi fondamentali sono almeno una dichiarazione di classe \documentclass{h. . .i}

e le dichiarazioni di inizio e fine documento: \begin{document} ... \end{document}

Preambolo

Tutte le istruzioni che precedono \begin{document} costituiscono il preambolo del documento (o semplicemente preambolo) e comprendono, oltre alla dichiarazione di classe: • il caricamento di pacchetti che estendono le capacità di LATEX (\usepackage{h. . .i}); • le definizioni di comandi e ambienti personalizzati (da impostare con i comandi \newcommand e \newenvironment, per i quali si veda il paragrafo 9.1 a pagina 181); • le opzioni generali del documento; • informazioni varie, come \title{h. . .i}, \author{h. . .i}, eccetera.

Corpo del documento

Fra \begin{document} e \end{document} si scrive il testo vero e proprio, o corpo del documento, cioè tutto ciò che verrà visualizzato nel documento finale. Si noti che per isolare anche visivamente il corpo del documento dai due comandi appena descritti si può lasciare una riga bianca nel codice sorgente, come si è fatto in tutta questa guida.

La figura 5 a fronte mostra un documento elementare composto con LATEX, ottenuto compilando (due volte) il codice seguente: \documentclass[a4paper]{article} \usepackage[T1]{fontenc} \usepackage[utf8]{inputenc} \usepackage[italian]{babel} \author{Lorenzo Pantieri} \title{Minimalismo} \begin{document} \maketitle \tableofcontents \section{Inizio} Bene, qui comincia il mio grazioso articolo. \section{Fine} \dots e qui finisce. \end{document}

3.2 i file sorgente di latex

23

Minimalismo Lorenzo Pantieri 24 giugno 2010

Indice 1 Inizio

1

2 Fine

1

1

Inizio

Bene, qui comincia il mio grazioso articolo.

2

Fine

. . . e qui finisce.

1

Figura 5: Esempio di un breve documento composto con LATEX.

Dove: • \begin{document} comincia il documento; • \maketitle ne stampa il titolo; • \tableofcontents ne stampa l’indice generale dopo due compilazioni; • \section{htitolo del paragrafoi} stampa il titolo di un paragrafo; • \dots stampa i puntini di sospensione “. . . ”; • \end{document} termina il documento.

3.2.2 Spazi e righe vuote

Il modo in cui LATEX tratta spazi, tabulazioni e righe vuote nel codice sorgente è particolarissimo, e si discosta decisamente da tutti i comuni elaboratori di testo. Infatti: • più spazi consecutivi (o più tabulazioni consecutive) sono considerati come un solo spazio; • spazi o tabulazioni all’inizio di una riga vengono ignorati; • una sola interruzione di riga è trattata come uno spazio; • una riga vuota tra due righe di testo separa due capoversi; • più righe vuote consecutive sono trattate come una sola riga vuota.

L’esempio seguente mostra il comportamento di LATEX nei casi appena descritti: a sinistra c’è il codice sorgente, a destra il risultato in stampa:

Spazi “insoliti”

24

le basi Carattere \ {} % $

Tabella 2: Caratteri speciali di LATEX.

Nome

Funzione

Barra rovescia Parentesi graffe Percento Dollaro

Comincia un comando Racchiudono un gruppo Comincia un commento Delimita una formula matematica in linea Stampa un pedice nelle formule matematiche Separa le celle di una tabella Indica l’argomento nei nuovi comandi Stampa apici ed esponenti nelle formule matematiche Produce uno spazio indivisibile

_

Trattino basso

& #

e commerciale Cancelletto

^

Accento circonflesso

~

Tilde

Non ha alcuna importanza se si mettono uno o tanti spazi dopo una parola.

E neppure se si mettono tanti spazi all’inizio di una riga o se si interrompe una riga.

Le cose cambiano se si saltano una o più righe, perché in questo modo si comincia un nuovo capoverso.

Non ha alcuna importanza se si mettono uno o tanti spazi dopo una parola. E neppure se si mettono tanti spazi all’inizio di una riga o se si interrompe una riga.

Le cose cambiano se si saltano una o più righe, perché in questo modo si comincia un nuovo capoverso.

3.2.3 Caratteri speciali

Di solito, i comuni programmi di videoscrittura a composizione sincrona ricevono dall’utente: • il testo; • i comandi per impostarne l’aspetto.

Caratteri speciali

Non tutti i caratteri sono sulla tastiera.

Questi ultimi vengono scelti da appositi menu e se ne possono vedere immediatamente gli effetti, ma non le istruzioni che permettono di ottenerli, che rimangono nascoste. LATEX, con i suoi comandi, le mantiene in superficie nei modi che spiegheremo.

Per distinguere i comandi dal testo, LATEX interpreta in modo particolare i nove caratteri elencati nella tabella 2, che si chiamano caratteri speciali.

I caratteri speciali sono molto usati nei codici sorgente di LATEX, ma possono dare qualche problema perché non hanno una posizione standard sulla tastiera oppure la loro scrittura richiede combinazioni di tasti o codici numerici particolari. Non tutti, inoltre, sono presenti su tutte le tastiere. Diventa tanto più importante, perciò, sapere come scriverli.

3.2 i file sorgente di latex

Tabella 3: Scorciatoie da tastiera (italiana) per alcuni caratteri speciali d’uso frequente.

Carattere ‘ { } ~

Windows

Mac

Linux

Alt + 96 Alt + 123 Alt Gr + Maiusc + [ Alt + 125 Alt Gr + Maiusc + ] Alt + 126

⌥9

Alt Alt Alt Alt Alt Alt

⌥⇧[ ⌥⇧] ⌥5

Gr + ’ Gr + 7 Gr + Shift + [ Gr + 8 Gr + Shift + ] Gr + ì

Quattro di essi, { ‘ ~ }, sulla tastiera italiana non ci sono proprio.

La tabella 3 indica le scorciatoie da prendere in questi casi (in Windows, il codice ascii relativo va digitato sul tastierino numerico). Si noti, inoltre, che è fondamentale distinguere con attenzione ‘ (virgoletta alta aperta e accento grave) da ’ (apostrofo, virgoletta alta chiusa e accento acuto).

Per stampare i caratteri speciali così come sono, invece, basta in genere farli precedere nel codice sorgente da una barra rovescia \: \{ \} \% \$ \_ \& \#

25

Stampare i caratteri speciali

{}%$_&#

Tre di loro, però, richiedono un codice ancora diverso: \textbackslash \^{} \~{}

\ˆ ˜

Dove: • il comando \textbackslash sostituisce la sequenza \\, prevista da LATEX, ma solo per interrompere una riga in alcuni casi; • gli altri due comandi servono per apporre il rispettivo carattere sopra una lettera, perciò richiedono un gruppo di parentesi graffe che racchiuda un argomento “vuoto” (si veda il paragrafo successivo).

3.2.4 Comandi, dichiarazioni e ambienti

I comandi di LATEX sono composti da una barra rovescia \ più altri caratteri, e in essi maiuscole e minuscole vanno usate con attenzione.

Si distinguono innanzitutto due grandi gruppi di comandi: • comandi che cominciano con una barra rovescia \ seguita da un nome costituito di soli caratteri alfabetici; il comando finisce con il primo carattere non alfabetico, di solito un segno d’interpunzione o uno spazio (per esempio: \TeX, \end{document}, \documentclass); • comandi che cominciano con una barra rovescia \ seguita da un solo carattere non alfabetico (per esempio: \{, \}, \%, \$, \_, \&, \#, \~).

Com’è fatto un comando?

26

le basi

LATEX ignora gli spazi dopo i comandi del primo tipo che “producono testo” (\LaTeX , \Ars , \dots , per esempio). Essi perciò vanno separati dal testo successivo in uno dei seguenti due modi: • scrivendo {} e uno spazio; • con un comando esplicito di spaziatura, come \ .3 \Ars{} è la rivista del Gruppo Utilizzatori Italiani di \TeX{} e \LaTeX.

Sintassi e argomenti

ArsTEXnica è la rivista del Gruppo Utilizzatori Italiani di TEX e LATEX.

Come si può notare, un segno d’interpunzione immediatamente dopo il comando elimina la necessità dello spazio esplicito.

La giustapposizione degli elementi di un comando prende il nome di sintassi del comando. Ciò che va tra parentesi graffe si chiama argomento obbligatorio, mentre ciò che va tra parentesi quadre si chiama argomento facoltativo. Se gli elementi da scrivere all’interno dello stesso gruppo di parentesi sono più d’uno, vanno separati con una virgola. A seconda della sintassi che presentano, esistono essenzialmente quattro tipi di comando: • senza argomenti (\LaTeX ); • con il solo argomento obbligatorio (\emph{htestoi}); • con il solo argomento facoltativo (\item[hnome della vocei]); • con entrambi (\documentclass[hopzionii]{hclassei}).

Alle categorie elencate qui sopra, si possono aggiungere altri due tipi di comando che spiegheremo più avanti nella guida: quelli con più di un argomento facoltativo (come \subfloat ) e quelli con più di un argomento obbligatorio (come \pdfbookmark ).

Il prossimo esempio mostra alcune tipologie di comando esaminate sin qui.

Data odierna: \today.

Sono qui in \emph{dieci} minuti.

Dichiarazioni

Data odierna: 9 aprile 2011.

Sono qui in dieci minuti.

Come si può osservare, il comando \today stampa nella lingua corrente la data del giorno in cui si compila il documento. Il comando \emph evidenzia il contenuto del suo argomento (si veda il paragrafo 4.10 a pagina 70).

Una dichiarazione è un comando che imposta uno o più aspetti generali della composizione, e il suo effetto termina quando finisce il gruppo in cui si trova. Un gruppo può essere definito, per esempio, da una coppia di parentesi graffe, da un ambiente o dalle celle di una tabella.

L’effetto di una dichiarazione posta nel preambolo, invece, si estende 3 Il pacchetto xspace permette di definire comandi di questo tipo seguiti da uno spazio, a meno che non siano seguiti da determinati segni di punteggiatura (si veda il paragrafo 9.1.2 a pagina 183).

3.2 i file sorgente di latex

sull’intero documento, e si annulla soltanto con un’altra dichiarazione. Sono esempi di dichiarazioni \small , \linespread (che richiede un argomento) e \appendix .

Un ambiente è una porzione di codice delimitata da un comando d’apertura e uno di chiusura che LATEX tratta in un certo modo. Un ambiente generico si invoca con

27

Ambienti

\begin{hambientei} ... \end{hambientei}

dove hambientei è il nome dell’ambiente. Si noti che: • in alcuni casi anche un ambiente può avere argomenti (obbligatori e facoltativi); • se ciò che va all’interno dell’ambiente appartiene al flusso del discorso, non si lasciano righe bianche tra testo e ambiente; • in caso contrario, l’ambiente va isolato dal resto del testo con una riga bianca prima e dopo.

3.2.5 Commenti

Quando LATEX, durante l’elaborazione di un file sorgente, incontra un carattere % (eccetto \%), ignora il resto della riga, l’interruzione di riga, e tutti gli spazi bianchi all’inizio della riga successiva.

Il carattere % può essere dunque impiegato per appendere un promemoria che non verrà stampato. Talvolta il simbolo di percento si usa per spezzare parole troppo lunghe, o per dividere righe in cui non sono permessi spazi bianchi o interruzioni di riga: Ecco un % semplice, % ma istruttivo esempio: Supercal% ifragilist% ichespiralidoso.

Ecco un esempio: Supercalifragilistichespiralidoso.

Per commenti più lunghi si usa l’ambiente comment definito dall’omonimo pacchetto: Ecco un altro \begin{comment} semplice, ma utile \end{comment} esempio per includere commenti nel proprio documento.

3.2.6 Codici sorgente ordinati

Promemoria

comment

Ecco un altro esempio per includere commenti nel proprio documento.

Spesso gli utenti di LATEX sottovalutano l’importanza di un codice sorgente ben strutturato (con rientri, incolonnamenti, eccetera) e commentato. Nonostante tutto questo non sia indispensabile, si consiglia

È importante scrivere codici sorgente ben strutturati e commentati.

28

le basi

di farlo ugualmente: l’ordine facilita la gestione del codice, soprattutto se a uno stesso progetto lavorano più persone, e rende più facile ricercare eventuali errori.

Durante la stesura si raccomanda di usare i commenti e suddividere con chiarezza il documento, aiutandosi eventualmente con rientri, incolonnamenti, a capo e righe vuote supplementari. Ulteriori consigli in questo senso verranno forniti nelle prossime pagine al momento opportuno.

Si esemplificano ora i consigli precedenti in un codice sorgente “ben scritto”.

Esempio di articolo composto con LATEX. % Un articolo scritto con LaTeX \documentclass[a4paper,11pt]{article} \usepackage[T1]{fontenc} % imposta la codifica dei font \usepackage[utf8]{inputenc} % lettere accentate da tastiera \usepackage[italian]{babel} % per scrivere in italiano \usepackage{layaureo} % imposta i margini di pagina \usepackage{lipsum} % genera testo fittizio \usepackage{url} % per scrivere gli indirizzi Internet \begin{document} \title{Il titolo} \author{Lorenzo Pantieri} \maketitle \begin{abstract} \lipsum[1] \end{abstract} \tableofcontents \section{Un paragrafo} \lipsum[1] \subsection{Un sottoparagrafo} \lipsum[1] \section{Un paragrafo} \label{sec:esempio} \lipsum[1] % Bibliografia \begin{thebibliography}{9} \bibitem{pantieri:arte} Pantieri, Lorenzo (2010), \emph{L’arte di scrivere con \LaTeX}, \url{http://www.lorenzopantieri.net/LaTeX_files/ArteLaTeX.pdf}. \end{thebibliography} \end{document}

3.3

3.3 le classi di documento

le classi di documento

La prima informazione che LATEX richiede quando elabora un file sorgente è il tipo di documento che si desidera realizzare; questo si specifica con il comando \documentclass :

29

Quale documento?

\documentclass[hopzionii]{hclassei}

dove: • hopzionii specifica le impostazioni generali del documento (da separare con la virgola, se più d’una); • hclassei è la classe di documento con cui si intende scrivere il proprio lavoro.

Di seguito si elencano le principali classi standard di documento: article Per scrivere articoli.

Classi standard di LATEX

report Per scrivere relazioni o tesi strutturate in diversi capitoli e dotate eventualmente di un sommario.

book Per scrivere libri.

letter Per scrivere lettere.

Esistono numerose altre classi aggiuntive per i più diversi documenti, compresi lucidi e presentazioni. Per esempio, questa guida è scritta con lo stile ClassicThesis, basato sulle classi KOMA-Script, leggermente diverse da quelle standard. Per maggiori dettagli, si veda [Pantieri, 2007].4 Le hopzionii date a \documentclass adattano il comportamento della classe del documento. Di seguito si descrivono le opzioni globali (ovvero che hanno effetto sull’intero documento) più comuni per le tre classi principali article, report e book. (Dal momento che la classe letter è fondamentalmente diversa dalle altre tre, se ne veda la documentazione.)

10pt, 11pt, 12pt Impostano la dimensione del font principale del do-

cumento. Omettendo l’opzione, il valore predefinito è di 10 punti.

a4paper, a5paper, ... Definiscono le dimensioni del foglio, che per impostazione predefinita è nel formato americano letterpaper.

Le altre opzioni possibili sono executivepaper, legalpaper e b5paper. oneside, twoside Specificano se verrà composto un documento a sin-

gola o doppia facciata. Per impostazione predefinita, le classi article e report sono a singola facciata e la classe book è a doppia facciata.

4 Tra le classi non standard più diffuse vi sono memoir (che consente di personalizzare qualunque aspetto del documento in modo particolarmente versatile), toptesi (specifica per tesi di laurea e dottorato), beamer (per le presentazioni), examdesign (per scrivere prove d’esame e test di vario genere).

Opzioni di classe

30

le basi

Tabella 4: Le opzioni più comuni delle classi standard di LATEX; i simboli , G #e # denotano rispettivamente che l’opzione è predefinita, applicabile (anche se non predefinita), non applicabile.

Opzione 10pt letterpaper oneside twoside openany openright titlepage final

book G # G #

report

article

# G

G # # # G #

# G

openany, openright L’opzione openright, che è predefinita nella clas-

se book, fa iniziare i capitoli sempre in una pagina destra, mentre l’opzione openany, predefinita nella classe report, li fa iniziare nella successiva pagina a disposizione. Queste opzioni non sono disponibili nella classe article, dato che non ammette la suddivisione in capitoli.

twocolumn Dà a LATEX le istruzioni per stampare il documento su due

colonne.

titlepage, notitlepage Specificano se dopo il titolo del documento

debba avere inizio una nuova pagina (come accade con le classi report e book) o meno (come accade con la classe article).

fleqn Allinea le formule a sinistra rispetto a un margine rientrato.

leqno Mette la numerazione delle formule a sinistra anziché a destra. draft, final L’opzione draft evidenzia le righe che LATEX non è riu-

scito a comporre (e che quindi fuoriescono) con una spessa linea nera sul margine destro, rendendole più facili da individuare.

Ciò non accade con l’opzione final. Le due opzioni vengono passate anche agli altri pacchetti caricati nel documento e hanno effetto sul loro funzionamento. Per esempio, il pacchetto graphicx non carica le immagini quando è specificata l’opzione draft: al loro posto viene mostrato un riquadro di dimensioni corrispondenti che contiene solo il nome dell’immagine.

Si noti, però, che alcune di queste opzioni hanno un’applicabilità limitata, come mostra la tabella 4.

Il codice sorgente di un documento da comporre con LATEX potrebbe iniziare con la riga \documentclass[a4paper,11pt,twoside]{article}

Sommario

che ordina a LATEX di impaginare il documento come un articolo, su carta di formato A4, con un carattere di 11 punti e impostato per la stampa fronte/retro.

Si noti inoltre che nelle classi standard report e article l’ambiente abstract permette di scriverne il sommario. (La classe book, invece,

3.4 i pacchetti

non prevede quest’ambiente, perché nei libri il sommario è di solito sostituito dall’introduzione.)

3.4

i pacchetti

Scrivendo i documenti, capita non di rado di imbattersi in alcuni problemi che LATEX non riesce a risolvere da solo. Il suo linguaggio standard, per esempio, non gestisce direttamente l’inclusione delle immagini, né sillaba i testi scritti in lingue diverse dall’inglese, né ancora permette di modificare i margini di pagina in modo semplice. Per aggirare questo tipo di “ostacoli”, si sfrutta la struttura modulare del programma, che ne estende le capacità di base: questi moduli aggiuntivi si chiamano pacchetti.

31

La struttura modulare di LATEX

Che cosa sono?

Fondamentalmente, un pacchetto è un file “di stile” (con estensione .sty), scritto in linguaggio LATEX, contenente alcune istruzioni che permettono di svolgere alcune operazioni.

Come sapere se servono?

In genere, se per ottenere il risultato sperato si deve faticare troppo, probabilmente qualcuno che si è già trovato nella stessa situazione ha provveduto a creare un pacchetto per semplificare il lavoro.

Viceversa, compilando un file sorgente può capitare che LATEX produca un messaggio di errore del tipo Can’t find file guit.sty: ciò significa che è stato caricato un pacchetto (guit, nell’esempio considerato) non presente nella distribuzione di LATEX installata sul calcolatore. In questo caso, bisogna seguire le istruzioni del paragrafo 3.4.3 a pagina 34.

Come scovare il pacchetto “giusto”?

Questo è l’unico aspetto del lavoro con LATEX in cui gusto, abilità e fortuna dell’autore la fanno da padroni: cercando sul motore di ricerca del sito del guIt (+ guit), oppure su ctan (+ ctan) o su Sarovar (+ sarovar), si trovano preziosi riferimenti e soluzioni per risolvere moltissimi problemi.

Come installarli?

Una distribuzione di LATEX si modifica nel tempo, per cui nuovi pacchetti possono esserle aggiunti e altri tolti in qualsiasi momento. I pacchetti già inclusi in una distribuzione in genere soddisfano quasi tutte le esigenze di scrittura, e per mantenere il proprio sistema sempre efficiente, bisogna aggiornarli periodicamente. Potrebbe anche essere necessario installare i nuovi pacchetti che vengono continuamente creati e caricati negli archivi di ctan, e che perciò non figurano nel

Capire qual è il pacchetto che fa al proprio caso

Installare un pacchetto automaticamente. . .

32

. . . e a mano.

Installare un pacchetto “al volo”

MiKTEX Package Manager

le basi

sistema. MiKTEX e TEX Live (quest’ultima soltanto dalla versione 2008 in poi) permettono di svolgere facilmente entrambe le operazioni con appositi programmi integrati (package manager), che funzionano dalla riga di comando o a interfaccia grafica.

Esistono, però, almeno due circostanze in cui per installare nuovi pacchetti non si possono usare le funzioni automatiche del sistema: quando il pacchetto è creato dall’autore (si veda il paragrafo 9.1.4 a pagina 184) oppure quando il pacchetto è coperto da licenze particolari.

Nei due paragrafi seguenti illustreremo il funzionamento dei due principali package manager.

3.4.1

MiKTEX Package Manager

MiKTEX prevede la possibilità di installare un pacchetto “al volo” (purché, naturalmente, la connessione a Internet sia attiva): quando il compilatore si imbatte nei comandi di un pacchetto disponibile per la distribuzione ma non ancora installato, MiKTEX lo scarica automaticamente dall’archivio locale o da ctan.

In alternativa, si può usare il programma MiKTEX Package Manager (si veda la figura 6a a fronte), seguendo questa procedura: • si lancia il programma (Start → Programmi → MiKTEX → Browse Packages): apparirà una finestra con l’elenco alfabetico dei pacchetti disponibili nell’archivio (repository); per ciascuno viene indicato se è installato o meno e ne viene data una breve descrizione; • si evidenzia con un clic il nome del pacchetto o dei pacchetti che si desiderano installare; • si clicca il pulsante +, che si evidenzierà, e si attende la fine dell’installazione; • si aggiornano i cosiddetti file “di formato” di MiKTEX (Start → Programmi → MiKTEX → Settings → General → Update Formats).

Può capitare che non sia il pacchetto a mancare, ma che la versione installata semplicemente non sia aggiornata. In questo caso si usa il programma MiKTEX Update Wizard (Start → Programmi → MiKTEX → Update), che propone di aggiornare i pacchetti con le nuove versioni eventualmente disponibili.

TEX Live Manager

3.4.2

TEX Live Manager

Dal 2008, la distribuzione TEX Live integra il programma TEX Live Manager per installare e aggiornare i pacchetti (+ tlmgr). Il programma si lancia e si usa dalla riga di comando con i privilegi di amministratore, ma se ne può avere comunque una versione con interfaccia grafica specificando l’opzione --gui. MacTEX integra anche un’interfaccia grafica nativa per Mac, TEX Live Utility, da preferire senz’altro a quella precedente perché evita di dover usare la riga di comando e altri programmi accessori.

3.4 i pacchetti

(a) MiKTEX Package Manager.

33

(b) TEX Live Utility.

Figura 6: La gestione automatica dei pacchetti.

Si noti che le maggiori distribuzioni di Linux non forniscono TEX Live Manager insieme a TEX Live, per non avere a che fare con gestori di pacchetti diversi dal proprio. Per aggiornare TEX Live bisogna attendere che il package manager installato segnali la presenza di un aggiornamento di qualche pacchetto a essa legato.

TEX Live Utility per Mac TEX Live Utility, dalla versione 2009 inclusa in MacTEX, è l’interfaccia grafica consigliata agli utenti Mac per installare e aggiornare i pacchetti (richiede Mac OS X 10.5.6 o successivi). Per aggiornare tutti i pacchetti proposti nell’elenco si clicca il pulsante Update All sulla barra degli strumenti; per aggiornarne soltanto alcuni si clicca il pulsante Update dopo averli selezionati; per installare quelli non compresi nel sistema, si selezionano e si clicca il tasto +. La scheda Manage Packages permette di ottenere informazioni di vario tipo sui pacchetti. tlmgr dalla riga di comando

Se si preferisce usare TEX Live Manager dalla riga di comando, queste sono le istruzioni più comuni da eseguire: • tlmgr list elenca tutti i pacchetti disponibili, contrassegnando con “i” quelli già installati; • tlmgr install hpacchettoi installa il pacchetto prescelto; • tlmgr update --list elenca i pacchetti aggiornabili; • tlmgr update --all aggiorna tutti i pacchetti; • tlmgr update hpacchettoi aggiorna il pacchetto prescelto.

Per ottenere i privilegi di amministratore su Mac OS X, bisogna premettere a ogni istruzione il comando sudo (super user do) o, in alternativa, dare le istruzioni in qualità di utente root — l’alternativa da seguire dipende dal sistema operativo installato.

L’interfaccia grafica rispecchia fedelmente la riga di comando. Dopo averla lanciata si carica l’elenco dei pacchetti cliccando il tasto Carica

TEX Live Utility

34

Installare a mano un pacchetto è semplice.

le basi

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 cliccare il pulsante Installa selezionati.

Per aggiornare uno, più o tutti i pacchetti, bisogna spostarsi nella scheda Aggiornamento e cliccare i tasti Aggiorna selezionati (dopo aver effettuato una selezione) oppure Aggiorna tutti.

3.4.3

Installare un pacchetto a mano

Talvolta (ma accade assai di rado) può essere necessario installare a mano un pacchetto non compreso nella propria distribuzione. In questo caso, bisogna sapere dove va sistemato il relativo file .sty, in modo che LATEX lo possa trovare. Se si usano MiKTEX o TEX Live, è sufficiente copiare il file .sty nella sottocartella /tex/latex/ dell’albero personale (ovvero la cartella in cui l’utente può mettere i pacchetti, le classi e gli stili che usa ma non inclusi nella distribuzione), creando le necessarie cartelle, se non ci fossero già.5 La posizione dell’albero personale dipende dalla distribuzione di LATEX installata: • Su Windows (con MiKTEX) l’albero personale è la cartella C:\ Documents and Settings\hnome dell’utentei\Dati applicazioni\ MiKTeX\2.9\ oppure, in alternativa, la cartella C:\Documents and Settings\hnome dell’utentei\Impostazioni locali\Dati applicazioni\MiKTeX\2.9\.

• Su Mac, l’albero personale è $HOME/Library/texmf/.

• Su Linux, la posizione dell’albero personale dipende dalla distribuzione installata, mentre la sua radice può comunque essere visualizzata dalla riga di comando eseguendo kpsexpand ’$ TEXMFHOME’. Su una Debian, per esempio, l’albero personale è radicato in ~/texmf/.

In alternativa, basta copiare i file .sty nella cartella di lavoro: LATEX li troverà lì e li userà senza doverli installare.

Caricare un pacchetto

3.4.4

Come caricarli?

I pacchetti si caricano nel preambolo con il comando

\usepackage[hopzionii]{hpacchettoi}

dove: • hopzionii è una voce o un elenco di voci (in questo caso separate dalla virgola) che specificano altrettante impostazioni del pacchetto; 5 MiKTEX e TEX Live prevedono altre due cartelle in cui trovare i file da usare: l’albero principale (ovvero la cartella che contiene i file installati dalla distribuzione che si sta usando, disponibili per tutti gli utenti) e l’albero locale (ovvero la cartella che rende i file disponibili a tutti gli utenti senza dover modificare a mano l’albero principale). Per i dettagli, si veda + guit.

• hpacchettoi è il nome del pacchetto.

3.4 i pacchetti

35

Un’opzione può essere costituita da un unico elemento o da un’espressione del tipo hchiavei=hvalorei.

3.4.5 Imparare a usarli al meglio: la documentazione

Chi scrive o aggiorna un pacchetto per LATEX ne scrive anche, e quasi sempre in inglese, la documentazione. Questa si compone spesso di due parti distinte: • Il vero e proprio manuale d’uso, che spiega come caricare il pacchetto e come usare i suoi comandi.

• Il codice che costituisce il pacchetto, destinato a chi voglia eventualmente svilupparlo. (Nel caso di pacchetti molto corposi, il codice costituisce un file a sé.)

I pacchetti contenuti in ogni distribuzione di LATEX sono già corredati della relativa documentazione (quasi sempre un pdf o dvi omonimo), che di regola va cercata nella cartella .../doc/latex/ del calcolatore (è impossibile indicare in questa sede tutti i percorsi esatti, perché ogni distribuzione ha i propri). Se il percorso di ricerca sopra indicato non è immediatamente individuabile, si possono sempre ritrovare i file di documentazione con le ordinarie funzioni di ricerca del sistema operativo, con l’avvertenza che su Mac e Linux non sempre hanno successo, perché non tutto il contenuto del disco rigido viene indicizzato dal sistema.

Risolve il problema il programma texdoc, integrato in TEX Live a partire dalla versione 2008, e disponibile per tutti e tre i sistemi operativi considerati in questa guida. Il programma si lancia dalla riga di comando e prevede numerose opzioni di ricerca, come si può leggere nella sua documentazione: eseguendo texdoc hnome del pacchettoi, in un attimo si apre il relativo manuale. Dalla versione 2.30 in poi, TEXShop integra un’interfaccia grafica per usare il programma: con l’editor aperto, la sequenza ⌥ ⌘ i apre una finestra di dialogo nella quale scrivere il nome del pacchetto di cui si cerca la documentazione. La stessa cosa si ottiene con la sequenza Ctrl + Maiusc + F1 in WinEdt 6.0.

Si noti, però, che la ricerca va sempre a buon fine se il file cercato è un pdf, mentre non accade lo stesso con i dvi: alcuni vengono trovati e visualizzati, altri no. Ad ogni modo, la documentazione è sempre e comunque reperibile tramite il motore di ricerca di ctan (+ ctan).

3.4.6 E i file .ins e .dtx?

In alcuni casi, i pacchetti che si scaricano da Internet (in forma di archivi compressi) non contengono direttamente il file .sty e il relativo pdf di documentazione, ma un file con estensione .ins e uno con estensione .dtx. Basta procedere in questo modo: • Il file .dtx contiene la documentazione del pacchetto. Eseguendo LATEX su di esso, si ottiene il manuale d’uso in formato .pdf o, meno spesso, .dvi.

Dove si trova la documentazione?

Il programma texdoc

36

le basi

• Eseguendo invece LATEX sul file .ins, si ottiene il file .sty desiderato (o anche più di uno, a seconda dei casi).

Si noti che alcuni pacchetti contengono soltanto il file .dtx: in questo caso la prima delle due istruzioni permette di ottenere anche il file .sty.

A questo punto, per ultimare l’installazione, basta spostare i file .sty ottenuti in una cartella accessibile a LATEX e, se necessario, aggiornare la base di dati dei pacchetti come spiegato poco sopra.

3.4.7 I pacchetti di uso più comune

I seguenti pacchetti di uso comune devono essere presenti in tutte le distribuzioni fin dall’inizio. L’unico che può richiedere una tantum qualche intervento dell’utente è babel, responsabile della gestione tipografica del documento in una o più lingue particolari (si veda il paragrafo 4.1.3 a pagina 46). amsmath Fornisce numerose estensioni per gestire al meglio documenti che contengono formule matematiche. amssymb Arricchisce la scelta di simboli matematici.

amsthm Migliora la gestione degli enunciati matematici.

array Permette di definire nuovi descrittori per le tabelle. babel Permette di usare lingue diverse dall’inglese.

backref Nelle voci bibliografiche, indica le pagine del documento in cui l’opera viene citata.

biblatex Offre all’autore una soluzione complessiva e automatica per gestire e personalizzare la bibliografia. booktabs Migliora l’aspetto delle tabelle. caption Personalizza le didascalie.

changepage Modifica i margini di una singola pagina. enumitem Personalizza gli elenchi.

eurosym Stampa il simbolo dell’euro.

fancyhdr Personalizza lo stile della pagina.

float Crea oggetti mobili personalizzati e ne forza la collocazione sulla pagina. fontenc Gestisce la codifica dei font che LATEX usa per comporre il documento. geometry Imposta i margini di pagina nelle classi standard. graphicx Gestisce l’inclusione delle immagini. hyperref Abilita i riferimenti ipertestuali.

3.5 stili di pagina

indentfirst Rientra il primo capoverso di ogni unità di sezionamento del testo (in accordo con la tradizione italiana).

37

inputenc Interpreta correttamente i caratteri accentati e nazionali scritti direttamente con la tastiera.

listings Permette di scrivere codici, controllandone finemente il formato. longtable Ripartisce una tabella su più pagine.

makeidx Fornisce comandi per realizzare l’indice analitico. microtype Migliora il riempimento delle righe. minitoc Genera i miniindici.

multicol Dispone e bilancia il testo su più colonne.

showlabels Durante la revisione, permette di controllare la correttezza dei riferimenti \label , \ref , \cite , eccetera.

subfig Affianca figure e tabelle.

tabularx Compone tabelle di larghezza impostata dall’utente. url Imposta la scrittura degli indirizzi Internet.

varioref Gestisce in modo flessibile i riferimenti incrociati.

xcolor Gestisce il colore.

3.5

stili di pagina

Lo stile di pagina è l’organizzazione del contenuto di testatina e piè di pagina scelta per il proprio documento, e va indicata nell’argomento hstilei del comando: \pagestyle{hstilei}

LATEX prevede tre stili di pagina predefiniti e uno personalizzabile: plain Stampa i numeri di pagina nel piè di pagina, lasciando vuota la

testatina. È lo stile predefinito nelle classi article e report.

empty Lascia testatina e piè di pagina vuoti.

headings Lascia il piè di pagina vuoto, e compone le testatine come

segue: il numero di pagina è sempre posto nel margine esterno, seguito dal titolo del capitolo corrente nella testatina di sinistra, e preceduto dal titolo del paragrafo corrente in quella di destra. È lo stile predefinito nella classe book, e agisce nello stesso modo nella classe report e article impostate con twoside, con la differenza che in quest’ultima le testatine riportano i titoli del paragrafo e del sottoparagrafo correnti, rispettivamente. Se invece si imposta la classe con oneside, la testatina riporta soltanto il titolo della suddivisione maggiore.

Ci si può accontentare di uno stile predefinito. . .

. . . oppure si può crearne uno proprio.

Cambiare lo stile della pagina corrente

38

le basi

myheadings È simile a headings nel risultato, e va usato quando non

si vuole che le testatine dipendano dai titoli delle sezioni (capitolo e paragrafo) correnti. L’autore è chiamato a specificare il contenuto delle testatine a ogni nuovo capitolo (o paragrafo, se la classe è article), dando \markboth per comporle entrambe, oppure \markright per comporre soltanto quella di destra.

Si può cambiare lo stile della pagina corrente con il comando \thispagestyle{hstilei}

emptypage fancyhdr

Per eliminare le testatine e i piè di pagina che l’opzione openright comunque stampa nelle pagine bianche alla fine di un capitolo nelle classi standard (scelta consigliata), basta caricare il pacchetto emptypage nel modo consueto.

Il pacchetto fancyhdr (si veda il paragrafo 9.3 a pagina 185) crea stili di pagina personalizzati.

3.6

file con cui si ha a che fare

Quando si lavora con LATEX, si ha a che fare con svariati tipi di file.

Di seguito se ne riporta un elenco (non completo).

3.6.1

File dell’utente

.tex Estensione del file sorgente scritto dall’utente con LATEX. .pdf, .jpg, .png Formati standard delle figure accettati da pdfLATEX

(si veda il capitolo 6 a pagina 117).

.eps Formato delle figure accettato da LATEX (si veda il capitolo 6 a

pagina 117).

3.6.2

File di classi, pacchetti e stili

.cls Classe di documento. Si sceglie scrivendone il nome nell’argomento di \documentclass . .sty Pacchetto di LATEX. Si carica nel testo sorgente scrivendone il nome nell’argomento di \usepackage . .ins, .dtx File di installazione e documentazione di un pacchetto.

Eseguendo LATEX sul file .ins e .dtx si ottengono i corrispondenti file .sty e .pdf. .bst Stile bibliografico usato dal programma BibTEX (si veda il capito-

lo 7 a pagina 155).

.ist File che contiene le istruzioni per personalizzare l’indice analitico

(si veda il capitolo 8 a pagina 177).

3.6.3 File ausiliari

3.6 file con cui si ha a che fare

Prodotti dalla compilazione .log Rendiconta dettagliatamente l’ultima compilazione. .toc Contiene le informazioni necessarie per produrre l’indice generale (table of contents). .lof È simile al .toc ma riguarda l’elenco delle figure (list of figures). .lot È l’analogo di .lot per l’elenco delle tabelle (list of tables). .aux File che trasporta informazioni da un’esecuzione all’altra del compilatore; tra le altre cose, il file .aux è usato per conservare le

informazioni associate ai riferimenti incrociati.

Generati in compilazione da pacchetti e programmi .bbl Contiene le informazioni per impaginare la bibliografia, se si usa

BibTEX.

.blg Rendiconta l’operato di BibTEX. .idx Viene generato se il documento contiene un indice analitico. Tut-

te le parole che vanno nell’indice analitico sono memorizzate da LATEX in questo file, che deve essere successivamente elaborato con il programma MakeIndex.

.ind È il risultato dell’elaborazione del file .idx fatta da MakeIndex,

pronto per essere incluso nel documento alla successiva compilazione.

.ilg Rendiconta l’operato di MakeIndex. .out Raccoglie le informazioni per generare i segnalibri ipertestuali,

se si usa il pacchetto hyperref (si veda il capitolo 4 a pagina 43).

.mtc Raccoglie le informazioni per generare i miniindici, se si usa il

pacchetto minitoc (si veda il capitolo 4 a pagina 43).

.brf Raccoglie le informazioni per generare i riferimenti bibliografi-

ci finali, se si usa il pacchetto backref (si veda il capitolo 4 a pagina 43).

.maf Contiene l’elenco dei file ausiliari di minitoc.

3.6.4 File di output

.dvi È il principale risultato dell’esecuzione di LATEX. Si visualizza e

si stampa con un visualizzatore di dvi.

.pdf È il principale risultato dell’esecuzione di pdfLATEX. Si visualizza

e si stampa con un visualizzatore di pdf.

39

40

Organizzare il materiale

le basi

3.7

documenti di grandi dimensioni

L’organizzazione del materiale gioca un ruolo importantissimo per scrivere con successo un documento di grandi dimensioni (come un libro o una tesi). Immaginando di scrivere la tesi di laurea, si suggerisce di mettere tutti i file del documento in una stessa cartella Tesi, per esempio, da strutturare in sottocartelle come segue: • La sottocartella MaterialeInizialeFinale contiene il materiale iniziale e finale del documento suddiviso in altrettanti file come Ringraziamenti.tex, Introduzione.tex, Conclusioni.tex, eccetera.

• La sottocartella Capitoli contiene i capitoli del documento suddivisi in altrettanti file come Mane.tex, Tekel.tex, Fares.tex, eccetera.

• La cartella Immagini contiene tutte le immagini da includere nel documento, in uno dei formati accettati da LATEX o pdfLATEX. Se sono molte, potrebbe essere conveniente distribuirle in ulteriori sottocartelle corrispondenti ai diversi capitoli.

La cartella Tesi deve contenere anche altri due file: • il file principale del documento, Tesi.tex; • il file Bibliografia.bib, cioè la base di dati di BibTEX che contiene tutti i riferimenti bibliografici del documento.

\input

Questo piccolo accorgimento semplifica notevolmente il proprio lavoro.

I file .tex corrispondenti alle diverse sezioni del documento si caricano tra \begin{document} e \end{document} semplicemente indicandone il percorso nell’argomento di \input , come mostra l’esempio seguente: \input{MaterialeInizialeFinale/Ringraziamenti} \input{MaterialeInizialeFinale/Introduzione} \input{Capitoli/Mane} \input{Capitoli/Tekel} \input{Capitoli/Fares} ... \input{MaterialeInizialeFinale/Conclusioni}

Il comando

\include può essere

utile se si dispone di un calcolatore di vecchia generazione.

In pratica, il comando \input costruisce il documento “attaccando” uno dopo l’altro i vari file sorgente specificati nel proprio argomento.

Si noti che questi ultimi non devono contenere alcun preambolo (da scrivere invece una sola volta nel file hnome del documentoi.tex), ma soltanto titolo della sezione e relativo testo. Permette l’annidamento, ovvero si può richiamare un file che ne richiama un altro.

Se si lavora a un documento corposo su una macchina particolarmente datata, può essere utile il comando \include , il cui uso è analogo a \input : \include{hfile1i} \include{hfile2i} ...

3.7 documenti di grandi dimensioni

Il comando non permette l’annidamento e fa iniziare una nuova pagina prima di elaborare il file richiamato nell’argomento, ma permette di usare il comando

41

\includeonly{hfile1i,hfile2i,h. . .i}

per includere soltanto i file elencati tra parentesi graffe. Quando si usa quest’ultimo comando, vengono compilati solamente i file tra parentesi graffe e i contatori (numeri di pagina, numeri di note, eccetera) non vengono aggiornati. A differenza di \input , che scrive tutte le informazioni sul file .aux principale, il comando \include crea un file .aux per ogni file incluso e poi richiama questi ultimi dal file .aux principale. (Poiché il meccanismo di \include comprende la scrittura di un file .aux per ogni file incluso e alcune distribuzioni di LATEX non permettono di scrivere in cartelle che siano al di sopra di quella in cui si trova il file sorgente, \include potrebbe non funzionare se si cerca di includere un file che si trova in un punto “proibito”. Si può evitare il problema strutturando il materiale come consigliato in questo paragrafo.)

Per evitare problemi, è opportuno che il percorso (path) dei file inclusi mediante i comandi \input , \include e \includeonly non contenga spazi.

Si può eseguire un veloce controllo sintattico del documento con il pacchetto syntonly, che imposta LATEX per controllare soltanto sintassi e corretto uso dei comandi senza restituire alcun output. Questa modalità permette un notevole risparmio di tempo, dato che LATEX viene eseguito molto più velocemente. L’uso del pacchetto è molto semplice: \usepackage{syntonly} \syntaxonly

Per compilare effettivamente il documento basta commentare la seconda riga (facendola precedere dal simbolo %).

Controllare velocemente la sintassi del documento

4 indice 4.1

4.2 4.3

4.4

4.5 4.6

4.7 4.8 4.9 4.10 4.11

4.12 4.13 4.14

IL TESTO Scrivere nelle varie lingue 43 4.1.1 La codifica di output: fontenc 43 4.1.2 La codifica di input: inputenc 45 4.1.3 Le scelte tipografiche: babel 46 La struttura del testo 48 Comporre i capoversi 48 4.3.1 Dividere le parole in fine di riga 51 4.3.2 Il pacchetto microtype 53 4.3.3 Il rientro della prima riga 53 Sezionare il documento 53 4.4.1 Materiale iniziale, principale e finale 54 4.4.2 L’indice generale 55 4.4.3 Miniindici 57 Le proporzioni di pagina 57 4.5.1 Il tormentone dei margini 57 4.5.2 Interlinea e riempimento della pagina 59 Caratteri particolari e simboli 60 4.6.1 Virgolette, tratti e puntini di sospensione 60 4.6.2 Riferimenti ipertestuali e indirizzi Internet 61 4.6.3 Loghi, caratteri particolari, apici e pedici 65 Titoli e frontespizi 66 Riferimenti incrociati 68 Note a margine e a piè di pagina 69 Evidenziare le parole 70 Ambienti 70 4.11.1 Elenchi puntati, numerati e descrizioni 70 4.11.2 Allineare e centrare i capoversi 72 4.11.3 Citazioni 73 4.11.4 Poesie 74 4.11.5 Codici e algoritmi 75 Acronimi e glossari 77 Specialità 77 La revisione finale 79

Questo capitolo mostra come realizzare veri e propri documenti di testo.

4.1

scrivere nelle varie lingue

4.1.1 La codifica di output: fontenc

LATEX non nasce poliglotta, ma come programma “pensato” in inglese per comunicare in questa lingua, e nelle intenzioni degli autori

Un programma nato “in inglese”

43

44

il testo

(realizzare documenti scientifici ad alto contenuto di matematica e a basso contenuto di testo) bastava la minima dotazione di caratteri incorporata, composta di lettere, numeri, e pochi altri segni. Un tipico documento in inglese, infatti, si presenta così: \documentclass{h. . .i} \begin{document}

htestoi \end{document}

“Costruire” i caratteri: controindicazioni

fontenc e la codifica di output

Si noti che tra la dichiarazione di classe e l’inizio del documento può non essere caricato alcun pacchetto.1 Com’è noto, l’inglese si scrive senza alcun accento o carattere particolare, mentre la vasta maggioranza delle altre lingue che usano l’alfabeto latino presenta nella scrittura una varietà di segni diversi: accento, tilde, dieresi, eccetera. Appena si cominciò a usare il calcolatore per documenti più complessi e diversificati, emerse il problema di scrivere questi caratteri con LATEX. Si consideri il caso dell’italiano, nel quale gli unici caratteri “complessi” sono le vocali accentate. Se in un documento come il precedente al posto del htestoi si scrivesse, per esempio, La pietà è una virtù usando i tasti dedicati per le lettere accentate, queste non verrebbero visualizzate nel file di output perché, mancando nell’inglese scritto, LATEX non le riconosce e le salta.

Si potrebbe risolvere il problema “costruendole”, sovrapponendo in modo esplicito l’accento alla vocale: La piet\‘a \‘e una virt\‘u. L’espediente, che sembrerebbe funzionare, presenta tuttavia due controindicazioni. La prima risiede nella scomodità di scrivere così per lunghi tratti di testo: alcune lingue richiedono una procedura ben più laboriosa per i propri caratteri particolari. La seconda è sostanziale: per come riconosce le parole, LATEX non sillaba completamente le parole che contengono caratteri costruiti in questo modo, al punto che, per parole relativamente corte, potrebbe non essere in grado di trovare un valido punto di cesura. Le sillaberebbe senza problemi, però, se i caratteri accentati fossero già disegnati e pronti per l’uso.

Risolve il problema il pacchetto fontenc (font encoding, “codifica dei font”), che mette a disposizione di LATEX caratteri “fatti su misura”, che costituiscono la codifica di output, nel gergo di LATEX, responsabile di ciò che si vedrà nel documento finito, da indicare come opzione del pacchetto subito dopo la dichiarazione di classe: \documentclass[h. . .i]{h. . .i} \usepackage[T1]{fontenc}

Si scrive in italiano e in molte altre lingue europee con la codifica T1, che presto sarà quella predefinita per le lingue occidentali; per altre lingue o alfabeti particolari vanno usate altre codifiche.2 Per gli approfondimenti, si veda la documentazione contenuta nel file encguide.pdf, recuperabile con texdoc nel modo consueto.

1 La corretta scrittura di parole straniere, tuttavia, potrebbe richiedere di caricare i due pacchetti descritti in questo paragrafo anche in un documento completamente in inglese.

2 Se un documento prevede parti in più lingue, si separeranno le diverse codifiche con una virgola, avendo cura di mettere per ultima quella della lingua principale: [T2A,T1] per un documento in italiano e russo. Si noti che T1 potrebbe “sgranare” i caratteri sul monitor con la sola MiKTEX Basic: un motivo per non installarla.

4.1 scrivere nelle varie lingue

4.1.2 La codifica di input: inputenc

Il set di caratteri fornito da fontenc, però, da solo non basta a LATEX per interpretare correttamente tutti i caratteri particolari inseriti con i tasti dedicati o le combinazioni di tasti: nel documento finito si potrebbero vedere altri caratteri da quelli immessi, oppure non vederli del tutto.

Il problema si risolve fornendo al programma anche le istruzioni per usare i caratteri di cui si ha effettivamente bisogno. Queste costituiscono la codifica di input, nel gergo di LATEX, che si occupa di interpretare correttamente il flusso di caratteri in entrata e si indica come opzione del pacchetto inputenc (input encoding, “codifica di input”) subito dopo fontenc:

45

inputenc e la codifica di input

\documentclass[h. . .i]{h. . .i} \usepackage[T1]{fontenc} \usepackage[utf8]{inputenc}

Per scrivere in italiano e in moltissime altre lingue si raccomanda la codifica utf-8 (che si imposta dando l’opzione utf8 a inputenc), che permette di usare i segni di numerosi alfabeti evitando di dover caricare in ogni documento la codifica adatta alla lingua in cui si scrive. Si noti che tra gli editor considerati in questa guida solo TEXShop e TEXworks supportano pienamente utf-8, mentre TEXnicCenter e WinEdt lo faranno soltanto a partire dalle prossime versioni. Per il momento, la codifica di input consigliata per gli ultimi due è latin1.3 Per gli approfondimenti, si veda la documentazione contenuta nel file inputenc.pdf, recuperabile con texdoc nel modo consueto.

Codifiche e editor La codifica di input è strettamente legata alla codifica con cui lavora l’editor in uso. Molti programmi di gestione dei testi oggi permettono non solo di aprire un file scritto in diverse codifiche, ma anche di decidere al momento di aprirlo quale codifica si voglia usare. Naturalmente occorre conoscerla in anticipo, altrimenti aprendo il file ci si troverà davanti a caratteri bizzarri.

Questo accade perché la codifica di input data a inputenc nel file sorgente è diversa da quella con cui è impostato l’editor (da regolare nella finestra Preferenze o un nome analogo). In queste situazioni è importante chiudere il file senza salvare e riaprirlo soltanto dopo aver reimpostato correttamente il programma, altrimenti bisognerà sostituire a mano i caratteri incomprensibili oppure, se il file è corposo, convertirlo con un programma apposito.4 Se le due codifiche coincidono, invece, non ci sono problemi. Si tengano presenti queste indicazioni, 3 Tra gli editor che accettano la codifica utf-8 non considerati in questa guida si segnalano almeno Texmaker (+ texmaker) e TexMakerX, poco diversi l’uno dall’altro ed entrambi multipiattaforma. Se ci fosse bisogno di usare caratteri non compresi neppure in utf8 si può ampliare ulteriormente il campo con la codifica utf8x, da caricare subito dopo il pacchetto ucs che, però, non è più mantenuto da tempo.

4 Per trasformare in utf8 un file codificato diversamente si può anche usare il programma Charco (+ charco). Per Linux c’è l’analogo iconv (+ iconv), che opera dalla riga di comando. Se non si è sicuri della codifica predefinita della distribuzione di Linux installata, basta eseguire printenv LANG dalla riga di comando.

Codifica dell’editor e di input devono coincidere.

46

il testo

dunque, prima di aprire un file sorgente scaricato da Internet oppure quando uno stesso documento viene trasferito e “lavorato” da più mani su editor e sistemi operativi diversi.

Si noti che ogni editor gestisce le codifiche a modo proprio, e che quelli più avanzati riescono a risolvere automaticamente questo inconveniente con qualche semplice accorgimento. Si raccomanda, perciò, di leggerne con attenzione il manuale.

4.1.3 Le scelte tipografiche: babel

Dopo aver caricato e impostato i pacchetti per la lingua o le lingue del documento, si può pensare alle scelte tipografiche, per le quali LATEX deve essere configurato in due ambiti: 1. le voci generate automaticamente (Indice, Elenco delle figure, Elenco delle tabelle, Capitolo, eccetera) devono essere adattate alla nuova lingua; 2. di quest’ultima, LATEX deve conoscere le regole di sillabazione.

Per farlo, basta caricare il pacchetto babel subito dopo inputenc, specificando nel suo argomento facoltativo la lingua (o le lingue) in cui si intende scrivere:5 \usepackage[hlinguai]{babel}

Scrivere in italiano

Si configura LATEX per l’italiano scrivendo nel preambolo: \usepackage[italian]{babel}

Per attivare la sillabazione, babel è necessario ma in generale non sufficiente.

Si noti che babel può sillabare le parole italiane soltanto se viene attivato anche il file che ne contiene le regole. La procedura è la seguente: • con MiKTEX, si seleziona la voce Italian dal pannello Languages del menu Settings e si aggiorna il sistema (con Update Formats);

• con TEX Live su Linux, a seconda della distribuzione può essere necessario lanciare texconfig-sys dalla riga di comando (occorrono i privilegi di amministratore), scegliere hyphenation e togliere il % davanti a italian nel file che comparirà (dalla versione 2008 in poi, questa procedura non è più necessaria); • con TEX Live su Mac, non c’è bisogno di fare nulla (tutto l’occorrente viene abilitato automaticamente durante l’installazione).

Comandi “nazionali”

Per alcune lingue babel definisce anche nuovi comandi che semplificano l’immissione di caratteri particolari. La lingua tedesca, per esempio, contiene molte dieresi (ä, ö, ü): impostando opportunamente il pacchetto, si può immettere una ö battendo "o invece di \"o. Per l’italiano, questi comandi sono raccolti nella documentazione del pacchetto e vengono spiegati in [Gregorio, 2010].

5 Le lingue gestite da babel sono elencate in [Gregorio, 2010].

4.1 scrivere nelle varie lingue

Ecco, infine, il tipico inizio di un file sorgente per scrivere in italiano:

47

\documentclass[a4paper,h. . .i]{h. . .i} \usepackage[T1]{fontenc} \usepackage[utf8]{inputenc} \usepackage[italian]{babel}

Scegliere la lingua Ciascuna lingua di un documento multilingue si può sillabare a sé.

Se se si carica babel con \usepackage[english,italian]{babel}

l’ultima lingua (l’italiano) è quella predefinita. Si passa da una lingua all’altra con \begin{otherlanguage}{hlinguai} ... \end{otherlanguage}

da usare in questo modo:6 \begin{abstract} Versione del sommario in italiano. \dots \end{abstract} \begin{otherlanguage}{english} \begin{abstract} English version of the abstract. \dots \end{abstract} \end{otherlanguage}

Sommario Versione del sommario in italiano. . . .

Abstract English version of the abstract. . . .

In alternativa si può usare il comando \foreignlanguage{hlinguai}{htestoi}

oppure, analogamente, l’ambiente \begin{otherlanguage*}{hlinguai}

htestoi \end{otherlanguage*}

dove il htestoi viene composto secondo le regole tipografiche di hlinguai, ma le voci generate automaticamente rimangono quelle della lingua predefinita. Dopo \foreignlanguage{english} in un documento scritto in italiano, \chapter produrrà Capitolo.

Si può semplificare il codice sorgente definendo nel preambolo un comando ad hoc (si veda il paragrafo 9.1 a pagina 181) \newcommand{\inglese}[1]{\foreignlanguage{english}{#1}}

6 Per passare da una lingua all’altra esiste anche il comando \selectlanguage{hlinguai}, da usare soltanto quando un lunghissimo tratto di testo è in lingua diversa da quella corrente. Se tra le lingue scelte c’è il francese, va dato \selectlanguage{hlingua principalei} subito dopo \begin{document}.

Documenti multilingue

48

il testo

da usare come segue: \inglese{We have seen that computer programming is an art.}

La struttura logica del contenuto di un testo

4.2

We have seen that computer programming is an art.

la struttura del testo

Lo scopo primario di chi scrive un testo è comunicare idee e conoscenze al lettore, che le comprenderà tanto più quanto meglio sono strutturate, e ne apprezzerà tanto più la struttura quanto più la forma tipografica del documento rispecchia la costruzione logica del suo contenuto [Oetiker et al., 2010].

La struttura interna di un’opera scientifica scritta di grandi dimensioni presenta quasi sempre due elementi costanti: • la suddivisione in “blocchi” di testo di lunghezza variabile, con i blocchi più grandi che contengono quelli più piccoli; • la presenza di altre parti aggiunte (come l’introduzione e le eventuali appendici).

Come riconoscere le sezioni sulla pagina?

Le varie suddivisioni del corpo del testo (elencate nella tabella 5 nella pagina successiva) sono fondamentali per comprenderne l’articolazione del contenuto, e vengono chiamate in generale sezioni. Di seguito le si descrivono brevemente.

• Le sezioni dalla parte al sottoparagrafo sono titolate, eventualmente numerate e precedute e seguite da spazi bianchi verticali.

Capoversi

• Un capoverso è la porzione di testo compresa tra un a capo e quello successivo, con lunghezza e struttura interna variabilissime.

Di solito ha la prima riga rientrata e l’iniziale maiuscola della prima parola.

Enunciati

• Un enunciato è la porzione di testo compresa tra due punti fermi.

Di solito la prima parola ha l’iniziale maiuscola.

A questo proposito si noti che: • il sezionamento del documento rimane a carico dell’autore, perché LATEX non lo fa automaticamente; • è di fondamentale importanza articolare il testo in capoversi, sia per chi scrive sia per chi legge: le informazioni sono meglio articolate e di più facile memorizzazione.

Scrivere capoversi ben strutturati

4.3

comporre i capoversi

Spesso si sottovaluta l’importanza di scrivere un testo ben strutturato, e usando LATEX altrettanto frequentemente si comincia un nuovo capoverso senza nemmeno rendersene conto.

4.3 comporre i capoversi

Tabella 5: Suddivisione tradizionale di un testo scientifico.

Sezione

Lunghezza orientativa

Parte Capitolo Paragrafo Sottoparagrafo Capoverso Enunciato

Imprecisabile Da una decina a un centinaio di pagine Da mezza a una decina di pagine Da poche righe a un paio di pagine Da una a una ventina di righe Da una parola a una decina di righe

49

È molto facile commettere quest’ultimo errore se il testo contiene formule matematiche [Oetiker et al., 2010]. Infatti l’abitudine, diffusa, di lasciare una riga vuota tra la fine di una formula e la prosecuzione del testo, si sconta nel documento finito con altrettanti nuovi capoversi, anche là dove il flusso del discorso non li richiederebbe per nulla.

Cominciare un nuovo capoverso

Con l’ovvia eccezione del primo capoverso di una sezione, per cominciare un nuovo capoverso con LATEX basta lasciare una riga vuota nel codice sorgente (in alternativa, si può dare \par ). Osservando gli esempi che seguono, si cerchi di capire perché a volte la si lascia (alla fine del capoverso), e altre no. (Se non si comprendono ancora tutti i comandi contenuti negli esempi, si leggano interamente questo capitolo e i primi paragrafi del capitolo 5 a pagina 83, e poi si ritorni nuovamente su questo paragrafo.)

\dots quando Einstein propose l’equazione \begin{equation} E = mc^2, \end{equation} che è allo stesso tempo la più nota e la meno compresa formula della Fisica.

\dots che, rispetto ai precedenti, presenta alcuni vantaggi.

La formula \begin{equation} I_\textup{D} = I_\textup{F} - I_\textup{R} \end{equation} costituisce la parte centrale di un modello molto diverso di transistor. \dots

. . . quando Einstein propose l’equazione E = mc2 , (4.1) che è allo stesso tempo la più nota e la meno compresa formula della Fisica.

. . . che, rispetto ai precedenti, presenta alcuni vantaggi.

La formula ID = IF − IR

(4.2)

costituisce la parte centrale di un modello molto diverso di transistor. ...

Per cominciare un nuovo capoverso, si lascia una riga vuota.

50

il testo

\dots da cui segue la legge di Kirchhoff sulle correnti: \begin{equation} \sum_{k=1}^n I_k = 0. \end{equation}

. . . da cui segue la legge di Kirchhoff sulle correnti: n X

Ik = 0.

(4.3)

k=1

La legge di Kirchhoff sulle tensioni può essere ricavata\dots

Non si comincia mai un capoverso con una formula.

Come si riconosce un testo “ben composto”?

La legge di Kirchhoff sulle tensioni può essere ricavata. . .

Terminare un capoverso con una formula in display (si veda il paragrafo 5.1 a pagina 84), come nel terzo degli esempi proposti, è raro, ma comunque lecito. È invece sempre sconsigliabile cominciarlo con una formula matematica di qualunque tipo.

Capoversi giustificati, rientrati e ben riempiti

Un testo “ben composto” si riconosce da alcuni elementi: le righe sono interamente riempite, le parole sono adeguatemente spaziate tra loro e, se necessario, sillabate a fine riga se proprio non ci stanno. I capoversi hanno la prima riga rientrata per facilitare la lettura e non sono solcati dai fastidiosi “ruscelli” (cioè le zone bianche che percorrono la pagina in verticale). Tutto questo, di solito, si ottiene dando a mano le rispettive impostazioni. Con LATEX, invece, non occorre nemmeno pensarci, perché il programma: • giustifica il testo per impostazione predefinita; • riempie la riga con un sofisticatissimo algoritmo di spaziatura tra le parole, evitando così i ruscelli e sillabandole a fine riga soltanto se davvero necessario; • rientra automaticamente la prima riga di ogni capoverso;7 • non aggiunge spazio supplementare tra un capoverso e l’altro.8

I comandi \\ e \newline non vanno

mai usati per cominciare un nuovo capoverso.

Interrompere una riga senza cominciare un nuovo capoverso

In casi particolari può essere necessario interrompere una riga. Per farlo, si usano i comandi \\ oppure \newline , e se ne incomincia una nuova senza iniziare un nuovo capoverso (senza rientro, dunque, come qui).

Si può inserire uno spazio aggiuntivo tra due linee dello stesso capoverso con il comando \\[hlunghezzai], che può essere espressa in una qualunque delle unità di misura tipografiche accettate da LATEX avendo cura di usare il punto come separatore decimale: per esempio, centimetri (cm), millimetri (mm), punti tipografici (pt). Per maggiori dettagli si veda [Beccari, 2010].

7 Se per qualche motivo non si volesse il rientro, basta dare \noindent all’inizio del capoverso.

8 Talvolta, invece, può essere utile inserirlo. I comandi \bigskip , \medskip e \smallskip inseriscono uno spazio verticale la cui ampiezza è in funzione del font utilizzato, mentre il comando \vspace{hlunghezzai} inserisce uno spazio verticale pari a hlunghezzai.

Questo spazio va perso se si trova all’inizio di una pagina: per mantenerlo basta usare la variante asterisco \vspace* (vedi il paragrafo 4.4.2 a pagina 55).

4.3.1 Dividere le parole in fine di riga

4.3 comporre i capoversi

In generale, LATEX cerca di interrompere le righe sempre nel miglior punto possibile. Se, però, non riesce a farlo neppure secondo i suoi severi criteri, le lascia fuoriuscire dal margine destro, avvertendo l’autore con un messaggio di overfull hbox. Queste righe si individuano con difficoltà, ma l’opzione draft di \documentclass risolve il problema, evidenziandole con una spessa riga nera sul margine corrispondente.

L’algoritmo di sillabazione di LATEX funziona correttamente con quasi tutte le parole, ma in particolari circostanze si potrebbe volere una divisione diversa da quella automatica. Con i nomi propri o i tecnicismi come nitroidrossilamminico o macroistruzione, per esempio, a volte si richiede la sillabazione etimologica anziché quella che LATEX esegue di default: “nitro-idrossil-amminico” invece di “ni-troi-dros-si-lam-mini-co” e “ma-cro-istru-zio-ne” invece di “ma-croi-stru-zio-ne”.

In questi casi basta sillabare a mano le parole nell’argomento di \hyphenation dato nel preambolo, separandole con uno spazio ed evitando caratteri speciali e simboli:

51 L’opzione draft di \documentclass

LATEX sillaba correttamente quasi tutte le parole. . .

. . . e permette di suggerire una divisione diversa con \hyphenation.

\hyphenation{nitro-idrossil-amminico ma-cro-istru-zio-ne}

Il comando precedente funziona anche al contrario. Un comando come il seguente \hyphenation{FORTRAN nitro-idrossil-amminico}

sillaba nitroidrossilamminico e Nitroidrossilamminico come viene suggerito nel suo argomento, ma non FORTRAN, Fortran e fortran. Analogamente, \hyphenation forza nella parola qualunque cesura si desideri: se si vuole spezzare la parola melograno soltanto tra melo e grano, si scrive: \hyphenation{melo-grano}

Se la parola in questione compare una sola volta, si può suggerirne la sillabazione direttamente nel testo. Il comando \- spezza la parola nel punto (o nei punti) in cui viene dato, e in quel punto soltanto.

La scoperta dell’acido nitro\-idrossil\-amminico avvenne nel 1896.

La scoperta dell’acido nitroidrossilamminico avvenne nel 1896.

Si noti che anche gli interventi sulla sillabazione, come tutti quelli fatti “a mano” sul documento, dovrebbero essere riservati alla revisione finale immediatamente precedente la stampa. Di fronte a un messaggio di overfull hbox, per esempio, è sempre preferibile tentare di riformulare l’enunciato piuttosto che imporre una sillabazione particolare come prima soluzione al problema.

L’opzione italian di babel definisce il comando "/, utile per andare a capo dopo la barra nelle espressioni che comportano l’alternanza tra due possibilità. La scrittura modulazione"/demodulazione, per esempio, produce modulazione/demodulazione se si trova all’interno di una riga, mentre se si trova in fine di riga viene spezzata in modulazione/ demodulazione.

Sillabare una tantum

\mbox

52

il testo

Il comando

\mbox{htestoi}

serve per scrivere una parola che non si vuole che venga spezzata senza metterla nell’argomento di \hyphenation . Va usato all’occorrenza, magari perché in un certo punto del documento non va bene che la parola sia spezzata, ma altrove sì: Entro l’anno avrò imparato il Fortran. \\ Entro l’anno avrò imparato il \mbox{Fortran}.

Spazio in fine di enunciato

Spazio indivisibile

Entro l’anno avrò imparato il Fortran.

Entro l’anno avrò imparato il Fortran.

Lo spazio tra le parole

Per ottenere capoversi giustificati LATEX inserisce tra le parole spazi di dimensione variabile, e per rendere il testo più leggibile, alla fine di un enunciato inserisce uno spazio leggermente più ampio di quanto farebbe un comune elaboratore di testo. LATEX presuppone che gli enunciati si chiudano con un punto, un punto interrogativo o un punto esclamativo. (Se preceduto da una lettera maiuscola, un punto non viene interpretato come la fine di un enunciato, ma come il punto di un’abbreviazione, e lo spazio supplementare viene omesso.)

Ogni eccezione a queste regole generali deve essere specificata dall’autore: • il carattere \ dato prima di uno spazio produce uno spazio che ignora l’interpunzione; • una tilde ~ produce uno spazio che ignora l’interpunzione e inoltre impedisce l’interruzione della riga.

Si osservi come agisce la tilde nei due esempi seguenti:

\@

Hai letto le dispense del prof.~Beccari? \\ Hai letto le dispense del prof. Beccari?

Hai letto le dispense del prof. Beccari?

Hai letto le dispense del prof.

Beccari?

Il concetto è spiegato nel paragrafo~\ref{sec:par}. \\ Il concetto è spiegato nel paragrafo \ref{sec:par}.

Il concetto è spiegato nel paragrafo 4.3.

Il concetto è spiegato nel paragrafo 4.3.

Come si può notare, per evitare che una riga finisca con un punto (non di fine enunciato) o cominci con un numero, le scritture corrette sono le prime di ciascuna coppia.

Il comando \@ davanti a un punto specifica che quel punto conclude un enunciato anche se si trova dopo una lettera maiuscola. Si confrontino: CEE\@. Poi CE\@. Ora UE\@. \\ CEE. Poi CE. Ora UE.

CEE. Poi CE. Ora UE. CEE. Poi CE. Ora UE.

4.4 sezionare il documento

Come si può osservare, la spaziatura corretta si ottiene con la prima scrittura.9 Si noti che LATEX non comincia automaticamente con l’iniziale maiuscola la parola immediatamente successiva a un punto (di qualunque specie sia), a differenza di quanto accade con la maggior parte degli altri programmi di videoscrittura.

4.3.2 Il pacchetto microtype

Il pacchetto microtype (sfruttabile completamente soltanto compilando con pdfLATEX) migliora il riempimento delle righe abilitando:

53

Microtipografia

• l’espansione dei font, ovvero espande i caratteri sull’asse orizzontale per riempire la riga in modo ottimale; • la protrusione dei caratteri, ovvero permette a certi caratteri di sporgere leggerissimamente a fine riga (di solito segni di punteggiatura e trattini).

Se ne consiglia, perciò, sempre l’uso.

4.3.3 Il rientro della prima riga

La tipografia anglosassone (predefinita in LATEX) non prevede il rientro della prima riga del primo capoverso di una sezione (si veda il paragrafo 4.4). Per ottenerlo, secondo una consuetudine spesso seguita in Italia, basta caricare il pacchetto indentfirst nel modo consueto.

indentfirst

È molto facile strutturare un documento con LATEX (cioè suddividerlo in capitoli, paragrafi, eccetera): basta dare i comandi elencati nella tabella 6 nella pagina seguente, a proposito dei quali si noti quanto segue.

Strutturare un documento

4.4

sezionare il documento

• Tutti i comandi della tabella producono il loro argomento come titolo della sezione.

• I nomi inglesi dei comandi corrispondono a unità di suddivisione del testo in vigore nei Paesi anglosassoni, perciò i falsi amici section e paragraph (e derivati) potrebbero creare qualche difficoltà d’interpretazione. Il comando \section introduce una sezione titolata e numerata corrispondente al nostro paragrafo, mentre \paragraph (in inglese “capoverso”) non corrisponde né al nostro paragrafo (perché produce un titolo non numerato), né al nostro capoverso (che ammette al massimo un titoletto o una breve indi9 Per disabilitare lo spazio aggiuntivo dopo un punto fermo in tutto il documento (come nella tipografia francese), si dà nel preambolo la dichiarazione \frenchspacing .

Se si vuole comporre in questo modo soltanto alcune parti del lavoro, la si può dare direttamente nel corpo principale del testo (in tal caso, non serve più \@ ogni volta).

54

il testo

Tabella 6: I comandi di sezionamento del documento.

Comando

Sezione

\part \chapter \section \subsection \subsubsection \paragraph \subparagraph

Parte Capitolo Paragrafo Sottoparagrafo Sotto-sottoparagrafo Sezione di livello ancora più basso Sezione al più basso livello possibile

cazione). La scelta (infelice) di questi nomi non ne permette una traduzione italiana efficace.10 • In ogni caso, si consiglia per quanto possibile di evitare suddivisioni così fini come quelle individuate dagli ultimi tre comandi della tabella.

Le uniche limitazioni nell’uso di questi comandi sono poste dalla classe article, in cui non è ammesso \chapter (mentre continua a esservi definito \part ) e dalla classe letter, che non prevede alcuna unità di sezionamento. LATEX numera automaticamente le sezioni (tranne le ultime tre della tabella) e, a seconda della classe con cui si sta scrivendo, imposta il corpo dei titoli e lo spazio tra essi e il testo.

4.4.1 Materiale iniziale, principale e finale

\frontmatter, \mainmatter e \backmatter

Oltre ai comandi appena illustrati, la classe book prevede le tre dichiarazioni \frontmatter (“materiale iniziale”), \mainmatter (“materiale principale”) e \backmatter (“materiale finale”) che, date nel corpo del documento, ne controllano formato dei numeri di pagina e numerazione delle sezioni.

A differenza dei comandi della tabella 6, però, queste tre dichiarazioni agiscono al più alto livello possibile e costituiscono una specie di “super-sezionamento”: • \frontmatter non numera i capitoli e numera le pagine con numeri romani minuscoli (i, ii, iii, eccetera); • \mainmatter numera i capitoli e le pagine con numeri arabi (la numerazione della pagine riprende da 1); • \backmatter non numera i capitoli e continua la numerazione araba delle pagine dal materiale principale.

Appendici

Per introdurre le appendici, subito dopo il materiale principale del documento basta dare la dichiarazione \appendix , che cambia i numeri dei capitoli (o dei paragrafi, se la classe impostata è article) in lettere.

4.4 sezionare il documento

Per personalizzare le appendici del documento, esiste il pacchetto appendix (se ne veda la documentazione).

La struttura generale di un libro o di una tesi

Di seguito si propone la struttura generale di un libro o di una tesi di laurea o di dottorato (il simbolo * contraddistingue le sezioni facoltative, mentre ° indica che le sezioni non devono essere presenti nellâ&#x20AC;&#x2122;indice). Lo schema è tratto da [Mori, 2007], cui si rimanda per ogni approfondimento. Si noti che lâ&#x20AC;&#x2122;introduzione può finire tanto nel materiale iniziale (non numerata ma presente nellâ&#x20AC;&#x2122;indice generale, come in questa guida) quanto in quello principale (numerata come un capitolo vero e proprio). â&#x20AC;˘ Frontespizio° â&#x20AC;˘ Colophon° â&#x20AC;˘ Dedica*° â&#x20AC;˘ Sommario*° â&#x20AC;˘ Indice generale° â&#x20AC;˘ Elenco delle figure° â&#x20AC;˘ Elenco delle tabelle° â&#x20AC;˘ Prefazione* â&#x20AC;˘ Ringraziamenti*° â&#x20AC;˘ Introduzione* â&#x20AC;˘ Capitoli interni â&#x20AC;˘ Appendici* â&#x20AC;˘ Acronimi e i glossari* â&#x20AC;˘ Bibliografia â&#x20AC;˘ Indice analitico*

                                                

Materiale iniziale

Materiale principale       

Materiale finale

4.4.2 Lâ&#x20AC;&#x2122;indice generale Il comando

\tableofcontents

produce lâ&#x20AC;&#x2122;indice generale nel punto in cui viene dato. Per ottenerlo, servono due compilazioni successive: la prima scrive il contenuto dellâ&#x20AC;&#x2122;indice nel file .toc (table of contents) e la seconda lo include nel documento.

10 Naturalmente, le stesse considerazioni si possono estendere ai rimanenti comandi \subsection , \subsubsection e \subparagraph .

55

appendix

56

il testo

Varianti asterisco

Di tutti i comandi di sezionamento elencati nella tabella 6 a pagina 54 esiste anche una variante asterisco, formata dal comando e da un asterisco aggiunto alla fine, che genera titoli non numerati e non inclusi nell’indice. Il titolo precedente è stato ottenuto con il comando \subsection*{Varianti asterisco} \addcontentsline

Per mandare nell’indice anche questi titoli (perché asteriscati, per esempio), subito dopo il relativo comando di sezionamento basta scrivere \addcontentsline{toc}{hlivelloi}{htitoloi}

dove: • hlivelloi è il nome del livello di sezionamento (tranne paragraph e subparagraph); • htitoloi è il testo che verrà stampato nell’indice.

Se si volesse far comparire nell’indice il titolo di questa sezione, basterebbe scrivere: \subsection*{Varianti asterisco} \addcontentsline{toc}{subsection}{Varianti asterisco}

Capitoli non numerati e testatine

Si noti che se hyperref è caricato, subito prima di \addcontentsline bisogna dare anche \phantomsection , per evitare possibili errori nei collegamenti ipertestuali e nei segnalibri del documento finito. È decisamente preferibile eliminare le testatine nelle sezioni non numerate, come la prefazione o i ringraziamenti, impostando lo stile di pagina plain (si veda il paragrafo 3.5 a pagina 37) come segue: \chapter*{Prefazione} \pagestyle{plain} ... \chapter{Introduzione} \pagestyle{headings} ...

\markboth

Se comunque le si volessero, si noti che nelle classi standard il comando \chapter* richiede di inserire a mano con \markboth le testatine che si ottengono con lo stile di pagina headings: \markboth{\MakeUppercase{htestatina di sinistrai}}% {\MakeUppercase{htestatina di destrai}}

Per esempio: \chapter*{Prefazione} \markboth{\MakeUppercase{Prefazione}}{\MakeUppercase{Prefazione}}

Se i capitoli non numerati vengono inseriti con l’apposita dichiarazione \frontmatter o se si usano le classi AMS, invece, questo problema non si presenta.

Titoli alternativi nell’indice generale

4.5 le proporzioni di pagina

Nell’indice generale finiscono i titoli che si scrivono nell’argomento dei comandi di sezionamento dati nel documento. Se un titolo è troppo lungo per stare agevolmente nell’indice o si hanno particolari esigenze, lo si può sostituire con un titolo alternativo, da specificare nell’argomento facoltativo degli stessi comandi:

57 Titoli alternativi

\chapter[Leggilo! È emozionante!]{Questo è un titolo lunghissimo e particolarmente noioso}

4.4.3 Miniindici

Quando la struttura di un capitolo è particolarmente complessa, può essere utile stampare il suo indice fra titolo e inizio del testo (come si è fatto in questa guida). Un indice di questo tipo prende il nome di miniindice, e si ottiene automaticamente caricando il pacchetto minitoc:

minitoc

\usepackage[tight,italian]{minitoc}

dove:

• l’opzione tight stringe lo spazio verticale tra le voci del miniindice; • l’opzione italian intesta il miniindice con Indice anziché il predefinito Table of Contents.

La documentazione del pacchetto (particolarmente ponderosa) precisa i comandi da dare nel documento: • prima di \tableofcontents va dato \dominitoc ; • dopo ogni \chapter vanno dati \minitoc e \mtcskip ; • alla fine di ogni \chapter* va dato \adjustmtc (ma soltanto con i comandi asteriscati, per evitare che i miniindici appaiano nel capitolo sbagliato).

4.5

le proporzioni di pagina

4.5.1 Il tormentone dei margini

I margini di pagina in tipografia rivestono funzioni importantissime, tra cui quella di delimitare in modo chiaro il corpo del testo per permettere al lettore di individuarlo senza difficoltà e di maneggiarlo comodamente appoggiando i pollici su uno spazio sufficientemente confortevole [Bringhurst, 1992]. Questa è la ragione principale per cui i margini esterni predefiniti nei documenti impostati per la stampa in fronte/retro sono più ampi di quelli interni, che al lettore appaiono duplicati perché adiacenti [Wilson, 2010].

La maggior parte degli utenti europei, che stampa su carta in formato A4, ritiene troppo ampi i margini predefiniti da LATEX nelle classi standard, e che di conseguenza la pagina non sia sufficientemente

Le classi standard presentano margini asimmetrici per ottime ragioni.

Chi va piano. . .

58

La “regola” di Bringhurst

layaureo

il testo

riempita. Prima di buttarsi nella frenesia dell’ “allarghiamo un po’ questa strettissima pagina”, però, è doveroso riflettere.

I margini di LATEX derivano da convenzioni tipografiche ampiamente verificate e accettate, e mettono l’autore nelle vantaggiose condizioni di potersene servire per ottenere risultati professionali già alla prima compilazione e senza doverci mettere le mani. Modificarli, perciò, significherebbe dover studiare un (bel) po’ di tipografia prima di raggiungere risultati accettabili.

L’esperienza dimostra che leggere diventa tanto più difficile quanti più caratteri ci sono in una singola riga di testo: l’occhio è costretto a compiere movimenti più ampi, e si affatica presto (questo è il motivo per cui quotidiani e riviste sono stampati su più colonne). Robert Bringhurst ha codificato quest’esperienza nella sua celebre “regola”, che considera ottimale il numero di circa 66 caratteri per riga (spazi inclusi), indipendentemente dal font usato [Pantieri, 2007]. L’ampiezza media di un carattere corrisponde al rapporto tra la lunghezza dell’alfabeto latino minuscolo “abcdefghijklmnopqrstuvwxyz” e il numero di lettere che lo compongono (26). Per riempire meglio la pagina, LATEX usa in partenza una riga più lunga del limite stabilito da Bringhurst: è evidente, perciò, come si debbano evitare il più possibile modifiche di questo tipo.

Tuttavia, in alcune circostanze può essere desiderabile o necessaria una copertura della pagina ancora maggiore. Tra i numerosi pacchetti scritti a questo scopo se ne consigliano due, dei quali uno agisce in modo automatico, mentre l’altro richiede una configurazione manuale.

Il pacchetto layaureo (se ne veda la documentazione) mette a disposizione proporzioni di pagina pronte per l’uso e permette di impostare facilmente lo spazio per la rilegatura con la chiave binding. Basta caricarlo nel modo consueto: \usepackage[binding=5mm]{layaureo}

geometry

Il pacchetto, però, è tanto facile da usare quanto “rigido”, perché non lascia all’utente molta autonomia per personalizzare le dimensioni della gabbia del testo. In una parola: o piace o non piace.

Se diventano necessarie proporzioni di pagina ancora diverse da quelle di layaureo (perché la propria facoltà impone un modello di tesi particolare, per esempio), il pacchetto geometry, completamente configurabile, può risolvere il problema.

Si immagini di dover comporre un documento in formato A4 con margini superiore e inferiore di 3 cm, sinistro e destro (che nella stampa in fronte/retro diventano interno ed esterno) di 3,5 cm e di voler destinare alla rilegatura uno spazio di 5 mm. Il codice da scrivere nel preambolo è il seguente: \usepackage[a4paper,top=3cm,bottom=3cm,left=3.5cm,right=3.5cm,% heightrounded,bindingoffset=5mm]{geometry}

Tra le opzioni di geometry, che quando sono così numerose si mettono di solito nell’argomento del comando dedicato \geometry subito dopo aver caricato il pacchetto, si consiglia sempre anche heightrounded, che modifica di poco le dimensioni della gabbia del testo per farle contenere un numero intero di righe.

4.5 le proporzioni di pagina

Si eviti nel modo più assoluto, invece, di modificare comandi interni di LATEX come \textwidth , \oddsidemargin , eccetera, perché la loro azione non tiene in nessun conto le proporzioni di pagina [Fairbairns, 2010; Trettin e Zannarini, 2005].

Per interventi circoscritti a una pagina alla volta, si consiglia il pacchetto changepage.

Talvolta può essere utile indicare al rilegatore dove tagliare il foglio: in coppia con geometry, il pacchetto crop stampa sul documento i crocini di taglio.

59

I comandi interni di LATEX non si modificano mai. changepage crop

4.5.2 Interlinea e riempimento della pagina L’interlinea

L’interlinea standard di LATEX (fissata a uno) garantisce un risultato tipografico ottimale e non andrebbe modificata senza una ragione precisa. Purtroppo, però, esistono editori e regolamenti di facoltà che impongono di scrivere pubblicazioni e tesi in modo non professionale. Per modificarla, si consiglia di caricare il pacchetto setspace, che definisce tre interlinee globali da impostare nel preambolo come segue: • \singlespacing (interlinea singola);

• \onehalfspacing (interlinea 1,5); • \doublespacing (interlinea doppia).

Si può modificare l’interlinea soltanto in alcune parti del documento con gli ambienti singlespace, onehalfspace e doublespace, da usare nel modo consueto.

Se, infine, ne fosse necessaria una ancora diversa, si può risolvere il problema dando nel preambolo il comando standard \linespread{hfattore di scalai}

che moltiplica l’interlinea per il hfattore di scalai. In alternativa, il pacchetto definisce l’ambiente spacing da impostare come \linespread : \begin{spacing}{hfattore di scalai}

h. . .i

\end{spacing}

Il riempimento della pagina In mancanza di istruzioni specifiche, LATEX cerca sempre di riempire per intero l’altezza della pagina. Se non riesce a farlo con il testo, perché non ce n’è abbastanza, “stiracchia” il materiale che ha a disposizione, inserendo spazio aggiuntivo tra i capoversi, oppure dilatando le voci degli elenchi e così via.11 11 Si può disattivare quest’impostazione e ottenere dello spazio bianco a piè di pagina (scelta sconsigliata) scrivendo nel preambolo \raggedbottom .

Interlinee diverse da uno

60

il testo

4.6

caratteri particolari e simboli

4.6.1 Virgolette, tratti e puntini di sospensione Virgolette

In tipografia si usano comunemente tre tipi di virgolette:12 • doppie e basse « » (dette anche «francesi», «caporali» o «a sergente»); • doppie e alte “ ” (dette anche “inglesi”); • semplici e alte o apici ‘ ’.

Virgolette alte e apici

I modi per ottenerle sono molti, e dipendono dalla codifica di input impostata, dall’editor in uso e dalle particolari sequenze di tasti digitate: qui si descriveranno quelli validi con entrambe le opzioni a inputenc considerate in questa guida (si veda il paragrafo 4.1.2 a pagina 45), lasciando scoprire all’autore le alternative. In linea generale, si eviti di aprire le virgolette alte battendo una sola volta il carattere " da tastiera, perché LATEX non lo riconosce durante la compilazione, a differenza di altri programmi. (Si noti, però, che alcuni editor possono essere configurati anche in questo senso.)

Le virgolette alte si scrivono battendo: • due volte ‘ (accento grave, si veda il paragrafo 3.2.3 a pagina 24) oppure due volte " per aprirle e due volte ’ (apostrofo) per chiuderle;

Caporali

• direttamente il carattere corrispondente dalla tastiera (tranne che Nam dui euismod con la ligula, codifica di inputa, ). sodales, Nam dui ligula, fringilla fringilla a,latin1 euismod sodales, sollicitudin sollicitudin vel, vel, wisi. wisi.

Morbi auctor lorem non justo.

Nam lacus libero, pretium at, lobortis 13 Morbi auctor lorem non justo.

Nam lacus libero, pretium at, lobortis ligula, fringilla a, euismod sollicitudin vel, wisi.

GliNam apicidui si ottengono battendo ‘ e ’ unasodales, volta soltanto. vitae, ultricies tellus. aliquet, tortor sed vitae, ultricies et, tellus.

Donec aliquet, tortor sed accumsan accumsan bibendum, Morbi auctor et, lorem nonDonec Nam lacus libero, pretium bibendum, at, lobortis Le virgolette caporali sijusto. scrivono battendo: erat ligula aliquet magna, vitae ornare odio metus a mi.

Morbi ac erat ligula aliquet magna, vitae ornare odio metus a mi.

Morbi ac orci orci vitae, ultricies et, tellus.

Donec aliquet, tortor sed accumsan bibendum, • due volte < mollis. per aprirle e due volteut > massa. per chiuderle; et nisl hendrerit Suspendisse Cras nec ante.

Pelet nisl hendrerit mollis.

Suspendisse ut massa.

Cras nec ante.

Pelerat ligula aliquet magna, vitae ornare odio metus a mi. Morbi ac orci lentesque a nulla.

Cum sociis natoque penatibus et magnis dis partulentesque a nulla.

Cum sociis natoque penatibus et magnis dis partu• "<hendrerit per aprirle e "> per chiuderle ut (si massa. raccomanda questo et nisl mollis.

Suspendisse Cras in nec ante. caso Pelrient montes, nascetur ridiculus mus. tincidunt urna. rient montes, nascetur ridiculus mus. Aliquam Aliquam tincidunt urna.

Nulla la codifica di Cum output T1); natoque lentesque a nulla. sociis penatibus et magnis dis Nulla partuullamcorper vestibulum turpis. cursus luctus ullamcorper vestibulum turpis. Pellentesque Pellentesque cursus luctus mauris. mauris. rient nascetur ridiculus mus. Aliquam tincidunt • montes, direttamente il carattere corrispondente da tastieraurna. (nei Nulla modi ullamcorper vestibulum turpis.

Pellentesque cursus luctus mauris. propri di ogni sistema operativo).

La La Delta Delta di di La Delta di Dirac Dirac èè una una ‘‘funzione impropria’’. ‘‘funzione impropria’’. ‘‘funzione impropria’’.

La Delta di Dirac è una ‘‘funzione impropria’’.

<<Se Ermanno, <<Se stavi stavi attento, <<Se stavi attento, attento, Ermanno, Ermanno, <<Se stavi attento, Ermanno, capivi tutto anche tu.>> capivi tutto capivi tutto anche tu.>> <<Se stavi attento, Ermanno, capivi tutto anche tu.>> capivi tutto anche tu.>>

Ora chiaro Ora dovrebbe dovrebbe Ora dovrebbe essere essere chiaro chiaro il il concetto concetto di il concetto di Ora dovrebbe essere chiaro ‘composizione ‘composizione asincrona’. ‘composizione asincrona’. il concetto di

La La Delta Delta di di Dirac Dirac èè una una “funzione “funzione impropria”. impropria”.

La Delta di Dirac è una ““funzione ciao ” ‘ ciao ’ impropria”. “ ciao ” ‘ ciao ’

«Se «Se stavi stavi attento, attento, Ermanno, Ermanno, capivi capivi «Se stavi attento, Ermanno, capivi tutto anche tu.» tutto anche tu.»

«Se attento, tuttostavi anche tu.» Ermanno, capivi tutto anche tu.»

Ora Ora dovrebbe dovrebbe essere essere chiaro chiaro ilil concon-

di asincrona’. cetto di “ cetto ciao ” ‘composizione ‘‘composizione ciao“essere ’ ciao chiaro ”asincrona’. ‘ ciao ’ Ora dovrebbe il concetto di ‘composizione asincrona’.

‘composizione asincrona’.

12 Si Nam noti che neligula, esiste un quarto tipo, le virgolette semplicisollicitudin e basse ‹ › (che in wisi. alcudui fringilla a, sodales, vel, Nam dui ligula, fringilla a, euismod euismod sodales, sollicitudin vel, wisi. ne tradizioni tipografiche possono apparire rovesciate › ‹), poco usato nella tipografia Morbi lorem non Nam libero, pretium lobortis Morbi auctor loremfringilla non justo. justo.

Nam lacus lacus libero,sollicitudin pretium at, at,vel, lobortis Namauctor dui ligula, a, euismod sodales, wisi. italiana. vitae, ultricies et, tellus.

Donec aliquet, tortor sed accumsan bibendum, vitae, ultricies et, tellus.

Donec aliquet, tortor sed accumsan bibendum, 13 Si noti che per esigenze le virgolette alte e libero, gli apici pretium di questo paragrafo soMorbi auctor lorem didattiche non justo.

Nam lacus at, lobortis erat ligula aliquet magna, vitae ornare odio metus aa mi.

Morbi ac orci no composti con ilet, font Computer Modern, perché i font in accumsan uso nel resto della erat ligula aliquet magna, vitae ornare odio metus mi.

Morbi acguida orci vitae, ultricies tellus.

Donec aliquet, tortor sed bibendum, restituiscono le virgolette alte aperte e chiuse in ut modo molto simile. et nisl mollis.

Suspendisse Cras et nisl hendrerit hendrerit mollis.

Suspendisse ut massa. massa.

Cras nec nec ante. ante. PelPel-

erat ligula aliquet magna, vitae ornare odio metus a mi. Morbi ac orci lentesque aa nulla.

Cum natoque magnis lentesque nulla.mollis.

Cum sociis sociis natoque penatibus penatibus et magnis dis partupartuet nisl hendrerit Suspendisse ut massa. et Cras nec dis ante.

Pelrient montes, nascetur ridiculus mus.

Aliquam tincidunt urna.

Nulla rient montes, nascetur ridiculus mus.

Aliquam tincidunt urna.

Nulla lentesque a nulla. Cum sociis natoque penatibus et magnis dis partuullamcorper turpis. cursus luctus mauris. ullamcorper vestibulum turpis. Pellentesque Pellentesque cursus luctusurna. mauris. rient montes,vestibulum nascetur ridiculus mus. Aliquam tincidunt Nulla ullamcorper vestibulum turpis. Pellentesque cursus luctus mauris.

Trattini, tratti e lineette

4.6 caratteri particolari e simboli

61

La tipografia distingue quattro tipi di tratto: tre corrispondono a un diverso numero di trattini consecutivi, mentre il quarto è il segno matematico “meno”. Se ne danno l’elenco e il modo per ottenerli: • il trattino (hyphen) - si ottiene battendo - una sola volta; • il tratto (en-dash) – si ottiene battendolo due volte; • la lineetta (em-dash) — si ottiene battendolo tre volte; • il segno meno − si ottiene battendo un trattino in modo matematico (si veda il paragrafo 5.1.3 a pagina 86).

L’esempio seguente illustra i quattro tipi di tratto appena considerati: Stratford-on-Avon, e-mail \\ p.~13-67, 1921-1928 \\ Ottica~--~Schema generale \\ ---~Eccomi,~---~disse. \\ $0$, $1$ e $-1$

Stratford-on-Avon, e-mail p. 13-67, 1921-1928 Ottica – Schema generale — Eccomi, — disse.

0, 1 e −1

Puntini di sospensione Se inseriti battendo tre punti consecutivi, i puntini di sospensione potrebbero compromettere la spaziatura delle parole o la corretta interruzione di riga. LATEX risolve il problema con il comando \dots , che li stampa correttamente spaziati e li tiene uniti in ogni caso: Non così... ma così: \\ Londra, Parigi, Berlino\dots

...

Non così... ma così: Londra, Parigi, Berlino. . .

Per indicare l’omissione di una parola o di una porzione di testo originale, si può usare il segno di omissione [. . .] definendo nel preambolo un comando ad hoc \omissis (vedi il paragrafo 9.1 a pagina 181):

Omissis

\newcommand{\omissis}{[\textellipsis\unkern]}

Si noti che \dots e \omissis sono comandi “che producono testo”: si ricordi di separarli dalla parola seguente forzando uno spazio nei modi consueti (\omissis{} , per esempio).

4.6.2 Riferimenti ipertestuali, indirizzi Internet e di posta elettronica

Il pacchetto hyperref (che di regola va caricato per ultimo), abilita i riferimenti ipertestuali all’interno di un documento compilato con pdfLATEX (si veda il paragrafo 2.2 a pagina 12): \usepackage{hyperref}

Si può personalizzare in modo fine il comportamento del pacchetto, mettendone le opzioni nell’argomento facoltativo del comando di chiamata: \usepackage[hchiavei=hvalorei,h. . .i]{hyperref}

hyperref

62

il testo

oppure di \hypersetup , in una riga di codice a sé: \usepackage{hyperref} \hypersetup{hchiavei=hvalorei,h. . .i}

Opzioni di hyperref

Si elencano di seguito le sue opzioni principali.

• bookmarks=true, bookmarks=false mostra o nasconde la barra dei segnalibri, rispettivamente (il valore predefinito è true); • unicode=true, unicode=false permette di usare caratteri di lingue non latine (il valore predefinito è false); • pdftoolbar=true, pdftoolbar=false mostra o nasconde la barra degli strumenti (il valore predefinito è true); • pdfmenubar=true, pdfmenubar=false mostra o nasconde la barra dei menu (il valore predefinito è true); • pdffitwindow=true, pdffitwindow=false regola l’ingrandimento iniziale del pdf (il valore predefinito è true); • pdftitle=htitoloi definisce il titolo che si vuole far comparire nella finestra Informazioni del visualizzatore di pdf; • pdfauthor=hautorei imposta il nome dell’autore del documento; • pdfnewwindow=true, pdfnewwindow=false stabilisce se aprire o meno una nuova finestra in caso di collegamento esterno (il valore predefinito è true); • colorlinks=true, colorlinks=false circonda i collegamenti con riquadri colorati (false, predefinito) o colora il loro testo (true) secondo le opzioni di configurazione seguenti: – linkcolor=hcolorei imposta il colore dei collegamenti interni, come sezioni e pagine (il valore predefinito è red); – citecolor=hcolorei definisce il colore dei collegamenti ai riferimenti bibliografici (il valore predefinito è green); – filecolor=hcolorei determina il colore dei collegamenti a file (il valore predefinito è magenta); – urlcolor=hcolorei stabilisce il colore dei collegamenti a siti Web (il valore predefinito è cyan).

Segnalibri e collegamenti colorati

Per avere segnalibri e collegamenti colorati si scrive \usepackage[bookmarks,colorlinks]{hyperref}

(i valori =true possono essere omessi).

Se si desidera semplicemente indicare autore e titolo del documento per farli comparire nella finestra Informazioni del visualizzatore di pdf, si scrive \usepackage[pdfauthor={Lorenzo Pantieri},% pdftitle={L’arte di scrivere con LaTeX}]{hyperref}

4.6 caratteri particolari e simboli

Stampando in bianco e nero, i collegamenti colorati vengono resi con sfumature di grigio, a volte poco leggibili: si risolve il problema racchiudendoli in riquadri, che invece non vengono stampati:

63

Riquadri

\usepackage{hyperref} \hypersetup{colorlinks=false}

In alternativa si possono lasciare i collegamenti in nero: \usepackage{hyperref} \hypersetup{colorlinks,% citecolor=black,% filecolor=black,% linkcolor=black,% urlcolor=black}

Oltre ai collegamenti automatici per i riferimenti incrociati, si possono realizzare collegamenti espliciti al Web con il comando \href

Collegamenti a siti Web. . .

\href{hindirizzo Interneti}{htesto del collegamentoi}

Scrivendo Visita il sito del \href{http://www.guit.sssup.% it/}{\GuIT*}.

Visita il sito del guIt.

basta cliccare sul logo guIt per accedere al sito omonimo.

Con lo stesso comando si crea il collegamento a un file locale: Il documento completo è \href{manuale.pdf}{qui}.

Il documento completo è qui.

Un clic su qui aprirà il file manuale.pdf (il percorso del file è relativo alla posizione del documento corrente).

Il pacchetto url (caricato automaticamente da hyperref) definisce il comando \url , utile per scrivere un indirizzo Internet: \url{http://profs.sci.univr.% it/~gregorio/}

Indirizzi Internet

http://profs.sci.univr.it/ ~gregorio/

Per i collegamenti a un indirizzo di posta elettronica conviene definire nel preambolo un apposito comando \mail (si veda il paragrafo 9.1 a pagina 181), \newcommand{\mail}[1]{\href{mailto:#1}{\texttt{#1}}}

da usare come segue: \mail{sit6113@iperbole.% bologna.it}

. . . e a file locali

sit6113@iperbole.bologna.it

@

64

il testo

Tabella 7: Loghi di uso frequente.

Comando

Risultato

Descrizione

\TeX \LaTeX \LaTeXe \AmS \MF \MP \GuIT , \GuIT* \Ars

TEX LATEX LATEX 2ε AMS METAFONT METAPOST guIt, guIt ArsTEXnica

Il “motore” di LATEX Il nome del gioco L’attuale versione di LATEX American Mathematical Society Programma per disegnare font Strumento per generare grafici con LATEX Gruppo Utilizzatori Italiani di TEX e LATEX La rivista del guIt

I segnalibri

Aggiungere un segnalibro

I segnalibri (bookmark) sono voci (di regola, elencate verticalmente in una barra laterale del visualizzatore di pdf) che indicano i livelli di sezionamento e altri punti importanti del documento: un clic su un segnalibro porta direttamente al punto corrispondente del pdf, che in questo modo può essere consultato più velocemente.

L’opzione bookmarks di hyperref genera automaticamente i segnalibri relativi alle voci dell’indice generale (capitoli, paragrafi, eccetera), comprese quelle inserite a mano con \addcontentsline .

Per aggiungere alla barra un segnalibro supplementare, si scrive \pdfbookmark[hlivelloi]{htesto del segnalibroi}{hetichettai}

nel punto esatto in cui si vuole che il segnalibro compaia, dove: • hlivelloi è un numero intero che indica il livello di sezionamento (capitolo, paragrafo, eccetera) in corrispondenza del quale il segnalibro verrà collocato nella barra (nelle classi book o report questo numero vale -1 per le parti, 0 per i capitoli, 1 per i paragrafi, e così via; nella classe article vale 0 per le parti, 1 per i paragrafi, 2 per i sottoparagrafi, e così via). Se non si specifica alcun hlivelloi, è come se si desse 0.

• htesto del segnalibroi si spiega da sé.

• hetichettai è una stringa univoca che permette di riferirsi al segnalibro da un punto qualsiasi del documento.

La versione elettronica di questa guida contiene un segnalibro Prefazione così definito: \pdfbookmark[1]{Prefazione}{prefazione}

Inconvenienti con i segnalibri

Per scrivere il htesto del segnalibroi non si possono usare tutti i caratteri che LATEX mette di solito a disposizione. Il codice seguente evita gli inconvenienti di una sequenza particolare: \texorpdfstring{htesto del documentoi}{htesto del segnalibroi}

Il codice \section{La funzione \texorpdfstring{$\Gamma$}{Gamma}}

4.6 caratteri particolari e simboli

Tabella 8: Accenti e caratteri particolari. \ ‘o \ ’o

ò ó

\u{o} \t{o}

o˘

o

\~o \r{o}

õ o˚

\.o \d{o}

o˙ o.

\^o \v{o}

ô oˇ

\"o \H{o}

ö o˝

\c{o} \k{o}

o¸ o˛

\=o \b{o}

\OE \oe

Œ œ

\AE \ae

Æ æ

\AA \aa

Å å

\O \o

o¯ o ¯ Ø ø

\L \l

Ł ł

\DH \dh

Ð ð

\DJ \dj

Ð d¯

\TH \th

Þ þ

65

stampa \section{La funzione $\Gamma$} come La funzione Gamma nell’area del segnalibro.

Scrivendo il documento con la codifica utf8 e impostando analogamente anche hyperref (opzione unicode con la lettera minuscola), si possono usare anche per i segnalibri i caratteri Unicode, molto più numerosi di quelli standard.

Per una gestione più fine dei segnalibri si segnala il pacchetto bookmarks, da caricare dopo hyperref (se ne veda la documentazione).

4.6.3 Loghi, accenti, caratteri particolari, apici e pedici Loghi

La tabella 7 a fronte elenca i comandi per stampare i loghi più comuni. Si noti che AMS richiede il pacchetto amsmath, mentre METAFONT e METAPOST richiedono il pacchetto mflogo, e guIt, guIt e ArsTEXnica richiedono il pacchetto guit.

Accenti e caratteri particolari

LATEX permette di usare gli accenti e i caratteri particolari di molte lingue (nella tabella 8 sono esemplificati per la lettera o, ma funzionano anche per tutte le altre lettere), come si può vedere nell’esempio seguente: H\^otel, na\"if, Stra\ss e, !‘Se\~norita!, élève, Sm\o rrebr\o d, z\l oty.

Hôtel, naïf, Straße, ¡Señorita!, élève, Smørrebrød, złoty.

Il simbolo dell’euro (e) si ottiene con il comando \euro del pacchetto eurosym.

L’opzione italian di babel definisce una coppia di comandi che stampano il loro argomento in tondo anche in modo matematico. In modo testuale, inoltre, mantengono anche lo stile corrente, qualunque sia: • \ap{htestoi} stampa un apice (in alternativa, esiste il comando standard \textsuperscript{htestoi}), come nelle abbreviazioni oggi in disuso sig.ra o f.lli ; • \ped{htestoi} stampa un pedice, utile per qualche sostanza chimica, come la vitamina B12 , per esempio.

e

66

\maketitle

il testo

Per l’elenco completo di tutti i simboli e i caratteri speciali di LATEX (quasi 6000), si veda [Pakin, 2009].

4.7

titoli e frontespizi

Titoli standard Il comando

\maketitle

dato dopo \begin{document} stampa il titolo del documento. Gli elementi che lo costituiscono vengono definiti nel preambolo dai comandi \title{htitoloi} \author{hautorei} \date{hdatai}

Il loro funzionamento si spiega da sé, ma si osservi quanto segue: • un htitoloi troppo lungo per stare su una sola riga va spezzato con \\; • i vari hautorei di un documento scritto a più mani si separano con \and ; • LATEX stampa come predefinita la hdatai della compilazione anche se \date non viene dato, mentre la omette se si lascia vuoto il suo argomento (\date{}).

Grazie a. . .

Per inserire ringraziamenti veloci, si usa il comando \thanks{hringraziamentii}

che può essere dato indifferentemente dentro l’argomento: • di \title , per associargli il nome dell’ente che finanzia il progetto; • di \author , per specificare l’istituzione cui appartengono gli autori o per ringraziare qualcuno; • di \date , per indicare il numero di versione del documento.

Ecco un esempio: \author{Lorenzo Pantieri\thanks{Ringrazio i membri del \GuIT.}}

Nelle classi AMS \thanks va invece dato in una riga a sé, fuori dai tre comandi appena considerati.14 Nella figura 5 a pagina 23 si può trovare un esempio di alcuni dei comandi sopra citati.

4.7 titoli e frontespizi

67

Universit` a degli Studi di Paperopoli ` DI PENNUTOLOGIA FACOLTA Corso di Laurea Magistrale in Belle Lettere

Tesi di laurea magistrale

La mia tesi: una lunga serie di risultati difficilissimi e complicatissimi Alcune considerazioni mutevoli

Candidato:

Relatori:

Paperino Paolino

Giovanni Episcopo Pippo Cluvio

Matricola PP999999

Correlatori:

Ugo Frogio Ubaldo Kutuzu

Anno Accademico 2030–2031

Frontespizi

Figura 7: Esempio d’uso del pacchetto frontespizio.

Il titolo generato dal comando \maketitle , si deve riconoscere, è piuttosto spartano, anche se negli articoli e nelle relazioni può essere accettabile. Si consiglia di comporre il frontespizio di una tesi di laurea o di dottorato con il pacchetto frontespizio (si veda la figura 7), accompagnato da un’esauriente documentazione (in italiano). Oltre ai comandi per inserire tutti i dati che di solito trovano posto in una pagina di questo tipo, il pacchetto prevede opzioni per l’uso di caratteri senza grazie e l’inserimento di loghi universitari e immagini in filigrana.

In alternativa si può usare la suite ClassicThesis, che fornisce un modello di tesi pronto per l’uso completo di frontespizio [Pantieri, 2007].

Infine, se proprio nessuna delle soluzioni precedenti va bene, si può comporre un frontespizio personalizzato con l’ambiente titlepage (da aprire subito dopo \begin{document}) all’interno del quale si è completamente padroni dell’impaginazione.

Di seguito se ne mostra un semplice esempio. (Si noti che corpo dei titoli e bilanciamento degli spazi verticali sono puramente indicativi: qualche prova permetterà di raggiungere un risultato ottimale.) \frontmatter \begin{titlepage} \centering {\large Lorenzo Pantieri \par} \vspace{\stretch{1}} {\Huge L’arte di scrivere con \LaTeX \par}

14 Nelle classi standard e KOMA-Script \thanks funziona come \footnote (si veda il paragrafo 4.9 a pagina 69), producendo una nota a piè di pagina con un simbolo in apice.

frontespizio

titlepage

68

il testo

\vspace{24pt} {\huge Un’introduzione a \LaTeXe \par} \vspace{\stretch{2}} {\small Gruppo Utilizzatori Italiani di \TeX{} e \LaTeX \par} \end{titlepage}

Dove: • \par equivale a una riga vuota e si usa spesso per rendere più facili da leggere i nuovi ambienti e i nuovi comandi; • \vspace{hlunghezzai} aggiunge nel punto in cui viene dato uno spazio verticale uguale a hlunghezzai; • \stretch{hnumeroi}, se usato in coppia con un altro comando uguale, regola il rapporto dello spazio verticale da lasciare tra gli elementi del frontespizio; • pt è il punto tipografico.

Etichette e riferimenti

4.8

riferimenti incrociati

Nei documenti si trovano spesso riferimenti incrociati a sezioni, figure, tabelle, teoremi e particolari porzioni di testo. Per realizzarli si usano i comandi standard \label{hetichettai} \ref{hetichettai} \pageref{hetichettai}

dove: • hetichettai è un identificatore univoco scelto dall’utente, il cui formato, libero in teoria, in pratica è l’abbreviazione della sezione o dell’oggetto (sec per una sezione, fig per una figura, tab per una tabella, eccetera) seguita da : e da una parola chiave che caratterizza l’oggetto cui ci si riferisce;15 • \ref stampa il numero della sezione o dell’oggetto indicato in hetichettai; • \pageref si comporta come \ref , stampando però il numero di pagina.

Proprio come per l’indice, per attivare i riferimenti incrociati nel documento sono necessarie due compilazioni successive.

Per esempio, se si identifica questo paragrafo con \section{Riferimenti incrociati} \label{sec:ref}

poi si può far riferimento a esso con 15 Si noti che se si scrive in francese si sconsiglia di mettere i due punti nelle etichette.

4.9 note a margine e a piè di pagina

Ecco un riferimento a questo paragrafo: ‘‘si veda il paragrafo~\ref{sec:ref}’’.

69

Ecco un riferimento a questo paragrafo: “si veda il paragrafo 4.8”.

Molto spesso, specialmente quando il riferimento si trova a una o più pagine di distanza dall’oggetto, è utile avere un’indicazione completa anche del numero di pagina. Il pacchetto varioref risolve questo problema, definendo un comando \vref che riunisce in sé le funzioni dei precedenti \ref e \pageref . Per adattare i riferimenti addizionali alla lingua principale del documento, bisogna specificarla nell’argomento facoltativo del comando:

Riferimenti completi della pagina: il pacchetto varioref

\usepackage[italian]{varioref}

A questo punto, \vref si usa come segue: Si veda il paragrafo~\vref{sec:titolo}.

4.9

Si veda il paragrafo 4.7 a pagina 66.

note a margine e a piè di pagina

Note a margine

Una nota a margine si ottiene molto semplicemente con il comando

\marginpar{htesto della nota a marginei}

Nei documenti impostati per la stampa in fronte/retro, le note vengono stampate nel margine destro nelle pagine dispari e nel margine sinistro in quelle pari. Nei documenti solo fronte, invece, le note vengono stampate sempre nel margine destro. (Talvolta può accadere che una nota appaia nel margine sbagliato: per rimediare a questo piccolo difetto di LATEX, basta caricare il pacchetto mparhack.)

Le note a margine danno un tocco di vitalità alla pagina.

mparhack

Note a piè di pagina Il comando

\footnote{htesto della nota a piè di paginai}

stampa una nota in fondo alla pagina corrente. Le note a piè di pagina (di cui è bene non abusare) dovrebbero essere poste, per quanto possibile, alla fine del relativo capoverso, dopo il punto fermo.16 Le note a piè di pagina sono l’emblema della meticolosità.\footnote{Questo ne è un esempio.}

Le note a piè di pagina sono l’emblema della meticolosità.a a Questo ne è un esempio.

LATEX produce note al piede di alta qualità, ma quando circostanze particolari le richiedono in un formato diverso da quello predefinito basta caricare il pacchetto footmisc e configurarlo opportunamente (se ne veda la documentazione).

16 Così.

footmisc

70

il testo

4.10

evidenziare le parole

Scrivendo a macchina, le parole importanti si evidenziano con una sottolineatura; in tipografia, invece, le parole si evidenziano stam-

pandole in corsivo. Per evidenziare una parola o una porzione di testo, LATEX definisce il comando standard \emph{htestoi}

la cui azione effettiva dipende dal contesto. \emph{All’interno di un testo già evidenziato, \LaTeX{} evidenzia ulteriormente con il \emph{font normale}.}

Differenza logica tra corsivo ed evidenziato

All’interno di un testo già evidenziato, LATEX evidenzia ulteriormente con il font normale.

Esiste anche un altro comando standard, \textit , che mette in corsivo il proprio argomento in ogni caso. Per cogliere la differenza tra i due ruoli logici del corsivo e dell’evidenziato, si osservino le due scritture: \emph{Sono qui in \textit{dieci} minuti.} \textit{Sono qui in \emph{dieci} minuti.}

4.11

Sono qui in dieci minuti.

Sono qui in dieci minuti.

ambienti

4.11.1 Elenchi puntati, numerati e descrizioni

In un documento gli elenchi sono molto importanti. Permettono, infatti: • di “dare respiro” al testo; • di migliorarne la leggibilità; • di strutturare le proprie idee.

Elenchi puntati

L’elenco precedente è stato ottenuto con l’ambiente itemize come segue: Gli elenchi permettono: \begin{itemize} \item di ‘‘dare respiro’’ al testo; \item di migliorarne la leggibilità; \item di strutturare le proprie idee. \end{itemize}

Gli elenchi permettono: • di “dare respiro” al testo; • di migliorarne la leggibilità; • di strutturare le proprie idee.

Il comando \item premesso a ogni elemento dell’elenco stampa un pallino nero. Si noti come il rientro degli item renda il codice più ordinato e permetta di individuare più facilmente l’elenco.

4.11 ambienti

L’ambiente enumerate si usa come itemize, ma qui a ogni elemento \item premette un numero: \begin{enumerate} \item Mane; \item Tekel; \item Fares. \end{enumerate}

Elenchi numerati

1. Mane; 2. Tekel; 3. Fares.

L’ambiente description si usa per le descrizioni, elenchi in cui il segno distintivo non è né un simbolo né un numero, ma una parola o un’espressione che s’intende descrivere o spiegare, da indicare nell’argomento facoltativo (in questo caso, però, obbligatorio) di \item : \begin{description} \item[itemize] Per gli elenchi puntati. \item[enumerate] Per gli elenchi numerati. \item[description] Per gli elenchi in cui ogni elemento comincia con un testo a piacere. \end{description}

71

Descrizioni

itemize Per gli elenchi puntati. enumerate Per gli elenchi numerati. description Per gli elenchi in cui ogni elemento comincia con un testo a piacere.

Si noti che LATEX mette automaticamente in rilievo l’argomento, in accordo con le impostazioni generali della classe di documento corrente.

LATEX permette l’annidamento degli ambienti (e dunque anche degli elenchi), purché l’ordine di chiamata venga rispettato.

Annidare gli elenchi

\begin{haaai} ... \begin{hbbbi} ... \end{hbbbi} ... \end{haaai}

Ecco un esempio di elenchi annidati: \begin{enumerate} \item sono facili da usare; \item rendono più chiaro il testo: \begin{itemize} \item spaziandolo; \item facilitandone la lettura; \end{itemize} \item permettono di strutturare meglio le proprie idee. \end{enumerate}

1. sono facili da usare; 2. rendono più chiaro il testo: • spaziandolo; • facilitandone la lettura; 3. permettono di strutturare meglio le proprie idee.

Di seguito si riportano alcune convenzioni tipografiche comunemente seguite per comporre gli elenchi (sono le stesse che si sono osservate in questa guida):

Convenzioni tipografiche per gli elenchi

72

il testo

• ogni elemento di un elenco semplice (i cui elementi sono costituiti da un solo enunciato) comincia di solito con l’iniziale minuscola della prima parola e termina con un punto e virgola, a eccezione dell’ultimo, che termina con un punto fermo;

• ogni elemento di un elenco complesso (in cui almeno uno degli elementi sia composto da più di un enunciato) comincia di solito con l’iniziale maiuscola della prima parola (anche dopo il segno di due punti) e termina con il punto fermo.

Personalizzare gli elenchi: il pacchetto enumitem

Si noti che non bisogna per forza uniformare tutti gli elenchi di un documento a criteri stabiliti a priori: l’importante è essere coerenti volta per volta.

Per personalizzare gli elenchi c’è il pacchetto enumitem (se ne veda la documentazione). L’opzione “locale” noitemsep elimina la spaziatura verticale tra le voci dell’elenco predefinita dagli ambienti standard.

Un elenco senza spaziatura verticale: \begin{itemize}[noitemsep] \item Mane; \item Tekel; \item Fares. \end{itemize}

Un elenco senza spaziatura verticale: • Mane; • Tekel; • Fares.

L’opzione locale leftmargin=* allinea le voci dell’elenco al margine sinistro anziché rientrarle: Un elenco non rientrato: \begin{itemize}[leftmargin=*] \item Mane; \item Tekel; \item Fares. \end{itemize}

Un elenco non rientrato: • Mane; • Tekel; • Fares.

4.11.2 Allineare e centrare i capoversi

LATEX mette a disposizione tre ambienti standard per allineare un capoverso (a sinistra o a destra) o per centrarlo sulla pagina. Le righe di testo vanno a capo automaticamente, a meno di un’interruzione esplicita con \\. \begin{flushleft} Questo testo è allineato a \\ sinistra. \LaTeX{} non cerca di creare righe di uguale lunghezza. \end{flushleft} \begin{flushright} Questo testo è allineato a \\ destra. \LaTeX{} non cerca di creare righe di uguale lunghezza. \end{flushright}

Questo testo è allineato a sinistra. LATEX non cerca di creare righe di uguale lunghezza.

Questo testo è allineato a destra. LATEX non cerca di creare righe di uguale lunghezza.

\begin{center} Al centro \\ dell’universo. \end{center}

4.11 ambienti

73

Al centro dell’universo.

La dedica Non esistono regole tipografiche vincolanti per stampare la dedica in una pubblicazione, se non il gusto e le esigenze dell’autore. In linea generale, se di dimensioni contenute si colloca orizzontalmente sulla pagina con uno degli ambienti appena considerati.

Altrettanto libero ne è il collocamento in verticale, che si può controllare con una coppia di comandi \vspace*{\stretch{h. . .i}}, per esempio. Se si desidera una dedica spostata a destra e collocata a un terzo della pagina (ovvero in modo che lo spazio che la segue sia il doppio di quello che la precede), basta scrivere:

Collocare la dedica sulla pagina

\frontmatter \cleardoublepage \vspace{\stretch{1}} \begin{flushright} Ai miei cari. \end{flushright} \vspace{\stretch{2}} \cleardoublepage

4.11.3 Citazioni e intercitazioni

Esistono due modi per scrivere le citazioni con LATEX: “in linea” e “in display”.

Citazioni “in linea” Una citazione “in linea” è un’espressione composta di uno o due enunciati al massimo e segnalata da virgolette del tipo scelto che LATEX incorpora nel testo, come quando si cita il motto kantiano «il cielo stellato sopra di me, la legge morale dentro di me».

Una citazione in linea è un’espressione che \LaTeX{} incorpora nel testo: «il cielo stellato sopra di me, la legge morale dentro di me».

Citare “in linea”. . .

Una citazione in linea è un’espressione che LATEX incorpora nel testo: «il cielo stellato sopra di me, la legge morale dentro di me».

Citazioni “in display” Una citazione “in display” è un testo più o meno lungo che LATEX compone su linee a sé, separate dal testo precedente e seguente con spazi bianchi di ampiezza adeguata per “metterlo in mostra” e farlo risaltare sulla pagina. L’esempio in linea del paragrafo precedente diventa, allora: Il cielo stellato sopra di me, la legge morale dentro di me.

. . . e “in display”

74

quote e quotation

il testo

Come si può osservare, ora la citazione è centrata e separata dal resto del testo.

LATEX mette a disposizione due ambienti standard per le citazioni in display, quote e quotation, che si comportano quasi allo stesso modo: stampano il testo su righe più brevi di quelle correnti, lo giustificano su entrambi i margini e cominciano un nuovo capoverso lasciando una riga bianca nel testo sorgente. L’unica differenza tra i due è che quotation rientra ogni capoverso compreso il primo, per cui se ne consiglia l’uso per citazioni consistenti.

Le convenzioni tipografiche delle citazioni in display prevedono inoltre che il testo citato venga stampato con un corpo più piccolo di quello corrente. Siccome gli ambienti appena esaminati non soddisfano del tutto quest’esigenza, è conveniente definire nel preambolo un nuovo ambiente citazione (si veda il paragrafo 9.1 a pagina 181) \newenvironment{citazione} {\begin{quotation}\small} {\end{quotation}}

da usare nel modo consueto, che permette di ottenere un risultato come il seguente: Una citazione in display è un testo che \LaTeX{} compone su linee a sé: \begin{citazione} Il cielo stellato sopra di me, la legge morale dentro di me. \end{citazione} Come si può osservare, la citazione è centrata e separata dal resto del testo.

Una citazione in display è un testo che LATEX compone su linee a sé: Il cielo stellato sopra di me, la legge morale dentro di me.

Come si può osservare, la citazione è centrata e separata dal resto del testo.

Intercitazioni Le intercitazioni, cioè le citazioni dentro altre citazioni, si mettono tra virgolette diverse da quelle scelte per le citazioni di primo livello.

Sempre caro. . .

4.11.4 Poesie

Per scrivere poesie LATEX mette a disposizione l’ambiente standard verse, nel quale: • i margini vengono aumentati come per le citazioni; • ogni verso deve finire con \\, tranne l’ultimo di ogni strofa; • le strofe vengono separate automaticamente tra loro con dello spazio bianco.

L’esempio seguente mostra l’ambiente all’opera:

La seguente poesia \emph{La sera} è di Fabiano Busdraghi. \begin{verse} Il sole è già svanito \\ dietro le colline scure \\ e i chiarori del giorno \\ s’avvolgono d’ombra.

Tutto si assopisce: \\ le tracce di nubi \\ il volo di una rondine \\ i miei ulivi grigi\dots e la luce \\ si adagia quieta \\ e come saggia \\ sulla campagna \\ silenziosa. \end{verse}

4.11 ambienti

75

La seguente poesia La sera è di Fabiano Busdraghi.

Il sole è già svanito dietro le colline scure e i chiarori del giorno s’avvolgono d’ombra.

Tutto si assopisce: le tracce di nubi il volo di una rondine i miei ulivi grigi. . . e la luce si adagia quieta e come saggia sulla campagna silenziosa.

Per esigenze poetiche più avanzate è utile il pacchetto verse (se ne veda la documentazione).

4.11.5 Codici e algoritmi

Talvolta bisogna scrivere nel documento frammenti o “pezzi” di testo più consistenti in modo verbatim (“alla lettera”), cioè mettendo in evidenza il linguaggio di programmazione con cui sono stati scritti, nel quale spazi, caratteri speciali, rientri, a capo, simboli e comandi possono avere un’importanza particolare e non devono essere interpretati.

In questa guida lo si è fatto tutte le volte che si è mostrato il codice di un comando, di un ambiente o quello per ottenere un certo risultato in stampa, come per la poesia precedente. Per scrivere un frammento di testo verbatim in linea, LATEX definisce il comando standard \verb!htesto da riprodurre verbatimi!

Il simbolo ! è solo uno dei possibili caratteri delimitatori del htestoi: a questo scopo si può usare un carattere qualunque purché non compaia tra i caratteri da riprodurre, tranne *. Si consiglia di usarne uno tra !, ?, | e @. Si noti che il htesto da riprodurre verbatimi non obbedisce ai parametri di giustificazione del testo principale del documento: se troppo lungo, infatti, fuoriesce dal margine sinistro. Indicativamente si consiglia di non superare una riga di codice sorgente, ma per ottenere un risultato ottimale potrebbero servire alcune prove.

Per scrivere del testo verbatim in display e su più righe, invece, c’è l’ambiente verbatim, da usare come di consueto: \begin{verbatim}

htesto da riprodurre verbatimi \end{verbatim}

L’interpretazione dell’esempio dovrebbe essere chiara, a questo punto della lettura. Sia il comando \verb sia l’ambiente verbatim prevedono

verbatim

76

il testo

una variante asterisco \verb* e verbatim*, diverse soltanto perché riproducono lo spazio in modo visibile con il carattere , come si può osservare negli esempi seguenti.

Il logo ‘‘\LaTeX” si ottiene con il comando \verb!\LaTeX!.

\begin{verbatim} Nell’ambiente verbatim i comandi di \LaTeX, gli a capo, gli spazi, i rientri e i caratteri speciali (\{}%$_&#^~) non vengono interpretati. \end{verbatim}

\begin{verbatim*} Il comando \verb* e l’ambiente verbatim* rendono gli spazi così. \end{verbatim*}

Il logo “LATEX” si ottiene con il comando \LaTeX.

Nell’ambiente verbatim i comandi di \LaTeX, gli a capo, gli spazi, i rientri e i caratteri speciali (\{}%$_&#^~) non vengono interpretati.

Il comando \verb* e l’ambiente verbatim* rendono gli spazi così.

A questo proposito si noti che: • né \verb né verbatim possono comparire nell’argomento di un altro comando; • verbatim può riprodurre tutto tranne la stringa \end{verbatim}, perché, essendo il comando per chiudere l’ambiente stesso verrebbe interpretato da LATEX la prima volta, e la seconda arresterebbe la compilazione con un errore. listings

Questi strumenti, però, non sono flessibili e vanno bene soltanto per un uso di base. Per controllare e personalizzare finemente il formato dei codici, invece, si consiglia il pacchetto listings. Il pacchetto riconosce molti linguaggi di programmazione e definisce il comando \lstinline e l’ambiente lstlisting, che funzionano esattamente come i corrispondenti strumenti standard di LATEX con la differenza che non presentano né varianti asterisco né limitazioni al testo da riprodurre. Per ottenere risultati come il primo e il secondo di quelli appena esaminati, però, il pacchetto richiede un’impostazione particolare nel preambolo: \usepackage{listings} \lstset{language=[LaTeX]TeX,% basicstyle=\small\ttfamily}

dove: • \lstset regola le impostazioni generali del pacchetto; • language indica il linguaggio di programmazione in cui va scritto l’esempio (LATEX, in questo caso);

4.12 acronimi e glossari

• basicstyle imposta lo stile con cui si vuole che il codice venga stampato (in un corpo leggermente più piccolo di quello corrente e a spaziatura fissa, in questo caso).

Tutti gli esempi contenuti nella guida sono stati realizzati con questo pacchetto (se ne veda la documentazione).

Per scrivere algoritmi si consigliano i pacchetti algorithm e algpseudocode: il primo, a differenza del secondo, genera oggetti mobili (si veda a questo proposito il paragrafo 6.5 a pagina 144).

4.12

Algoritmi

acronimi e glossari

In lavori particolarmente tecnici e complessi è consigliabile mettere nel backmatter un elenco degli acronimi menzionati nel testo e un glossario, cioè un elenco alfabetico dei termini specialistici presenti nel documento con le relative definizioni (ed eventualmente un simbolo).

Il pacchetto acronym (se ne veda la documentazione), gestisce efficacemente gli acronimi, generando automaticamente anche i riferimenti ipertestuali tra testo e spiegazione nell’elenco.

Per gestire un vero e proprio glossario esiste il pacchetto glossaries, che tramite il programma MakeIndex genera automaticamente i corrispondenti elenchi.

4.13

77

specialità

acronym glossaries

Il tutto è maggiore della somma delle parti.

Aristotele Metafisica

Epigrafi

Qualche volta, esigenze particolari richiedono di scrivere un’epigrafe in testa a un capitolo o un paragrafo. Per realizzarla facilmente c’è il pacchetto epigraph. Un’epigrafe come quella che si vede dopo il titolo di questo paragrafo si ottiene con il seguente codice: \section{Specialità} \epigraph{Il tutto è maggiore della somma delle parti}% {Aristotele\\Metafisica}

Capilettera

e convenzioni tipografiche permettono, a scopo decorativo, di L sostituire la prima lettera di un capitolo con un capolettera, cioè una lettera di corpo maggiore delle altre (come qui). I capilettera hanno le forme più svariate: si va dalle lettere nel font corrente a caratteri elaboratissimi costruiti appositamente per pubblicazioni particolarmente ricercate o di lusso.

epigraph

lettrine

78

il testo

Il pacchetto lettrine (se ne veda la documentazione) ne offre un vasto assortimento. Per funzionare al meglio, lettrine richiede il pacchetto type1ec (che rende “scalabili a piacimento” i font standard di LATEX disegnati in vari corpi), da caricare prima di fontenc con l’opzione T1: \usepackage{type1ec} \usepackage[T1]{fontenc} \usepackage{lettrine}

Si noti che usando font disegnati in un solo corpo, invece, come per esempio quelli dei pacchetti txfonts, pxfonts, mathpazo e fourier (si veda il paragrafo 9.5 a pagina 187), type1ec non serve.

Per stampare il capolettera si usa il comando omonimo \lettrine , la cui sintassi, a questo punto della lettura, dovrebbe essere chiara: \lettrine[hopzionii]{hcapoletterai}{heventuale testo in maiuscolettoi}

Di seguito si riporta un esempio di testo con capolettera. \lettrine{L}{ui non ha mai saputo} come Cousin Jerry avesse previsto tutto quel che poi è successo. Non ha mai capito perché se ne andasse in giro col passaporto sempre in tasca, quasi fosse già pronto a spiccare il grande salto.

ui non ha mai saputo come L Cousin Jerry avesse previsto tutto quel che poi è successo. Non

ha mai capito perché se ne andasse in giro col passaporto sempre in tasca, quasi fosse già pronto a spiccare il grande salto.

Una consuetudine molto seguita prevede di sfumare il passaggio dal capolettera al testo normale con qualche parola in maiuscoletto: si può fare, ma non è una regola.

shapepar

Scritture curiose

Il pacchetto shapepar stampa il testo contenuto nel proprio argomento in forme curiose: cuori, rombi, esagoni, rettangoli, cerchi, stelle a cinque punte, eccetera. Il suo uso è semplicissimo, come si può osservare nei due esempi seguenti: \heartpar{Lui non ha mai saputo come Cousin Jerry\dots}

Lui non ha mai saputo come Cousin Jerry avesse previsto tutto quel che poi è successo. Non ha mai capito perché se ne andasse in giro col passaporto sempre in tasca, quasi fosse già pronto a spiccare il grande salto. Di una sola cosa è certo, che se gliel’avesse chiesto, il vecchio Jerry avrebbe richiamato in superficie la migliore delle sue espressioni strafottenti, detto una frase da mezzo adulto, tipo: «Se stavi attento, Ermanno, capivi tutto anche tu». ♥

♦ Lui non ha mai saputo come Cousin Jerry avesse previsto tutto quel che poi è successo. Di una sola cosa è certo, che se gliel’avesse chiesto, il vecchio Jerry avrebbe richiamato in superficie la migliore delle sue espressioni strafottenti, detto una frase da mezzo adulto, tipo: «Se stavi attento, Ermanno, capivi tutto anche tu». ♦

4.14 la revisione finale

Scrivere su più colonne

Per scrivere su due colonne, LATEX definisce il comando standard \twocolumn , ma ogni volta che lo si dà viene cominciata una nuova pagina e le colonne spesso non sono bilanciate nella parte finale. Il pacchetto multicol (se ne veda la documentazione) può risolvere il problema, semplicemente scrivendo

4.14

\begin{multicols}% {hnumeroi}

htesto multicolonnai \end{multicols}

dove: • hnumeroi è il numero delle colonne (da 2 a 10) in cui si intende dividere il testo; • htesto multicolonnai si spiega da sé.

79

Il testo nelle colonne viene bilanciato (come qui) e può essere sezionato con i comandi consueti.

Tuttavia, il pacchetto non permette le note a margine né oggetti mobili che non siano a tutta pagina (vanno inseriti perciò con le varianti asterisco table* e figure*; si veda il paragrafo 6.5 a pagina 144).

la revisione finale

Come si è sottolineato più volte, anche se LATEX privilegia la struttura logica di un documento a discapito del suo aspetto, neppure lui, tuttavia, riesce a risolvere tutti i problemi tipografici ed evitare all’utente di mettere mano alla forma del lavoro, se desidera un prodotto di altissima qualità. La revisione finale è una fase tanto impegnativa quanto gratificante: risolvere grandi problemi di impaginazione con piccole modifiche è un’arte complicata ma ricca di soddisfazioni.

In linea generale, piuttosto che modificare le impostazioni globali di LATEX è conveniente tentare piccole modifiche al testo, spesso sufficienti per risolvere i problemi e ottenere un risultato migliore.

Si supponga, per esempio, che l’ultimo paragrafo di un capitolo di un libro sfori di due righe su una pagina a destra: si avrebbero due pagine consecutive praticamente bianche. Per evitarlo, si può provare a riformulare un paio di capoversi per accorciarli di una riga ciascuno.

In alternativa, si possono usare alcuni strumenti che LATEX mette a disposizione per regolare finemente il risultato finale.

Il comando \looseness dato all’inizio di un capoverso, senza righe vuote tra sé e il testo che lo segue, ordina a LATEX di tentare la ricomposizione del capoverso in base al parametro che gli viene assegnato (il parametro predefinito è \looseness=0). Il comando si può applicare per ricomporre usando una riga in meno della lunghezza originaria capoversi sufficientemente lunghi e la cui ultima riga sia breve, come si vede nell’esempio seguente: \dots qui finisce un capoverso. \looseness=-1 Qui ne comincia un altro, che \LaTeX{} cercherà di comporre usando una riga in meno della sua lunghezza ‘‘naturale’’. \dots

Piccole modifiche per grandi problemi

\looseness

80

\enlargethispage

il testo

Si noti che l’azione di \looseness è limitata al capoverso cui viene premesso. Se lo stratagemma funziona per un paio di capoversi almeno, si riesce a far rientrare le due righe in questione, e si guadagna una pagina.

Se non dovesse funzionare, tra due capoversi si può dare il comando \enlargethispage{\baselineskip}

che allunga di una riga rispetto al normale la pagina in cui viene inserito. Perché l’aggiustamento non dia nell’occhio, il comando va usato in coppia su pagine affiancate, prive di note a piè di pagina, con margini inferiori sufficientemente ampi e in previsione di una stampa su carta di qualità (una bassa grammatura, infatti, tradirebbe l’aggiustamento in trasparenza).

La variante asterisco \enlargethispage*{\baselineskip}

si comporta in modo analogo, cercando prima di stringere gli eventuali spazi bianchi presenti sulla pagina per mantenerne invariata l’altezza complessiva.

I trucchi ora esaminati si possono usare anche al contrario. Alcuni problemi d’impaginazione, infatti, si possono risolvere egregiamente allungando un capoverso di una riga con il comando \looseness=1

oppure accorciando le pagine problematiche con il comando \enlargethispage{-\baselineskip}

Allungare un capoverso

Non sempre LATEX riesce a evitare vedove e orfane.

Se l’ultima riga di un capoverso allungato con \looseness=1 risulta troppo breve (di una sola parola o, peggio, di una sola sillaba), si consiglia di inserire uno spazio indivisibile ~ tra le ultime due parole del capoverso, o di racchiudere l’ultima in \mbox . Questi trucchi d’impaginazione possono funzionare purché il capoverso in questione sia abbastanza lungo e presenti nella composizione normale l’ultima riga quasi piena. Salvo casi fortunati, i capoversi brevi non sono adatti per simili acrobazie. Questo capoverso, per esempio, è stato composto con \looseness=1, e presenta effettivamente una riga in più rispetto al risultato che si avrebbe senza quel comando. Come tutti i trucchi, anche questo non funziona sempre: ci si armi di molta pazienza, dunque, e si sia pronti anche a riformulare il testo per ottenere l’effetto desiderato.

Vedove e orfane

In tipografia si usa chiamare orfana una riga solitaria in fondo alla pagina (di solito, la prima riga di un capoverso) e vedova una riga solitaria in testa alla pagina seguente (tipicamente, l’ultima riga di un capoverso). Entrambi questi casi andrebbero accuratamente evitati ma, tra le due, le vedove sono più gravi delle altre, come testimonia la terminologia tedesca: una riga orfana si chiama Schusterjunge (“apprendista ciabattino”), mentre una riga vedova Hurenkind (“figlio di p* * *”). Bisogna fare in modo che tanto in cima quanto in fondo a ogni pagina ci

4.14 la revisione finale

siano almeno due righe di uno stesso capoverso. LATEX è programmato per farlo, ma a volte può essere necessario intervenire a mano.

Oltre agli strumenti presentati in questo paragrafo si può tentare di eliminare una riga orfana dando \pagebreak immediatamente prima del capoverso che dà problemi. La pagina si interrompe e il suo contenuto viene “stiracchiato” in verticale per riempirla in modo ottimale.

Se c’è abbastanza spazio sulla pagina il risultato finale è in genere soddisfacente.

Interrompere la pagina corrente

Di seguito si descrivono brevemente i principali comandi standard per “cambiare pagina”. Tutti interrompono la pagina corrente nel punto in cui vengono dati, ma: • \newpage comincia semplicemente una pagina nuova; • \pagebreak prima di cominciare la nuova pagina stiracchia in verticale il contenuto di quella in cui viene dato per riempirla al meglio; • \clearpage si usa nei documenti impostati per la stampa solo fronte e azzera prima le code di stampa (si veda il paragrafo 6.5.1 a pagina 144); • \cleardoublepage si usa nei documenti impostati per la stampa in fronte/retro e si comporta come il comando precedente, inserendo prima una pagina bianca se necessario.

81

\pagebreak

Comandi per “cambiare pagina”

5 indice

L A M AT E M AT I C A

5.1

Formule in linea e in display 84 5.1.1 Formule “in linea” 84 5.1.2 Formule “in display” 84 5.1.3 Modo matematico e modo testuale 86 5.2 Le basi 86 5.2.1 Raggruppamenti 87 5.2.2 Esponenti, indici e radici 87 5.2.3 Somme, prodotti e frazioni 87 5.2.4 Limiti, derivate e integrali 88 5.2.5 Insiemi numerici 89 5.2.6 Lettere greche 89 5.2.7 Simboli che sormontano altri simboli 90 5.2.8 Barre e accenti 90 5.2.9 Punti e frecce 92 5.2.10 Spazi in modo matematico 93 5.3 Operatori 94 5.4 Parentesi 95 5.5 Vettori e matrici 98 5.6 Formule lunghe 99 5.6.1 Spezzare formule senza allineamento: multline 100 5.6.2 Spezzare formule con allineamento: split 100 5.6.3 Raggruppare formule senza allineamento: gather 100 5.6.4 Raggruppare formule con allineamento: align 101 5.6.5 Gli ambienti gathered e aligned 101 5.6.6 Casi e numerazione subordinata 102 5.7 Modificare stile e corpo del font 102 5.8 Enunciati e dimostrazioni 104 5.9 Diagrammi commutativi 108 5.10 Fisica e chimica 108 5.11 Evidenziare formule: il pacchetto empheq 109 5.12 Elenco dei simboli matematici 110

Questo capitolo esplora uno dei principali punti di forza di LATEX, anche se ne intacca solamente la superficie: la composizione di formule matematiche. Verranno spiegati strumenti sufficienti a soddisfare la maggior parte delle esigenze, ma potrebbe darsi che quella particolare necessità non trovi risposta in queste pagine. Se così fosse, molto probabilmente la soluzione sta in una delle funzioni del pacchetto amsmath (che non potrà essere descritto per intero, dati i limiti di questo lavoro) o di qualche altro pacchetto dedicato.

La scrittura della matematica è regolata da norme che dipendono dalle tradizioni e dalla cerchia dei lettori cui lo scritto è destinato. Queste regole sono raccolte nel mondo dalla normativa iso (International Standard Organization) e in Italia dalla normativa uni (Ente Nazionale Italiano di Unificazione). Le norme emesse dall’uni hanno valore di

Le norme ISO-UNI

83

84

la matematica

legge, per cui se un documento per uso legale viene scritto in modo conforme alle norme, non perde tale valore. Per maggiori dettagli, se ne veda la documentazione.1 Di qui in avanti si danno per caricati i pacchetti amsmath e amssymb.

5.1

formule in linea e in display

Esistono due modi per scrivere la matematica con LATEX: “in linea” e “in display”.

5.1.1 Formule “in linea”

Le formule in linea si usano solo per espressioni di piccole dimensioni.

Una formula “in linea” è un’espressione che LATEX incorpora nel P 1 π2 testo: limn→∞ n k=1 k2 = 6 , per esempio.

Come si può osservare, LATEX fa il possibile per comprimerla e non aumentare l’interlinea del capoverso in cui viene inserita. Le formule di questo tipo si scrivono tra dollari $. . .$ (oppure, ma è un’alternativa meno usata, tra i comandi \(. . .\)), vengono stampate in corsivo matematico (diverso dal corsivo ordinario) e il corpo degli esponenti è più piccolo di quello delle basi.

Una formula in linea è un’espressione che \LaTeX{} incorpora nel testo: $\lim_{n \to \infty} \sum_{k=1}^n \frac{1}{k^2} = \frac{\pi^2}{6}$.

Una formula in linea è un’espressione che LATEX incorpora nel testo: P π2 1 limn→∞ n k=1 k2 = 6 .

Si consiglia, però, di scrivere in linea soltanto espressioni di piccole dimensioni, come mostra il codice seguente: Ci sono voluti secoli per dimostrare che quando $n>2$ \emph{non} ci sono tre interi positivi $a$, $b$, $c$ tali che $a^n+b^n=c^n$.

Ci sono voluti secoli per dimostrare che quando n > 2 non ci sono tre interi positivi a, b, c tali che an + bn = cn .

5.1.2 Formule “in display”

Una formula “in display”, invece, è un’espressione che LATEX compone su linee a sé, separate dal testo precedente e seguente con spazi bianchi di ampiezza adeguata per “metterla in mostra” e farla risaltare sulla pagina. L’esempio in linea del paragrafo precedente diventa, in display: n X π2 1 = lim . n→∞ 6 k2 k=1

1 Purtroppo, nonostante detta importanza, li si può consultare soltanto tramite un servizio a pagamento.

5.1 formule in linea e in display

Come si può osservare, ora la formula è centrata e non compressa, e a numeri e simboli è assegnato lo spazio che devono avere, con un risultato finale di grande respiro.

Per comporre una formula in display bisogna racchiuderla tra comandi particolari o in ambienti matematici. Si può farlo in molti modi, ma alcuni di essi sono decisamente sconsigliabili.

Bisogna sempre evitare, per esempio, di scrivere la formula tra dollari doppi $$. . .$$, perché la spaziatura verticale delle strutture o l’opzione di classe fleqn potrebbero non funzionare più bene [Fairbairns, 2010; Trettin e Zannarini, 2005].

Altrettanto da evitare sono gli ambienti standard eqnarray (per sistemi di formule numerate) ed eqnarray* (per sistemi di formule non numerate) viziati, purtroppo, da una specie di “peccato originale”: tra il segno di uguaglianza e il resto del testo inseriscono più spazio di quanto non facciano altri ambienti matematici. È un difetto che nel passaggio a LATEX 2ε gli sviluppatori hanno deciso di conservare per questioni di compatibilità con la vecchia versione del programma. Oggi questi due ambienti e i dollari doppi non devono più essere usati.

Il modo corretto di scrivere una formula in display, allora, è quello di racchiuderla negli ambienti dedicati: equation, per le formule numerate, ed equation* (di solito abbreviato in \[. . .\]) per quelle non numerate. Si considerino gli esempi seguenti: Una formula in display è un’espressione che \LaTeX{} compone su linee a sé stanti: \[ \lim_{n \to \infty} \sum_{k=1}^n \frac{1}{k^2} = \frac{\pi^2}{6}. \]

Se $f$ è continua e \[ F(x)=\int_a^x f(t)\,dt, \] allora \begin{equation} F’(x)=f(x). \end{equation}

85

Pratiche da evitare

Formule numerate e non numerate

Una formula in display è un’espressione che LATEX compone su linee a sé stanti: n X 1 π2 = .

2 n→∞ 6 k

lim

k=1

Se f è continua e Zx f(t) dt, F(x) = a

allora

F 0 (x) = f(x).

(5.1)

Come si può osservare, le formule sono accompagnate da segni di punteggiatura.

Intorno alla punteggiatura nelle formule in display sono fiorite due scuole di pensiero. Alcuni ritengono che non andrebbe mai usata, perché superflua e causa di possibili ambiguità nella lettura [Beccari, 2010]. Altri, tra cui chi scrive, ritenendo le formule in genere parte integrante dell’argomentazione, pensano che la punteggiatura aiuti il lettore e che vada quindi messa [Guiggiani e Mori, 2008]. Qualunque delle due scuole si intenda seguire, l’importante è rimanere coerenti con la propria scelta in tutto il documento.

I comandi \label ed \eqref permettono di richiamare una formula da altre parti del documento (come avviene per gli oggetti mobili):

Formule in display e punteggiatura

Riferimenti

86

la matematica

\begin{equation} \label{eq:euler} e^{i\pi}+1=0. \end{equation} Dalla formula~\eqref{eq:euler} si deduce che\dots

eiπ + 1 = 0.

(5.2)

Dalla formula (5.2) si deduce che. . .

Il modo display va riservato a espressioni complesse e di grandi dimensioni (troppo sacrificate tra le righe di un capoverso) e a formule più contenute a cui si voglia dare un risalto particolare.

5.1.3 Modo matematico e modo testuale

La modalità con cui si scrive la matematica (modo matematico) differisce per alcuni aspetti da quella con cui si scrive il testo (modo testuale).

Ecco i principali.

Spazi in modo matematico

• Spazi e interruzioni di riga non hanno significato, perché LATEX gestisce automaticamente il loro inserimento sulla base della struttura della formula: $x+y+z=n$ equivale a $ x + y + z = n $. Se serve, si possono inserire a mano ulteriori spazi con comandi appositi: – \, per lo spazio sottile; – \quad per lo spazio di un quadrato; – \qquad per lo spazio di un quadratone (si veda il paragrafo 5.2.10 a pagina 93).

• Nella scrittura delle formule non sono ammesse righe vuote.

Inserire un breve testo in una formula in display

• LATEX considera ogni lettera una variabile, e come tale la scrive.

Si può comunque inserire un breve testo con font e spaziatura normali in una formula in display scrivendolo nell’argomento del comando \text{h. . .i}

ed esplicitando la spaziatura prima e dopo di esso. $x+y+z=n$ \\ $ x + y + z = n $ \[ z^2+1=0 \quad \text{per $z=\pm i$.} \]

Nastro di Möbius II, incisione su legno di M. Escher.

x+y+z = n x+y+z = n

z2 + 1 = 0

per z = ±i.

Il comando \pm dà ±. Esiste anche \mp , che dà ∓.

5.2

le basi

Questo paragrafo descrive i comandi più usati per scrivere le formule matematiche. (Per un loro elenco dettagliato, si veda il paragrafo 5.12 a pagina 110.)

5.2 le basi

5.2.1 Raggruppamenti

La maggior parte dei comandi matematici agisce soltanto sul carattere immediatamente successivo. Per evitare questo comportamento basta racchiudere il testo matematico in un gruppo di parentesi graffe:

87 Graffe di raggruppamento

{htesto matematicoi}

\[ a^x+y \neq a^{x+y} \]

ax + y 6= ax+y

5.2.2 Esponenti, indici e radici

Apici e pedici vanno scritti facendoli precedere dai caratteri ^ e _ rispettivamente: $a_1$ \qquad $x^2$ \qquad $e^{-\alpha t}$ \qquad $a^{3}_{ij}$ \\ $e^{x^2} \neq {e^x}^2$

x2

a1 2

ex 6= e

e−αt

a3ij

x2

Per stampare gli indici di secondo ordine bisogna racchiuderli in un gruppo di graffe: una scrittura come $x_n_k$ non ha senso.

Dalla successione $x_n$ estrarre $x_{n_k}$.

Apici e pedici

Indici di second’ordine

Dalla successione xn estrarre xnk .

Il simbolo di radice quadrata si ottiene con \sqrt , quello di radice n-esima con

Radici

\sqrt[hni]{h. . .i

LATEX ne calcola automaticamente le dimensioni: $\sqrt{x}$ \qquad $\sqrt{x^2+\sqrt{y}}$ \qquad $\sqrt[3]{2}$

√ x

√ 3 2

q √ x2 + y

5.2.3 Somme, prodotti e frazioni

Il simbolo di sommatoria è generato da \sum e quello di produttoria da \prod . Gli estremi si scrivono come indici.

Trovare il massimo valore della funzione \[ f(x_1,\dots,x_n)= \prod_{k=1}^n x_k \] sotto la condizione \[ \sum_{k=1}^n x_k^2=1. \]

Trovare il massimo valore della funzione f(x1 , . . . , xn ) =

n Y k=1

sotto la condizione n X k=1

x2k = 1.

xk

Somme e prodotti

Frazioni

88

la matematica

Una frazione, anche complessa, si ottiene semplicemente con il comando \frac{hnumeratorei}{hdenominatorei}

Per piccole quantità di “materiale frazionario”, talvolta la forma n/m è più gradevole sulla pagina. \[ \frac{x^2}{k+1} \qquad x^{\frac{2}{k+1}} \qquad x^{1/2} \]

Limiti

x2 k+1

2

x1/2

x k+1

5.2.4 Limiti, derivate e integrali Il comando

\lim_{hvariabilei\to hvalorei}

stampa i limiti, e \infty dà ∞. \[ \lim_{x\to 0} \frac{\sin x}{x}=1 \qquad \lim_{n\to +\infty}f_n=\delta \]

Derivate

lim

x→0

!

!!

Integrali

···

!

lim fn = δ

n→+∞

Le derivate si scrivono con il simbolo ’, che produce un segno di primo. \[ y=x^2, \quad y’=2x, \quad y’’=2. \]

!

sin x =1 x

y = x2 ,

y 0 = 2x,

!!!

Il comando \int produce il simbolo di integrale.

y 00 = 2.

Gli estremi di integrazione si scrivono come indici: \int_a^b. Un indice formato da più di una lettera o una cifra va racchiuso tra graffe: \int{a+1}^{b+1}. \[ \int_a^{a+T}f(x)\,dx= \int_0^T f(x)\,dx \]

Z a+T

ZT

f(x) dx = a

f(x) dx 0

Come si può osservare, lo spazio sottile \, allontana dx da f(x).

Per gli integrali multipli si usano i comandi \iint , \iiint , \iiiint e \idotsint . \[ \iint_D f(x,y)\,dx\,dy \qquad \iiint g \,dx\,dy\,dz \]

x D

f(x, y) dx dy

y

g dx dy dz

5.2 le basi

Tabella 9: Lettere greche minuscole: forme principali (a sinistra) e varianti (a destra). (a) Font AMS Euler.

(b) Font Palatino.

�

\epsilon

ε

\varepsilon

�

\epsilon

ε

\varepsilon

θ

\theta

ϑ

\vartheta

θ

\theta

ϑ

\vartheta

π

\pi

�

\varpi

π

\pi

�

\varpi

ρ

\rho

ρ

\varrho

ρ

\rho

�

\varrho

σ

\sigma

σ

\varsigma

σ

\sigma

ς

\varsigma

φ

\phi

ϕ

\varphi

φ

\phi

ϕ

\varphi

5.2.5 Insiemi numerici

I simboli degli insiemi numerici si ottengono con \mathbb (blackboard bold, “neretto da lavagna”). \[ x^2 \geq 0 \quad \forall x \in \mathbb{R}. \]

89

x2 > 0

“Neretto da lavagna”

∀x ∈ R.

Il comando \in dà la relazione di appartenenza ∈ (per la non appartenenza ∈ / si usa \notin ).

Se si scrivono nel preambolo le definizioni seguenti (si veda il paragrafo 9.1 a pagina 181)

Relazione di appartenenza

\newcommand{\numberset}{\mathbb} \newcommand{\N}{\numberset{N}} \newcommand{\R}{\numberset{R}}

per avere N basta scrivere \N, e si può cambiare notazione con un’unica modifica.

5.2.6 Lettere greche

Le lettere greche minuscole si ottengono con i comandi elencati nella tabella 12 a pagina 110. Sei di esse, prefissate con var e raccolte nella tabella 9, subiscono una sorte particolare: • \varpi non si usa mai;

ϕ

• anche se fortemente sconsigliato, è ammesso usare in modo non esclusivo \sigma e \varsigma per indicare grandezze diverse in uno stesso documento; • le altre quattro vanno usate in modo esclusivo (o la forma principale o la sua variante), ma si ricordi che, a differenza di altri Paesi, in Europa si usa la forma corrispondente alla variante.2 2 I font AMS Euler usati in questa guida restituiscono nello stesso modo entrambe le forme di rho e sigma, ma non c’è pericolo di confondersi, perché in uno stesso 1 documento la scelta tra forma principale e variante va operata in modo esclusivo.

1

Scrivere le lettere greche minuscole in accordo con il gusto europeo

90

la matematica

Ecco perché è conveniente ridefinire queste quattro “varianti” come caratteri normali, scrivendo nel preambolo (si veda il paragrafo 9.1 a pagina 181): \renewcommand{\epsilon}{\varepsilon} \renewcommand{\theta}{\vartheta} \renewcommand{\rho}{\varrho} \renewcommand{\phi}{\varphi}

Le lettere greche maiuscole si ottengono con i comandi elencati nella tabella 13 a pagina 110. Per tutte le altre si usano le corrispondenti maiuscole latine, identiche a quelle greche.

\overset e \underset

5.2.7 Simboli che sormontano altri simboli Il comando

\overset{hprimo argomentoi}{hsecondo argomentoi}

stampa il simbolo indicato nel hprimo argomentoi rimpicciolito e sovrapposto a quello scritto nel hsecondo argomentoi (di solito un simbolo di relazione binaria), che rimane delle sue dimensioni e nella posizione abituale. Il comando \underset fa l’opposto.

Il simbolo \[ \overset{H}{=} \] indica l’uguaglianza nel senso del teorema di de l’H\^{o}pital.

Barre orizzontali

Il simbolo

H

= indica l’uguaglianza nel senso del teorema di de l’Hôpital.

5.2.8 Barre e accenti

Il comando \bar pone un trattino sul suo argomento: il simbolo x¯ indica un nome di variabile distinto da x.

I comandi \overline e \underline (il secondo dei quali si usa piuttosto raramente) sopralineano e sottolineano rispettivamente tutto il loro argomento: il simbolo x indica un operatore applicato alla variabile x: $\bar{x}$ \qquad$ \bar{X}$ \qquad $\overline{m+n}$

x¯

X¯

m+n

I comandi \vec e \overrightarrow agiscono esattamente come \bar e \overline , stampando frecce anziché barre orizzontali. $\vec x$ \qquad $\overrightarrow{AB}$

Barre verticali

~x

−→ AB

Esistono tre tipi di barra verticale, che differiscono per lo spazio che lasciano tra sé e i simboli circostanti: • semplice | (ottenibile anche con \vert ); • delimitatore sinistro e destro (\lvert e \rvert rispettivamente);

5.2 le basi

• relazione binaria (\mid ) per la divisibilità e il tale che negli insiemi. $F(x)|_{x=\gamma(t)}$ \qquad $\lvert x\rvert$ \\ Se $p\mid n^2$, allora $p\mid n$.

F(x)|x=γ(t) |x| 2 Se p | n , allora p | n.

I comandi appena esaminati prevedono degli analoghi che stampano barre verticali doppie: \| (o \Vert ), \lVert , \rVert e \parallel .

La barra laterale è prevista talvolta nel calcolo degli integrali: \[ \int_a^b f(x)\,dx = F(x)\big|_a^b \]

Zb a

\DeclarePairedDelimiter{\abs}{\lvert}{\rvert} \DeclarePairedDelimiter{\norma}{\lVert}{\rVert}

I comandi \abs e \norma si usano nel modo seguente:

\[ \norma{x}= \sqrt{x_1^2+\dots+x_n^2} \]

+∞ X

zn =

n=0

kxk =

1 1−z

q

per |z| < 1.

x21 + · · · + x2n

Le varianti asterisco dei comandi appena definiti producono delimitatori ad altezza variabile: \[ \abs*{\frac{a}{b}} \qquad \norma*{\frac{u}{\lambda}} \]

Differenza tra insiemi

A\B A\B

Come si può osservare, il primo codice produce una spaziatura (leggermente) sbagliata.

Per il valore assoluto e la norma è conveniente caricare il pacchetto mathtools e definire due comandi ad hoc, scrivendo nel preambolo:

\[ \sum_{n=0}^{+\infty}z^n= \frac{1}{1-z} \quad \text{per $\abs{z}<1$.} \]

Barra laterale

b f(x) dx = F(x) a

L’altezza della barra va regolata a mano, premettendole uno dei comandi che verranno descritti nel paragrafo 5.4 a pagina 95.

La differenza tra due insiemi si realizza con il comando \setminus .

Si confrontino le due scritture seguenti: $A\backslash B$ \\ $A\setminus B$

91

a

b

u

λ

Valore assoluto e norma

92

la matematica

Esiste un’ulteriore variante per entrambi i comandi: \abs[hgrandezza del delimitatorei]{htestoi}

e \norma[hgrandezza del delimitatorei]{htestoi}

che permette di regolare a mano la grandezza dei delimitatori specificandola nell’argomento facoltativo. Si consideri l’esempio seguente: \[ \abs[\bigg]{\sum_{i=1}^{n}x_i} \qquad \abs*{\sum_{i=1}^{n}x_i} \]

Accenti matematici

Due punti

X

n

x i

i=1

n

X

x

i

i=1

Come si può osservare, il primo esempio presenta delimitatori (leggermente) migliori.

Per aggiungere alle variabili un accento matematico, come un cappello o una tilde, si possono usare i comandi della tabella 14 a pagina 110. I comandi \widehat e \widetilde stampano rispettivamente simboli di cappello e tilde che sormontano tutto il loro argomento.

5.2.9

Punti e frecce

In matematica esistono due tipi di due punti, diversamente spaziati: • semplice :, spaziato come in un’operazione binaria (divisione); • \colon , spaziato come un segno di interpunzione.

Si confrontino le due scritture seguenti: $f:\R\to\R$ \\ $f\colon\R\to\R$

Punti ellittici

Come si può osservare, il primo codice produce una spaziatura (leggermente) sbagliata.

Per inserire punti ellittici in una formula si usa il comando \dots , che li mette automaticamente sulla linea di base del testo o li centra rispetto alla riga a seconda del contesto. \[ x_1,\dots,x_n \qquad x_1+\dots+x_n \]

Frecce

f:R→R f: R → R

x1 , . . . , xn

x1 + · · · + xn

Per ulteriori esempi dell’uso di \dots , si rimanda il lettore al paragrafo 5.5 a pagina 99.

Oltre alla freccia semplice →, che si ottiene con il comando \to , c’è anche quella col trattino 7→, che si ottiene con \mapsto . $f\colon\R\to\R$, \\ $x\mapsto x^2$

f : R → R, x 7→ x2

5.2 le basi

Tabella 10: Spazi in modo matematico.

Comando

Tipo di spazio

\,

Spazio sottile positivo Spazio sottile negativo Spazio di un “quadrato” Spazio di un “quadratone”

\! \quad \qquad

93

Valore (\quad ) () 3 − 18 1( ) ) 2( 3 18

I comandi \xleftarrow e \xrightarrow stampano frecce che si estendono automaticamente per accordarsi con indici di lunghezza non comune. Entrambi accettano un argomento facoltativo (il pedice) e uno obbligatorio (l’apice), che possono anche rimanere vuoti. \[ \xleftarrow{a} \quad \xleftarrow[X]{a+b} \quad \xrightarrow[X+Y+Z]{} \]

a

a+b

← − ←−−− X

−−−−−−→ X+Y+Z

I simboli logici vanno usati solo in un lavoro sull’argomento (mentre in tutti gli altri contesti vanno senz’altro preferite le forme estese se. . . allora, se e solo se, eccetera): il comando \implies dà =⇒ e \iff dà ⇐⇒ (entrambi adeguatamente spaziati prima e dopo). I comandi \land , \lor e \lnot producono rispettivamente ∧, ∨ e ¬.

5.2.10 Spazi in modo matematico

Può accadere, anche se di rado, che la spaziatura scelta da LATEX per le formule non soddisfi l’autore. Per modificarla si usano i comandi raccolti nella tabella 10. L’unità di misura dello spazio matematico è il quadrato (\quad ), corrispondente alla larghezza del carattere M nel font corrente. A tutti gli altri spazi LATEX assegna i valori indicati nella tabella.3 Lo spazio sottile prodotto dal comando \, è molto utile in alcune formule. Si confronti \[ \int_a^b f(x)\,dx, \quad \sqrt{2}\,a, \quad \sqrt{\,\log x}. \]

Zb f(x) dx,

√ 2 a,

p

√ 2a,

p log x.

log x.

a

con \[ \int_a^b f(x) dx, \quad \sqrt{2} a, \quad \sqrt{\log x}. \]

Zb f(x)dx, a

3 Oltre ai comandi citati ne esistono altri, come \: e \; (che producono uno spazio oriz4 5 zontale rispettivamente di 18 e di 18 di “quadrato”) che per motivi di uniformità tipografica non dovrebbero mai essere usati. Anche l’uso di \quad e \qquad fuori dagli ambienti matematici, pure possibile (si veda il paragrafo 6.5.5 a pagina 150), è di regola fortemente sconsigliato.

Simboli logici

Modificare a mano gli spazi tra le formule

Spazio sottile

94 Migliorare la qualità delle formule con gli spazi sottili

la matematica

Come si può osservare, il secondo codice produce una spaziatura (leggermente) insufficiente.

Il comando \! può rivelarsi una finezza utilissima per compensare spaziature spiacevoli in presenza di simboli inclinati (barre di frazione, radicali) preceduti o seguiti da simboli particolari (esponenti, apici o operatori). Si confronti \[ x^2\!/2, \quad a/\!\sin b. \]

x2/2,

a/sin b.

x2 /2,

a/ sin b.

con \[ x^2/2, \quad a/\sin b. \]

Come si può osservare, il secondo codice produce una spaziatura (leggermente) esagerata.

Si ricorda che interventi come gli ultimi due vanno operati esclusivamente durante la revisione finale per migliorare ulteriormente la qualità (già alta) del documento.

5.3

operatori

A differenza delle variabili, stampate in corsivo matematico, LATEX stampa in tondo le funzioni come sin, cos e log, per renderne più immediata la visibilità sulla pagina (in accordo con le norme iso-uni).

Le funzioni richiedono una spaziatura particolare (inserita automaticamente dal compilatore) che dipende dal tipo di contesto in cui vengono introdotte. In LATEX, i comandi come \sin , \cos e \log vengono detti operatori.

Si considerino i due esempi seguenti: \[ \cos2x= \frac{1-\sin^2x}{2}, \]

\[ \log\log x, \quad \log(x+y) \]

cos 2x =

log log x,

1 − sin2 x , 2

log(x + y)

Come si può osservare, nella formula cos 2x fra cos e 2 c’è più spazio che fra 2 e x. Inoltre, nella formula log log x c’è uno spazio sottile tra i due log e un altro spazio sottile tra log e x, mentre nella formula log(x + y) non ci sono spazi tra log e la parentesi. Omettendo la barra rovescia, si otterrebbe cosx in corsivo e spaziato scorrettamente, il che non è più un operatore. Soltanto scrivendo gli operatori come si è

Tabella 11: Operatori predefiniti. \arccos \arcsin \arctan \arg \cos

\cosh \cot \coth \csc \deg

\det \dim \exp \gcd \hom

\inf \ker \lg \lim \liminf

\limsup \ln \log \max \min

5.4 parentesi \Pr \sec \sin \sinh \sup

\tan \tanh

appena mostrato LATEX si comporta nel giusto modo e assegna loro font e spazi corretti.

I seguenti sono alcuni operatori predefiniti (la tabella 11 ne riporta l’elenco completo): $\arccos x$, $\exp x$, $\min_{x\in A} f(x)$, $\det A$, $\log x$, $\tan x$

Operatori predefiniti

arccos x, exp x, minx∈A f(x), det A, log x, tan x

I due comandi \bmod e \pmod riguardano la relazione di congruenza modulo m: $a\bmod b$ \qquad $a\equiv b \pmod{m}$

95

a mod b

Congruenze

a ≡ b (mod m)

Le pubblicazioni specialistiche introducono continuamente nuove funzioni, che devono poter essere definite in qualche modo, non essendo contemplate né da LATEX né dai pacchetti dedicati. Il comando \DeclareMathOperator risolve il problema.

Per esempio, per definire la funzione matematica arsinh che denoti l’arcoseno iperbolico (non predefinito né da LATEX né da amsmath), si scrive nel preambolo

Definire nuovi operatori

\DeclareMathOperator{\arsinh}{arsinh}

Nel documento, poi, si darà \arsinh per ottenere arsinh nel font corretto e adeguatamente spaziato su entrambi i lati.

L’operatore che denota la parte reale di un numero complesso è \Re , che produce il simbolo <. Lo si può ridefinire perché stampi il simbolo in tondo anziché in gotico dando nel preambolo i comandi

Operatore “parte reale”

\DeclareMathOperator{\Realpart}{Re} \renewcommand{\Re}{\Realpart}

Se il nuovo operatore presenta indici scritti come nei limiti (lim, sup, o max), si usa la variante asterisco di \DeclareMathOperator : \DeclareMathOperator*{\Lim}{Lim}

5.4

parentesi

LATEX offre una vasta scelta di simboli per parentesi e altri delimitatori. Le parentesi tonde e quadre si scrivono con i corrispondenti

Definire operatori “di tipo limite”

96

la matematica

caratteri da tastiera, mentre quelle graffe anche nel modo matematico devono essere precedute da \. Tutti gli altri delimitatori vengono generati da comandi dedicati. \[ {a,b,c}\neq\{a,b,c\} \]

Specificare le dimensioni di un delimitatore a mano. . .

a, b, c 6= {a, b, c}

(Per un loro elenco completo, si vedano le tabelle 18 e 19 a pagina 112.)

Talvolta bisogna aggiustare a mano le dimensioni di uno di essi: per farlo basta prefissarlo con i comandi \big , \Big , \bigg e \Bigg . I comandi \bigl (big left) e \bigr (big right) ingrandiscono lievemente le parentesi: \[ \bigl( (x-y)+(x+y) \bigr) \]

(x â&#x2C6;&#x2019; y) + (x + y)

I comandi \Bigl e \Bigr producono parentesi ancora piĂš grandi: \[ \Bigl(1+\frac{1}{n}\Bigr)^n \]

1 n 1+ n

I comandi \biggl e \biggr ne generano di piĂš grandi ancora: \[ \biggl(\sum_n x_n^2\biggr)^{1/2} \]

X

x2n

1/2

n

Se non basta, ci sono anche \Biggl e \Biggr . $\bigl(\Bigl(\biggl(\Biggl($ \quad $\bigr\}\Bigr\}\biggr\} \Biggr\}$ \quad $\big\|\Big\|\bigg\|\Bigg\|$

...e automaticamente

Graffe orizzontali

LATEX può determinare le dimensioni dei delimitatori anche automaticamente, premettendo \left a quello di apertura e dando \right prima del corrispondente delimitatore di chiusura (nel caso in cui si voglia lasciare lâ&#x20AC;&#x2122;espressione aperta, si userĂ \right. con il punto finale). Questi comandi funzionano soltanto se usati in coppia e sulla stessa riga. Tuttavia, siccome quasi sempre inseriscono spaziature indesiderate e parentesi piĂš grandi del necessario, si preferisce loro il metodo manuale appena esaminato.

I comandi \overbrace e \underbrace creano delle lunghe graffe orizzontali sopra o sotto unâ&#x20AC;&#x2122;espressione: \[ \underbrace{1+2+\dots+n}_{{}= \frac{n(n+1)}{2}} +(n+1) \]

|1 + 2 +{z¡ ¡ ¡ + n} +(n + 1) = n(n+1) 2

5.4 parentesi

Per scrivere coefficienti binomiali si usa il comando \binom : \[ (a+b)^n= \sum_{\substack{k\in\N \\ 0\le k\le n}} \binom{n}{k}a^{n-k} b^k \]

(a + b)n =

97

Coefficienti binomiali

X n an−k bk k

k∈N 06k6n

Il comando \substack{hsoprai\\hsottoi}

serve per stampare un indice su più righe.

Le parentesi quadre messe nell’argomento dei comandi \mathopen e \mathclose indicano gli intervalli della retta reale. Si considerino le due scritture seguenti: $]a,b[ \times ]b,c[$ \\ $\mathopen{]}a,b\mathclose{[} \times \mathopen{]}c,d\mathclose{[}$

Intervalli

]a, b[×]b, c[ ]a, b[ × ]c, d[

Come si può osservare, il primo codice produce una spaziatura (leggermente) sbagliata.

Per i sistemi di equazioni è conveniente definire nel preambolo un ambiente ad hoc (si veda il paragrafo 9.1 a pagina 181):

Sistemi di equazioni

\newenvironment{sistema}% {\left\lbrace\begin{array}{@{}l@{}}}% {\end{array}\right.}

da usare come segue: \[ \begin{sistema} x+y+z=0 \\ 2x-y=1 \\ y-4z=-3 \end{sistema} \]

 x + y + z = 0 2x − y = 1  y − 4z = −3

Per gli insiemi è utile il pacchetto braket, che definisce l’apposito comando \Set :

Insiemi

e, per le parentesi angolate, \Bra , \Ket e \Braket :

Parentesi angolate

\[ \Set{\frac{1}{n^3} | n\in\N} \]

\[ \Bra{\psi_n} \quad \Ket{\psi} \quad c_n=\Braket{\psi_n | \psi} \]

hψn |

1

n ∈ N n3

|ψi

cn = hψn | ψi

98

Vettori

la matematica

5.5

vettori e matrici

I vettori si scrivono di solito in neretto (o neretto corsivo, secondo le norme iso-uni) oppure in semplice corsivo matematico; talvolta, soprattutto nei testi di fisica, vengono stampati con una freccia sopra. Per scrivere simboli in neretto si può usare il comando \mathbf ; per il neretto corsivo c’è il comando \bm del pacchetto bm (bold math); per comporre simboli sormontati da una freccia si usa il comando \vec . Può essere conveniente ridefinire nel preambolo quest’ultimo comando (si veda il paragrafo 9.1 a pagina 181): \renewcommand{\vec}{\bm}

Matrici

In questo modo basta scrivere \vec{v} per ottenere v, e si può cambiare notazione con un’unica modifica (si veda anche il paragrafo 5.7 a pagina 102).

Le matrici vanno scritte negli ambienti pmatrix, bmatrix, Bmatrix, vmatrix e Vmatrix, che hanno come delimitatori rispettivamente parentesi tonde, parentesi quadre (braces), parentesi graffe (curly Braces), barre verticali e doppie barre Verticali. Esiste anche l’ambiente matrix senza delimitatori.

Gli elementi della matrice vengono centrati automaticamente, e righe e colonne si scrivono come una normale tabella in tabular: • i vari & separano gli elementi di una riga; • il comando \\ termina una riga (eccetto l’ultima); • gli spazi non espliciti sono ignorati. \[ \begin{pmatrix} 1 & 2 \\ 3 & 4 \end{pmatrix} \]

\[ \begin{bmatrix} 1 & 2 \\ 3 & 4 \end{bmatrix} \]

\[ \begin{vmatrix} 1-x & 2 \\ 3 & 4-x \end{vmatrix} \]

Matrici con punti ellittici

1 3

2 4

2 4

1 3

1 − x

3

2

4 − x

Si possono scrivere matrici con punti ellittici, come nell’esempio seguente:

5.6 formule lunghe

99

\[ A=   \begin{bmatrix} x11 x12 . . . x_{11} & x_{12} & \dots \\   A = x21 x22 . . . x_{21} & x_{22} & \dots \\ .. .. .. . . . \vdots & \vdots & \ddots Nam dui ligula, fringilla a, euismod sodales, sollicitudin vel, wisi. \end{bmatrix} Morbi auctor lorem non justo. Nam lacus libero, pretium at, lobortis \]

vitae, ultricies et, tellus. Donec aliquet, tortor sed accumsan bibendum, erat ligula aliquet magna,il vitae ornare odio metus a mi. ac orci Come si può osservare, comando \vdots produce tre Morbi punti ellittici et nisl hendrerit Suspendisse ut massa.

Cras nec ante. Pelverticali e \ddots mollis. ne stampa tre in diagonale.

Il comando lentesque a nulla. Cum sociis natoque penatibus et magnis dis partu\hdotsfor{hni} rient montes, nascetur ridiculus mus. Aliquam tincidunt urna. Nulla ullamcorper vestibulum turpis.

Pellentesque cursus luctus mauris. riempie di punti ellittici la riga della matrice per n colonne: \[ \begin{bmatrix} a_{11} & a_{12} & \dots & a_{1n} \\ a_{21} & a_{22} & \dots & a_{2n} \\ \hdotsfor{4} \\ a_{n1} & a_{n2} & \dots & a_{nn} \end{bmatrix} \]



a11

a12

...

a1n

an1

an2

...

ann



   a21 a22 . . . a2n      . . . . . . . . . . . . . . . . . . . . . . . .

Namscrivere dui ligula, a, euismod sodales, Per una fringilla piccola matrice in linea con ilsollicitudin corpo del vel, testowisi. c’è Morbi auctor lorem non: justo. Nam lacus libero, pretium at, lobortis l’ambiente smallmatrix vitae, ultricies et, tellus. Donec aliquet, tortor sed accumsan bibendum, Sia ligula $A=\bigl( erat aliquet magna, vitae ornare odio metus a mi. Morbi ac orci \begin{smallmatrix} et nisl hendrerit mollis. Suspendisse ut massa. Cras nec ante. Pel a & b \\ b lentesque a nulla. Cum sociis natoque magnis partuSiapenatibus A = eta una dis matrice c d c & d rient montes, nascetur ridiculus mus.invertibile.

Aliquam tincidunt urna. Nulla \end{smallmatrix} ullamcorper vestibulum turpis. Pellentesque cursus luctus mauris. \bigr)$

Piccole matrici

una matrice invertibile.

In questo caso le parentesi vanno aggiunte a mano.

5.6

formule lunghe

LATEX non spezza le formule lunghe in modo automatico. Solo chi ha scritto la formula, infatti, ne conosce il ritmo di lettura e sa dov’è più opportuno andare a capo e se allinearne o meno le varie righe. In generale, tuttavia, vale la regola per cui si può andare a capo: • dopo i simboli di relazione e, subordinatamente, dopo i simboli di relazione e di operazione binaria (si vedano le tabelle 15 e 16 a pagina 111); • mai dopo gli operatori funzionali (tabella 11 a pagina 95), i grandi operatori e i delimitatori di apertura (si vedano le tabelle 17, 18 e 19 a pagina 112).

1

Le formule lunghe vanno spezzate a mano

100

Spezzare una formula senza allineamento

la matematica

Per spezzare le formule in display, il pacchetto amsmath mette a disposizione (fra gli altri) gli ambienti multline, split, gather e align.

5.6.1 Spezzare formule senza allineamento: l’ambiente multline

Per dividere una formula in più righe, senza particolari allineamenti fra di esse, si usa l’ambiente multline. \begin{multline} f=a+b+c \\ +d+e+g+h \\ +r+s+t. \end{multline}

f = a+b+c +d+e+g+h + r + s + t.

(5.3)

In stampa, la prima prima riga viene allineata a sinistra, l’ultima a destra e le rimanenti centrate (a meno che non sia attiva l’opzione fleqn, che allinea comunque le formule a sinistra rispetto a un margine rientrato). Il numero progressivo della formula viene stampato nel margine destro dell’ultima riga. La variante asterisco multline* produce formule dello stesso tipo non numerate.

Spezzare una formula con allineamento

5.6.2 Spezzare formule con allineamento: l’ambiente split

Per dividere una singola formula in più righe da allineare si usa l’ambiente split. \begin{equation} \begin{split} a &= b+c-d \\ &= e-f \\ &= g+h \\ &= i. \end{split} \end{equation}

a = b+c−d = e−f = g+h

(5.4)

= i.

Come si può osservare, il simbolo & incolonna le righe della formula a partire dal punto in cui è inserito (di solito, in corrispondenza di un simbolo di relazione). A differenza di altre strutture per comporre la matematica, split non numera autonomamente le formule, perché va usato esclusivamente all’interno di altri ambienti per le espressioni in display (equation, align o gather) responsabili della numerazione progressiva.

Raggruppare formule senza allineamento

5.6.3 Raggruppare formule senza allineamento: l’ambiente gather

L’ambiente gather raggruppa più formule senza allinearle l’una con l’altra, ma centrando ciascuna in una riga a sé, numerandola autonomamente e, se necessario, corredandola di un’etichetta. \begin{gather} a=b+c, \\ V+F-S=2. \end{gather}

a = b + c,

(5.5)

V + F − S = 2.

(5.6)

5.6 formule lunghe

Si potrebbe ottenere un risultato “simile” inserendo ciascuna formula del gruppo in un ambiente equation, ma la spaziatura tra le righe risulterebbe esagerata. La variante asterisco gather* produce formule dello stesso tipo non numerate.

5.6.4 Raggruppare formule con allineamento: l’ambiente align

L’ambiente align riunisce e allinea gruppi di due o più formule, ciascuna su una riga a sé e numerata singolarmente. Si consideri l’esempio seguente: \begin{align} a &= b+c+d, \\ e &= f, \notag \\ x-1 &= y+z. \end{align}

101

Raggruppare formule con allineamento

(5.7)

a = b + c + d, e = f,

(5.8)

x − 1 = y + z.

La variante asterisco align* produce formule dello stesso tipo non numerate. Si noti che lo stesso risultato si ottiene dando \notag alla fine della formula interessata.

L’ambiente align è utile anche per incolonnare più righe di formule.

In tal caso, il segno & assume due significati diversi a seconda della posizione in cui si trova sulla riga: • se occupa un posto dispari, segna i punti da incolonnare; • se occupa un posto pari, è un separatore come in tabular. \begin{align} a &= b, & c &=d, u &= v, & w &=x, \end{align}

& e &=f, \\ & y &=z.

a = b,

c = d,

e = f,

(5.9)

u = v,

w = x,

y = z.

(5.10)

5.6.5 Gli ambienti gathered e aligned

Per raggruppare delle formule con una parentesi, magari da integrare con del testo esplicativo, LATEX definisce i due ambienti gathered e aligned, che trattano le espressioni al loro interno come i due ambienti appena esaminati. \[ \left. \begin{aligned} a &= b+1 \\ c &= d \\ e &= f \end{aligned} \right\} \quad \text{tre equazioni} \]

 a = b + 1  c=d e=f

 

tre equazioni

Parentesi attorno a gruppi di formule: gathered e aligned

102 Casi

la matematica

5.6.6 Casi e numerazione subordinata

Lâ&#x20AC;&#x2122;ambiente cases serve per le definizioni fatte per casi. La graffa e lâ&#x20AC;&#x2122;allineamento sono automatici; il testo nella seconda colonna va nellâ&#x20AC;&#x2122;argomento di \text . \[ n!= \begin{cases} 1, & \text{se $n=0$,} \\ n(n-1)!, & \text{se $n\ge 1$.} \end{cases} \]

Sottonumerazioni

5.7

1, n(n â&#x2C6;&#x2019; 1)!,

se n = 0, se n > 1.

a = b + c,

(5.11a)

c = d,

(5.11b)

e = f + g.

(5.11c)

Le formule (5.11), e in particolare la (5.11b), . . .

modificare stile e corpo del font

In modo matematico, LATEX armonizza stile e corpo del font con il contesto in cui le formule si trovano. A volte, però, può essere necessario modificare a mano questi parametri. Gli esempi seguenti mostrano i comandi per cambiare lo stile del font e il loro risultato in stampa. $x+y+2^n M\cos t$ \\ $\mathit{x+y+2^n M\cos $\mathbf{x+y+2^n M\cos $\mathrm{x+y+2^n M\cos $\mathtt{x+y+2^n M\cos $\mathsf{x+y+2^n M\cos

Lettere maiuscole in corsivo

n! =

Lâ&#x20AC;&#x2122;ambiente subequations produce sottonumerazioni: \begin{subequations} \label{eqn:schema} \begin{align} a &= b+c, \\ c &= d, \label{eqn:sub} \\ e &= f+g. \end{align} \end{subequations} Le formule~\eqref{eqn:schema}, e in particolare la~\eqref{eqn:sub}, \dots

Font matematici

t}$ t}$ t}$ t}$ t}$

\\ \\ \\ \\

x + y + 2n M cos t x + y + 2n M cos t x + y + 2n M cos t x + y + 2n M cos t x + y + 2n M cos t x + y + 2n M cos t

Come si può osservare, i comandi agiscono su lettere e numeri, ma non sui segni di operazione.

Il comando \mathcal genera lettere maiuscole corsive: Siano $\mathcal{C}$ la circonferenza di centro~$O$ e raggio~$1$, $\mathcal{D}_1$ e $\mathcal{D}_2$ due rette.

Siano C la circonferenza di centro O e raggio 1, D1 e D2 due rette.

Spesso i compositori amatoriali abusano dei simboli in neretto, tipograficamente piuttosto â&#x20AC;&#x153;pesantiâ&#x20AC;?. Questi si ottengono con il comando

5.7 modificare stile e corpo del font

\mathbf . Il suo comportamento dipende in larga parte dalla serie di

103

font matematici in uso e di solito ha effetto soltanto sulle lettere e non sugli altri simboli. Si osservi l’esempio seguente: \[ \mu, M \qquad \mathbf{\mu}, \mathbf{M} \]

µ, M

—, M

Come si può osservare, il comando non ha effetto sulla lettera µ e restituisce lettere in tondo anziché in corsivo matematico.

Per comporre simboli matematici in neretto corsivo si consiglia il comando \bm del pacchetto bm. Si tenga presente che \bm funziona se (e solo se) il font matematico corrente dispone di una versione in neretto di quel simbolo. \[ \mu, M \qquad \bm{\mu}, \bm{M} \]

µ, M

µ, M

Gli indici letterali vanno scritti in corsivo matematico se rappresentano quantità variabili (cioè se sono dei simboli), in tondo se rappresentano apposizioni di una grandezza fisica (cioè se sono semplice testo).

In quest’ultimo caso si usa il comando \textup (o, in alternativa, il comando \ped specifico per l’italiano definito dall’opzione italian di babel: si veda il paragrafo 4.6.3 a pagina 65). \[ V_\textup{eff} \qquad \psi\ped{incidente} \]

Veff

Simboli in neretto corsivo

Indici letterali in tondo

ψincidente

Si confrontino le due scritture seguenti: $V_\textup{eff}$ \\ $V_{eff}$

Veff Veff

Come si può osservare, LATEX interpreta il pedice nel secondo codice come tre variabili da moltiplicare, stampandole in corsivo matematico e spaziate di conseguenza. Il codice corretto è il primo.

In modo matematico, la dimensione del font può essere impostata a mano con le quattro dichiarazioni \displaystyle , \textstyle , \scriptstyle e \scriptscriptstyle . Si considerino gli esempi seguenti: \[ \sum_{k=1}^n z^k \qquad n X Pn \textstyle\sum_{k=1}^n z^k k zk k=1 z \] k=1 $\displaystyle\sum_{k=1}^n n X P z^k$ k Pn zk Pn zk zk n k=1 k=1 k=1 z $\sum_{k=1}^n z^k$ k=1 $\scriptstyle\sum_{k=1}^n z^k$ $\scriptscriptstyle\sum_{k=1}^n z^k$

Impostare a mano la dimensione del font

104

la matematica

\[ x_G= \frac{\displaystyle\sum_{i=1}^n m_ix_i} {\displaystyle\sum_{i=1}^n m_i} \]

n X

xG =

mi xi

i=1 n X

mi

i=1

Come si può osservare, il cambiamento del corpo influisce anche sul modo in cui vengono stampati gli indici.

I comandi \dfrac e \tfrac si possono usare come abbreviazioni di {\displaystyle\frach. . .i} e {\textstyle\frach. . .i}: $\frac{1}{k}\log_2 c(f)$ \qquad $\dfrac{1}{k}\log_2 c(f)$ \[ \frac{1}{k}\log_2 c(f) \qquad \tfrac{1}{k}\log_2 c(f) \]

Introdurre e numerare strutture di testo

5.8

1 k

log2 c(f) 1 log2 c(f) k

1 log2 c(f) k 1 k

log2 c(f)

enunciati e dimostrazioni

Di qui in avanti si dà per caricato anche il pacchetto amsthm.

Nella scrittura della matematica è utile poter disporre di un metodo per introdurre e numerare definizioni, teoremi e strutture simili. I tipi di enunciato non sono predefiniti, ma vanno dichiarati dall’autore, chiamato a prendere alcune decisioni globali: • stabilire il tipo di enunciato da inserire (per esempio, definizioni e teoremi); • assegnare un nome a ogni ambiente (per esempio, definizione e teorema; non si può usare def, perché è già un comando di base di LATEX); • titolare gli enunciati (per esempio, con Definizione e Teorema).

\newtheorem

Il comando \newtheorem , nel preambolo, permette di fare le dichiarazioni globali e prevede due forme di definizione: \newtheorem{hnome dell’enunciatoi}{htitoloi}[hsezionei]

oppure, in alternativa, \newtheorem{hnome dell’enunciatoi}[hnumerato comei]{htitoloi}

dove: • hnome dell’enunciatoi è una parola chiave per identificare con facilità l’enunciato anche successivamente; • htitoloi specifica il titolo dell’enunciato che verrà stampato nel documento;

5.8 enunciati e dimostrazioni

• hsezionei specifica il livello di sezionamento (di regola, chapter o section) a cui collegare la numerazione dell’enunciato, mentre in hnumerato comei si scrive il nome di un enunciato dichiarato in precedenza, in modo che quello nuovo ne prosegua la numerazione.4

105

Il testo dell’enunciato va messo entro i consueti comandi di apertura e chiusura d’ambiente, e un’eventuale specificazione si scrive nell’argomento facoltativo immediatamente dopo il comando di apertura (verrà stampato fra parentesi tonde), così: \begin{hnome dell’enunciatoi}[heventuale specificazionei]

htesto dell’enunciatoi \end{hnome dell’enunciatoi}

Il pacchetto amsthm prevede tre stili predefiniti per gli enunciati (plain, definition e remark), i cui dettagli tipografici dipendono dalla classe di documento con cui si scrive, anche se in linea di massima il primo dei tre stampa il proprio contenuto in corsivo, mentre gli altri due lo lasciano in tondo. Di seguito si riportano le principali categorie di enunciato, ciascuna associata al suo stile più tipico:

Stili dell’enunciato

plain Per teoremi, lemmi, corollari, proposizioni, congetture, criteri, leggi e algoritmi. definition Per definizioni, condizioni, problemi ed esempi. remark Per osservazioni e annotazioni.

Si possono stampare gli enunciati con stili diversi dal predefinito plain dividendoli in gruppi per tipo di enunciato e premettendo a ciascun gruppo il comando \theoremstyle . (Si può personalizzare lo stile dell’enunciato con il comando \newtheoremstyle .)

A questo punto le nozioni teoriche dovrebbero bastare. Alcuni esempi mostreranno quanto si è appena esaminato. Scrivendo nel preambolo \theoremstyle{definition} \newtheorem{definizione}{Definizione} \theoremstyle{plain} \newtheorem{teorema}{Teorema}

gli ambienti definizione e teorema si usano così: \begin{definizione}[di Lord Kelvin] Si dice \emph{matematico} colui per il quale è ovvio che $\int_{-\infty}^{+\infty} e^{-x^2}\,dx=\sqrt{\pi}$. \end{definizione} \begin{teorema} I matematici, se ce ne sono, sono molto rari. \end{teorema}

Definizione 1 (di Lord Kelvin). Si dice matematico colui per il quale è R+∞ √ 2 ovvio che −∞ e−x dx = π.

Teorema 1. I matematici, se ce ne sono, sono molto rari.

4 La variante asterisco \newtheorem* produce enunciati non numerati.

Esempi di enunciati

106

la matematica

Il seguente teorema è a tutti ben noto. \begin{teorema}[di Pitagora] La somma dei quadrati costruiti sui cateti è uguale al quadrato costruito sull’ipotenusa. \end{teorema} La dimostrazione è lasciata per esercizio.

Enunciati numerati con la stessa sequenza numerica

Il seguente teorema è a tutti ben noto.

Teorema 2 (di Pitagora). La somma dei quadrati costruiti sui cateti è uguale al quadrato costruito sull’ipotenusa.

La dimostrazione è lasciata per esercizio.

Come si può osservare, LATEX numera automaticamente in neretto (e ne conclude l’intestazione con un punto fermo) ogni enunciato e lo stacca dal resto del testo senza rientrarne il titolo. Lo stile delle definizioni è in tondo, e quello dei teoremi in corsivo.

L’esempio seguente riguarda la numerazione di una sequenza di tre enunciati consecutivi, il primo e il terzo dei quali sono dello stesso tipo, ma il secondo no. Scrivendo nel preambolo \theoremstyle{plain} \newtheorem{legge}{Legge} \newtheorem{decreto}[legge]{Decreto}

gli ambienti legge e decreto si usano come segue: \begin{legge} \label{lex:capo} Il capo ha ragione. \end{legge} \begin{decreto}[Aggiornamento alla legge~\ref{lex:capo}] Il capo ha \emph{sempre} ragione. \end{decreto} \begin{legge} Se il capo ha torto, vedere la legge~\ref{lex:capo}. \end{legge}

Enunciati numerati secondo il paragrafo corrente

Legge 1. Il capo ha ragione.

Decreto 2 (Aggiornamento alla legge 1). Il capo ha sempre ragione.

Legge 3. Se il capo ha torto, vedere la legge 1.

Come si può osservare, il numero assegnato a Decreto prosegue la numerazione di Legge anziché cominciarne una nuova, perché l’argomento facoltativo [legge] assegnato alla definizione del teorema nel preambolo assegna entrambi i tipi di enunciato allo stesso contatore. Ancora, si può assegnare un’etichetta a un enunciato per potervisi riferire da un punto qualsiasi del documento.

Se si desidera introdurre un enunciato Murphy, per esempio, la cui numerazione sia collegata al paragrafo corrente, basta specificare nell’argomento facoltativo l’opzione section, in questo modo: \newtheorem{murphy}{Murphy}[section]

5.8 enunciati e dimostrazioni

L’ambiente murphy così definito si usa come di consueto: \begin{murphy} Se esistono due o più modi per fare una cosa, e uno di questi può creare una catastrofe, allora qualcuno lo sceglierà. \end{murphy}

Murphy 5.8.1. Se esistono due o più modi per fare una cosa, e uno di questi può creare una catastrofe, allora qualcuno lo sceglierà.

Per scrivere una dimostrazione si usa l’ambiente proof, che ne segnala la fine stampando un quadratino.

Si osservi l’esempio seguente: \begin{teorema}[Sorpresa] Si ha che $0=1$. \end{teorema} \begin{proof} Da $e^{2n\pi i}=1$ segue che $e^{1+2n\pi i}=e$, poi $(e^{1+2n\pi i})^{1+2n\pi i}= e^{1+2n\pi i}=e$, per cui $e^{1+4n\pi i-4n^2\pi^2}=e$, e infine $e^{4n\pi i4n^2\pi^2}=1$. Mandando $n\to+\infty$ si ha la tesi. \end{proof}

107

Dimostrazioni

Teorema 3 (Sorpresa). Si ha che 0 = 1.

Dimostrazione. Da e2nπi = 1 segue che e1+2nπi = e, poi (e1+2nπi )1+2nπi = e1+2nπi = e, 2 2 per cui e1+4nπi−4n π = e, e in2 2 fine e4nπi−4n π = 1. Mandando n → +∞ si ha la tesi.

Per sostituire la scritta Dimostrazione con un’altra, per esempio Soluzione, basta scrivere

Sostituire l’intestazione

\begin{proof}[Soluzione]

Il comando \qedhere colloca correttamente il simbolo di “fine dimostrazione” anche se questa termina con una formula in display. Si confrontino i due esempi seguenti: \begin{proof} Basta usare la formula \[ E=mc^2. \] \end{proof}

\begin{proof} Basta usare la formula \[ E=mc^2.\qedhere \] \end{proof}

Dimostrazione. Basta usare la formula E = mc2 .

Dimostrazione. Basta usare la formula E = mc2 .

Come si può osservare, il primo dei due presenta il quadratino collocato in modo (leggermente) sbagliato.

Chiudere una dimostrazione

108

Disegnare semplici diagrammi commutativi con il pacchetto amscd

la matematica

5.9

diagrammi commutativi

I diagrammi commutativi sono particolari oggetti a metà strada fra un insieme di espressioni matematiche e un disegno che le mette in relazione tra di loro.

Il pacchetto amscd definisce un ambiente CD (da usare soltanto all’interno di un ulteriore ambiente per formule in display) con cui si possono disegnare diagrammi commutativi piani e senza frecce diagonali. Per diagrammi più complessi ci sono pacchetti più sofisticati, come PSTricks, Xy-pic o il recente xypdf. \[ \begin{CD} A @>f>> B \\ @V{g}VV @VV{h}V \\ C @>>k> D \\ \end{CD} \]

siunitx

5.10

f

A −−−−−→   gy

B   yh

C −−−−−→ D k

fisica e chimica

Le unità di misura del Sistema Internazionale si inseriscono con i comandi del pacchetto siunitx (se ne veda la documentazione), che permette di regolarne molto finemente il formato e di cambiare convenzione tipografica operando un’unica modifica nel preambolo anziché agire a mano su un’unità di misura alla volta.

Le convenzioni tipografiche italiane prevedono la virgola e non il punto (predefinito dal pacchetto) come separatore decimale. Il pacchetto va caricato così: \usepackage[output-decimal-marker={,}]{siunitx}

Ecco qualche esempio: \SI{23.4}{kg.m.s^{-2}} \\ $r=\SI{0.8768(11)e-15}{m}$ \\ \si{\joule\per\mole% \per\kelvin} \\ \si{j.mol^{-1}.K^{-1}} \SI{100}{\celsius} \\ \ang{1;2;3} \\

23,4 kg m s−2 r = 0,8768(11) × 10−15 m J mol−1 K−1 j mol−1 K−1 100 ◦C 1°20 300

Tutti i precedenti comandi funzionano sia in modo testuale sia in modo matematico. Si tenga presente, tuttavia, che se le unità di misura da inserire nel documento sono poche, si possono sempre scrivere senza usare i comandi dedicati, come si può vedere nell’esempio seguente: L’auto viaggiava a 65\,km/h.

L’auto viaggiava a 65 km/h.

Se si prevede di inserire i simboli dei gradi Celsius o di quelli sessagesimali, si consiglia di caricare anche il pacchetto textcomp, che abilita la ricerca di ° nel documento stampato.

\ryl(5==NH--SO$ {2}$)% {4==\bzdrh{1==(yl)}}

7.11

NH–SO2

EVIDENZIARE FORMULE 5.11 evidenziare formule:

il pacchetto empheq

Se si desidera dare particolare evidenza ad una formula, è utile comporre formule chimiche utile il pacchetto mhchem. il Per pacchetto empheq . (Il primo dei èseguenti due esempi richiedePer il esempio: xcolor.) pacchetto \newcommand*\mygraybox[1]{% \ce{H2O} \qquad \colorbox{lightgray}{#1}} \ce{^{227}_{90}Th+} \qquad \begin{empheq}[box=% \ce{C6H5-CHO} \\[1ex] \mygraybox]{align*} \ce{SO4^2- + Ba^2+ -> BaSO4 v} a &= b \\ E &= mc^2 + \int_a^a x\, dx Il pacchetto XyMTeX compone \end{empheq}

109

Il pacchetto empheq Formule chimiche

+ 227 C6 H− 90Th 5 CHO a=b &a 4 ↓ SO42− + Ba 2+ −−→ BaSO E = mc2 + x dx

H2 O

a

le formule di struttura.

Formule di struttura

\ryl(5==NH--SO$_{2}$)% NH–SO2 \begin{empheq}[box=% {4==\bzdrh{1==(yl)}} a=b \fbox]{align*} &a a &= b \\ 2 E = mc + x dx _a^a InE alternativa si può usare &= mc^2 + \int x\, il dxpacchetto ppchtex. a \end{empheq} Il pacchetto feynmf disegna i grafici di Feynman.

Grafici di Feynman

\begin{fmffile}{esempio} \begin{fmfgraph*}(40,25) \fmfleft{em,ep} \fmf{fermion}{em,Zee,ep} \fmf{photon}{Zee,Zff} \fmf{fermion}{fb,Zff,f} \fmfright{fb,f} \fmfdot{Zee,Zff} \end{fmfgraph*} \end{fmffile}

Per la scrittura di tutte le altre discipline scientifiche si rimanda il

lettore alELENCO catalogo tematico dei pacchettiMATEMATICI disponibile su + sarovar.

7.12 DEI SIMBOLI

Nelle seguenti tabelle si possono trovare tutti i simboli ai quali si può accedere normalmente dall’ambiente matematico. Queste tabelle 5.11 evidenziare formule sono prese da [?, p. 52-58]. (Per un elenco esauriente dei simboli di LATEX, vedi [?].)

Per evidenziare una formula con uno sfondo colorato o con una cornice è utile il pacchetto empheq. (Il primo dei due esempi che seguono richiede xcolor.) \newcommand*\mygraybox[1]{% \colorbox{lightgray}{#1}} \begin{empheq}[box=% \mygraybox]{align*} a &= b \\ E &= mc^2 + \int_a^a x\, dx \end{empheq}

\begin{empheq}[box=% \fbox]{align*} a &= b \\ E &= mc^2 + \int_a^a x\, dx \end{empheq}

a=b E = mc2 +

Za x dx a

a=b E = mc2 +

Za x dx a

empheq

110

la matematica

5.12

elenco dei simboli matematici

Le seguenti tabelle, tratte da [Oetiker et al., 2010], riportano tutti i simboli normalmente disponibili in modo matematico. (Per un elenco completo dei simboli di LATEX, si veda [Pakin, 2009].)

Tabella 12: Lettere greche minuscole.

ι β γ δ

Îľ Îś Ρ θ Ď&#x2018;

\alpha \beta \gamma \delta \epsilon \varepsilon \zeta \eta \theta \vartheta

Κ Îş Îť Âľ ν Ξ o Ď&#x20AC; $ Ď

\iota \kappa \lambda \mu \nu \xi o \pi \varpi \rho

Ď Ď&#x192; Ď&#x192; Ď&#x201E; Ď&#x2026; Ď&#x2020; Ď&#x2022; Ď&#x2021; Ď&#x2C6; Ď&#x2030;

\varrho \sigma \varsigma \tau \upsilon \phi \varphi \chi \psi \omega

Tabella 13: Lettere greche maiuscole.

Î&#x201C; â&#x2C6;&#x2020; Î&#x2DC; Î&#x203A;

\Gamma \Delta \Theta \Lambda

Î&#x17E; Î ÎŁ ÎĽ

\Xi \Pi \Sigma \Upsilon

ÎŚ Ψ â&#x201E;Ś

\Phi \Psi \Omega

Tabella 14: Accenti in modo matematico.

aÂŻ a ~ a´ aË&#x2021;

\bar{a} \vec{a} \acute{a} \check{a}

aË&#x2020; aË&#x2122; a` b A

\hat{a} \dot{a} \grave{a} \widehat{a}

aË&#x153; a¨ aË&#x2DC; e A

\tilde{a} \ddot{a} \breve{a} \widetilde{a}

5.12 elenco dei simboli matematici

Tabella 15: Relazioni binarie.

< 6

≺

⊂ ⊆ < v ∈ ` | ^ :

< \leq o \le \ll \prec \preceq \subset \subseteq \sqsubset \sqsubseteq \in \vdash \mid \smile :

> >

⊃ ⊇ = w 3 a k _ ∈ /

> \geq o \ge \gg \succ \succeq \supset \supseteq \sqsupset \sqsupseteq \ni o \owns \dashv \parallel \frown \notin

= ≡ . = ∼ ' ≈ ∼ = 1 ./ ∝ |= ⊥

6=

= \equiv \doteq \sim \simeq \approx \cong \Join \bowtie \propto \models \perp \asymp \neq o \ne

Tabella 16: Operazioni binarie. + ± · × ∪ t ∨ ⊕

⊗ 4

+ \pm \cdot \times \cup \sqcup \vee o \lor \oplus \odot \otimes \bigtriangleup \lhd \unlhd

− ∓ ÷ \ ∩ u ∧

5

\mp \div \setminus \cap \sqcap \wedge o \land \ominus \oslash \bigcirc \bigtriangledown \rhd \unrhd

/ . ? ∗ ◦ •

] q † ‡ o

\triangleleft \triangleright \star \ast \circ \bullet \diamond \uplus \amalg \dagger \ddagger \wr

111

112

la matematica

Tabella 17: Grandi operatori.

P R T L U

Q H W N J

\sum \int \bigcap \bigoplus \biguplus

` S V

\prod \oint \bigvee \bigotimes \bigodot

\coprod \bigcup \bigwedge

Tabella 18: Delimitatori. ( ) h i ↑ ↓ l / q

       

( ) \langle \rangle \uparrow \downarrow \updownarrow / \urcorner

\lgroup \rgroup \bracevert

[ ] b c ⇑ ⇓ m \ x

[ o \lbrack ] o \rbrack \lfloor \rfloor \Uparrow \Downarrow \Updownarrow \backslash \llcorner

{ } d e | k p y

\{ o \lbrace \} o \rbrace \lceil \rceil | o \vert \| o \Vert . (carattere fantasma) \ulcorner \lrcorner

Tabella 19: Grandi delimitatori.   \lmoustache   \rmoustache

 

\arrowvert

w w

\Arrowvert

5.12 elenco dei simboli matematici

Tabella 20: Frecce. â&#x2020;? â&#x2020;&#x2019; â&#x2020;&#x201D; â&#x2021;? â&#x2021;&#x2019; â&#x2021;&#x201D; 7 â&#x2020;&#x2019; â&#x2020;?â&#x2020;&#x2018; â&#x2020;&#x201C; l ( )

L99 â&#x2021;&#x201D;

W

" x

% . ;

\leftarrow o \gets \rightarrow o \to \leftrightarrow \Leftarrow \Rightarrow \Leftrightarrow \mapsto \hookleftarrow \uparrow \downarrow \updownarrow \leftharpoonup \leftharpoondown \rightleftharpoons \dashleftarrow \leftleftarrows \leftrightarrows \Lleftarrow \twoheadleftarrow \leftarrowtail \leftrightharpoons \Lsh \looparrowleft \curvearrowleft \circlearrowleft \nearrow \swarrow \leadsto \upuparrows \upharpoonleft \downharpoonleft \rightsquigarrow

â&#x2020;?â&#x2C6;&#x2019; â&#x2C6;&#x2019;â&#x2020;&#x2019; â&#x2020;?â&#x2020;&#x2019; â&#x2021;?= =â&#x2021;&#x2019; â&#x2021;?â&#x2021;&#x2019; 7â&#x2C6;&#x2019;â&#x2020;&#x2019; ,â&#x2020;&#x2019; â&#x2021;&#x2018; â&#x2021;&#x201C; m * + â&#x2021;?â&#x2021;&#x2019; 99K â&#x2021;&#x2019;

V

# y

& (

!

\longleftarrow \longrightarrow \longleftrightarrow \Longleftarrow \Longrightarrow \Longleftrightarrow \longmapsto \hookrightarrow \Uparrow \Downarrow \Updownarrow \rightharpoonup \rightharpoondown \iff (con spazi grandi) \dashrightarrow \rightrightarrows \rightleftarrows \Rrightarrow \twoheadrightarrow \rightarrowtail \rightleftharpoons \Rsh \looparrowright \curvearrowright \circlearrowright \searrow \nwarrow \multimap \downdownarrows \upharpoonright \downharpoonright \leftrightsquigarrow

113

114

la matematica

Tabella 21: Simboli misti. ... ··· .. . .. . ♥ ♦ ♣ ♠ ı  3 ∠ \

M O ♦ ∠ ] ^

< =

\dots \cdots

\Re \Im

∞ ∂

\infty \partial

\vdots

∀

\forall

∇

\nabla

\ddots \heartsuit \diamondsuit \clubsuit \spadesuit \imath \jmath \Diamond \angle \natural \square \vartriangle \triangledown \lozenge \angle \measuredangle \sphericalangle

∃ ` h h ℘ 4 ⊥ √

\exists \neg o \lnot \ell \hbar \hslash \wp \triangle \bot \surd \sharp \blacksquare \blacktriangle \blacktriangledown \blacklozenge \diagup \diagdown \backprime

∅ { ℵ

\emptyset \complement \aleph ’ \prime \mho \Box \top \flat \Bbbk \circledS \eth \Game \bigstar \nexists \Finv \varnothing

]

N H

8

0

0 0 2 > [ k s ð a F @ ` ∅

Tabella 22: Simboli non matematici (da potersi usare anche in modo testuale).

† ‡

\dag \ddag

§ ¶

\S \P

© £

\copyright \pounds

Tabella 23: Altri caratteri alfabetici.

z k

\digamma \daleth

κ ‫ג‬

\varkappa \gimel

i

\beth

5.12 elenco dei simboli matematici

Tabella 24: Altre relazioni binarie. l 6 0 5 â&#x2030;Ş . / â&#x2030;ś Q S 4 2 w j b < â&#x2C6;´ p ` C E

\lessdot \leqslant \eqslantless \leqq \llless o \lll

m > 1 = â&#x2030;Ť & ' â&#x2030;ˇ R

\lesssim \lessapprox \lessgtr \lesseqgtr \lesseqqgtr \preccurlyeq \curlyeqprec \precsim \precapprox \subseteqq \Subset \sqsubset \therefore \shortmid \smallsmile \vartriangleleft \trianglelefteq

T < 3 % v k c = â&#x2C6;ľ q a B D

\gtrdot \geqslant \eqslantgtr \geqq \gggtr o \ggg \gtrsim \gtrapprox \gtrless \gtreqless \gtreqqless \succcurlyeq \curlyeqsucc \succsim \succapprox \supseteqq \Supset \sqsupset \because \shortparallel \smallfrown \vartriangleright \trianglerighteq

+ : ; P $ , l m â&#x2C6;ź

\doteqdot o \Doteq \risingdotseq \fallingdotseq \eqcirc \circeq

â&#x2030;&#x2C6; u v w

â&#x2C6;?

G t J I

\thickapprox

\triangleq \bumpeq \Bumpeq \thicksim \approxeq \backsim \backsimeq \vDash \Vdash \Vvdash \backepsilon \varpropto \between \pitchfork \blacktriangleleft \blacktriangleright

Tabella 25: Altre operazioni binarie. u n d Y

h g | r

~

\dotplus \ltimes \Cup o \doublecup \veebar \boxplus \boxtimes \leftthreetimes \curlyvee \intercal \smallsetminus \circleddash \circledast

o e Z

i f > [ }

\centerdot \rtimes \Cap o \doublecap \barwedge \boxminus \boxdot \rightthreetimes \curlywedge \divideontimes \doublebarwedge \circledcirc

115

116

la matematica

Tabella 26: Negazioni di simboli. â&#x2030;Ž

\nless \lneq \nleq \nleqslant \lneqq \lvertneqq

â&#x160;&#x20AC;

(

\nleqq

* $ 8 :

\lnsim \lnapprox \nprec \npreceq \precneqq \precnsim \precnapprox \subsetneq \varsubsetneq \nsubseteq \subsetneqq \nleftarrow \nLeftarrow

â&#x2030;Ż

) ! + % 9 ;

\ngtr \gneq \ngeq \ngeqslant \gneqq \gvertneqq

& ' " # â&#x2C6;Ś . /

0 2 1 3 6 7 5 4 = <

\ngeqq \gnsim \gnapprox \nsucc \nsucceq \succneqq \succnsim \succnapprox \supsetneq \varsupsetneq \nsupseteq \supsetneqq \nrightarrow \nRightarrow

\varsubsetneqq \varsupsetneqq \nsubseteqq \nsupseteqq \nmid \nparallel \nshortmid \nshortparallel \nsim \ncong \nvdash \nvDash \nVdash \nVDash \ntriangleleft \ntriangleright \ntrianglelefteq \ntrianglerighteq \nleftrightarrow \nLeftrightarrow

Tabella 27: Font matematici.

Esempio

Comando

ABCdef ABCdef ABCdef

\mathit{ABCdef} \mathbf{ABCdef} \mathrm{ABCdef} \mathtt{ABCdef} \mathsf{ABCdef} \mathnormal{ABCdef} \mathcal{ABC} \mathscr{ABC} \mathcal{ABC} \mathbb{ABC}

ABCdef

ABCdef ABCdef ABC A BC ABC ABC

Pacchetto richiesto

mathrsfs eucal amssymb

6 indice 6.1 6.2 6.3

6.4

6.5

TA B E L L E E F I G U R E Strumenti fondamentali 117 Oggetti “in testo” e “fuori testo” 119 Tabelle 120 6.3.1 Indicazioni generali 120 6.3.2 Tabelle standard: tabular e array 122 6.3.3 Celle con testo troppo lungo 123 6.3.4 Colonne di soli numeri: siunitx 125 6.3.5 Celle multicolonna 127 6.3.6 Celle multiriga 128 6.3.7 Spaziare a mano righe e colonne 129 6.3.8 Personalizzare le colonne: array 130 6.3.9 Tabelle colorate 133 6.3.10 Tabelle con note 134 6.3.11 Tabelle grandi 134 Figure 139 6.4.1 Immagini vettoriali e bitmap 139 6.4.2 Convertire i formati 140 6.4.3 Ritagliare le immagini 140 6.4.4 Alcuni programmi utili 141 6.4.5 Includere le immagini 142 Oggetti mobili 144 6.5.1 Gli ambienti table e figure 144 6.5.2 Codici tipo 146 6.5.3 Controllare gli oggetti mobili 147 6.5.4 Personalizzare le didascalie: caption 149 6.5.5 Specialità 150

Tabelle e figure sono tra gli oggetti più usati nella composizione dei documenti, specialmente quelli scientifici, e tra gli argomenti più estesamente trattati dalle guide. Questo capitolo ne illustra i concetti di base e gli strumenti fondamentali per produrle, inserirle nel documento e gestirle.

Di qui in avanti si danno per caricati i pacchetti booktabs e graphicx.

6.1

strumenti fondamentali

Per trattare tabelle e figure, LATEX offre all’autore tre strumenti di base: • l’ambiente tabular, per comporre tabelle che contengono prevalentemente testo; • l’ambiente array, per comporre tabelle che contengono prevalentemente matematica;

117

118

tabelle e figure

• il comando \includegraphics , per includere nel documento le figure (che sono sempre file esterni a esso).

Li si vede all’opera nei tre esempi seguenti, i cui comandi e ambienti verranno spiegati nei prossimi paragrafi.

La tabella testuale \begin{center} \begin{tabular}{ll} \toprule Alcaloide & Origine \\ \midrule atropina & belladonna \\ chinina & china \\ morfina & papavero \\ nicotina & tabacco \\ \bottomrule \end{tabular} \end{center} mostra l’origine vegetale di alcuni alcaloidi.

La tabella matematica \[ \begin{array}{ll} \toprule f(x) & f’(x) \\ \midrule k & 0 \\ x^n & nx^{n-1} \\ e^x & e^x \\ \sin x & \cos x \\ \bottomrule \end{array} \] mostra le derivate di alcune funzioni elementari.

La figura \begin{center} \includegraphics[width=% 0.5\columnwidth]{Rettili} \end{center} riproduce l’incisione su legno \emph{Tassellazione del piano con rettili} di M.~Escher.

La tabella testuale Alcaloide

Origine

atropina chinina morfina nicotina

belladonna china papavero tabacco

mostra l’origine vegetale di alcuni alcaloidi.

La tabella matematica f(x)

f 0 (x)

k xn ex sin x

0 nxn−1 ex cos x

mostra le derivate di alcune funzioni elementari.

La figura

riproduce l’incisione su legno Tassellazione del piano con rettili di M. Escher.

Si noti che: Le scatole di LATEX

• Tutti e tre non cominciano un nuovo capoverso, ma producono un’unità tipografica indivisibile che il programma tratta come se fosse un unico carattere (un box o scatola, nel gergo di LATEX), e

6.2 oggetti “in testo” e “fuori testo”

che nel caso di tabular e \includegraphics va centrata rispetto alla giustezza del testo mettendola nell’ambiente center;

119

• Una tabella scritta con array va a sua volta racchiusa tra comandi matematici. Quelli per le formule “in display” \[. . .\] (i più usati), sostituiscono l’ambiente center, che va dunque omesso.1 • Si consiglia di assegnare alle figure (e a qualche tabella particolare) una larghezza relativa a un parametro di riferimento, e mai assoluta. Quest’ultimo, di solito la giustezza della riga, si può esprimere con due valori non sempre coincidenti: \textwidth (cioè la larghezza della riga stabilita dalla classe di documento con cui si sta scrivendo) o \columnwidth (cioè la larghezza della colonna di composizione). Molto spesso è più conveniente riferirsi al secondo dei due, perché così facendo l’oggetto mantiene le proporzioni rispetto alla riga anche quando si passa da una a più colonne e viceversa.2

\columnwidth \textwidth

• center si omette anche quando si vuole mettere una figura particolarmente piccola (un logo) direttamente sulla linea del testo, come mostra l’esempio seguente: Il simbolo della mela \includegraphics[width=% 0.10\columnwidth]{apple} è il logo di Apple, Inc.

6.2

Il simbolo della mela di Apple, Inc.

Ð

è il logo

oggetti “in testo” e “fuori testo”

In tipografia esistono due tipi di oggetto: “in testo” e “fuori testo”.

Tabelle e figure “in testo” Una tabella (o una figura) “in testo”, come quelle degli esempi appena considerati, appartiene al flusso del discorso e non può essere collocata altrove senza danneggiarlo. Oggetti di questo tipo non prevedono la didascalia (proprio perché la loro funzione è spiegata dal testo che li precede e li segue) né riferimenti espliciti a sé stessi da altre parti del documento, e devono essere di chiarissima comprensione.

Si noti che gli oggetti in testo dovrebbero costituire delle eccezioni (tornano utili per mettere un logo proprio “lì” e in pochissime altre circostanze), perché possono creare problemi nell’impaginazione irrisolvibili. Si immagini, infatti, di dover mettere a fondo pagina un’immagine più alta dello spazio a disposizione: LATEX la sposterebbe in una pagina nuova senza colmare lo spazio residuo e si comporterebbe così in tutte le situazioni analoghe, con un risultato tipograficamente scadente.

1 Se l’opzione di classe fleqn è attiva, però, la tabella non risulterà più centrata.

2 Si noti che alcuni pacchetti dedicati alla geometria della pagina (layaureo o geometry, per esempio) modificano il valore standard di \textwidth anche solo caricandoli.

Gli oggetti in testo devono essere eccezionali.

120

tabelle e figure

Tabella 28: Tabella che viola le regole generali.

D .500 m 1.50 m 10.0 m

P 269.8 kg 421.0 kg 640.2 kg

u .000674 m .001035 m .001565 m

β 1.79 3.59 7.18

G .04089 Pa ” ”

Tabella 29: Tabella che rispetta le regole generali.

D (m)

P (kg)

u (m)

β

G (Pa)

0,500 1,50 10,0

269,8 421,0 640,2

0,000 674 0,001 035 0,001 565

1,79 3,59 7,18

0,040 89 0,040 89 0,040 89

Tabelle e figure “fuori testo” Una tabella (o una figura) “fuori testo”, invece, non appartiene al flusso del discorso e per esigenze tipografiche può essere spostata altrove rispetto al punto d’inclusione. Oggetti di questo tipo, perciò, prevedono una didascalia che ne illustri il contenuto e un numero progressivo al quale potersi riferire direttamente da altre parti del documento.

Il principale vantaggio degli oggetti fuori testo (si veda il paragrafo 6.5 a pagina 144), la cui gestione è uno dei punti di forza di LATEX, è l’ottimale riempimento della pagina, che altrimenti andrebbe perso.

Indipendentemente dalle dimensioni del documento, perciò, si raccomanda di includerli sempre fuori testo, grandi o piccoli che siano (come si è fatto in tutta questa guida), vincendo quanto prima le iniziali e comprensibili perplessità derivanti dal non vedere praticamente mai gli oggetti nel punto esatto in cui li si è inseriti nel file sorgente.

6.3

tabelle

Comporre tabelle di altissima qualità è una delle specialità di LATEX, ma i suoi comandi standard sono piuttosto limitati. Numerosi pacchetti, però, ne definiscono di nuovi e più avanzati con cui si può personalizzare finemente il proprio lavoro. Questo paragrafo, basato su [Mori, 2006], cui si rimanda per ogni approfondimento, spiega come usare gli uni e gli altri e affronta gli aspetti principali dell’argomento.

6.3.1

Indicazioni generali

Regole generali di composizione Regole generali per comporre le tabelle

La composizione di una tabella dovrebbe fondarsi sulle seguenti regole [Fear, 2005]: • non usare mai filetti verticali; • evitare filetti doppi;

6.3 tabelle

• scrivere le unità di misura nell’intestazione della colonna (e non nel corpo della tabella);

121

• non usare le virgolette per ripetere il contenuto di una cella; • far precedere sempre il separatore decimale da una cifra.

A queste si aggiungano le seguenti: • incolonnare i numeri al separatore decimale, se presente; • usare i numeri maiuscoli nelle tabelle numeriche (si veda il paragrafo A.4.2 a pagina 201); • nei documenti in italiano, usare la virgola e non il punto come separatore decimale.

Così vuole la tradizione tipografica, in contrasto con la cattiva abitudine, purtroppo oggi molto diffusa, di comporre le tabelle come se fossero parti di un foglio elettronico. Per capire quanto sia importante rispettare queste regole, si confrontino le tabelle 28 e 29 nella pagina precedente.

Separare le celle e chiudere le righe Le celle di una tabella vanno separate tra loro con il carattere separatore & e le righe devono terminare con il comando \\, pena l’errore.

Filetti orizzontali: booktabs

Per stampare i filetti orizzontali della tabella il pacchetto booktabs definisce tre nuovi comandi che sostituscono lo standard \hline , dalla resa tipografica insoddisfacente per via dello spazio troppo risicato che LATEX lascia tra i filetti e il testo nelle celle. Questi comandi non vogliono \\ dopo di sé, stampano filetti di spessori differenti (le righe prodotte da \midrule , infatti, sono più sottili delle altre) e vanno dati secondo un ordine rigoroso: 1. \toprule stampa il primo filetto della tabella; 2. \midrule stampa il filetto interno (o, ripetendolo, i filetti, ma non se ne abusi); 3. \bottomrule stampa l’ultimo filetto.

“Riassumere” colonne dello stesso tipo Per “alleggerire” il codice sorgente, nel preambolo di una tabella si può sempre usare la scrittura *{hni}{hdescrittorei}

equivalente a hni colonne consecutive del tipo indicato dal hdescrittorei (si veda l’esempio riportato nel paragrafo 6.3.8 a pagina 131).

booktabs

122

tabelle e figure

Tabella 30: Descrittori standard delle colonne.

Descrittore l c r p{hlarghezzai}

Spiegazione Allinea il contenuto della cella a sinistra (left) Centra il contenuto della cella (center) Allinea il contenuto della cella a destra (right) Giustifica un blocco di testo largo hlarghezzai

Codice “ordinato” Anche se LATEX non richiede di incolonnare le celle nel codice sorgente, si consiglia di farlo ugualmente: un codice ordinato facilita eventuali modifiche successive e diminuisce la probabilità di commettere errori.

tabular array

6.3.2 Tabelle standard: tabular e array

In linea generale, una tabella che contiene prevalentemente testo va composta dentro l’ambiente tabular; una tabella che contiene prevalentemente matematica va composta dentro l’ambiente array. Entrambi si comportano in modo molto simile, come si può osservare negli esempi seguenti: \begin{tabular}{lcr} \toprule Grandezza & Simbolo & \midrule forza & $F$ & energia & $E$ & frequenza & $\nu$ & \bottomrule \end{tabular}

Unità \\

Grandezza

Simbolo

newton \\ joule \\ hertz \\

forza energia frequenza

F E ν

\[ \begin{array}{cc} \toprule f(x) & \text{Una primitiva} \\ \midrule e^x & e^x \\ \cos x & \sin x \\ \sin x & -\cos x \\ \bottomrule \end{array} \]

Unità newton joule hertz

f(x)

Una primitiva

ex

ex sin x − cos x

cos x sin x

Alle osservazioni del paragrafo 6.1 a pagina 117 si aggiungano le seguenti: • tabular e array richiedono un argomento, detto preambolo della tabella, formato da un certo numero di caratteri descrittori, ciascuno dei quali definisce il comportamento di un tipo di colonna come spiegato nella tabella 30;

Tabella 31: Tabella con colonna p.

6.3 tabelle

Forza

Una forza è una grandezza fisica che si manifesta nell’interazione di due o più corpi materiali, che cambia lo stato di quiete o di moto dei corpi stessi.

Momento polare

Il momento polare di una forza rispetto a una determinata origine è definito come il prodotto vettoriale tra il vettore posizione (rispetto alla stessa origine) e la forza.

123

• in tabular, eventuali formule matematiche si scrivono con i comandi per le formule in linea, per esempio fra dollari $. . .$; • in array, un eventuale testo si scrive nell’argomento del comando \text del pacchetto amsmath, che va dunque caricato.

6.3.3 Celle con testo troppo lungo

Le tabelle migliori si ottengono lasciando loro la propria larghezza “naturale”. È ciò che fanno automaticamente i tre descrittori appena visti, allargando naturalmente la cella per adattarla al proprio contenuto. Se quest’ultimo è costituito da un testo troppo lungo, però, la tabella eccede la giustezza della riga e il compilatore lo notifica con il relativo avviso. Per queste celle, e soltanto per queste, non si possono più usare i descrittori l, c e r, ma bisogna ricorrere ad altri strumenti:

Larghezza naturale e larghezza prefissata

• a una colonna p, che permette di stabilire a priori la larghezza di una sola colonna; • al pacchetto tabularx, che permette di stabilire a priori la larghezza dell’intera tabella.

Ovviamente, le altre celle rimarranno della propria larghezza naturale.

Colonne di larghezza prefissata L’esempio seguente mostra all’opera il descrittore p{hlarghezzai}, spiegato nella tabella 30 a fronte. Il codice \begin{tabular}{lp{0.5\columnwidth}} \toprule \textbf{Forza} & Una forza è una grandezza fisica che si manifesta nell’interazione di due o più corpi materiali, che cambia lo stato di quiete o di moto dei corpi stessi. \\ \midrule \textbf{Momento polare} & Il momento polare di una forza rispetto a una determinata origine è definito come il prodotto vettoriale tra il vettore posizione (rispetto alla stessa origine) e la forza. \\ \bottomrule \end{tabular}

Colonne standard p

124

tabelle e figure

Tabella 32: Tabella di larghezza prefissata ottenuta con il pacchetto tabularx.

Forza

Una forza è una grandezza fisica che si manifesta nell’interazione di due o più corpi materiali, che cambia lo stato di quiete o di moto dei corpi stessi.

Momento polare

Il momento polare di una forza rispetto a una determinata origine è definito come il prodotto vettoriale tra il vettore posizione (rispetto alla stessa origine) e la forza.

produce la tabella 31 nella pagina precedente. Si noti che: • \textbf stampa il proprio argomento in neretto; • per impostazione predefinita, in una colonna p il testo viene giustificato e sillabato automaticamente (ma lo si può ottenere anche centrato o allineato a destra o a sinistra, come si spiega nel paragrafo 6.3.8 a pagina 130); • se presenti, le colonne l, c e r rimangono della loro larghezza naturale.

Tabelle di larghezza prefissata Colonne X

Il pacchetto tabularx, che carica il pacchetto array (si veda il paragrafo 6.3.8 a pagina 130), definisce l’omonimo ambiente tabularx e un nuovo tipo di colonna X, che alle caratteristiche delle colonne p esaminate nel paragrafo precedente aggiunge un vantaggio: è LATEX a calcolarne automaticamente la larghezza sulla base della larghezza complessiva assegnata all’intera tabella.

Infatti tabularx richiede obbligatoriamente un secondo argomento in cui indicare tale larghezza (nel prossimo esempio pari a \columnwidth , ma sono ammessi anche altri valori, da impostare come già spiegato nel paragrafo 6.1 a pagina 117) Il codice seguente, che produce la tabella 32, mostra il pacchetto all’opera. \begin{tabularx}{\columnwidth}{lX} \toprule \textbf{Forza} & Una forza è una grandezza fisica che si manifesta nell’interazione di due o più corpi materiali, che cambia lo stato di quiete o di moto dei corpi stessi. \\ \midrule \textbf{Momento polare} & Il momento polare di una forza rispetto a una determinata origine è definito come il prodotto vettoriale tra il vettore posizione (rispetto alla stessa origine) e la forza. \\ \bottomrule \end{tabularx}

Si noti che tabularx richiede obbligatoriamente un secondo argomento nel quale indicare la larghezza complessiva dell’intera tabella (qui pari a \columnwidth , ma sono ammessi anche altri valori, da impostare come già spiegato nel paragrafo 6.1 a pagina 117).

6.3 tabelle

Tabella 33: Tabella ottenuta con il pacchetto tabularx con due colonne della della stessa larghezza.

Periodo

Fenomeni geologici

Biosfera

Giurassico

Periodo caratterizzato da variazioni del livello del mare; prevalenza delle terre emerse in America, Asia, Australia.

Fauna: compaiono i primi marsupiali; dominano i grandi rettili (dinosauri). Flora: predominano le conifere.

Triassico

Intensa l’erosione dei continenti; profonde fratture da cui escono lave che originano altopiani estesi.

Fauna: si diffondono i rettili; nei mari prosperano pesci e invertebrati. Flora: si sviluppano alghe caratteristiche.

125

Si noti inoltre che a tutte le colonne X di una tabella di questo tipo, se più d’una, LATEX assegnerà la stessa larghezza indipendentemente dalle altre colonne presenti, come mostra la tabella 33 ottenuta con il codice seguente: \begin{tabularx}{\columnwidth}{lXX} \toprule Periodo & Fenomeni geologici & Biosfera \\ \midrule \textbf{Giurassico} & Periodo caratterizzato da variazioni del livello del mare; prevalenza delle terre emerse in America, Asia, Australia. & Fauna: compaiono i primi marsupiali; dominano i grandi rettili (dinosauri). Flora: predominano le conifere. \\ \midrule \textbf{Triassico} & Intensa l’erosione dei continenti; profonde fratture da cui escono lave che originano altopiani estesi. & Fauna: si diffondono i rettili; nei mari prosperano pesci e invertebrati. Flora: si sviluppano alghe caratteristiche. \\ \bottomrule \end{tabularx}

6.3.4 Colonne di soli numeri: siunitx

Il pacchetto siunitx gestisce in modo molto potente e flessibile anche la resa tipografica dei numeri nelle tabelle, definendo un nuovo tipo di colonna S specifico per dati numerici che si comporta come segue: • nei numeri di cinque o più cifre separa automaticamente le cifre a gruppi di tre per migliorarne la leggibilità (si veda il paragrafo A.4.2 a pagina 201); • per impostazione predefinita, mette il separatore decimale al centro della colonna, di cui espande flessibilmente entrambi i margini a seconda del numero di cifre da scrivere nella cella; • spazia correttamente il separatore decimale (se c’è) tra parte intera e decimale del numero (si veda il paragrafo A.4.2 a pagina 201).

Lo si vede all’opera nella tabella 34 nella pagina seguente, ottenuta con il seguente codice:

Colonne S

126

tabelle e figure

Tabella 34: Tabella con colonna S.

Espressione π ππ π ππ

Valore 3,1416 36,46 80 662,7

\usepackage{siunitx} \sisetup{output-decimal-marker={,}} \begin{tabular}{cS} \toprule Espressione & \midrule $\pi$ & $\pi^{\pi}$ & $\pi^{\pi^{\pi}}$ & \bottomrule \end{tabular}

{Valore} \\ 3.1416 \\ 36.46 \\ 80662.7 \\

Si noti che: • si possono scrivere le opzioni di siunitx anche nell’argomento del comando dedicato \sisetup subito dopo aver caricato il pacchetto (alternativa di solito preferita quando sono particolarmente numerose); • l’opzione output-decimal-marker={,} permette di avere come separatore decimale la virgola anziché il punto predefinito; • un eventuale testo in una colonna S (di solito nell’intestazione) si scrive tra parentesi graffe per non “confondere” il pacchetto, che lì si aspetterebbe dei numeri.

Tra le opzioni, numerose, per il trattamento dei numeri, se ne segnala qui una, utile per risolvere alcune situazioni in cui il comportamento predefinito delle colonne S risulta inadeguato. Nell’esempio seguente si nota uno spazio tra le colonne decisamente esagerato: \begin{tabular}{SS} \toprule {$P$} & {$u$} \\ {(kg)} & {(m)} \\ \midrule 269.8 & 0.000674 \\ 421.0 & 0.001035 \\ 640.2 & 0.001565 \\ \bottomrule \end{tabular}

P (kg) 269,8 421,0 640,2

u (m) 0,000 674 0,001 035 0,001 565

Risolve il problema l’opzione table-format=hvalorei, da assegnare a ciascuna colonna S nel preambolo della tabella. La sintassi completa dell’opzione è:

6.3 tabelle

127

table-format=hprimai.hdopoi

dove: • hprimai è il numero di cifre intere del numero che nella colonna ha la parte intera più lunga; • . è il separatore decimale; • hdopoi è il numero di cifre decimali del numero che nella colonna ha la parte decimale più lunga.

La tabella precedente diventa: \begin{tabular}% {S[table-format=3.1]% S[table-format=1.6]} \toprule {$P$} & {$u$} \\ {(kg)} & {(m)} \\ \midrule 269.8 & 0.000674 \\ 421.0 & 0.001035 \\ 640.2 & 0.001565 \\ \bottomrule \end{tabular}

P (kg)

u (m)

269,8 421,0 640,2

0,000 674 0,001 035 0,001 565

Ecco l’opzione all’opera nel codice che ha prodotto la tabella 29 a pagina 120: \begin{tabular}{S[table-format=2.3]% S[table-format=3.1]% S[table-format=1.6]% S[table-format=1.2]% S[table-format=1.5]} \toprule {$D$} & {$P$} & {$u$} & {$\beta$} {(m)} & {(kg)} & {(m)} & \midrule 0.500 & 269.8 & 0.000674 & 1.79 1.50 & 421.0 & 0.001035 & 3.59 10.0 & 640.2 & 0.001565 & 7.18 \bottomrule \end{tabular}

& {$G$} \\ & {(Pa)} \\ & 0.04089 \\ & 0.04089 \\ & 0.04089 \\

6.3.5 Celle multicolonna Il comando

\multicolumn{hni}{hdescrittorei}{htestoi}

sostituisce a hni celle successive un’unica cella, il cui htestoi viene stampato nei modi specificati con il hdescrittorei. Lo si vede all’opera nell’esempio seguente, che produce la tabella 35 nella pagina seguente:

Celle multicolonna

128

tabelle e figure

Tabella 35: Tabella con cella multicolonna.

Particella

Nome Antiparticella

Carica (e)

elettrone protone neutrone

positrone antiprotone antineutrone

∓1 ±1 0

Tabella 36: Tabella con celle multiriga.

Famiglia

Particella

Simbolo

leptoni

elettrone muone tau neutrino

e µ τ ν

barioni

protone neutrone

p n

\begin{tabular}{llc} \toprule \multicolumn{2}{c}{Nome} Particella & Antiparticella \midrule elettrone & positrone protone & antiprotone neutrone & antineutrone \bottomrule \end{tabular}

& Carica \\ & (e) \\ & $\mp 1$ \\ & $\pm 1$ \\ & $0$ \\

Si noti che si può usare \multicolumn per modificare il formato anche di una sola cella: in questo caso, a hni si sostituisce 1.

Celle multiriga

6.3.6 Celle multiriga Il comando

\multirow{hni}*{htestoi}

(che richiede il pacchetto omonimo) crea una cella alta hni righe, il cui htestoi verrà centrato verticalmente. Il codice \begin{tabular}{clc} \toprule Famiglia & Particella \midrule \multirow{4}*{leptoni} & elettrone & muone & tau & neutrino \midrule \multirow{2}*{barioni} & protone & neutrone

& Simbolo \\ & & & &

$e$ \\ $\mu$ \\ $\tau$ \\ $\nu$ \\

& $p$ \\ & $n$ \\

6.3 tabelle

Tabella 37: Tabella con celle multiriga e multicolonna.

Elemento idrogeno litio sodio

129

Strati K

L

M

1 2 2

1 8

1

\bottomrule \end{tabular}

produce la tabella 36 nella pagina precedente. (Si noti, però, che il testo in una cella multiriga non sempre viene perfettamente centrato rispetto alle righe.)

I due comandi si possono combinare. Il codice \begin{tabular}{lccc} \toprule \multirow{2}*{Elemento} & \cmidrule(lr){2-4} & \midrule idrogeno & litio & sodio & \bottomrule \end{tabular}

\multicolumn{3}{c}{Strati} \\ K

& L

& M \\

$1$ & & \\ $2$ & $1$ & \\ $2$ & $8$ & $1$ \\

produce la tabella 37.

Il comando \cmidrule{hni-hmi}

disegna un filetto orizzontale dalla sinistra della colonna hni-esima fino alla destra della colonna hmi-esima. Per migliorare leggermente la resa della tabella, si può specificare subito dopo \cmidrule un argomento facoltativo htroncamentoi fra parentesi tonde: \cmidrule(htroncamentoi){hni-hmi}

che accetta tre possibilità: r, l o rl. Si sta dicendo a LATEX che il filetto va “rasato” a destra (r), a sinistra (l) o a entrambe le estremità (rl).

6.3.7 Spaziare a mano righe e colonne

Quando (molto di rado) i risultati di LATEX non soddisfano completamente l’autore, si può migliorare la resa tipografica della tabella con piccoli aggiustamenti manuali. I casi sono due: 1. le righe della tabella appaiono troppo compresse; 2. le colonne della tabella appaiono troppo compresse.

\cmidrule

130

Spaziare le righe

tabelle e figure

Risolve il primo caso il comando

\\[hlunghezzai]

che sostituito allo standard \\ in fine di riga nel corpo della tabella, abbassa la riga immediatamente successiva (e solo quella) di uno spazio verticale pari a hlunghezzai. Di solito si inserisce questo spazio supplementare per rimediare a lievi sovrapposizioni (specialmente di formule matematiche in display) oppure per far “respirare” una tabella come si è fatto nella tabella 42 a pagina 137, dove si sono allontanati leggermente i blocchi di testo altrimenti troppo vicini. \[ \begin{array}{cc} \toprule f(x) & f’(x) \\ \midrule \log x & \dfrac{1}{x} \\ \arctan x & \dfrac{1}{1+x^2} \\ \bottomrule \end{array} \]

f(x)

f 0 (x)

log x

1 x 1 1 + x2

arctan x

è troppo risicata, e come la si può correggere molto semplicemente con \[ \begin{array}{cc} \toprule f(x) & f’(x) \\ \midrule \log x & \dfrac{1}{x}\\[2ex] \arctan x & \dfrac{1}{1+x^2} \\ \bottomrule \end{array} \]

Spaziare le colonne

f(x)

f 0 (x)

log x

1 x 1 1 + x2

arctan x

Il comando \dfrac richiede il pacchetto amsmath.

Non accade praticamente mai di dover aumentare la distanza tra due colonne di una tabella. Se proprio ce ne fosse bisogno, si può usare il separatore di colonna @{hlarghezzai}

che, dato nel preambolo della tabella tra i descrittori delle due colonne che si desidera allontanare, inserisce uno spazio orizzontale pari a hlarghezzai. Si noti che in questo caso la hlarghezzai va indicata con modalità leggermente diverse dal solito: con le consuete espressioni (valore e unità di misura) scritte nell’argomento di \hspace{h. . .i} oppure con comandi di spaziatura “fissa” (\quad e \qquad , per esempio).

Le due istruzioni appena esaminate si possono eseguire insieme e anche più di una volta nella stessa tabella, là dove serve.

6.3.8 Personalizzare le colonne: array

I diversi tipi di colonna esaminati fino a qui (gli standard l, c, r e p e gli “speciali” X e S) riescono a soddisfare la maggior parte delle

6.3 tabelle

esigenze, ma non si possono personalizzare. Si immagini, per esempio, di dover scrivere il contenuto di un’intera colonna in neretto: può essere più vantaggioso, soprattutto se le celle sono numerose, definire questo stile una volta per tutte anziché ripeterne il comando in ognuna.

Risolve il problema il pacchetto array (da non confondere con l’omonimo ambiente standard), che per personalizzare le colonne definisce due istruzioni >{hdichiarazione inizialei} e <{hdichiarazione finalei} la cui sintassi completa è

131

Colonne personalizzate

>{hdichiarazione inizialei}hdescrittorei<{hdichiarazione finalei}

dove: • >{hdichiarazione inizialei} può essere usato prima di uno dei descrittori fin qui esaminati per dire a LATEX di eseguire la dichiarazione prima del contenuto di ogni cella della colonna; • hdescrittorei è un descrittore di colonna, eventualmente definito con \newcolumntype (si veda più sotto); • >{hdichiarazione finalei} può essere usato dopo uno dei descrittori fin qui esaminati per dire a LATEX di eseguire la dichiarazione dopo il contenuto di ogni cella della colonna.

Le istruzioni appena esaminate si possono usare nel preambolo della tabella se servono ogni tanto; se invece un documento richiede numerose tabelle con colonne personalizzate, è più conveniente definirle una volta per tutte nel preambolo del documento con il comando \newcolumntype , la cui sintassi completa è \newcolumntype{hcaratterei}{>{hdichiarazionei}hdescrittorei<{hdichiarazionei}}

dove hcaratterei è una lettera, non già in uso nel documento come descrittore di colonna, che indica il nuovo descrittore da richiamare nel preambolo della tabella nel modo consueto.

Nei prossimi paragrafi si vedono le dichiarazioni all’opera in entrambe le modalità.

Modificare lo stile del font di una colonna Le istruzioni di array tornano utili per modificare lo stile del font di una colonna: basta sostituire a hdichiarazionei una delle dichiarazioni elencate nella tabella 49 a pagina 189. Il codice \begin{tabular}{>{\bfseries}lp{0.5\columnwidth}} \toprule Forza & Una forza è una grandezza fisica che si manifesta nell’interazione di due o più corpi materiali, che cambia lo stato di quiete o di moto dei corpi stessi. \\ \midrule Momento polare & Il momento polare di una forza rispetto a una determinata origine è definito come il prodotto vettoriale tra il vettore posizione (rispetto alla stessa origine) e la forza. \\ \bottomrule \end{tabular}

produce la tabella 31 a pagina 123, ottenuta in precedenza specificando a mano lo stile della prima colonna all’inizio di ogni riga.

\newcolumntype

132

tabelle e figure

Tabella 38: Comportamenti di una colonna p.

(a) Giustificata.

(b) Allineata a sinistra.

Forza

Una forza è una grandezza fisica che si manifesta nell’interazione di due o più corpi materiali, che cambia lo stato di quiete o di moto dei corpi stessi.

Forza

Una forza è una grandezza fisica che si manifesta nell’interazione di due o più corpi materiali, che cambia lo stato di quiete o di moto dei corpi stessi.

Momento polare

Il momento polare di una forza rispetto a una determinata origine è definito come il prodotto vettoriale tra il vettore posizione (rispetto alla stessa origine) e la forza.

Momento polare

Il momento polare di una forza rispetto a una determinata origine è definito come il prodotto vettoriale tra il vettore posizione (rispetto alla stessa origine) e la forza.

Modificare l’allineamento di una colonna Con le stesse dichiarazioni si può migliorare la resa tipografica del contenuto di colonne p o X quando sono particolarmente strette: basta sostituire a hdichiarazione inizialei una delle tre dichiarazioni seguenti: • \raggedright (“irregolare a destra”) per avere il contenuto delle celle allineato a sinistra; • \raggedleft (“irregolare a sinistra”) per averlo allineato a destra; • \centering per averlo centrato.

Si noti che il testo in queste colonne non viene sillabato.3 Si confronti la tabella 38a, la cui seconda colonna è una colonna p standard, con la tabella 38b accanto, ottenuta con il codice seguente: \begin{tabular}{l>{\raggedright\arraybackslash}p{0.2\columnwidth}} \toprule \textbf{Forza} & Una forza è una grandezza fisica che si manifesta nell’interazione di due o più corpi materiali, che cambia lo stato di quiete o di moto dei corpi stessi. \\ \midrule \textbf{Momento polare} & Il momento polare di una forza rispetto a una determinata origine è definito come il prodotto vettoriale tra il vettore posizione (rispetto alla stessa origine) e la forza. \\ \bottomrule \end{tabular}

dove \arraybackslash dato dopo \raggedright nell’ultima colonna della tabella permette di terminarne le righe con il consueto \\.4 Per ulteriori dettagli su array si consiglia la lettura della sua documentazione e di [Gregorio, 2010].

3 Per migliorare ulteriormente la distribuzione del testo (sillabato, questa volta) nella composizione non giustificata si possono usare i comandi \RaggedRight e \RaggedLeft del pacchetto ragged2e.

4 Se non si dà \arraybackslash nella definizione della nuova colonna, per terminare le righe bisogna usare \tabularnewline e riservare \\ per dare degli a capo espliciti. La stessa cosa vale nel caso di colonne allineate a destra con \raggedleft o centrate con \centering .

6.3 tabelle

Tabella 39: Tabella ottenuta con il pacchetto array.

133

Z

cos x dx

sin x + c

Z ex dx

ex + c

Z sec2 x dx

tan x + c

Colonne di sola matematica I comandi seguenti \newcolumntype{L}{>{$}l<{$}} \newcolumntype{C}{>{$}c<{$}} \newcolumntype{R}{>{$}r<{$}}

definiscono tre nuove colonne L, C e R nelle quali le formule matematiche vengono stampate rispettivamente allineate a sinistra, centrate e allineate a destra. Se si preferisce il formato in display, basta aggiungere il relativo comando alla definizione della nuova colonna. Il codice \newcolumntype{L}{>{$\displaystyle}l<{$}} \newcolumntype{C}{>{$}c<{$}} \begin{tabular}{LC} \toprule \int\cos x\,dx & \sin x + c \\ \midrule \int e^x dx & e^x + c \\ \midrule \int \sec^2 x \,dx & \tan x + c \\ \bottomrule \end{tabular}

produce la tabella 39.

6.3.9 Tabelle colorate

Esigenze particolari potrebbero richiedere a volte una tabella â&#x20AC;&#x153;colorataâ&#x20AC;?. Risolve il problema il pacchetto colortbl, che permette di evidenziare lo sfondo di singole celle o di intere righe e colonne (se ne veda la documentazione).

Quando il colore, invece, serve solo a separare le righe tra loro con maggiore evidenza, si usa il pacchetto xcolor, che con lâ&#x20AC;&#x2122;opzione table produce righe alterne con lo sfondo colorato. Dopo aver caricato il pacchetto nel modo consueto: \usepackage[table]{xcolor}

subito prima di aprire tabular basta dare: \rowcolors{hrigai}{hcolore delle righe disparii}{hcolore delle righe parii}

colortbl xcolor

134

tabelle e figure

Tabella 40: Tabella con le righe dispari colorate ottenuta con il pacchetto xcolor.

Alcaloide

Origine

atropina chinina morfina nicotina

belladonna china papavero tabacco

dove: • hrigai indica il numero della prima riga da colorare; • hcolore delle righe disparii indica il colore da applicare alle righe dispari (l’argomento vuoto lascia la riga bianca); • hcolore delle righe parii indica il colore da applicare alle righe pari (l’argomento vuoto lascia la riga bianca); • il hcolorei va scelto tra quelli contemplati dal pacchetto: nell’esempio seguente si è usato un grigio leggero (lightgray).

La tabella 40 usa lo sfondo grigio per le righe pari. Il codice usato è: \rowcolors{2}{}{lightgray} \begin{tabular}{ll} ... \end{tabular}

Una tabella non dovrebbe mai avere note al piede.

6.3.10 Tabelle con note

Il comando \footnote , che in un testo stampa le note a piè di pagina, non funziona nell’ambiente tabular e, come per la maggior parte delle cose in LATEX, questa limitazione ha ottime ragioni per esistere.

Una tabella dovrebbe essere sempre inserita “fuori testo” in un documento; una nota al piede la “vincolerebbe” alla pagina in cui si trova, impedendole di essere davvero un oggetto slegato dal contesto.

Il luogo più adatto per mettere eventuali annotazioni è la didascalia della tabella, ma a volte le tabelle con note esplicative sono imposte dal relatore o dall’editore. LATEX risolve questo problema in modi diversi a seconda dei due casi in cui ci si trova di solito: 1. si vuole che la nota alla tabella segua la numerazione delle altre note presenti nel testo; 2. si vuole una numerazione particolare, per esempio con lettere.

footnote ctable

Il pacchetto footnote risolve il primo caso; il pacchetto ctable il secondo: se ne veda la documentazione.

6.3.11 Tabelle grandi

I codici di questo paragrafo contengono l’ambiente mobile per le tabelle table e i relativi comandi, che verranno spiegati tutti nel paragrafo 6.5 a pagina 144. Si rimanda a quella sede il lettore che voglia

6.3 tabelle

Tabella 41: Tabella con font di corpo inferiore (footnotesize) al resto del testo (normalsize).

Forza

Una forza è una grandezza fisica che si manifesta nell’interazione di due o più corpi materiali, che cambia lo stato di quiete o di moto dei corpi stessi.

Momento polare

Il momento polare di una forza rispetto a una determinata origine è definito come il prodotto vettoriale tra il vettore posizione (rispetto alla stessa origine) e la forza.

approfondire immediatamente l’argomento, e lo si invita a ritornare su queste pagine in seguito.

Se le dimensioni della tabella finita eccedono quelle dell’intera pagina in lunghezza, in larghezza o in entrambe, si prospettano soluzioni diverse a seconda della dimensione in eccesso.

Nel caso di una tabella troppo lunga, si può:

135

Tabelle troppo lunghe

• ridurre il corpo del font; • spezzarla su più pagine.

Nel caso di una tabella troppo larga, si può: • ridurre il corpo del font; • ruotarla; • spezzarla su più pagine.

A ogni caso si possono applicare più soluzioni contemporaneamente.

Ridurre il corpo del font Per ridurre il corpo del font in una tabella si usano le stesse dichiarazioni elencate nella tabella 50 a pagina 190, che però vanno date in luoghi diversi del codice sorgente a seconda del tipo di tabella che si sta componendo.

Se la tabella è in testo, la dichiarazione va data fuori dall’ambiente tabular, alla fine del quale una nuova dichiarazione ripristinerà la dimensione corrente del font.

Se la tabella è mobile (si veda il paragrafo 6.5 a pagina 144), invece, la dichiarazione va data dentro l’ambiente table, che a differenza di tabular argina al proprio interno l’effetto dei comandi che contiene (il corpo della didascalia, però, non subisce variazioni). Il codice \begin{table}[tb]\footnotesize \caption{h. . .i}\label{h. . .i}\centering \begin{tabular}{lp{0.5\columnwidth}} ... \end{tabular} \end{table}

produce la tabella 41. (Se ne confronti il risultato con la tabella 31 a pagina 123.)

Tabelle troppo larghe

136

tabelle e figure 27,2

1,210

37,1 40,2 38,0 40,6

0,285

% Id %

–

28,7

0,279

1,236 1,217

0,283

27,6 28,9

1,240

0,278

Iˆ N

–

–

Ii %

0,882

–

%

(δmax /L)N

0,391

23

Deflessione risultante

Impulso trasmesso

13,78

0,299

0,925

4,1 4,0

0,297

0,939

14,0 14,0

0,299

0,931

4,0 4,0

14,0

– δmax /L

0,398 0,391

– Iˆ

1,234

100

14,55

0,882

%

kg/m2

ρnr

mA Densità superficiale

Dati sperimentali

Densità nucleare relativa

iii ii i

Pannello multistrato a nido d’ape quadrato Piastra monolitica Unità di misura Simbolo Grandezza

Tabella 1: Confronto tra i miglioramenti delle prestazioni di strutture resistenti ad onde d’urto.

Pannello multistrato a piramide reticolare

9 CONCLUSIONI

Figura 8: Esempio d’uso dell’ambiente sidewaystable.

Ruotare una tabella rotating

L’ambiente sidewaystable del pacchetto rotating ruota un oggetto posto al proprio interno. La sintassi generale dell’ambiente è: \begin{sidewaystable} \caption{h. . .i}\label{h. . .i}\centering \begin{tabular} ... \end{tabular} \end{sidewaystable}

A differenza degli ambienti esaminati in precedenza, sidewaystable (che sostituisce table) occupa sempre un’intera pagina e, se il riempimento della pagina lo richiede, nel documento composto può essere preceduto dal testo che nel sorgente lo segue. Il codice \begin{sidewaystable}[p]\small \caption{h. . .i}\label{h. . .i}\centering \begin{tabularx}{\textheight}{h. . .i} ... \end{tabularx} \end{sidewaystable}

produce la tabella della figura 8.

Tabelle su più pagine longtable

Una tabella composta con tabular deve sempre poter essere contenuta in una sola pagina: se ne supera le dimensioni in altezza, le parti in eccesso vengono tagliate e si riceve un errore di overfull vbox. Il pacchetto longtable può risolvere il problema e ripartire una tabella su più pagine, anche se tabelle di questo tipo, si ricordi, andrebbero usate soltanto se inevitabili.

6.3 tabelle

A differenza di altri pacchetti simili,5 di solito longtable riesce a usare su ogni pagina la stessa larghezza di riga, calcolandola in base alla riga della tabella con larghezza massima. Per ottenere il risultato finale, però, potrebbero essere necessarie alcune compilazioni successive.

Si noti che anche se può avere una didascalia, una tabella prodotta da longtable non è mobile, ma nel documento finale comparirà nel punto esatto in cui la si è inserita nel file sorgente.

La tabella 42 ne mostra la struttura generale, descrive l’ambiente omonimo e i principali comandi definiti dal pacchetto. Se ne riportano tutte le parti nell’ordine in cui vanno scritte, ma va ricordato che non sono obbligatorie né si deve abusarne: la didascalia non sempre è necessaria, e anche intestazioni e piedi sono facoltativi, ma si consiglia di scrivere almeno uno dei due per segnalare al lettore che la stessa tabella occupa più di una pagina.

Tabella 42: Un esempio di tabella ripartita su più pagine.

Comando

Effetto

\begin{longtable}

Comincia la tabella. L’ambiente longtable si comporta come tabular, ma in più, dopo aver composto ogni riga controlla l’altezza complessiva della tabella: se supera quella della pagina, vengono inseriti automaticamente il contenuto del piede ( foot) e il comando \end {tabular}, e la tabella continua su una nuova pagina con l’intestazione scelta (head).

[hcaratterei]

Va eventualmente specificato tra l’apertura dell’ambiente e il preambolo della tabella per impostarne la posizione sulla pagina (c se centrata, l se a sinistra e r se a destra). Non indicandolo, la tabella risulta centrata per impostazione predefinita.

{hpreamboloi}

È il consueto preambolo nel quale indicare i descrittori già esaminati nei paragrafi precedenti.

\caption{hdidascaliai}

Se specificato, assegna alla tabella una didascalia, anche nella versione [hdidascalia brevei] (si veda il paragrafo 6.5.1 a pagina 144).

Continua nella prossima pagina

5 Esistono altri due pacchetti simili a longtable: supertabular e il suo sviluppo xtab. La loro parziale incompatibilità con array e altri pacchetti, tuttavia, ne sconsiglia l’uso.

137

138

tabelle e figure

Continua dalla pagina precedente

Comando

Effetto

\label{hetichettai}

Assegna alla tabella un’etichetta, utile per i riferimenti incrociati (si veda lo stesso paragrafo).

hintestazione inizialei

Specifica l’hintestazione inizialei, cioè l’intestazione della tabella nella prima pagina in cui compare.

\endfirsthead

hintestazione normalei \endhead

hpiede normalei \endfoot

hpiede finalei \endlastfoot

Specifica l’hintestazione normalei, cioè l’intestazione della tabella dalla seconda pagina in poi (Continua dalla pagina precedente, per esempio).

Specifica il hpiede normalei, cioè il testo che deve comparire alla fine di ogni pagina (Continua nella prossima pagina).

Specifica il hpiede finalei, cioè il testo che deve apparire subito dopo l’ultima riga della tabella (Si conclude dalla pagina precedente).

hcorpo della tabellai

Qui si mette il contenuto della tabella, separando le colonne e terminando le righe nei modi consueti.

\end{longtable}

Termina la tabella.

Si conclude dalla pagina precedente

Si può vedere il pacchetto all’opera nel codice seguente, usato per ottenere la tabella 42 nella pagina precedente. \begin{longtable}{lp{0.5\columnwidth}} % intestazione iniziale \caption{Un esempio di tabella ripartita su più pagine.} \label{tab:longtable} \\ \toprule Comando & Effetto \\ \midrule \endfirsthead % intestazione normale \multicolumn{2}{l}{\footnotesize\itshape Continua dalla pagina precedente} \\ \toprule Comando & Effetto \\ \midrule \endhead % piede normale \midrule \multicolumn{2}{r}{\footnotesize\itshape

Continua nella prossima pagina} \\ \endfoot % piede finale \bottomrule \multicolumn{2}{r}{\footnotesize\itshape Si conclude dalla pagina precedente} \\ \endlastfoot % corpo della tabella ... & ... \\ ... ... & ... \\ \end{longtable}

6.4 figure

139

Per evitare errori nella compilazione, si ricordi di terminare con \\ le righe di intestazioni, piedi e didascalia (o etichetta, se presente). Per ulteriori approfondimenti, si consiglia la lettura di [Gregorio, 2010].

6.4

figure

Le figure rientrano tra gli argomenti più studiati dalle guide, tanto che ne esistono di specifiche (tra cui [Caucci e Spadaccini, 2005]), cui si rimanda il lettore per ogni approfondimento.

Includere le figure comporta problemi di due tipi: il primo riguarda la figura stessa, cioè il tipo di file che si vuole introdurre nel testo (e verrà trattato in questo paragrafo); il secondo, completamente diverso, riguarda la sua collocazione sulla pagina (e verrà trattato nel paragrafo successivo).

Di qui in avanti si dà per caricato il pacchetto graphicx.

6.4.1 Immagini vettoriali e bitmap

Si possono dividere le figure in due grandi classi: le immagini vettoriali e le immagini bitmap. Le prime sono descritte da forme, possono essere scalate e deformate senza perdere in definizione e sono adatte soprattutto per grafici e schemi. Le seconde sono matrici di pixel colorati e sono adatte per fotografie, disegni e icone [Mori, 2007, p. 32].

Immagini vettoriali Esistono numerosi strumenti per creare grafici e schemi con LATEX, ma in questa guida non verranno considerati perché piuttosto complicati da usare.6 Molto più semplicemente, si possono preparare a parte i disegni con un programma specifico, e aggiungerli poi al documento. I formati vettoriali più noti e diffusi sono il pdf, il ps e il suo parente stretto eps. Oggi è diffuso anche l’svg, usato specialmente per le applicazioni Web. Il paragrafo 6.4.4 a pagina 141 descrive alcuni programmi di grafica vettoriale.

6 Gli strumenti più diffusi per disegnare grafici e schemi con LATEX sono l’ambiente picture, i pacchetti pgf, PSTricks, Xy-pic, i programmi METAPOST e Asymptote: tutti richiedono di dare a mano i comandi per costruire il grafico.

Preparare grafici con un software esterno

140

tabelle e figure

Immagini bitmap

I formati di matrici di pixel sono numerosissimi, e vanno dal jpeg, molto diffuso per rappresentare immagini fotografiche, al png, adatto per rappresentare disegni e icone, al gif al tiff. L’elenco potrebbe continuare, fino a comprendere i formati proprietari di aziende o di specifici codici di colore. Alcuni formati sono compressi, in modo da sfruttare la ridondanza di informazioni delle immagini.

Produrre figure nel formato corretto

6.4.2 Convertire i formati

Prima ancora di includere le immagini nel documento bisogna produrle nel formato più adatto al proprio scopo. È inutile registrare una figura come jpeg per poi convertirla in pdf, perché la conversione include semplicemente il file bitmap in una “cornice” pdf senza migliorarne in alcun modo la qualità. È sbagliato anche fare l’opposto, perché così si perdono le informazioni sulla geometria della figura, abbassandone la qualità. Nonostante questo, si potrebbero avere a disposizione soltanto immagini in formati non adatti a LATEX, e allora la conversione sarebbe davvero necessaria.

A questo proposito si ricordi bene che: • LATEX accetta soltanto immagini eps; • pdfLATEX accetta soltanto immagini pdf (se vettoriali) e jpeg e png (se bitmap).

Si noti che Mac OS X non ha bisogno di software aggiuntivo per convertire un’immagine eps o ps in pdf: si apre il file con Anteprima e lo si registra semplicemente come pdf.

Il paragrafo 6.4.4 nella pagina successiva descrive alcuni programmi per convertire i diversi formati.7

Il bounding box

6.4.3

Ritagliare le immagini

Uno dei parametri più importanti di una figura è l’informazione sulle dimensioni del rettangolo circoscritto all’immagine (bounding box).

Questo contorno determina la taglia effettiva dell’immagine e serve a LATEX per calcolare lo spazio da riservarle sulla pagina. Idealmente, il contorno dovrebbe coincidere con il limite dell’immagine, ma talvolta le figure sono circondate da un invisibile bordo bianco più o meno spesso che genera non pochi problemi estetici: la figura appare sulla pagina troppo piccola, o non centrata, o circondata da eccessivi margini verticali, per esempio, anche se LATEX la sta trattando nel modo corretto.

La primissima cosa da verificare, quindi, è che le dimensioni del bounding box siano corrette, aprendo la figura con un programma opportuno (come Adobe Reader o GIMP) e attivando la visualizzazione del contorno che, se scorretto, va ridimensionato. Se il problema riguarda poche figure si può risolvere a mano, ma se i file da ottimizzare sono molti, allora vanno corretti all’origine (magari configurando ad hoc il programma usato per produrli).

7 Caricando il pacchetto bmpsize, pdfLATEX accetta anche immagini bmp, gif e tiff.

6.4 figure

Tabella 43: Alcuni programmi utili per lavorare con LATEX (le lettere G, C, R e V indicano rispettivamente le funzioni di grafica vettoriale, conversione dei formati, ritaglio immagini e visualizzazione; il simbolo indica che la funzione è disponibile).

Programma

G

C

R

V

Inkscape Xfig e WinFIG Gnuplot Mathematica OmniGraffle GIMP Adobe Acrobat Adobe Reader Anteprima ImageMagick eps2pdf e epstopdf Ghostview e GSview 6.4.4 Alcuni programmi utili

La composizione asincrona di LATEX ha anche un altro vantaggio: l’autore, infatti, in ogni fase dell’elaborazione del documento può usare un programma specializzato in modo da avere sempre il prodotto migliore. Questo non potrebbe accadere con un software “tuttofare” come un editor di testo tradizionale. Di seguito si propone, senza pretese di completezza, un elenco di programmi utili per lavorare con LATEX, ma preziosi anche in numerose altre occasioni. inkscape Multipiattaforma, gratuito e distribuito con licenza gnu, è particolarmente adatto per i grafici qualitativi (+ inkscape).

xfig Gratuito, per Unix/Linux e distribuito con licenza gnu, disegna figure usando cerchi, rettangoli e linee (+ xfig). Ne esiste una versione per Windows, WinFIG (+ winfig).

gnuplot Multipiattaforma e gratuito, disegna grafici di funzioni matematiche a due e tre dimensioni (+ gnuplot).

mathematica È un programma commerciale multipiattaforma di calcolo numerico e simbolico. Disegna anche grafici di funzioni matematiche a due e tre dimensioni (+ mathematica).

omnigraffle È un programma commerciale per Mac che disegna schemi e diagrammi di ogni tipo (+ omnigraffle).

gimp Multipiattaforma e gratuito, oltre ad avanzate funzioni di fotoritocco visualizza, ritaglia e corregge immagini bitmap registrate in numerosi formati e le converte in uno qualsiasi di quelli che gestisce. Non va usato, però, per convertire immagini vettoriali in matrici di pixel (+ gimp). adobe acrobat È un programma commerciale per Windows e Mac dal costo piuttosto elevato, per gestire i pdf in modo avanzato:

141

142

tabelle e figure width height angle scale

Tabella 44: Principali chiavi del pacchetto graphicx.

Ridimensiona l’immagine alla larghezza specificata Ridimensiona l’immagine all’altezza specificata Ruota l’immagine in senso antiorario Riassegna le dimensioni dell’immagine

possiede potenti funzioni di estrazione utili per trattare le immagini. Ne esiste una versione più “leggera” e gratuita, Adobe Reader, che non permette, però, di modificare il file. Entrambi i programmi si scaricano da + adobe.

anteprima Nativo di Mac OS X, oltre a gestire i pdf in modo avanzato, visualizza, ritaglia e converte automaticamente immagini vettoriali e bitmap semplicemente registrando il file in un altro formato. imagemagick È un programma di grafica bitmap, multipiattaforma e gratuito. Il suo comando convert converte rapidamente un’immagine da un formato all’altro (+ imagemagick). eps2pdf Gratuito e disponibile solo per Windows, converte un file eps o ps in pdf. Un programma simile, epstopdf, è disponibile anche per Linux. Entrambi i programmi si scaricano da + ctan.

ghostview Gratuito, per Unix/Linux, visualizza file ps, eps e pdf e converte file eps e ps in pdf. Un programma simile, GSview, è disponibile anche per Windows. Entrambi sono anche in grado di ritagliare le immagini vettoriali e richiedono Ghostscript. Tutti e tre i programmi si scaricano da + ghost.

La tabella 43 nella pagina precedente riassume le funzioni principali dei programmi appena descritti.

graphicx

\includegraphics

6.4.5 Includere le immagini

LATEX gestisce le immagini con il pacchetto graphicx, da caricare nel modo consueto. Il comando \includegraphics , la cui sintassi completa è \includegraphics[hchiavei=hvalorei,h. . .i]{himmaginei}

le include nel documento. Si osservi che: • nell’argomento facoltativo vanno messi un’opzione o un’elenco di opzioni (separate dalla virgola) nella modalità hchiavei=hvalorei per modificare dimensioni e orientamento della figura sulla pagina; • nell’argomento obbligatorio va scritto il nome assegnato all’immagine (senza specificarne l’estensione).

La tabella 44 elenca le chiavi più importanti del pacchetto, e gli esempi che seguono dovrebbero rendere più chiaro il procedimento.

Si può assegnare all’immagine una larghezza (width)

6.4 figure

\includegraphics[width=% \columnwidth]{Mani}

143

L’immagine a fianco riproduce la litografia Mani che disegnano di M. Escher.

o un’altezza (height) stabilite dall’utente,

\includegraphics[height=% 0.15\textheight]{Mani}

dove \textheight indica l’altezza della gabbia del testo.

Le chiavi width e height accettano qualsiasi unità di misura tipografica riconosciuta da LATEX (width=85mm oppure width=8.5cm è la stessa cosa), ma è sempre meglio esprimere queste due dimensioni in modo relativo, con un valore legato alla geometria della pagina (per esempio, width=0.5\columnwidth). Così si evitano gli inconvenienti che le dimensioni assolute potrebbero presentare nell’impaginazione del documento. Si pensi di voler passare dalla composizione a piena pagina a una composizione su più colonne: 85 mm potrebbero andar bene per una pagina intera, ma diventare eccessivi per una sola colonna.

Il comando \includegraphics permette inoltre di ridimensionare l’immagine nel suo complesso:

Dimensioni relative e assolute

Ridimensionare. . .

\includegraphics[scale=0.10]% {Mani}

Si può infine ruotare l’immagine in senso antiorario di un angolo espresso in gradi:

. . . e ruotare

\includegraphics[width=0.5% \columnwidth,angle=45]{Mani}

Per tenere in ordine il codice sorgente e razionalizzare il lavoro si consiglia di raccogliere tutte le figure del documento in una cartella,

Organizzare le immagini

144

tabelle e figure

da suddividere a sua volta in sottocartelle se le immagini sono molto numerose. Immaginando di chiamare le sottocartelle grafici e foto basta dare nel preambolo \graphicspath{{grafici/},{foto/}}

Per evitare problemi, il percorso dei file inclusi mediante il comando

\graphicspath non deve contenere spazi. È consigliabile non specificare l’estensione dei file grafici caricati.

Se si prevede di compilare sia con LATEX sia con pdfLATEX, si consiglia di non specificare l’estensione dei file caricati con \includegraphics .

Volendo per esempio includere il file figura.eps, bisogna prima creare il file figura.pdf (con Ghostview o GSview) e poi scrivere nel testo sorgente \includegraphics{figura}

Con questo accorgimento LATEX caricherà il file figura.eps, mentre pdfLATEX il file figura.pdf.

6.5

In LATEX, le tabelle e le figure fuori testo sono oggetti mobili.

table figure

oggetti mobili

Tabelle e figure richiedono un trattamento particolare, perché LATEX non le spezza e non le stampa su più pagine.8 Se si cominciasse una nuova pagina tutte le volte che una figura o una tabella è troppo grande per stare sulla pagina corrente, però, si avrebbero pagine parzialmente vuote, con un risultato insoddisfacente.

Questo problema può essere risolto rendendole “mobili” (floating, “galleggianti”) e affidandone la gestione a LATEX, che le stamperà “liberamente” nella posizione migliore: sulla stessa pagina, oppure in una pagina successiva a quella in cui sono state effettivamente inserite nel codice sorgente, e riempirà lo spazio intermedio con il testo che in esso le segue: perciò oggetti di questo tipo vengono chiamati “fuori testo”.

LATEX gestisce gli oggetti mobili con due ambienti standard dedicati: table (per le tabelle) e figure (per le figure). Il loro comportamento è uno degli aspetti per cui il programma si discosta maggiormente dagli altri elaboratori di testo: diventa molto importante, perciò, comprenderne almeno approssimativamente il funzionamento; in caso contrario, table e figure possono diventare una fonte di frustrazione, perché in pratica non mettono mai gli oggetti mobili dove ci si aspetterebbe che lo facciano.9 6.5.1

Gli ambienti table e figure

LATEX tratta come oggetto mobile tutto il contenuto di un ambiente table o figure. A entrambi è comune un argomento facoltativo hcollocazionei 8 Fanno eccezione le tabelle ripartite su più pagine create con longtable (si veda il paragrafo 6.3.11 a pagina 134).

9 Se si scrive un documento su più colonne, oltre agli ambienti table e figure, che si usano per tabelle e figure larghe una singola colonna (\columnwidth ), si possono usare anche gli ambienti table* e figure* per tabelle e figure larghe l’intera pagina (\textwidth ).

Si possono anche creare oggetti mobili personalizzati con il pacchetto float (se ne veda la documentazione).

6.5 oggetti mobili

Tabella 45: Indicatori di preferenza per gli oggetti mobili.

Indicatore h t b p !

145

Chiede a LATEX di mettere l’oggetto Qui (here), se possibile In cima (top) alla pagina In fondo (bottom) alla pagina In una pagina di soli oggetti mobili (page of floats) Va incontro il più possibile alle preferenze dell’autore

\begin{table}[hcollocazionei]

e \begin{figure}[hcollocazionei]

costituito da uno o più indicatori di preferenza (si veda la tabella 45) che chiedono a LATEX di mettere l’oggetto sulla pagina secondo le preferenze dell’autore.

Una tabella mobile potrebbe cominciare con la seguente riga di codice: \begin{table}[tbp]

Di fronte a un’opzione di questo tipo (che è quella predefinita per le classi standard) LATEX cerca di collocare la tabella successivamente in cima alla pagina (top), in fondo alla pagina (bottom) o in una pagina di soli oggetti mobili (page of floats). Se nessuno di questi tentativi va a buon fine, il programma comincia una nuova pagina e tratta la tabella come se fosse appena comparsa nel testo.

Si consideri ora l’opzione seguente, diversa soltanto nel primo indicatore (!h): \begin{figure}[!hbp]

A differenza dell’esempio precedente, qui come primo tentativo LATEX cercherà di mettere con tutte le sue forze (!) la figura nel punto esatto in cui sta nel sorgente. Se non ce la fa, tenterà le strade appena esaminate.

Si noti che di tutti gli indicatori p è l’unico che può comparire da solo nell’argomento facoltativo di table o figure (mettere da soli gli altri tre potrebbe dare qualche problema) e che ! può accompagnare anche t e p.

Ogni oggetto mobile che LATEX incontra durante la compilazione viene collocato nel documento finito in base agli indicatori specificati nell’argomento hcollocazionei. Se un oggetto non può essere messo sulla pagina corrente, viene caricato da LATEX in liste particolari chiamate code di stampa (una per le tabelle e una per le figure) e così accade per ogni nuovo oggetto mobile incluso nel testo. Le code di stampa sono del tipo fifo (First In First Out, “primo arrivato, primo servito”) e vengono azzerate progressivamente via via che gli oggetti riescono a trovare posto sulle pagine del documento rispettandone rigorosamente l’ordine di inclusione nel file sorgente. Quando comincia una nuova pagina, LATEX controlla prima di tutto se si può comporre una pagina speciale di soli oggetti mobili con quelli presenti nelle code; se non

LATEX colloca ogni oggetto mobile in base alle opzioni specificate dall’autore.

Code di stampa

146

\caption

tabelle e figure

si può, tratta il primo oggetto di ciascuna come se lo incontrasse per la prima volta e tenta nuovamente di rimetterlo sulla pagina in base all’indicatore o agli indicatori assegnatigli (questa volta, però, h non è più possibile). Ecco perché un oggetto che non può essere collocato immediatamente spinge tutti gli altri verso la fine del documento e si ha l’impressione che LATEX non li metta dove si vorrebbe.

Dopo la parte difficile, ecco poche altre nozioni su table e figure.

Agli ambienti mobili appena considerati sono legati alcuni comandi importanti spiegati di seguito.

Il comando \caption{hdidascaliai}

\listoftables \listoffigures

stampa l’intestazione Tabella o Figura e la hdidascaliai, e assegna all’oggetto un numero progressivo.

I due comandi \listoftables

e \listoffigures

stampano rispettivamente l’elenco delle tabelle o delle figure nel punto in cui li si dà (esattamente come fa \tableofcontents per l’indice generale del documento). Le loro voci sono le stesse didascalie degli oggetti o, se troppo lunghe, una loro versione ridotta da scrivere nell’argomento facoltativo di \caption : \caption[hdidascalia brevei]{hdidascaliai} \label va dato dopo \caption!

table

Il comando \label , da dare dopo il corrispondente \caption , assegna all’oggetto un’etichetta per i riferimenti incrociati con \ref e \vref (si veda il paragrafo 4.8 a pagina 68).

6.5.2 Codici tipo

Il modo migliore per introdurre un oggetto mobile nel codice sorgente è scriverne il relativo ambiente tra capoversi, cioè preceduto e seguito da una riga vuota. Ecco un esempio tipico per una tabella composta con tabular con il relativo richiamo: \dots qui finisce un capoverso. \begin{table}[tb] \caption{h. . .i} \label{tab:esempio} \centering \medskip \begin{tabular}{h. . .i} ... \end{tabular} \end{table} La tabella~\vref{tab:esempio} è un esempio di tabella testuale mobile.

6.5 oggetti mobili

Ora un esempio (anche se meno frequente del precedente) di una tabella composta con array:

147

\dots qui finisce un capoverso. \begin{table}[tb] \caption{h. . .i} \label{tab:esempio} \vspace{-\bigskipamount} \[ \begin{array}{h. . .i} ... \end{array} \] \end{table} La tabella~\vref{tab:esempio} è un esempio di tabella matematica mobile.

E uno per figure: \dots qui finisce un capoverso. \begin{figure}[tb] \centering \includegraphics[width=0.5\columnwidth]{figura} \caption{h. . .i} \label{fig:esempio} \end{figure} La figura~\vref{fig:esempio} è un esempio di figura mobile.

Come si può osservare: • Per centrare un oggetto mobile sulla pagina si usa il comando \centering , perché l’ambiente center lascia tra testo e oggetto uno spazio verticale eccessivo, adeguato, invece, per un oggetto in testo.

• La posizione della didascalia varia a seconda dell’oggetto cui è apposta: precede una tabella e segue una figura. Per farlo, è sufficiente scriverla subito prima di tabular e subito dopo \includegraphics .

• Per separare correttamente la didascalia da una tabella mobile composta con tabular, tra \caption e tabular si può dare il comando \medskip o ricorrere all’alternativa spiegata nel paragrafo 6.5.4 a pagina 149.

• Per separare correttamente la didascalia da una tabella mobile composta con array, a seconda della classe di documento con cui si sta scrivendo, tra \label e array può essere necessario dare il comando \vspace{-\bigskipamount}.

6.5.3

Controllare gli oggetti mobili

Spesso, come si è visto, si ritiene che LATEX sposti gli oggetti mobili nel documento finito lontano dal punto in cui li si include nel sorgente.

figure

148

tabelle e figure

Quando LATEX si comporta così, lo fa essenzialmente perché si usano le opzioni di collocazione nel modo sbagliato. Questo paragrafo spiega le decisioni da prendere durante la stesura del testo e (solo se davvero necessarie) durante la revisione.

Che cosa fare durante la stesura

Perché LATEX “sposta” un oggetto?

Si consiglia di introdurre gli oggetti mobili con un’opzione di collocazione tb se sono piccoli, e p se sono grandi.

Bisogna accettare il fatto che se LATEX sposta un oggetto lo fa essenzialmente per due motivi: o perché non ci sta nello spazio a disposizione o per considerazioni estetiche. Per esempio, LATEX non metterà mai una figura seguita da un titolo di paragrafo e da un cambio pagina, ma preferirà stampare il titolo del paragrafo e poi la figura. Oppure, se si aggiunge un oggetto mobile in fondo a una pagina, si sente “obbligato” a spostarlo almeno nella pagina successiva. È inutile forzare LATEX a mettere l’oggetto nella posizione che si vuole: se lo spazio fisico non c’è, non lo si può inventare.

Per fortuna, con un minimo di accortezza e osservando le indicazioni che daremo, LATEX fa un ottimo lavoro. Durante la redazione del documento, si sa, bisogna concentrarsi soltanto sui contenuti e non sull’impaginazione. Innanzitutto, dunque, si evitino le collocazioni fatte “a mano”, perché interferiscono con il complesso algoritmo con cui LATEX gestisce gli oggetti mobili e quasi sempre producono risultati peggiori di quelli automatici.

Se in queste circostanze ci si lamenta di LATEX, probabilmente è perché si sono usate in modo indiscriminato sequenze di collocazione come htbp o, peggio, !ht, ritenute a torto le migliori. Opzioni di questo genere possono funzionare soltanto se gli oggetti da includere sono molto piccoli (cioè hanno un’altezza di molto inferiore all’altezza del corpo del testo).

Le opzioni di collocazione vanno usate con accortezza. In primo luogo, ci si chieda se l’oggetto che si vuole introdurre è abbastanza piccolo per stare in una pagina insieme a del testo oppure se avrà bisogno di una pagina tutta per sé. Nel primo caso, l’opzione corretta è tb: se le code di stampa non contengono ulteriori oggetti, LATEX può mettere l’oggetto subito prima del punto d’inclusione (cosa che non può fare con ht) o nella pagina immediatamente successiva. Nel secondo caso, l’opzione corretta è p: LATEX stamperà immediatamente l’oggetto in una pagina dedicata, senza doverlo spostare alla fine del capitolo (ciò che accade con tbp). Si tenga presente che il risultato ottimale si ha quando oggetti mobili e relativi riferimenti sono sulla stessa pagina o al massimo in due pagine contigue (a libro aperto non dovrebbe essere necessario voltare pagina, per intenderci).10 È sufficiente sfogliare un qualunque libro ben impaginato per accorgersi che tabelle e figure vi sono incluse proprio in questo modo: di regola, in cima o alla fine della pagina; in una pagina a sé se sono grandi; raramente, soltanto se davvero piccole, nel corpo del testo.11 10 Alcune redazioni, talvolta, richiedono che nelle bozze tutte le figure e le tabelle siano riportate alla fine del documento: il pacchetto endfloats risolve il problema.

11 In un documento scritto su più colonne, i risultati migliori si ottengono includendo gli oggetti con l’opzione t durante la scrittura, e distribuendoli omogeneamente sulle diverse colonne soltanto durante la revisione finale. Così facendo, LATEX cerca di mettere un solo oggetto per colonna, evitando di congestionare il documento.

6.5 oggetti mobili

Che cosa fare durante la revisione

Prima di stampare, può essere ancora necessario intervenire a mano per correggere la collocazione degli oggetti mobili, dando per esempio uno dei comandi \clearpage o \cleardoublepage visti nel paragrafo 4.14 a pagina 79.

Possono inoltre tornare utili altri due pacchetti. Il pacchetto float definisce l’indicatore H (Here, “esattamente qui, in ogni caso”), da usare sempre da solo, che forza la collocazione dell’oggetto nel punto esatto in cui viene incluso nel sorgente; il pacchetto placeins definisce il comando \FloatBarrier , che traccia delle barriere invalicabili per gli oggetti mobili. \dots qui finisce un capoverso. \begin{figure}[H] \centering \includegraphics[width=% 0.5\columnwidth]{Formica} \caption{Figura collocata a mano.} \label{fig:float} \end{figure} La figura~\vref{fig:float} è un esempio di figura mobile collocata a mano.

\clearpage \cleardoublepage

float placeins

. . . qui finisce un capoverso.

L’immagine a fianco riproduce la litografia Formica di M. Escher.

Figura 9: Figura collocata a mano.

La figura 9 è un esempio di figura mobile collocata a mano.

Si raccomanda di non abusare dell’opzione H: essa va usata solo in circostanze eccezionali ed esclusivamente durante la revisione finale per ottenere un effetto di impaginazione particolare e, soprattutto, se si sa davvero che cosa si sta facendo.

6.5.4 Personalizzare le didascalie: caption

Il pacchetto caption personalizza finemente le didascalie degli oggetti mobili. Quelle di questa guida sono state composte impostando il pacchetto in questo modo: \usepackage[font=small,format=hang,labelfont={sf,bf}]{caption}

dove: • format=hang incolonna (hang) la seconda riga di una didascalia particolarmente lunga sotto la prima (LATEX centra automaticamente le didascalie che occupano una sola riga); • labelfont={sf,bf} imposta l’intestazione della didascalia in caratteri senza grazie (sans serif) e in neretto (boldface).

Per stampare automaticamente la didascalia di una tabella nella posizione corretta basta caricare caption e scrivere una volta per tutte nel preambolo: \captionsetup[table]{position=top}

149

L’opzione H va usata solo in casi eccezionali.

caption

150

tabelle e figure

Lo stesso risultato di può ottenere con le classi KOMA-Script impostando il pacchetto come segue dopo aver selezionato l’opzione di classe tablecaptionavobe: \captionsetup[table]{skip=\medskipamount}

In questo modo si evita di dover dare \medskip in ogni tabella.

6.5.5 Specialità

Affiancare gli oggetti subfig

Il pacchetto subfig (che richiede caption) gestisce più (sotto)figure o (sotto)tabelle (come la tabella 38 a pagina 132) in un unico ambiente mobile e ne regola le didascalie molto finemente.

Per includere nel documento un sottooggetto mobile si usa il comando \subfloat , che richiede due argomenti facoltativi con la stessa funzione degli argomenti facoltativo e obbligatorio di \caption : • il primo, se presente, indica ciò che andrà nel relativo elenco (\listoffigures o \listoftables ); • il secondo indica la sottodidascalia che comparirà sulla pagina [Gregorio, 2010].

Il consueto comando \label assegna un’etichetta a ciascun sottooggetto per poterglisi riferire da un punto qualsiasi del documento.

La figura 10 nella pagina successiva è stata ottenuta con un codice del tipo: \begin{figure}[p] \centering \subfloat[][\emph{Mano con sfera riflettente}.] {\includegraphics[width=.45\columnwidth]{Sfera}} \quad \subfloat[][\emph{Belvedere}.] {\includegraphics[width=.45\columnwidth]{Belvedere}} \\ \subfloat[][\emph{Cascata}.] {\includegraphics[width=.45\columnwidth]{Cascata}} \quad \subfloat[][\emph{Salita e discesa}.] {\includegraphics[width=.45\columnwidth]{SalitaDiscesa}} \caption{Alcune litografie di M.~Escher.} \label{fig:subfig} \end{figure}

Si noti che il comando \quad , che in modo matematico stampa uno spazio di un quadrato, funziona anche in modo testuale.

Didascalie laterali sidecap

Il pacchetto sidecap stampa una didascalia accanto all’oggetto anziché sopra o sotto di esso. Le opzioni fondamentali del pacchetto sono le seguenti: outercaption La didascalia è posta nel margine esterno della pagina

(a sinistra in quelle pari e a destra in quelle dispari). È l’opzione predefinita.

6.5 oggetti mobili

(a) Mano con sfera riflettente.

(b) Belvedere.

(c) Cascata.

(d) Salita e discesa.

Figura 10: Esempio dâ&#x20AC;&#x2122;uso del pacchetto subfig (le immagini riproducono alcune litografie di M. Escher).

151

tabelle e figure

152

Figura 11: Esempio d’uso del pacchetto sidecap (l’immagine riproduce la litografia Concavo e convesso di M. Escher). innercaption La didascalia è posta nel margine interno della pagina

(a destra in quelle pari e a sinistra in quelle dispari).

leftcaption, rightcaption La didascalia è sempre posta a sinistra o

a destra dell’oggetto, rispettivamente.

raggedright, raggedleft, ragged Giustificano le didascalie brevi in

modo più fine.

Il pacchetto sidecap definisce due nuovi ambienti SCfigure e SCtable (analoghi agli ambienti figure e table) che prevedono due argomenti facoltativi, \begin{SCfigure}[hlarghezza relativai][hcollocazionei]

e \begin{SCtable}[hlarghezza relativai][hcollocazionei]

dove: • hlarghezza relativai indica il rapporto fra larghezza della didascalia e larghezza della figura o della tabella corrispondente. Un valore elevato di hlarghezza relativai (50, per esempio) imposta per la didascalia la larghezza massima possibile. Il valore predefinito è \sidecaptionrelwidth (che è pari a 1).

• hcollocazionei indica il consueto parametro di collocazione degli oggetti mobili e si usa come negli ambienti figure e table. Il valore predefinito è tbp.

La figura 11 è stata inclusa con un codice del tipo: \begin{SCfigure}[][tb] \centering \includegraphics[width=0.5\columnwidth]{ConcavoConvesso} \caption{Un esempio di figura con didascalia laterale.} \label{fig:sidecap} \end{SCfigure}

Esistono anche gli ambienti SCfigure* e SCtable* (la cui sintassi è la stessa di SCfigure e SCtable) che in un documento a più colonne permettono di ottenere rispettivamente una figura o una tabella mobile (con didascalia laterale) estesa su tutta la pagina.

“Avvolgere” un oggetto mobile

6.5 oggetti mobili

Vi sono circostanze in cui può essere desiderabile “avvolgere” un oggetto con del testo. Risolve il problema il pacchetto wrapfig, particolarmente indicato perché interagisce correttamente con caption per personalizzare opportunamente la didascalia.

Il pacchetto definisce l’apposito ambiente wrapfloat, nel quale mettere l’oggetto con i comandi consueti. Ragioni estetiche impongono di circondarlo soltanto con testo “puro” e di rimandare più oltre l’eventuale inserimento di altri oggetti. Tuttavia, anche operando correttamente il pacchetto non garantisce un risultato ottimale già alla prima compilazione: potrebbero essere necessari numerosi aggiustamenti manuali della pagina, più o meno consistenti.

Figura 12: Esempio d’uso del pacchetCome si può osservare, una to wrapfig (l’immagine riwrapfig correttamente inclusa dà produce la litografia Relatiun risultato altamente professiovità di M. Escher). nale, ma si raccomanda di usare questa tecnica soltanto in circostanze davvero eccezionali. Le condizioni che garantiscono la buona riuscita dell’operazione, infatti, sono particolari: la composizione deve essere a piena pagina, e la colonna di testo sufficientemente grande da poter comprendere una figura larga la sua metà: in caso contrario, la colonna di testo accanto all’immagine risulterà troppo stretta e inevitabilmente solcata dai ruscelli. La regola da seguire rimane la stessa: includere tutti gli oggetti fuori testo e lasciar fare a LATEX. Soltanto a lavoro ultimato, quando il risultato finale è davvero soddisfacente, sarà possibile ricollocare qualcuno degli oggetti secondo il proprio gusto.

La figura 12 è stata inclusa con un codice del tipo: \dots ‘‘Avvolgere’’ un oggetto con del testo è molto semplice. \begin{wrapfloat}{figure}{I}{0pt} \includegraphics[width=0.5\columnwidth]{Relativo} \caption{Esempio di figura ‘‘avvolta’’ da un testo.} \end{wrapfloat} Può rendersi necessario un po’ di lavoro per ottenere un’impaginazione ottimale. \dots

Come si vede nell’esempio precedente, l’ambiente wrapfloat richiede tre argomenti obbligatori: \begin{wrapfloat}{hoggettoi}{hcollocazionei}{hlarghezzai}

Dove: • hoggettoi indica il tipo di oggetto (figure o table, da non confondersi con gli ambienti omonimi) da includere nel documento;

153 wrapfig

154

tabelle e figure

Tabella 46: Caratteri di collocazione dell’ambiente wrapfloat. r, l, i, o,

R L I O

Sul lato destro del testo (right) Sul lato sinistro del testo (left) Sul margine interno (inner) Sul margine esterno (outer)

• hcollocazionei, che dice a LATEX dove mettere l’oggetto sulla pagina, accetta una sola delle otto opzioni della tabella 46, in maiuscolo o in minuscolo a seconda che si voglia stampare l’oggetto “esattamente qui nel testo” o che si voglia creare un oggetto mobile, rispettivamente; • hlarghezzai specifica la larghezza dell’oggetto che, se nulla (0pt), equivale all’opzione assegnata al comando \includegraphics .

7 indice 7.1 7.2 7.3

7.4

LA BIBLIOGRAFIA L’ambiente thebibliography 155 Il pacchetto biblatex 157 Le basi di biblatex 157 7.3.1 Caratteristiche generali e pacchetti accessori 158 7.3.2 Basi di dati dei riferimenti bibliografici 158 7.3.3 I diversi tipi di record 159 7.3.4 I diversi tipi di campo 161 7.3.5 Stili bibliografici e schemi di citazione 163 7.3.6 Collocare la bibliografia nel documento 166 7.3.7 Comandi per le citazioni 167 7.3.8 Generare la bibliografia 168 7.3.9 Stili bibliografici personalizzati 169 Specialità 170 7.4.1 Campi speciali 170 7.4.2 Campi omissibili 170 7.4.3 Riferimenti finali e riferimenti cliccabili 170 7.4.4 Bibliografia multilingue 171 7.4.5 Suddividere la bibliografia 171

Realizzare e gestire la bibliografia è da sempre uno degli aspetti più delicati nella stesura di un documento: LATEX offre gli strumenti per svolgere questo compito con efficienza e flessibilità.

Si può creare la bibliografia in due modi: a mano, con l’ambiente thebibliography; oppure in automatico, con il pacchetto biblatex.

7.1

l’ambiente thebibliography

L’ambienteuna thebibliography gestisce la bibliografia in modo assai Realizzare bibliografia è generalmente piuttosto complicato.

Con AT X sonoanche semplice, se (a differenza di biblatex, presentato nel prossimo L disponibili svariati strumenti per gestire questo lavoro con E paragrafo) non molto flessibile. Di seguito se ne mostra un esempio: grande efficienza e flessibilità. \begin{thebibliography}{9} \bibitem{eco:tesi} Eco, Umberto (1977), \emph{Come si fa una tesi di laurea}, Bompiani, Milano. \bibitem{mori:tesi} Mori, Lapo Filippo (2007), “Scrivere la tesi di laurea con \LaTeXe”, \Ars~(3). \end{thebibliography}

BIBLIOGRAFIA

[1] Eco, Umberto (1977), Come si fa una tesi di laurea, Bompiani, Milano.

[2] Mori, Lapo Filippo (2007), “Scrivere la tesi di laurea con LATEX 2ε ”, ArsTEXnica (3).

Il comando cite viene usato per fare riferimento ad un elemento della bibliografia, e stampa il numero o l’etichetta dell’opera questa è per sì che allora stampa il numero o l’etichetta dell’opera questa è per 155 sì che allora: Si veda~\cite{eco:tesi} per maggiori dettagli.

Si veda [1] per maggiori dettagli.

Si possono indicare pagine, capitoli, . . . nel riferimento tramite il parametro opzionale di cite:

156

Aggiungere all’indice la voce Bibliografia

la bibliografia

Per aggiungere all’indice generale del documento la sezione della bibliografia, subito prima di aprire l’ambiente thebibliography vanno dati alcuni comandi, diversi a seconda della classe di documento con cui si sta scrivendo.

I comandi seguenti aggiungono la voce Bibliografia all’indice generale di un documento scritto con la classe book o report:1 \cleardoublepage \addcontentsline{toc}{chapter}{\bibname}

dove: • \cleardoublepage fa cominciare la bibliografia in una pagina nuova (destra) e assegna alla corrispondente voce nell’indice il numero di pagina corretto; • chapter precisa il livello del titolo che viene aggiunto all’indice (toc): in questo caso, un capitolo; • \bibname stampa la voce Bibliografia.

Aggiungere all’indice la voce Riferimenti bibliografici

Il comando seguente aggiunge la voce Riferimenti bibliografici all’indice di un documento scritto con la classe article.2

\addcontentsline{toc}{section}{\refname}

dove: • section precisa il livello del titolo che viene aggiunto all’indice (toc): in questo caso, un paragrafo; • \refname stampa la voce Riferimenti bibliografici.

Con

thebibliography,

gli elementi della bibliografia vanno ordinati a mano.

Assegnare etichette personalizzate

In un documento scritto con la classe article, la bibliografia dovrebbe cominciare immediatamente dopo il corpo principale del testo (e non in una pagina nuova). Se, però, l’articolo termina esattamente alla fine di una pagina (e la bibliografia quindi, comincia proprio all’inizio della pagina successiva), LATEX potrebbe non assegnare il numero di pagina corretto alla voce Riferimenti bibliografici nell’indice generale. Si risolve l’inconveniente premettendo \clearpage al comando appena esaminato.

L’ambiente thebibliography è simile a itemize. Nel file sorgente, ogni elemento della bibliografia comincia con un \bibitem , nel cui argomento si scrive l’etichetta che identifica l’opera (come con \label ); subito dopo si indicano autore, titolo (in corsivo o in tondo), editore e anno di pubblicazione. Gli elementi vanno ordinati a mano, perché thebibliography (al contrario di biblatex) non lo fa automaticamente.

Ciascuna voce bibliografica viene contrassegnata nel documento finito con un numero tra parentesi quadre, e le si può assegnare un’etichetta personalizzata scrivendola nell’argomento facoltativo di \bibitem : \bibitem[Eco, 77]{eco:tesi} Eco, Umberto (1977), ...

1 Se hyperref è caricato, si ricordi di dare \phantomsection nei modi spiegati nel paragrafo 4.4.2 a pagina 55.

2 Si veda la nota precedente.

\begin{thebibliography}{9} \bibitem{eco:tesi} Eco, Umberto (1977), \emph{Come si fa una tesi di laurea}, Bompiani, Milano.

BIBLIOGRAFIA

7.1 il pacchetto biblatex

[1] Eco, Umberto (1977), Come si fa una tesi di laurea, Bompiani, Il\bibitem{mori:tesi} secondo argomento di thebibliography precisa la lunghezza massiMilano.

157

Mori, Lapo Filippo (2007), ma di queste etichette:

[2] Mori, Lapo Filippo (2007), «Scrivere la tesi di laurea «Scrivere tesi di dieci laureaopere, con • \LaTeXe», in genere si scrive 9 se in bibliografia ci sono la meno con \Ars~(3).

A nica A L T X 2 », rsT X (3). \end{thebibliography} ε 99 se ce ne sono almeno dieci ma meno E di cento,E eccetera;

usando etichette personalizzate, si scrive l’etichetta lunga.

Il• comando cite viene usato per fare riferimento ad più un elemento della stampa il della numero o l’etichetta questa è Perbibliografia, riferirsi a une elemento bibliografia da dell’opera un punto qualsiasi per sì che allorasistampa il numero o l’etichetta dell’opera questadell’oè per del documento dà \cite , che stampa il numero o l’etichetta sì che allora: pera: Si veda~\cite{eco:tesi} per maggiori dettagli.

Riferimenti

Si veda [1] per maggiori dettagli.

Si possono indicare indicare nel pagine, capitoli,anche . . . nel riferimento tramite paraSi possono riferimento numeri di pagina o di ilcapitometro opzionale di cite: lo, scrivendoli esplicitamente nell’argomento facoltativo del comando: veda~\cite[p.~7]{eco:tesi} Si veda~\cite[p.~27]{eco:tesi} per maggiori dettagli.

[1, p. p. 27] 7] per maggiori Si veda [1, dettagli.

Il comando cite viene usato per fare riferimento ad un elemento della bibliografia, e stampa il numero o l’etichetta dell’opera:

7.2 il pacchetto biblatex Si veda~\cite{eco:tesi} per maggiori dettagli.

Si veda [1] per maggiori dettagli.

Il risultato di thebibliography è dignitoso, ma presenta alcuni inconvenienti da cite non viene sottovalutare: Il comando usato per fare riferimento ad un elemento della stampa il numero o l’etichetta dell’opera: • bibliografia, gli elementi edella bibliografia non vengono ordinati automaticamente;

I limiti di thebibliography

Si veda [1, p. 27] per maggiori Si veda~\cite[p.~27]{eco:tesi} • maggiori bisogna riscrivere per ogni documento, anche se per dettagli. la bibliografia dettagli.

c’è solo qualche opera di differenza dall’uno all’altro;

• se il documento viene aggiornato, bisogna modificare le bibliografie di tutti i documenti in cui esso è citato; • per cambiare lo stile della bibliografia bisogna modificare a mano tutte le voci, una per una.

Come si noterà, piuttosto che compilare bibliografie indipendenti è decisamente meglio creare una volta per tutte una base di dati delle opere, e a partire da questa generare automaticamente la bibliografia del proprio documento in funzione delle citazioni in esso contenute.

7.3

le basi di biblatex

In questo paragrafo, basato su [Mori, 2008] e su [Lehman, 2011], cui si rimanda per ogni approfondimento, vengono presentati i concetti1 fondamentali del pacchetto biblatex, che offre all’autore una soluzione complessiva e automatica per gestire e personalizzare la bibliografia e gli stili bibliografici e di citazione in un documento composto con LATEX. Infatti, oltre a includere in sé le funzioni di molti pacchetti, biblatex permette di effettuare modifiche anche profonde di un particolare stile bibliografico.

Generare automaticamente la bibliografia

158 Installazione

la bibliografia

7.3.1 Caratteristiche generali e pacchetti accessori

Il pacchetto biblatex è ancora in fase di sviluppo, ma è già stato incluso in TEX Live 2010 e in MiKTEX 2.9.

Per il corretto funzionamento di biblatex si raccomanda di caricare (ma non è strettamente necessario) anche i pacchetti babel e csquotes (con l’opzione babel). Questa è la sequenza di caricamento: \usepackage[hlinguei]{babel} \usepackage[babel]{csquotes} \usepackage[hopzionii]{biblatex}

Ovviamente, biblatex non può essere usato assieme ai pacchetti che si propone di sostituire.

Record bibliografici

7.3.2 Basi di dati dei riferimenti bibliografici

Una base di dati dei riferimenti bibliografici è un file con estensione

.bib che contiene un certo numero di record come i seguenti: @book{eco:tesi, author title publisher year location }

= = = = =

@article{mori:tesi, author = title = journaltitle = number = year = }

{Eco, Umberto}, {Come si fa una tesi di laurea}, {Bompiani}, {1977}, {Milano}

{Mori, Lapo Filippo}, {Scrivere la tesi di laurea con \LaTeXe}, {\Ars}, {3}, {2007}

@manual{mori:poesie, author = {Mori, Lapo Filippo}, title = {Scrivere poesie con \LaTeX}, year = {2007}, url = {http://www.guit.sssup.it/} } @online{wiki:latex, title = year = url = sortkey = label = }

{\LaTeX{} su Wikipedia}, {2010}, {http://it.wikipedia.org/wiki/LaTeX}, {wiki}, {wiki}

Si osservi che: • Ogni record corrisponde a un’opera, il cui tipo viene indicato come prima cosa subito dopo il carattere @. Si tratta in questo caso di un libro (record di tipo book), di un articolo (record di

7.3 le basi di biblatex

tipo article), di un manuale (record di tipo manual) e di un sito Web (record di tipo online).

159

• Si indica poi una chiave che servirà per identificare l’opera nella base di dati e per citarla nei documenti come argomento dei comandi \cite (o analoghi). Il formato della chiave è libero, ma di solito si usa il nome dell’autore seguito da : e da una parola che caratterizza l’opera. In una base di dati, le chiavi devono essere uniche.

• Infine, si riempie una serie di campi che definiscono l’opera (autore, titolo, eccetera). Ogni campo assume la forma hnome del campoi = {hcontenuto del campoi}

ed è separato dalla chiave e da altri campi con la virgola.

7.3.3 I diversi tipi di record

Ogni record contiene uno o più campi. Un campo può essere: • obbligatorio, ovvero indispensabile a biblatex per generare la bibliografia; • opzionale, cioè non indispensabile ma utile, se specificato, per completare le informazioni sull’opera cui si riferisce.

Di seguito si elencano i principali tipi di record riconosciuti da biblatex.

Per ognuno si indicano i campi obbligatori e i principali campi opzionali (il loro significato verrà spiegato nel paragrafo successivo). I record e i campi disponibili con biblatex sono numerosissimi e rispondono alle esigenze più disparate; per il loro elenco completo se ne veda la documentazione. article Articolo apparso in una rivista o in un giornale.

Campi obbligatori: author, title, journaltitle, year.

Campi opzionali: editor, series, volume, number, month, pages, note, url. book Libro regolarmente pubblicato da una casa editrice.

Campi obbligatori: author, title, year.

Campi opzionali: editor, volume, series, number, publisher, location, note, url. booklet Libro distribuito in proprio.

Campi obbligatori: author o editor, title, year.

Campi opzionali: howpublished, type, note, location, chapter, pages, url. collection Raccolta di contributi indipendenti di autori diversi.

Campi obbligatori: editor, title, year.

Campi opzionali: volume, series, number, publisher, location, note, chapter, pages, url.

Principali record di biblatex

160

la bibliografia

inbook Parte di un libro con un titolo proprio.

Campi obbligatori: author, title, booktitle, year.

Campi opzionali: editor, volume, series, number, publisher, location, chapter, note, pages, url. incollection Parte di una raccolta con un titolo proprio.

Campi obbligatori: author, title, booktitle, year.

Campi opzionali: volume, series, number, publisher, location, note, chapter, pages, url. inproceedings Articolo nei lavori di una conferenza.

Campi obbligatori: author, editor, title, booktitle, year.

Campi opzionali: volume, series, number, note, organization, publisher, location, chapter, pages, url. manual Documentazione tecnica. I campi author o editor possono essere omessi (si veda il paragrafo 7.4.2 a pagina 170).

Campi obligatori: author o editor, title, year.

Campi opzionali: type, version, series, number, organization, note, publisher, location, chapter, pages, url. misc Record da usare quando nessuno degli altri è appropriato. I campi author o editor possono essere omessi (si veda il paragrafo 7.4.2 a pagina 170).

Campi obbligatori: author o editor, title, year.

Campi opzionali: howpublished, type, organization, location, note, date, url. online Risorsa disponibile su Internet. I campi author o editor possono essere omessi (si veda il paragrafo 7.4.2 a pagina 170).

Campi obbligatori: author o editor, title, year, url.

Campi opzionali: note, organization, date. proceedings Lavori di una conferenza. Il campo editor può essere omesso (si veda il paragrafo 7.4.2 a pagina 170).

Campi obbligatori: editor, title, year.

Campi opzionali: volume, series, number, note, organization, publisher, location, chapter, pages, url. report Relazione pubblicata da universitĂ , scuola o altra istituzione.

Campi obbligatori: author, title, type, institution, year.

Campi opzionali: number, note, location, chapter, pages, url. thesis Tesi di laurea o di dottorato. Il campo type specifica il tipo di tesi.

7.3 le basi di biblatex

Campi obbligatori: author, title, type, institution, year.

Campi opzionali: note, location, chapter, pages, url.

161

unpublished Documento con autore e titolo, ma non pubblicato.

Campi obbligatori: author, title, year.

Campi opzionali: howpublished, note, date, url.

7.3.4 I diversi tipi di campo

Di seguito si riporta l’elenco dei principali tipi di campo riconosciuti da biblatex.

author Nome e cognome dell’autore (o degli autori, nel formato descritto più avanti). booktitle Titolo dell’opera principale, per lavori che sono parte di una pubblicazione più ampia. chapter Numero del capitolo (o di una qualunque parte del documento). editor Nome e cognome del curatore (o dei curatori). howpublished Genere della pubblicazione. institution Nome dell’università o dell’istituzione. journaltitle Nome della rivista o del giornale. label Etichetta per le citazioni, nel caso in cui manchino i dati necessari per formare l’etichetta “regolare” (si veda il paragrafo 7.4.2 a pagina 170). location Indirizzo dell’editore (publisher) o dell’istituzione (institution).

month Mese di pubblicazione dell’opera. Dev’essere un numero intero; per esempio, non si scrive month={January}, ma month={1}. note Informazioni supplementari che possono aiutare il lettore a identificare meglio l’opera. number Numero della rivista, del giornale o della raccolta.

Principali campi di biblatex

162

la bibliografia

organization Organizzazione che pubblica il documento o patrocina la conferenza. pages Uno o più numeri di pagina. publisher Nome dell’editore. series Nome della collezione di cui l’opera fa parte. sortkey Ordina alfabeticamente le voci bibliografiche prive dell’indicazione di autore o curatore (si veda il paragrafo 7.4.1 a pagina 170). title Titolo dell’opera. type Tipo di manuale, relazione o tesi. url Indirizzo Internet di riferimento per l’opera. volume Numero di volume dell’opera. year Anno di pubblicazione dell’opera.

Il problema delle maiuscole

Alcune precisazioni

Gli stili predefiniti di biblatex stampano il titolo dell’opera rispettando le maiuscole e le minuscole. Un titolo come

title = {TCP-IP e lo Zen di Confucio}

verrà stampato esattamente com’è scritto. Alcuni suoi stili personalizzati, invece, lo stampano automaticamente tutto in minuscolo, con risultati a volte indesiderati. Si può risolvere il problema racchiudendo in ulteriori gruppi di graffe solo le parole problematiche, così: title = {{TCP-IP} e lo {Zen} di {Confucio}}

oppure l’intero titolo, così: title = {{TCP-IP e lo Zen di Confucio}}

Un comando che produce testo presente in un campo non va racchiuso tra graffe se si lavora con uno stile predefinito: title = {L’arte di scrivere con \LaTeX}

ma potrebbe essere necessario farlo se lo stile è personalizzato: title = {L’arte di scrivere con {\LaTeX}}

7.3 le basi di biblatex

Più nomi in un campo author o editor vanno separati con and:

163

Autori multipli

author = {Mori, Lapo Filippo and Himmelmann, Maurizio}

Se l’elenco dei nomi degli autori o dei curatori è troppo lungo, può essere concluso da and others, che di regola viene reso da biblatex come et al.: author = {Gregorio, Enrico and Mori, Lapo Filippo and Pantieri, Lorenzo and others}

I cognomi multipli si scrivono separando i cognomi e il nome in questo modo:

Cognomi multipli

author = {Levi Montalcini, Rita}

Con i cognomi preceduti da particelle con iniziale minuscola (von o van, per esempio) biblatex si comporta in modo particolare. Si immagini che l’autore sia Ludwig van Beethoven: gli stili standard considerano il cognome come se non avesse la particella e lo mettono in ordine alfabetico di conseguenza. Per evitarlo, seguendo la tradizione italiana, basta dare a biblatex l’opzione useprefix:

Cognomi preceduti da particelle

\usepackage[h. . .i,useprefix]{biblatex}

e il cognome viene considerato per intero. (Con qualunque stile, l’opzione useprefix=false, predefinita negli stili standard, tratta il cognome come se non avesse la particella davanti.)

Se il cognome è invece preceduto da una particella con iniziale maiuscola, viene sempre considerato per intero e messo in ordine alfabetico di conseguenza. Per esempio, De Gasperi cade sotto la lettera d.

7.3.5 Stili bibliografici e schemi di citazione

I formati dei riferimenti bibliografici e delle citazioni di biblatex sono contenuti in file .bbx (stili bibliografici) o .cbx (schemi di citazione) e si specificano con un’opzione del pacchetto: \usepackage[style=alphabetic]{biblatex}

oppure \usepackage[bibstyle=authortitle,% citestyle=verbose-trad1]{biblatex}

Nel primo caso, il valore alphabetic è assegnato sia a bibstyle sia a citestyle.

Il pacchetto biblatex fornisce quattro stili bibliografici predefiniti, diversi nel formato complessivo dell’elenco dei riferimenti bibliografici e nel tipo di etichetta che ci viene stampato. Tutti e quattro elencano le opere nella bibliografia secondo l’ordine alfabetico del cognome del loro autore. Di seguito se ne dà una breve descrizione. numeric Assegna a ciascuna opera un numero progressivo ([1], [2], eccetera).

Stili bibliografici predefiniti di biblatex

164

la bibliografia

alphabetic Assegna a ciascuna opera un’etichetta formata dalla prima parte del cognome dell’autore e dalle ultime due cifre dell’anno di pubblicazione ([Mor07]). authoryear Non assegna alle opere alcuna etichetta, ma anticipa l’anno di pubblicazione subito dopo il nome dell’autore (o del curatore). authortitle Non assegna alle opere alcuna etichetta.

Alcuni schemi di citazione predefiniti di biblatex

A ciascuno stile si possono associare (non contemporaneamente) uno o più schemi di citazione appropriati, che ne riproducono l’effetto nel corpo del documento. Ogni schema, però, può essere associato a un solo stile bibliografico. Di seguito si descrivono quattro degli schemi predefiniti da biblatex e alcune loro varianti, utili per ottenere riferimenti in altri formati. numeric, numeric-comp Tipo di riferimento: numerico ([1], [2], eccetera).

Da associare a: stile numeric.

Varianti: numeric-comp, che ordina e comprime automaticamente le citazioni multiple. Per esempio, si ottiene [2–4, 8] al posto di [4, 2, 8, 3].

alphabetic Tipo di riferimento: misto ([Mor07]).

Da associare a: stile alphabetic. authoryear, authoryear-comp Tipo di riferimento: autore, anno ([Mori, 2007]).

Da associare a: stile authoryear.

Varianti: authoryear-comp, che ordina e comprime automaticamente le citazioni multiple con lo stesso autore (ed eventualmente lo stesso anno di pubblicazione). Per esempio, si ottiene [Eco 1977; Mori 2007a,b] anziché [Mori 2007b; Eco 1977; Mori 2007a]. authortitle, authortitle-comp, verbose, verbose-trad1 Tipo di riferimento: autore, titolo (Mori, Titolo).

Da associare a: stile authortitle.

Varianti: • authortitle-comp, che ordina e comprime automaticamente le citazioni multiple di opere con lo stesso autore. Per esempio, si ottiene [Mori, Primo titolo, Secondo titolo] anziché [Mori, Primo titolo; Mori, Secondo titolo].

• verbose, che usa la citazione completa la prima volta e una sua forma abbreviata le volte successive; prevede a sua volta alcune varianti (tra cui verbose-trad1) in cui vengono usate, a seconda del contesto, le formule convenzionali idem, ibidem, op. cit. e loc. cit.

7.3 le basi di biblatex

Bibliografia

Bibliografia

[1] Umberto Eco. Come si fa una tesi di laurea. Milano: Bompiani, 1977.

[2] Lapo Filippo Mori. “Scrivere la tesi di laurea con LATEX 2ε”. In: ArsTEXnica 3 (2007).

[3] Lapo Filippo Mori. Scrivere poesie con LATEX. 2007. url: http: //www.guit.sssup.it/.

[4] LATEX su Wikipedia. 2010. url: http : / / it . wikipedia . org / wiki/LaTeX.

[Eco77]

(a) Stile numeric.

Umberto Eco. Come si fa una tesi di laurea. Milano: Bompiani, 1977.

[Mor07a] Lapo Filippo Mori. “Scrivere la tesi di laurea con LATEX 2ε”. In: ArsTEXnica 3 (2007).

[Mor07b] Lapo Filippo Mori. Scrivere poesie con LATEX. 2007. url: http : / / www . guit . sssup.it/.

[Wiki10] LATEX su Wikipedia.

2010. url: http : / / it . wikipedia . org / wiki / LaTeX.

(b) Stile alphabetic.

Bibliografia

Bibliografia

Eco, Umberto (1977). Come si fa una tesi di laurea. Milano: Bompiani.

Mori, Lapo Filippo (2007a). “Scrivere la tesi di laurea con LATEX 2ε”. In: ArsTEXnica 3.

– (2007b). Scrivere poesie con LATEX. url: http : / / www . guit . sssup . it/.

Wiki (2010). LATEX su Wikipedia. url: http://it.wikipedia.org/ wiki/LaTeX.

Eco, Umberto. Come si fa una tesi di laurea. Milano: Bompiani, 1977.

Mori, Lapo Filippo. “Scrivere la tesi di laurea con LATEX 2ε”. In: ArsTEXnica 3 (2007).

– Scrivere poesie con LATEX. 2007. url: http : / / www . guit . sssup . it/.

LATEX su Wikipedia. 2010. url: http: / / it . wikipedia . org / wiki / LaTeX.

(c) Stile authoryear.

(d) Stile authortitle.

Figura 13: Esempi di stili bibliografici.

165

166 Il tipo di documento determina schema e stile da usare.

C’è uno stile bibliografico adatto per ogni schema di citazione.

la bibliografia

Per l’elenco completo degli schemi di citazione di biblatex si rimanda a [Lehman, 2011]. È il tipo di lavoro che si sta scrivendo a determinare lo schema (e quindi lo stile) più adatto da usare. Nei documenti scientifici, quando si cita un’opera per riferirsi a un risultato che non si riporta per intero spesso non ha molta importanza che il lettore sappia chi l’ha scritta e quando: perciò si usa diffusamente lo stile numerico.

Nei documenti umanistici, invece, il riferimento a un autore o a un anno invece che a un altro ha di per sé significato, ed è importante dare queste informazioni direttamente nel testo: ecco perché è molto diffuso lo schema autore-anno, ma solo se la bibliografia è moderna [Eco, 1977, p. 190].

A metà strada tra gli schemi appena considerati c’è lo schema alfabetico: non è sintetico come lo schema numerico e al tempo stesso non riporta sufficienti informazioni nel caso in cui autore e anno di pubblicazione siano essenziali per comprendere la citazione, ma è utile se l’autore deve sottostare a precisi standard editoriali oppure preferisce una via di mezzo.

Lo schema autore-titolo (per cui un’opera citata nel testo ha il proprio riferimento in una nota a piè di pagina) si usa esclusivamente nei documenti umanistici: il lettore conosce subito l’opera cui lo si rimanda, ma la pagina potrebbe diventare troppo piena di note e perciò faticosa da leggere.

Per ogni schema di citazione c’è uno stile bibliografico adatto. Assegnando a bibstyle uno di questi schemi, biblatex aiuta l’autore caricando in automatico lo stile corrispondente. Il codice \usepackage[style=authoryear-comp]{biblatex}

equivale a \usepackage[bibstyle=authoryear,% citestyle=authoryear-comp]{biblatex}

Stili di biblatex si adattano automaticamente alla lingua impostata con babel.

biblatex adatta automaticamente i propri stili e schemi predefiniti alla lingua impostata con babel.

7.3.6 Collocare la bibliografia nel documento

Una volta create le basi di dati, il più è fatto. Ora ci si può riferire a un’opera da un punto qualsiasi del documento dando il comando \cite e scrivendogli nell’argomento la chiave corrispondente: Si veda~\cite{eco:tesi} per maggiori dettagli.

Collocare la bibliografia

Per indicare a LATEX dove collocare la bibliografia nel documento, si dà nel preambolo il comando \bibliography , nel cui argomento va scritto l’elenco delle basi di dati (senza estensione .bib), separate con una virgola e senza spazi supplementari: \bibliography{hbibliografia1i,hbibliografia2i,h. . .i}

Naturalmente, le basi di dati dovranno contenere tutte le opere citate nel documento.

7.3 le basi di biblatex

7.3.7 Comandi per le citazioni

Oltre ai classici \cite e \nocite , biblatex definisce altri comandi per diversi tipi di citazione: • \textcite quando la citazione è parte integrante del discorso; • \parencite racchiude la citazione fra parentesi; • \footcite mette la citazione in una nota; • \supercite (solo per schemi numerici) segnala le citazioni in apice; 3questo siamo tutti Parole questo inserisce sì che è vita èè certo paese per • \fullcite l’intera vocema bibliografica.

Parole questo sì che vita ma per questo siamo tutti Parolecerto questo sìpaese che èèper vitaquesto è certo certosiamo ma paese paese per questo siamo tutti ancora ma tutti ancora sì che èè vita è ancora certo ma paese per questo siamo tutti ancora sì che vita ancora certo maper paese permadonna questo siamo tutti ancora sìquesto che è con vitaloèè Di seguito si mostrano alcuni esempi d’uso dipaese questi comandi certo ma paese questo certo ma per siamo certo ma paese madonna certoancora. maautore-anno paese per per questo questo madonna certo certo ma ma paese paese per per questo questo siamo siamo schema compatto. tutti tutti ancora. tutti ancora.

\cite{eco:tesi} \\ \cite{eco:tesi} \\ \cite{eco:tesi} \\ \\ \cite[5]{eco:tesi} \cite[5]{eco:tesi} \\ \cite[5]{eco:tesi} \\\\ \cite[5-9]{eco:tesi} \cite[5-9]{eco:tesi} \\ \cite[5-9]{eco:tesi} \\ \\ \cite[vedi][]{eco:tesi} \cite[vedi][]{eco:tesi} \\ \cite[vedi][]{eco:tesi} \\ \cite[vedi][5]{eco:tesi} \cite[vedi][5]{eco:tesi} \cite[vedi][5]{eco:tesi}

Eco, 1977 Eco, 1977 Eco, 1977, 1977 p. 5 Eco, 1977, p. p. 55 5-9 Eco, 1977, pp.

Eco, 1977, pp.

Eco, Eco, 1977,1977 pp. 5-9 5-9 vedi vedi 1977 vedi Eco, Eco, 1977, 1977 p. 5 vedi vedi Eco, Eco, 1977, 1977, p. p. 55

\textcite{eco:tesi} \\ \textcite{eco:tesi} \\ \textcite{eco:tesi} \\ \\ \textcite[5]{eco:tesi} \textcite[5]{eco:tesi} \\ \textcite[5]{eco:tesi} \\\\ \textcite[5-9]{eco:tesi} \textcite[5-9]{eco:tesi} \\ \textcite[5-9]{eco:tesi} \\ \\ \textcite[vedi][]{eco:tesi} \textcite[vedi][]{eco:tesi} \\ \textcite[vedi][]{eco:tesi} \\ \textcite[vedi][5]{eco:tesi} \textcite[vedi][5]{eco:tesi} \textcite[vedi][5]{eco:tesi}

Eco (1977) Eco (1977) (1977) p. 5) Eco (1977, Eco p.

Eco (1977, (1977, pp. p. 5) 5)5-9) Eco (1977, pp.

Eco (vedi (1977,1977) pp. 5-9) 5-9) Eco (vedi 1977) 1977) p. 5) Eco (vedi 1977, Eco Eco (vedi (vedi 1977, 1977, p. p. 5) 5)

\parencite{eco:tesi} \\ \parencite{eco:tesi} \\ \parencite{eco:tesi} \\ \\ \parencite[5]{eco:tesi} \parencite[5]{eco:tesi} \\ \parencite[5]{eco:tesi} \\\\ \parencite[5-9]{eco:tesi} \parencite[5-9]{eco:tesi} \\ \parencite[5-9]{eco:tesi} \\ \\ \parencite[vedi][]{eco:tesi} \parencite[vedi][]{eco:tesi} \\ \parencite[vedi][]{eco:tesi} \\ \parencite[vedi][5]{eco:tesi} \parencite[vedi][5]{eco:tesi} \parencite[vedi][5]{eco:tesi}

(Eco, 1977) (Eco, 1977) (Eco, 1977, 1977) p. 5) (Eco, 1977, p. p. 5) 5)5-9) (Eco, 1977, pp.

(Eco, 1977, pp.

(Eco, 1977, pp. 5-9) 5-9) (vedi Eco, 1977) (vedi 1977) (vedi Eco, Eco, 1977, 1977) p. 5) (vedi (vedi Eco, Eco, 1977, 1977, p. p. 5) 5)

\parencite{mori:poesie,% \parencite{mori:poesie,%

(Eco, 1977; Mori, 2007a,b)

\citeauthor{eco:tesi} \\ \citeyear{eco:tesi}

Eco 1977

\parencite{mori:poesie,% (Eco, Mori, eco:tesi,mori:tesi} Come si può osservare, biblatex produce automaticamente (Eco, 1977; 1977; Mori, 2007a,b) 2007a,b) le abbreeco:tesi,mori:tesi} eco:tesi,mori:tesi} viazioni p. e pp. a seconda delle circostanze. (È possibile ottenere anche la scrittura pagine: veda la documentazione del Parole questo sìestesa che èpagina vita èocerto masipaese per questo siamo tutti Parole questo sì che vita èè certo ma per questo siamo tutti Parolecerto questo che èèper vitaquesto certosiamo ma paese paese questo siamo tutti pacchetto.) ancora ma sìpaese tutti per ancora sì che è vita è ancora certo ma paese per questo siamo tutti ancora sì che èè vita ancora certo maper paese per questo siamo tutti ancora sìquesto che vita èè certo ma paese questo madonna certo ma paese per siamo Per citare singole parti di una voce bibliografica ci sono i comandi certo ma per certoancora. ma paese paese per questo questo: madonna madonna certo certo ma ma paese paese per per questo questo siamo siamo tutti \citeauthor e \citeyear tutti ancora. tutti ancora.

Lo schema authoryear-comp mette le citazioni multiple in ordine alfabetico: 3 L’opzione natbib di biblatex permette di mantenere una compatibilità quasi totale con i documenti scritti usando il pacchetto natbib: la maggior parte dei nomi dei comandi per le citazioni di natbib, come \citep e \citet , sono conservati come alias.

167 \cite \nocite \textcite \parencite \footcite \supercite \fullcite

168

\parencite{eco:tesi} \\ \parencite[5]{eco:tesi} \\ \parencite[5-9]{eco:tesi} \\ \parencite[vedi][]{eco:tesi} \\ la bibliografia \parencite[vedi][5]{eco:tesi} \parencite{mori:poesie,% eco:tesi,mori:tesi}

(Eco, 1977) (Eco, 1977, p. 5) (Eco, 1977, pp. 5-9) (vedi Eco, 1977) (vedi Eco, 1977, p. 5)

(Eco, 1977; Mori, 2007a,b)

Parole questo sì che è vita è certo ma paese per questo siamo tutti Parole questo questo sì sì che che èè vita èè certo ma per questo siamo tutti Parole vitaquesto certosiamo ma paese paese per questo siamo tutti ancora certo ma sìpaese per tutti per ancora sì che è vita Parole questo che è vita è certo ma paese questo siamo tuttiè ancora certo ma paese per questo siamo tutti ancora sì che è vita Di ma seguito si per ripropongono gli esempi precedenti con lo èschema ancora certo ma paese permadonna questo siamo tutti ancora sìquesto che vita èè certo paese questo certo ma paese per siamo ancora certo maper paese permadonna questo siamo tutti ancora sìquesto che è vita è certo ma ma paese questo numerico compatto. certo paese per questo madonna certo certo ma ma paese paese per per questo siamo siamo tutti ancora.

Parole sì che è vita è certo certo ma paese per questo siamosiamo tutti certo ma questo paese per questo madonna ma paese per questo tutti ancora. tutti ancora. ancora certo ma paese per questo siamo tutti ancora sì che è vita è tutti ancora.

[1] \cite{eco:tesi} \\ certo ma paese per ma paese per questo siamo [1] \cite{eco:tesi} \\questo madonna certo [1] p. 5] [1, \cite{eco:tesi} \\ \\ \cite[5]{eco:tesi} [1, p. 5] tutti ancora. \cite[5]{eco:tesi} \\ [1, p. 5] \cite[5]{eco:tesi} \\\\ \cite[5-9]{eco:tesi} \cite[5-9]{eco:tesi} \\ \cite[5-9]{eco:tesi} \\ \\ \cite[vedi][]{eco:tesi} \cite[vedi][]{eco:tesi} \\ \cite{eco:tesi} \\ \cite[vedi][]{eco:tesi} \\ \cite[vedi][5]{eco:tesi} \cite[vedi][5]{eco:tesi} \cite[5]{eco:tesi} \\ \cite[vedi][5]{eco:tesi} \cite[5-9]{eco:tesi} \\ \cite[vedi][]{eco:tesi} \textcite{eco:tesi} \\ \\ \textcite{eco:tesi} \\ \cite[vedi][5]{eco:tesi} \textcite{eco:tesi} \\ \\ \textcite[5]{eco:tesi} \textcite[5]{eco:tesi} \\ \textcite[5]{eco:tesi} \\\\ \textcite[5-9]{eco:tesi} \textcite[5-9]{eco:tesi} \\ \textcite[5-9]{eco:tesi} \\ \\ \textcite[vedi][]{eco:tesi} \textcite[vedi][]{eco:tesi} \\ \textcite{eco:tesi} \\ \textcite[vedi][]{eco:tesi} \\ \textcite[vedi][5]{eco:tesi} \textcite[vedi][5]{eco:tesi} \textcite[5]{eco:tesi} \\ \textcite[vedi][5]{eco:tesi} \textcite[5-9]{eco:tesi} \\ \textcite[vedi][]{eco:tesi} \\ \parencite{eco:tesi} \\ \parencite{eco:tesi} \\ \textcite[vedi][5]{eco:tesi} \parencite{eco:tesi} \\ \\ \parencite[5]{eco:tesi} \parencite[5]{eco:tesi} \\ \parencite[5]{eco:tesi} \\\\ \parencite[5-9]{eco:tesi} \parencite[5-9]{eco:tesi} \\ \parencite[5-9]{eco:tesi} \\ \\ \parencite[vedi][]{eco:tesi} \parencite[vedi][]{eco:tesi} \\ \parencite{eco:tesi} \\ \parencite[vedi][]{eco:tesi} \\ \parencite[vedi][5]{eco:tesi} \parencite[vedi][5]{eco:tesi} \parencite[5]{eco:tesi} \\ \parencite[vedi][5]{eco:tesi} \parencite[5-9]{eco:tesi} \\ \parencite[vedi][]{eco:tesi} \\ \parencite{mori:poesie,% \parencite{mori:poesie,% \parencite[vedi][5]{eco:tesi} \parencite{mori:poesie,% Loeco:tesi,mori:tesi} schema numeric-comp ordina eco:tesi,mori:tesi} eco:tesi,mori:tesi}

\printbibliography

[1, pp. 5-9] [1, pp. 5-9] [1, pp.1]5-9] [vedi [vedi 1] [1] [vedi 1, 1] p. 5] [vedi 1, p. 5] [1, p. 5] [vedi 1, p. 5] [1, pp. 5-9] [vedi 1] Eco [1] Eco [1] [vedi 1,p. p.5] 5] [1] Eco [1, Eco [1, p. 5] Eco [1, pp. p. 5]5-9] Eco [1, pp. 5-9] [1, pp.1]5-9] Eco [vedi [vedi 1] Eco 1] p. 5] Eco [1] [vedi 1, Eco [1, [vedi 1, p. 5] p. 5] Eco [vedi 1, p. 5] Eco [1, pp. 5-9] Eco [1] [vedi 1] [1] Eco [1] p.[vedi [1, 5] 1, p. 5] [1, p. 5] p. 5]5-9] [1, pp.

[1, pp. 5-9] [1, pp.1]5-9] [vedi [vedi 1] [1] 1] p. 5] [vedi 1, [vedi 1, p. 5] [1, p. 5] [vedi 1, p. 5] [1, pp. 5-9] [vedi 1] [1–3] [vedi [1–3] 1, p. 5]le citazioni multiple: e comprime [1–3]

Parole questo sì che è vita è certo ma paese per questo siamo tutti \parencite{mori:poesie,% Parole questo sì che è vita è certo [1–3] ma paese per questo siamo tutti Parole questo che èper vitaquesto è certosiamo ma paese questo siamo tuttiè ancora certo ma sìpaese tutti per ancora sì che è vita eco:tesi,mori:tesi} ancora certo ma paese per questo siamo tutti ancora sì che è vita è ancoramacerto maper paese permadonna questo siamo ancora che è siamo vita è certo paese questo certo tutti ma paese persìquesto certo ma paese per questo madonna certo ma paese per questo siamo certoancora. ma paese per questo madonna certo ma paese per questo siamo1 tutti Parole questo sì che è vita è certo ma paese per questo siamo tutti tutti ancora. tutti ancora. ancora certo malapaese per questo siamo tutti ancora sì che è vita è 7.3.8 Generare bibliografia certo ma paese per questo madonna certo ma paese per questo siamo tutti ancora. \bibliography specifica soltanto le basi di dati: il vero Il comando e proprio elenco delle opere si inserisce nel documento composto con l’apposito comando \printbibliography . Per aggiungere all’indice generale del documento la sezione della bibliografia (operazione che biblatex non svolge automaticamente), vanno dati gli stessi comandi già esaminati nel paragrafo 7.1 a pagina 155, aggiungendovi subito dopo \printbibliography .4 Negli esempi seguenti si mostra il codice completo da usare con biblatex per includere la bibliografia in un documento scritto con le classi book o report: \cleardoublepage \addcontentsline{toc}{chapter}{\bibname} \printbibliography

e con la classe article:

4 Se hyperref è caricato, si ricordi di dare \phantomsection nei modi spiegati nel paragrafo 4.4.2 a pagina 55.

1 1 1 1

7.3 le basi di biblatex

169

\addcontentsline{toc}{section}{\refname} \printbibliography

Analogamente a quanto accade con thebibliography (si veda il paragrafo 7.1 a pagina 155), se la bibliografia di un articolo comincia in una pagina nuova bisogna premettere \clearpage al codice appena esaminato, per far sì che biblatex assegni il numero di pagina corretto alla voce Riferimenti bibliografici nell’indice generale.

Questa, infine, è la sequenza di compilazione per generare la bibliografia e includerla nel documento: 1. si compila con LATEX una prima volta; 2. si compila con il programma BibTEX cliccando l’apposito pulsante dell’editor oppure, dalla riga di comando, portandosi nella cartella di lavoro ed eseguendo bibtex hnome del documentoi senza l’estensione .tex;

Generare la bibliografia con biblatex

3. si compila altre due volte con LATEX. 7.3.9 Stili bibliografici personalizzati

In Rete si possono trovare molti altri stili oltre a quelli predefiniti, per comporre bibliografie conformi a precisi standard.5 Installare uno stile non compreso nel pacchetto è molto semplice: 1. si scarica da + ctan l’archivio .zip dello stile;

2. lo si decomprime e si copiano i file .bbx e .cbx contenuti al suo interno rispettivamente nelle cartelle tex/latex/bibtex/bbx e tex/latex/bibtex/cbx dell’albero personale.

Installare uno stile non compreso in biblatex

Infine, si carica biblatex dando il nuovo stile come opzione del pacchetto: \usepackage[h. . .i,style=hstile bibliograficoi]{biblatex}

dove hstile bibliograficoi è il nome dello stile prescelto. La bibliografia di questa guida è composta con lo stile philosophy-modern [Valbusa, 2010], ancora in fase di sviluppo ma già pienamente operativo e incluso in TEX Live 2010 e in MiKTEX 2.9.

Lo stile si carica come al solito: \usepackage[h. . .i,style=philosophy-modern]{biblatex}

È una variante dello stile autore-anno, che incolonna le opere di uno stesso autore sotto il suo nome scritto per esteso, con l’anno di pubblicazione accanto a ciascuna. Ne risulta una bibliografia particolarmente ordinata e di facile consultazione. In questo modo, fra l’altro, si può valutare a colpo d’occhio il “peso” di ciascun autore e si può trovare molto velocemente l’opera che si sta cercando. (Lo stile comprende anche alcune funzioni non standard che permettono di inserire nelle voci bibliografiche informazioni sulla traduzione italiana di testi stranieri o sulla loro ristampa.) Si rimanda il lettore alla documentazione del pacchetto, in italiano.

5 Se ne possono scaricare alcuni da + ctan.

philosophy-modern

170

la bibliografia

7.4

specialità

In questo paragrafo vengono presentati alcuni argomenti avanzati relativi a biblatex.

7.4.1 Campi speciali

I campi elencati in questo paragrafo non contengono dati stampabili, ma servono per scopi diversi e si possono applicare a tutti i record bibliografici. hyphenation Imposta la lingua della voce bibliografica. Il valore dev’essere il nome di una lingua nota a babel (si veda il paragrafo 7.4.4 nella pagina successiva per maggiori dettagli).

sortkey Imposta l’ordine alfabetico degli elementi della bibliografia: serve come chiave di ordinamento nei record privi dell’indicazione di autore o curatore. keywords Un elenco di parole chiave separate da virgole, che fanno da filtro sulle voci bibliografiche da stampare (per un esempio, si veda il paragrafo 7.4.5 a fronte).

7.4.2 Campi omissibili

label: il factotum

di biblatex

backref

Alcuni dei campi indicati come obbligatori nel paragrafo 7.3.3 a pagina 159 in realtà non lo sono sempre. Nella bibliografia del proprio lavoro ci possono essere un libro anonimo oppure la raccolta dei lavori di una conferenza senza un curatore. Di regola, questo non è un problema nella composizione della bibliografia, ma può esserlo nelle citazioni: uno schema di citazione autore-anno richiede sempre un campo author/editor e un campo year.

Se mancano i dati necessari per formare l’etichetta “regolare”, si può sostituire ogni dato mancante con il campo label, da usare nei modi propri di ogni schema di citazione. Negli schemi autore-anno sostituisce il campo author/editor oppure il campo year nelle opere che ne sono prive. Negli schemi numerici, invece, non viene usato, perché in questo caso il formato delle citazioni è indipendente dai dati della bibliografia. Lo stesso accade negli schemi autore-titolo, perché il solo titolo basta di solito per formare una citazione univoca (di regola, ogni opera ha un titolo).

7.4.3

Riferimenti finali e riferimenti cliccabili

L’opzione backref indica accanto a ciascuna voce bibliografica le pagine del documento in cui l’opera è citata: \usepackage[h. . .i,backref]{biblatex}

7.4 specialità

L’opzione hyperref (che richiede il pacchetto omonimo) rende cliccabili le citazioni e i riferimenti finali.

171

hyperref

\usepackage[h. . .i,hyperref]{biblatex} \usepackage[h. . .i]{hyperref}

7.4.4 Bibliografia multilingue

Con l’opzione babel=hyphen

\usepackage[h. . .i,babel=hyphen]{biblatex}

biblatex verifica per quale o per quali voci della bibliografia si è specificata una lingua diversa da quella corrente, e le sillaba con le regole della nuova lingua.

L’opzione babel=other \usepackage[h. . .i,babel=other]{biblatex}

include la voce in un ambiente otherlanguage, traducendo nella nuova lingua anche tutti i termini associati all’opera, come curatore, volume, eccetera.

Di seguito si mostra un record in cui si è specificata la lingua: @book{lamport:latex, author = {Lamport, Leslie}, title = {\LaTeX: a document preparation system}, publisher = {Addison-Wesley}, year = {1994}, location = {Reading (Massachusetts)}, hyphenation = {english} }

7.4.5 Suddividere la bibliografia

Talvolta è necessario suddividere la bibliografia in base a certi criteri. Per esempio, la si può ripartire in letteratura di base e di approfondimento, oppure elencare separatamente le risorse cartacee e quelle online, oppure ancora separare le opere citate esplicitamente nel documento da quelle che s’intendono semplicemente suggerire. Con biblatex, tutto questo si può fare facilmente.

Si supponga di avere una base di dati di riferimenti bibliografici Bibliografia.bib definita come a pagina 158. Si consideri il seguente codice: \documentclass{article} \usepackage[italian]{babel} \usepackage[babel]{csquotes} \usepackage[style=alphabetic]{biblatex} \usepackage{guit} \bibliography{Bibliografia} \DeclareBibliographyCategory{basi} \DeclareBibliographyCategory{approf}

Con biblatex si può suddividere la bibliografia in base a certi criteri.

172

la bibliografia

Il riferimento a [Mor07a] appare nella bibliografia essenziale.

Il riferimento a [Eco77] appare nelle letture di approfondimento. Si possono includere negli approfondimenti anche delle opere non esplicitamente citate nel documento.

Riferimenti bibliografici Bibliografia essenziale [Mor07a]

Lapo Filippo Mori. “Scrivere la tesi di laurea con LATEX 2ε ”. In: ArsTEXnica 3 (2007).

Letture d’approfondimento [Eco77]

Umberto Eco. Come si fa una tesi di laurea. Milano: Bompiani, 1977.

[Mor07b] Lapo Filippo Mori. Scrivere poesie con LATEX. 2007. url: http://www.guit.sssup.it/.

Figura 14: Bibliografia suddivisa per argomenti.

7.4 specialità

173

\addtocategory{basi}{mori:tesi} \addtocategory{approf}{eco:tesi,mori:poesie} \defbibheading{basi}{\subsection*{Bibliografia essenziale}} \defbibheading{approf}{\subsection*{Letture d’approfondimento}} \begin{document} Il riferimento a~\cite{mori:tesi} appare nella bibliografia essenziale.

Il riferimento a~\cite{eco:tesi} appare nelle letture di approfondimento. Si possono includere negli approfondimenti anche delle opere non esplicitamente citate nel documento. \nocite{mori:poesie} \section*{\refname} \printbibliography[heading=basi,category=basi] \printbibliography[heading=approf,category=approf] \end{document}

Si tratta di un articolo con due bibliografie separate, una per la letteratura di base e l’altra per gli approfondimenti. Si osservi ora quanto segue.

• Nel preambolo sono definite due categorie bibliografiche (con il comando \DeclareBibliographyCategory ), una per la letteratura di base, l’altra per gli approfondimenti. Le singole voci vengono assegnate alle rispettive categorie dando \addtocategory .

Categorie

• Il comando \defbibheading definisce il titolo delle due bibliografie (Bibliografia essenziale e Letture d’approfondimento), che vengono composte esattamente come due sottoparagrafi (è la prassi, in un articolo). (Se si scrive un libro o una relazione con una bibliografia suddivisa, nel codice precedente bisogna sostituire i comandi \subsection* con \section* e l’istruzione \section*{\refname} con \chapter*{\bibname}.)

• L’argomento facoltativo di \printbibliography specifica le istruzioni di controllo. L’opzione heading=hnomei imposta il titolo della bibliografia come specificato con \defbibheading . L’opzione category=hcategoriai filtra le voci da stampare, selezionando soltanto quelle che appartengono alla hcategoriai specificata.

Al posto dei due \printbibliography con i relativi argomenti facoltativi, si può scrivere un semplice \bibbycategory

che equivale a dare un \printbibliography per ogni categoria nell’ordine in cui le si è dichiarate. Compilando il codice precedente si ottiene il risultato della figura 14 a fronte.

Si consideri un altro esempio. Si supponga ancora di avere una base di dati di riferimenti bibliografici Bibliografia.bib definita come a pagina 158. Si consideri il seguente codice:

Filtri

174

la bibliografia

I riferimenti a [Eco77] e a [Mor07] appaiono nell’elenco dei manuali cartacei.

Il riferimento a [Wiki10] appare nell’elenco dei siti Web consultati.

Riferimenti bibliografici Manuali cartacei [Eco77]

Umberto Eco. Come si fa una tesi di laurea. Milano: Bompiani, 1977.

[Mor07]

Lapo Filippo Mori. “Scrivere la tesi di laurea con LATEX 2ε ”. In: ArsTEXnica 3 (2007).

Siti Web consultati [Wiki10] LATEX su Wikipedia. 2010. url: http://it.wikipedia. org/wiki/LaTeX.

Figura 15: Bibliografia suddivisa per tipo di fonte.

7.4 specialità

175

\documentclass{article} \usepackage[italian]{babel} \usepackage[babel]{csquotes} \usepackage[style=alphabetic]{biblatex} \usepackage{guit} \bibliography{Bibliografia} \defbibheading{cartaceo}{\subsection*{Manuali cartacei}} \defbibheading{web}{\subsection*{Siti Web consultati}} \begin{document} I riferimenti a~\cite{eco:tesi} e a~\cite{mori:tesi} appaiono nell’elenco dei manuali cartacei.

Il riferimento a~\cite{wiki:latex} appare nell’elenco dei siti Web consultati. \section*{\refname} \printbibliography[heading=cartaceo,nottype=online] \printbibliography[heading=web,type=online] \end{document}

Si tratta di un articolo con due bibliografie separate, una per i manuali cartacei e l’altra per i siti Web consultati (una “sitografia”): • il comando \defbibheading definisce il titolo delle due bibliografie (Manuali cartacei e Siti Web consultati); • l’argomento facoltativo di \printbibliography filtra le voci come prima, per cui l’opzione type=htipoi stampa soltanto quelle il cui campo type è htipoi, mentre l’opzione nottype=htipoi stampa soltanto i record il cui campo type non è htipoi.

Compilando il codice precedente si ottiene il risultato della figura 15 nella pagina precedente.

Tipi

8

INDICE ANALITICO

L’indice analitico è un elenco alfabetico (anche con alcuni livelli di subordinazione) di parole o espressioni, dette voci, posto di regola alla fine di un documento; vicino a ogni voce compare l’elenco dei numeri delle pagine in cui la voce in questione è menzionata.

In molti lavori un indice di questo tipo costituisce una sezione di enorme utilità, e LATEX è capace di gestirlo automaticamente e con grande efficienza, come si mostra in questo capitolo.

8.1

creare l’indice analitico

Per creare l’indice analitico con LATEX bisogna innanzitutto eseguire due operazioni preliminari: 1. caricare il pacchetto makeidx come di consueto, per abilitare LATEX alla composizione dell’indice;

Abilitare la composizione dell’indice analitico

2. dare il comando \makeindex nel preambolo, per attivare i comandi dedicati che verranno inseriti nel corpo del testo.

A questo punto, subito dopo ogni parola o espressione che si desidera far comparire come voce nell’indice è sufficiente dare il comando \index{hvocei}

che stamperà il suo argomento nell’indice stesso. I seguenti comandi, dati di solito subito prima di \end{document}, aggiungono la sezione dell’indice analitico all’indice generale del documento e lo stampano:1 \addcontentsline{toc}{section}{\indexname} \printindex

per la classe article, e

\addcontentsline{toc}{chapter}{\indexname} \printindex

per le classi report o book. Il codice \documentclass{article} ... \usepackage{makeidx} \makeindex ... \begin{document}

1 Se hyperref è caricato, si ricordi di dare \phantomsection nei modi spiegati nel paragrafo 4.4.2 a pagina 55.

177

178

indice analitico

Tabella 47: Esempi di voci dell’indice analitico.

Esempio

Voce

Voce primaria

Arte, 2

\index{Arte} Voce secondaria sotto “Arte”

Escher, 3

\index{Arte!Escher} Voce con forma specificata

Gaudì, 5

\index{Gaudì@\textit{Gaudì}} Pagina con forma specificata

Klimt, 7

\index{Klimt|textbf} Rimando

\index{Liberty|see{Modernismo}}

Liberty, si veda Modernismo

Si possono inserire nell’indice analitico singole parole, come \emph{arte}\index{arte}, oppure intere espressioni come questa\index{intere espressioni come questa}. ... \addcontentsline{toc}{section}{\indexname} \printindex \end{document}

Sottolemmi

genera nell’indice analitico le voci arte e intere espressioni come questa.

Per generare i sottolemmi, si separa la voce principale da quella che comparirà come sottolemma con il carattere !: Qui parliamo dei sottolemmi% \index{indice!sottolemmi} dell’indice analitico.

Sostituzioni

Qui parliamo dei sottolemmi dell’indice analitico.

Infine, con il carattere @ si può sostituire una voce dell’indice analitico con dell’altro testo, simboli compresi, mantenendo inalterata la posizione alfabetica della voce di partenza: Mettiamo il simbolo $\alpha$% \index{alpha@$\alpha$} nell’indice analitico al posto di ‘‘alpha’’ nell’ordine alfabetico.

Mettiamo il simbolo α nell’indice analitico al posto di “alpha” nell’ordine alfabetico.

A volte possono essere utili le graffe di raggruppamento: Si può inserire una voce in corsivo\index{corsivo@% \textit{corsivo}}.

Generare l’indice analitico

Si può inserire una voce in corsivo.

La tabella 47 esemplifica la sintassi del comando \index .

Per generare l’indice analitico, questa è la sequenza di compilazione da seguire: 1. si compila con LATEX una prima volta;

8.2 personalizzare l’indice analitico

2. si compila con il programma MakeIndex cliccando l’apposito pulsante dell’editor o, dalla riga di comando, portandosi nella cartella di lavoro ed eseguendo makeindex hnome del documentoi, senza l’estensione .tex;

179

3. si compila altre due volte con LATEX. Durante la correzione delle bozze e il controllo dell’indice analitico, può essere utile il pacchetto showidx, che visualizza le voci dell’indice nel margine sinistro della pagina.

8.2

Controllare l’indice analitico

personalizzare l’indice analitico

Il risultato che si ottiene con le impostazioni predefinite non è molto elegante. Si può ricorrere allora a un apposito file, che chiameremo classic.ist, contenente le istruzioni per personalizzare l’indice analitico, così definito: headings_flag 1 heading_prefix heading_suffix symhead_positive symhead_negative numhead_positive numhead_negative

"\\goodbreak\\textsc{" "}\\par\\nobreak\\vskip\\smallskipamount\\nobreak" "Simboli" "simboli" "Numeri" "numeri"

Dopo aver messo classic.ist nella cartella opportuna — la sua posizione, di regola, dipende dalla distribuzione di LATEX installata, ma in genere basta metterlo nella cartella makeindex dell’albero personale (si veda il paragrafo 3.4.3 a pagina 34), eventualmente creando le necessarie cartelle, se non ci fossero già — le istruzioni per compilare l’indice analitico sono le seguenti:

Istruzioni per generare un indice analitico personalizzato

1. si compila con LATEX una prima volta; 2. si elabora l’indice analitico dalla riga di comando, portandosi nella cartella di lavoro ed eseguendo makeindex -s classic hnome del documentoi, senza l’estensione .tex; 3. si compila altre due volte con LATEX. Per bilanciare le colonne dell’ultima pagina dell’indice analitico basta inserirlo all’interno di un ambiente multicols (che richiede il pacchetto multicol) e ridefinire l’ambiente theindex scrivendo nel preambolo il seguente codice: \let\orgtheindex\theindex \let\orgendtheindex\endtheindex \def\theindex{% \def\twocolumn{\begin{multicols}{2}}% \def\onecolumn{}% \clearpage \orgtheindex } \def\endtheindex{%

Bilanciare le colonne

indice analitico

180

\end{multicols}% \orgendtheindex

}

9 indice 9.1

9.2 9.3 9.4 9.5

P E R S O N A L I Z Z A R E LATEX Comandi, ambienti e pacchetti nuovi 181 9.1.1 Nuovi comandi 181 9.1.2 Spazi dopo i comandi 183 9.1.3 Nuovi ambienti 183 9.1.4 Pacchetti e classi personalizzate 184 Sfondi colorati per le immagini 185 Testatine personalizzate 185 Modificare le voci generate da babel 186 Font 187 9.5.1 Che cos’è un font?

187 9.5.2 Larghezza: fissa o variabile?

187 9.5.3 Abbellimenti: con grazie o senza?

189 9.5.4 Modificare stile e corpo del font in uso 189 9.5.5 Scegliere i font 191

Chiunque scriva con LATEX ha bisogno, prima o poi, di estensioni personali, e perciò si crea comandi e ambienti ad hoc o modifica quelli che già ci sono. In questo capitolo si impara come farlo.

9.1

comandi, ambienti e pacchetti nuovi

9.1.1 Nuovi comandi

Immaginate di scrivere un libro di botanica e di volere tutti i nomi scientifici di pianta in corsivo, come si fa di solito. Il modo più immediato per ottenerlo è scrivere ogni nome nell’argomento di \textit .

Successivamente, per scelte tipografiche imperscrutabili, l’editore vi chiede i nomi di pianta in neretto. Che fare? Si potrebbero sostituire automaticamente tutti i \textit con altrettanti \textbf , ma ci sarebbe qualche problema, perché potreste aver usato il corsivo anche per altre parti del libro, che debbono rimanere tali. Non rimane che sostituire un comando dopo l’altro e perdere un sacco di tempo.

LATEX risolve questi problemi molto più “filosoficamente” di quanto non facciano altri programmi. Anziché agire a mano, si può definire una volta per tutte un nuovo comando, che chiameremo \pianta , che stampa il proprio argomento (un nome di pianta, in questo caso) nello stile che l’autore decide (in corsivo, in questo caso). Se la scelta del neretto viene imposta in un secondo momento, allora si modifica il comando una sola volta e non più tutte le volte che compare nel documento.

Il nuovo comando, dunque, non descrive come l’argomento debba essere stampato, ma come lo si è pensato. Perciò in un documento scritto

Storia di un povero autore

181

182

\newcommand

personalizzare latex

con LATEX i comandi per cambiare lo stile vanno usati molto di rado, in favore di comandi che rispecchino la logica di ciò che si sta scrivendo.

I comandi personalizzati si definiscono nel preambolo con il comando \newcommand : \newcommand{hnomei}[hnumero di argomentii]{hdefinizionei}

Dove: • hnomei è il nome che si dà al nuovo comando.

• hnumero di argomentii è il numero di argomenti che si assegna al nuovo comando, fino a un massimo di nove. Se non si specifica questo valore, allora il nuovo comando non ha alcun argomento.

• hdefinizionei contiene le istruzioni che specificano ciò che si vuole che il nuovo comando “faccia”. Se gli si sono assegnati degli argomenti, nella hdefinizionei questi vengono indicati con # e il loro numero progressivo: #1, #2, eccetera.

Nuovi comandi senza argomenti

Il comando appena esaminato serve a definire nuovi comandi senza e con argomenti. L’esempio seguente mostra la sintassi di un comando personalizzato senza argomenti: \newcommand{\arte}{\emph{L’arte di scrivere con \LaTeX}}

utile, per esempio, se in un documento si dovesse scrivere ripetutamente il titolo di questa guida (si noti che un comando di questo tipo “produce testo”, e va perciò spaziato dal testo che lo segue nei modi già visti nel paragrafo 3.2.4 a pagina 25): Questo lavoro è intitolato \arte.

Nuovi comandi con argomenti

Questo lavoro è intitolato L’arte di scrivere con LATEX.

Il prossimo codice, invece, mostra la sintassi di un comando personalizzato con argomenti. \newcommand{\pianta}[1]{\textit{#1}}

Si è assegnato al nuovo comando un solo argomento obbligatorio ([1]).

Quando si dà il comando, accade questo: il testo nell’argomento di \pianta viene “passato” a #1 e trattato secondo la hdefinizionei. In questo caso verrà stampato in corsivo, come si vede nell’esempio seguente: \pianta{rosa canina}

\renewcommand

rosa canina

In modo analogo, anche se accade davvero di rado, si possono definire nuovi comandi con più argomenti (specificando [2], [3], eccetera).

LATEX impedisce di definire un comando già esistente, ma non di ridefinirlo: per farlo, si usa \renewcommand , che ha la stessa sintassi di \newcommand .

A chi volesse approfondire gli aspetti della programmazione avanzata di LATEX si consiglia la lettura di [Gregorio, 2009].

9.1 comandi, ambienti e pacchetti nuovi

9.1.2 Spazi dopo i comandi

Un’alternativa ai due modi già esaminati per inserire uno spazio dopo un comando che produce testo ({} e \ , si veda il paragrafo 3.2.4 a pagina 25) è offerta dal pacchetto xspace. Un comando definito in questo modo

183 xspace

\newcommand{\mcescher}{Maurits Cornelis Escher\xspace}

ordina a LATEX di determinare automaticamente se lasciare o meno uno spazio dopo il testo che produce: \mcescher è stato un incisore e grafico olandese. \\ \mcescher, artista olandese, è molto apprezzato da logici, matematici e scienziati.

Maurits Cornelis Escher è stato un incisore e grafico olandese.

Maurits Cornelis Escher, artista olandese, è molto apprezzato da logici, matematici e scienziati.

Si faccia attenzione, però, a non esagerare con i comandi personalizzati soltanto per abbreviare il testo (come \gb per Gran Bretagna, per esempio): questa pratica rende il codice illeggibile, soprattutto a distanza di tempo e se ci lavorano più persone. Inoltre, mentre le spaziature manuali sono sempre sicure, xspace potrebbe produrre risultati indesiderati con qualche carattere particolare, anche se le ultime versioni del pacchetto sono abbastanza robuste. (Dalla lettura della documentazione si capisce che non è del tutto prevedibile quando qualcosa può andare storto.)

9.1.3 Nuovi ambienti

Gli ambienti personalizzati si definiscono nel preambolo con il comando \newenvironment : \newenvironment{hnomei}[hnumero di argomentii]% {hcomandi di aperturai}{hcomandi di chiusurai}

Dove: • hnomei è il nome che si dà al nuovo ambiente.

• hnumero di argomentii è il numero di argomenti che gli si assegna.

Se non si specifica questo valore, allora il nuovo ambiente non ha alcun argomento.

• hcomandi di aperturai contiene le istruzioni da dare all’inizio dell’ambiente, che fanno uso degli argomenti eventualmente presenti.

• hcomandi di chiusurai contiene le istruzioni da dare alla chiusura dell’ambiente.

In pratica, definire un nuovo ambiente equivale a definire due nuovi comandi, uno per la sua apertura e uno per la sua chiusura, da usare nel modo consueto.

L’esempio seguente mostra la sintassi di un ambiente personalizzato senza argomenti. Scrivendo nel preambolo

Il troppo “stroppia”

\newenvironment

184

personalizzare latex \newenvironment{itaitemize}{\begin{itemize}\itshape}{\end{itemize}}

potremo usare il nuovo ambiente itaitemize così: \begin{itaitemize} \item Un elenco con voci\dots \item \dots automaticamente in corsivo. \end{itaitemize}

\renewenvironment

• Un elenco con voci. . .

• . . . automaticamente in corsivo.

Si noti che gli eventuali argomenti assegnati al nuovo ambiente possono essere assegnati soltanto ai hcomandi di aperturai.

Per ridefinire ambienti già esistenti, si usa \renewenvironment (analogo a \renewcommand ), che ha la stessa sintassi di \newenvironment .

9.1.4 Pacchetti e classi personalizzate

Si può alleggerire un preambolo con troppe nuove definizioni riunendole una volta per tutte in un pacchetto costruito ad hoc, da caricare nel modo consueto. In sostanza, un pacchetto è un file che va registrato con estensione .sty e nel quale si scrive la parte del preambolo contenente i comandi e gli ambienti personalizzati.

L’esempio seguente mostra come si scrive un pacchetto: % Esempio di pacchetto personalizzato \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{esempio}[2010/06/02 v0.1 elenchi e titoli corsivi] \newcommand{\arte}{\emph{L’arte di scrivere con \LaTeX}} \newcommand{\pianta}[1]{\textit{#1}} \newenvironment{itaitemize}{\begin{itemize}\itshape}{\end{itemize}}

La porzione rilevante del codice è costituita dalle righe \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{hnome del pacchettoi}[hdata della versione (aaaa/mm/gg)i hnumero della versionei hbreve testo esplicativoi]

che devono essere le prime due righe del file e che comunicano a LATEX il nome del pacchetto, permettendogli di riconoscerlo una volta caricato e restituire i messaggi d’errore appropriati. Si noti che nell’argomento facoltativo di \ProvidesPackage (e di \ProvidesClass , descritto qui sotto), se specificato, va indicata almeno la data della versione (si possono omettere le altre due informazioni).

Nello stesso modo si possono scrivere anche intere classi di documento personalizzate. In questo caso, il file va registrato con estensione .cls, e deve cominciare con \NeedsTeXFormat{LaTeX2e} \ProvidesClass{hnome della classei}[hdata della versione (aaaa/mm/gg)i hnumero della versionei hbreve testo esplicativoi]

Per ulteriori approfondimenti, si rimanda il lettore alle indicazioni ufficiali per scrivere pacchetti e classi di documento contenute nella guida clsguide.pdf, presente in ogni distribuzione di LATEX e recuperabile nei modi propri di ogni sistema operativo.

9.2 sfondi colorati per le immagini

i

o Util

pp

i

zz a

o Util

t tori I

t tori I

pp

zz a

(a) Immagine senza sfondo.

guIt

ni di

ni di

TE X ! Gru

al ia

al ia

guIt

185

TE X ! Gru

(b) Immagine con sfondo.

Figura 16: Immagini con sfondo colorato.

9.2

sfondi colorati per le immagini

Si può sovrapporre un’immagine con lo sfondo trasparente a uno sfondo colorato (come si è fatto assegnando al logo del guIt il colore “Azzurro Alice” nella figura 16b) caricando i pacchetti xcolor e graphicx e definendo nel preambolo il comando ad hoc \definecolor{AzzurroAlice}{RGB}{240,248,255} \newcommand{\myincludegraphics}[2][]{% \begingroup\setlength{\fboxsep}{0pt}% \colorbox{AzzurroAlice}{\includegraphics[#1]{#2}}% \endgroup}

da usare nel modo seguente: \myincludegraphics[h. . .i]{himmaginei}

9.3

testatine personalizzate

Il pacchetto fancyhdr permette di personalizzare testatine e piè di pagina nelle classi di documento standard.

L’operazione richiede un codice piuttosto laborioso: per regolare le testatine, per esempio, bisogna ridefinire alcuni comandi, come si può osservare nell’esempio seguente che permette di ottenere le testatine illustrate nella figura 17 nella pagina seguente: \documentclass{book} \usepackage{fancyhdr} \pagestyle{fancy} \renewcommand{\chaptermark}[1]{\markboth{#1}{}} \renewcommand{\sectionmark}[1]{\markright{\thesection\ #1}} \fancyhf{} \fancyhead[LE,RO]{\bfseries\thepage} \fancyhead[RE]{\bfseries\footnotesize\nouppercase{\leftmark}} \fancyhead[LO]{\bfseries\footnotesize\nouppercase{\rightmark}}

fancyhdr

186

personalizzare latex 76

Le origini della teoria delle distribuzioni

77

3.3 La “Delta di Dirac”

! la trasformata di Laplace L[pH(t)] = 0 pH(t)e−st dt della funzione impulsiva unitaria, Van der Pol procede ! +∞ nel modo seguente. Innanzitutto determina L[fn (t)] = 0 fn (t)e−st dt, dove fn (t) è definita dalla relazione (3.4); ottenuto L[fn (t)] = 1−e−s/n dimostra che limn→+∞ L[fn (t)] = 1 e conclude: s/n +∞

" # L[pH(t)] = L lim fn (t) = lim L[fn (t)] = 1. n→+∞

Figura 3.2: Alcuni dei matematici impegnati nell’opera di rendere rigoroso il calcolo di Heaviside bandirono le “funzioni impulsive” trovandole «illegittime», mentre altri, fra cui Van der Pol, non si preoccuparono della debolezza dei loro fondamenti e le usarono senza particolari commenti.

Alcuni dei matematici impegnati nell’opera di rendere rigoroso il calcolo di Heaviside bandirono tali funzioni trovandole «illegittime» [Doetsch, 1937, p. 57], mentre altri (fra i quali Van der Pol e Niessen) non si preoccuparono della debolezza dei loro fondamenti e le usarono senza curarsi del rigore. Van der Pol [1929] descrive la “funzione impulsiva unitaria” come segue: ! " +∞ 0, se t != 0, pH(t) = pH(t) dt = 1.

(3.6) +∞, se t = 0, −∞ Afferma che tale oggetto può essere definito in modo equivalente come limite di una successione di gaussiane: n 2 2 pH(t) = √ e−n t , (3.7) π dove n è “un numero naturale molto grande”. Egli inoltre dà la formula " +∞ # $% f (t) pH(t) dt = −f % (0), (3.8) −∞

che dimostra attraverso un’integrazione per parti. Van der Pol illustra i suoi argomenti con la figura 3.2. Per calcolare

n→+∞

(3.9)

La debolezza dell’impostazione di Van der Pol e Heaviside è dovuta essenzialmente ad una confusione circa le operazioni con i limiti doppi. Va però riconosciuto che la spregiudicatezza del loro modo di procedere coglie, in un certo senso, nel segno: bisogna sottolineare che tutti i risultati precedenti possono essere resi rigorosi nella teoria delle distribuzioni.

3.3

La “Delta di Dirac”

Il significatofisico delle funzioni “impulsive” o “improprie” è quello di fornire una rappresentazione di cariche e masse puntiformi. È degno di nota come fisici e matematici siano stati in grado di aggirare abilmente i problemi connessi con questi oggetti, in ambiti dove a noi, oggi, sembrano giocare un ruolo fondamentale.

Nel trattamento delle forze elettriche o gravitazionali, per esempio, la procedura tradizionale consisteva nel trattare per prime le cariche (o le masse) puntiformi e successivamente nel considerare distribuzioni continue di carica (o di massa), mediante l’introduzione di una opportuna funzione densità. In questo modo, però, era impossibile rappresentare in modo rigoroso linee e superficie cariche, come anche le cariche (le masse) puntiformi da cui si era inizialmente partiti. Questa contraddizione logica era il prezzo pagato dai fisici per la mancanza di una teoria delle distribuzioni adeguatamente sistemata.

La situazione che precedette la scoperta della teoria delle distribuzioni sembra per certi aspetti paradossale. Né i fisici né

Figura 17: Esempio d’uso del pacchetto fancyhdr.

Le istruzioni precedenti stampano sulla testatina delle pagine pari (Even) il numero di pagina a sinistra e il titolo del capitolo corrente in minuscolo a destra (Right). In quella delle pagine dispari (Odd), il titolo del paragrafo corrente in minuscolo a sinistra (Left) e il numero di pagina a destra. La dettagliata documentazione del pacchetto mostra il codice per numerosi altri stili di pagina.

9.4

modificare le voci generate da babel

Per modificare le voci generate automaticamente da babel (sostituire Capitolo con Unità oppure Bibliografia con Letture suggerite, per esempio), si carica babel e si scrive nel preambolo il codice

\addto\captionshlinguai{htestoi}

che comanda a LATEX di aggiungere alle definizioni specifiche della hlinguai il htestoi.

Volendo sostituire la voce Capitolo con Unità basta scrivere \addto\captionsitalian{% \renewcommand{\chaptername}{Unità}}

mentre per sostituire Bibliografia con Letture suggerite si può scrivere \addto\captionsitalian{% \renewcommand{\bibname}{Letture suggerite}}

La tabella 48 nella pagina successiva elenca i comandi di queste voci con la relativa traduzione italiana.

Tabella 48: Voci italiane di babel.

Comando

Voce

\abstractname \alsoname \appendixname \bibname \ccname \chaptername \contentsname \enclname \figurename \glossaryname \headtoname

Sommario vedi anche Appendice Bibliografia e p. c.

Capitolo Indice Allegati Figura Glossario Per

9.5

9.5 font

Comando

Voce

\indexname \listfigurename \listtablename \pagename \partname \prefacename \proofname \refname \seename \tablename

Indice analitico Elenco delle figure Elenco delle tabelle Pag. Parte Prefazione Dimostrazione Riferimenti bibliografici vedi Tabella

187

font

“LATEX e i font” è un argomento che da sempre appassiona gli autori. In questo paragrafo, prima daremo una breve descrizione dei font dal punto di vista tipografico, poi mostreremo come modificare stile e corpo dei font in uso e come scegliere e usare font diversi da quelli predefiniti.

9.5.1 Che cos’è un font?

In tipografia la parola font indica un insieme di caratteri accomunati da un certo stile grafico. Questi caratteri, detti anche glifi, sono di solito lettere, numeri e segni di punteggiatura, ma possono essere anche simboli matematici, note musicali, icone, disegni e altro ancora.

Font

Una famiglia di font è un insieme di font la cui rappresentazione grafica si mantiene fedele a caratteristiche comuni. Essa contiene il font con rappresentazione grafica standard e alcune sue varianti (come corsivo e maiuscoletto). Times, Helvetica, Courier e Monaco sono alcune famiglie di font usate comunemente.

Famiglie di font

9.5.2 Larghezza: fissa o variabile?

Si possono classificare i font secondo numerosi parametri. Uno di questi è la larghezza del carattere, che può essere fissa o variabile.

I font a larghezza fissa (detti anche monospaced o typewriter) presentano caratteri tutti della stessa larghezza, che si mantiene in ogni punto del testo: il risultato è simile a quello che si ottiene con una macchina per scrivere. Questa caratteristica potrebbe andar bene per scrivere in un editor di testo o per stampare molti dati incolonnati, ma per lunghe parti di testo puro vanno preferite senz’altro famiglie di font a larghezza variabile, in cui ogni carattere ha una larghezza propria per riempire la riga in modo ottimale.

Courier e Monaco sono font a larghezza fissa; Times ed Helvetica a larghezza variabile (si vedano le figure 18 e 19 nella pagina seguente).

Larghezza fissa e variabile

188

personalizzare latex

(a) Con grazie: Times.

(b) Senza grazie: Helvetica.

Figura 18: Famiglie di font a larghezza variabile.

(a) Con grazie: Courier.

(b) Senza grazie: Monaco.

Figura 19: Famiglie di font a larghezza fissa.

9.5 font

Tabella 49: Comandi e dichiarazioni per modificare lo stile del font.

Comando

Dichiarazione

Stile

\textit \textsc \textbf \textsl \textrm \textsf \texttt

\itshape \scshape \bfseries \slshape \rmfamily \sffamily \ttfamily

Corsivo Maiuscoletto Neretto Inclinato Tondo Senza grazie

189

Macchina per scrivere

9.5.3 Abbellimenti: con grazie o senza?

Si possono classificare i font anche in base alla presenza o meno delle cosiddette “grazie”, cioè le piccole rifiniture alle estremità dei caratteri.

Rispetto ai font senza grazie (detti anche sans serif ), quelli con grazie (detti anche serif ) vengono generalmente considerati più leggibili specie nei lunghi passaggi (le grazie creano l’effetto ottico di una linea continua che guida l’occhio nella lettura della riga), e sono quindi più comunemente utilizzati nelle parti testuali di molto materiale destinato alla lettura (come libri, quotidiani e riviste).

Viceversa, alcune famiglie di font sans serif rendono meglio di un font serif nella composizione di pagine Web, cataloghi e brochure commerciali. L’assenza delle grazie, infine, conferisce maggiore chiarezza a caratteri molto piccoli da visualizzare a video.

Times e Courier sono font con grazie; Helvetica e Monaco senza grazie (si vedano le figure 18 e 19 nella pagina precedente).

Grazie

La suddivisione dei font in serif (sopra) e sans serif (sotto) vale anche per i caratteri cinesi.

9.5.4 Modificare stile e corpo del font in uso

Di regola, LATEX sceglie il font appropriato in base alla struttura logica del documento (capitoli, paragrafi, testatine, eccetera). Talvolta, però, si ha la necessità di modificarne a mano stile e corpo.

Modificare lo stile I comandi elencati nella tabella 49 modificano lo stile del loro argomento (e solo di quello), lasciando invariato il testo seguente.

La parola che segue è in \textit{corsivo}.

Il resto del testo è normale.

La parola che segue è in corsivo. Il resto del testo è normale.

I comandi si possono combinare, ma non tutte le combinazioni sono possibili, come mostrano gli esempi seguenti: L’espressione che segue \textit{è in \textbf{neretto corsivo}}, ma questa \textsc{non è in \textit{maiuscoletto corsivo}}.

L’espressione che segue è in neretto corsivo, ma questa non è in maiuscoletto corsivo.

Comandi per modificare lo stile del font. . .

190

personalizzare latex

Tabella 50: Dichiarazioni per modificare il corpo del font.

Dichiarazione \tiny \scriptsize \footnotesize \small \normalsize \large \Large \LARGE \huge \Huge

. . . e relative dichiarazioni

Corpo Il più piccolo

Font molto piccolo

Font abbastanza piccolo

Font piccolo

Font normale

Font grande

Font più grande

Font molto più grande

Font enorme

Il più grande

A ciascuno di questi comandi corrisponde una dichiarazione che ha effetto su tutto il testo che la segue, a meno di racchiuderla in un gruppo di parentesi graffe.

Vorrei che soltanto la prossima parola fosse in \itshape corsivo, ma forse ho sbagliato qualcosa.

Vorrei che soltanto la prossima parola fosse in corsivo, ma forse ho sbagliato qualcosa.

Ecco, forse {\itshape adesso} ho capito come fare.

Ecco, forse adesso ho capito come fare.

Come i comandi, si possono combinare anche le dichiarazioni: L’espressione che segue {\itshape è in {\bfseries neretto corsivo}}.

L’espressione che segue è in neretto corsivo.

Modificare il corpo Il corpo effettivo del font in un documento dipende da tre fattori: la classe di documento con cui si sta scrivendo; l’opzione (eventualmente) assegnata alla classe; le (eventuali) dichiarazioni per modificare il corpo del font date nel testo. Le dichiarazioni elencate nella tabella 50 modificano il corpo del font. Naturalmente, anche il testo esemplificato nella tabella risente dei fattori appena elencati: in particolare, si noti che il corpo di \normalsize è quello del testo principale di questa guida.

Lettere {\Large grandi e {\footnotesize piccole}}.

Lettere grandi

e piccole.

La tabella 51 a fronte riporta, per ogni dichiarazione, la grandezza effettiva del carattere a seconda delle tre opzioni possibili nelle classi standard. Si noti che in esse la grandezza “normale” del font (\normalsize )

9.5 font

Tabella 51: Corpo effettivo del font per ciascuna dichiarazione a seconda dell’opzione di classe nelle classi standard.

Dichiarazione

Corpo del font (pt) Opzione 10pt

Opzione 11pt

Opzione 12pt

5 7 8 9 10 12 14 17 20 25

6 8 9 10 11 12 14 17 20 25

6 8 10 11 12 14 17 20 25 25

\tiny \scriptsize \footnotesize \small \normalsize \large \Large \LARGE \huge \Huge

corrisponde all’opzione assegnata alla classe (in assenza di opzioni, il valore è pari a 10 punti).

Queste dichiarazioni modificano anche l’interlinea del capoverso interessato, a patto però che esso termini entro il loro raggio d’azione.

Nei due esempi seguenti, \par produce effetti differenti in base alla sua posizione nel testo. {\large Socrate: «Platone mentirà nella frase seguente».\par}

Socrate: «Platone mentirà nella frase seguente».

{\large Platone: «Socrate ha detto il vero nella frase precedente».}\par

Platone: «Socrate ha detto il vero nella frase precedente».

Come si può osservare nel secondo esempio, fuori dal gruppo \par non funziona più, con un risultato finale poco gradevole.

Il nostro viaggio tra stili e dimensioni si conclude con un consiglio, che sta all’utente seguire o meno:

! Quanti Pi

scegli di usare in un documento, tanto più leggibile e bello diventa.

Ricorda

9.5.5 Scegliere i font

ù corpi e stili

Qualche volta, per le esigenze più diverse, è necessario usare font diversi da quelli predefiniti: per uniformarsi allo stile di una casa editrice, per aumentare la leggibilità del proprio lavoro o ancora per rendere un testo più compatto.

Se il font scelto è compreso nella distribuzione, è facile: basta caricarlo nel preambolo come di consueto \usepackage{hfonti}

191

192

personalizzare latex

e sarà attivo per tutto il documento. Naturalmente, si possono installare e usare anche tutti gli altri font non presenti nel sistema, anche se è un’operazione piuttosto laboriosa [Zannarini e Vavassori, 2005]. Si ricordi che un font non va usato per evidenziare parti di testo (a questo scopo esistono i comandi per modificare lo stile visti nei paragrafi precedenti) né tanto meno per abbellirle. Difficile, invece, è scegliere famiglie di font che si accordino bene fra loro.

Di solito, in un documento si utilizzano quattro famiglie di font: • una famiglia con grazie per il testo principale; • una famiglia senza grazie per scopi particolari; • una famiglia a larghezza fissa per comporre codici e indirizzi Internet; • una famiglia per scrivere la matematica.

Scegliere queste famiglie (e quindi creare lo “stile” del documento) richiede conoscenze approfondite e un’ottima padronanza della tipografia per ottenere risultati adeguati.

Le famiglie Computer Modern

Computer Modern

In mancanza di istruzioni specifiche, LATEX impiega le quattro famiglie Computer Modern, create da Donald Knuth con il programma METAFONT (si veda la tabella 52 nella pagina successiva): computer modern roman è una famiglia di font con grazie dall’aspetto molto “moderno”, progettata per il testo del documento. computer modern sans serif è una famiglia di font senza grazie. computer modern typewriter è una famiglia di font a larghezza fissa. computer modern mathematics è una famiglia di font progettata per le formule matematiche.

Si faccia attenzione, però, a non considerare le varie possibilità come una “tavolozza” da cui attingere liberamente: gli stili da usare in un documento sono ben pochi, e decisamente sufficienti per la maggior parte delle esigenze di scrittura.

Palatino-Helvetica-Courier

Palatino-HelveticaCourier

Se si desidera usare il font Palatino per il testo con grazie, l’Helvetica per il testo senza grazie e il Courier per il testo a spaziatura fissa, è sufficiente scrivere nel preambolo: \usepackage{mathpazo} \usepackage[scaled=.95]{helvet} \usepackage{courier}

9.5 font

Tabella 52: Alcuni stili delle quattro famiglie Computer Modern.

Famiglia

Stile

CM Roman

Tondo Corsivo Inclinato Neretto Maiuscoletto

CM Sans Serif

Tondo Corsivo Inclinato Neretto

CM Typewriter

Tondo Corsivo Inclinato Maiuscoletto

CM Mathematics

abc (corsivo matematico) αβγ (greco corsivo)

Figura 20: Utopia.

193

Il pacchetto mathpazo (a differenza di palatino, che è obsoleto e non deve più essere usato) carica anche font matematici appositamente creati per essere compatibili con Palatino. Inoltre, il codice precedente scala i caratteri Helvetica perché non appaiano troppo grandi rispetto a quelli delle altre famiglie.

Si può ottenere un risultato analogo con il Palatino esteso del pacchetto pxfonts, molto fornito di simboli e caratteri particolari, ma con il difetto che i simboli matematici talvolta risultano insufficientemente spaziati.

1 Times-Helvetica-Courier

Se si desidera usare il font Times per il testo con grazie, l’Helvetica per il testo senza grazie e il Courier per il testo a spaziatura fissa, è sufficiente scrivere nel preambolo: \usepackage{mathptmx} \usepackage[scaled=.90]{helvet} \usepackage{courier}

Il pacchetto mathptmx (a differenza di times, che è obsoleto e non deve più essere usato) carica anche font per i simboli matematici appositamente creati per essere compatibili con Times. Ne risulta un pdf particolarmente “leggero” (con un numero minimo di font inclusi), anche se in presenza di formule matematiche appena più che elementari

Times-HelveticaCourier

194

Utopia

personalizzare latex

il risultato tipografico è molto discutibile. Il fattore di scala con cui qui è impostato il font Helvetica è diverso dal precedente perché il Times, a parità di corpo, appare più piccolo e stretto del Palatino. I caratteri apparentemente “troppo attaccati” sono una caratteristica peculiare del font Times, disegnato espressamente per stampare il famoso quotidiano di Londra: gli editori richiedevano un font insieme leggibile e compatto per risparmiare spazio sulle colonne del giornale.

Si può ottenere un risultato analogo con il Times esteso del pacchetto txfonts, che condivide pregi e difetti con il pacchetto esaminato nel paragrafo precedente.

Il pacchetto fourier

Il pacchetto fourier, che si carica come di consueto

\usepackage{fourier}

usa per il testo i font Utopia (si veda la figura 20 nella pagina precedente) e fornisce tutti i font complementari richiesti, incluso un insieme di caratteri matematici estesi e svariati altri simboli. Il font sans serif è il Computer Modern Sans Serif, mentre quello a spaziatura fissa è il Computer Modern Typewriter.

ArsClassica

I font di ArsClassica

Si descrive infine lo stile di ArsClassica, con cui è stata scritta questa guida. Lo stile impiega la famiglia di font Palatino per il testo, gli Iwona come font senza grazie (usati per comporre i titoli delle sezioni, le testatine, le etichette delle descrizioni e le intestazioni delle didascalie), i Bera Mono come font a spaziatura fissa e i font AMS Euler per la matematica [Pantieri, 2010]. palatino è una famiglia di font con grazie progettata per il testo del documento, basata sui tipi di carattere del Rinascimento italiano, che imitano la scrittura calligrafica. iwona è una famiglia di font senza grazie, caratterizzata dall’abbondante spaziatura fra una lettera e l’altra. bera mono è una famiglia di font a spaziatura fissa, particolarmente leggibile anche a video.

AMS euler è una famiglia di font progettata per le formule ma-

tematiche che imita la scrittura diritta di un matematico alla lavagna.

A indice a.1 a.2

NORME TIPOGRAFICHE I TA L I A N E

Accento e apostrofo 195 Punteggiatura e spaziatura 197 a.2.1 Segni di interpunzione 197 a.2.2 Virgolette 197 a.2.3 Parentesi 197 a.2.4 Puntini di sospensione 198 a.2.5 Trattino, tratto e lineetta 198 a.2.6 Barra e asterisco 199 Stile del font 199 a.3.1 Corsivo 199 a.3.2 Neretto 200 a.3.3 Maiuscoletto 200 Composizione del testo 200 a.4.1 Parole straniere 200 a.4.2 Numeri 201 a.4.3 Frazioni, percentuali, unità di misura a.4.4 Acronimi 202

a.3

a.4

202

Quest’appendice, basata su [Cevolani, 2006] e [Lesina, 2004], cui si rimanda il lettore per ogni approfondimento, descrive sinteticamente e senza pretese di completezza le tradizioni tipografiche più seguite nella redazione di un documento in italiano. Di ogni regola discussa si mostra, per quanto possibile, l’applicazione in LATEX. La parola norma va qui intesa in senso piuttosto lato: anche nella nostra lingua, come in tutte le altre, non esistono che pochissime regole tipografiche realmente universali e vincolanti, mentre molti aspetti del testo finito dipendono da tradizioni e abitudini o dal gusto dell’autore o dell’editore del testo.

Ciò premesso, si tenga presente che la scrittura in una qualunque lingua è governata nel mondo dalle norme emesse dall’iso e in Italia da quelle definite dall’uni, che (come scritto a pagina 83) hanno valore di legge. Per maggiori dettagli su queste norme, se ne veda la documentazione.

a.1

Esistono pochissime regole tipografiche realmente vincolanti.

Norme ISO-UNI

accento e apostrofo

Accento

Per una trattazione dell’accento in italiano si rimanda il lettore alla consultazione di una grammatica e di un dizionario, che rimangono i mezzi più rapidi e sicuri per verificare i casi di dubbio. Ci limiteremo qui ad alcune indicazioni di carattere operativo.

195

196

norme tipografiche

Esistono due tipi di accento:1 • grave, `, che indica suono aperto; • acuto, ´, che indica suono chiuso.

La loro applicazione non è univoca, e oscilla tra le prescrizioni uni (per cui l’accento grave può colpire tutte le vocali: à/À, è/È, ì/Ì, ò/Ò, ù/Ù; e l’accento acuto soltanto le vocali e e o: é/É, ó/Ó) e le tradizioni di alcune case editrici (per cui i e u portano sempre l’accento acuto, per esempio). Qualunque sistema si scelga, l’importante è seguirlo coerentemente in tutto il documento.

Come si può osservare, gli accenti vanno apposti sopra la vocale, minuscola o maiuscola che sia: i pacchetti fontenc e inputenc opportunamente impostati interpretano e stampano correttamente le lettere accentate direttamente dalla tastiera (si veda il paragrafo 4.1.2 a pagina 45). Si noti tuttavia che per ottenere alcuni caratteri assenti dalla tastiera italiana come la ó, è sempre necessario digitare il codice esplicito o le combinazioni di tasti dedicate. Al contrario di quanto accade con le vecchie macchine per scrivere o con altri elaboratori di testo, LATEX permette di accentare senza problemi anche le lettere maiuscole, che spesso vengono erroneamente apostrofate (come in E’ , che sta per “ei” cioè “egli”).

Apostrofo

“Scontri” indesiderati

L’apostrofo, ’, segnala normalmente la caduta della parte iniziale, come in ’sta (per questa), o finale di una parola, come in un’altra, un po’, da’ (imperativo), eccetera.

Quando cadono lettere o sillabe iniziali l’apostrofo è preceduto da uno spazio; quando cadono sillabe finali l’apostrofo è seguito da uno spazio o da un segno di interpunzione.

In una parola in cui cade una vocale finale di fronte a un’altra parola che inizia per vocale (come in un’altra o in quell’uomo), l’apostrofo sta al posto della vocale caduta e la parola seguente comincia senza nessuno spazio intermedio. In questo modo LATEX evita automaticamente l’apostrofo in fine di riga: quell’uomo viene sillabato “quel-l’uo-mo”, come fosse un’unica parola (si noti che occorre impostare babel con l’opzione italian).

A volte l’apostrofo si “scontra” con le virgolette, come in l’“unico”.

Per evitare i due segni troppo ravvicinati si possono usare le virgolette basse; se si sono scelte le virgolette alte, conviene riformulare l’espressione (per esempio, un “unico”) o, in alternativa, inserire uno spazio sottile \, fra apostrofo e virgolette: il codice l’\,‘‘unico’’ produce la forma, più leggibile, l’ “unico”.

1 Un terzo tipo di accento, il circonflesso, ˆ, usato in passato soprattutto per distinguere gli omografi uscenti in -ii al plurale — odî (plurale di odio) da odi (voce del verbo udire) — oggi non viene quasi più usato.

a.2 punteggiatura e spaziatura

a.2

punteggiatura e spaziatura

a.2.1

Segni di interpunzione

a.2.2

Virgolette

197

La punteggiatura italiana comprende segni di interpunzione, parentesi, virgolette, puntini di sospensione, trattini e altri simboli come l’asterisco e la barra. Ci sono alcune regole fisse sull’uso degli spazi prima e dopo i segni di interpunzione.

Tutti i segni di interpunzione seguono immediatamente la parola che li precede e vanno separati con uno spazio da quella che li segue.

Nel testo non si lasciano spazi bianchi tra le virgolette e il loro contenuto, mentre li si lascia tra le virgolette e il testo esterno.

Normalmente si contrassegnano tra virgolette: • citazioni dirette («Gli ho sentito dire: “Verrò di sicuro”») e “intercitazioni”, cioè citazioni dentro a citazioni;

Quando usare le virgolette

• termini ed espressioni che specificano il significato di altre parole: «La parola box significa “scatola”»; • espressioni figurate o gergali: «Si prevedono scioperi “a singhiozzo”»; • termini correnti a cui si attribuisce un significato diverso da quello abituale: «Questo ragazzo non è certo una “cima”»; • parole usate in senso ironico.

I casi sopra elencati non costituiscono regole realmente vincolanti: alcuni di essi, infatti, trovano un ottimo concorrente nel corsivo, con l’avvertenza di evitare sempre l’uso contemporaneo dei due metodi. Non esistono nemmeno regole fisse o comunemente accettate per l’uso dei vari tipi di virgolette (si veda il paragrafo 4.6.1 a pagina 60): nella pubblicazione dei testi a stampa, infatti, si adottano convenzioni tipografiche variabili dall’uno all’altro editore, e perfino tra l’una e l’altra collana sotto lo stesso marchio editoriale. L’unico consiglio che qui si può dare è di scegliere un sistema di virgolettatura prima di scrivere il documento, e di usarlo poi con coerenza al suo interno. a.2.3

Parentesi

In italiano si usano di solito le parentesi tonde ( ) e le parentesi quadre [ ]. Le parentesi graffe { } e angolate h i (i comandi per queste ultime sono $\langle$ e $\rangle$) vengono usate solo in discipline tecniche, tipicamente in matematica e in informatica.

Generalmente le parentesi racchiudono un inciso nel discorso (cioè una parte accessoria, come questa). Seguono alcune indicazioni generali sul loro impiego.

Parentesi tonde

198

norme tipografiche

• Nel testo non si lasciano spazi bianchi tra le parentesi e il loro contenuto, mentre lo si lascia tra le parentesi e il testo esterno (a meno che non siano a fine enunciato, come qui).

• Quando un segno d’interpunzione ricorre dentro le parentesi, l’enunciato finirà, come questo, con un punto fuori dalla parentesi stessa (ovviamente!). Si noti che solo i punti interrogativo ed esclamativo possono stare di norma dentro le parentesi.

• L’uso di racchiudere tra parentesi un intero enunciato è lecito ma poco diffuso in italiano, a differenza di altre lingue. (In tal caso, anche la punteggiatura rientra nelle parentesi, come qui.)

Parentesi quadre

Le parentesi quadre vengono usate quasi esclusivamente in due casi.

• Come parentesi interne a parentesi (come [anche se non è molto frequente] in questo caso).

• Per introdurre «il commento di una persona diversa dall’autore del testo cui il commento si riferisce [in questo modo]». In quest’ultimo caso rientra anche quello dell’omissione volontaria (che è comunque un commento), segnalata con [. . .] (si veda il paragrafo 4.6.1 a pagina 60).

...

Trattino

a.2.4

Puntini di sospensione

a.2.5

Trattino, tratto e lineetta

I puntini di sospensione sono sempre e solo tre e, come gli altri segni di interpunzione, seguono immediatamente la parola che li precede e sono separati con uno spazio da quella che li segue. . . in questo modo. In LATEX, il comando da usare è \dots (non vanno mai inseriti a mano tre punti separati), eventualmente inserendo uno spazio esplicito se i puntini non sono a fine enunciato (si veda il paragrafo 4.6.1 a pagina 60).

Se usati per indicare un’omissione in una citazione «è bene [. . .] inserirli entro parentesi quadre o tonde» come in questo caso.

Si è già spiegato (nel nel paragrafo 4.6.1 a pagina 60) come realizzare questi tre segni con LATEX. Di seguito se ne descrive l’uso in termini generali.

Il trattino di solito divide le parti di un termine composto e nella scrittura del testo si interpone tra due caratteri senza lasciare alcuno spazio bianco tra di essi. Si usa: • Per i termini composti da due singole parole, come «guerralampo».

• Per gli intervalli numerici o di tempo i cui estremi siano espressi in cifre, come «1915-1918» e «pagine 2-11». Se gli estremi sono costituiti da più di una parola, per ragioni di chiarezza è opportuno spaziare anche il trattino: «Trentino - Alto Adige».

a.3 stile del font

Il tratto, preceduto e separato da uno spazio bianco, di solito suddivide elementi come titoli, didascalie e diciture di vario tipo, come «Varianti di carattere – Il maiuscoletto».

La lineetta isola nettamente un inciso all’interno del testo o, usata in coppia, segnala le battute di dialogo nei testi narrativi. Nella scrittura del testo è separata dal testo precedente e seguente da uno spazio bianco — come in questo caso. a.2.6

Barra e asterisco

La barra (o sbarretta) può essere usata nelle seguenti circostanze ordinarie.

199

Tratto

Lineetta

Barra

• Senza spazi né prima né dopo, per un’alternativa tra due termini: «i passeggeri diretti a Torino/Milano».

• Per separare i versi di una poesia riportata in modo testuale (in questo caso è preceduta e seguita da uno spazio bianco): «M’illumino / d’immenso».

• Per scrivere una frazione numerica in modo testuale: «i 3/4 della popolazione».

Si noti che la barra (slash, /), inseribile direttamente da tastiera, non va confusa con il carattere di barra rovescia (\textbackslash , \), riservato ai comandi di LATEX. L’asterisco ha un uso limitato alle seguenti circostanze.

Asterisco

• Ripetuto tre volte indica omissione volontaria («Il padre Cristoforo da * * * era un uomo più vicino ai sessanta che ai cinquanta», codice: *\,*\,*).

• Per indicare in linguistica forme non attestate, scorrette o inaccettabili: «*che io vadi».

a.3

stile del font

a.3.1

Corsivo

I font più usati in italiano, oltre a quello normale del testo, comprendono lo stile corsivo, neretto e maiuscoletto. È poco utilizzato invece lo stile inclinato (slanted). Altri stili possono essere usati per esigenze particolari: per esempio, in questo documento si usa lo stile macchina per scrivere per evidenziare il codice di LATEX. Lo stile “evidenziato” (o “enfatizzato”) è reso normalmente col corsivo, ma riveste un ruolo logico differente, discusso nel paragrafo 4.10 a pagina 70.

Convenzionalmente si scrivono in corsivo le seguenti categorie di parole: • termini tecnici e specialistici: «Una distribuzione è una raccolta di programmi. . . »;

Quando usare il corsivo

200

norme tipografiche

• parole o frasi straniere di uso non comune con le quali si ritiene che il lettore non abbia affinità: «Questa tecnica di engraving può essere considerata. . . »; • parole e lettere a cui ci si riferisce come tali nel testo: «La lettera e non compare nella parola parola»; • parole o frasi da evidenziare: «Questo non si fa».

Oltre che nel testo principale, si può usare il corsivo per comporre i titoli.

Il neretto va usato con moderazione.

a.3.2

Neretto

a.3.3

Maiuscoletto

a.4

composizione del testo

Nelle classi standard di LATEX il neretto si usa per i titoli dei capitoli, dei paragrafi e delle altre suddivisioni del testo. Si tende di norma a non impiegarlo per evidenziare parole o addirittura interi capoversi nel testo principale (il corsivo va benissimo), e comunque a utilizzarlo con moderazione per non appesantire l’aspetto della pagina.

Il maiuscoletto viene usato in italiano quasi esclusivamente per i nomi degli autori citati in bibliografia, come in Bringhurst (1992).

Questa convenzione, tuttavia, dipende dallo stile bibliografico scelto.

Oppure concorre con il maiuscolo per segnalare gli acronimi nel testo.

Le parole straniere di uso non corrente per il lettore vanno in corsivo.

Sillabare le parole straniere

a.4.1

Parole straniere

Le parole straniere vanno in corsivo, a meno che non vengano esplicitamente “quoted” (“virgolettate”, come in questo caso) o non siano entrate nell’uso comune. Quindi si scriverà: «ho visto un bel film» (comune) ma «ho mangiato un pudding» (non comune). In realtà, dato che è molto difficile stabilire che cosa sia entrato o meno nell’uso “comune”, la regola più corretta è quella di scrivere in corsivo le parole straniere che si presumono di uso non corrente per il lettore a cui ci si rivolge. In un libro di informatica software e computer potranno essere scritte in tondo.

I nomi propri e le denominazioni ufficiali (come Stanford University e Magna Charta) non sono considerati parole straniere e vanno in tondo.

La traduzione straniera di un’espressione italiana usata nel testo può essere semplicemente messa in corsivo e fra parentesi (bracket), come in questo caso. Se invece l’espressione tradotta ricorre in una citazione e se ne vuole indicare la forma originale, occorre inserirla fra parentesi quadre come ogni altro commento. Per esempio: «La visione del mondo [Weltanschauung]. . . ».

Ovviamente ogni lingua straniera va sillabata a sé, ed è altrettanto ovvio che scrivendo in lingue diverse dall’italiano alcune cesure nel documento finito potrebbero risultare errate. Si noti che si possono

a.4 composizione del testo

sillabare secondo le nostre regole parole straniere isolate nel discorso, ma non un testo in lingua più esteso (si veda il paragrafo 4.1.3 a pagina 46). a.4.2

201

Numeri

Scrivere i numeri I caratteri numerici possono essere maiuscoli e minuscoli. Si osservi la resa tipografica del numero 1821 nei due esempi seguenti: Il numero $1821$ non è primo. \\ Napoleone morì nel 1821.

Il numero 1821 non è primo.

Napoleone morì nel 1821.

Nel primo, 1821 è maiuscolo; nel secondo, 1821 è minuscolo.

I numeri maiuscoli presentano tutti la stessa altezza e sono indicati:

Anche i numeri possono essere maiuscoli e minuscoli.

Numeri maiuscoli

• per scrivere le formule matematiche; • nelle tabelle composte di dati numerici; • quando li si intende in senso aritmetico (nell’indicazione di quantità esatte, per esempio).

Mentre i primi due punti si risolvono con gli strumenti già esaminati nei capitoli precedenti, per l’ultimo c’è più di una possibilità: o si scrivono i numeri tra i comandi per le formule matematiche “in linea” (tra dollari, per esempio $hnumeroi$) o li si scrive nell’argomento del comando \num del pacchetto siunitx.

I numeri minuscoli presentano tratti ascendenti e discendenti per integrarsi al meglio con i caratteri minuscoli del font corrente, e sono indicati in tutti gli altri casi. Di solito, per ottenere i numeri minuscoli non c’è bisogno di fare nulla, perché spesso il font scelto li usa per impostazione predefinita. Si consiglia in ogni caso di fare una semplice prova per verificare la cosa: se i numeri predefiniti sono maiuscoli e si vogliono invece quelli minuscoli, la documentazione del font caricato dovrebbe indicare come risolvere il problema.

Si noti, infine, che anche se alcuni font (come i Computer Modern predefiniti da LATEX) non distinguono tra numeri maiuscoli e minuscoli, si dovrebbe assumere da subito la buona abitudine di usare i dollari nei casi previsti: così facendo, sarà possibile cambiare il font del documento senza dover modificare a mano ogni numero.

Spaziare le cifre La corretta scrittura dei numeri di cinque o più cifre prevede uno spazio sottile fra ogni gruppo di tre cifre partendo da destra (come in 1 500 000). Per ottenerlo, ci sono diverse possibilità: se i numeri da scrivere nel documento non sono molti, si può inserire lo spazio sottile \, a mano; in caso contrario, risolve il problema il comando \num visto nel paragrafo precedente. Si osservi il risultato tipografico dei numeri negli esempi seguenti:

Numeri minuscoli

202

norme tipografiche 1500000 \\ $1500000$ \\ 1\,500\,000 \\ $1\,500\,000$ \\ \num{1500000}

Il punto e la virgola non vanno mai usati per separare le cifre a gruppi di tre.

1500000 1500000 1 500 000 1 500 000 1 500 000

Come si può notare, se non altrimenti specificato \num stampa i numeri maiuscoli. È bene evitare il punto e la virgola per separare le cifre, perché questi due segni servono già da separatore decimale nel mondo anglosassone ed europeo rispettivamente. Lo spazio sottile è l’unico metodo universalmente corretto.

Numeri decimali

La virgola decimale deve stare esattamente tra le due parti.

Nei numeri decimali il separatore fra parte intera e decimale è una virgola: «21,12». Si noti che in modo matematico LATEX tratta la virgola come un normale segno di punteggiatura e aggiunge uno spazio extra dopo di essa, con un risultato insoddisfacente. siunitx caricato con l’opzione output-decimal-marker={,} e \num risolvono anche questo problema: $21,12$ \\ \num{21,12}

21, 12 21,12

Come si può osservare, nel primo caso dopo la virgola si ha una spaziatura (leggermente) sbagliata.

Frazioni

Percentuali

Unità di misura

Acronimi

a.4.3

Frazioni, percentuali, unità di misura

a.4.4

Acronimi

Le frazioni si esprimono in lettere («tre quarti»), a meno che non indichino una quantità numerica precisa. In questo caso si possono scrivere usando la barra (3/4) o la forma frazionaria vera e propria ( 34 ), ottenibile con il codice visto nel paragrafo 5.2.3 a pagina 87.

Nella scrittura del testo il simbolo di percento segue immediatamente il numero cui si riferisce senza spazi intermedi («30%»). Si ricorda che questo simbolo è un carattere speciale per i commenti nel codice sorgente: si ottiene in stampa premettendogli una barra rovescia: \%.

Le quantità misurate sono costituite da numeri seguiti da un’unità di misura espressa di solito con il simbolo relativo, come in «20 cm» o «15 kg». Si noti che il simbolo dell’unità di misura non vuole il punto e va separato dal numero cui si riferisce con uno spazio adeguato. Per inserire correttamente le unità di misura del Sistema Internazionale si consiglia di usare il pacchetto siunitx o lo spazio sottile (si veda il paragrafo 5.10 a pagina 108).

Gli acronimi sono espressioni formate dalle lettere o sillabe iniziali delle parole di un’espressione che si vuole abbreviare, come guIt, html o pdf. Dovrebbero essere composti interamente da maiuscole (si ammette anche il maiuscoletto), senza spaziature interne e punti

a.4 composizione del testo

d’abbreviazione. Se l’acronimo è entrato nell’uso e si può pronunciare come parola, è ammissibile (e spesso preferibile) scriverlo come tale: Fiat e radar (anziché FIAT e RADAR) vanno benissimo. Si consiglia di citare per esteso gli acronimi meno noti la prima volta che compaiono nel testo, mettendone la forma estesa fra parentesi: guIt (Gruppo Utilizzatori Italiani di TEX e LATEX).

Le abbreviazioni si ottengono invece dal troncamento di una parola, mantenendone una o più lettere iniziali seguite dal punto. In casi particolari, come sig.ra o prof.ssa, l’abbreviazione comprende anche la parte finale della parola originale. Se l’abbreviazione dovesse cadere a fine enunciato (caso raro, forse possibile con il solo ecc.) il punto di abbreviazione funziona anche da punto fermo (cioè, ovviamente, non si scrivono due punti successivi).

203

Abbreviazioni

B indice b.1

b.2

b.3 b.4

GALLERIA DEGLI ORRORI Testo 205 b.1.1 Caratteri accentati 205 b.1.2 Sillabazione 206 b.1.3 Margini 206 b.1.4 Indirizzi Internet 206 Le tabelle 207 b.2.1 Regole generali 207 b.2.2 Allineare i numeri alla virgola 209 b.2.3 Tabelle mobili 209 Le figure 211 La matematica 212 b.4.1 Formule in display 212 b.4.2 Operatori 215 b.4.3 Parentesi 216 b.4.4 Matrici 217 b.4.5 Integrali multipli 217 b.4.6 Insiemi numerici 218 b.4.7 Riferimenti a una formula 218 b.4.8 Puntini di sospensione 219

In questa appendice, ispirata a [Gregorio, 2003], vengono raccolti alcuni esempi estratti da alcune diffuse guide introduttive a LATEX. Si presenta questa galleria non per svergognarne gli autori, naturalmente, ma per mostrare come non si dovrebbe scrivere in LATEX e che con qualche minuto di riflessione e il pacchetto “giusto” si può spesso ottenere un risultato migliore e più corretto, evitando acrobazie “TEXniche”.

In ciascun esempio è mostrato il testo originale; lo si discute e poi si mostra una versione corretta, con l’indicazione di quali pacchetti richiamare e quali comandi, eventualmente, definire nel preambolo.

b.1

testo

b.1.1 Caratteri accentati

Si consideri il codice seguente:

Non se ne pu\‘o pi\‘u: in realt\‘a, cos\‘{\i} facendo il numero di caratteri da battere \‘e triplo! Perch\’e non usare direttamente i caratteri accentati?

Non se ne può più: in realtà, così facendo il numero di caratteri da battere è triplo! Perché non usare direttamente i caratteri accentati?

205

206

Con fontenc e inputenc, si inseriscono i caratteri accentati direttamente dalla tastiera.

galleria degli orrori

Questa scrittura non ha più ragione di esistere. Dal 1994, infatti, i pacchetti fontenc e inputenc opportunamente impostati interpretano correttamente i caratteri accentati dati direttamente dalla tastiera senza problemi di sillabazione (si veda il paragrafo 4.1 a pagina 43): In realtà, dal 1994 si possono inserire i caratteri accentati direttamente dalla tastiera: perché non farlo?

In realtà, dal 1994 si possono inserire i caratteri accentati direttamente dalla tastiera: perché non farlo?

b.1.2 Sillabazione

Si consideri il seguente infelice esempio d’uso di \hyphenation :

\hyphenation{Sil-la-ba-zio-ne sim-pa-ti-ca-men-te}

Il comando

\hyphenation si usa

per sillabazioni eccezionali.

L’algoritmo di sillabazione di LATEX funziona correttamente con quasi tutte le parole italiane (e dunque anche con quelle indicate nell’esempio), ma in particolari circostanze si potrebbe volere una divisione diversa da quella automatica. Esempi più calzanti sarebbero, piuttosto, nomi propri o tecnicismi composti come nitroidrossilamminico o macroistruzione, per i quali a volte si richiede la sillabazione etimologica “nitro-idrossil-amminico” invece di “ni-troi-dros-si-lam-mi-ni-co”, e “ma-cro-istru-zio-ne” invece di “ma-croi-stru-zio-ne”, che LATEX esegue di default.

L’esempio proposto va sostituito con quello seguente: \hyphenation{nitro-idrossil-amminico ma-cro-istru-zio-ne}

b.1.3 Margini

Si consideri il seguente codice, proposto per modificare i margini di pagina predefiniti: \addtolength{\textwidth}{1cm} \addtolength{\hoffset}{-0.5cm}

layaureo e geometry

La modifica dei comandi interni di LATEX (\textwidth e \hoffset , in questo caso) è sempre sconsigliabile, se non altro perché non tiene in nessun conto le proporzioni di pagina [Fairbairns, 2010; Trettin e Zannarini, 2005].

A questo scopo, nelle classi standard è bene affidarsi a pacchetti dedicati come layaureo o geometry (si veda il paragrafo 4.5.1 a pagina 57). b.1.4 Indirizzi Internet

Si consideri il seguente codice:

http://profs.sci.univr.% it/\~{}gregorio/ http://profs.sci.univr.% it/$\sim$gregorio/

http://profs.sci.univr.it/˜gregorio/ http://profs.sci.univr.it/∼gregorio/

b.2 le tabelle

Per scrivere un indirizzo Internet si usa il pacchetto url (che viene caricato automaticamente da hyperref): \url{http://profs.sci.univr.% it/~gregorio/}

http://profs.sci.univr.it/ ~gregorio/

207

Per scrivere un indirizzo Internet si usa il pacchetto url.

Come si può osservare, non occorrono peripezie per inserire la tilde

~, l’indirizzo è composto con il font a spaziatura fissa impostato e, se

necessario, automaticamente sillabato.

b.2

le tabelle

b.2.1 Regole generali

Si considerino le seguenti tabelle:

\begin{tabular}{|l|c|r|} \hline Sparc & SunOS & 4.1.4 \\ \hline HP & HP-UX & 10.20 \\ \hline PC & NetBSD & 1.2 \\ \hline \end{tabular}

\begin{tabular}{|r|l|} \hline 7C0 & esadecimale \\ 3700 & ottale \\ 11111000000 & binario \\ \hline \hline 1984 & decimale \\ \hline \end{tabular}

Sparc HP PC

SunOS HP-UX NetBSD

7C0 3700 11111000000 1984

4.1.4 10.20 1.2

esadecimale ottale binario decimale

• Le tabelle precedenti sono state composte senza seguire le regole generali, che impongono di non usare filetti verticali e di evitare quelli doppi (si veda il paragrafo 6.3.1 a pagina 120).

Le tabelle vanno composte seguendo le regole generali, . . .

• Per stampare i filetti orizzontali vanno usati i comandi \toprule , \midrule e \bottomrule di booktabs al posto di \hline , per via dello spazio troppo risicato che quest’ultimo lascia tra i filetti e il testo nelle celle (si veda il paragrafo 6.3.2 a pagina 122).

. . . usando i comandi di booktabs per ottenere le linee orizzontali. . .

• Si consiglia, infine, di allineare le colonne anche se LATEX non lo richiede, per tenere in ordine il codice sorgente.

. . . e allineando le colonne nel sorgente.

208

galleria degli orrori

Tabella 53: Tabella non composta correttamente secondo le regole generali.

Contenuto 33 cl 66 cl 33 cl

Heineken Guinness Kronenbourg

Quantità 10 5 0

Tabella 54: Tabella composta correttamente secondo le regole generali.

Heineken Guinness Kronenbourg

Contenuto (cl)

Quantità

33 66 33

10 5 0

Per queste ragioni è opportuno riscrivere le tabelle nel modo seguente: \begin{tabular}{lcr} \toprule Sparc & SunOS & 4.1.4 \\ HP & HP-UX & 10.20 \\ PC & NetBSD & 1.2 \\ \bottomrule \end{tabular}

\begin{tabular}{rl} \toprule 7C0 & esadecimale \\ 3700 & ottale \\ 11111000000 & binario \\ \midrule 1984 & decimale \\ \bottomrule \end{tabular}

Sparc HP PC

SunOS HP-UX NetBSD

7C0 3700 11111000000 1984

4.1.4 10.20 1.2

esadecimale ottale binario decimale

Si consideri la tabella 53, ottenuta con il seguente codice: \begin{tabular}{||p{5cm}||*{2}{c|}|} \hline & Contenuto & Quantit\‘a \\ \hline \hline \bfseries Heineken & 33 cl & 10 \\ \hline \bfseries Guinness & 66 cl & 5 \\ \hline \bfseries Kronenbourg & 33 cl & 0 \\ \hline \end{tabular}

Per impostare il font di una colonna di una tabella si usa array.

Nell’esempio considerato, la scelta di specificare la larghezza della prima colonna non appare molto appropriata. Inoltre, per impostare il font di una determinata colonna è opportuno usare il comando >{hdichiarazionei} di array (si veda il paragrafo 6.3.8 a pagina 130). Eliminando i filetti verticali, i filetti doppi e quelli orizzontali superflui,

b.2 le tabelle

usando i comandi di booktabs per stampare solo quelli davvero necessari e inserendo l’unità di misura nell’intestazione anziché nel corpo della tabella, la tabella 53 a fronte si trasforma nella 54 nella pagina precedente, ottenuta con il seguente codice: \begin{tabular}{>{\bfseries}lcc} \toprule & Contenuto (cl) & Quantità \\ \midrule Heineken & 33 & 10 \\ Guinness & 66 & 5 \\ Kronenbourg & 33 & 0 \\ \bottomrule \end{tabular}

nel quale, come al solito, si sono allineate le colonne per fare ordine e si sono usati i caratteri da tastiera per le lettere accentate. b.2.2 Allineare i numeri alla virgola Si consideri la seguente tabella:

\begin{tabular}{c r @{,} l} Espressione & \multicolumn{2}{c}{Valore} \\ \hline $\pi$ & 3&1416 \\ $\pi^{\pi}$ & 36&46 \\ $(\pi^\pi)^\pi$ & 80662&7 \\ \end{tabular}

Espressione π ππ (ππ )π

Valore 3,1416 36,46 80662,7

Per allineare i numeri alla virgola è meglio usare il pacchetto siunitx e la sua colonna di tipo S (si veda il paragrafo 6.3.4 a pagina 125). La tabella precedente si trasforma nella 55 nella pagina successiva, ottenuta con il codice: \begin{tabular}{cS} \toprule Espressione & \midrule $\pi$ & $\pi^{\pi}$ & $\pi^{\pi^{\pi}}$ & \bottomrule \end{tabular}

{Valore} \\ 3.1416 \\ 36.46 \\ 80662.7 \\

nel quale, come al solito, si sono usati i comandi di booktabs per stampare i filetti orizzontali. b.2.3 Tabelle mobili

Si consideri il seguente codice, spesso usato per una tabella mobile:

\begin{table}[htbp] \begin{center} \begin{tabular}{|l|l|}

209

210

galleria degli orrori

Tabella 55: Esempio di tabella con allineamento alla virgola.

Espressione π ππ π ππ

Valore 3,1416 36,46 80 662,7

\hline table & tabelle \\ \hline figure & disegni \\ \hline \end{tabular} \end{center} \caption{Esempio di tabella mobile} \label{tab:table} \end{table}

Si considerino gli errori che contiene: È meglio evitare l’opzione di collocazione htbp.

• L’opzione di collocazione htbp andrebbe sempre evitata. Al suo posto si consiglia tb se l’oggetto mobile è di dimensioni contenute, altrimenti p (si veda il paragrafo 6.5 a pagina 144).

Per centrare una tabella mobile si usa \centering invece di center.

• Per centrare una tabella mobile sulla pagina è più opportuno il comando \centering piuttosto che l’ambiente center, per via dell’eccessivo spazio verticale lasciato da quest’ultimo tra didascalia e tabella.

Per separare la didascalia dalla tabella si può usare caption.

• Per separare la didascalia dalla tabella (che di regola si mette sopra e non sotto, come nell’esempio mostrato), nelle classi standard conviene caricare il pacchetto caption e scrivere una volta per tutte nel preambolo \captionsetup[table]{position=top}

Eliminando come al solito i filetti verticali e usando i comandi di booktabs per ottenere quelli orizzontali, la tabella precedente si trasforma nella 56 nella pagina successiva, ottenuta con il seguente codice: \begin{table}[tb] \caption{Esempio di tabella mobile.} \label{tab:esempio} \centering \begin{tabular}{ll} \toprule \texttt{table} & tabelle \\ \texttt{figure} & disegni \\ \bottomrule \end{tabular} \end{table}

Tabella 56: Esempio di tabella mobile. table figure

b.3

b.3 le figure

211

tabelle disegni

le figure

Le figure mobili

Si consideri il seguente codice, spesso usato per una figura mobile:

\begin{figure}[htbp] \caption{Disegno} \label{fig:dessin} \begin{center} \includegraphics[width=10cm]{figura.eps} \end{center} \end{figure}

Ai primi due errori esaminati nel paragrafo precedente, comuni a quest’esempio, se ne aggiungono altri.

• Di regola, la didascalia si scrive sotto la figura.

• Le chiavi width e heigth accettano qualsiasi unità di misura tipografica riconosciuta da LATEX (width=85mm oppure width=8.5cm è la stessa cosa), ma è sempre meglio esprimere queste due dimensioni in modo relativo con un valore legato alla geometria della pagina (per esempio, width=0.5\columnwidth). In questo modo si evitano gli inconvenienti che le dimensioni assolute potrebbero presentare nell’impaginazione del documento.

È opportuno specificare le dimensioni relative e non assolute di una figura.

• Se si prevede di compilare sia con LATEX sia con pdfLATEX, si consiglia di non specificare l’estensione dei file da caricare con \includegraphics (si veda il paragrafo 6.4.5 a pagina 142).

Si consiglia di non specificare l’estensione dei file grafici caricati.

Per concludere, di seguito si riporta il codice tipo per inserire nel documento una figura mobile come la figura 21 nella pagina successiva: \begin{figure}[tb] \centering \includegraphics[width=0.5\columnwidth]{Galleria} \caption{Esempio di figura mobile.} \label{fig:galleria} \end{figure}

Si consideri ora il seguente codice: Come si vede in Fig.~21 \dots

• I riferimenti incrociati di LATEX si ottengono con i comandi \label , \ref e \vref (si veda il paragrafo 4.8 a pagina 68), uniti al testo precedente da uno spazio indivisibile.

• Nell’inserire un oggetto mobile si abbia cura che \label sia dato dopo il corrispondente \caption .

212

galleria degli orrori

Figura 21: Esempio di figura mobile (l’immagine riproduce la litografia Galleria di stampe di M. Escher).

• Le abbreviazioni italiane degli oggetti mobili non hanno l’iniziale maiuscola e richiedono l’opportuna preposizione articolata.

L’esempio precedente si scriverà, allora: Come si vede nella figura~\vref{fig:galleria} \dots

b.4

Come si vede nella figura 21 . . .

la matematica

b.4.1 Formule in display

Si consideri il seguente esempio:

Ne risulta: $$ x + y + z = n $$

I comandi $$...$$ non vanno mai usati.

Ne risulta: x+y+z = n

I comandi $$. . .$$ non vanno mai usati per scrivere formule in display in un documento, perché la spaziatura verticale delle strutture o l’opzione di classe fleqn potrebbero non funzionare più bene [Fairbairns, 2010; Trettin e Zannarini, 2005]. La formula precedente si scrive correttamente così: Ne risulta: \[ x + y + z = n. \]

Ne risulta: x + y + z = n.

Si noti che nell’esempio corretto è stata aggiunta la punteggiatura.

b.4 la matematica

Si consideri ora: $$ f(x) > 1 \mbox{ se } x < 3 $$

213

Testo nelle formule

f(x) > 1 se x < 3

Se si vuole corredare una formula in display di un breve testo (con font e spaziatura normali), si usa il comando \text{h. . .i} di amsmath.

Il modo corretto di scrivere la formula precedente è: \[ f(x)>1 \text{ se $x<3$.} \]

f(x) > 1 se x < 3.

Come sempre, si è aggiunta la punteggiatura.

Gruppi di formule con allineamento Si consideri il seguente esempio: \begin{eqnarray} e^{x+y} & = & e^x \: e^y \\ \ln xy & = & \ln x + \ln y \end{eqnarray}

ex+y

=

ex e y

ln xy

=

ln x + ln y (B.2)

(B.1)

L’ambiente align di amsmath allinea gruppi di due o più formule, ciascuna su una riga a sé e numerata singolarmente. L’esempio precedente si scrive, allora: \begin{align} e^{x+y} &= e^x e^y \\ \ln xy &= \ln x + \ln y \end{align}

ex+y = ex ey

(B.3)

ln xy = ln x + ln y

(B.4)

Si osservi che alla spaziatura manuale è stata preferita quella automatica e che è stato eliminato il comando \: (che non dovrebbe mai essere usato per le ragioni esaminate nel paragrafo 5.2.10 a pagina 93).

Formule spezzate con allineamento Si consideri la seguente formula: \begin{eqnarray} \int_1^2 x^2 dx & = & \left[ \frac{x^3}{3} \right]_1^2 \nonumber \\ & = & \frac{2^3}{3}\frac{1^3}{3} \nonumber \\ & = & \frac{8}{3}\frac{1}{3} \nonumber \\ & = & \frac{7}{3} \end{eqnarray}

Z2

2

x dx

=

1

= = =

x3 3

2 1

23 13 − 3 3 8 1 − 3 3 7 (B.5) 3

Allineare gruppi di formule

214

Spezzare una formula allineandone le parti

galleria degli orrori

Per spezzare una singola formula in più righe da allineare si usa l’ambiente split di amsmath: \begin{equation} \begin{split} \int_1^2 x^2 dx &= \biggl[ \frac{x^3}{3} \biggr]_1^2 \\ &= \frac{2^3}{3}\frac{1^3}{3} \\ &= \frac{8}{3}-\frac{1}{3} \\ &= \frac{7}{3}. \end{split} \end{equation}

Z2

x2 dx =

1

x3 3

2 1

2 3 13 = − 3 3 8 1 = − 3 3 7 = .

3

(B.6)

Si noti che per specificare le dimensioni delle parentesi quadre, al posto dei comandi automatici \left e \right si sono usati i comandi manuali \biggl e \biggr (si veda il paragrafo 5.4 a pagina 95).

Formule spezzate senza allineamento Si consideri la seguente formula:

\begin{eqnarray} \lefteqn{ \cos x = 1 -\frac{x^{2}}{2!} +{} } \nonumber\\ & & {}+\frac{x^{4}}{4!} -\frac{x^{6}}{6!}+{}\cdots \end{eqnarray}

Spezzare una formula senza allinearne le parti

Per spezzare una singola formula in più righe senza particolari allineamenti fra di esse si usa l’ambiente multline di amsmath: \begin{multline} \cos x = 1-\frac{x^2}{2!} \\ +\frac{x^4}{4!}-\frac{x^6}{6!} +\dots \end{multline}

Quando si spezza una formula, non bisogna ripetere i segni di operazione.

x2 + 2!

4 6 x x + − + · · · (B.7) 4!

6!

cos x = 1 −

x2 2! x4 x6 + − +...

4!

6!

cos x = 1 −

(B.8)

I segni di operazione o relazione vanno indicati una sola volta: nel caso di formule in linea, a fine riga; nel caso di formule in display, a inizio riga. Si sconsiglia di indicarli due volte sia per ragioni estetiche sia per evitare ambiguità [Guiggiani e Mori, 2008]. Si osservi, inoltre, che nella versione corretta sono state eliminate molte graffe superflue, soprattutto attorno agli esponenti.

b.4 la matematica

Casi

215

Si consideri il seguente esempio: $$ |x| = \left\{ \begin{array}{rl} x & \mbox{se } x \ge 0 \\ -x & \mbox{se } x < 0 \end{array} \right. $$

x â&#x2C6;&#x2019;x

|x| =

se x > 0 se x < 0

â&#x20AC;˘ Per le definizioni fatte per casi si usa lâ&#x20AC;&#x2122;ambiente cases di amsmath.

Ampiezza e allineamento della parentesi graffa sono automatici; il testo nella seconda colonna va dentro a \text{h. . .i}.

Per le definizioni fatte per casi si usa cases.

â&#x20AC;˘ Per scrivere il valore assoluto è conveniente caricare il pacchetto mathtools (si veda il paragrafo 5.2.8 a pagina 90) e definire nel preambolo un comando ad hoc:

Per il valore assoluto si usa mathtools.

\DeclarePairedDelimiter{\abs}{\lvert}{\rvert}

La formula precedente si scrive, allora: \[ \abs{x} = \begin{cases} x, & \text{se $x\ge 0$,} \\ -x, & \text{se $x<0$.} \end{cases} \]

|x| =

x, â&#x2C6;&#x2019;x,

se x > 0, se x < 0.

b.4.2 Operatori

Si consideri il seguente esempio:

\begin{displaymath} \mathop{\mathrm{cov}}(X,Y)= \frac{1}{n}\sum_{i=1}^n (x_i-\overline x) (y_i-\overline y) \end{displaymath}

cov(X, Y) =

n 1 X (xi â&#x2C6;&#x2019; x)(yi â&#x2C6;&#x2019; y) n i=1

Il comando \DeclareMathOperator di amsmath (si veda il paragrafo 5.3 a pagina 94) definisce un nuovo operatore. Per esempio, per definire una funzione matematica cov che denoti la covarianza (non predefinita nĂŠ da LATEX nĂŠ da amsmath) si scrive nel preambolo \DeclareMathOperator{\cov}{cov}

Nel documento basterĂ scrivere \cov per ottenere cov nel font corretto e adeguatamente spaziato su entrambi i lati. Lâ&#x20AC;&#x2122;esempio precedente si scrive, allora:

Per definire un nuovo operatore si usa lâ&#x20AC;&#x2122;apposito comando di amsmath.

216

galleria degli orrori

\[ \cov(X,Y)= \frac{1}{n}\sum_{i=1}^n (x_i-\bar x)(y_i-\bar y) \]

cov(X, Y) =

n 1 X (xi − x¯ )(yi − y) ¯ n i=1

Si noti che per indicare il valore medio delle variabili aleatorie X e Y si è usato \bar e non \overline : quest’ultimo, infatti, produce x (operatore applicato alla variabile x), mentre il primo comando stampa il simbolo corretto x¯ (nome di variabile distinto da x). b.4.3 Parentesi

Si consideri la seguente formula:

\begin{displaymath} 1 + \left( \frac{1}{ 1-x^{2} } \right)^3 \end{displaymath}

Per specificare le dimensioni di un delimitatore, spesso la scelta manuale è la migliore.

1+

1 1 − x2

3

LATEX può determinare automaticamente le dimensioni dei delimitatori premettendo \left al delimitatore di apertura e dando \right prima del corrispondente delimitatore di chiusura. Il metodo manuale, tuttavia, rimane ancora quello preferito per via delle spaziature indesiderate e delle parentesi più grandi del necessario che questi due comandi quasi sempre producono. La formula precedente, allora, si scrive: \[ 1+\biggl(\frac{1}{1-x^2} \biggr)^3 \]

1+

1 1 − x2

3

Come al solito, si sono eliminate le parentesi graffe superflue.

Si consideri: \begin{displaymath} {n \choose k} \end{displaymath}

Per i coefficienti binomiali si usa \binom.

n k

Per scrivere coefficienti binomiali si usa il comando \binom di amsmath:

\[ \binom{n}{k} \]

n k

b.4 la matematica

b.4.4 Matrici

217

Si considerino i seguenti esempi:

$$ \left[ \begin{array}{cc} a_{11} & a_{12} \\ a_{21} & a_{22} \end{array} \right] $$ $$ {\mathcal A} = \left( \begin{array}{ccc} a_{11} & a_{12} & a_{13} \\ a_{21} & a_{22} & a_{23} \\ a_{31} & a_{32} & a_{33} \end{array} \right) $$

a11 a21



a11 A =  a21 a31

a12 a22

 a13 a23  a33

a12 a22 a32

Per scrivere le matrici è opportuno usare gli appositi ambienti di amsmath (si veda il paragrafo 5.5 a pagina 98), che oltre a essere facili da usare danno un risultato tipografico ottimale. Le matrici precedenti si scrivono, allora: \[ \begin{bmatrix} a_{11} & a_{12} \\ a_{21} & a_{22} \end{bmatrix} \] \[ \mathcal{A}= \begin{pmatrix} a_{11} & a_{12} & a_{13} \\ a_{21} & a_{22} & a_{23} \\ a_{31} & a_{32} & a_{33} \end{pmatrix} \]

a11 a21



a11 A = a21 a31

a12 a22

a12 a22 a32

 a13 a23  a33

Si noti, inoltre, che il comando \mathcal non è una dichiarazione e richiede un argomento. b.4.5 Integrali multipli

Si considerino i seguenti esempi:

$$ V = \int \!\! \int \!\! \int_{\Omega} d\tau $$

ZZZ V=

dτ Ω

Per le matrici si usano gli ambienti dedicati di amsmath.

218

galleria degli orrori

\newcommand{\ud}{\mathrm{d}} \begin{displaymath} \int\!\!\int_{D} g(x,y) \, \ud x\, \ud y \end{displaymath}

Per scrivere gli integrali multipli si usano gli appositi comandi di amsmath.

ZZ g(x, y) dx dy D

Per gli integrali multipli si usano gli appositi comandi di amsmath (si veda il paragrafo 5.2.4 a pagina 88): \[ V=\iiint_\Omega d\tau \]

\[ \iint_D g(x,y)\,dx\,dy \]

V=

y

dτ

Ω

x

g(x, y) dx dy

D

Si osservi che, in contrasto con le norme iso-uni che regolano la redazione di lavori tecnico-scientifici il simbolo del “differenziale” non è in tondo ma in corsivo, come vuole la tradizione dei documenti di matematica pura [Guiggiani e Mori, 2008]. b.4.6 Insiemi numerici

Si consideri il seguente esempio:

\begin{equation} \forall x \in \mathbf{R}: \qquad x^{2} \ge 0 \end{equation}

Per comporre gli insiemi numerici conviene adottare una scrittura che permetta di cambiare notazione con un’unica modifica.

∀x ∈ R :

x2 > 0

(B.9)

Per comporre gli insiemi numerici si carica il pacchetto amssymb e si scrivono nel preambolo le seguenti definizioni:

\newcommand{\numberset}{\mathbb} \newcommand{\N}{\numberset{N}} \newcommand{\R}{\numberset{R}}

In questo modo, per avere N basta scrivere \N e si può cambiare notazione con un’unica modifica. L’esempio precedente si scrive, allora: \begin{equation} \forall x \in \R \quad x^2 \ge 0. \end{equation}

∀x ∈ R

x2 > 0.

(B.10)

b.4.7 Riferimenti a una formula

Si consideri il seguente esempio:

\begin{equation} \label{eq:eta} \eta>0 \end{equation} Dalla formula (\ref{eq:eta}) si deduce che \ldots

η>0

(B.11)

Dalla formula (B.11) si deduce che ...

b.4 la matematica

Per riferirsi a una formula da un punto qualsiasi del documento si usa il comando \eqref del pacchetto amsmath e si unisce il riferimento al testo precedente con uno spazio indivisibile (si veda il paragrafo 4.3.1 a pagina 52), così: \begin{equation} \label{eqn:eta} \eta>0 \end{equation} Dalla formula~\eqref{eqn:eta} si deduce che\dots

η>0

219

\eqref

(B.12)

Dalla formula (B.12) si deduce che. . .

b.4.8 Puntini di sospensione

Si consideri il seguente esempio:

\begin{displaymath} x_{1},\ldots,x_{n} \qquad x_{1}+\cdots+x_{n} \end{displaymath}

x1 , . . . , xn

x1 + · · · + xn

Per inserire puntini di sospensione in una formula si usa il comando \dots del pacchetto amsmath, che li inserisce automaticamente sulla linea di base del testo o li centra rispetto alla riga a seconda del contesto: \[ x_1,\dots,x_n \qquad x_1+\dots+x_n \]

x1 , . . . , xn

x1 + · · · + xn

\dots

C indice c.1

c.2

LATEX P E R G L I U M A N I S T I

Scrivere in latino 221 c.1.1 Marche prosodiche 222 c.1.2 Latino medievale 223 c.1.3 Documenti interamente in latino 224 Scrivere in greco 225 c.2.1 La traslitterazione dei caratteri 226 c.2.2 Scrivere in greco nel sorgente 228 c.2.3 Documenti interamente in greco 230 c.2.4 Il pacchetto teubner 231

In quest’appendice si presentano gli strumenti essenziali per scrivere in latino e in greco, le due lingue fondamentali per chi si occupa di scienze umane. Se non indicato diversamente, si assume che la lingua principale del documento sia l’italiano.

c.1

scrivere in latino

Scrivere in latino con LATEX non presenta particolari difficoltà: l’alfabeto e la codifica di input sono gli stessi dell’italiano, e anche i font del documento finito possono essere uguali.

Caricare babel indicando latin tra le lingue,

latin

\usepackage[latin,italian]{babel}

generalmente basta per scrivere qualunque testo latino (antico o contemporaneo, letterario e non) e per attivarne la corretta sillabazione.

Per passare da una lingua all’altra si possono usare gli strumenti già esaminati nel paragrafo 4.1 a pagina 43 come, per esempio: \dots testo in italiano. \begin{otherlanguage*}{latin} Gallia est omnis divisa in partes tres, quarum unam incolunt Belgae, aliam Aquitani, tertiam qui ipsorum lingua Celtae, nostra Galli appellantur. \end{otherlanguage*}

. . . testo in italiano.

Gallia est omnis divisa in partes tres, quarum unam incolunt Belgae, aliam Aquitani, tertiam qui ipsorum lingua Celtae, nostra Galli appellantur.

Altro testo in italiano. . .

Altro testo in italiano\dots

221

222

latex per gli umanisti

e si può inserire un testo latino breve o brevissimo all’interno di un capoverso scrivendolo nell’argomento di un comando \latino definito ad hoc: \newcommand{\latino}[1]{\foreignlanguage{latin}{#1}}

da usare come segue: L’attacco della prima \emph{Catilinaria}, \latino{Quo usque tandem abutere, Catilina, patientia nostra?}, è famosissimo.

L’attacco della prima Catilinaria, Quo usque tandem abutere, Catilina, patientia nostra?, è famosissimo.

Di seguito si descrivono alcune proprietates di babel.

c.1.1

Marche prosodiche

L’attributo withprosodicmarks specificato subito dopo la chiamata di babel

\languageattribute{latin}{withprosodicmarks}

permette di segnare esplicitamente la quantità sulle vocali minuscole (come spesso si trova nei testi didattici o di linguistica) semplicemente premettendo loro il carattere ^ per la quantità breve ˘ o il carattere = per quella lunga ¯ : \begin{otherlanguage*}{latin}% \ProsodicMarksOn ros^a \\ ros=a \end{otherlanguage*} \ProsodicMarksOn \ProsodicMarksOff

ros˘a ros¯a

Si ricordi, però, di attivarne effettivamente la composizione racchiudendo il testo interessato (anche nell’argomento di \latino ) tra le dichiarazioni \ProsodicMarksOn e \ProsodicMarksOff , altrimenti il compilatore restituisce esattamente quello che trova nel testo sorgente. Nei (rari) casi in cui sia una maiuscola a dover portare la quantità, si possono usare i comandi consueti \={h. . .i} o \u{h. . .i} (si veda la tabella 8 a pagina 65).

Si noti che in entrambi i casi LATEX potrebbe sillabare in modo insoddisfacente o non sillabare per nulla le parole con la quantità segnata. Si risolve il problema inserendo "| dove serve per indicare al programma i punti di cesura.

L’esempio precedente diventa, con le marche prosodiche segnate: \begin{otherlanguage*}{latin} \ProsodicMarksOn Galli^a est omn^is divis^a in part=es tr=es, qu=arum un^am inc^olunt Belgae, ali^am Aquitan=i, terti^am qu=i ips=orum lingu=a Celtae, nostr=a Gall=i appell=antur. \end{otherlanguage*}

Galli˘a est omn˘ıs divis˘a in part¯es ˘ tr¯es, qu¯arum un˘am incolunt Belgae, ali˘am Aquitan¯ı, ter¯ ti˘am qu¯ı ipsorum lingu¯a Celtae, nostr¯a Gall¯ı appell¯antur.

c.1 scrivere in latino

Si noti che non è permesso (né avrebbe senso) indicare la quantità di un dittongo legato in latino medievale (si veda il paragrafo seguente).

Per un difetto interno di babel, le dichiarazioni appena descritte non producono i loro effetti se non apportando due piccole modifiche al file babel.def (che contiene le definizioni del pacchetto), pena uno spazio indesiderato all’inizio del testo. Di seguito si spiega come procedere:

223

• si copia sul proprio desktop il file babel.def dalla cartella in cui si trova (il percorso esatto varia a seconda del sistema operativo e della distribuzione di LATEX installati, ma è sempre recuperabile dalle prime righe del log di una compilazione, per esempio); • si apre il file con l’editor in uso e si aggiunge un segno di percento % alla fine delle righe 191 e 246 (si ricordi di impostare l’editor per visualizzare il numero delle righe, se non lo fosse già); • si registrano le modifiche, si chiude il file modificato e lo si sposta nella cartella /tex/latex/generic/babel/ del proprio albero personale, creando le necessarie cartelle, se non ci fossero già, nei modi indicati nel paragrafo 3.4.3 a pagina 34.1 Chi non volesse apportare le modifiche appena descritte, può usare in ogni caso i comandi standard ricordati più sopra in questo stesso paragrafo. Infine, se la distribuzione installata è MiKTEX va aggiornato il database dei file nel modo consueto (TEX Live non lo richiede). c.1.2

Latino medievale

Per dare al testo latino una patina medievaleggiante, l’autore può applicare tutte o solo alcune delle seguenti varianti: • usare un unico segno, u, per u e v minuscole: Nouembris anziché Novembris, per esempio; • usare un unico segno, V, per U e V maiuscole: IVLIVS anziché Iulius; • usare le legature per i dittonghi æ e œ (minuscoli e maiuscoli), che nel latino classico erano sempre sciolti: æ (\ae ), œ (\oe ), Æ (\AE ), Œ (\OE ).

L’opzione latin di babel offre un paio di automatismi utili per scrivere in questa varietà di latino: • gestisce correttamente la conversione da minuscolo a maiuscolo nelle stringhe automatiche come i titoli di sezione: un titolo come \chapter{C\ae sar et Heluetii}, per esempio, nella corrispondente testatina maiuscola diventa CÆSAR ET HELVETII; • ridefinisce il comando \prefacename per ottenere Præfatio anziché Praefatio (le altre voci automatiche non subiscono variazioni, si veda il paragrafo seguente).

1 Quando gli autori di babel correggeranno ufficialmente il difetto in questione, si ricordi di cancellare dall’albero personale il file babel.def modificato.

\ae \oe \AE \OE

224

latex per gli umanisti

Si seleziona questo tipo di scrittura caricando l’attributo medieval subito dopo la chiamata di babel: \languageattribute{latin}{medieval}

Applicando tutte le varianti viste in questo paragrafo, l’esempio precedente diventa: Gallia est omnis diuisa in partes tres, quarum unam incolunt Belg\ae, aliam Aquitani, tertiam qui ipsorum lingua Celt\ae, nostra Galli appellantur.

Gallia est omnis diuisa in partes tres, quarum unam incolunt Belgæ, aliam Aquitani, tertiam qui ipsorum lingua Celtæ, nostra Galli appellantur.

Anche in latino medievale si possono risolvere eventuali sillabazioni problematiche come già spiegato nel paragrafo precedente. c.1.3

Documenti interamente in latino

Chi dovesse scrivere un documento completamente in latino può contare su qualche agevolazione in più. L’opzione latin di babel, infatti:

• converte automaticamente la data prodotta da \today nella corrispondente data “latina”, nella forma IX Aprilis MMXI; • traduce in latino tutte le voci automatiche delle classi di documento standard: Capitolo diventa Caput, per esempio.

Si fornisce infine il preambolo tipo per comporre un documento in italiano e latino o nel solo latino (le righe sono numerate per necessità pratiche). Si noti che: • va indicata obbligatoriamente una sola tra le righe 5 e 6 a seconda della o delle lingue del documento; • le righe 8 e 9, invece, servono soltanto per sfruttare le rispettive specialità di latin e si possono anche caricare insieme.

1 2 3

\documentclass[a4paper]{article} \usepackage[T1]{fontenc} \usepackage[utf8]{inputenc}

4 5 6

\usepackage[latin,italian]{babel} \usepackage[latin]{babel}

7 8 9

\languageattribute{latin}{withprosodicmarks} \languageattribute{latin}{medieval}

10 11 12 13

\begin{document} ... \end{document}

c.2

scrivere in greco

c.2 scrivere in greco

225

Scrivere in greco con LATEX richiede qualche attenzione: non soltanto è diverso l’alfabeto, ma lo sono anche la codifica di output e i font che il sistema usa per comporre il documento finito.

Prima di scrivere effettivamente il documento, l’autore è chiamato a scegliere almeno due cose: 1. il sistema ortografico che intende seguire; 2. il metodo di scrittura del testo greco nel file sorgente.

LATEX gestisce correttamente due sistemi ortografici per scrivere in questa lingua: • il sistema politonico (“con molte intonazioni”), caratterizzato dalla presenza di tre accenti e numerosi altri segni diacritici, con cui si può scrivere il greco antico; • il sistema monotonico (“con una sola intonazione”), caratterizzato dalla presenza di un solo accento, con cui si può scrivere il greco moderno.

Nel testo sorgente, infine, si possono scrivere le parti in greco in due modi: • traslitterando il testo in lingua secondo una particolare corrispondenza tra i caratteri; • scrivendo direttamente i caratteri greci.

Le possibilità appena descritte si possono combinare per un totale di quattro. Se non diversamente indicato, gli esempi di questo paragrafo sono in greco antico secondo il sistema politonico.

Caricare babel indicando greek tra le lingue, \usepackage[greek,italian]{babel}

generalmente basta per scrivere qualunque testo greco (antico o contemporaneo, letterario e non): così facendo, infatti, si caricano automaticamente i font greci predefiniti CB (di Claudio Beccari, compresi nelle moderne distribuzioni di LATEX, ma ne sono disponibili molti altri, alcuni dei quali hanno anche i caratteri latini) e si attivano la codifica di output LGR (Local GReek) e la corretta sillabazione delle parole. Si noti che per la traduzione delle voci automatiche in greco antico in un documento interamente in greco (si veda il paragrafo C.2.3 a pagina 230) bisogna specificare anche l’attributo polutoniko subito dopo la chiamata di babel: \languageattribute{greek}{polutoniko}

Si passa da una lingua all’altra con gli strumenti già esaminati nel paragrafo 4.1 a pagina 43 come, per esempio:

greek

226

latex per gli umanisti | ͺ \

!

1

" ¨v 2

£ 3

$ 4

% 5

& 6

/ 7

( 8

) 9

= 0

? ; ’ ΄v

^ ì

Q Χ W Ω E Ε R Ρ T Τ Y Ψ U Υ I Ι O Ο P Π é * q χ w ω e ε r ρ t τ y ψ u υ i ι o ο p π è [ + ] A Α S Σ D Δ F Φ G Γ H Η J Θ K Κ L Λ ç ° a α s σv d δ f φ g γ h η j θ k κ l λ ò @ à # > ᾿v < ῾v

Z Ζ X Ξ C z ζ x ξ c ς

V v

B Β N Ν M Μ ; · b β n ν m μ ,

: .

§ ù

_ -

Figura 22: Corrispondenza tra la tastiera italiana e i caratteri greci.

\dots testo in italiano. \begin{otherlanguage*}{greek} Th| p’anta dido’ush| ka‘i >apolambano’ush| f’usei <o pepaideum’enos ka‘i a>id’hmwn l’egei; <<d‘os, <‘o j’eleis, >ap’olabe, <‘o j’eleic>>.

L’egei d‘e to~uto o>u katajrasun’omenos, >all‘a peijarq~wn m’onon ka‘i e>uno~wn a>ut~h|. \end{otherlanguage*}

. . . testo in italiano. Τῃ πάντα διδούσῃ καὶ ἀπολαμβανούσῃ φύσει ὁ πεπαιδευμένος καὶ αἰδήμων λέγει· ῾῾δὸς, ὃ θέλεις, ἀπόλαβε, ὃ θέλεις᾿᾿. Λέγει δὲ τοῦτο οὐ καταθρασυνόμενος, ἀλλὰ πειθαρχῶν μόνον καὶ εὐνοῶν αὐτῇ.

Altro testo in italiano. . .

Altro testo in italiano\dots

e si può inserire un testo breve o brevissimo all’interno di un capoverso scrivendolo nell’argomento di un comando \greco definito ad hoc: \newcommand{\greco}[1]{\foreignlanguage{greek}{#1}}

da usare come segue: In lettere minuscole, \TeX{} si scriverebbe \greco{teq}. È la radice della parola greca \greco{t’eqnh} che vuol dire ‘‘arte’’ e ‘‘mestiere’’.

c.2.1

In lettere minuscole, TEX si scriverebbe τεχ. È la radice della parola greca τέχνη che vuol dire “arte” e “mestiere”.

La traslitterazione dei caratteri

Il greco antico

Come si può osservare negli esempi precedenti, il testo sorgente “in greco” è un insieme di caratteri latini e altri segni (tutti conosciuti, ma qui con funzioni diverse) che poco assomiglia a ciò che si vede a destra.

Lo si è scritto, infatti, con il metodo più immediato per chi possiede una tastiera italiana, cioè la traslitterazione dei caratteri. La figura 22 mostra (in blu) come l’opzione greek di babel interpreta i caratteri latini (alfabetici e non) che hanno una corrispondenza in greco. Tutti gli altri, compresi i caratteri speciali di LATEX, sono uguali nelle due lingue (per

c.2 scrivere in greco

Tabella 57: Diacritici e punteggiatura del greco antico.

Segno Accento Spirito Coronide Dieresi Iota sottoscritto Apostrofo Punto

acuto grave circonflesso dolce aspro

in alto e virgola

Codice

Esempio

Risultato

’ ‘

’w ‘w ~w >w <w t>~alla "i w| d" >eg’w

ώ ὼ ῶ ὠ ὡ τἆλλα ϊ ῳ δ’ ἐγώ · ;

~ > < > " | " ; ?

227

la tilde, però, si veda sotto). Si noti che la lettera italiana v non ha un corrispettivo greco perché è una specie di “carattere greco speciale”: la scrittura sv, infatti, è l’unico modo per ottenere un sigma iniziale o mediale isolato σv, altrimenti interpretato dal programma sempre come finale ς.

La tabella 57 raccoglie i segni di punteggiatura e i diacritici necessari per scrivere in greco. Si noti che: • i font greci predefiniti permettono di combinare i diacritici in tutti i modi previsti dalla grammatica, premettendoli a una lettera in una sequenza qualsiasi; • l’unico diacritico da posporre alla lettera è lo iota sottoscritto; • il carattere " nel testo sorgente restituisce un apostrofo soltanto se seguito da uno spazio (mantenuto anche nel testo composto, a differenza dell’italiano): " ; • il carattere ~, che in greco produce l’accento circonflesso, potrebbe talvolta produrre il consueto spazio indivisibile (che in greco si ottiene con \nobreakspace ), nelle seguenti sequenze: ~, ~", "~, ~<, <~, ~> e >~. Si risolve il problema premettendo a ciascuna una barra rovescia \ e caricando nel preambolo il file lgraccents-glyphs.def con il comando \input ;

\nobreakspace

• il greco antico non prevedeva nella scrittura virgolette e apici, che si possono comunque ottenere con i codici ((h. . .i)) per i caporali, <<h. . .i>> per le virgolette alte e ‘‘h. . .i’’ per gli apici.

L’opzione greek di babel definisce ulteriori caratteri utili per scopi particolari:

• i caratteri minuscoli per indicare alcuni numeri (il qoppa ϟ ottenuto con \qoppa per il numero 6, lo stigma ϛ con \stigma per il 90 e il sampi ϡ con \sampi per il 900); quelli per il digamma minuscolo ϝ, ottenuto con \ddigamma e maiuscolo Ϝ, ottenuto con \Digamma ; il carattere ϛ, ottenuto con \vardigamma ;

\qoppa \stigma \sampi \ddigamma \Digamma \vardigamma

• l’apice ʹ e il pedice ͵ per scrivere i numerali, ottenuti rispettivamente con \anwtonos e \katwtonos .

\anwtonos \katwtonos

228

\greeknumeral \Greeknumeral

latex per gli umanisti

Infine definisce i due comandi \greeknumeral e \Greeknumeral , che producono automaticamente il numero arabo scritto nel loro argomento (da 1 a 999 999, in greco lo zero non esisteva) nel corrispondente numero greco secondo il sistema di numerazione alfabetico, minuscolo e maiuscolo rispettivamente (ma si noti che qoppa, stigma e sampi vengono stampati sempre minuscoli): \begin{otherlanguage*}{greek} \greeknumeral{996} \\ \Greeknumeral{123} \end{otherlanguage*}

ϡϟϛʹ ΡΚΓʹ

Il greco moderno Dai primi anni Ottanta del secolo scorso, in Grecia il sistema politonico ha lasciato il posto a quello monotonico, che nella varietà scritta presenta un solo accento (dipende dalle scelte tipografiche degli editori, ma di solito è quello acuto).

Quest’ortografia, dunque, è molto più semplice dell’altra, bastando soltanto altri due caratteri oltre alle lettere e ai consueti moderni segni d’interpunzione: • ’ per l’accento acuto; • " (seguito da uno spazio) per ottenere l’apostrofo, oppure " seguito da uno iota o un upsilon (minuscoli o maiuscoli) per ottenere la dieresi sopra di essi.

Si dichiara nel preambolo caricando babel senza alcun attributo:2 \usepackage[greek,italian]{babel}

e un testo in questa varietà di greco appare così: \begin{otherlanguage*}{greek} Pr’epei na skefto’ume mia sun’arthsh ths opo’ias gnwr’izoume ’oti up’arqei to olokl’hrwma. \end{otherlanguage*}

c.2.2

Πρέπει να σκεφτούμε μια συνάρτηση της οποίας γνωρίζουμε ότι υπάρχει το ολοκλήρωμα.

Scrivere in greco nel sorgente

Il modo appena descritto per scrivere in greco non è particolarmente difficile: la corrispondenza di lettere e diacritici sulla tastiera si memorizza in poco tempo, ma la traslitterazione rende comunque il testo sorgente difficile da leggere, specie per chi il greco lo conosce.

Quando in un documento le parti in greco sono lunghe o lunghissime (o quando il documento è in greco per intero) poterle scrivere direttamente in lingua diventa una comodità quasi irrinunciabile. I metodi per farlo sono più d’uno: si può usare una tastiera bilingue o 2 Si noti che nonostante greek preveda tre distinti schemi di sillabazione per il greco (due per il greco politonico, antico e moderno, e uno per il greco monotonico), di fatto babel usa sempre quello per il greco politonico antico.

c.2 scrivere in greco

una tastiera virtuale che non richieda di ricordare tutti gli abbinamenti, oppure si può ridefinire allo scopo i tasti di una tastiera italiana (con i modi propri di ogni sistema operativo). Qualunque metodo si scelga tra quelli spiegati in questo paragrafo, l’editor un uso deve supportare la codifica Unicode.

Se si intende compilare il documento con LATEX usando i font greci predefiniti, bisogna cambiare la codifica di immissione dei caratteri sostituendo a utf8 la variante utf8x, che richiede di caricare immediatamente prima di sé il pacchetto ucs. Per riprodurre l’esempio iniziale scrivendo davvero in greco, il codice diventa:

229

Scrivere direttamente in greco con LATEX. . .

\documentclass[a4apaper]{article} \usepackage[T1]{fontenc} \usepackage{ucs} \usepackage[utf8x]{inputenc} \usepackage[greek,italian]{babel} \languageattribute{greek}{polutoniko} \begin{document} \begin{otherlanguage*}{greek}

Τῃ πάντα διδούσῃ καὶ ἀπολαμβανούσῃ φύσει ὁ πεπαιδευμένος καὶ αἰδήμων λέγει· ῾῾δὸς, ὃ θέλεις, ἀπόλαβε, ὃ θέλεις᾿᾿. Λέγει δὲ τοῦτο οὐ καταθρασυνόμενος, ἀλλὰ πειθαρχῶν μόνον καὶ εὐνοῶν αὐτῃ. \end{otherlanguage*} \end{document}

E

\documentclass[a4paper]{article} \usepackage{fontspec} \setmainfont{Linux Libertine O} \usepackage{polyglossia} \setmainlanguage{italian} \setotherlanguage[variant=ancient]{greek} \begin{document} \begin{greek}

Τῃ πάντα διδούσῃ καὶ ἀπολαμβανούσῃ φύσει ὁ πεπαιδευμένος καὶ αἰδήμων λέγει· ῾῾δὸς, ὃ θέλεις, ἀπόλαβε, ὃ θέλεις᾿᾿. Λέγει δὲ τοῦτο οὐ καταθρασυνόμενος, ἀλλὰ πειθαρχῶν μόνον καὶ εὐνοῶν αὐτῃ. \end{greek} \end{document}

Si noti che: • il pacchetto fontenc è sostituito da fontspec, che gestisce i font del sistema in modo molto potente;

• il pacchetto inputenc non va caricato, perché XELATEX lavora con la codifica utf-8 per impostazione predefinita;

• \setmainfont imposta il font principale del documento con le eventuali opzioni (qui si è scelto il font Linux Libertine, già presente nel sistema e dotato di una collezione completa di font greci);

. . . o con X LATEX E

L’alternativa è compilare il documento con il programma X LATEX (di solito basta sceglierlo tra le preferenze dell’editor in uso), che richiede un preambolo come il seguente:

230

latex per gli umanisti

• il pacchetto babel è sostituito da polyglossia;

• \setmainlanguage imposta la lingua principale del documento con le eventuali opzioni; • \setotherlanguage carica la o le altre lingue del documento con le eventuali opzioni (in questo caso il greco antico nella variante ancient, cioè politonico);3 • l’ambiente greek equivale a otherlanguage*{greek}.

Entrambe queste ultime possibilità, però, presentano una limitazione: i pacchetti ucs e biblatex non sono attualmente compatibili tra loro, e usando XELATEX microtype non svolge per intero le sue funzioni: infatti permette soltanto la protrusione dei caratteri, ma non la microgiustificazione e altre finezze (si noti che quest’ultima osservazione vale soltanto per le parti in italiano).

Per maggiori dettagli si consiglia la lettura di [Gregorio, 2011]. c.2.3

Documenti interamente in greco

Chi dovesse scrivere un documento completamente in greco (seguendo indifferentemente l’una o l’altra ortografia) può contare su qualche agevolazione in più. L’opzione greek di babel, infatti: • definisce due comandi per convertire automaticamente la data corrente nella corrispondente data greca: \dategreek la stampa con i numerali arabi (9 ᾿Απριλίου 2011), \Grtoday con i numerali alfabetici (Θʹ ᾿Απριλίου ͵ΒΙΑʹ);

\dategreek \Grtoday

• traduce in greco le voci automatiche delle classi di documento standard in accordo con l’ortografia dichiarata nel preambolo: Indice diventa Εὑρετήριο in greco politonico, ma Ευρετήριο in greco monotonico, per esempio; • definisce altri due comandi utili: \euro , che produce il simbolo dell’euro e e \permill , che produce il simbolo di per mille ‰.

\euro \permill

Si fornisce infine il preambolo tipo per comporre un documento in italiano e greco o nel solo greco con LATEX (le righe sono numerate per necessità pratiche). Si noti che: • va indicata obbligatoriamente una sola tra le righe 5 e 6 a seconda della o delle lingue del documento; • la riga 8, invece, va messa subito dopo babel soltanto per sfruttarne la corretta traduzione delle voci automatiche.

1 2 3

\documentclass[a4paper]{article} \usepackage[T1]{fontenc} \usepackage[utf8]{inputenc}

4

3 Vale la pena di ricordare che, a differenza di babel, polyglossia carica effettivamente la sillabazione corrispondente alla variante indicata: ancient (o poly) per il greco politonico, mono per quello monotonico.

5 6

\usepackage[greek,italian]{babel} \usepackage[greek]{babel}

c.2 scrivere in greco

231

7 8

\languageattribute{greek}{polutoniko}

9 10 11 12

\begin{document} ... \end{document}

Naturalmente le osservazioni di questo paragrafo valgono anche per XELATEX: basterà modificare il preambolo esemplificato nel paragrafo C.2.2 a pagina 228 impostando il greco come lingua principale del documento con \setmainlanguage[hopzionii]{greek}. c.2.4

Il pacchetto teubner

Chi avesse la necessità di comporre documenti in greco di altro tipo (in particolare linguistici, filologici e letterari), può rivolgersi al pacchetto teubner, che comprende una collezione di caratteri inclinati particolarmente raffinati, disegnati originariamente nella tipografia Teubner di Lipsia (in onore della quale è stato scelto il nome del pacchetto), e tra le altre cose permette di regolare molto finemente le combinazioni dei diacritici sulle lettere e le legature tra i caratteri.

Si raccomanda infine di caricare teubner dopo amsmath, se dovesse servire anche quest’ultimo pacchetto. Per maggiori dettagli si rimanda alla sua documentazione.

teubner

ACRONIMI

AMS

American Mathematical Society Fondata nel 1888, la “Società Matematica Americana” è una delle più importanti associazioni di matematici nel mondo, con varie decine di migliaia di soci. L’AMS ha sostenuto attivamente lo sviluppo di LATEX ed è stata tra i primi organismi scientifici a sollecitare gli autori a scrivere con questo programma.

ascii

American Standard Code for Information Interchange Il “codice standard americano per lo scambio di informazioni” è un sistema di codifica dei caratteri proposto nel 1961 e comunemente impiegato nei calcolatori.

bmp

Windows bitmap È un formato di file per la rappresentazione di immagini a mappa di bit nei sistemi operativi Microsoft Windows e OS/2. Fu introdotto con Windows 3.0 nel 1990. I file bmp possono essere compressi senza perdita di informazioni (ossia in modo lossless) oppure possono non essere compressi affatto.

ctan

Comprehensive TEX Archive Network La “rete di archivi completi di TEX” è, nel Web, il luogo di riferimento da cui scaricare software e materiale su TEX e LATEX.

dvi

DeVice Independent È il formato di output “indipendente dal dispositivo” generato da LATEX.

eps

Encapsulated PostScript È un formato per immagini di tipo PostScript (un linguaggio di descrizione della pagina sviluppato dalla Adobe). Rispetto al PostScript, un’immagine eps contiene alcune restrizioni che la rendono adatta a essere inclusa (“incapsulata”) in un documento, come l’informazione sulle dimensioni del rettangolo circoscritto all’immagine effettiva (bounding box). L’eps è il formato standard delle figure da includere in un documento da compilare con LATEX.

fifo

First In First Out L’espressione (“primo a entrare, primo a uscire”) indica un particolare modo di immagazzinare gli oggetti, per cui il primo oggetto inserito è anche il primo a uscire. LATEX gestisce gli oggetti mobili proprio così: se una figura o una tabella non può essere messa nella pagina corrente, viene accumulata nella relativa coda.

Si contrappone alla modalità lifo (Last In First Out, “ultimo arrivato, primo a uscire”), in cui è l’ultimo oggetto inserito a essere restituito per primo.

gif

Graphics Interchange Format È un formato per immagini di tipo bitmap molto diffuso nel Web e usato anche per le animazioni. Esegue una compressione senza perdita di informazioni (cioè di tipo lossless).

233

234

acronimi

gml

Generalized Markup Language Nato nel 1969, il “linguaggio di marcatura generalizzato” è stato inventato per gestire testi strutturati di grandi dimensioni e ha influenzato direttamente LATEX, che ne ha adottato alcune idee.

gnome

gnu Network Object Model Environment È l’interfaccia grafica ufficiale del progetto gnu per sistemi operativi Unix/Linux.

gnu

gnu’s Not Unix È un acronimo ricorsivo che significa “gnu non è Unix”. Il progetto, lanciato nel 1983 da Richard Stallman, si basa sulla gestione dei diritti d’autore improntata al concetto di software libero.

gui

Graphical User Interface Nei moderni sistemi operativi, l’ “interfaccia grafica per l’utente” è una modalità di interazione tra utente e calcolatore che permette al primo di interagire con il secondo manipolando oggetti grafici (come icone e finestre) attraverso un puntatore comandato con un mouse (o con un dispositivo analogo). Si contrappone alla modalità cli (Command Line Interface, “interfaccia a riga di comando”), nella quale l’interazione avviene tramite comandi testuali dati dalla tastiera.

Questo ambiente di lavoro, introdotto per la prima volta nei laboratori Xerox (progetto Alto), venne sviluppato dalla Apple, che lo applicò al mondo dei personal computer e lo commercializzò nel 1983 con il Lisa e nel 1984 con il Macintosh. In seguito al successo del Macintosh, è stato adottato anche da Microsoft con Windows.

guIt

Gruppo Utilizzatori Italiani di TEX e LATEX È un’associazione senza fini di lucro con lo scopo di aumentare la diffusione di TEX e LATEX in Italia attraverso la condivisione di informazioni legate al loro uso, conciliando il vantaggio dell’apprendimento con il piacere dell’insegnamento.

html

Hyper Text Mark-up Language Il “linguaggio di marcatura degli ipertesti” è un linguaggio di pubblico dominio inventato nel 1989 al cern di Ginevra da Tim BernersLee per descrivere i documenti ipertestuali che popolano il Web.

iso

International Standard Organization L’ “organizzazione internazionale per le standardizzazioni” è la più importante associazione a livello mondiale per la definizione di standard tecnico-scientifici. Suoi membri sono gli organismi nazionali di standardizzazione di 157 Paesi del mondo.

jpeg

Joint Photographic Experts Group È lo standard di compressione delle immagini fotografiche più usato. Esegue una compressione con perdita di informazioni (cioè di tipo lossy). Insieme con il png, è il formato standard delle immagini bitmap da inserire in un documento da compilare con pdfLATEX.

kde

K Desktop Environment È un’interfaccia grafica per sistemi operativi Unix/Linux, caratterizzata da un elevato grado di personalizzazione.

pdf

Portable Document Format

acronimi

È il formato di file più versatile per la stampa e la distribuzione elettronica, introdotto dalla Adobe Systems nel 1993 per rappresentare documenti indipendentemente dall’hardware e dal software usati per generarli o visualizzarli. Il pdf eredita molte delle funzioni del PostScript, un linguaggio di descrizione della pagina sviluppato dalla stessa azienda. È il formato standard delle immagini vettoriali da inserire in un documento da compilare con pdfLATEX.

png

Portable Network Graphics Creato nel 1995, è un formato di file per immagini particolarmente adatto per rappresentare disegni e icone. Esegue una compressione senza perdita di informazioni (cioè di tipo lossless). Insieme con il jpg, è il formato standard delle immagini bitmap da inserire in un documento da compilare con pdfLATEX.

ps

PostScript È un linguaggio di descrizione della pagina sviluppato dalla Adobe.

Il PostScript ha costituito la base su cui è stato sviluppato il formato pdf.

sgml

Standard Generalized Mark-up Language Nato nel 1978 direttamente dal gml, il “linguaggio di marcatura generalizzato standard” ha costituito la base per lo sviluppo dei successivi html e xml.

svg

Scalable Vector Graphics È un formato di file derivato dall’xml, progettato per memorizzare immagini vettoriali (e dunque “scalabili” nelle dimensioni).

tiff

Tagged Image File Format È un formato per immagini di tipo bitmap sviluppato da Microsoft e Aldus che permette di specificare numerose indicazioni aggiuntive (per esempio informazioni sulla calibratura del colore) con apposite etichette (tag). Le specifiche del formato tiff permettono una notevole flessibilità: ciò di per sé è un vantaggio, ma rende difficile scrivere un interprete pienamente conforme alle sue specifiche. I file .tiff possono usare diversi algoritmi di compressione senza perdita di informazioni (cioè di tipo lossless) oppure possono non essere compressi affatto.

tug

TEX User Group L’espressione (“gruppo di utenti di TEX”) indica le associazioni di persone accomunate dalla passione per TEX e LATEX sparse nei principali Paesi del mondo. Il loro scopo è quello di diffondere l’uso di questi due programmi e di fornire supporto alle rispettive comunità di utenti.

uni

Ente Nazionale Italiano di Unificazione È un’associazione privata senza scopo di lucro che svolge attività normativa in tutti i principali settori tecnico-scientifici. Rappresenta l’Italia all’attività normativa dell’organismo internazionale di standardizzazione iso.

235

236

acronimi

url

Uniform Resource Locator

È una stringa di caratteri che identifica in modo univoco l’indirizzo di una qualunque risorsa in Rete. Ogni url (per esempio http://www.guit.sssup.it/forum/) si compone normalmente di tre parti: il protocollo usato per indirizzare la risorsa (http, nell’esempio considerato), il nome dell’host o del server o del dominio (www.guit.sssup.it), e infine il nome del file della risorsa (/forum/).

utf

Unicode Transformation Format Unicode è un sistema di codifica che assegna una combinazione di bit a ogni carattere indipendentemente da programma, piattaforma e lingua usati. La codifica utf-8 (Unicode Transformation Format, 8 bit) è una particolare realizzazione di Unicode.

wysiwyg What You See Is What You Get L’espressione indicata dall’acronimo (“ciò che vedi è ciò che ottieni”) ha sostanzialmente due significati.

Il primo si riferisce al problema di ottenere in stampa testo e immagini che abbiano una disposizione grafica uguale a quella visualizzata sullo schermo del calcolatore. I primi software e le prime stampanti per uso domestico non davano risultati pienamente soddisfacenti e si superò il problema introducendo nuovi dispositivi e software (pionieri furono il sistema di codifica dei caratteri TrueType sviluppato dalla Apple e il programma Adobe TypeManager).

Con il tempo, il significato dell’acronimo si è esteso per analogia anche ad alcune problematiche connesse alla creazione dei documenti.

Nei comuni elaboratori di testo (come per esempio Microsoft Word), l’autore agisce direttamente sul testo già composto così come appare sullo schermo del suo elaboratore, e ogni sua azione si traduce in un’immediata variazione di quel testo. Programmi di questo tipo vengono detti wysiwyg (in questo secondo significato), e il tipo di composizione che adottano viene denominato “composizione sincrona”. L’acronimo che si riferisce al concetto opposto è wysiwym.

wysiwym What You See Is What You Mean L’acronimo (“ciò che vedi è ciò che intendi”) è stato coniato espressamente per LATEX in contrapposizione all’acronimo wysiwyg (nel senso di “programma di videoscrittura caratterizzato da una composizione sincrona”).

La caratteristica che più differenzia LATEX dagli altri elaboratori di testo è il fatto che per realizzare un documento con questo programma bisogna agire in tempi diversi per introdurre il testo e per comporlo. È la “composizione asincrona”: prima si scrive il testo badando soltanto a contenuto e scansione logica; poi lo si dà “in pasto” a LATEX, che lo compila e lo impagina per produrre il documento finito.

yap

Yet Another Previewer È un programma che legge i file dvi generati da LATEX. È integrato nella distribuzione MiKTEX per Windows.

xml

eXtensible Mark-up Language Nato nel 1998 come semplificazione e adattamento dell’sgml, il “linguaggio di marcatura estensibile” è un metalinguaggio, ovvero un linguaggio che permette di definire la grammatica di diversi linguaggi specifici derivati.

ELENCO DEI SITI INTERNET

adobe gnuplot Sito ufficiale della Adobe SySito ufficiale di Gnuplot. stems Inc. http://www.gnuplot.info/ http://www.adobe.com/it/

aquamacs Sito ufficiale di Aquamacs. http://aquamacs.org/

charco Sito ufficiale di Charco. http://www.marblesoftware. com/Marble_Software/ Charco.html

ctan Sito ufficiale di ctan. http://www.ctan.org/

editors Pagina Web comparativa dei pi첫 diffusi editor per LATEX. http://en.wikipedia.org/ wiki/Comparison_of_text_ editors

emacs Pagina Web di Emacs. http://www.gnu.org/software/ emacs/

imagemagick Sito ufficiale di Imagemagick. http://www.imagemagick. org/

inkscape Sito ufficiale di Inkscape. http://www.inkscape.org/

kile Pagina Web di Kile. http://kile.sourceforge. net/

knuth Sito ufficiale di Donald Ervin Knuth. http://www-cs-faculty. stanford.edu/~knuth/

lamport Sito ufficiale di Leslie Lamport. http://research.microsoft. com/en-us/um/people/ lamport/

escher Sito ufficiale di Maurits Cor- iconv Pagina Web di iconv. nelis Escher. http://www.mcescher.com/

http://www.gnu.org/ software/libiconv/

ghost Pagina Web di Ghostscript, mactex Sito ufficiale di MacTEX. Ghostview e GSview. http://pages.cs.wisc.edu/ ~ghost/

gimp Sito ufficiale di GIMP. http://www.gimp.org/

guit Sito ufficiale del guIt.

http://www.guit.sssup.it/

http://www.tug.org/mactex/

mathematica Pagina Web di Mathematica. http://www.wolfram.com/ products/mathematica/

miktex Sito ufficiale di MiKTEX. http://miktex.org/

237

238

elenco dei siti internet

mirrors Elenco dei mirror ctan.

http://www.ctan.org/ tex-archive/CTAN.sites

openoffice Sito ufficiale di OpenOffice.

texlive Sito ufficiale di TEX Live.

http://www.tug.org/texlive/

texmaker Pagina Web di Texmaker. http://www.xm1math.net/ texmaker/

http://it.openoffice.org/

omnigraffle Pagina Web di OmniGraffle.

texmakerx Pagina Web di TexMakerX. http://texmakerx.sourceforge. net/

http://www.omnigroup.com/ applications/omnigraffle/

protext Sito ufficiale di proTEXt.

texshop Pagina Web di TEXShop.

http://www.uoregon.edu/ ~koch/texshop/

http://www.tug.org/protext/

uniroma2 Il mirror ctan predefinito per lâ&#x20AC;&#x2122;Italia.

texworks Pagina Web di TEXworks.

http://www.tug.org/texworks/

http://ftp.uniroma2.it

sarovar Catalogo LATEX online.

http://texcatalogue. sarovar.org/

skim Pagina Web di Skim.

texniccenter Sito ufficiale di TEXnicCenter. http://www.texniccenter. org/

tlmgr Pagina Web di tlmgr.

http://skim-app.sourceforge. net/

sumatra Pagina Web di Sumatra PDF. http://blog.kowalczyk. info/software/sumatrapdf/ index.html

switch Il mirror svizzero di ctan. ftp://mirror.switch.ch/ mirror/tex

http://www.tug.org/texlive/ tlmgr.html

winedt Sito ufficiale di WinEdt. http://www.winedt.org/

winfig Pagina Web di WinFIG. http://www.schmidt-web-berlin. de/winfig/

xfig Sito ufficiale di Xfig. http://www.xfig.org/

BIBLIOGRAFIA

American Mathematical Society 1999 Manuale d’uso del pacchetto amsmath, http://www.ctan.org/ tex-archive/info/italian/amsldoc/itamsldoc.pdf.

Beccari, Claudio 2010 Introduzione all’arte della composizione tipografica con LATEX, http://www.guit.sssup.it/downloads/GuidaGuIT.pdf. (Citato alle pp. 4, 50, 85.)

Bringhurst, Robert 1992 The Elements of Typographic Style, Hartley & Marks, Vancouver, (edizione italiana a cura di Lucio Passerini, Gli Elementi dello Stile Tipografico, Sylvestre Bonnard, Milano 2001). (Citato a p. 57.)

Busdraghi, Fabiano 2003 Documentazione del pacchetto layaureo, http://www.guit. sssup.it/downloads/layaureo.pdf.

Caucci, Luca e Mariano Spadaccini 2005 Gestione di figure e tabelle con LATEX, http://www.guit.sssup. it/downloads/fig_tut.pdf. (Citato a p. 139.)

Cevolani, Gustavo 2006 “Norme tipografiche per l’italiano in LATEX”, ArsTEXnica, 1, http://www.guit.sssup.it/arstexnica/download_ars/ arstexnica01.pdf. (Citato a p. 195.)

Eco, Umberto 1977 Come si fa una tesi di laurea. Le materie umanistiche, Bompiani, Milano. (Citato alle pp. 166, 167.)

Fairbairns, Robin 2010 The uk TEX faq, http://www.tex.ac.uk/tex-archive/help/ uk-tex-faq/newfaq.pdf. (Citato alle pp. 59, 85, 206, 212.)

Fear, Simon 2005 Publication quality tables in LATEX, Manuale d’uso del pacchetto booktabs, http://www.ctan.org/tex-archive/macros/ latex/contrib/booktabs/booktabs.pdf. (Citato a p. 120.)

Flynn, Peter 2005 “In my opinion”, PracTEX Journal, 1, http://tug.org/ pracjourn/2005-1/flynn/. (Citato a p. 8.)

Goossens, Michel, Frank Mittelbach e Johannes Braams 2004 The LATEX Companion, Addison-Wesley, Reading (Massachusetts).

239

bibliografia

Gregorio, Enrico 2003 Galleria degli orrori. Come maltrattare LATEX e rendere infelice un copy editor, http://profs.sci.univr.it/~gregorio/orrori. pdf. (Citato a p. 205.)

2009 Appunti di programmazione in LATEX e TEX, http://profs.sci. univr.it/~gregorio/introtex.pdf. (Citato a p. 182.)

2010 LATEX. Breve guida ai pacchetti di uso più comune, http: //profs.sci.univr.it/~gregorio/breveguida.pdf. (Citato alle pp. 46, 132, 139, 150.) http://profs.sci.univr.it/ 2011 Introduzione a X LATEX, ~gregorio/introxelatex.pdf. (Citato a p. 230.)

E

240

Guiggiani, Massimo e Lapo Filippo Mori 2008 “Consigli su come non maltrattare le formule matematiche”, ArsTEXnica, 5, http://www.guit.sssup.it/arstexnica/ download_ars/arstexnica05.pdf. (Citato alle pp. 85, 214, 218.)

Knuth, Donald Ervin 1973 Computer Programming as an Art, Addison-Wesley, Reading (Massachusetts), vol. 3. (Citato a p. xvii.)

1984 The TEXbook, Addison-Wesley, Reading (Massachusetts).

Lamport, Leslie 1994 LATEX. A Document Preparation System, Addison-Wesley, Reading (Massachusetts).

Lehman, Philipp 2011 The biblatex package, http://www.ctan/org/tex-archive/ macros/latex/exptl/biblatex/doc/biblatex.pdf. (Citato alle pp. 157, 166.)

Lesina, Roberto 2004 Il Nuovo Manuale di Stile, edizione 2.0, con la collaborazione di Federico Boggio Merlo, Zanichelli, Bologna. (Citato a p. 195.)

Mittelbach, Frank, Gianluca Pignalberi e Dave Walden 2007 “Intervista a Frank Mittelbach”, ArsTEXnica, 3, http://www. guit.sssup.it/arstexnica/download_ars/arstexnica03. pdf. (Citato a p. 7.)

Mori, Lapo Filippo 2006 “Tabelle su LATEX 2ε : pacchetti e metodi da utilizzare”, ArsTEXnica, 2, http://www.guit.sssup.it/arstexnica/ download_ars/arstexnica02.pdf. (Citato a p. 120.)

2007 “Scrivere la tesi di laurea con LATEX 2ε ”, ArsTEXnica, 3, http://www.guit.sssup.it/arstexnica/download_ars/ arstexnica03.pdf. (Citato alle pp. 55, 139.)

2008 “Gestire la bibliografia con LATEX”, ArsTEXnica, 6, http://www. guit.sssup.it/arstexnica/download_ars/arstexnica06. pdf. (Citato a p. 157.)

bibliografia

Mori, Lapo Filippo e Maurizio Himmelmann 2007 “Scrivere il curriculum vitae”, ArsTEXnica, 4, http://www.guit. sssup.it/arstexnica/download_ars/arstexnica04.pdf.

Oetiker, Tobias et al.

2010 The Not So Short Introduction to LATEX 2ε , http://www.ctan. org/tex-archive/info/lshort/english/lshort.pdf. (Citato alle pp. 7, 48, 49, 110.)

Pakin, Scott 2009 The Comprehensive LATEX Symbol List, http://www.ctan. org/tex-archive/info/symbols/comprehensive/symbolsa4.pdf. (Citato alle pp. 66, 110.)

Pantieri, Lorenzo 2007 “Introduzione

allo

stile

ClassicThesis”,

ArsTEXnica,

http://www.guit.sssup.it/arstexnica/download_ars/ arstexnica06.pdf. (Citato alle pp. 29, 58, 67.)

6,

2009 “L’arte di gestire la bibliografia con biblatex”, ArsTEXnica, 8, http://www.guit.sssup.it/arstexnica/download_ars/ arstexnica08.pdf.

2010 Manuale d’uso del pacchetto ArsClassica, http://www.ctan.org/ tex-archive/macros/latex/contrib/arsclassica/Italian/ ArsClassica.pdf. (Citato a p. 194.)

Pantieri, Lorenzo e Tommaso Gordini 2009 L’arte di fare una presentazione con beamer, http://www. lorenzopantieri.net/LaTeX_files/Presentazioni.pdf.

Sabatini, Francesco e Vittorio Coletti 1997 il Sabatini Coletti. Dizionario della Lingua Italiana, Giunti Gruppo Editoriale, Firenze.

Serianni, Luca 1989 Grammatica italiana. Italiano comune e lingua letteraria, con la collaborazione di Alberto Castelvecchi, utet, Torino.

Tantau, Till 2007 The beamer class, Manuale d’uso della classe beamer, http://www.ctan.org/tex-archive/macros/latex/contrib/ beamer/doc/beameruserguide.pdf.

Trettin, Mark e Emanuele Zannarini 2005 Elenco dei “peccati” degli utenti di LATEX 2ε o Comandi, pacchetti obsoleti ed errori da evitare, ftp://ftp.dante.de/tex-archive/ info/l2tabu/italian/l2tabuit.pdf. (Citato alle pp. 59, 85, 206, 212.)

Valbusa, Ivan 2010 Guida agli stili philosophy-classic e philosophy-modern, http://www.ctan.org/pub/tex-archive/macros/latex/ exptl/biblatex-contrib/biblatex-philosophy/doc/ biblatex-philosophy.pdf. (Citato a p. 169.)

241

242

bibliografia

Wilson, Peter 2010 The memoir class, Manuale dâ&#x20AC;&#x2122;uso della classe memoir, http: //www.ctan.org/tex-archive/macros/latex/contrib/ memoir/memman.pdf. (Citato a p. 57.)

Zannarini, Emanuele e Emiliano Giovanni Vavassori 2005 LATEX e i font: installazione pratica, http://www.guit.sssup.it/ guitmeeting/2005/articoli/zannarini-vavassori.pdf. (Citato a p. 192.)

INDICE ANALITICO

A

\AA, 65 \aa, 65 \abs, 91 abstract, 30 \abstractname, 187

Accenti in matematica, 92, 110 nel testo, 65, 195 Acronimi, 55, 77 \acute, 110 \addcontentsline, 56, 64 \addtocategory, 173 \adjustmtc, 57 Adobe Acrobat, 141 Adobe Reader, 140â&#x20AC;&#x201C;142 \AE, 65, 223 \ae, 65, 223 Albero personale, 34, 179 \aleph, 114 align, 100, 101, 213 align*, 101 aligned, vii, 101 \alpha, 110 alphabetic, 164 \alsoname, 187 \amalg, 111 \AmS, 64 \and, 66 \angle, 114 Anteprima, 141, 142 \anwtonos, 227 \ap, 65 \appendix, 27, 54 \appendixname, 187 \approx, 111 \approxeq, 115 Aquamacs, 17 \arccos, 95 \arcsin, 95 \arctan, 95 \arg, 95 array, 117, 119, 122, 123, 147 \arraybackslash, 132 \Arrowvert, 112

\arrowvert, 112 \Ars, 26, 64 \arsinh, 95 \ast, 111 \asymp, 111

Asymptote, 139

\author, 66 authortitle, 164 authoryear, 164

B \b, 65 \backepsilon, 115 \backmatter, 54 \backprime, 114 \backsim, 115 \backsimeq, 115 \backslash, 112 \bar, 90, 110, 216 \barwedge, 115 \Bbbk, 114 \because, 115 \beta, 110 \beth, 114 \between, 115 \bfseries, 189 \bibitem, 156 \bibliography, 166, 168 \bibname, 156, 187 \Big, 96 \big, 96 \bigcap, 112 \bigcirc, 111 \bigcup, 112 \Bigg, 96 \bigg, 96 \Biggl, 96 \biggl, 96, 214 \Biggr, 96 \biggr, 96, 214 \Bigl, 96 \bigl, 96 \bigodot, 112 \bigoplus, 112 \bigotimes, 112

243

244

indice analitico

\Bigr, 96 \bigr, 96 \bigskip, 50 \bigstar, 114 \bigtriangledown, 111 \bigtriangleup, 111 \biguplus, 112 \bigvee, 112 \bigwedge, 112 \binom, 97, 216 \blacklozenge, 114 \blacksquare, 114 \blacktriangle, 114 \blacktriangledown, 114 \blacktriangleleft, 115 \blacktriangleright, 115 \bm, 98, 103 Bmatrix, 98 bmatrix, 98 \bmod, 95 \bot, 114 \bottomrule, 121, 207

bounding box, 140

\bowtie, 111 \Box, 114 \boxdot, 115 \boxminus, 115 \boxplus, 115 \boxtimes, 115 \Bra, 97 \bracevert, 112 \Braket, 97 \breve, 110 \bullet, 111 \Bumpeq, 115 \bumpeq, 115

C \c, 65 \Cap, 115 \cap, 111 \caption, 146, 147, 150, 211 cases, 102, 215 \ccname, 187 CD, 108 \cdot, 111 \cdots, 114 center, 119, 147, 210 \centerdot, 115 \centering, 132, 147, 210 \chapter, 47, 54, 57 \chapter*, 56, 57

\chaptername, 187

Charco, 237

\check, 110 \chi, 110 \circ, 111 \circeq, 115 \circlearrowleft, 113 \circlearrowright, 113 \circledast, 115 \circledcirc, 115 \circleddash, 115 \circledS, 114 \cite, 37, 157, 159, 166, 167 \citeauthor, 167 \citep, 167 \citet, 167 \citeyear, 167

Classe article, 29, 30, 37, 38, 54, 64, 156, 168, 177 beamer, 29, 241 book, 29, 30, 37, 54, 64, 156, 168, 177 examdesign, 29 KOMA-Script, 29, 67, 150 letter, 29, 54 memoir, 29, 242 report, 29, 30, 37, 64, 156, 168, 177 toptesi, 29 ClassicThesis, ii, xv, 29, 67 \cleardoublepage, 81, 149, 156 \clearpage, 81, 149, 156, 169 \clubsuit, 114 \cmidrule, 129 Codifica dei font, 36, 43 \colon, 92 \columnwidth, 119, 124, 144 comment, 27 \complement, 114 \cong, 111 \contentsname, 187 \coprod, 112 \copyright, 114 \cos, 94, 95 \cosh, 95 \cot, 95 \coth, 95 \cov, 215 \csc, 95 \Cup, 115 \cup, 111

\curlyeqprec, 115 \curlyeqsucc, 115 \curlyvee, 115 \curlywedge, 115 \curvearrowleft, 113 \curvearrowright, 113

D \d, 65 \dag, 114 \dagger, 111 \daleth, 114 \dashleftarrow, 113 \dashrightarrow, 113 \dashv, 111 \date, 66 \dategreek, 230 \ddag, 114 \ddagger, 111 \ddigamma, 227 \ddot, 110 \ddots, 99, 114 \DeclareBibliographyCategory,

173

\DeclareMathOperator, 95, 215 \defbibheading, 173, 175 \deg, 95 \Delta, 110 \delta, 110 description, 71 \det, 95 \dfrac, 104, 130 \DH, 65 \dh, 65 \diagdown, 114 \diagup, 114 \Diamond, 114 \diamond, 111 \diamondsuit, 114 \Digamma, 227 \digamma, 114 \dim, 95 \displaystyle, 103 \div, 111 \divideontimes, 115 \DJ, 65 \dj, 65 \documentclass, 26, 29, 38, 51 \dominitoc, 57 \dot, 110 \Doteq, 115 \doteq, 111

indice analitico

\doteqdot, 115 \dotplus, 115 \dots, 23, 26, 61, 92, 114, 198,

219

\doublebarwedge, 115 \doublecap, 115 \doublecup, 115 doublespace, 59 \doublespacing, 59 \Downarrow, 112, 113 \downarrow, 112, 113 \downdownarrows, 113 \downharpoonleft, 113 \downharpoonright, 113

E \ell, 114

Emacs, 13, 17, 18

\emph, 26 empty, 37 \emptyset, 114 \enclname, 187 enumerate, 71 eps2pdf, 141, 142 \epsilon, 110 epstopdf, 141, 142 \eqcirc, 115 eqnarray, 85 eqnarray*, 85 \eqref, 85, 219 \eqslantgtr, 115 \eqslantless, 115 equation, 85, 100, 101 equation*, 85 \equiv, 111 \eta, 110 \eth, 114 \euro, 65, 230 \exists, 114 \exp, 95

F \fallingdotseq, 115 figure, 144â&#x20AC;&#x201C;147, 152 figure*, 79, 144 \figurename, 187 \Finv, 114 \flat, 114 \FloatBarrier, 149 \footcite, 167 \footnote, 67, 134 \footnotesize, 190, 191

245

246

indice analitico

\forall, 114 \frenchspacing, 53

\gvertneqq, 116

\frontmatter, 54, 56 \frown, 111 \fullcite, 167

\H, 65 \hat, 110 \hbar, 114 headings, 37 \headtoname, 187 \heartsuit, 114 \hline, 121, 207 \hoffset, 206 \hom, 95 \hookleftarrow, 113 \hookrightarrow, 113 \href, 63 \hslash, 114 \hspace, 130 \Huge, 190, 191 \huge, 190, 191 \hypersetup, 62 \hyphenation, 51, 52, 206

Frontespizio, 55, 67

G \Game, 114 \Gamma, 110 \gamma, 110 gather, 100 gather*, 101 gathered, vii, 101 \gb, 183 \gcd, 95 \ge, 111 \geometry, 58 \geq, 111 \geqq, 115 \geqslant, 115 \gets, 113 \gg, 111 \ggg, 115 \gggtr, 115

Ghostscript, 142, 237 Ghostview, 141, 142, 144, 237 \gimel, 114 GIMP, 140, 141, 237 Glossari, 55, 77 \glossaryname, 187 \gnapprox, 116 \gneq, 116 \gneqq, 116 \gnsim, 116 Gnuplot, 18, 141, 237 \graphicspath, 144 \grave, 110 \greco, 226 greek, 230 \Greeknumeral, 228 \greeknumeral, 228 \Grtoday, 230 GSview, 141, 142, 144, 237 \gtrapprox, 115 \gtrdot, 115 \gtreqless, 115 \gtreqqless, 115 \gtrless, 115 \gtrsim, 115 \GuIT, 64 \GuIT*, 64

H

I iconv, 237 \idotsint, 88 \iff, 93, 113 \iiiint, 88 \iiint, 88 \iint, 88 \Im, 114

ImageMagick, 141, 142, 237

\imath, 114 \implies, 93 \in, 89, 111 \include, 40, 41 \includegraphics,

118, 119, 142â&#x20AC;&#x201C;144, 147, 154, 211 \includeonly, 41 \index, 178 \indexname, 187 Indice generale, 55 \inf, 95 \infty, 88, 114 Inkscape, 141, 237 \input, 40, 41, 227 Insiemi numerici, 89 \int, 88, 112 Integrali, 218 \intercal, 115 Interlinea, 59, 191 \iota, 110 itaitemize, 184

\item, 26, 70, 71 itemize, 70, 71, 156 \itshape, 189

J \jmath, 114 \Join, 111

K \k, 65

\kappa, 110 \katwtonos, 227 \ker, 95 \Ket, 97

Kile, 18, 237

L \L, 65 \l, 65

\label, 37, 85, 146, 147, 150, 156,

211

\Lambda, 110 \lambda, 110 \land, 93, 111 \langle, 112 \LARGE, 190, 191 \Large, 190, 191 \large, 190, 191 \LaTeX, 21, 26, 64 \LaTeXe, 64 \latino, 222 \lbrace, 112 \lbrack, 112 \lceil, 112 \le, 111 \leadsto, 113 \left, 96, 214, 216 \Leftarrow, 113 \leftarrow, 113 \leftarrowtail, 113 \leftharpoondown, 113 \leftharpoonup, 113 \leftleftarrows, 113 \Leftrightarrow, 113 \leftrightarrow, 113 \leftrightarrows, 113 \leftrightharpoons, 113 \leftrightsquigarrow, 113 \leftthreetimes, 115 \leq, 111 \leqq, 115 \leqslant, 115

indice analitico

\lessapprox, 115 \lessdot, 115 \lesseqgtr, 115 \lesseqqgtr, 115 \lessgtr, 115 \lesssim, 115

Lettere greche, 89, 110

\lettrine, 78 \lfloor, 112 \lg, 95 \lgroup, 112 \lhd, 111 \lim, 95 \liminf, 95 \limsup, 95 \linespread, 27, 59 \listfigurename, 187 \listoffigures, 150 \listoftables, 150 \listtablename, 187 \ll, 111 \llcorner, 112 \Lleftarrow, 113 \lll, 115 \llless, 115 \lmoustache, 112 \ln, 95 \lnapprox, 116 \lneq, 116 \lneqq, 116 \lnot, 93, 114 \lnsim, 116 \log, 94, 95 \Longleftarrow, 113 \longleftarrow, 113 \Longleftrightarrow, 113 \longleftrightarrow, 113 \longmapsto, 113 \Longrightarrow, 113 \longrightarrow, 113 longtable, 137 \looparrowleft, 113 \looparrowright, 113 \looseness, 79, 80 \lor, 93, 111 \lozenge, 114 \lrcorner, 112 \Lsh, 113 \lstinline, 76 lstlisting, 76 \lstset, 76 \ltimes, 115

247

248

indice analitico

\lVert, 91 \lvert, 90 \lvertneqq, 116

M \mail, 63 \mainmatter, 54 MakeIndex, 39, 77, 179 \makeindex, 177 \maketitle, 23, 67 \mapsto, 92, 113

Margini di pagina, 36, 57, 58, 206 \markboth, 38, 56 \markright, 38 \mathbb, 89, 116 \mathbf, 98, 103, 116 \mathcal, 102, 116, 217 \mathclose, 97 Mathematica, 141, 237 \mathit, 116 \mathnormal, 116 \mathopen, 97 \mathrm, 116 \mathscr, 116 \mathsf, 116 \mathtt, 116 matrix, 98 \max, 95 \mbox, 80 \measuredangle, 114 \medskip, 50, 147, 150 METAFONT, 8, 65, 192 METAPOST, 65, 139 \MF, 64 \mho, 114 \mid, 91, 111 \midrule, 121, 207 MiKTEX Package Manager, 32 \min, 95 \minitoc, 57 \models, 111 \MP, 64 \mp, 86, 111 \mtcskip, 57 \mu, 110 multicols, 179 \multicolumn, 128 \multimap, 113 multline, 100, 214 multline*, 100 myheadings, 38

N \nabla, 114 \natural, 114 \ncong, 116 \ne, 111 \nearrow, 113 \neg, 114 \neq, 111 \newcolumntype, 131 \newcommand, 182 \newenvironment, 183, 184 \newline, 50 \newpage, 81 \newtheorem, 104 \newtheorem*, 105 \newtheoremstyle, 105 \nexists, 114 \ngeq, 116 \ngeqq, 116 \ngeqslant, 116 \ngtr, 116 \ni, 111 \nLeftarrow, 116 \nleftarrow, 116 \nLeftrightarrow, 116 \nleftrightarrow, 116 \nleq, 116 \nleqq, 116 \nleqslant, 116 \nless, 116 \nmid, 116 \nobreakspace, 227 \nocite, 167 \noindent, 50 \norma, 91 \normalsize, 190, 191

Norme iso-uni, 83, 94, 98, 195

\notag, 101

Note a margine, 69 a piè di pagina, 69 \notin, 89, 111 \nparallel, 116 \nprec, 116 \npreceq, 116 \nRightarrow, 116 \nrightarrow, 116 \nshortmid, 116 \nshortparallel, 116 \nsim, 116 \nsubseteq, 116

\nsubseteqq, 116 \nsucc, 116 \nsucceq, 116 \nsupseteq, 116 \nsupseteqq, 116 \ntriangleleft, 116 \ntrianglelefteq, 116 \ntriangleright, 116 \ntrianglerighteq, 116 \nu, 110 \num, 201, 202 numeric, 163 \nVDash, 116 \nVdash, 116 \nvDash, 116 \nvdash, 116 \nwarrow, 113

O \O, 65 \o, 65 \oddsidemargin, 59 \odot, 111 \OE, 65, 223 \oe, 65, 223

Oggetti mobili, 36, 77, 144, 145, 147–149 \oint, 112 \Omega, 110 \omega, 110 \ominus, 111 \omissis, 61 OmniGraffle, 141 onehalfspace, 59 \onehalfspacing, 59 Operatori, 94, 215 \oplus, 111 \oslash, 111 otherlanguage, 171 otherlanguage*, 230 \otimes, 111 \overbrace, 96 \overline, 90, 216 \overrightarrow, 90 \owns, 111 P \P, 114

Pacchetto acronym, 77 algorithm, 77 algpseudocode, 77

indice analitico

amscd, 108 amsmath, 36, 65, 83, 84, 95, 100, 123, 130, 213–219, 231, 239 amssymb, 36, 84, 116, 218 amsthm, 36, 104, 105 appendix, 55 array, 36, 124, 130–133, 137, 208 ArsClassica, ii, 194, 241 babel, 36, 46, 47, 51, 65, 103, 158, 166, 170, 186, 187, 196, 221–228, 230 backref, 36, 39, 170 biblatex, 36, 155–159, 161– 164, 166–171, 230, 240, 241 bm, 98, 103 bmpsize, 140 bookmarks, 65 booktabs, 36, 117, 121, 207, 209, 210, 239 braket, 97 caption, 36, 149, 150, 153, 210 changepage, 36, 59 colortbl, 133 comment, 27 crop, 59 csquotes, 158 ctable, 134 empheq, 109 emptypage, 38 endfloats, 148 enumitem, 36, 72 epigraph, 77 eucal, 116 eurosym, 36, 65 fancyhdr, 36, 38, 185, 186 feynmf, 109 float, 36, 144, 149 fontenc, 36, 43–45, 78, 196, 206, 229 fontspec, 229 footmisc, 69 footnote, 134 fourier, 78, 194 frontespizio, 67 geometry, 36, 58, 59, 119, 206 glossaries, 77

249

250

indice analitico

graphicx, 30, 36, 117, 139, 142, 185 guit, 31, 65 hyperref, 13, 36, 39, 56, 61, 63â&#x20AC;&#x201C;65, 156, 168, 177, 207 indentfirst, 37, 53 inputenc, 37, 45, 46, 60, 196, 206, 229 layaureo, 58, 119, 206, 239 lettrine, 78 listings, 37, 76 longtable, 37, 136, 137, 144 makeidx, 37, 177 mathpazo, 78, 193 mathptmx, 193 mathrsfs, 116 mathtools, 91, 215 mflogo, 65 mhchem, 109 microtype, 13, 37, 53, 230 minitoc, 37, 39, 57 mparhack, 69 multicol, 37, 79, 179 natbib, 167 palatino, 193 pgf, 139 placeins, 149 polyglossia, 230 ppchtex, 109 pst-pdf, 12 PSTricks, 12, 108, 139 pxfonts, 78, 193 ragged2e, 132 rotating, 136 setspace, 59 shapepar, 78 showidx, 179 showlabels, 37 sidecap, 150, 152 siunitx, 108, 125, 126, 201, 202, 209 subfig, 37, 150, 151 supertabular, 137 syntonly, 41 tabularx, 37, 123â&#x20AC;&#x201C;125 teubner, ix, 231 textcomp, 108 times, 193 txfonts, 78, 194 type1ec, 78 ucs, 45, 229, 230

url, 37, 63, 207 varioref, 37, 69 verse, 75 wrapfig, 153 xcolor, 37, 109, 133, 134, 185 xspace, 26, 183 xtab, 137 Xy-pic, 108, 139 XyMTeX, 109 xypdf, 108 \pagebreak, 81 \pagename, 187 \pageref, 68, 69 \par, 49, 68, 191 \paragraph, 53, 54 \parallel, 91, 111 \parencite, 167 \part, 54 \partial, 114 \partname, 187 \pdfbookmark, 26 \ped, 65, 103 \permill, 230 \perp, 111 \phantomsection, 56, 156, 168, 177 \Phi, 110 \phi, 110 \Pi, 110 \pi, 110 \pianta, 181, 182 picture, 139 \pitchfork, 115 plain, 37 \pm, 86, 111 pmatrix, 98 \pmod, 95 \pounds, 114 \Pr, 95 \prec, 111 \precapprox, 115 \preccurlyeq, 115 \preceq, 111 \precnapprox, 116 \precneqq, 116 \precnsim, 116 \precsim, 115 \prefacename, 187, 223 \prime, 114 \printbibliography, 168, 173, 175

\prod, 87, 112 proof, 107 \proofname, 187 \propto, 111 \ProsodicMarksOff, 222 \ProsodicMarksOn, 222

proTEXt, 14, 238

\ProvidesClass, 184 \ProvidesPackage, 184 \Psi, 110 \psi, 110

Q \qedhere, 107 \qoppa, 227 \qquad, 86, 93, 130 \quad, 86, 93, 130, 150 quotation, 74 quote, 74

R \r, 65 \raggedbottom, 59 \RaggedLeft, 132 \raggedleft, 132 \RaggedRight, 132 \raggedright, 132 \rangle, 112 \rbrace, 112 \rbrack, 112 \rceil, 112 \Re, 95, 114 \ref, 37, 68, 69, 146, 211 \refname, 156, 187 \renewcommand, 182, 184 \renewenvironment, 184 \rfloor, 112 \rgroup, 112 \rhd, 111 \rho, 110

Riferimenti a una formula, 85, 218 incrociati, 68, 211 ipertestuali, 61 \right, 96, 214, 216 \Rightarrow, 113 \rightarrow, 113 \rightarrowtail, 113 \rightharpoondown, 113 \rightharpoonup, 113 \rightleftarrows, 113 \rightleftharpoons, 113

indice analitico

\rightrightarrows, 113 \rightsquigarrow, 113 \rightthreetimes, 115 \risingdotseq, 115 \rmfamily, 189 \rmoustache, 112 \Rrightarrow, 113 \Rsh, 113 \rtimes, 115 \rVert, 91 \rvert, 90

S \S, 114 \sampi, 227 SCfigure, 152 SCfigure*, 152 \scriptscriptstyle, 103 \scriptsize, 190, 191 \scriptstyle, 103 \scshape, 189 SCtable, 152 SCtable*, 152 \searrow, 113 \sec, 95 \section, 23, 53, 54 \section*, 173 \seename, 187 \Set, 97 \setmainfont, 229 \setmainlanguage, 230, 231 \setminus, 91, 111 \setotherlanguage, 230 \sffamily, 189 \sharp, 114 \shortmid, 115 \shortparallel, 115 \sidecaptionrelwidth, 152 sidewaystable, 136 \Sigma, 110 \sigma, 89, 110

Sillabazione, 46, 47, 51

\sim, 111 \simeq, 111 \sin, 94, 95 singlespace, 59 \singlespacing, 59 \sinh, 95 \sisetup, 126 \slshape, 189 \small, 27, 190, 191 \smallfrown, 115

251

252

indice analitico

smallmatrix, 99 \smallsetminus, 115 \smallskip, 50 \smallsmile, 115 \smile, 111 spacing, 59 \spadesuit, 114 \sphericalangle, 114 split, 100, 214 \sqcap, 111 \sqcup, 111 \sqrt, 87 \sqsubset, 111, 115 \sqsubseteq, 111 \sqsupset, 111, 115 \sqsupseteq, 111 \square, 114 \star, 111 \stigma, 227 \stretch, 68 subequations, 102 \subfloat, 26, 150 \subparagraph, 54, 55 \subsection, 54, 55 \subsection*, 173 \Subset, 115 \subset, 111 \subseteq, 111 \subseteqq, 115 \subsetneq, 116 \subsetneqq, 116 \subsubsection, 54, 55 \succ, 111 \succapprox, 115 \succcurlyeq, 115 \succeq, 111 \succnapprox, 116 \succneqq, 116 \succnsim, 116 \succsim, 115 \sum, 87, 112 \sup, 95 \supercite, 167 \Supset, 115 \supset, 111 \supseteq, 111 \supseteqq, 115 \supsetneq, 116 \supsetneqq, 116 \surd, 114 \swarrow, 113

T \t, 65 table, 134–136, 144–146, 152 table*, 79, 144 \tablename, 187 \tableofcontents, 23, 57, 146 tabular, 98, 101, 117, 119, 122,

123, 133–137, 146, 147 \tabularnewline, 132 tabularx, 124 \tan, 95 \tanh, 95 \tau, 110 Tesi di laurea, 29, 55, 67 \TeX, 64 TEXnicCenter, 13, 15, 45, 238 TEXShop, 13, 17, 45, 238 \text, 102, 123, 213, 215 \textbackslash, 25, 199 \textbf, 124, 181, 189 \textcite, 167 \textheight, 143 \textit, 70, 181, 189 \textrm, 189 \textsc, 189 \textsf, 189 \textsl, 189 \textstyle, 103 \textsuperscript, 65 \texttt, 189 \textup, 103 \textwidth, 59, 119, 144, 206 TEXworks, 13, 17, 18, 45, 238 \tfrac, 104 \TH, 65 \th, 65 \thanks, 66, 67 thebibliography, 155–157, 169 theindex, 179 \theoremstyle, 105 \therefore, 115 \Theta, 110 \theta, 110 \thickapprox, 115 \thicksim, 115 \tilde, 110 \times, 111 \tiny, 190, 191 \title, 66 titlepage, 67 \to, 92, 113

\today, 26, 224 \top, 114 \toprule, 121, 207 \triangle, 114 \triangledown, 114 \triangleleft, 111 \trianglelefteq, 115 \triangleq, 115 \triangleright, 111 \trianglerighteq, 115 \ttfamily, 189 \twocolumn, 79 \twoheadleftarrow, 113 \twoheadrightarrow, 113

U \u, 65, 222 \ulcorner, 112 \underbrace, 96 \underline, 90 \underset, 90 \unlhd, 111 \unrhd, 111 \Uparrow, 112, 113 \uparrow, 112, 113 \Updownarrow, 112, 113 \updownarrow, 112, 113 \upharpoonleft, 113 \upharpoonright, 113 \uplus, 111 \Upsilon, 110 \upsilon, 110 \upuparrows, 113 \urcorner, 112 \url, 63 \usepackage, 38 V \v, 65

\vardigamma, 227 \varepsilon, 110 \varkappa, 114 \varnothing, 114 \varphi, 110 \varpi, 89, 110 \varpropto, 115 \varrho, 110 \varsigma, 89, 110 \varsubsetneq, 116 \varsubsetneqq, 116

indice analitico

\varsupsetneq, 116 \varsupsetneqq, 116 \vartheta, 110 \vartriangle, 114 \vartriangleleft, 115 \vartriangleright, 115 \Vdash, 115 \vDash, 115 \vdash, 111 \vdots, 99, 114 \vec, 90, 98, 110 \vee, 111 \veebar, 115 \verb, 75, 76 \verb*, 76 verbatim, 75, 76 verbatim*, 76 verse, 74 \Vert, 91, 112 \vert, 90, 112 Vmatrix, 98 vmatrix, 98 \vref, 69, 146, 211 \vspace, 50, 68 \vspace*, 50 \Vvdash, 115

W \wedge, 111 \widehat, 92, 110 \widetilde, 92, 110

WinEdt, 13, 15, 16, 35, 45, 238 WinFIG, 141, 238 \wp, 114 \wr, 111 wrapfloat, 153, 154 X Xfig, 18, 141, 238

\Xi, 110 \xi, 110 \xleftarrow, 93 \xrightarrow, 93

Y Yap, 236 Z \zeta, 110

253