Il Pacchetto Toptesi
Total Page：16
File Type：pdf, Size：1020Kb
Il pacchetto TOPtesi Manuale d’uso Il pacchetto TOPtesi Versione 6.4.06 del 2020-09-06 Per comporre tesi in molti atenei fra i quali il Politecnico di Torino Il pacchetto TOPtesi contiene la classe omonima e diversi altri file per comporre tesi di diverso tipo Questa documentazione fornisce anche le linee guida per comporre una tesi rispettando certe regole tipografiche Claudio Beccari Documentazione: versione 0.9.50 del 2020-09-03 Questo testo è libero secondo le condizioni stabilite dalla LATEX Project Public Licence (LPPL) riportata nella pagina 161. Composto con LuaLATEX il 6 settembre 2020 Sommario Questo testo serve per descrivere come comporre tipograficamente la tesi di laurea ola monografia o la dissertazione di dottorato mediante il noto programma di composizione LATEX, o meglio, mediante le sue varianti pdfLATEX, X E LATEX o LuaLATEX; per produrre con X E LATEX il file finale in formato PDF archiviabile secondo la norma ISO 19005-1 bisogna procedere come descritto nel paragrafo 3.13.3. Il formato PDF archiviabile si ottiene più facilmente con LuaLATEX e pdfLATEX. 3 Summary This text describes how to typeset a university master thesis, or the bachelor final report, or the PhD dissertation through the well known typesetting program LATEX, or rather through its variants pdfLATEX, X E LATEX, or LuaLATEX; in order to produce the final document in a PDF archivable format according to the ISO regulation 19005-1 it’s necessary to proceed as described in section 3.13.3. A PDF archivable output file is more easily obtained with LuaLATEX and pdfLATEX. 4 Ringraziamenti Ringrazio gli studenti del Politecnico di Torino che mi hanno sollecitato a mettere la mia esperienza a loro disposizione per predisporre e rendere disponibile il software necessario per preparare le loro tesi, monografie o dissertazioni con la qualità che solo 1 pdfLATEX, X E LATEX o LuaLATEX riescono a produrre. 1 La composizione di questo testo di documentazione è stata eseguita con LuaLATEX. Il programma di composizione X E LATEX presenta numerosi vantaggi su pdflatex per quel che riguarda l’uso dei font, anche per la matematica, ma non è ancora (2020) in grado di produrre l’uscita direttamente nel formato PDF, anche se apparentemente lo fa. In realtà la sua uscita è in un formato intermedio che viene poi trasformato automaticamente in PDF. L’esperienza mi insegna che in realtà le limitazioni di X E LATEX sono pochissime e, con la classe toptesi, la limitazione forse più importante, ma risolvibile, riguarda il formato PDF archiviabile che non è ottenibile direttamente, tanto che bisogna procedere come indicato nel paragrafo 3.13.3. Con LuaLATEX non ci sono le limitazioni di X E LATEX, quindi nel seguito si darà sempre la preferenza a LuaLATEX. 5 Indice Elenco delle tabelle 9 Elenco delle figure 10 1 Questo manuale: cosa fare e cosa non fare 11 1.1 A cosa serve TOPtesi ............................ 13 1.2 Cosa leggere ................................. 14 1.3 Errori da evitare ............................... 16 1.4 Pacchetti già caricati da TOPtesi ...................... 17 1.5 Pacchetti che il laureando deve caricare personalmente ......... 19 1.6 Pacchetti da non caricare affatto ...................... 21 1.7 Comandi e ambienti di TOPtesi ...................... 22 1.8 Modelli di tesi e di frontespizi ....................... 24 2 Introduzione 25 2.1 LATEX e le tesi di laurea ........................... 26 2.2 Installare LATEX ................................ 28 2.3 Ora si è pronti ................................ 32 3 L’uso di TOPtesi 37 3.1 Impostazioni standard di TOPtesi ..................... 40 3.1.1 Dove sono i file di TOPtesi? .................... 41 3.1.2 Il file di configurazione ....................... 42 3.2 Tutto è ora pronto per cominciare ..................... 43 3.3 Il preambolo del file principale ....................... 43 3.4 Le opzioni .................................. 47 3.5 I moduli accessori .............................. 50 3.5.1 La composizione del frontespizio ................. 50 3.5.2 Il logo dell’ateneo per l’uso con TOPtesi ............. 51 3.6 I frontespizi ................................. 53 3.6.1 Comporre il frontespizio con topfront .............. 53 3.6.2 Comporre il frontespizio della tesi di dottorato della ScuDo .. 61 6 Indice 3.6.3 Il frontespizio della tesi triennale ................. 65 3.6.4 Il frontespizio della tesi magistrale ................ 66 3.6.5 Il frontespizio della tesi dottorale ................. 67 3.6.6 Il frontespizio della tesina ..................... 67 3.6.7 Il frontespizio “custom” ...................... 73 3.6.8 Il frontespizio composto con frontespizio ............. 76 3.6.9 Casi particolari ........................... 80 3.7 Il comando \chapter ............................ 82 3.8 Il file accessorio topcoman ......................... 83 3.9 Doctoral dissertation for the ScuDo school of Politecnico di Torino .. 84 3.9.1 Further packages loaded for typesetting ScuDo theses ..... 84 3.9.2 New commands available with the toptesi-scudo module .... 86 3.10 Come si comincia .............................. 88 3.10.1 La scelta della codifica per il file sorgente ............ 93 3.10.2 La scelta della codifica per il file di uscita ............. 96 3.11 Come stampare la tesi ............................ 99 3.12 Comporre la tesi in diverse lingue ..................... 101 3.12.1 Configurazione iniziale ....................... 102 3.12.2 Le lingue della tesi ......................... 105 3.13 Il formato PDF archiviabile ......................... 108 3.13.1 pdflatex e il formato PDF/A ................... 113 3.13.2 lualatex e il formato PDF/A .................... 115 3.13.3 xelatex e il formato PDF/A .................... 116 3.13.4 Uso di pdfpages o ghostscript ................... 116 Conformità con TOPtesi ...................... 117 Conformity when using TOPtesi for ScuDo doctoral theses .. 117 3.14 Verifica della conformità .......................... 119 3.14.1 Verifica con veraPDF ........................ 120 3.14.2 Verifica con Preflight ........................ 122 3.14.3 Correzione degli errori ....................... 122 3.14.4 Considerazioni sulla verifica .................... 123 4 I comandi specifici introdotti da TOPtesi 125 4.1 Introduzione ................................. 125 4.2 Opzioni per la classe toptesi ........................ 125 4.3 Comandi di tipo generale .......................... 127 4.4 Comandi per il frontespizio ......................... 137 4.5 Altri comandi ................................ 144 4.6 ScuDo title page commands ........................ 151 4.6.1 Variant data ............................. 151 4.6.2 Fixed data .............................. 152 4.6.3 The title page ............................ 154 7 Indice 5 Personalizzazioni 155 Preamble ...................................... 161 Definitions ..................................... 161 Conditions on Distribution and Modification .................. 162 No Warranty .................................... 164 Maintenance Of the Work ............................. 165 Whether and How to Distribute Works under This License .......... 166 Choosing This License or Another License ................ 166 A Recommendation on Modification Without Distribution ....... 167 How to Use This License .......................... 167 Important Recommendations ........................ 168 Indice analitico 169 8 Elenco delle tabelle 2.1 Le principali differenze fra pdflatex, xelatex e lualatex .......... 35 3.1 Varie modalità di composizione del frontespizio ............. 63 4.1 Valori particolari per la chiave tipotesi ................. 129 4.2 Comandi di tipo generale .......................... 131 4.3 Possibilità d’uso di \SDbox ......................... 135 4.4 Comandi ulteriori di toptesi ......................... 145 4.5 Comandi ulteriori con lo stile classico ................... 146 4.6 Comandi per il frontespizio delle tesi e della dissertazione di dottorato . 147 4.7 Comandi per i frontespizi delle tesi universitarie ............. 148 4.8 Comandi per i frontespizi delle tesi universitarie ............. 149 4.9 Comandi per modificare le parole fisse .................. 150 9 Elenco delle figure 2.1 Logo tondo del guIt ............................. 26 3.1 Diagramma di flusso di TOPtesi, versioni 1.x–3.x ............. 37 3.2 Diagramma di flusso di TOPtesi versione 5.85 .............. 38 3.3 Diagramma di flusso di TOPtesi versione 6.x ............... 39 3.4 Frontespizi composti con lo stile standard ................. 60 3.5 Un logo modificato con l’aggiunta del nome dell’ateneo ......... 61 3.6 Frontespizi composti con lo stile classica ................ 62 3.7 Frontespizio della dissertazione della ScuDo ............... 64 3.8 Esempio di frontespizio per una tesina .................. 68 3.9 Frontespizio con in landscape ottenuto con l’ambiente titlepage .... 77 3.10 Finestra iniziale di veraPDF ......................... 121 3.11 Verdetto dell’analisi di veraPDF su due file ................ 121 4.1 Il logo di TiT (1) ............................... 133 4.2 Il logo di TiT (2) ............................... 133 4.3 Logo di fantasia ............................... 137 4.4 I quattro frontespizi fondamentali ..................... 140 10 Capitolo 1 Questo manuale: cosa fare e cosa non fare Prima di prendere ironicamente l’aggettivo ‘rapida’ attribuito a questa guida di più di 170 pagine, vorrei sottolineare che essa è lunga perché TOPtesi permette di svolgere moltissimi compiti. E per comporre bene la propria tesi, le cose da fare sono moltissime