summaryrefslogtreecommitdiff
path: root/Master
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-11-17 00:34:16 +0000
committerKarl Berry <karl@freefriends.org>2010-11-17 00:34:16 +0000
commit73cd5c082800b6704a33df225536f0d8f761c42f (patch)
treed1395b96a064e4632ba8cf2b42d0ed95f70da46f /Master
parented6a4bf7b100677d2f500185436d7f3981a7598d (diff)
toptesi (16nov10)
git-svn-id: svn://tug.org/texlive/trunk@20458 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r--Master/texmf-dist/doc/latex/toptesi/README26
-rw-r--r--Master/texmf-dist/doc/latex/toptesi/manifest.txt6
-rw-r--r--Master/texmf-dist/doc/latex/toptesi/toptesi-doc.pdfbin595124 -> 595123 bytes
-rw-r--r--Master/texmf-dist/doc/latex/toptesi/toptesi-doc.tex1717
-rw-r--r--Master/texmf-dist/doc/latex/toptesi/toptesi-example.pdfbin0 -> 249816 bytes
-rw-r--r--Master/texmf-dist/doc/latex/toptesi/toptesi-example.tex2
-rw-r--r--Master/texmf-dist/doc/latex/toptesi/toptesi.pdfbin404947 -> 408918 bytes
-rw-r--r--Master/texmf-dist/source/latex/toptesi/toptesi.dtx370
-rw-r--r--Master/texmf-dist/source/latex/toptesi/toptesi.ins113
-rw-r--r--Master/texmf-dist/tex/latex/toptesi/topcoman.sty50
-rw-r--r--Master/texmf-dist/tex/latex/toptesi/topfront.sty50
-rw-r--r--Master/texmf-dist/tex/latex/toptesi/topsiz14.clo50
-rw-r--r--Master/texmf-dist/tex/latex/toptesi/toptesi.cfg50
-rw-r--r--Master/texmf-dist/tex/latex/toptesi/toptesi.cls52
-rw-r--r--Master/texmf-dist/tex/latex/toptesi/toptesi.sty64
-rw-r--r--Master/texmf-dist/tex/latex/toptesi/trieste.sty50
-rwxr-xr-xMaster/tlpkg/libexec/ctan2tds1
17 files changed, 2235 insertions, 366 deletions
diff --git a/Master/texmf-dist/doc/latex/toptesi/README b/Master/texmf-dist/doc/latex/toptesi/README
index a06cfb8c3d0..472b91ed8f2 100644
--- a/Master/texmf-dist/doc/latex/toptesi/README
+++ b/Master/texmf-dist/doc/latex/toptesi/README
@@ -1,24 +1,28 @@
-The TOPtesi bundle contains everything is needed for typesetting a bachelor,
-master or PhD thesis in Italian (or in any other language supported
-by LaTeX: the bundle is constructed to support multilanguage use).
+The TOPtesi bundle contains everything is needed for typesetting a
+bachelor, master or PhD thesis in Italian (or in any other language
+supported by LaTeX: the bundle is constructed to support multilanguage
+use).
The infix strings may be selected and specified at will by means
of a configuration file, so as to customize the layout of the
front page to the requirements of a specific university.
-Thanks to its language management, the bundle is suited for multilanguage
-theses that are becoming more and more frequent thanks to the
-double degree programs of the European Union Erasmus programs.
+Thanks to its language management, the bundle is suited for
+multilanguage theses that are becoming more and more frequent thanks
+to the double degree programs of the European Union Erasmus programs.
-For installation either read the Italian documentation in toptesi-doc.pdf
-or quickly decompress the toptesi.zip file and move
+For installation, if the package is not already installed in your
+TeX system distribution, either read the Italian documentation in
+toptesi-doc.pdf or quickly decompress the toptesi.zip file and move
toptesi-doc.pdf
-toptesi.dtx
-toptesi.ins
+toptesi.dtx
in your local texmf tree, for example in /texmf/doc/latex/toptesi.
+Extract the derived files.
+Notice that by running pdflatex on toptesi.dtx you simultaneouly get
+the class and package files and the pdf documentation in English.
-Then move all other files into /texmf/tex/latex/toptesi.
+Then move all other (non pdf) files into /texmf/tex/latex/toptesi.
If the cited folders do not exist, create them.
diff --git a/Master/texmf-dist/doc/latex/toptesi/manifest.txt b/Master/texmf-dist/doc/latex/toptesi/manifest.txt
index f3a9c99acee..d5e7e314aea 100644
--- a/Master/texmf-dist/doc/latex/toptesi/manifest.txt
+++ b/Master/texmf-dist/doc/latex/toptesi/manifest.txt
@@ -58,4 +58,8 @@ The file
is an example of the usage of this work; it may be used as a template,
but in itself it is not part of this Work
-The file toptesi-example.xmpdata is an example of the contents and format of the metadata that must be included into the same directatory as the thesis main file in order to be able to use pdflatex for typesetting a file that hopefully is PDF/A-1b compliant, that is in the "weak" archivable PDF format.
+The file toptesi-example.xmpdata
+is an example of the contents and format of the metadata that must be
+included into the same directatory as the thesis main file in order to be
+able to use pdflatex for typesetting a file that hopefully is PDF/A-1b
+compliant, that is in the "weak" archivable PDF format.
diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.pdf
index 82f18fa275c..8fc83d14c89 100644
--- a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.pdf
+++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.tex b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.tex
new file mode 100644
index 00000000000..e476929db1d
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.tex
@@ -0,0 +1,1717 @@
+%
+% toptesi-doc.tex
+%% Copyright 2005-2006 Claudio Beccari
+%
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either version 1.3
+% of this license or (at your option) any later version.
+% The latest version of this license is in
+% http://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of LaTeX
+% version 2003/12/01 or later.
+%
+% This work has the LPPL maintenance status "author-maintained".
+%
+%
+% This work consists of the files listed in manifest.txt
+%
+% Version 1.3 of the LaTeX Project Public License is included in the
+% appendix of this documentation, but the primary source remains in
+% http://www.latex-project.org/
+%
+% 2008/03/01 corretto l'esempio della sola stampa del frontespizio,
+% perche' risultava errata omettendo di chiamare babel
+\documentclass[12pt,twoside,pdfa]{toptesi}\errorcontextlines=9
+\hypersetup{%
+ pdfpagemode={UseOutlines},
+ bookmarksopen,
+ pdfstartview={FitH},
+ colorlinks,
+ linkcolor={blue},
+ citecolor={blue},
+ urlcolor={blue}
+ }
+\usepackage[latin1]{inputenc}
+\usepackage{color}
+\usepackage{microtype}%
+%%%% inserire il valore corretto della versione di toptesi
+\def\fileversion{5.01}
+ \NomeMonografia{Manuale d'uso}
+ \monografia{La classe \textsf{TOPtesi}}
+ \sottotitolo{Per comporre le tesi al Poli \\e in molte altre università}
+ \candidato{Claudio Beccari}
+ \sedutadilaurea{Versione \fileversion}
+ \logosede{logopolito}
+
+
+
+\begin{document}
+\thispagestyle{empty}
+\vspace*{.2\textheight}
+\hrule
+\bigskip
+\centerline{\Huge \textsf{La classe TOPtesi}}
+\bigskip
+\hrule
+\clearpage
+
+
+
+
+ \frontespizio
+\sommario
+ Questo testo serve per descrivere come comporre tipograficamente la
+ tesi di laurea o la monografia o la dissertazione di dottorato
+ mediante il noto programma di composizione \LaTeX, o meglio, mediante la sua variante pdf\LaTeX; sono previste di default le necessarie azioni per produrre il file finale in formato PDF archiviabile secondo la norma ISO 19005-1.
+
+ L'appendice~A contiene il testo della \LaTeX\ Project Public Licence,
+ versione 1.3, alla quale questo lavoro è soggetto.
+
+
+
+\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 \LaTeX\ e pdf\LaTeX\ riescono a produrre.
+
+\indici
+
+\chapter{Introduzione}
+
+Si legge ancora nelle istruzioni per scrivere le tesi di molte
+università italiane come di moltissime università straniere:
+\begin{quote}\ttfamily
+Comporre la tesi con interlinea 2 e con righe di 60 battute;
+\dots
+\end{quote}
+
+Quelle università non si sono ancora accorte che le macchine da
+scrivere meccaniche o elettromeccaniche sono rimasti oggetti di
+sola curiosità, ammesso che ce ne sia ancora qualcuna disponibile
+e le poche superstiti non siano tutte nei musei.
+
+Oggi si scrive con uno dei tanti sistemi di elaborazione testi,
+detti anche ``word processors'', che fanno parte più o meno di
+default di ogni dotazione iniziale di qualsiasi PC di qualunque
+marca e con qualunque sistema operativo.
+
+Fra i vari programmi di elaborazione testi, uno in particolare
+spicca per la sua particolarità: \LaTeX. Esso è nato come
+sovrastruttura di un altro programma, \TeX, che continua ad
+esserne il motore. La prima versione di \TeX\ è stata creata nel
+1978, ma è ancora usata oggi, naturalmente molto aggiornata, e
+questo fatto è una cosa insolita nel panorama turbolento di novità
+dell'informatica.
+
+Secondo me, il suo successo è dovuto a due fatti: (a) esso è stato
+progettato e implementato da un matematico per comporre i suoi
+stessi libri di informatica; (b) egli l'ha messo a disposizione di
+chiunque, sin dal primo momento, come software libero.
+
+Oggi il software libero è piuttosto diffuso, ma nel 1978 parlare
+di software libero era quasi una bestemmia.
+
+D'altra parte Donald E.\ Knuth non era soddisfatto della bassa
+professionalità che anno dopo anno manifestavano i compositori
+delle case editrici, i quali anno dopo anno si abituavano a quanto
+i programmi di elaborazione mettevano loro a disposizione, ma
+contemporaneamente perdevano le loro conoscenze professionali via
+via che si adattavano a quanto quei programmi consentivano loro di
+fare.
+
+La cosa era o stava diventando insostenibile durante i vari anni
+in cui uscivano i successivi volumi dell'opera di Knuth ``The Art
+of Computer Programming'', e così Knuth si dedicò alla creazione
+della tipografia elettronica realizzando il programma \TeX\ che,
+ripeto, è ancora in ottima salute dopo quasi trent'anni di
+onorato servizio.
+
+L'uso di \TeX\ per eseguire direttamente la composizione era piuttosto
+difficile, e ogni utente doveva prima o poi imparare a scriversi delle
+macroistruzioni che gli consentissero di agevolare il suo lavoro.
+
+Nel 1984 \TeX\ era già così diffuso in tutto il mondo,
+specialmente in ambito accademico, che Leslie Lamport decise di
+produrre un sistema quasi completo di macro che consentiva agli
+utenti di usare \TeX\ lasciandolo dietro alle quinte, in modo da
+potersi concentrare sul contenuto dei loro scritti e non sulla
+forma da dare a questo o a quel dettaglio.
+
+Nel 1990 Knuth realizzò la versione di \TeX\ che consentiva di
+comporre in diverse lingue simultaneamente; nel 1994 molti utenti
+di \LaTeX\ costituirono il \LaTeX3 Team al fine di rendere
+gestibile la mole enorme delle estensioni di \LaTeX\ che in
+10~anni utenti entusiasti avevano messo a disposizione della
+comunità degli altri utenti. Insomma è successo con \TeX\ e
+\LaTeX\ quello che succede normalmente con il software libero.
+
+Attenzione: Knuth paga di tasca sua un dollaro a chiunque trovi un
+errore nel suo software; a tutt'oggi non è andato in bancarotta,
+sia perché gli errori sono rarissimi, sia perché quelle poche
+persone che hanno segnalato errori veri e hanno ricevuto l'assegno
+di Knuth, non l'hanno incassato ma l'hanno incorniciato come fosse
+una reliquia preziosa.
+
+\section{\LaTeX\ e le tesi di laurea}
+
+Ovviamente \LaTeX\ serve per scrivere qualunque cosa; o meglio;
+serve per comporre tipograficamente qualunque testo. \LaTeX\ non è
+un programma di impaginazione, è un programma di composizione
+tipografica. Non aspettatevi quindi di poter fare qualunque
+acrobazia con le righe di testo, come per esempio piegare le
+righe, deformando i caratteri che vi sono appoggiati sopra,
+mettendovi attorno aloni di luce cangiante, sfumature,
+ombreggiature, evidenziandone i contorni, eccetera. Queste cose
+sono riservate ai creativi che si occupano di pubblicità.
+
+Aspettatevi invece di comporre testi in cui ogni capoverso è
+ottimizzato per avere il minor numero di parole divise in sillabe
+in fin di riga, e di avere il minor numero possibile di
+``ruscelli'' fra le parole grazie alla uniformità dello spazio
+interparola; aspettatevi di comporre formule complicatissime con
+il minimo di sforzo da parte vostra ma con la certezza che esse
+saranno composte come nessun altro programma riesce a fare.
+Aspettatevi uno stampato estremamente professionale.
+
+Per questo motivo voi studenti che userete questo pacchetto di
+macroistruzioni chiamato \textsf{TOPtesi} dovrete astenervi
+dall'introdurre errori compositivi così da vanificare quanto di
+bello riesce a produrre \LaTeX.
+
+Inizialmente vi troverete un po' a disagio perché vi siete
+abituati anche voi ai programmi commerciali che consentono la
+``composizione sincrona''; vi consentono di vedere subito sullo
+schermo il frutto del vostro lavoro. Per ottenere questo risultato
+questi programmi hanno necessariamente rinunciato a diverse
+funzioni, massimizzando invece la velocità di presentazione del
+risultato.
+
+\LaTeX\ richiede che voi scriviate un testo non formattato in puri
+caratteri ASCII, ma marcato con un particolare sistema di
+\emph{mark-up} che consente di sapere che cosa sia ogni parte del
+vostro scritto. Ci pensa poi \LaTeX\ in un secondo tempo a dare forma
+al vostro testo e, in particolare, a dare la stessa forma a ogni
+elemento del vostro scritto a seconda di come lo abbiate ``marcato'';
+elementi marcati nello stesso modo vengono composti nello stesso modo.
+Così si evitano quelle disuniformità compositive che si notano assai
+spesso quando si usa un word processor comune.
+
+Attenzione: questa guida presuppone che voi abbiate già uno conoscenza di base del linguaggio di \emph{mark-up} di \LaTeX. Se non l'avete ancora, installate pure il [programma, ma non usate questa guida per imparare a comporre testi con LaTeX. Esistono diversi testi gratuiti in rete, da \emph{\LaTeX\ per l'impaziente} a \emph{L'arte di scrivere con \LaTeX} a \emph{Introduzione all'arte della composizione tipografica con \LaTeX}; vi basta cercare questi titoli con un qualunque motore di ricerca e troverete da dove scaricarli.
+
+Ricordatevi però che il vostro primo problema sarà quello di superare lo scoglio psicologico di non vedere subito il frutto delle vostre fatiche; abituati come siete ai word processor che seguono il paradigma \emph{What you see is what you get}, che più realisticamente andrebbe scritto \emph{What you see is all you can get} (Quello che vedi e tutto quel che puoi ottenere), dovete passare al paradigma: \emph{What you see is what you mean}, dove l'aspetto grafico di quel che si vede sullo schermo del PC in fase di composizione non è importante, ma è importante quello che avete scritto; il suo aspetto grafico gli verrà dato da \LaTeX\ in un secondo tempo e in una maniera estremamente professionale. Non pretendo di dire che non si possano scrivere tesi ancora più professionali di come si ottengono con \textsf{TOPtesi}, ma certo il risultato è molto migliore di quello che si può ottenere con qualsiasi word processor.
+
+Volete avere una migliore approssimazione sulla finestra di composizione, in modo da restare su una via di mezzo fra le due posizioni di composizione? Usate LyX, oppure usate la componente \texttt{Writer} di OpenOffice; questa componente può essere arricchita con una estensione, scaricabile dal sito di OpenOffice, che si chiama \texttt{Writer2LaTeX}. Mentre sto scrivendo questi appunti la versione stabile non consente di usare \texttt{Writer} come se fosse un editor per \LaTeX; ma è già disponibile una versione sperimentale, che diventerà la versione ufficiale~1.2 di questa estensione) che permette di usare con certe limitazioni il programma \texttt{Writer} come un editor per \LaTeX, per poi disporre di un comodo bottone da cliccare per ottenere la composizione del testo sorgente, ed un altro comodo bottone per la visualizzazione dell'uscita in formato PDF. Gli utenti esperti possono superare le limitazioni inserendo nel testo sorgente adeguate istruzioni in linguaggio \LaTeX, cosicché quello che non può fare \texttt{Writer} come word processor, lo fa poi \LaTeX\ nella sua qualità di text processor.
+
+Personalmente non consiglierei queste vie di mezzo; tuttavia vale la pena sapere che esistono e che possono essere usate, sia pure con qualche limitazione.
+
+\section{Installare \LaTeX}
+Quindi per cominciare a lavorare con \LaTeX\ per prima cosa dovete
+installarvi il software; ovviamente se vi siete già installati
+l'intero sistema \TeX\ ed è già calibrato per comporre
+correttamente, potete saltare questo paragrafo.
+
+Ci sono sostanzialmente tre situazioni:
+\begin{enumerate}
+\item se siete degli utenti delle piattaforme Windows allora
+collegatevi in rete al sito \texttt{www.miktex.org} e scaricatevi
+ed installatevi la distribuzione di \LaTeX, o meglio, del sistema
+\TeX\ chiamato MiK\TeX. Scaricatevi l'installazione minima
+\texttt{small-miktex} e, seguendo le istruzioni di installazione,
+configurate il programma in modo da consentirgli di scaricare
+dalla rete ogni possibile pacchetto di estensione che possa via
+via esservi necessario. Ovviamente questo scaricamento implica una
+connessione di rete sufficientemente veloce; personalmente io mi
+sono scaricato tutto sul mio hard disk in una cartella che mi
+funziona da archivio; quando MiK\TeX\ ha bisogno di estensioni
+esso è configurato per scaricare quanto gli occorre dalla mia
+cartella di archivio. Saltuariamente aggiorno il contenuto della
+cartella di archivio, diciamo ogni due o tre mesi, per cui il mio
+software è sempre aggiornatissimo. Però non imitatemi, se non
+disponete di una connessione veloce; io uso \LaTeX\ e gli altri
+programmi accessori in modo molto avanzato ed è per questo che mi
+tengo tutto a portata di mano, oops! di mouse.
+
+\item Siete degli utenti di Linux; in questo caso siete particolarmente
+fortunati perché il sistema \TeX\ fa parte integrante di
+qualunque distribuzione, anche se non viene installato di default;
+vi basta inserire il disco di installazione o vi basta connettervi
+in rete e invocare uno dei vari programmi come \texttt{apt-get},
+\texttt{rpm} o \texttt{yast} per scaricare tutto quanto vi serve e
+per configurare l'installazione. Ricordatevi che Linux un po'
+più ``ruspante'' di Windows, e quindi la configurazione richiede
+un po' più di attenzione e di smanettamento con la riga di
+comando; ma a questo, in qualità di ``pinguini doc'', ci siete
+abituati; in compenso avete il beneficio di avere tutto quanto il
+software già predisposto fin dalla nascita per macchine UNIX e
+Linux e quindi evitate tutti i (pochi) piccoli bug che si
+incontrano quando le cose sono tradotte per altri sistemi.
+
+\item Siete degli utenti delle piattaforme Macintosh e siete i
+fortunati possessori di un portatile o di un desktop che funziona
+con il sistema operativo Mac~OS~X. Anche voi avete a disposizione
+una distribuzione che si chiama \texttt{Mac\TeX}, che viene
+installata e configurata con un particolare software adatto alla
+specificità del sistema che state usando. Cercate il nome MacTeX
+con un qualunque motore di ricerca e sarete portati ad un sito dal
+quale potrete scaricare il pacchetto di installazione (piuttosto
+grosso); alla fine del download vi viene chiesto se continuare con
+l'installazione; rispondendo affermativamente, il software vi vene
+scaricato sul disco che avrete indicato, ma quel che è più
+comodo, esso già configurato per scrivere e sillabare anche in
+italiano. Il sistema \texttt{Mac\TeX} produce il suo output solo
+in formato PDF; se ne tenga conto leggendo attentamente la
+documentazione, perché la cosa può essere critica con
+l'inserimento delle immagini. Il pacchetto è già dotato dello
+shell editor \TeX{}shop e fa ricorso al previewer di sistema per
+il formato PDF; potrebbe essere una buona idea scaricare dalla
+rete anche l'applicativo freeware Adobe Reader che consente una
+visualizzazione forse migliore ma con una possibilità di
+navigazione all'interno del documento maggiore che non col
+previewer di sistema.
+
+Attenzione, però: il previewer di sistema consente di eseguire
+l'\textit{inverse search} mentre l'editor \TeX{}shop consente di
+fare la \textit{forward search}. Questo è molto comodo durante la
+fase di editing del vostro documento. Invece Adobe Reader
+(e Adobe Acrobat), che io sappia, non sono capaci di eseguire
+l'\textit{inverse search} per cui l'editing diventa un poco più
+complicato.
+
+\end{enumerate}
+
+Poi avete bisogno di programmi accessori per visualizzare sullo
+schermo e/o stampare su carta i prodotti delle vostre
+composizioni. Ognuna delle tre piattaforme tipo può avere già
+installati sia i visualizzatori dei file in formato \texttt{.dvi},
+\texttt{.ps} o \texttt{.pdf}. Il formato \texttt{.dvi} è il
+formato nativo del sistema \TeX\ quindi il software per
+visualizzare e stampare arriva insieme alla distribuzione che
+avete già installato. Per il formato \texttt{.ps} bisogna disporre
+di qualcosa come \texttt{ghostscript} e/o \texttt{GSView} o altri
+simili software che con Linux sono solitamente già disponibili
+insieme al sistema. In ogni caso non è difficile trovare in rete
+i luoghi da dove scaricarli. Per il formato \texttt{.pdf} Linux,
+come al solito già attrezzato, ma suggerisco per tutti e tre i
+tipi di piattaforme il programma \texttt{Adobe Reader} che la
+Adobe mette a disposizione di chiunque e gratuitamente per tutte
+le possibili piattaforme. Naturalmente l'\texttt{Adobe Reader} è
+una specie di programma dimostrativo, per altro eccellente; ma
+credo che la Adobe lo metta a disposizione per far venire
+l'acquolina in bocca e per invogliare a comperare il prodotto
+commerciale completo \texttt{Adobe Acrobat}, che per gli studenti
+non costa molto. Secondo me vale ogni dollaro che costa, ma
+ovviamente questo giudizio dipende dall'uso che se ne fa.
+
+Infine è necessario disporre di un programma di composizione di
+testi ASCII che sia anche un po' d'aiuto per comporre con \LaTeX.
+Il programma gratuito che, a detta degli appassionati, serve per
+fare tutto sarebbe \texttt{emacs}, disponibile per tutte e tre le
+piattaforme anche se è nativo di UNIX. Sarà anche vero che è
+quasi onnipotente, ma per me è difficile da usare; diciamo che ha
+una curva di apprendimento piuttosto ripida e per la mia età le
+salite ripide non sono indicate.
+
+Per le piattaforme Linux esiste un bel software che si chiama
+\texttt{Kile} (KDE Integrated \LaTeX\ Environment) ed è fatto
+apposta per lavorare con \LaTeX. Esso è montabile anche sulle
+piattaforme Windows pur di disporre dell'ambiente \texttt{Cygwin}
+(un simulatore di UNIX compatibile con la maggior parte dei
+sistemi Operativi per Windows) dentro il quale si sia già
+installato tanto KDE (K Desktop Environment) quanto le sue
+librerie di sviluppo.
+
+Per le piattaforme Windows ci sono diverse soluzioni di tipo
+freeware, per esempio \texttt{Winshell} e \texttt{TeXnicCenter}.
+Esiste il prodotto shareware WinEdt scaricabile da \texttt{www.winedt.com}. Vale ogni dollaro che costa e non serve solo per lavorare con \LaTeX; io l'ho usato
+anche per i miei linguaggi di programmazione preferiti e credo di avere risparmiato un bel po' di tempo grazie alle sue funzionalità.
+
+Per le piattaforme Mac esistono diversi programmi; a me sembra il migliore
+di tutti sia TeXShop, automaticamente installato quando si usa il
+pacchetto \texttt{Mac\TeX}.
+
+Per tutte e tre le piattaforme principali \texttt{TeXmakerX} offre notevoli vantaggi, compresa la visualizzazione di parti del testo da comporre che richiedano più interazione fra il compositore il il sofware. Permette anche di disporre di una finestra laterale che contiene tutta la struttura ad albero del documento da comporre; cliccando su ogni ramo o rametto di questo albero, il programma sposta la finestra sul punto del file sorgente dove quella sezione comincia. Anche \texttt{Kile} ha questa funzionalità; risulta molto comoda. Quasi tutti gli editor citati \emph{non} consentono di fare la ricerca inversa con il formato di uscita PDF, ma solo con il formato DVI. \texttt{TeXShop} per Mac, e \texttt{TeXworks} per tutte le piattaforme permettono di eseguire la ricerca inversa anche con il formato PDF, e questa particolarità è estremamente comoda. Per le piattaforme Windows esiste il visualizzatore PDF \texttt{SumatraPDF} che può essere configurato per interagire con l'editor per poter essere usati assieme sia con la ricerca diretta sia con la ricerca inversa. Va da sé, che se non ci sono esigenze diverse, il formato di uscita PDF è sicuramente quello da preferire.
+
+\section{Ora siete pronti}
+Ora che avete scaricato tutto il software gratuito o commerciale di cui
+avete bisogno siete pronti per cominciare.
+
+{\color{red}Dopo avere letto un po' di documentazione e aver giocato un poco
+con i programmi già predisposti sia dalla distribuzione del
+sistema \TeX\ sia dai vari editor ASCII, siete in grado di capire
+come funziona il tutto.
+
+Attenzione: non si minimizzi la frase precedente: la documentazione va letta sempre e capita fino in fondo; se c'è qualcosa che non capite, provate ad esercitarvi con qualche piccolo esercizio, visto che la pratica permette di capire la teoria (e viceversa), ma non andate a cercare in rete aiuto nei vari forum dedicati a \LaTeX\ per farvi dire: ``guarda nella pagina tal-dei-tali della documentazione''; per voi sarebbe una vera umiliazione\dots}
+
+A qualcuno può venire in mente: ``Ma non sarà mica che ci siano in giro dei programmi che permettono di fare tutto questo in modo WYSIWYG?'' Come noto, WYSIWYG è l'acronimo che si forma con le iniziali di ``what you see is what you get''. \LaTeX\ dovrebbe essere classificato con l'acronimo WYSIWYM che sta per ``what you see is what you mean''. Certo per ottenere esattamente quello che si voleva bisogna lavorare (apparentemente) di più; in realtà bisogna usare di più la testa e di meno il mouse.
+
+Tuttavia là fuori nei negozi ci sono diversi prodotti che consentono di usare \LaTeX\ praticamente in modo WYSIWYG; da Scientific Word a LyX a TeXmacs a Textures ce ne è per ogni piattaforma; LyX e TeXmacs sono freeware mentre gli altri costano attorno ai 500\$. Poi c'è la soluzione gratuita di OpenOffice con l'estensione~1.2 di \texttt{Writer2LaTeX}.
+
+Sia però chiaro; per poter operare in modo ``sincrono'' così da
+avere immediatamente sullo schermo una cosa molto simile a quello
+che si otterrà sulla carta, il programma deve essere velocissimo
+ad eseguire il rendering grafico di quanto viene via via composto;
+per questo motivo deve rinunciare a non poche funzionalità del
+sistema \TeX. Però tutti questi software hanno la possibilità di
+salvare i file in formato \texttt{.tex}, cioè nel formato
+sorgente del sistema \TeX, per cui una volta finito l'editing si
+può eseguire la composizione finale con il programma vero, e non
+tramite le facilities del programma di editing.
+
+Io ho cominciato a lavorare con \LaTeX\ a metà degli anni '80 e non ho mai usato editor sincroni. Una decina di anni fa mi sono interessato per vedere i vantaggi di Textures, ma dopo poco ho lasciato perdere perché dovevo lavorare su una piattaforma Mac altrui e non potevo seccarlo in continuazione per chiedergli come si fa questo, come si fa quello; allora il sistema operativo era molto diverso dall'attuale Mac~OS~X e solo gli addetti ai lavori sapevano come usarlo al meglio.
+
+
+Disponendo di una piattaforma Linux ho verificato il funzionamento
+sia di LyX sia di TeXmacs, ma alla fine sono tornato a usare i
+miei semplici editor ASCII con i quali non ho nessuna limitazione
+di nessun genere per quel che riguarda la composizione dei miei
+testi. Bisogna dire che io faccio un grande uso di macroistruzioni
+adatte al mio modo di comporre; in generale le macroistruzioni non
+sono interpretabili da quei sistemi che sono un po' chiusi in se
+stessi, proprio per poter massimizzare la velocità di rendering.
+
+\textcolor{red}{Nel seguito partirò dal presupposto che abbiate già una certa
+conoscenza di \LaTeX\ e che conosciate la differenza fra \LaTeX\ e
+pdf\LaTeX.}
+
+\chapter{L'uso di \textsf{TOPtesi}}
+
+L'insieme di macro contenute in \textsf{TOPtesi} realizza esattamente
+le specifiche di composizione per le monografie, tesi di laurea e
+dissertazioni di dottorato da comporre presso il Politecnico di Torino;
+l'acronimo TOP sta per TOrino Politecnico e naturalmente gioca un po'
+anche sull'altro significato della parola inglese ``top''.
+
+Tuttavia il pacchetto non è stato creato solo per il Politecnico
+di Torino; le informazioni relative a questo ateneo sono di
+default, così come la facoltà di ingegneria è la facoltà di
+default. Ma i comandi predisposti consentono di personalizzare il
+pacchetto per ogni ateneo e ogni facoltà e, oserei dire, in ogni
+lingua.
+
+Tenete conto che \textsf{TOPtesi} è già stato usato anche per
+scrivere tesi in filologia classica greca e in filologia copta;
+\textsf{TOPtesi} non è limitato solo a scritti delle discipline
+cosiddette esatte, quelle che fanno un grande uso del linguaggio
+matematico, ma altrettanto utile per scrivere testi in
+discipline umanistiche, perché \LaTeX\ e pdf\LaTeX\ sono
+altrettanto precisi nel comporre la matematica di quanto lo siano
+nel comporre una poesia o un romanzo.
+
+
+\section{Dove sono i file di \textsf{TOPtesi}?}
+La distribuzione di \textsf{TOPtesi} contiene molti file; ma ogni distribuzione moderna del sistema \TeX\ li carica tutti senza che dobbiate intervenire a mano. Tuttavia è importante che voi sappiate dove trovare questi file.
+
+L'installazione del sistema \TeX\ prevede che i suoi numerosissimi file siano installati in un certo numero di strutture di cartelle, chiamate ``alberi''; ogni albero ha una radice; normalmente la radice della distribuzione si chiama \texttt{texmf-distr}, ma sulla vostra macchina e con il vostro sistema operativo potrebbe avere un altro nome. Esiste anche un albero radicato nella vostra ``home''; nei sistemi di stampo UNIX essa si indica simbolicamente con la tilde e la radice del vostro albero personale potrebbe chiamarsi \texttt{\~{}/texmf}; sulle macchine Windows invece dovete cercare in \texttt{C:\char92Documents and settings} Seguito dal vostro user name oppure da \texttt{All users}; magari ci sono ancora altri rami di albero da percorrere, ma poi si trova \texttt{texmf} o \texttt{localtexmf}. Nei sistemi Mac la radice del vostro albero personale è sotto la vostra \texttt{Library}.
+
+Tutti i file del pacchetto \textsf{TOPtesi} vengono caricati nell'albero della distribuzione; i file della documentazione lungo il ramo \texttt{doc}; i file sorgente, lungo il ramo \texttt{source}; i file ``eseguibili'' in una cartella lungo il ramo \texttt{tex}; fra questi file ``eseguibili''\footnote{Chiamare ``eseguibili'' i file che vengono usati da \LaTeX\ è molto improprio: si tratta di file necessari durante l'esecuzione del programma, ma non sono quei file ad essere eseguibili nel senso informatico del termine.} c'è anche il file \texttt{toptesi.cfg}. Copiate questo file nella vostra cartella di lavoro come spiegato qui di seguito e modificatelo secondo le vostre necessità.
+
+
+\section{Il file di configurazione}
+
+
+È comodo disporre di un file di configurazione
+\texttt{toptesi.cfg}; il pacchetto \textsf{TOPtesi} contiene già
+un file con la configurazione di default; chiunque se lo può
+modificare come meglio crede; infatti che senso avrebbe una
+configurazione di default se non la si potesse configurare?
+
+Tuttavia non è necessario servirsi del file \texttt{toptesi.cfg}
+né di modificare il file con la configurazione di default,
+perché ogni comando che contenga esplicitamente materiale per il
+frontespizio ridefinisce quanto è definito di default e quindi
+nulla è cristallizzato, fisso e immutabile. Tuttavia il file
+di configurazione semplifica molto la vita e se ne consiglia
+l'uso.
+
+Potete perciò usare un diverso file di configurazione, sempre
+chiamato però \texttt{toptesi.cfg}, collocato nella stessa
+cartella dove risiede il materiale da comporre. Per esempio,
+poteste comporre la monografia di laurea creando da qualche parte
+la cartella \texttt{/monografia} e in questa cartella vi copiate
+\texttt{toptesi.cfg} che poi modificherete a vostro piacimento; in
+questa cartella sistemerete anche i file per comporre la
+monografia. Quando due anni dopo componete la vostra tesi di
+laurea magistrale, create da qualche parte la cartella
+\texttt{/tesi} e mettetevi dentro un copia del file
+\texttt{toptesi.cfg} con la vostra configurazione adattata alla
+tesi magistrale; in questa stessa cartella metterete i file
+relativi alla vostra tesi magistrale. Se dopo tre anni prenderete
+il dottorato e vi scriverete la vostra dissertazione dottorale,
+createvi da qualche parte la cartella \texttt{/dissertazione} e
+mettetevi dentro un'altra copia di \texttt{toptesi.cfg} che
+configurerete per la vostra dissertazione; sempre in questa stessa
+cartella metterete i file necessari per comporre la vostra
+dissertazione.
+
+\section{Il formato PDF/A}
+Il Politecnico di Torino, come anche molte università italiane e straniere, sta cercando di ``smaterializzare'' le copie di archivio delle tesi di laurea. Sono al corrente che oggi (fine 2008) è allo studio un processo per consegnare la copia di archivio della tesi tramite il Portale della Didattica, in modo da eliminare le copie cartacee.
+
+Il problema dell'archiviazione elettronica è che il materiale archiviato deve essere reperibile, leggibile e stampabile anche di qui a, diciamo, cinquanta anni. Per questo è necessario che esso sia archiviato in un formato standard e che nel futuro continuino ad esistere i programmi per la visualizzazione e la stampa di questo formato.
+
+L'Interntional Standards Organization ha pubblicato nel 2005 uno standard per l'archiviazione dei file con la norma ISO 19005-1:2005. Secondo questa norma i file archiviabili devono avere il formato PDF della versione 1.4 e devono soddisfare ad altri requisiti, oltre a contenere un certo numero di \emph{metadata} specificati dalla norma. Esistono due sotto"formati: il PDF/A-1a e il PDF/A-1b. Il formato PDF/A-1a deve rispondere ai requisiti del formato PDF/A-1b oltre ad altri requisiti specifici, in particolare che i font siano tutti inclusi nel file ed abbiano codifica UNICODE e che il file deve mantenere una struttura logica che possa essere esaminata con i motori di ricerca. Viceversa il formato PDF/A-1b, con meno pretese, richiede che i font siano tutti inclusi nel file, anche se non rispettano la codifica UNICODE, e che il file sia riproducibile a schermo e sia stampabile esattamente nello stesso modo di quando il file è stato archiviato. Il Politecnico richiede il sotto'formato PDF/A-1b.
+
+Per questo scopo è necessario usare il programma di composizione \texttt{pdflatex} e il pacchetto specifico \textsf{pdfx} richiedendo nel preambolo del file principale della tesi che sia richiamato il file \texttt{pdfx.sy} con l'opzione giusta, precisamente il preambolo, subito prima di \verb|\begin{document}|, deve contenere la richiesta:
+\begin{verbatim}
+\usepackage[a-1b]{pdfx}
+\end{verbatim}
+Per facilitare la composizione della tesi questa richiesta è già contenuta nella classe \texttt{TOPtesi}, quindi lo studente non deve preoccuparsi di niente, fuorché installare il pacchetto \textsf{pdfx} nel proprio albero locale.
+
+Se questo pacchetto non fosse già caricato con l'installazione del sistema \TeX\ in un albero di sistema, bisogna provvedere scaricando il pacchetto dagli archivi \textsc{ctan} e installandolo nel proprio albero locale. Siccome bisogna provvedere ad una certa personalizzazione, è consigliabile eseguire questa installazione nell'albero locale, perché quando si aggiorna il sistema \TeX, vengono riscritti tutti i file degli alberi di sistema, ma non quelli dell'albero locale.
+
+Non solo, ma il formato PDF/A richiede che sia specificato un profilo di colore; se il sistema non contenesse già il file indicato nella documentazione del pacchetto \textsf{pdfx}, si consiglia di scaricare dalla pagina di download del sito \texttt{www.eci.org} il file \texttt{ECI-RGB.V1.0.icc} e di modificare con questo nome le varie righe del file \texttt{pdfx.sty} che contengono il riferimento ad un file \texttt{icc} o \texttt{.icm} diverso.
+
+Il file \texttt{pdfx.sty} carica anche il file \texttt{hyperref.sty} che permette di eseguire i link interni ed esterni del file PDF. Non è quindi possibile fare a meno di questo file; tuttavia, subito all'inizio del preambolo è possibile personalizzare le informazioni da inserire nel file PDF mediante i parametri dell'argomento del comando \verb|\hypersetup|; a titolo di esempio questo documento informativo è stato composto con questa personalizzazione:
+\begin{verbatim}
+\documentclass[12pt,twoside]{toptesi}
+\hypersetup{%
+ pdfpagemode={UseOutlines},
+ bookmarksopen,
+ pdfstartview={FitH},
+ colorlinks,
+ linkcolor={blue},
+ citecolor={blue},
+ urlcolor={blue}
+ }
+\usepackage[latin1]{inputenc}
+...
+\end{verbatim}
+e, come si vede, la personalizzazione è stata eseguita subito dopo la dichiarazione di classe e prima di invocare altri pacchetti. Naturalmente la personalizzazione indicata è solo indicativa e riportata a titolo di esempio.
+
+I \emph{metadata} di carattere generale sono inseriti nel file di uscita dall'azione diretta del file \texttt{pdfx.sty}; ma questo non può contenere i \emph{metadata} specifici del documento che si sta componendo; è necessario allora predisporre nella cartella dove risiede il file principale della tesi (quello sul quale opera l'eseguibile \texttt{pdflatex}) un file contenente i \emph{metadata} specifici, e che abbia estensione \texttt{xmpdata}. Per esempio, il file principale di questo documento si chiama \texttt{toptesi-doc.tex}: nella cartella dove risiede è stato creato il file \texttt{toptesi-doc.xmpdat} con il seguente contenuto:
+\begin{verbatim}
+\Author{Claudio Beccari}
+\Title{La classe ToPtesi}
+\Keywords{LaTeX</rdf:li><rdf:li>Tesi</rdf:li><rdf:li>PDF/A</rdf:li>%
+<rdf:li>Dissertazione</rdf:li><rdf:li>Monografia}
+\end{verbatim}
+Questa operazione, evidentemente va ripetuta per ogni documento da produrre in formato PDF/A, e quindi bisogna predisporre un diverso file \texttt{.xmpdata} contenente le informazioni specifiche relative allo specifico documento.
+
+Ricordate solo che il pacchetto \textsf{TOPtesi} non contiene nessuna verifica se state componendo con \texttt{pdflatex} oppure con il semplice \texttt{latex} o con qualche altro applicativo del sistema \TeX. Il concetto è che \emph{dovete} usare \texttt{pdflatex}.
+
+Se esistono validi motivi per non usare \texttt{pdflatex} (ma è meglio che vi mettiate nelle condizioni di \emph{non usare} quei pacchetti che richiedano l'uso di comandi PostScript, come per esempio \textsf{PSTriks} o \textsf{XYpic}, ma di usare i pacchetti di grafica come \textsf{pgf} e il suo ambiente \texttt{tikz} che consento di fare quasi tutto quello che si può fare con gli altri pacchetti che richiedono il linguaggio PostScript), allora dovete usare il semplice \LaTeX, e poi convertire il file DVI ottenuto in un file PS; per la conversione in file PDF/A dovete poi usare \texttt{ghostscript}; per come fare dovete consultare il libretto \textit{Saper Cominicare -- Cenni di scrittura tecnico scientifica} e/o la documentazione di \texttt{ghostscript} (versione 8.61 o successiva) in particolare il file \texttt{ps2pdf.html}.
+
+Ricordate solo che produrre un file PDF/A non è semplice, ma se usate \texttt{pdflatex} con i font di default, se incorporate solo figure PNG e JPEG con profilo di colore RGB (red, green, blue), se controllate che ogni file PDF da incorporare contenga al suo interno anche i font che eventualmente sono necessari per comporre il testo che contengono, non dovreste incontrare problemi di certificazione della natura PDF/A del file della vostra tesi.
+
+\section{Pronti? Via!}
+
+Ora siete pronti per comporre la vostra tesi o monografia o
+dissertazione. Ricordate solo di non giocare con quei pochi
+comandi di \LaTeX\ che permettono di fare pasticcetti alla
+WYSIWYG; \LaTeX\ compone da solo benissimo; al massimo, alla fine,
+quando tutto sarà finito e non sarà più necessario apportare
+correzioni, potrete anche inserire qualche spazio fine positivo o
+negativo per fare degli aggiustamenti di seconda o terza
+approssimazione. Ricordatevi però che, anche se non c'è limite
+al meglio (ma nemmeno al peggio!), \LaTeX\ lavora benissimo da
+solo purché non lo si disturbi con interventi non professionali.
+
+\section{I file accessori}
+
+Il pacchetto \textsf{TOPtesi} contiene fra le sue parti il file
+\texttt{topfront.sty} che può essere usato per comporre il solo
+frontespizio. Esso in effetti, oltre a leggere il file di
+configurazione contiene solo i comandi per definire gli elementi
+del frontespizio e per comporlo. La cosa può tornare utile in
+diverse circostanze, per esempio quando dovete ancora modificare
+la tesi quasi ultimata, ma dovete cercare il o i relatori per far
+loro firmare alcune copie del frontespizio.
+
+Basta predisporre un piccolo file come questo, salvandolo con un nome a
+piacere, per esempio, con grande fantasia, \texttt{myfile.tex}:
+\begin{verbatim}
+\documentclass{report}%%%% <--- Nota bene: la classe è report!
+\usepackage[latin1]{inputenc}
+\usepackage[italian]{babel}%%% ci vuole perché topfront ne fa uso
+\usepackage{topfront}
+\candidato{Mario Rossi}
+\titolo{La mia tesi di laurea}
+\relatore{Giovanni Bianchi}
+\sedutadilaurea{Dicembre 2005}
+\begin{document}
+\frontespizio
+\end{document}
+\end{verbatim}
+
+Passando questo piccolo file a \LaTeX\ o a pdf\LaTeX, si ottiene
+un documento di una sola pagina, il frontespizio, che si può
+stampare in varie copie per gli scopi detti sopra. Anche se componete il frontespizio in inglese, non potete fare a meno di chiamare \texttt{babel} perché \texttt{topfront} usa alcuni comandi di quel pacchetto. Naturalmente al posto di \texttt{italian} potete specificare un'altra lingua.
+
+L'altro file accessorio \texttt{topcoman.sty} contiene diversi
+utili comandi, alcuni già incorporati nella definizione della
+lingua italiana del sistema \TeX. Tuttavia se dovete scrivere in
+una lingua diversa dall'italiano quei comandi non sono
+disponibili. Il file contiene anche un comando per la stampa in
+pulito di un programma; ci sono altri pacchetti \LaTeX\ che
+consentono di stampare il listato di un programma, ma visto che vi
+può servire per la tesi e visto che una volta che lo conoscete vi
+potrebbe piacere e poi vorreste continuare ad usarlo, è meglio
+disporne come pacchetto separato. Non sarebbe difficile per
+esempio stamparsi in pulito il listato del proprio programma
+\texttt{myprogram.c}: si scrive semplicemente un file del tipo
+\begin{verbatim}
+\documentclass{report}%%%% <--- Nota bene: la classe è report!
+\usepackage{topcoman}
+\begin{document}
+\chapter{Il programma myprogram.c}
+\listing{myprogram.c}
+\end{document}
+\end{verbatim}
+e lo si passa a \LaTeX\ o a pdf\LaTeX\ per ottenere poi una stampa
+ben composta da conservare per documentazione; per evitare che le
+righe sbordino fuori della larghezza normale del testo, o, peggio
+ancora, fuori dalla carta, sarebbe opportuno che le righe del
+programma non fossero più lunghe di una ottantina di caratteri.
+
+
+\section{Come si comincia}
+Non vi sto a dire niente di come si scriva una tesi; so per
+esperienza che all'inizio ci si sente sperduti davanti allo
+schermo vuoto. Ma voi studenti del Politecnico, e non solo del
+Politecnico, potete scaricare dal portale della didattica del sito
+del Politecnico \texttt{http://didattica.polito.it} l'opuscoletto
+\emph{Saper Comunicare --- Cenni di scrittura tecnico-scientifica}
+dove c'è scritto più o meno tutto quel che bisogna sapere per
+impostare e scrivere un rapporto tecnico-scientifico qual è la
+tesi, la monografia o la dissertazione.
+
+Qui dirò solo come si comincia a scrivere il file sorgente della
+tesi. Ci sono essenzialmente due vie, ognuna delle quali offre vantaggi e svantaggi, quindi non si può dire a priori quale via sia la più indicata:
+\begin{enumerate}
+\item si compone un unico file come esemplificato con il file \texttt{toptesi-example.tex} allegato alla documentazione di \textsf{TOPtesi}. Questo file permette di sperimentare diverse cose semplicemente mettendo o togliendo dei segni di commento all'inizio delle righe del preambolo che contengono alcuni comandi particolari. Esso è completo di bibliografia e quell'unico file permette di comporre una tesi completa; ovviamente può essere usato come modello per la vostra tesi; basta cambiare il contenuto dei comandi che contengono i nomi dei candidati, dei relatori, del titolo, dell'ateneo, della facoltà, eccetera. Ovviamente bisogna cambiare anche il contenuto dei capitoli.
+
+\item Si spezza il file sorgente in un numero adeguato di file parziali da gestire come specificato qui di seguito; ogni file parziale conterrà solo una parte della tesi, per esempio un solo capitolo; siccome il tutto è gestito dal master file, ciascun file parziale non dovrà più contenere la dichiarazione della classe né il preambolo né le righe \verb|\begin{document}| e \verb|\end{document}|, ma solo il materiale relativo ad uno specifico capitolo cominciando apputo con la righa che ne specifica il titolo: \verb|\chapter{Il titolo di questo capitolo}|.
+\end{enumerate}
+
+Avendo già predisposto una scaletta da seguire per comporre la
+tesi e avendo dato un nome a ciascun capitolo (nome un po' più
+furbo di quelli che scriverò io qui a titolo di esempio),
+predisponete un master file con un nome ``diverso'' da
+\texttt{tesi.tex}; sbizzarrite la fantasia, ma che il nome sia
+mnemonico e vi ricordi subito a che cosa vi riferite. Questo
+master file sarà dunque composto così:
+\begin{verbatim}
+ \documentclass[11pt]{toptesi}%% <--- Nota Bene: la classe è toptesi!
+ \ateneo{Università di Bengodi}
+ \nomeateneo{La Saggezza}
+ \titolo{Studi di tricotetratomia applicata}
+ \sottotitolo{Cosa succede quando si spacca un capello in quattro}
+ \candidata{Maria Chiomafolta}
+ \relatore{prof.\ Piero Scapigliati}
+ \sedutadilaurea{Maggio 2006}
+ \includeonly{%
+ preliminari,%
+ capitolo1,%
+ capitolo2,%
+ capitolo3,%
+ appendici,%
+ bibliografia%
+ }
+ \begin{document}
+ \include{preliminari}
+ \include{capitolo1}
+ \include{capitolo2}
+ \include{capitolo3}
+ \appendix
+ \include{appendici}
+ \include{bibliografia}
+ \end{document}
+\end{verbatim}
+
+È da osservare in particolare che l'aver scritto l'argomento di
+\verb+\includeonly+ nel modo esemplificato sopra, permette di
+inserire dei segni di commento all'inizio di alcune delle righe in
+modo da eseguire, per esempio, la compilazione selettiva di un
+solo capitolo conservando tutte le informazioni incrociate
+relative agli altri capitoli già compilati. Con i PC di oggi la
+compilazione è rapidissima, quindi non vi invito a seguire questa
+procedura per risparmiare tempo di compilazione; faccio solo
+notare che il fatto di tenere separate le varie parti della tesi
+permette di lavorare con più ordine e di risparmiare non poco
+tempo nella gestione dei vari file sorgente e nelle loro
+correzioni.
+
+Il file \texttt{preliminari.tex} conterrà presumibilmente il
+comando per comporre il frontespizio, il sommario, molto
+facoltativamente i ringraziamenti\footnote{I ringraziamenti in una
+tesi sono necessari molto raramente, cioè quando bisogna
+ringraziare una istituzione o una o più persone \emph{esterne}
+alla propria università che hanno messo a disposizione le loro
+strutture o le loro competenze per lo svolgimento della tesi. Non
+si ringraziano genitori, fidanzati/e, amici, e tutti i parenti di
+ogni grado, il quali saranno più che contenti di sapervi laureati,
+piuttosto che non vedere il proprio nome scritto sulla tesi\dots.
+Inoltre rappresenta un atto di piaggieria ringraziare il o i
+propri relatori; essi hanno svolto un loro compito istituzionale,
+non vi hanno fatto un piacere. Naturalmente questo non vieta che
+la consuetudine del lavoro assieme non abbia dato origine a
+sentimenti di reciproca stima e anche di amicizia, ma questa è
+un'altra faccenda.} e gli indici.
+
+Il file \texttt{capitolo1.tex} conterrà l'introduzione e in
+pratica esporrà lo stato dell'arte oltre allo scopo del lavoro e
+ai risultati che si vorrebbero ottenere.
+
+I file \texttt{capitolo2.tex}, \texttt{capitolo3.tex}, eccetera,
+conterranno la descrizione del lavoro svolto e l'analisi critica
+dei risultati via via ottenuti; l'ultimo file prima delle
+appendici conterrà le conclusioni.
+
+Nelle varie appendici verranno raccolte le misure eseguite, gli
+sviluppi matematici, i listati dei programmi, le note critiche, le
+lunghe citazioni e tutte le altre cose che rovinerebbero la
+fluidità del testo, se fossero inserite direttamente nel corpo
+della tesi. La bibliografia conclude la tesi.
+
+
+\subsection{La scelta della codifica per il file sorgente}
+
+Si noti che per comporre i file del corpo della tesi si possono
+usare direttamente le lettere accentate della tastiera italiana o
+quelle che si possono ottenere con combinazioni di tasti sia sotto
+Windows sia sotto Linux o Mac~OS~X; per default \textsf{TOPtesi}
+non specifica nessuna particolare codifica dell'input; ma perché
+\LaTeX\ elabori correttamente i file sorgente o non si specifica
+nessuna particolare codifica ma si usano solo i caratteri ASCII a
+7~bit, oppure si usano i caratteri nazionali direttamente da
+tastiera ma si specifica la codifica che l'editor usato ha
+impiegato per salvare nei file i codici dei caratteri non ASCII,
+per esempio le lettere accentate; si suggerisce di specificare
+esplicitamente la codifica mediante il comando
+\begin{verbatim}
+\usepackage[ansinew]{inputenc}
+\end{verbatim}
+per le macchine Windows; invece per le macchine Linux, UNIX e Mac~OS~X
+suggerisco di specificare la codifica con
+\begin{verbatim}
+\usepackage[latin1]{inputenc}
+\end{verbatim}
+
+In particolare vanno accentate anche le lettere maiuscole; siccome la tastiera italiana non le prevede, consiglio di inserire nel preambolo la definizione del comando \verb|\E| per scrivere È. Credo che questa sia la maiuscola accentata più frequente in italiano e le altre non capitano mai all'inizio di un periodo. Il comando:
+\begin{verbatim}
+\newcommand*\E{\`E\space}
+\end{verbatim}
+inserisce direttamente una È all'inizio di un periodo e inserisce direttamente lo spazio successivo, per cui, senza inserire esplicitamente nessun comando di spaziatura dopo il comando \verb|\E|, si può scrivere semplicemente:
+\begin{verbatim}
+\E conveniente rilevare che\dots
+\end{verbatim}
+per ottenere:
+\begin{quote}
+È conveniente rilevare che\dots
+\end{quote}
+Se il vostro editor vi consente di selezionale le maiuscole accentate da una tabella oppure vi consente di usare combinazioni di tasti per inserire direttamente le maiuscole accentate nel file sorgente, fatene uso, perché la lettura del file sorgente ne guadagna moltissimo.
+
+Per scrivere con in lingue dell'Europa orientale e, mi si dice, anche
+in francese, sono migliori altre opzioni di codifica, ma per questo si
+rinvia alla documentazione di \LaTeX.
+
+Certo se il vostro editor lo prevede, e gli editor moderni lo prevedono, potete anche scegliere di codificare i vostri file \texttt{.tex} con la codifica UTF-8; questo, sempre se il vostro editor lo consente, vi permette di scrivere direttamente la vostra tesi inserendo anche delle parti con alfabeti diversi, tutti quelli che i vostri font di uscita vi consentono, dal greco al cirillico, per citare i più vicini a noi, fino al cinese o al giapponese. Ovviamente dovete caricare nel vostro preambolo tutto quello che è necessario per gestire quelle lingue, ma non chiedetemi come si fa, perché so dirvelo solo per il greco. Per questa lingua, se usate l'ortografica monotonika, basta inserire l'opzione della lingua \texttt{greek} fra le opzioni della classe; se usate l'ortografia polytonika, allora dovete richiedere lo specifico attributo seguendo questo procedimento:
+\begin{verbatim}
+\documentclass[...,greek,...]{toptesi}
+...
+\languageattribute{greek}{polutoniko}
+\begin{document}
+...
+\end{document}
+\end{verbatim}
+Per una tesi che tratti il greco antico in forma filologica, consiglio l'uso del pacchetto \textsf{teubner}; visto che l'ho scritto io, un po' di réclame non guasta~\dots\ Bisogna però leggerne la documentazione con attenzione. In particolare conviene ricordare che \textsf{teubner} non viene installato se non è stato precedentemente specificata la lingua greca fra le opzioni, ma poi provvede da solo ad impostare l'attributo \texttt{polutoniko} e tutte le altre caratteristiche necessarie per comporre in greco con il \emph{mark-up} filologico.
+
+Probabilmente per usare le lingue che si scrivono in cirillico, basta specificare l'opzione della lingua, come si fa per il greco. Per alcune altre lingue bisogna invece caricare l'apposito pacchetto, il quale provvede a tutte le impostazioni necessarie; in questi casi bisogna leggere con attenzione la documentazione di quei pacchetti.
+
+Ma, tornando alla codifica UTF-8, il problema non è tanto l'editor che consenta o non consenta di usare quella codifica; quasi tutti i sistemi operativi consentono di installare diversi driver per la tastiera del PC, cosicché con un semplice click del mouse si può passare da un alfabeto all'altro; il problema sono i tasti della tastiera che hanno serigrafato sulla loro faccia il segno che si ottiene premendo quel tasto. Non è ovviamente possibile cambiare il disegno che appare sui tasti, semplicemente cliccando per cambiare driver; forse lo si può fare con le tastiere virtuali dei PC \emph{touch screen}, ma con i PC normali questo non è possibile. Ecco quindi che la difficoltà di scrivere con un alfabeto diverso richiede una memoria ferrea per ricordare a quale segno dell'altro alfabeto corrisponda il tasto della nostra tastiera. Per il greco moderno e classico, se si usano i font di default con la codifica LGR (Local GReek), che vengono installati praticamente con ogni installazione del sistema \TeX\ che non sia proprio una distribuzione essenziale, le corrispondenze con la tastiera latina sono studiate in modo da semplificare molto questo processo di ``memorizzazione''. Tuttavia ad una persona abituata a leggere il greco scritto (giustamente) in greco, vederlo scritto con caratteri latini fa un certo effetto; la documentazione di \textsf{babel} e quella di \textsf{teubner} ricordano questa corrispondenza fra i tasti latini e i segni greci (lettere, accenti, spiriti, segni speciali, ecc.). La corrispondenza fra greco e latino è abbastanza semplice perché il greco ha 24 maiuscole e 25 minuscole, mentre il latino ne ha 26 di ciscun tipo. Non so che cosa succeda con il cirillico che ha un alfabeto composto di più di 30 segni, per cui la corrispondenza con l'alfabeto latino è impossibile.
+
+\subsection{La scelta della codifica per il file di uscita}
+
+Solo per scrivere in inglese non è necessario specificare nessuna codifica per i font da usare per comporre la tesi; questo è vero in quanto l'inglese, fra le lingue più comuni nel mondo occidentale, è l'unico che non fa uso di accenti o altri segni diacritici. Perciò la codifica di default \texttt{OT1} per l'inglese va benissimo e non è necessario specificare nulla.
+
+Invece con questa codifica la presenza di accenti impedisce la divisione in sillabe o ne riduce molto l'efficacia; per l'italiano il problema è relativamente modesto perché normalmente gli accenti compaiono solo sull'ultima vocale delle parole \emph{tronche}. Quindi con questa codifica la parola ``qualità'' viene divisa in ``qua-lità'' invece che in ``qua-li-tà''. Invece in francese una parola come ``électricité'' non viene divisa per niente a causa dell'accento sulla prima vocale.
+
+Allora per tutte le lingue diverse dall'inglese è quanto mai opportuno specificare per i font di uscita la codifica \texttt{T1}. C'è però un problemino, facilmente risolubile, ma bisogna pensarci: i font di default usati da \LaTeX\ e pdf\LaTeX\ sono i font della collezione Computer Modern con codifica \texttt{OT1}; e ogni installazione del sistema \TeX\ li può usare sia nella versione ``bitmapped'' sia in quella PostScript Type~1. Quest'ultima dovrebbe essere quella da usare sempre con il formato PDF del file di uscita, perché questo formato è portabile da una macchina ad un'altra, indipendentemente dal sistema operativo usato. Se poi il file deve essere archiviato esso deve essere in formato PDF, quindi, di fatto non ci sono scelte.
+
+I file della collezione Computer Modern con codifica \texttt{T1}, conosciuti anche come font EC, sono invece distribuiti solo nella forma bitmapped, la quale, oltre ad essere vietata nei file PDF archiviabili, si leggono molto male sullo schermo, se il programma di visualizzazione non è molto ben adattato ai font bitmapped. Esiste il pacchetto \textsf{cm-super} per ovviare a questo inconveniente, ma scaricare dalla rete questo pacchetto enorme richiede molto tempo e poi occupa molto spazio sul disco del vostro~PC. Per aggirare questi inconvenienti bisogna usare i font della collezione Latin Modern, normalmente preinstallati, per cui nel preambolo si specificherà:
+\begin{verbatim}
+\documentclass[...]{toptesi}
+...
+\usepackage[T1]{fontenc}
+\usepackage{lmodern}
+...
+\begin{document}
+...
+\end{verbatim}
+
+Naturalmente per gli utenti esperti di \LaTeX\ ci sono anche altri pacchetti usabili per impiegare altri font diversi da quelli della collezione Latin Modern, che comunque sono i migliori per la loro completezza; grazie al diverso disegno dei corpi minori la lettura dei pedici e degli apici ne risulta agevolata.
+
+Qui segnalo solo la collezione dei font Times eXtendex, richiamabili con il pacchetto \textsf{txfonts}, e la collezione dei font Palatino eXtended, richiamabili con il pacchetto \textsf{pxfonts}. I Times sono font più stretti di quelli della collezione Latin Modern e sono forse indicati per rendere più compatta una tesi un po' voluminosa. I Palatino sono un po' più larghi dei font della collezione Latin Modern e allungano la tesi di qualche pagina.
+
+Tanto per confronto, questo testo di documentazione su \textsf{TOPtesi} è composto con i font di default Computer Modern con codifica \texttt{OT1}; come si vede la divisione delle parole tronche in fin di riga è piuttosto rara e non si presentano inconvenienti particolari; forse con un testo di altro genere, con composizione in colonne strette o all'interno di tabelle, si potrebbe verificare la presenza di righe molto lasche, dove è stato allargato troppo lo spazio interparola. Per questo si consiglia sempre di usare la codifica \texttt{T1} anche per l'italiano; non si sa mai, ma certamente con questa codifica si hanno meno inconvenienti e le lettere accentate sono disegnate meglio\footnote{Questo testo è stato composto facendo uso anche del pacchetto \textsf{microtype}; con questo pacchetto si ottimizza la composizione delle righe di ogni capoverso allo scopo di ridurre al massimo le cesure in fin di riga (in questo testo di una sessantina di pagine, ci sono solo una decina di righe, escluse le tabelle, con la cesura in fin di riga) e di rendere il più omogenei possibile gli spazi interparola; se ne coniglia l'uso, ma certo si tratta di una \emph{raffinatezza}, non di una cosa necessaria. \textsf{microtype} produce gli effetti migliori quando si usano i font PostScript e il motore di composizione pdf\LaTeX.}.
+
+
+\section{Come stampare la tesi}
+
+Il pacchetto \textsf{TOPtesi} contiene anche l'opzione di composizione
+\emph{in bianca e volta}, ma di default compone su una facciata sola
+della pagina.
+
+Qual è la differenza? È quella che si osserva nei libri composti
+meglio, cioè nei libri con i fogli stampati davanti e di dietro:
+quando il libro è aperto la striscia bianca formata dai due
+margini interni delle pagine affacciate è circa uguale a ciascuno
+dei margini esterni. Invece quando si stampa su una facciata sola
+il corpo del testo è centrato e i margini laterali sono
+uguali. Inoltre nelle testatine delle pagine stampate solo in
+bianca compare sempre e solo il titolo del capitolo corrente,
+mentre nelle testatine delle pagine \emph{pari} stampate in bianca
+e volta compare il titolo del capitolo, mentre nelle pagine
+\emph{dispari} compare il titolo del paragrafo con cui comincia la
+pagina.
+
+Molti laureandi ritengono di fare una cosa utile stampando fronte
+e retro, o, come dicono i tipografi, in bianca e volta. Certamente
+è una buona idea, sia perché il fascicolo della tesi viene ad
+assumere un aspetto più professionale, sia perché, ecologicamente
+parlando, si consuma meno carta.
+
+Per questo ho cambiato le impostazioni di default della classe
+\texttt{report}, sulla quale è basata la classe \texttt{toptesi},
+per far sì che comunque la stampa della pagina, sia essa solo in
+bianca o in bianca e volta, appaia sempre con i margini laterali
+uguali.
+
+Ho deciso per questa soluzione perché quando si rilega la tesi,
+necessariamente dal lato della cucitura o dell'incollatura le
+pagine sono piegate e l'insieme dei due margini interni delle
+pagine affacciate appare visivamente più piccolo di ciascuno dei
+margini esterni. Se si stampa solo in bianca invece sarebbe il
+caso di aumentare il margine sinistro; tuttavia non ho realizzato
+questo spostamento non solo perché il margine destro resta di una
+certa ampiezza e può accogliere le note
+marginali\marginpar{\footnotesize\sffamily Questa è una nota a
+margine}, se si decide di farne uso, ma anche perché, almeno al
+Politecnico di Torino, la copia da depositare nella segreteria di
+facoltà non deve essere realizzata in carta, ma deve essere
+registrata su un dischetto o su un CD-ROM in formato \texttt{.pdf}
+(o in formato \texttt{.doc} se non si usa \LaTeX) e chi legge la
+tesi sullo schermo preferisce senz'altro avere il testo centrato
+piuttosto che spostato alternativamente da un lato o dall'altro
+dello schermo.
+
+Però questa soluzione potrebbe non piacere ad alcuni laureandi,
+specialmente se compongono tesi piuttosto voluminose e/o se le
+rilegano con una costola piuttosto rigida. In questo caso la
+classe \texttt{toptesi} accetta l'opzione \texttt{cucitura}
+mediante la quale le facciate di sinistra e di destra vengono
+spostate all'esterno di quasi un centimetro, precisamente di
+7\,mm, per compensare la rigidezza della cucitura e la forte
+curvatura delle pagine causate dallo spessore e/o dal tipo di
+rilegatura. Questo implica che la copia da memorizzare sul CD-ROM
+o sul dischetto dovrà essere compilata senza specificare questa
+opzione, che invece sarà specificata per ricomporre il file prima
+della stampa su carta.
+
+\section{Comporre la tesi in diverse lingue}
+Il pacchetto \textsf{TOPtesi} usa di default il pacchetto
+\texttt{babel} per gestire la composizione in diverse lingue.
+Tuttavia la composizione in lingue diverse dall'inglese (che è la
+lingua di default per una installazione ``vergine'' del sistema
+\TeX) richiede che il sistema sia configurato per gestire diverse
+lingue; perciò le operazioni da fare sono essenzialmente due:
+\begin{enumerate}
+\item configurare il sistema \TeX\ per gestire diverse lingue;
+\item specificare nel comando di apertura del master file di quali altre
+lingue ci si vuole servire \textcolor{red}{oltre all'italiano e all'inglese che sono già automaticamente invocati da \textsf{TOPtesi}}. Si ricorda che non si può più invocare nel preambolo il pacchetto \textsf{babel} per la gestione delle lingue una seconda volta, quando esso è già stato invocato una prima volta nel corpo della classe. Si veda nel seguito come bisogna specificare le ulteriori lingue oltre all'italiano e all'inglese.
+
+\end{enumerate}
+
+
+\subsection{Configurazione iniziale}
+
+Per la prima parte, cioè per configurare il sistema \TeX\ per
+gestire diverse lingue, subito dopo l'installazione lanciate
+\LaTeX\ su un file di prova qualunque, per esempio
+\texttt{sample.tex}, poi apritene il file \texttt{.log},
+nell'esempio \texttt{sample.log}; nelle prime righe di questo file
+troverete le lingue per le quali il vostro sistema già
+configurato.
+
+Per esempio scrivendo questo file di documentazione il file
+\texttt{toptesi-doc.log} contiene nelle prime righe quanto segue:
+\begin{verbatim}
+This is pdfTeX, Version 3.1415926-1.40.10 (TeX Live 2009)
+(format=pdflatex 2009.11.13) 10 MAY 2010 10:37
+entering extended mode
+ \write18 enabled.
+ %&-line parsing enabled.
+**toptesi-doc.tex
+(./toptesi-doc.tex
+LaTeX2e <2009/09/24>
+Babel <v3.8l> and hyphenation patterns for english, usenglishmax,
+dumylang, nohyphenation, german-x-2009-06-19, ngerman-x-2009-06-19,
+ancientgreek, ibycus, arabic, basque, bohairic, bulgarian, catalan,
+pinyin, coptic, croatian, czech, danish, dutch, esperanto, estonian,
+farsi, finnish, french, galician, german, ngerman, monogreek, greek,
+hungarian, icelandic, indonesian, interlingua, irish, italian,
+kurmanji, latin, latvian, lithuanian, mongolian, mongolian2a, bokmal,
+nynorsk, polish, portuguese, romanian, russian, sanskrit, serbian,
+slovak, slovenian, spanish, swedish, turkish, ukenglish, ukrainian,
+uppersorbian, welsh, loaded.
+\end{verbatim}
+
+Chiaramente la mia non è una configurazione di default, ma serve
+per dare una idea di quello che contengono le prime righe del file
+in questione. Se, come è possibile, dopo la prima installazione
+il vostro primo file \texttt{.log} non contiene fra le lingue
+elencate anche l'italiano, allora questa è la cosa più urgente da
+fare; non vorrete mica che la vostra tesi, scritta in italiano,
+abbia le parole divise in sillabe in fin di riga con le regole
+angloamericane? Se poi siete su un programma di doppia laurea e
+dovete scrivere parte della tesi nella lingua dell'università
+straniera di cui prendete l'altro titolo, allora è necessario
+avere disponibile almeno anche quella lingua.
+
+Le regole per inizializzare le lingue gestibili differiscono da
+distribuzione a distribuzione del sistema \TeX. Leggete quindi la
+documentazione che accompagna la vostra distribuzione; qui darò
+alcuni cenni relativi alle distribuzioni che io conosco.
+
+\subsubsection{MiK\TeX}
+Questa distribuzione è senz'altro la più semplice da gestire, fra quelle che hanno bisogno di essere gestite. Si apre il wizard da \texttt{Avvio$|$Programmi$|$MiKTeX$|$MiKTeX\textvisiblespace Set"tings}. Esso apre una finestra di dialogo con diverse linguette; si clicca sulla linguetta Languages e viene aperta un'altra finestra con l'elenco di tutte le lingue gestibili, alcune già con il segno di spunta alla loro sinistra nell'apposito quadratino, altre senza il segno di spunta. Potete cliccare per togliere il segno di spunta sulle lingue già spuntate, ma che non userete mai, e potete aggiungere il segno di spunta cliccando nel quadratino corrispondente alle lingue desiderate.
+
+Poi uscite dal dialogo per la scelta delle lingue cliccando \texttt{OK} e tornate sulla
+linguetta General; qui trovate due bottoni il primo dei quali
+serve per aggiornare il database dei nomi dei file, mentre il
+secondo serve per re-inizializzare i file di formato, cioè quei
+file che contengono già la traduzione in linguaggio macchina di
+tutte le operazioni che la vostra distribuzione del sistema \TeX\
+è capace di compiere con i vari applicativi. La divisione in
+sillabe è una di quelle operazioni che deve essere inizializzata,
+perché richiede strutture dati particolari che sarebbe troppo
+lungo generare di volta in volta. Cliccate sul bottone per
+re-inizializzare i file di formato; alla fine di questa operazione
+potete chiudere il wizard e controllare, dopo aver ricomposto, per
+esempio, \texttt{sample.tex} che le prime righe del file
+\texttt{.log} contengono tutte le lingue che volete usare.
+
+\subsubsection{teTeX e Debian teTeX }
+La distribuzione \texttt{teTeX} non viene più aggiornata da quando esiste \TeX\-live; mi risulta che venga ancora distribuita dai sistemi Linux basati su Debian.
+
+
+Queste distribuzioni di \textsf{teTeX} per Linux basate su Debian per
+la mia esperienza non richiedono nessuna configurazione, perché
+sono già inizializzate per trattare \emph{tutte} le lingue di cui
+il sistema \TeX\ è capace.
+
+Tuttavia, sempre per mia esperienza, ho installato \TeX\-live sulla mia versione Debian di Ubuntu e non ho avuto nessunissimo problema; la distribuzione \TeX\-live è sempre veramente aggiornata in tempo praticamente reale e il suo ``package manager'' consente l'aggiornamento continuo, indipendentemente dalle ``uscite'' annuali di \TeX\-live; mi permetterei di consigliare di non usare \texttt{teTeX} nemmeno nella versione Debian, ma non vorrei passare per un iconoclasta di quella gloriosa distribuzione.
+
+
+\subsubsection{\TeX-live}
+La distribuzione \TeX-live nasce già configurata per tutte le lingue che \LaTeX\ è capace di gestire, quindi anche l'italiano; bisogna ricorrere ai suoi comandi di configurazione solo se si vuole aggiungere una lingua la cui sillabazione non sia distribuita insieme a \TeX\-live. Questo evento è talmente raro che non vale la pena di insistervi sopra. Tuttavia un laureando che svolga la sua tesi sull'ostrogoto altomedievale e disponesse solo della sillabazione per l'ostrogoto classico e per l'ostrogoto contemporaneo, si troverebbe in difficoltà; infatti, prima ancora di inserire le regole per l'ostrogoto altomedievale, dovrebbe scriversi le regole di sillabazione e codificarle nel linguaggio specifico richiesto dal sistema \TeX; questo è tutt'altro che facile ed è riservato a specialisti molto avanzati.
+
+
+\subsubsection{Pro\TeX}
+La distribuzione \textsf{pro\TeX} è per le macchine Windows ma di fatto installa MiK\TeX\ e i programmi accessori con una procedura guidata che dovrebbe semplificare le cose. Essa è distribuita con lo stesso DVD con il quale viene distribuito anche \TeX-live e dovrebbe avere il vantaggio di avere la stessa disponibilità di estensioni che ha \TeX-live. Il DVD è prodotto annualmente dall'associazione degli utenti di \TeX, TUG (\texttt{www.tug.org}); non disponendo di un collegamento internet veloce, si potrebbe risparmiare sulla bolletta del telefono chiedendo alla associazione di inviare per posta il DVD. La configurazione delle lingue gestibili si esegue come indicato per MiK\TeX.
+
+\subsubsection{Mac\TeX}
+Dal 2007 la distribuzione di \texttt{Mac\TeX} sostanzialmente coincide con\TeX-live, salvo che contiene anche programmi accessori specifici per le macchine Macintosh; è preconfigurato per gestire tutte le lingue, compreso l'italiano, di cui il sistema è capace.
+
+
+
+
+\subsubsection{Distribuzioni commerciali}
+Le distribuzioni commerciali differiscono da quelle gratuite
+essenzialmente per i programmi accessori che accompagnano la
+distribuzione del sistema \TeX\ che, di sua natura, è gratuito;
+il costo delle distribuzioni commerciali corrisponde al valore
+delle parti accessorie, all'assistenza per i clienti, eccetera.
+
+Fra le parti accessorie in generale ci sono anche i programmi
+realizzati attraverso comode interfacce grafiche per la
+inizializzazione e l'aggiornamento del software.
+
+Perciò con queste distribuzioni bisogna leggere il manuale di
+istruzioni e provvedere corrispondentemente.
+
+\subsection{Le lingue della tesi}
+
+Di default \textsf{TOPtesi} compone la tesi in italiano e per scrivere
+la tesi in italiano non occorre altro.
+
+Se si devono inserire nella tesi brani di testo in lingua
+straniera, ma lasciando la struttura della tesi in italiano, basta
+elencare i nomi (inglesi) delle lingue da usare nel comando di
+apertura del master file fra le altre opzioni; per esempio, per
+inserire brani in francese si scriverà:
+\begin{verbatim}
+\documentclass[12pt,twoside,french]{toptesi}
+\end{verbatim}
+
+Se invece si vuole scrivere la tesi in inglese, lingua già
+inserita di default in \textsf{TOPtesi}, ma non attivata, bisogna
+dare l'indicazione esplicita dopo l'inizio del documento così:
+\begin{verbatim}
+\documentclass[11pt,cucitura]{toptesi}
+...
+\begin{document}
+\english
+...
+\end{verbatim}
+
+
+Per commutare dall'italiano all'inglese e viceversa basta
+alternare le dichiarazioni \verb|\italiano| e \verb|\english|.
+Attenzione: queste dichiarazioni alterano anche le parole come
+Chapter o Capitolo, Table o Tabella, quindi per inserire brani
+nell'altra lingua è opportuno servirsi dei comandi di
+\texttt{babel}, in particolare l'ambiente \texttt{otherlanguage},
+per esempio:
+\begin{verbatim}
+... disse:
+``\begin{otherlanguage}{english}
+ Mr Livingstone, I suppose\dots
+\end{otherlanguage}''
+e si strinsero la mano.
+\end{verbatim}
+
+L'ambiente \texttt{otherlanguage} è adatto per citazioni
+relativamente lunghe; per citazioni brevi, come quella dell'esempio,
+sarebbe meglio usare così il comando \verb|\foreignlanguage|:
+\begin{verbatim}
+disse: ``\foreignlanguage{english}{Mr Livingstone, I suppose\dots}''
+e si strinsero la mano.
+\end{verbatim}
+
+Invece per comporre la tesi in una lingua diversa dall'italiano e
+dall'inglese bisogna lavorare un pochino di più perché bisogna
+ridefinire alcune cose; per esempio per scrivere la tesi in
+spagnolo bisogna agire così:
+\begin{verbatim}
+\documentclass[12pt,spanish]{toptesi}% <--- la lingua come opzione
+ % della classe!
+\ExtendCaptions{spanish}{Resumen}{Agradecimientos}
+\newcommand*{\spagnolo}{\selectlanguage{spanish}}%
+...
+\begin{document}
+\spagnolo
+...
+\end{document}
+\end{verbatim}
+
+Ovviamente le parole ``Resumen'' (Sommario) e ``Agradecimientos'' (Ringraziamenti) andranno scelte accuratamente; io ho indicato solo ciò che ho trovato sul vocabolario.
+
+È anche possibile servirsi del file di configurazione; per esempio le
+definizioni dei comandi suddetti possono venire scritte nel file di
+configurazione e alternando i comandi \verb|\italiano|, \verb|\english|
+e \verb|\spagnolo| si possono alternare le regole di sillabazione oltre a cambiare le parole \emph{infix}, come Chapter, Capitolo, Capítulo, eccetera.
+
+Per scrivere in lingue che implicano alfabeti diversi da quello
+latino, ovviamente, bisogna aver curato di disporre di una
+configurazione del sistema \TeX\ completa anche dei font che
+servono. Non dovrebbero esserci problemi con il cirillico e con il
+greco; per altri alfabeti e per le lingue che si scrivono da
+destra a sinistra bisogna ovviamente disporre dei pacchetti
+necessari. Si tenga presente che le versioni moderne del sistema
+\TeX\ \emph{non} usano come interprete il programma originario di Knuth,
+ma una la sua estensione che in origine si chiamava $\varepsilon$\TeX; la variante
+che produce il file del documento composto in formato
+\texttt{.pdf} si chiama \texttt{pdftex}, come appare evidente
+dalle prime righe del file \texttt{.log} di questo documento, ma questa versione comprende tutte le estensioni di $\varepsilon$\TeX.
+Bene, queste estensioni servono anche per gestire le lingue
+con scrittura retrograda pur di disporre dei pacchetti relativi a queste lingue.
+
+\chapter{I comandi specifici introdotti da \textsf{TOPtesi}}
+
+\section{Introduzione}
+
+I comandi specifici introdotti da \textsf{TOPtesi} si aggiungono a
+tutti quelli definiti da \LaTeX\ e dalla sua classe standard
+\texttt{report}; mentre questi sono tutti in inglese o sono
+abbreviazioni inglesi, i comandi introdotti da \textsf{TOPtesi} sono
+quasi tutti in italiano o sono abbreviazioni italiane.
+
+Questi comandi sono di diverse categorie; alcuni si possono usare solo
+in modo matematico altri solo in modo testo; alcuni solo nel preambolo,
+alcuni hanno senso solo durante la composizione del testo; alcuni
+servono solo per il frontespizio. Essi saranno descritti nei paragrafi
+seguenti.
+
+\section{Le opzioni}
+La classe \texttt{toptesi} accetta diverse opzioni nel
+comando di di dichiarazione della classe; negli esempi esposti ne sono
+state usate diverse, ma qui forse vale la pena di elencarle tutte
+in ordine, senza ripetere le opzioni già presenti di default per
+la classe \texttt{report}.
+
+
+\begin{description}\def\Item[#1]{\item[\normalfont\texttt{#1}]}
+\Item[chapterbib] serve per specificare che si desidera la composizione della bibliografia alla fine di ogni capitolo; la bibliografia va composta a mano; se si desidera comporla con \textsc{Bib\TeX} si invochi invece il pacchetto \texttt{chapterbib.sty} con il solito comando \verb|\usepackage|. Si abbia cura di leggere attentamente la documentazione di quel pacchetto.
+%
+\Item[classica] Serve per usare delle denominazioni un po' diverse
+dei comandi e per dare una forma diversa al loro contenuto; il
+frontespizio ne viene un poco modificato con un look più adatto
+alle tesi in discipline classiche. Si veda la
+tabella~\ref{tab:front5} per i nuovi comandi disponibili.
+%
+\Item[cucitura] Serve per spostare il testo scritto verso l'esterno
+quando si teme che la piegatura delle pagine verso il centro del
+fascicolo rilegato possa impedire la lettura agevole delle parole
+vicino al margine interno.
+%
+\Item[14pt] Aumenta la possibilità di scelta del corpo normale per
+la composizione della tesi; può contribuire a migliorare la
+lettura quando il testo è fitto di notazioni molto articolate, ma in
+generale il corpo così grande è un trucco per rimpolpare una
+tesi di modeste dimensioni; ne sconsiglio l'uso per questo secondo
+scopo. Avverto che con un corpo così grande è facile che certe
+righe risultino troppo lunghe e vadano a capo in punti non
+adeguati e producano delle righe non giustificate con i messaggi
+d'errore ``Overfull hbox''; questo è un altro motivo per il quale
+sconsiglio di usare questa opzione, se non quando è strettamente
+necessario. Se la si usa, si verifichi che il titolo, i titoli dei
+capitoli, quelli dei paragrafi, eccetera siano composti
+correttamente. In particolare il titolo della tesi e i titoli dei
+capitoli possono andare a capo solo prima di articoli,
+preposizioni semplici o articolate, congiunzioni e brevi avverbi
+come ``non''; per evitare di andare a capo dopo queste parti del
+titolo si abbia l'accortezza di inserire il segno di legame
+\verb|~| fra queste brevi parole e le parole seguenti; per
+esempio, il titolo della tesi fornita come modello va scritto
+nella forma \verb|La~pressione barometrica di~Giove|.
+%
+\Item[autoretitolo] Questa opzione funziona solo se viene
+specificata anche l'opzione \texttt{classica}; se la si inserisce
+senza specificare \texttt{classica}, non succede nulla di male,
+semplicemente la classe informa di aver trovato delle opzioni che
+né lei né altri pacchetti hanno usato. Serve per comporre la
+testatina di sinistra sulle pagine pari con l'indicazione del
+candidato e del titolo della tesi. È ovvio che il titolo della
+tesi con questa opzione deve essere molto breve, ed è per questo
+che è stato messo a disposizione dello studente l'argomento
+facoltativo del comando \verb|\titolo| che consente di specificare
+un titolo di tre o quattro parole (brevi) ma di senso compiuto,
+che possa sostituire il titolo normale, specialmente se questo è
+un po' lungo.
+%
+\Item[oldstyle] Anche questa opzione funziona solamente insieme
+all'opzione \texttt{classica}; serve per scrivere i numeri delle
+pagine con i numeri all'antica, cioè con segni di altezze e
+profondità diverse; si confronti \oldstylenums{1234567890} con
+1234567890.
+%
+\Item[pdfa] Serve per attivare la composizione di un file PDF che possa passare la verifica per la certificazione del formato PDF/A. Attenzione: si ricorda che questa operazione viene eseguita tramite l'uso del file \texttt{pdfx.sty} che a sua volta richiama il file \texttt{hyperref.sty} con la giusta opzione per il formato PDF/A. Eventuali personalizzazioni per configurare gli stili di composizione dei link generati da \texttt{hyperref.sty} devono essere dichiarate subito dopo la dichiarazione della classe. Se si specificano queste personalizzazioni, ma non è stata data l'opzione \texttt{pdfa}, viene prodotto un errore terminale. Inoltre bisogna ricordarsi di predisporre il file \texttt{.xmpdata} contenente i \emph{metadata} relativi al documento specifico come si è già spiegato in precedenza.
+\end{description}
+
+
+\section{Comandi di tipo generale}
+I comandi di tipo generale si possono usare in ogni contesto, in
+particolare alcuni sono fatti per essere usati sia in modo testo sia in
+modo matematico. Essi sono raccolti nella tabella~\ref{tab:generale}.
+
+\begin{table}\def\V{\rule{0pt}{2.5ex}}
+\def\cs#1{\texttt{\string#1}}
+\centering \footnotesize
+\begin{tabular}{llp{.3\textwidth}p{.3\textwidth}}
+ \hline
+ Comando\V & Default & Scopo & Esempio d'uso \\[.5ex]
+ \hline
+ \cs{\interlinea\string{\dots\string}} &
+ 1.0 & Modifica l'argomento di
+ \cs{\linespread}\newline \textcolor{red}{NON usare se non costretti con la forza!}\newline Modo testo &
+ \cs{\interlinea\string{1.05\string}} \newline
+ oppure \newline
+ \cs{\begin\string{interlinea\string}\string{1.05\string}} \newline
+ \dots\newline
+ \cs{\end\string{interlinea\string}}\newline
+ Vedi annotazioni sull'interlinea nel testo\\
+\cs{\ohm} & & Omega ``diritto''\newline
+ Modi testo e matematico & \texttt{45\string\ohm}\\
+\cs{\ped\string{...\string}}&
+ nessuno & Pedice in tondo\newline
+ Modi testo e matematico & \texttt{\string$V\string\ped\string{eff\string}\string$} \\
+\cs{\unit\string{...\string}}&
+ nessuno & Unità di misura in
+ tondo unite al numero\newline
+ Modi testo e matematico &
+ \texttt{15\string\unit\string{k\string\ohm\string}} \\
+\cs{\gei} & & Unità immaginaria in
+ tondo \newline
+ Solo modo matematico &
+ \texttt{\string$\string\eu\string^\string{\string\gei\string\omega\ t\string}\string$} \\
+\cs{\eu} & & Numero ``e'' in tondo\newline Solo modo matematico &
+ \texttt{\string$\string\eu\string^\string{\string\gei\string\omega\ t\string}\string$} \\
+\cs{\gradi} & & circoletto alzato\newline Modo testo e %!TEX encoding =
+ matematico &
+ \texttt{27\string\unit\string{\string\gradi\ C\string}} \\
+\cs{\listing\string{...\string}}&
+ nessuno & Listato di un programma in caratteri typewriter &
+ \texttt{\string\listing\string{toptesi.tex\string}}\\[.5ex]
+\hline
+\end{tabular}
+\caption{Comandi di tipo generale}\label{tab:generale}
+\end{table}
+
+Vale la pena di commentare sull'uso dell'ambiente \texttt{interlinea} e/o del comando \texttt{\string\interlinea}.
+
+Il primo confina il suo effetto all'interno dell'ambiente da lui
+stesso formato; il secondo agisce come una dichiarazione che resta
+in vigore finché una dichiarazione contraria non ne modifica il
+valore.
+
+\textcolor{red}{Tuttavia sia l'ambiente sia il comando non dovrebbero essere mai usati!}
+La composizione tipografica non ha nulla a che vedere con la
+composizione dattilografica (\emph{absit iniuria verbis}!).
+Quest'ultima si faceva con mezzi avanzati per l'epoca, ma oggi quei
+mezzi sono del tutto obsoleti; le poche macchine da scrivere
+meccaniche o elettromeccaniche che esistono ancora fuori da qualche
+museo, vengono usate per riempire formulari o compilare le informazioni
+sui documenti cartacei che sopravvivono alla invasione delle carte
+plastificate; forse qualche ufficio di notaio fa ancora uso di quelle
+macchine; ma tolti gli usi burocratici non mi viene in mente nessun
+altro uso degno di essere citato.
+
+La composizione tipografica esige un perfetto equilibrio fra il
+corpo del font usato e la distanza fra due righe successive,
+distanza che prende il nome tecnico di \emph{avanzamento di riga};
+questo avanzamento a seconda del font in uso può essere dal 10\%
+al 20\% maggiore del corpo del font usato.
+
+Questa documentazione è scritta in corpo 12\,pt e l'avanzamento
+di riga è di 14,5\,pt; si dice che questo testo è composto in
+corpo 12/14,5.
+
+\begin{interlinea}{1.05}
+L'interlinea era originariamente lo spazio aggiuntivo da inserire
+fra una linea e l'altra; quando la composizione tipografica era
+eseguita con font ricavati da punzoni metallici, l'interlinea era
+la striscia di metallo che veniva interposta fra una riga di
+caratteri metallici e la successiva. Il comando
+\texttt{\string\interlinea} e l'ambiente corrispondente hanno
+pertanto dei nomi che si rifanno alla tipografia tradizionale, ma
+vengono usati come in dattilografia. In effetti l'argomento del
+comando e dell'ambiente serve solo come fattore moltiplicativo
+dell'avanzamento di riga; porre questo fattore al valore
+\texttt{1.05} vuol dire moltiplicare l'avanzamento di riga per
+1,05 portandolo quindi al valore di 15,5225\,pt. Questo capoverso
+è composto con questo fattore impostato con l'ambiente
+\texttt{interlinea} e, nonostante si tratti solo di un aumento del
+5\% dell'avanzamento di riga, l'occhio lo percepisce in modo più
+grande di quanto non faccia pensare il suo piccolo valore.
+\end{interlinea}
+
+L'avanzamento di default scelto per i caratteri in uso è
+l'avanzamento otticamente ottimale; se desideraste usare un font
+diverso da quello di default, potreste, per esempio, invocare il
+pacchetto \texttt{pxfonts} per usare il Palatino esteso come font
+di testo. Siccome questo font a pari corpo ha le minuscole
+decisamente più grandi di quelle dei font di default, potrebbe
+essere una idea sensata quello di sperimentare con diversi valori
+del fattore di \texttt{interlinea}, ma poi si scoprirebbe che
+questo fattore differirebbe di pochi centesimi dall'unità e quindi
+ci sarebbe da domandarsi se ne valga la pena.
+
+Se proprio volete stampare delle bozze su carta scritte abbastanza
+larghe per potervi inserire le correzioni e le annotazioni a mano,
+allora impostate il fattore di \texttt{interlinea} al massimo a
+\texttt{1.5}, ma quando stampate la bella copia, la versione finale,
+ricordatevi di re-impostare per \texttt{interlinea} il valore unitario
+di default.
+
+Tra l'altro non vorreste mica usare l'espediente di un grande fattore
+di interlinea solo per rimpolpare una tesi dal volume modesto? Esso
+sarebbe un espediente talmente puerile che sarebbe scoperto al primo
+sguardo. Ricordate che ci sono state in passato tesi che non superavano
+le 30~pagine dattiloscritte o scritte a mano (!) e sulle quali si sta
+studiando ancora oggi dopo più di 50~anni!
+
+
+\section{Comandi per il frontespizio}
+
+I comandi per la composizione del frontespizio debbono essere
+tutti inseriti nel preambolo, cioè prima di
+\verb|\begin{document}|.
+\begin {table}[p]
+\def\V{\rule{0pt}{2.5ex}}
+\def\cs#1{\texttt{\string#1}}\let\s\string
+\def\d{\discretionary{\%}{}{}}
+\makebox[\textwidth]{%
+\begin {tabular}{p{.3\textwidth}p{.2\textwidth}p{.2\textwidth}p{.25\textwidth}}
+\hline
+Comando\V & Default & Scopo & Esempio d'uso \\[.5ex]
+\hline
+\cs{\ateneo\s{...\s}}\V&POLITECNICO DI TORINO& Definisce il nome generico dell'Ateneo &
+ \cs{\ateneo\{II Università di Roma\}} \\
+\cs{\nomeateneo\s{...\s}}& nessuno& Definisce il nome proprio dell'Ateneo &
+ \cs{\nomeateneo\{Tor Vergata\}} \\
+\cs{\facolta[...]\s{...\s}}& Ingegneria& Definisce il nome della
+Facoltà opzionalmente con l'indicazione dell'ordinale&
+ \cs{\facolta[III]\d\{Scienze\}} \\
+\cs{\corsodilaurea\s{...\s}}& nessuno& Definire il nome del corso di laurea &
+ \cs{\corsodilaurea\d\{Fisica\}} \\
+\cs{\corsodidottorato\{...\}}& nessuno&Definisce il nome del corso di dottorato&
+ \cs{\corsodidottorato\d\{Fisica\}} \\
+\cs{\monografia\{...\}}&nessuno&Definisce il titolo della monografia e imposta lo stile del frontespizio&
+ \cs{\monografia\d\{Il~teorema di Eulero\}}\\
+\cs{\titolo[...]\{...\}}&nessuno&Definisce il titolo della tesi o della dissertazione&
+ \cs{\titolo\d[La~pressione]\d\{La~pressione di Giove\}}\\
+\cs{\sottotitolo\{...\}}&nessuno&Definisce il sottotitolo della tesi o della dissertazione&
+ \cs{\sottotitolo\{Metodo Barometrico\}} \\
+\cs{\Materia\{...\}}&nessuno&Definisce la materia su cui verte la tesi &
+ \cs{\Materia\{Remote Sensing\}} \\
+\cs{\materia\{...\}}&nessuno&sinonimo di \cs{\Materia} &
+ \cs{\materia\d\{Letteratura ostrogota\}} \\[.5ex]
+\hline
+\end{tabular}}
+\caption{Comandi per il frontespizio della monografia di laurea, della
+tesi di laurea e della dissertazione di dottorato
+(\emph{continua})}\label{tab:front1}
+\end{table}
+
+\addtocounter{table}{-1}
+\begin{table}[p]
+\def\V{\rule{0pt}{2.5ex}}
+\def\cs#1{\texttt{\string#1}}\let\s\string
+\def\d{\discretionary{\%}{}{}}
+\makebox[\textwidth]{%
+\begin {tabular}{p{.3\textwidth}p{.2\textwidth}p{.2\textwidth}p{.25\textwidth}}
+\hline
+Comando\V & Default & Scopo & Esempio d'uso \\[.5ex]
+\hline
+\cs{\relatore\{...\}}\V&nessuno& Definisce il nome del relatore&
+ \cs{\relatore\d\{prof.\s~Albert Einstein\}} \\
+\cs{\secondorelatore\{...\}}&nessuno&Se c'è, definisce il nome del secondo relatore&
+ \cs{\secondorelatore\d\{dott.\s~Grazia Deledda\}}\\
+\cs{\terzorelatore\{...\}}&nessuno&Se c' è, definisce il nome del
+terzo relatore&
+ \cs{\terzorelatore\d\{ing.\s~Thomas A.\s~Edison\}}\\
+\cs{\direttore\{...\}}&nessuno&Definisce il nome del direttore del ciclo di dottorato&
+ \cs{\direttore\d\{prof.\s~Albert Enstein\}}\\
+\cs{\coordinatore\{...\}}&nessuno&Definisce il nome del coordinatore del ciclo di dottorato&
+ \cs{\coordinatore\d\{prof.\s~Albert Einstein\}}\\
+\cs{\tutore\{...\}}&nessuno&Definisce il nome del tutore&
+ \cs{\tutore\d\{prof.\s~Karl Von Braun\}} \\
+\cs{\candidato\{...\}}&nessuno&Definisce il nome del candidato&
+ \cs{\candidato\{Galileo Galilei\}} \\
+\cs{\candidata\{...\}}&nessuno&Definisce il nome della candidata&
+ \cs{\candidata\{Maria Curie\}} \\
+\cs{\secondocandidato\{...\}}&nessuno&Se c'è , definisce il nome
+del secondo candidato&
+ \cs{\secondocandidato\d\{Evangelista Torricelli\}}\\
+\cs{\secondacandidata\{...\}}&nessuno&Se c'è , definisce il nome
+della seconda candidata&
+ \cs{\secondacandidata\d\{Rita Levi Montalcini\}}\\
+\cs{\terzocandidato\{...\}}&nessuno& Se c'è, definisce il nome del
+terzo candidato&
+ \cs{\terzocandidato\d\{Alessandro Volta\}} \\
+\cs{\terzacandidata\{...\}}&nessuno&Se c'è, definisce il nome della terza candidata&
+ \cs{\terzacandidata\d\{Eleonora Duse\}}\\[.5ex]
+\hline
+\end{tabular}}
+\caption{Comandi per il frontespizio della monografia di laurea, della
+tesi di laurea e della dissertazione di dottorato (\emph{continua})}\label{tab:front2}
+\end{table}
+
+\addtocounter{table}{-1}
+\begin{table}
+\def\V{\rule{0pt}{2.5ex}}
+\def\cs#1{\texttt{\string#1}}\let\s\string
+\def\d{\discretionary{\%}{}{}}
+\makebox[\textwidth]{%
+\begin {tabular}{p{.3\textwidth}p{.2\textwidth}p{.2\textwidth}p{.25\textwidth}}
+\hline
+Comando\V & Default & Scopo & Esempio d'uso \\[.5ex]
+\hline
+\cs{\sedutadilaurea\{...\}}\V&data corrente &Definisce il mese e l'anno (volendo il giorno) della seduta di laurea&
+ \cs{\sedutadilaurea\d{Dicembre~2005}}\\
+\cs{\esamedidottorato\{...\}}&data corrente&Definisce il mese e l'anno (volendo il giorno) della seduta di discussione&
+ \cs{\esamedidottorato\d\{Febbraio~2003\}}\\
+\cs{\ciclodidottorato\{...\}}&nessuno&Definisce il numero ordinale del ciclo di dottorato&
+ \cs{\ciclodidottorato\d\{XV~ciclo\}} \\
+\cs{\logosede\{...\}}&nessuno&Inserisce nel frontespizio il logo dell'ateneo&
+ \cs{\logosede\d\{logopolito\}}\\[.5ex]
+\hline
+\end{tabular}}
+\caption{Comandi per il frontespizio della monografia di laurea, della
+tesi di laurea e della dissertazione di dottorato}\label{tab:front3}
+\end{table}
+
+
+\begin{table}[p]
+\def\V{\rule{0pt}{2.5ex}}
+\def\cs#1{\texttt{\string#1}}\let\s\string
+\def\d{\discretionary{\%}{}{}}
+\def\serve{definisce una stringa equivalente a }
+\makebox[\textwidth]{\small%
+\begin{tabular}{@{}p{.35\textwidth}p{.65\textwidth}@{}}
+\hline
+\cs{\FacoltaDi\{...\}}\V & \serve ``Facoltà di'' prima del nome della facoltà \\
+\cs{\DottoratoIn\{...\}} & \serve ``Dottorato in'' prima del nome del dottorato\\
+\cs{\CorsoDiLaureaIn\{...\}} & \serve ``Corso di Laurea in'' prima del nome del corso di laurea\\
+\cs{\TesiDiLaurea\{...\}} & \serve ``Tesi di Laurea''\\
+\cs{\NomeMonografia\{...\}} & \serve ``Monografia di Laurea''\\
+\cs{\NomeDissertazione\{...\}} & \serve ``Dissertazione di Dottorato''\\
+\cs{\InName\{...\}} & \serve ``in''; in tedesco potrebbe essere ``auf'', in francese ``en'', ecc.\\
+\cs{\CandidateName\{...\}} & \serve ``Candidato''; per questo e i due comandi successivi il programma riesce
+ a scegliere la stringa giusta adattata in numero e genere; nel cambiare queste stringhe
+ il compositore ha una sola possibilità e deve scegliere direttamente il genere e il numero.\\
+\cs{\AdvisorName\{...\}} & \serve ``Relatore''\\
+\cs{\CoAdvisorName\{...\}} & \serve ``Correlatore''; questo comando si può usare sempre, ma il suo contenuto viene effettivamente usato solo se si specifica l'opzione \texttt{classica}; se in italiano non piace ``Correlatore'' ma si preferisce ``Corelatore'' o ``Co-relatore'', sempre con l'opzione \texttt{classica}, si può correggere la versione di default.\\
+\cs{\TutorName\{...\}} & \serve ``Tutore''\\
+\cs{\NomeTutoreAziendale\{...\}}& \serve ``Supervisore aziendale''; usando un argomento che contenga anche
+ indicazioni di ``a capo'', nella seconda riga si può scrivere il nome dell'azienda.\\
+\cs{\CycleName\{...\}} & \serve ``ciclo''; serve essenzialmente per indicare il ciclo di dottorato\\
+\cs{\NomePrimoTomo\{...\}} & \serve ``Tomo primo''\\
+\cs{\NomeSecondoTomo\{...\}} & \serve ``Tomo secondo''\\
+\cs{\NomeTerzoTomo\{...\}} & \serve ``Tomo terzo''\\
+\cs{\NomeQuartoTomo\{...\}} & \serve ``Tomo quarto''; tutte e quattro queste stringhe dipendono dalla lingua
+ usata e dall'ordine che si vuole o si deve dare alle due parole.\\[.5ex]
+\hline
+\end{tabular}}
+ \caption{Comandi per modificare le parole e/o le brevi frasi scritte
+nel frontespizio o per cambiare le parole italiane di default in altre
+parole diverse, o per esprimere gli stessi concetti in un'altra
+lingua}\label{tab:front4}
+\end{table}
+
+I comandi di questa sezione possono essere introdotti in un
+ordine qualunque, ma è più chiaro se sono introdotti nell'ordine
+in cui sono elencati.
+
+Essi possono anche essere scritti nel file di configurazione
+\texttt{toptesi.cfg}, anzi, direi che è meglio che siano inseriti
+in quel file, lasciando nel preambolo solo quelli che cambiano i
+valori di default o che inseriscono informazioni non presenti di
+default.
+
+Alcuni comandi sono generali; altri si riferiscono specificatamente
+alla monografia di laurea, alla tesi laurea, o alla dissertazione di
+dottorato.
+
+La differenza è che generalmente la monografia di laurea non ha
+un relatore; se nella vostra facoltà anche la monografia di laurea
+ha un relatore comportatevi come per la tesi di laurea. Se nel
+vostro ateneo o nella vostra facoltà succede così, allora inserite
+nel file di configurazione il seguente comando
+\begin{verbatim}
+\TesidiLaurea{Tesi di Laurea Specialistica}
+\end{verbatim}
+oppure cambiate ``Specialistica'' in `Magistrale'' se così è l'uso
+della vostra facoltà o del vostro ateneo. Similmente cambiate le
+stringhe inserite dai vari comandi facendo ampio uso dei comandi
+esposti nelle tabelle~\ref{tab:front1}--\ref{tab:front4}, in
+particolare inserendoli nel file di configurazione, specialmente
+se devono rappresentare delle modifiche ``permanenti''; usateli
+anche per predisporre quelle stringhe in una lingua diversa
+dall'italiano.
+
+Per comporre questo manuale si è usata la classe \texttt{toptesi},
+e si è supposto di scrivere una monografia; tuttavia alcune
+delle stringhe di default non sono adeguate all'uso, quindi il
+preambolo di questo documento contiene le seguenti specificazioni
+che illustrano l'impiego di diversi fra i comandi descritti nelle
+tabelle citate:
+\begin{verbatim}
+ \NomeMonografia{Manuale d'uso}
+ \monografia{La classe \textsf{TOPtesi}}
+ \sottotitolo{Per comporre le tesi al Poli\\
+ e in molte altre università}
+ \candidato{Claudio Beccari}
+ \sedutadilaurea{Versione \fileversion}
+ \logosede{logopolito}
+\end{verbatim}
+
+Vale la pena di fare le seguenti osservazioni:
+\begin {itemize}
+\item \texttt{\string\titolo} non deve
+essere usato per la monografia (ma \texttt{\string\sottotitolo} si
+può usare, come si è fatto per il frontespizio di questo
+manuale); per la monografia il comando \texttt{\string\monografia}
+imposta sia il titolo sia le altre informazioni che distinguono la
+monografia da una tesi di laurea (magistrale).
+%
+\item Il comando \texttt{\string\titolo} accetta un argomento facoltativo, la versione breve
+del titolo del frontespizio; serve con l'opzione \texttt{classica} e l'opzione
+\texttt{autoretitolo}, dove il titolo breve va nella testatina delle pagine;
+se il titolo del frontespizio fosse troppo lungo la testatina verrebbe
+molto male!
+%
+\item Non dare i comandi \texttt{\string\relatore}, \texttt{\string\secondorelatore}
+e \texttt{\string\terzorelatore} né per la dissertazione di
+dottorato né per la monografia.
+%
+\item L'indicazione della materia su cui si svolge la tesi di laurea
+o di dottorato non viene normalmente indicata se non, talvolta,
+nelle facoltà umanistiche.
+%
+\item I secondi e terzi candidati non hanno senso né per
+le tesi di dottorato né per le monografie.
+%
+\item Per la monografia l'informazione della data può essere omessa
+se non c'è una data per la presentazione.
+%
+\item Il pacchetto \textsf{TOPtesi} contiene i loghi del Politecnico
+di Torino, del Politecnico di Bari e dell'Institut National
+Polytechnique de Grenoble; delle Università di Torino, del
+Piemonte Orientale, di Genova, di Pavia, di Padova, di Trieste, di
+Bologna (di cui questa Università specifica il corretto uso), di
+Pisa, di Urbino, delle tre Università di Roma, di quelle di Bari e
+di Palermo; questi loghi sono forniti nei formati \texttt{.pdf} e
+\texttt{.eps}\footnote{Ahimè , alcuni di questi loghi sono stati
+ricavati con una risoluzione troppo bassa; se dovete inserire il
+logo di una di queste sfortunate università il cui logo è di
+bassa qualità grafica, cercate di informarvi all'ufficio giusto
+per avere l'autorizzazione per scaricare un logo di qualità
+grafica migliore.}.
+
+È ovvio che prima di usare un logo, del quale ogni università è
+piuttosto gelosa, bisogna essere sicuri di non commettere un
+illecito. Prima di usare qualsiasi logo informatevi
+dall'istituzione rappresentata da quel simbolo sul suo uso
+corretto e legale.
+\end{itemize}
+
+Per quanto riguarda i loghi, la loro inserzione implica l'uso del
+pacchetto \texttt{graphicx}, che \textsf{TOPtesi} carica di
+default; specificare nuovamente quel pacchetto non produce nessun
+danno, perché \LaTeX\ controlla da solo se lo deve caricare o non
+lo deve ricaricare.
+
+Tuttavia va segnalato un punto che dovrebbe essere evidente dal
+fatto che sono presenti le figure dei loghi sia nel formato
+\texttt{.eps} gestibile da \LaTeX\ e \texttt{dvips}, sia nel
+formato \texttt{.pdf} gestibile da {pdf\LaTeX}. I due insiemi di
+formati sono disgiunti, nel senso che non esiste un formato su cui
+possano operare indifferentemente sia \LaTeX\ sia pdf\LaTeX,
+tranne il formato dei file prodotti dal programma MetaPost, che è
+assai raro e poco usato, certamente non usato per i loghi.
+
+\textcolor{red}{Questa osservazione vale anche per tutte le altre figure da
+importare nel documento da file esterni. La cosa è scritta a
+chiare lettere nella guida \texttt{grfguide} che accompagna ogni
+distribuzione del sistema \TeX, ma è un fatto che viene
+dimenticato troppo spesso e che obbliga a cercare aiuto da chi ne
+sa di più, compagni o professori, ma che anche loro talvolta
+dimenticano.}
+
+\textcolor{red}{Esistono programmi per passare da un formato all'altro, ma anche
+disponendo di quei programmi e conoscendo i vantaggi e gli
+svantaggi di un formato rispetto ad un altro, questa operazione
+viene dimenticata troppo spesso, perché troppo spesso ci si
+dimentica di questa incompatibilità.}
+
+Per questo io preferisco usare sempre e solamente il compilatore
+pdf\LaTeX, se non altro perché accetta un maggior numero di
+formati grafici. L'unico inconveniente è che non posso usare il
+pacchetto \texttt{PSTricks}; ma finora me la sono cavata molto
+bene anche senza le prestazioni di questo bellissimo pacchetto.
+
+
+\section{Altri comandi}
+Il pacchetto \textsf{TOPtesi} richiede l'uso di altri comandi il
+più notevole dei quali è senza dubbio \verb|\frontespizio|. È un comando che
+non vuole argomenti e che va dato all'inizio, subito dopo
+l'apertura del documento o all'inizio del primo file incluso dal
+master file. Si veda comunque la tabella~\ref{tab:comandi}.
+
+\begin{table}
+\def\V{\rule{0pt}{2.5ex}}
+\def\cs#1{\texttt{\string#1}}\let\s\string
+\def\d{\discretionary{\%}{}{}}
+\makebox[\textwidth]{%
+\begin {tabular}{p{.25\textwidth}p{.25\textwidth}p{.4\textwidth}}
+\hline
+Comando\V & Default & Scopo \\[.5ex]
+\hline
+\cs{\figurespagetrue}&\cs{\figurespagefalse}& Fa o non fa stampare l'indice delle figure\\
+\cs{\tablespagetrue}&\cs{\tablespagefalse}&Fa o non fa stampare l'indice delle tabelle\\
+\cs{\frontespizio} & nessuno & Fa stampare il frontespizio \\
+\cs{\sommario} &nessuno & Inizia un capitolo non numerato che ha per
+ intestazione la parola SOMMARIO (anche in lingua)\\
+\cs{\ringraziamenti}&nessuno & Inizia un capitolo non numerato
+ che ha per intestazione la parola
+ RINGRAZIAMENTI (anche in lingua)\\
+\cs{\indici} &nessuno & Fa stampare l'indice generale, e,
+ se sono stati dati i comandi
+ \texttt{\char92figures"page"true} e
+ \texttt{\char92tables"page"true},
+ anche gli indici delle figure e delle
+ tabelle.\\[.5ex]
+\hline
+\end{tabular}}
+\caption{Comandi ulteriori di \textsf{TOPtesi}}\label{tab:comandi}
+\end{table}
+
+
+Ovviamente perché il comando esegua il suo compito, tutte le
+informazioni rilevanti devono già essere state scritte nel file di
+configurazione o i comandi specifici con i loro argomenti devono
+essere già stati posti nel preambolo.
+
+Nella figura~\ref{fig:frontespizi} sono riportati quattro esempi di frontespizi relativi ai tipi di tesi seguenti:
+\begin{itemize}
+\item tesi di laurea del Vecchio Ordinamento,
+\item monografia di laurea,
+\item tesi di laurea specialistica o magistrale,
+\item dissertazione di dottorato
+\end{itemize}
+Con questi modelli lo studente che compila la sua tesi usando
+\textsf{TOPtesi} può scegliere la versione che fa al caso suo e sa
+anche che cosa deve configurare per eseguire alcuni cambiamenti.
+\enlargethispage*{3\baselineskip}
+
+\begin{figure}[!htp]\centering
+\begin{minipage}{.45\textwidth}\centering
+\frame{\includegraphics[width=\linewidth]{tesilaurea}}
+\end{minipage}\hfil
+\begin{minipage}{.45\textwidth}\centering
+\frame{\includegraphics[width=\linewidth]{monografia}}
+\end{minipage}\\[\bigskipamount]
+\begin{minipage}{.45\textwidth}\centering
+\frame{\includegraphics[width=\linewidth]{laureaspecialistica}}
+\end{minipage}\hfil
+\begin{minipage}{.45\textwidth}\centering
+\frame{\includegraphics[width=\linewidth]{tesidottorato}}
+\end{minipage}
+\caption{I quattro frontespizi fondamentali}\label{fig:frontespizi}
+\end{figure}
+
+
+
+
+\begin{table}[p]
+\def\V{\rule{0pt}{2.5ex}}
+\def\cs#1{\texttt{\string#1}}\let\s\string
+\def\d{\discretionary{\%}{}{}}
+\makebox[\textwidth]{%
+\begin {tabular}{p{.2\textwidth}p{.7\textwidth}}
+\hline
+Comando\V & Scopo \\[.5ex]
+\hline
+\cs{\candidato}\V &Si usa come di solito ma con l'opzione \texttt{classica}
+ produce la scrittura ``Laureando'' invece che ``Candidato''.\\
+\cs{\candidata} & Come sopra al femminile.\\
+\cs{\tomo} & Esegue i frontespizi successivi di una tesi divisa in tomi
+ scrivendovi Tomo primo, Tomo secondo, eccetera,
+ a seconda del numero progressivo dei volumi in cui è suddivisa la tesi
+ (massimo quattro).\\
+\cs{\annoaccademico} & Il suo argomento può essere un anno solare o
+due anni separati da una lineetta.
+ Viene scritto nel frontespizio della tesi o del singolo tomo
+ con la specificazione che si tratta dell'anno accademico e non della data
+ della presentazione della tesi.\\
+\cs{\EnDash} & Produce una lineetta lunga come ---, ma ribassata in modo che stia
+ bene fra numeri di stile antico.\\
+\cs{\nota[...]} & Serve per comporre una nota senza ricorrere al contatore numerico di default.
+ Il simbolo con cui viene richiamata di default è l'asterisco, ma si può
+ mettere qualunque segno matematico senza esplicitare i segni di dollaro,
+ per esempio si può scrivere \cs{\nota[\s\dagger]\{Questa nota \dots\}}\\
+\texttt{dedica} & È un ambiente con cui si può stampare una
+pagina di dedica;
+ generalmente questa pagina viene prima del frontespizio.\\
+\texttt{citazioni} & È un ambiente che consente di scrivere una pagina con frasi argute.
+ L'arguzia dipende dall'autore; spesso nei libri, raramente nelle tesi,
+ l'autore cita frasi celebri o che in qualche modo hanno a che fare con
+ il contenuto del testo.\\
+\cs{\paginavuota} & Emette nel file di uscita una pagina totalmente bianca, senza nemmeno
+ il numero della pagina. Non so a che cosa possa servire, ma non costa niente
+ mettere a disposizione anche questo comando che mi è stato richiesto a gran voce.\\
+\cs{\NoteWhiteLine} & Anche questo comando mi è stato richiesto a
+gran voce e serve per mettere
+ in nota una riga completamente bianca.\\[.5ex]
+\hline
+\end{tabular}}
+\caption{Comandi ulteriori per il frontespizio e per il corpo
+della tesi definiti con l'opzione
+\texttt{classica}}\label{tab:front5}
+\end{table}
+
+
+\chapter*{Conclusioni}
+\addcontentsline{toc}{chapter}{Conclusioni}
+
+Il pacchetto \textsf{TOPtesi} fa quasi tutto quello che è
+necessario per comporre uno qualunque di quegli scritti che
+vengono chiamati \emph{monografia di laurea}, oppure \emph{tesi di
+laurea}, oppure \emph{tesi di laurea specialistica}, oppure
+\emph{tesi di laurea magistrale}, oppure \emph{dissertazione di
+dottorato}.
+
+
+Non fa tutto, ci mancherebbe altro, visto che nessuna persona è in
+grado di prevedere tutte le necessità delle altre persone.
+
+Da un lato alcuni devono adattarsi a quello che è disponibile,
+magari dandosi da fare per creare qualche cosa di nuovo per se
+stessi e forse anche per gli altri. Qualcun altro deve sapersi
+immedesimare nelle necessità altrui e magari deve darsi da fare
+per creare qualcosa di nuovo che possa essere utile agli altri e
+forse anche a se stesso.
+
+Una cosa certamente che rimane da fare è un procedimento più
+semplice per la composizione del frontespizio in una lingua
+diversa dall'italiano. Attualmente il procedimento si rifà all'uso
+delle macro che servono per definire le stringhe in lingua; il
+sistema dovrebbe essere completo ma richiede un po' di attenzione
+da parte dell'utente.
+
+\begin {sloppypar}
+Un'altra possibilità sarebbe quella di predisporre altri file con
+i nomi, per esempio, \texttt{topfrnten.sty},
+\texttt{topfrntfr.sty}, \texttt{topfrntsp.sty}, eccetera, che
+siano cloni del file \texttt{topfront.sty} e che si possono
+richiamare come pacchetti aggiuntivi. Ognuno definisce il comando
+\texttt{\string\frontespizioinglese},
+\texttt{\string\frontespiziofrancese},
+\texttt{\string\frontespiziospagnolo}, eccetera, e questo comando
+può quindi essere usato in sostituzione del comando per il
+frontespizio italiano. Questi file differirebbero da quello per il
+frontespizio in italiano perché vi sarebbero ridefinite tutte le
+definizioni di default delle stringhe in lingua. Ovviamente
+bisogna che chi clona e modifica il file \texttt{topfront.sty} e
+lo modifica per adattarlo ad una determinata lingua, deve
+conoscere quella lingua da maestro. Suggerirei però di non
+modificare le strutture con cui è composto il frontespizio del
+nostro Politecnico, perché effettivamente contiene tutti gli
+elementi richiesti ``per legge'' ed è tipograficamente abbastanza
+equilibrato; la sfalsatura del blocco dei relatori e di quello dei
+candidati lascia abbastanza spazio per le firme di legge, anche se
+introduce un elemento di asimmetria; tuttavia~\dots
+\end{sloppypar}
+
+Il pacchetto \textsf{TOPtesi} carica di default sia \texttt{babel} sia
+\texttt{graphicx}; certo potrebbe caricare di default anche
+\texttt{amsmath} e i suoi compagni, ma non tutti hanno bisogno di
+scrivere e comporre matematica avanzata e se non vengono usati essi
+comportano uno spreco di memoria e un sia pur piccolo rallentamento
+nell'esecuzione. Ritengo quindi che sia meglio che ognuno si carichi i
+pacchetti che intende davvero usare.
+
+Si ricordi che specificando l'opzione \texttt{pdfa}, bisogna usare esclusivamente \texttt{pdflatex} (con il parametro \verb|\pdfoutput| caricato con un numero positivo, generalmente~1); viene caricato un file di estensione specifico che a sua volta attiva la possibilità di disporre dei link interni ed esterni, che sono così comodi per ``navigare'' dentro al documento. Eventali personalizzazioni devono perciò venire eseguite immediatamente dopo la dichiarazione della classe, altrimenti non vengono recepite correttamente. Bisogna altresì ricordarsi di predisporre il file con i \emph{metadata} richiesti dal formato PDF/A.
+
+È possibile usare il semplice \texttt{latex} (o anche \texttt{pdflatex}, con il valore di \verb|\pdfoutput| caricato con il valore~0); ma questo serve solo per produrre un file in formato DVI, che può servire solo per una stampa della tesi su carta; può venire trasformato nel formato PS tramite l'applicativo \texttt{dvips}, ma questo formato non stamperebbe meglio di quel che si potrebbe ottenere dai ``previewer'' recenti per il formato DVI che siano anche in grado di inviare il file DVI in stampa. Viceversa è più interessante disporre della versione finale in formato PDF, cosa che si può ottenere mediante il programma \texttt{ps2pdf} il quale, con opportuni artifici, permette anche di produrre un file in formato PDF/A. Ma allora perché non ottenere questo risultato in un passaggio solo? Certo, potrebbe esserci l'esigenza di usare estensioni che fanno uso del linguaggio PostScript, ma, solitamente, agendo direttamente con \texttt{pdflatex} si possono usare altri pacchetti di estensione che consentono di evitare del tutto il linguaggio PostScript.
+
+So per certo che le tesi di filologia classica possono essere
+composte molto bene con \LaTeX\ e \textsf{TOPtesi}; se bisogna
+usare una buona dose di lingua greca classica è conveniente
+caricare il pacchetto \texttt{teubner}; gli intenditori sanno
+perfettamente che i font della casa editrice Teubner di Lipsia
+sono fra i più gradevoli che esistano; il pacchetto
+\texttt{teubner} fa uso di un'ottima imitazione di quei font e
+mette a disposizione una miriade di comandi per comporre quei
+segni ``strani'' che i filologi usano per scrivere le loro opere.
+
+Per le edizioni critiche esiste il pacchetto \texttt{ledmac}; io non
+l'ho mai usato, ma sembra che sia di grande aiuto per i letterati.
+
+Per gli scienziati e i tecnologi esistono troppi pacchetti
+specializzati e sarebbe impossibile, e forse inutile, elencarli
+tutti, o anche elencare solo i più importanti.
+
+Non resta che augurare:
+\begin {center}\Large\bfseries
+Buona composizione con \LaTeX!
+\end{center}
+\appendix
+\input{LPPL}
+
+
+ \end{document}
diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-example.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-example.pdf
new file mode 100644
index 00000000000..7ca13e1f2bf
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-example.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-example.tex b/Master/texmf-dist/doc/latex/toptesi/toptesi-example.tex
index a1bab7a27dc..8703f982580 100644
--- a/Master/texmf-dist/doc/latex/toptesi/toptesi-example.tex
+++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-example.tex
@@ -72,7 +72,7 @@
% urlcolor={blue}
% }
-
+%\setbindingcorrection{3mm}
\begin{document}\errorcontextlines=9
\expandafter\ifx\csname StileTrieste\endcsname\relax
diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf
index e686b686112..5368e0bd7e5 100644
--- a/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf
+++ b/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf
Binary files differ
diff --git a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx
index af35263e2d9..1b1cc98ce47 100644
--- a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx
+++ b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx
@@ -1,4 +1,64 @@
% \iffalse meta-comment
+%<*internal>
+\begingroup
+\input docstrip.tex
+\keepsilent
+\preamble
+ ______________________________________________________
+ The TOPtesi package
+ Copyright (C) 2010 Claudio Beccari
+ All rights reserved
+
+ License information appended
+
+\endpreamble
+\postamble
+
+Copyright 2005-2010 Claudio Beccari
+
+Distributable under the LaTeX Project Public License,
+version 1.3c or higher (your choice). The latest version of
+this license is at: http://www.latex-project.org/lppl.txt
+
+This work is "author-maintained"
+
+This work consists of this file toptesi.dtx, a README file
+and the derived files:
+
+toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, topsize14,
+trieste.sty, toptesi.cfg, and the English documentation toptesi.pdf;
+
+Furthermore the bundle contains the documentation source file toptesi-doc.tex
+and the derived file toptesi-doc.pdf.
+
+The toptesi-example.tex source file is just an example that shows how
+to use the various commands; by commenting or decommenting certain
+source lines it is possible to typeset different kind of theses and their
+frontpages.
+
+The toptesi.cfg file is a sample of a local configuration file that can be
+freely edited and modified.
+
+By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files
+and the English documentation file in pdf format.
+
+The documentation file toptesi-doc.pdf is in Italian; its source file is
+another example of how to use toptesi.
+\endpostamble
+\askforoverwritefalse
+
+\generateFile{toptesi.cls}{t}{\from{toptesi.dtx}{class}}
+\generateFile{toptesi.sty}{t}{\from{toptesi.dtx}{topsty}}
+\generateFile{topcoman.sty}{t}{\from{toptesi.dtx}{topcmn}}
+\generateFile{topfront.sty}{t}{\from{toptesi.dtx}{topfrn}}
+\generateFile{topsiz14.clo}{t}{\from{toptesi.dtx}{top14}}
+\generateFile{trieste.sty}{t}{\from{toptesi.dtx}{toptrst}}
+\generateFile{toptesi.cfg}{t}{\from{toptesi.dtx}{topcfg}}
+
+\def\tmpa{plain}
+\ifx\tmpa\fmtname\endgroup\expandafter\bye\fi
+\endgroup
+%</internal>
%
% Copyright 1989--2006 Claudio Beccari
%
@@ -27,7 +87,7 @@
% \iffalse
%<*driver>
\documentclass{ltxdoc}
-\ProvidesFile{toptesi.dtx}[2010/05/09 v.5.01 Documented TeX file for
+\ProvidesFile{toptesi.dtx}[2010/11/14 v.5.02 Documented TeX file for
the TOPtesi bundle]
\GetFileInfo{toptesi.dtx}
\title{The TOPtesi bundle}
@@ -42,7 +102,7 @@ the TOPtesi bundle]
%</driver>
% \fi
%
-% \CheckSum{2905}
+% \CheckSum{2917}
%
%% \CharacterTable
%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -63,14 +123,15 @@ the TOPtesi bundle]
% \begin{abstract}
% This file describes the TOPtesi bundle; it is a set of files designed to
% typeset with \LaTeX\ a university final report that in Italian is generally
-% called ``tesi''; It was originally developed at the Technical University
+% called ``tesi''; it was originally developed at the Technical University
% of Turin (Politecnico di Torino) but it was adapted for typesetting theses in any
% Italian university. Well\dots\ since the Erasmus student mobility is very
% extended and many Italian students participate in the so called \textit{double degree}
-% programs; their theses, or whatever they are called in other countries,
+% programs, their theses, or whatever they are called in other countries,
% may be typeset so as to comply also with the host university rules; therefore this
% set of files has the ambition to be suited for typesetting theses in any university in the
-% world\dots
+% world\dots\ This ambition can't be fulfilled, though, because of the complexity of the
+% title page (and possibly of the legal page) requirements.
% \end{abstract}
%
% \section{Introduction}
@@ -93,46 +154,48 @@ the TOPtesi bundle]
% independent extension package to be added to, say, the report class file for typesetting
% just the title page; this file might be used as a template for setting up the
% title page fixed information in languages different from Italian.
-% \item A third extension package \texttt{topcomand.sty} that defines a certain number
+% \item A third extension package \texttt{topcoman.sty} that defines a certain number
% of user commands suitable for typesetting technical matters.
% \item A fourth extension package \texttt{trieste.sty} and its accompanying package option
% \texttt{topsiz14.clo} that is used as an option by
% \texttt{toptesi.cls} in order to define a certain number of variations required
-% for theses in humanities at the university of Trieste; these variations are not so important
-% ones, but they may be preferred also in other faculties so that the suitable option
+% for theses in humanities at the university of Trieste; these variations are not that
+% important, but they may be preferred also in other faculties so that the suitable option
% comes handy also in other situations.
-% \item The logos of a certain number of Italian universities both in \texttt{.eps} and in
-% \texttt{.jpg} or \texttt{.pdf} formats; such logos are included for the user sake, but
+% \item The logos of a certain number of Italian universities in \texttt{.eps},
+% \texttt{.jpg}, and \texttt{.pdf} formats; such logos are included for the user sake, but
% the user should pay attention to use them according to the rules and limitations of
-% each university and is strongly advised to look up such regulations in each university Web
-% site.
+% each university and it is strongly advised to look up such regulations in each
+% university Web site.
% \item A documentation file \texttt{toptesi-doc.pdf} written in Italian where every feature
-% is explained in detail; simpler information is given in this English documentation.
+% is explained in detail; essential information is given in this English documentation.
% \end{itemize}
%
% The above files are complemented with a configuration file that any user may
% personalize at will; these personalizations make it easy to configure the
% bundle so as to make it suitable for another language; in facts the \textsf{babel}
-% package contains localizations for many languages but they refer to the standard
-% infix \LaTeX\ names and phrases and they do not cope with the thesis title page requirements.
+% package contains localizations for many languages, but such localisations deal
+% with the standard infix \LaTeX\ names and phrases and do not cope with the thesis
+% title page requirements.
%
% \section{User commands}
% The \texttt{toptesi.cls} is basically an extension of the standard class
-% \texttt{report.cls}; It redefines the page typesetting grid, the headers and the footers,
+% \texttt{report.cls}; it redefines the page typesetting grid, the headers and the footers,
% and the title page layout and commands.
% \texttt{toptesi.cls} does not set such crazy settings as ``double spaced'' text; it is
% intended to typeset the thesis with the quality of a \LaTeX\ well typeset document, not as
% a typewriter written one. I suppose that typewriter documents have completely vanished
% except perhaps in the legal professions, especially in Italy where legal documents have to
-% be written on special paper produced by the State Polygraphic Institute and carrying a
+% be written on special paper produced by the State Polygraphic Institute and carry a
% watermark and the Republic's Seal; without a special printer it would be very difficult to
-% typeset on such a paper.
+% typeset from a computer on such a custom paper.
%
% Theses very often are full of specialized material: formulas, diagrams and pictures,
-% texts written in non latin alphabets, special symbols for philological mark-up, and the like;
-% a common typewriter would not be suitable and the quality of the contents requires professional
-% typesetting; this is why I strongly believe that instructions on typesetting styles that
-% refer to the good old times of mechanical typewriters should be banned.
+% texts written in non latin alphabets, special symbols for philological mark-up, and
+% the like; a common typewriter would not be suitable and the quality of the contents
+% requires professional typesetting; this is why I strongly believe that instructions
+% on typesetting styles that refer to the good old times of mechanical typewriters
+% should be banned.
%
% Most new commands refer themselves to the information that should be typeset in the
% title page; some class options specify special stylistic page details; the rest is simple
@@ -154,23 +217,24 @@ the TOPtesi bundle]
%
% \Item[cucitura] In two sided printing it is better to move the
% typesetting grid towards the outer edges so as to cope with the thesis binding
-% that is generally not made by sawing a number of signatures; the outer displacement
-% is fixed to~7mm.
+% that is generally not made up by sewing together a number of signatures;
+% the default outer displacement is fixed to~7mm, but it can be customized by means
+% of a proper entry in the configuration file or by an explicit command in the preamble.
%
% \Item[14pt] Extends the normal size choice to 14 points; it is appreciated
% in various fields of humanities, but I would discourage this use in a technical
% thesis, where 10 point perhaps is too small, but 11 point or 12 point typesetting
-% may be adequate. It is worth mentioning that this option implements the font
-% settings in e different way from what is being done with the \texttt{extsizes} bundle of
-% classes; this is why the original \texttt{size14.clo} class option file has been renamed
+% may be adequate. It is worth mentioning that this option implements the font
+% settings in a different way from what is being done with the \texttt{extsizes} package
+% bundle; this is why the original \texttt{size14.clo} class option file has been renamed
% \texttt{topsiz14.clo} so as to avoid conflicts with the \texttt{size14.clo} file belonging
% to that bundle.
%
-% \Item[autoretitolo] This option modifies the left handed (even numbered) pages
-% in two side typesetting; normally the even numbered headings contain
+% \Item[autoretitolo] This option modifies the left hand (even numbered) pages
+% in two side typesetting; normally the even numbered page headings contain
% the chapter title, while the odd numbered ones contain the current section title.
% If the \texttt{classica} option has been specified, then with this option it is possible to
-% have even numbered % headings contain the author's name and the thesis title, while the odd
+% have even numbered headings contain the author's name and the thesis title, while the odd
% numbered ones contain the chapter title. Since the thesis title might be too
% long to fit in the header together with the author's name, the |\title| macro
% as been modified so as to accept an optional short title, similarly to the
@@ -192,8 +256,9 @@ the TOPtesi bundle]
% typeset, possibly with hilarious results\dots
%
% Since most users are supposed to be Italian, the user commands are mostly in Italian;
-% the following description gives their names and meanings; every command receives an argument;
-% only the command |\title| accepts an optional argument according to the usual \LaTeX\ syntax:
+% the following description gives their names and meanings; every command receives one
+% argument; only the command |\title| accepts an optional argument according to the usual
+% \LaTeX\ syntax:
% \[
% \makebox[0pt]{%
% \texttt{\char92}\emph{command}\relax
@@ -216,54 +281,58 @@ the TOPtesi bundle]
% \Item[coordinatore] gets the name of the Doctoral School Coordinator
% \Item[QualificaDirettore] gets the phrase that describes the director or coordinator
% official position; by using the command \cs{direttore} the default phrase
-% ``Direttore della Scuola di Dottorato'' is printed over the ``director's'' name;
+% ``Direttore della Scuola di Dottorato'' is printed above the
+% ``director's'' name;
% if \cs{coordinatore} is used the default phrase ``Coordinatore della
% Scuola di Dottorato'' is printed instead. If neither one is applicable or a
% description in another language is required, this macro is available for
% specifying such position.
-% \Item[relatore] gets the name of thesis first supervisor
+% \Item[relatore] gets the name of the thesis first supervisor
% \Item[secondorelatore] gets the name of the second supervisor
-% \Item[terzorelatore] gets the name of the third supervisor; it is assumed that the number of supervisors
-% never exceeds three.
+% \Item[terzorelatore] gets the name of the third supervisor; it is assumed that the
+% number of supervisors never exceeds three.
% \Item[tutore] gets the name of the doctorate tutor; there is no difference with regards
-% to the \cs{relatore}, but the default phrase ``Tutore'' is printed over this
-% person's name.
+% to the \cs{relatore}, but the default phrase ``Tutore'' is printed above
+% this person's name.
% \Item[TutorName] gets the phrase that describes the tutor position, possibly in a different
% language.
% \Item[AdvisorName] gets the string that qualifies the supervisor(s); the default string
% is ``Relatore:'' or ``Relatori:'' for the plural; in another language
% this command is used to define the string, say, ``Supervisors:'' if the
% thesis has been supervised by more than one person.
-% \Item[CoAdvisorName] gets the string that qualifies the co-supervisor(s); the default string is
-% ``Correlatore:'' or ``Correlatori:'' in the plural; this command may be used to
-% define the string, say, ``Corapporteur:'' in a French Projet de fin
-% d'\'etudes.
-% \Item[candidato] gets the name of the male student
-% \Item[candidata] gets the name of the female student
-% \Item[secondocandidato] gets the name of the second male student
-% \Item[secondacandidata] gets the name of the second female student
-% \Item[terzocandidato] gets the name of the third male student
-% \Item[terzacandidata] gets the name of the third female student; most often the thesis
+% \Item[CoAdvisorName] gets the string that qualifies the co-supervisor(s); the default
+% string is ``Correlatore:'' or ``Correlatori:'' in the plural; this
+% command may be used to define the string, say, ``Corapporteur:'' in a
+% French Projet de fin d'\'etudes.
+% \Item[candidato] gets the name of the male author
+% \Item[candidata] gets the name of the female author
+% \Item[secondocandidato] gets the name of the second male author
+% \Item[secondacandidata] gets the name of the second female author
+% \Item[terzocandidato] gets the name of the third male author
+% \Item[terzacandidata] gets the name of the third female author; most often the thesis
% author is just one person; but there are some institutions where group
% final works are accepted; it is assumed that the group does not contain more
% than three authors. The specification of the gender allows the software
-% to determine the correct labeling phrase in the proper gender and proper number.
+% to determine the correct labeling phrase in the proper gender and proper
+% number.
% For different languages there might be no difference in gender but
% there is a difference in the plural ending.
-% \Item[CandidateName] gets the string that describes the student status in a foreign language
-% or even in Italian; the default string is ``Candidato:'' (with colons)
-% adjusted to masculine, or feminine, singular or plural; with the option
-% \texttt{classica} the string becomes ``Laureato:''; in other languages
-% it is necessary to specify this string in the proper gender and number
-% \Item[sedutadilaurea] gets the date of the final exam, or presentation, or defense of the
+% \Item[CandidateName] gets the string that describes the student status in a foreign
+% language or even in Italian; the default string is ``Candidato:'' (with
+% colons) adjusted to masculine or feminine, singular or plural; with the
+% option \texttt{classica} the string becomes ``Laureando:''; in other
+% languages it is necessary to specify this string in the proper gender and
+% number.
+% \Item[sedutadilaurea] gets the date of the final exam, or presentation, or defense of the
% thesis; if this date is omitted the default date is the current
-% month and year in Italian
-% \Item[esamedidottorato] an alias for \cs{sedutadilaurea} to be used for doctoral dissertations
-% \Item[ciclodidottorato] gets the roman numeral that specifies the doctoral cycle
+% month and year in Italian.
+% \Item[esamedidottorato] an alias for \cs{sedutadilaurea} to be used for doctoral
+% dissertations.
+% \Item[ciclodidottorato] gets the roman numeral that specifies the doctoral cycle.
% \Item[CycleName] redefines the string that expresses the name of the doctoral cycle;
% by default this is ``ciclo'' but this command is useful to set the
% name in a different language.
-% \Item[corsodilaurea] gets the proper name of the degree course; the phrase that describes
+% \Item[corsodilaurea] gets the proper name of the degree course; the phrase that describes
% the degree course is specified, if necessary, with the following
% command; with this one you specify just, say, ``Electrical Engineering''
% \Item[CorsoDiLaureaIn] gets the generic name of the degree course, for example ``Bachelor
@@ -274,71 +343,97 @@ the TOPtesi bundle]
% it is ``Monografia di Laurea''. In some Italian universities it might
% be called ``Tesi di Laurea'', so that the master thesis should be given
% another qualification, for example ``Tesi di Laurea Magistrale''.
-% \Item[NomeDissertazione] gets the phrase that describes the doctoral thesis; by default it is
-% ``Tesi di Dottorato''.
+% \Item[NomeDissertazione] gets the phrase that describes the doctoral thesis; by default
+% it is ``Tesi di Dottorato''.
% \Item[InName] infix strings often require adjusting of the prepositions; this macro gets
% the preposition that stands for ``in'' (the default). In German it might
-% become ``auf''
+% become ``auf''.
% \Item[NomeAnnoAccademico] defines the infix string that stands for ``Academic year''.
-% This macro is
-% defined only if the option \texttt{classica} is in force; after all
-% the command |\annoaccademico| is defined only with that option.
-% \Item[logosede] specifies the name of the file that contains the university logo; no default
-% is defined; rather a warning message is issued if no name is given
-% or the file is missing, but typesetting goes on without the inclusion
-% of any logo.
+% This macro is defined only if the option \texttt{classica} is in force;
+% after all the command |\annoaccademico| is defined only with that option.
+% \Item[logosede] specifies the name of the file that contains the university logo;
+% no default is defined; rather a warning message is issued if no name is
+% given or the file is missing, but typesetting goes on without the inclusion
+% of any logo.
+% \Item[setbindingcorrection] sets up the length to displace the text block to the external
+% margin so as to have a wider internal margin to accommodate for the binding
+% correction. Its argument is not optional and is used to modify the default
+% correction of 7\,mm.
% \end{description}
%
% Since the infix strings are all memorized into control sequences and for each of them it
% is possible to use a defining command, all strings can be modified at will, so that there
-% is no difficulty to localize the package in another language; this comes particularly handy for the
-% Erasmus students on double degree programs.
+% is no difficulty to localize the package in another language; this comes particularly handy
+% for the Erasmus students on double degree programs.
%
-% As a final remark notice that the commands for typesetting the title page are contained in the package
-% \texttt{topfront.sty}, which can be used as an autonomous extension to the \texttt{report}
-% document class. One could easily typeset just the title page with a separate \TeX\ source file
-% so as to test the completeness of the commands and coherence of the configuration file or
-% for just printing the isolated title page.
+% As a final remark notice that the commands for typesetting the title page are contained
+% in the package \texttt{topfront.sty}, which can be used as an autonomous extension to the
+% \texttt{report} document class. One could easily typeset just the title page with a separate
+% \TeX\ source file so as to test the completeness of the commands and coherence of the
+% configuration file or for just printing the isolated title page.
%
% \subsection{Typesetting commands}
% The bundle and the TOPtesi document class accept all \LaTeX\ commands provided by
% the \LaTeX\ \texttt{kernel}, the \texttt{report} document class, and the \texttt{graphics}
% extension package, besides those provided by the \texttt{babel} package.
%
-% With this respect it must be underlined that the Italian and English languages are specified by
-% default, the Italian one being the default language. An initial specification of
-% |\selectlanguage{english}| sets the English language as default. Should a student typeset the thesis
-% in French, it would be necessary to specify the option \texttt{french} among the class options,
-% and so start the document by specifying |\selectlanguage{french}|. Nevertheless these
-% \texttt{babel} macros select the English or the French typesetting rules, but hyphenation
-% is activated only if the program format file has been generated with the pertinent languages.
+% With this respect it must be underlined that the Italian and English languages are specified
+% by default, the Italian one being the default language. An initial specification of
+% |\selectlanguage{english}| sets the English language as default. Should a student typeset
+% the thesis in French, it would be necessary to specify the option \texttt{french} among the
+% \emph{class} options, and so start the document by specifying |\selectlanguage{french}|.
+% But the user should pay attention to use \texttt{babel} in the proper way:
+% \begin{itemize}
+% \item Due to the way \LaTeX\ classes load the requested files, and to the fact that the
+% \texttt{babel} package has already been loaded by the \texttt{toptesi} class, the user
+% cannot reload it with a different list of language options; therefore the latter language
+% options \emph{must be specified} as global class options; therefore, if the thesis has
+% to be typeset, fore example, in French, is is necessary to do the following:
+%\begin{verbatim}
+%\documentclass[...,french,...]{toptesi}
+%...
+%\begin{document}
+%\selectlanguage{french}
+%\end{verbatim}
+% \item With the 2010 \TeX\ system distributions, both \TeX Live and MiKTeX, all known
+% (to \LaTeX) language hyphenation rules are preloaded; with other less up to date
+% \TeX\ system distributions this might not be true.
+% Remember that \texttt{babel} macros select the language typesetting rules, but hyphenation
+% is activated only if the program format file has been generated with the pertinent
+% language hyphenation rules. You can check this detail by reading the first dozen of lines
+% of your thesis \texttt{.log} file; there is the list of all language hyphenation rules that
+% are available in the format file.
% While (American) English is the default and almost any distribution of the \TeX\ system
% has many language defaults, it is more likely that French is preloaded while Italian is not.
-% The user should verify which are the default languages preloaded into the format file; this
-% information is written in the very first lines of any \texttt{.log} file generated by any
-% run of \LaTeX, \texttt{pdflatex} or even plain \TeX.
-%
-% Should the required languages be missing, the user is forced to read the distribution
-% instructions, so as to find out how to configure his/her system so as to consider the languages
-% s/he wants to work with, and finally s/he must recreate the format files and put them in
-% the proper places of the standard or the local folder tree. The user is invited to carefully
-% investigate on these fine points and to configure the system properly; it would be very
-% upsetting using fine software for producing a perfectly typeset thesis that, unfortunately,
-% has wrong hyphenation points!
+%
+% Should the required language(s) be missing, the user is forced to read his/her distribution
+% instructions, so as to find out how to configure his/her system so as to consider the
+% languages s/he wants to work with, and finally s/he must recreate the format files and put
+% them in the proper places of the standard or the local folder tree. The user is invited to
+% carefully investigate on these fine points and to configure the system properly; it would
+% be very upsetting using fine software for producing a perfectly typeset thesis that,
+% unfortunately, has wrong hyphenation points! Luckily enough, recent distributions of the
+% \TeX\ system have all the known hyphenation rules preloaded; in any case even older
+% distributions have available command line commands or graphical user interfaces that make
+% it easy to perform the tasks of changing the list of preloaded hyphenation rules and
+% rebuilding all the format files, moving them to the proper places.
+% \end{itemize}
%
% The TOPtesi bundle adds very little to the user commands; nevertheless the package
-% \texttt{topcomand.sty},
-% that is part of this bundle and is automatically loaded, defines some useful commands for
-% typesetting technical matters in such a way as to fulfill the ISO regulations.
-% Some of these commands are already defined in the \texttt{babel} Italian option, but if your thesis
-% is written in different languages it may happen that such commands are not available any more when
-% another language is selected.
+% \texttt{topcoman.sty}, that is part of this bundle and is automatically loaded, defines
+% some useful commands for typesetting technical matters in such a way as to fulfill the ISO
+% regulations.
+% Some of these commands are already defined with the \texttt{babel} Italian option, but if
+% your thesis is written in different languages it may happen that such commands are not
+% available any more when you select another language; with the presence of the definitions
+% contained in \texttt{topcoman.sty} such useful commands remain available with every
+% language.
%
% The following description specifies these particular commands.
% \begin{description}
% \def\Item[#1]{\item[\normalfont\texttt{\char92#1}]}
% \Item[DeclareSlantedCapitalGreekLetters] does exactly what its name
-% means: it changes the definitions of the mathematical capital Geek
+% means: it changes the definitions of the mathematical capital Greek
% letters so that they are typeset in ``italics''; they are in effects taken from the math
% italic alphabet, instead of the default roman one.
% %
@@ -347,7 +442,7 @@ the TOPtesi bundle]
% available anyhow.
% %
% \Item[ohm] typesets an upright capital omega even if the capital Greek
-% letters are in italics; the good point is that |\ohm| can be used also
+% letters are in italics; another good point is that |\ohm| can be used also
% in text mode.
% %
% \Item[ped] inserts a subscript in upright type; the ISO regulations
@@ -394,21 +489,24 @@ the TOPtesi bundle]
% %
% \Item[eu] inserts the Euler number symbol ``e'' in upright type; since
% this entity is not a variable, but it is a mathematical constant, the
-% ISO regulations require it to be written in upright type. The electron
-% charge $e$ is not upright because this physical ``constant'' is not
-% that constant\dots
+% ISO regulations require it to be written in upright type. The ISO regulations require
+% the upright type for ``e'' and any mathematical constant, but
+% the electron charge $e$ is typeset in math italics because this physical
+% ``constant'', not a mathematical one.
% %
-% \Item[listing] requires for its argument the name of a file and typesets it in verbatim mode;
-% this command is very useful for typesetting the listings of the programs that were written
-% for the thesis; for best results it is recommended that the source program has lines not
-% longer than 80 characters.
+% \Item[listing] requires for its argument the name of a file and typesets it in verbatim
+% mode; this command is very useful for typesetting the listings of the programs that were
+% written for the thesis; for best results it is recommended that the source program has
+% lines not longer than 80 characters. There exists an external package \texttt{listings},
+% that the user might want to load, that does a similar work in a more professional and
+% configurable way; our package simpler command might be preferable for its simplicity.
% \end{description}
%
% All these commands are defined into the separate package \texttt{topcoman.sty}
-% that can be used as an independent extension package for any document class.
+% that can be used as an independent extension package with (possibly) any document class.
%
% \section{Format PDF suitable for archiving}
-% Politecnico di Torino as well as many other Italian and non Italian universities are
+% Politecnico di Torino as well as many other Italian and foreign universities are
% moving towards archiving theses in electronic format, specifically in the PDF one. The
% problem of course is: ``Will it be possible to read the archived documents, say, fifty
% years from now?''
@@ -440,13 +538,13 @@ the TOPtesi bundle]
% summarized as follows:
% \begin{itemize}
% \item The preliminary essential requirement is that the \texttt{pdflatex} used to
-% typeset the thesis be sufficiently recent to support the PDF/A requirements. Have
-% a 2008, or even better, a 2009 version of the \TeX\ system installed on your PC.
+% typeset the thesis be sufficiently recent to support the PDF/A requirements. It's
+% better to have the most recent distribution of the \TeX\ system installed on your PC.
% Do not try to typeset the thesis
-% with the `old' \LaTeX; you must process the input thesis file(s) with
+% with the `old' \LaTeX; you \emph{must} process the input thesis file(s) with
% \texttt{pdflatex}; in the following, no specific check will be made in order
-% to verify if you are actually
-% using \texttt{pdflatex}. If you really need to use the `old' \LaTeX, you get a DVI
+% to verify if you are actually using \texttt{pdflatex}.
+% If you really need to use the `old' \LaTeX, you get a DVI
% file and you need to transform it with |dvips| into a PS file; at this point you
% have lost the possibility of exploiting the internal commands of |pdflatex| version
% 1.40.9 or later. You can still produce a PDF/A final document, but you have to
@@ -455,11 +553,11 @@ the TOPtesi bundle]
% to PDF/A transformation.
% \item Download from \textsc{ctan} and install the package \textsf{pdfx}, if it is
-% not already part of your \TeX\ system installation. % \item Install in the main
-% \texttt{pdfx} directory a good version of a color model
+% not already part of your \TeX\ system installation.
+% \item Install in the main \texttt{pdfx} directory a good version of a color model
% profile file, such as, for example, \texttt{ECI-RGB-V1.0.icc} (see in the download
% page of the site \texttt{www.eci.org}).
-%\item If your thesis main file, the one you run your \texttt{pdflatex} on, is named,
+% \item If your thesis main file, the one you run your \texttt{pdflatex} on, is named,
% say, \texttt{JohnSmithMasterThesis.tex}, prepare in the same directory another file
% named \texttt{JohnSmithMasterThesis.xmpdata} that contains the \emph{metadata}
% relative to the thesis; pay attention to follow the stringent syntax described and
@@ -471,19 +569,19 @@ the TOPtesi bundle]
% \end{verbatim}
% Keywords require a specific XML style format that can be examined in the package
% documentation.
-%\item Some mathematical symbol commands obtained from the standard \LaTeX\ set-up
+% \item Some mathematical symbol commands obtained from the standard \LaTeX\ set-up
% and the standard mathematical fonts require some patching that is already included
% in this \texttt{ToPtesi} bundle; but it is not excluded that with other fonts similar
% patches might be requested.
-%\item Use only PNG and JPEG images with RGB color profiles.
-%\item If you include PDF images that contain some text, be sure that the font for
+% \item Use only PNG and JPEG images with RGB color profiles.
+% \item If you include PDF images that contain some text, be sure that the font for
% this text is completely embedded in the included file. Should the PDF file come
% from an external drawing program be sure to configure that program so that it embeds
% all the fonts used in the image. If you don't succeed, open the PDF file with
% the free program \texttt{inkscape} and save it back in PDF format; the missing fonts
% will be replaced with their traced outlines and this will not disturb the PDF/A
% conformity.
-%\item Verify your final PDF file with a suitable program and do not give up doing the
+% \item Verify your final PDF file with a suitable program and do not give up doing the
% necessary corrections or modifications while the verification program keeps saying
% the this or that is not conforming to the PDF/A specification. A suitable program
% is the Preflight plug-in of Adobe Acrobat Professional version 8 or later, but this,
@@ -495,10 +593,9 @@ the TOPtesi bundle]
% that are of great concern for the large Institutions that have thousands of document
% a year to archive; it is not a question implied in the free nature of the
% \texttt{pdflatex} program, that, on the opposite, according to our experience has
-% a very high rate of
-% success in producing PDF/A conforming documents. If you stick to the default \TeX\
-% system fonts and use this patched version of \texttt{ToPtesi} you should be able to
-% avoid most problems.
+% a very high rate of success in producing PDF/A conforming documents. If you stick to
+% the default \TeX\ system fonts and use this patched version of \texttt{ToPtesi} you
+% should be able to avoid most problems.
%
% \StopEventually{} ^^A qui si puo' mettere una bibliografia
%
@@ -512,7 +609,7 @@ the TOPtesi bundle]
%<*class>
\NeedsTeXFormat{LaTeX2e}
\ProvidesClass{toptesi}%
-[2008/12/15 v.5.00 Class for typesetting university theses]
+[2010/11/14 v.5.01 Class for typesetting university theses]
% \end{macrocode}
%
% The class itself is very simple since it requires just the \texttt{report}
@@ -550,7 +647,7 @@ the TOPtesi bundle]
%<*topsty>
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{toptesi}%
-[2008/12/15 v.5.00 Extension for toptesi.cls]%
+[2010/11/14 v.5.01 Extension for toptesi.cls]%
% \end{macrocode}
%
% We start with defining the debugging macros; these trace commands and macros
@@ -568,6 +665,7 @@ the TOPtesi bundle]
% similar class option packages and is in line with the other standard \texttt{size??.clo}
% files. \texttt{chapterbib} allows to set a list of references at the end of each chapter.
% \begin{macrocode}
+\newlength\T@Pbinding\setlength\T@Pbinding{7mm}\def\setbindingcorrection#1{\T@Pbinding=#1}
\newif\if@binding \@bindingfalse
\newif\ifT@Ppdfa \T@Ppdfafalse
\newif\ifchapterbibliography \chapterbibliographyfalse
@@ -616,7 +714,8 @@ the TOPtesi bundle]
% text grid is centered; only if the class option \texttt{cucitura} is specified
% (|\if@binding| in this case is true) the text grids are moved to the outside
% in order to leave a wider inner margin. At the same time if the text grid is moved to
-% the outside, the marginal note width must be reduced accordingly.
+% the outside, the marginal note width must be reduced accordingly. These changes are
+% executed at the |\begin{document}| stage.
% \begin{macrocode}
\oddsidemargin=\paperwidth
\advance\oddsidemargin -\textwidth
@@ -627,13 +726,14 @@ the TOPtesi bundle]
\advance\marginparwidth 1in
\advance\marginparwidth-2.5\marginparsep
%
+\AtBeginDocument{%
\if@binding
\typeout{Messaggio Toptesi: Ricalcolo i margini}
- \advance\oddsidemargin 7mm
- \advance\evensidemargin -7mm
- \advance\marginparwidth -7mm
- \advance\marginparwidth -7mm
-\fi
+ \advance\oddsidemargin \T@Pbinding
+ \advance\evensidemargin -\T@Pbinding
+ \advance\marginparwidth -\T@Pbinding
+ \advance\marginparwidth -\T@Pbinding
+\fi}
% \end{macrocode}
%
% We now establish the page style. We start by setting to ``empy'' the tokens that
diff --git a/Master/texmf-dist/source/latex/toptesi/toptesi.ins b/Master/texmf-dist/source/latex/toptesi/toptesi.ins
deleted file mode 100644
index da3e4a1a532..00000000000
--- a/Master/texmf-dist/source/latex/toptesi/toptesi.ins
+++ /dev/null
@@ -1,113 +0,0 @@
-%%
-%% This file is necessary to extract from file toptesi.dtx the following files:
-%% toptesi.cls,
-%% toptesi.sty,
-%% topcoman.sty,
-%% topfront.sty,
-%% topsiz14.clo,
-%% trieste.sty,
-%% toptesi.cfg
-%% that are strictly speaking the components of the TOPtesi bundle and form
-%% the Work. The extraction is performed by means of the doctrip utility
-%% that extracts practically only the uncommented lines so that their loading
-%% becomes very quick. The bundle documentations in Italian is contained
-%% in the document toptesi-doc.pdf (part of the bundle), and further
-%% documentation in English may be obtained by LaTeX processing the
-%% documented TeX source file toptesi.dtx.
-%%
-%% ----------------------------------------
-%%
-%% This system is distributed in the hope that it will be useful,
-%% but WITHOUT ANY WARRANTY; without even the implied warranty of
-%% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-%%
-%% IMPORTANT NOTICE:
-%%
-%% Copyright 1989--2006 Claudio Beccari
-%% All rights reserved.
-%%
-%% Permission is granted to distribute verbatim copies of this file
-%% together with toptesi.dtx.
-%%
-%% No other permissions to copy or distribute this file in any form
-%% are granted and in particular no permission to modify its contents.
-%%
-%% --------------- start of docstrip commands ------------------
-%%
-\def\batchfile{toptesi.ins}
-\input docstrip.tex
-\preamble
-
-Copyright 1989--2005 Claudio Beccari All rights reserved.
-
- This system is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-
-
-IMPORTANT NOTICE:
-
-This file is subject to the LPPL licence, version 1.3 or any subsequent
-version. Copy of the LaTeX Project Public Licence is downloadable from
-any CTAN archive.
-
-
-\endpreamble
-
-\keepsilent
-
-\Msg{*** Generazione dei file del pacchetto TOPtesi ***}
-
-\generateFile{toptesi.cls}{t}{\from{toptesi.dtx}{class}}
-\generateFile{toptesi.sty}{t}{\from{toptesi.dtx}{topsty}}
-\generateFile{topcoman.sty}{t}{\from{toptesi.dtx}{topcmn}}
-\generateFile{topfront.sty}{t}{\from{toptesi.dtx}{topfrn}}
-\generateFile{topsiz14.clo}{t}{\from{toptesi.dtx}{top14}}
-\generateFile{trieste.sty}{t}{\from{toptesi.dtx}{toptrst}}
-\generateFile{toptesi.cfg}{t}{\from{toptesi.dtx}{topcfg}}
-
-
-
-
-\ifToplevel{%
-\Msg{***********************************************************}
-\Msg{*\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space*}
-\Msg{* Now move all files to a folder that is on \space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space*}
-\Msg{* the LaTeX search path \space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space\space*}
-\Msg{*\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space*}
-\Msg{* In order to produce the English documentation run LaTeX *}
-\Msg{* on toptesi.dtx. \space\space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space\space\space*}
-\Msg{*\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space\space\space\space\space\space\space\space*}
-\Msg{* \space\space\space\space\space\space\space\space\space
- \space\space\space\space
- Buon lavoro! Happy TeXing! \space\space\space\space\space
- \space\space\space\space\space\space\space\space\space\space
- \space*}
-\Msg{***********************************************************}
-}
-
-\endinput
diff --git a/Master/texmf-dist/tex/latex/toptesi/topcoman.sty b/Master/texmf-dist/tex/latex/toptesi/topcoman.sty
index 85ec293668e..2a749c09a17 100644
--- a/Master/texmf-dist/tex/latex/toptesi/topcoman.sty
+++ b/Master/texmf-dist/tex/latex/toptesi/topcoman.sty
@@ -5,20 +5,12 @@
%% The original source files were:
%%
%% toptesi.dtx (with options: `topcmn')
+%% ______________________________________________________
+%% The TOPtesi package
+%% Copyright (C) 2010 Claudio Beccari
+%% All rights reserved
%%
-%% Copyright 1989--2005 Claudio Beccari All rights reserved.
-%%
-%% This system is distributed in the hope that it will be useful,
-%% but WITHOUT ANY WARRANTY; without even the implied warranty of
-%% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-%%
-%%
-%% IMPORTANT NOTICE:
-%%
-%% This file is subject to the LPPL licence, version 1.3 or any subsequent
-%% version. Copy of the LaTeX Project Public Licence is downloadable from
-%% any CTAN archive.
-%%
+%% License information appended
%%
%% \CharacterTable
%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -94,6 +86,36 @@
\newcommand*\DisableFigTabNames{%
\let\p@figure\empty\let\p@table\empty}
\DisableFigTabNames
-\endinput
+%%
+%% Copyright 2005-2010 Claudio Beccari
+%%
+%% Distributable under the LaTeX Project Public License,
+%% version 1.3c or higher (your choice). The latest version of
+%% this license is at: http://www.latex-project.org/lppl.txt
+%%
+%% This work is "author-maintained"
+%%
+%% This work consists of this file toptesi.dtx, a README file
+%% and the derived files:
+%%
+%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, topsize14,
+%% trieste.sty, toptesi.cfg, and the English documentation toptesi.pdf;
+%%
+%% Furthermore the bundle contains the documentation source file toptesi-doc.tex
+%% and the derived file toptesi-doc.pdf.
+%%
+%% The toptesi-example.tex source file is just an example that shows how
+%% to use the various commands; by commenting or decommenting certain
+%% source lines it is possible to typeset different kind of theses and their
+%% frontpages.
+%%
+%% The toptesi.cfg file is a sample of a local configuration file that can be
+%% freely edited and modified.
+%%
+%% By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files
+%% and the English documentation file in pdf format.
+%%
+%% The documentation file toptesi-doc.pdf is in Italian; its source file is
+%% another example of how to use toptesi.
%%
%% End of file `topcoman.sty'.
diff --git a/Master/texmf-dist/tex/latex/toptesi/topfront.sty b/Master/texmf-dist/tex/latex/toptesi/topfront.sty
index 7eed7d981f0..9745124b55e 100644
--- a/Master/texmf-dist/tex/latex/toptesi/topfront.sty
+++ b/Master/texmf-dist/tex/latex/toptesi/topfront.sty
@@ -5,20 +5,12 @@
%% The original source files were:
%%
%% toptesi.dtx (with options: `topfrn')
+%% ______________________________________________________
+%% The TOPtesi package
+%% Copyright (C) 2010 Claudio Beccari
+%% All rights reserved
%%
-%% Copyright 1989--2005 Claudio Beccari All rights reserved.
-%%
-%% This system is distributed in the hope that it will be useful,
-%% but WITHOUT ANY WARRANTY; without even the implied warranty of
-%% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-%%
-%%
-%% IMPORTANT NOTICE:
-%%
-%% This file is subject to the LPPL licence, version 1.3 or any subsequent
-%% version. Copy of the LaTeX Project Public Licence is downloadable from
-%% any CTAN archive.
-%%
+%% License information appended
%%
%% \CharacterTable
%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -399,6 +391,36 @@
\vfill\par\null
\if@twoside\cleardoublepage\else\clearpage\fi
\endgroup}
-\endinput
+%%
+%% Copyright 2005-2010 Claudio Beccari
+%%
+%% Distributable under the LaTeX Project Public License,
+%% version 1.3c or higher (your choice). The latest version of
+%% this license is at: http://www.latex-project.org/lppl.txt
+%%
+%% This work is "author-maintained"
+%%
+%% This work consists of this file toptesi.dtx, a README file
+%% and the derived files:
+%%
+%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, topsize14,
+%% trieste.sty, toptesi.cfg, and the English documentation toptesi.pdf;
+%%
+%% Furthermore the bundle contains the documentation source file toptesi-doc.tex
+%% and the derived file toptesi-doc.pdf.
+%%
+%% The toptesi-example.tex source file is just an example that shows how
+%% to use the various commands; by commenting or decommenting certain
+%% source lines it is possible to typeset different kind of theses and their
+%% frontpages.
+%%
+%% The toptesi.cfg file is a sample of a local configuration file that can be
+%% freely edited and modified.
+%%
+%% By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files
+%% and the English documentation file in pdf format.
+%%
+%% The documentation file toptesi-doc.pdf is in Italian; its source file is
+%% another example of how to use toptesi.
%%
%% End of file `topfront.sty'.
diff --git a/Master/texmf-dist/tex/latex/toptesi/topsiz14.clo b/Master/texmf-dist/tex/latex/toptesi/topsiz14.clo
index 6275b6f6c3d..e6732f9ead7 100644
--- a/Master/texmf-dist/tex/latex/toptesi/topsiz14.clo
+++ b/Master/texmf-dist/tex/latex/toptesi/topsiz14.clo
@@ -5,20 +5,12 @@
%% The original source files were:
%%
%% toptesi.dtx (with options: `top14')
+%% ______________________________________________________
+%% The TOPtesi package
+%% Copyright (C) 2010 Claudio Beccari
+%% All rights reserved
%%
-%% Copyright 1989--2005 Claudio Beccari All rights reserved.
-%%
-%% This system is distributed in the hope that it will be useful,
-%% but WITHOUT ANY WARRANTY; without even the implied warranty of
-%% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-%%
-%%
-%% IMPORTANT NOTICE:
-%%
-%% This file is subject to the LPPL licence, version 1.3 or any subsequent
-%% version. Copy of the LaTeX Project Public Licence is downloadable from
-%% any CTAN archive.
-%%
+%% License information appended
%%
%% \CharacterTable
%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -198,6 +190,36 @@
\def\@listvi {\leftmargin\leftmarginvi
\labelwidth\leftmarginvi
\advance\labelwidth-\labelsep}
-\endinput
+%%
+%% Copyright 2005-2010 Claudio Beccari
+%%
+%% Distributable under the LaTeX Project Public License,
+%% version 1.3c or higher (your choice). The latest version of
+%% this license is at: http://www.latex-project.org/lppl.txt
+%%
+%% This work is "author-maintained"
+%%
+%% This work consists of this file toptesi.dtx, a README file
+%% and the derived files:
+%%
+%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, topsize14,
+%% trieste.sty, toptesi.cfg, and the English documentation toptesi.pdf;
+%%
+%% Furthermore the bundle contains the documentation source file toptesi-doc.tex
+%% and the derived file toptesi-doc.pdf.
+%%
+%% The toptesi-example.tex source file is just an example that shows how
+%% to use the various commands; by commenting or decommenting certain
+%% source lines it is possible to typeset different kind of theses and their
+%% frontpages.
+%%
+%% The toptesi.cfg file is a sample of a local configuration file that can be
+%% freely edited and modified.
+%%
+%% By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files
+%% and the English documentation file in pdf format.
+%%
+%% The documentation file toptesi-doc.pdf is in Italian; its source file is
+%% another example of how to use toptesi.
%%
%% End of file `topsiz14.clo'.
diff --git a/Master/texmf-dist/tex/latex/toptesi/toptesi.cfg b/Master/texmf-dist/tex/latex/toptesi/toptesi.cfg
index f1063f19f47..a0c097b87c0 100644
--- a/Master/texmf-dist/tex/latex/toptesi/toptesi.cfg
+++ b/Master/texmf-dist/tex/latex/toptesi/toptesi.cfg
@@ -5,20 +5,12 @@
%% The original source files were:
%%
%% toptesi.dtx (with options: `topcfg')
+%% ______________________________________________________
+%% The TOPtesi package
+%% Copyright (C) 2010 Claudio Beccari
+%% All rights reserved
%%
-%% Copyright 1989--2005 Claudio Beccari All rights reserved.
-%%
-%% This system is distributed in the hope that it will be useful,
-%% but WITHOUT ANY WARRANTY; without even the implied warranty of
-%% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-%%
-%%
-%% IMPORTANT NOTICE:
-%%
-%% This file is subject to the LPPL licence, version 1.3 or any subsequent
-%% version. Copy of the LaTeX Project Public Licence is downloadable from
-%% any CTAN archive.
-%%
+%% License information appended
%%
%% \CharacterTable
%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -56,6 +48,36 @@
\InName{in}
%%\TutorName{Tutore}
%%\CycleName{ciclo}
-\endinput
+%%
+%% Copyright 2005-2010 Claudio Beccari
+%%
+%% Distributable under the LaTeX Project Public License,
+%% version 1.3c or higher (your choice). The latest version of
+%% this license is at: http://www.latex-project.org/lppl.txt
+%%
+%% This work is "author-maintained"
+%%
+%% This work consists of this file toptesi.dtx, a README file
+%% and the derived files:
+%%
+%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, topsize14,
+%% trieste.sty, toptesi.cfg, and the English documentation toptesi.pdf;
+%%
+%% Furthermore the bundle contains the documentation source file toptesi-doc.tex
+%% and the derived file toptesi-doc.pdf.
+%%
+%% The toptesi-example.tex source file is just an example that shows how
+%% to use the various commands; by commenting or decommenting certain
+%% source lines it is possible to typeset different kind of theses and their
+%% frontpages.
+%%
+%% The toptesi.cfg file is a sample of a local configuration file that can be
+%% freely edited and modified.
+%%
+%% By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files
+%% and the English documentation file in pdf format.
+%%
+%% The documentation file toptesi-doc.pdf is in Italian; its source file is
+%% another example of how to use toptesi.
%%
%% End of file `toptesi.cfg'.
diff --git a/Master/texmf-dist/tex/latex/toptesi/toptesi.cls b/Master/texmf-dist/tex/latex/toptesi/toptesi.cls
index 10636942b9b..6d514576f3e 100644
--- a/Master/texmf-dist/tex/latex/toptesi/toptesi.cls
+++ b/Master/texmf-dist/tex/latex/toptesi/toptesi.cls
@@ -5,20 +5,12 @@
%% The original source files were:
%%
%% toptesi.dtx (with options: `class')
+%% ______________________________________________________
+%% The TOPtesi package
+%% Copyright (C) 2010 Claudio Beccari
+%% All rights reserved
%%
-%% Copyright 1989--2005 Claudio Beccari All rights reserved.
-%%
-%% This system is distributed in the hope that it will be useful,
-%% but WITHOUT ANY WARRANTY; without even the implied warranty of
-%% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-%%
-%%
-%% IMPORTANT NOTICE:
-%%
-%% This file is subject to the LPPL licence, version 1.3 or any subsequent
-%% version. Copy of the LaTeX Project Public Licence is downloadable from
-%% any CTAN archive.
-%%
+%% License information appended
%%
%% \CharacterTable
%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -38,12 +30,42 @@
\NeedsTeXFormat{LaTeX2e}
\ProvidesClass{toptesi}%
-[2008/12/15 v.5.00 Class for typesetting university theses]
+[2010/11/14 v.5.01 Class for typesetting university theses]
\DeclareOption*{\PassOptionsToClass{\CurrentOption}{report}}
\ProcessOptions\relax
\LoadClass[a4paper]{report}
\RequirePackage[english,italian]{babel}
\RequirePackage{toptesi}
-\endinput
+%%
+%% Copyright 2005-2010 Claudio Beccari
+%%
+%% Distributable under the LaTeX Project Public License,
+%% version 1.3c or higher (your choice). The latest version of
+%% this license is at: http://www.latex-project.org/lppl.txt
+%%
+%% This work is "author-maintained"
+%%
+%% This work consists of this file toptesi.dtx, a README file
+%% and the derived files:
+%%
+%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, topsize14,
+%% trieste.sty, toptesi.cfg, and the English documentation toptesi.pdf;
+%%
+%% Furthermore the bundle contains the documentation source file toptesi-doc.tex
+%% and the derived file toptesi-doc.pdf.
+%%
+%% The toptesi-example.tex source file is just an example that shows how
+%% to use the various commands; by commenting or decommenting certain
+%% source lines it is possible to typeset different kind of theses and their
+%% frontpages.
+%%
+%% The toptesi.cfg file is a sample of a local configuration file that can be
+%% freely edited and modified.
+%%
+%% By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files
+%% and the English documentation file in pdf format.
+%%
+%% The documentation file toptesi-doc.pdf is in Italian; its source file is
+%% another example of how to use toptesi.
%%
%% End of file `toptesi.cls'.
diff --git a/Master/texmf-dist/tex/latex/toptesi/toptesi.sty b/Master/texmf-dist/tex/latex/toptesi/toptesi.sty
index f2ef8813c8e..5a085e895a0 100644
--- a/Master/texmf-dist/tex/latex/toptesi/toptesi.sty
+++ b/Master/texmf-dist/tex/latex/toptesi/toptesi.sty
@@ -5,20 +5,12 @@
%% The original source files were:
%%
%% toptesi.dtx (with options: `topsty')
+%% ______________________________________________________
+%% The TOPtesi package
+%% Copyright (C) 2010 Claudio Beccari
+%% All rights reserved
%%
-%% Copyright 1989--2005 Claudio Beccari All rights reserved.
-%%
-%% This system is distributed in the hope that it will be useful,
-%% but WITHOUT ANY WARRANTY; without even the implied warranty of
-%% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-%%
-%%
-%% IMPORTANT NOTICE:
-%%
-%% This file is subject to the LPPL licence, version 1.3 or any subsequent
-%% version. Copy of the LaTeX Project Public Licence is downloadable from
-%% any CTAN archive.
-%%
+%% License information appended
%%
%% \CharacterTable
%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -38,10 +30,11 @@
\NeedsTeXFormat{LaTeX2e}
\ProvidesPackage{toptesi}%
-[2008/12/15 v.5.00 Extension for toptesi.cls]%
+[2010/11/14 v.5.01 Extension for toptesi.cls]%
\def\TRON{\tracingcommands \tw@ \tracingmacros \tw@}
\def\TROFF{\tracingcommands\z@ \tracingmacros \z@}
\let\TROF\TROFF
+\newlength\T@Pbinding\setlength\T@Pbinding{7mm}\def\setbindingcorrection#1{\T@Pbinding=#1}
\newif\if@binding \@bindingfalse
\newif\ifT@Ppdfa \T@Ppdfafalse
\newif\ifchapterbibliography \chapterbibliographyfalse
@@ -70,13 +63,14 @@
\marginparwidth\oddsidemargin
\advance\marginparwidth 1in
\advance\marginparwidth-2.5\marginparsep
+\AtBeginDocument{%
\if@binding
\typeout{Messaggio Toptesi: Ricalcolo i margini}
- \advance\oddsidemargin 7mm
- \advance\evensidemargin -7mm
- \advance\marginparwidth -7mm
- \advance\marginparwidth -7mm
-\fi
+ \advance\oddsidemargin \T@Pbinding
+ \advance\evensidemargin -\T@Pbinding
+ \advance\marginparwidth -\T@Pbinding
+ \advance\marginparwidth -\T@Pbinding
+\fi}
\def\lapagina{\thepage}
\mark{{}{}}
\newbox\@intesta
@@ -354,6 +348,36 @@ Skipping any redefinition\MessageBreak}%
\line(0,1){4}}\endpicture}
}}
\ifT@Ppdfa\RequirePackage[a-1b]{pdfx}\fi
-\endinput
+%%
+%% Copyright 2005-2010 Claudio Beccari
+%%
+%% Distributable under the LaTeX Project Public License,
+%% version 1.3c or higher (your choice). The latest version of
+%% this license is at: http://www.latex-project.org/lppl.txt
+%%
+%% This work is "author-maintained"
+%%
+%% This work consists of this file toptesi.dtx, a README file
+%% and the derived files:
+%%
+%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, topsize14,
+%% trieste.sty, toptesi.cfg, and the English documentation toptesi.pdf;
+%%
+%% Furthermore the bundle contains the documentation source file toptesi-doc.tex
+%% and the derived file toptesi-doc.pdf.
+%%
+%% The toptesi-example.tex source file is just an example that shows how
+%% to use the various commands; by commenting or decommenting certain
+%% source lines it is possible to typeset different kind of theses and their
+%% frontpages.
+%%
+%% The toptesi.cfg file is a sample of a local configuration file that can be
+%% freely edited and modified.
+%%
+%% By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files
+%% and the English documentation file in pdf format.
+%%
+%% The documentation file toptesi-doc.pdf is in Italian; its source file is
+%% another example of how to use toptesi.
%%
%% End of file `toptesi.sty'.
diff --git a/Master/texmf-dist/tex/latex/toptesi/trieste.sty b/Master/texmf-dist/tex/latex/toptesi/trieste.sty
index c6f959578d8..7878394d462 100644
--- a/Master/texmf-dist/tex/latex/toptesi/trieste.sty
+++ b/Master/texmf-dist/tex/latex/toptesi/trieste.sty
@@ -5,20 +5,12 @@
%% The original source files were:
%%
%% toptesi.dtx (with options: `toptrst')
+%% ______________________________________________________
+%% The TOPtesi package
+%% Copyright (C) 2010 Claudio Beccari
+%% All rights reserved
%%
-%% Copyright 1989--2005 Claudio Beccari All rights reserved.
-%%
-%% This system is distributed in the hope that it will be useful,
-%% but WITHOUT ANY WARRANTY; without even the implied warranty of
-%% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-%%
-%%
-%% IMPORTANT NOTICE:
-%%
-%% This file is subject to the LPPL licence, version 1.3 or any subsequent
-%% version. Copy of the LaTeX Project Public Licence is downloadable from
-%% any CTAN archive.
-%%
+%% License information appended
%%
%% \CharacterTable
%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -150,6 +142,36 @@
}{%
\endlist\clearpage
}
-\endinput
+%%
+%% Copyright 2005-2010 Claudio Beccari
+%%
+%% Distributable under the LaTeX Project Public License,
+%% version 1.3c or higher (your choice). The latest version of
+%% this license is at: http://www.latex-project.org/lppl.txt
+%%
+%% This work is "author-maintained"
+%%
+%% This work consists of this file toptesi.dtx, a README file
+%% and the derived files:
+%%
+%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, topsize14,
+%% trieste.sty, toptesi.cfg, and the English documentation toptesi.pdf;
+%%
+%% Furthermore the bundle contains the documentation source file toptesi-doc.tex
+%% and the derived file toptesi-doc.pdf.
+%%
+%% The toptesi-example.tex source file is just an example that shows how
+%% to use the various commands; by commenting or decommenting certain
+%% source lines it is possible to typeset different kind of theses and their
+%% frontpages.
+%%
+%% The toptesi.cfg file is a sample of a local configuration file that can be
+%% freely edited and modified.
+%%
+%% By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files
+%% and the English documentation file in pdf format.
+%%
+%% The documentation file toptesi-doc.pdf is in Italian; its source file is
+%% another example of how to use toptesi.
%%
%% End of file `trieste.sty'.
diff --git a/Master/tlpkg/libexec/ctan2tds b/Master/tlpkg/libexec/ctan2tds
index 7a5cdec3856..4302228110c 100755
--- a/Master/tlpkg/libexec/ctan2tds
+++ b/Master/tlpkg/libexec/ctan2tds
@@ -1475,6 +1475,7 @@ $standardsource='\.(c|drv|dtx|fea|fdd|ins|sfd)$|configure.*|install-sh';
'thesis', 'install.01|install.ndx',
'termlist', 'termlist.dtx',
'teubner', 'teubner.dtx',
+ 'toptesi', 'toptesi.dtx',
'turnstile', 'turnstile-en.ins', # skip pt
'ulqda', 'ulqda.dtx',
'undolabl', 'undolabl.dtx',