From 3930d60080fdc89cfaf643df3e3f9827aec5cf94 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 28 Dec 2012 22:42:48 +0000 Subject: toptesi 5.62 (28dec12) git-svn-id: svn://tug.org/texlive/trunk@28645 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/toptesi/README | 13 +- Master/texmf-dist/doc/latex/toptesi/manifest.txt | 20 +- .../doc/latex/toptesi/toptesi-doc-xetex-a.pdf | Bin 348826 -> 1935386 bytes .../doc/latex/toptesi/toptesi-doc-xetex.pdf | Bin 291676 -> 357839 bytes .../doc/latex/toptesi/toptesi-doc-xetex.tex | 123 +++++--- .../doc/latex/toptesi/toptesi-example-xetex.pdf | Bin 67481 -> 51903 bytes .../doc/latex/toptesi/toptesi-example-xetex.tex | 25 +- .../doc/latex/toptesi/toptesi-example.pdf | Bin 270328 -> 270735 bytes .../doc/latex/toptesi/toptesi-example.tex | 54 ++-- Master/texmf-dist/doc/latex/toptesi/toptesi.pdf | Bin 364849 -> 365472 bytes Master/texmf-dist/source/latex/toptesi/toptesi.dtx | 328 ++++++++++++--------- Master/texmf-dist/tex/latex/toptesi/topcoman.sty | 2 +- Master/texmf-dist/tex/latex/toptesi/topfront.sty | 34 ++- Master/texmf-dist/tex/latex/toptesi/toptesi.cls | 2 +- Master/texmf-dist/tex/latex/toptesi/toptesi.sty | 2 +- 15 files changed, 372 insertions(+), 231 deletions(-) (limited to 'Master') diff --git a/Master/texmf-dist/doc/latex/toptesi/README b/Master/texmf-dist/doc/latex/toptesi/README index 73dc3ed9b94..1d5295c45c4 100644 --- a/Master/texmf-dist/doc/latex/toptesi/README +++ b/Master/texmf-dist/doc/latex/toptesi/README @@ -1,4 +1,4 @@ -TOPtesi bundle version 5.61d of 2012/11/09 +TOPtesi bundle version 5.62 of 2012/12/26 Copyright 2012 Claudio Beccari LaTeX Project Public Licence LPPL v.1.3 (or later) @@ -6,6 +6,7 @@ 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 and a specific @@ -18,7 +19,7 @@ to the double degree programs of the European Union Erasmus programs. This important upgrade is intended to be compliant with XeLaTeX and the documentation explains how to obtain PDF/A-1b archivable files from both pdfLaTeX and XeLaTeX. -The version number 5.61 is a stable version. +The version number 5.62 is a stable version. For installation, if the package is not already installed in your TeX system distribution, either read the Italian documentation in @@ -43,10 +44,14 @@ paths on Windows systems, all of them containing in one form or another your login name. . If the package is already installed the texmf folder should be the -/texmf-dist system one. +/texmf-dist system one. But in this case you don't need to +decompress anything and move files around. Possibly check if in the +CTAN repository there is a newer version and, in case, use your package +manager to upgrade your installation, but don't ever move or change +anything in the TeX system directories. If you are running a Windows platform change the slashes into backslashes and prefix all paths with the drive letter and any other specific prefix -that is present in the texmf tree. +that is present in your texmf tree. In any case remember to refresh the filename database! \ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/toptesi/manifest.txt b/Master/texmf-dist/doc/latex/toptesi/manifest.txt index edeb0730fac..77185fba56f 100644 --- a/Master/texmf-dist/doc/latex/toptesi/manifest.txt +++ b/Master/texmf-dist/doc/latex/toptesi/manifest.txt @@ -1,4 +1,4 @@ -manifest.txt (version 5.61) +manifest.txt (version 5.62) Copyright 2008-2012 Claudio Beccari This work may be distributed and/or modified under the conditions of @@ -38,27 +38,31 @@ The files derived from the work are the following: toptesi-example-xetex.pdf The toptesi.dtx file is self extracting and self documenting; if you run -pdflatex on it you get at the same time the class, the style and the configuration files, together with the English documented file. +pdflatex on it you get at the same time the class, the style and the +configuration files, together with the English documented file. -The Italian documentation is obtained by running xelatex on +The Italian documentation is obtained by running xelatex on toptesi-doc-xetex.tex The two documentations pdf files, toptesi.pdf and toptesi-doc-xetex.pdf, -are complementary to one another. The third documentation file -toptesi-doc-xetex-a.pdf is just the PDF/A-b version of +are complementary to one another. The third documentation file +toptesi-doc-xetex-a.pdf is just the PDF/A-b version of toptesi-doc-xetex.pdf. The files toptesi-example.tex and toptesi-example-xetex.tex -are examples of the usage of this work, the former to be run with pdfLaTeX, -the latter with XeLaTeX; they may be used as templates, but in themselves, although part of this Work, they may be used by the end user the way s/he likes best, in order to use ithem as templates, but the files should not be modified unless their names are changed. +are examples of the usage of this work, the former to be run with pdfLaTeX, +the latter with XeLaTeX; they may be used as templates, but in themselves, +although part of this Work, they may be used by the end user the way s/he likes +best, in order to use ithem as templates, but the files should not be modified +unless their names are changed. The files toptesi-example.xmpdata and toptesi-doc-xetex-def.ps are examples 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 or ghostscript for producing a file that hopefully is +able to use pdflatex or ghostscript for producing a file that hopefully is PDF/A-1b compliant (PDF/A-1b is the "weak" archivable PDF format). Maintainer: Claudio Beccari: claudio dot beccari at gmail dot com diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex-a.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex-a.pdf index 4cf67e876cb..ffe58e08c2c 100644 Binary files a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex-a.pdf and b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex-a.pdf differ diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.pdf index da86b7cf955..0fe1cfc582b 100755 Binary files a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.pdf and b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.pdf differ diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.tex b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.tex index a91605a7a9c..c30058adf0d 100644 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.tex +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.tex @@ -45,6 +45,8 @@ \newcommand*\meta[1]{$\langle$\textit{#1}$\rangle$} \newcommand*\file[1]{\texttt{#1}} \providecommand\cs[1]{\texttt{\char92#1}} +\newcommand*\oarg[1]{\texttt{]}\meta{#1}\texttt{]}} +\newcommand*\marg[1]{\texttt{\{}\meta{#1}\texttt{\}}} \makeatletter \def\GetFileInfo#1{% \def\filename{#1}% @@ -94,7 +96,7 @@ \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 pdf\/\LaTeX\ e \XeLaTeX\ riescono a produrre\footnote{Questa particolare composizione è stata eseguita con \XeLaTeX. Questo motore di composizione presenta numerosi vantaggi su \prog{pdflatex} per quel che riguarda l'uso dei font, anche per la matematica, ma non è ancora (2012) in grado di produrre l'uscita direttamente nel formato PDF, anche se apparentemente lo fa. In realtà la sua uscita è in un formato intermedio che viene poi trasformato automaticamente in PDF. L'esperienza mi insegna che in realtà le limitazioni di \XeLaTeX\ sono pochissime e, con la classe \pack{toptesi}, quella forse più importante, ma facilmente risolvibile, riguarda il formato PDF archiviabile che non è ottenibile direttamente, tanto che bisogna procedere come indicato nel paragrafo~\ref{sec:XePDFA}.}. +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 pdf\/\LaTeX\ e \XeLaTeX\ riescono a produrre\footnote{Questa particolare composizione è stata eseguita con \XeLaTeX. Questo motore di composizione presenta numerosi vantaggi su \prog{pdflatex} per quel che riguarda l'uso dei font, anche per la matematica, ma non è ancora (2012) in grado di produrre l'uscita direttamente nel formato PDF, anche se apparentemente lo fa. In realtà la sua uscita è in un formato intermedio che viene poi trasformato automaticamente in PDF. L'esperienza mi insegna che in realtà le limitazioni di \XeLaTeX\ sono pochissime e, con la classe \pack{TOPtesi}, quella forse più importante, ma facilmente risolvibile, riguarda il formato PDF archiviabile che non è ottenibile direttamente, tanto che bisogna procedere come indicato nel paragrafo~\ref{sec:XePDFA}.}. \indici @@ -337,7 +339,7 @@ Formato archiviabile& \centering PDF/A-1b & \centering NO (*) \tabularnewline \vspace{\smallskipamount} \small \noindent (*) \XeLaTeX\ non consente la produzione diretta del formato PDF/A, ma ne consente la trasformazione, forse, in modo più sicuro che con pdf\/\LaTeX. -\noindent ($\dagger$) Dalla versione del 2010 pdf\LaTeX converte automaticamente in formato PDF i file EPS, conservandone quindi il carattere vettoriale; provvede anche a scontornarli. +\noindent ($\dagger$) Dalla versione del 2010 pdf\LaTeX\ converte automaticamente in formato PDF i file EPS, conservandone quindi il carattere vettoriale; provvede anche a scontornarli. \end{table} @@ -370,7 +372,7 @@ La distribuzione di \textsf{TOPtesi} contiene molti file; ma ogni distribuzione 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-dist}, 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}, oppure da \texttt{Users} seguito dal vostro nome; 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{\textasciitilde/Library}. L'albero personale non è mai inizialmente predisposto con l'installazione del sistema \TeX; ve lo dovete creare voi. In esso creerete una struttura di rami identica a quella degli alberi di sistema, magari sarà un albero più semplice e non così ramificato come gli alberi di sistema, ma i gruppi di cartelle presenti dovranno essere innestati nello stesso modo. Qui metterete i vostri file di classe, di stile, di definizioni, eccetera, personali. quando aggiornate la vostra distribuzione del sistema \TeX\ le cartelle degli alberi di sistema potranno essere completamente riscritte, mentre il vostro albero personale non verrà assolutamente modificato. -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à. +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, cambiategli il nome ma non l'estensione, e modificatelo secondo le vostre necessità. \section{Il file di configurazione} @@ -381,7 +383,7 @@ Tutti i file del pacchetto \textsf{TOPtesi} vengono caricati nell'albero della d Potete perciò usare un diverso file di configurazione, sempre chiamato \meta{mainfile}\texttt{.cfg}, collocato nella stessa cartella dove risiede il materiale da comporre. Per esempio, potreste comporre la monografia di laurea creando da qualche parte la cartella \texttt{/monografia} e in questa cartella vi create \meta{mainfile}\texttt{.cfg} nel quale scriverete quello che vi è necessario; 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'altro file \meta{mainfile}\texttt{.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'altro file \meta{mainfile}\texttt{.cfg} che configurerete per la vostra dissertazione; sempre in questa stessa cartella metterete i file necessari per comporre la vostra dissertazione. Ovviamante nei tre casi \meta{mainfile} conterrà il nome del vostro file principale che, altrettanto ovviamente, avrà un nome diverso per ciascuna delle tre tesi. \section{Il formato PDF/A} -Le istruzioni che seguono per la produzione di un file conforme alla normativa PDF/A sono applicabili se si compone la tesi sia con il programma \prog{pdflatex} sia con \prog{xelatex}. In particolare, se si usa \prog{xelatex} e se si vogliono realizzare gli hyperlink interni si deve chiamare esplicitamente il pacchetto \pack{hyperref} configurandolo come meglio si crede, ma usando solo il comando \verb|\hypersetup| per impostare le opzioni e le personalizzazioni; per sfruttare al meglio le possibilità offerte da \prog{xelatex} è necessario caricare il pacchetto \pack{fontspec} che, senza ulteriori opzioni o specificazioni, usa di default i font Latin Modern nella versione OpenType; volendo si possono usare i comandi specifici disponibili con quel pacchetto per caricare font diversi. Notate che se avete predisposto il preambolo del vostro file sorgente per la tesi in modo da poterlo compilare con \prog{pdflatex} e avete anche specificato l'opzione \texttt{pdfa}, come indicato qui di seguito, potrete ugualmente compilare il vostro documento anche con \prog{xelatex}, perché TOPtesi è perfettamente conscio del motore di composizione che state usando e sa che il vostro file sorgente parte dal presupposto che volevate creare gli hyperlink, sfruttando il fatto di aver specificato quell'opzione. In altre parole, non avete bisogno di modificare il file sorgente per passare da \prog{pdflatex} a \prog{xelatex}. Però il file prodotto con \prog{xelatex}, per soddisfare le specifiche richieste dalla norma ISO relativo al formato archiviabile, necessita di ulteriore elaborazione. +Le istruzioni che seguono per la produzione di un file conforme alla normativa PDF/A sono applicabili se si compone la tesi sia con il programma \prog{pdflatex} sia con \prog{xelatex}. In particolare, se si usa \prog{xelatex} e se si vogliono realizzare gli hyperlink interni si deve chiamare esplicitamente il pacchetto \pack{hyperref} configurandolo come meglio si crede, ma usando solo il comando \verb|\hypersetup| per impostare le opzioni e le personalizzazioni; per sfruttare al meglio le possibilità offerte da \prog{xelatex} è necessario caricare il pacchetto \pack{fontspec} che, senza ulteriori opzioni o specificazioni, usa di default i font Latin Modern nella versione OpenType; volendo si possono usare i comandi specifici disponibili con quel pacchetto per caricare font diversi. Notate che se avete predisposto il preambolo del vostro file sorgente per la tesi in modo da poterlo compilare con \prog{pdflatex} e avete anche specificato l'opzione \texttt{pdfa}, come indicato qui di seguito, potrete ugualmente compilare il vostro documento anche con \prog{xelatex}, perché TOPtesi è perfettamente conscio del motore di composizione che state usando e sa che il vostro file sorgente parte dal presupposto che volevate creare gli hyperlink, sfruttando il fatto di aver specificato quell'opzione. In altre parole, non avete bisogno di modificare il file sorgente per passare da \prog{pdflatex} a \prog{xelatex}. Però il file prodotto con \prog{xelatex}, per soddisfare le specifiche richieste dalla norma ISO relativa al formato archiviabile, necessita di ulteriore elaborazione. Il Politecnico di Torino, come anche molte università italiane e straniere, intende ``smaterializzare'' le copie di archivio delle tesi di laurea. Questo intendimento è cominciato nel 2008 ma non sono al corrente dell'esito di questo studio a cui ho collaborato all'inizio prima di andare in pensione. @@ -418,7 +420,7 @@ Il file \texttt{pdfx.sty} carica anche il file \texttt{hyperref.sty} che permett \end{verbatim} e, come si vede, la personalizzazione è stata eseguita subito dopo il caricamento di \pack{hyperref} (operazione eseguita dal file di classe) e prima di invocare altri eventuali 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 \prog{pdflatex}) un file contenente i \emph{metadata} specifici, e che abbia estensione \texttt{xmpdata}. Per esempio, il file principale di questo documento (quando veniva compilato con \prog{pdflatex}) si chiamava \texttt{toptesi-doc.tex}: nella cartella dove risiede era stato creato il file \texttt{toptesi-doc.xmpdata} con il seguente contenuto: +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 \prog{pdflatex}) un file contenente i \emph{metadata} specifici, e che abbia estensione \texttt{xmpdata}. Per esempio, il file principale di questo documento (quando veniva compilato con \prog{pdflatex}) si chiamava \texttt{toptesi-doc.tex}: nella cartella dove risiedeva era stato creato il file \texttt{toptesi-doc.xmpdata} con il seguente contenuto: \begin{verbatim} \Author{Claudio Beccari} \Title{La classe TOPtesi} @@ -488,7 +490,7 @@ systemdict /ProcessColorModel known { [{Catalog} <> /PUT pdfmark \end{verbatim} -Questo file è formato dal nome del file .tex. \texttt{toptesi-doc-xetex} agglutinato alla ``desinenza'' \texttt{-def.ps}, per un nome complessivo \texttt{toptesi-doc-xetex-def.ps}. Ripeto: deve essere memorizzato nella stessa cartella dove si trova il main file del documento. +Questo file è formato dal nome del file \texttt{.tex.}, \texttt{toptesi-doc-xetex}, agglutinato alla ``desinenza'' \texttt{-def.ps}, per un nome complessivo \texttt{toptesi-doc-xetex-def.ps}. Ripeto: deve essere memorizzato nella stessa cartella dove si trova il main file del documento. Per eseguire la conversione conviene predisporsi una procedura .bat (per Windows) o bash {per UNIX} del tipo seguente (mostro la procedura bash che con minime modifiche si trasforma in una procedura bat) dal nome \texttt{pdf2pdfa}: \begin{verbatim} @@ -507,7 +509,8 @@ Ora basta dare il comando nella finestra comandi: \end{flushleft} e \prog{ghostscript} si mette a lavorare finché produce in uscita un file PDF con il nome del file originario allungato con \texttt{-a}. A questo punto si può procedere con il software di verifica della natura PDF/A del file ottenuto; a me, seguendo le istruzioni che ho indicato, la verifica su questo file à avuto esisto positivo al primo colpo. -Le variazioni per Windows consistono nel fatto che l'eseguibile di \prog{ghostscript} si chiama \texttt{gswin32c} invece che \texttt{gs} e che i parametri di una macro si indicano con \verb|%1|, \verb|%2|, eccetera, mentre quelli per UNIX si indicano con \verb|$1|, \verb|$2|, eccetera. +Le variazioni per Windows consistono nel fatto che l'eseguibile di \prog{ghostscript} si chiama \texttt{gswin32c} invece che \texttt{gs} e che i parametri di una macro si indicano con \verb|%1|, \verb|%2|, +eccetera, mentre quelli per UNIX si indicano con \verb|$1|, \verb|$2|, eccetera; in bash i commenti iniziano con il segno \texttt{\#} mentre in bat essi cominciano con \texttt{REM}. Nessuno vieta di arricchire la definizione della procedura per verificare l'esistenza del file PDF da convertire, o l'esistenza del file dei \emph{metadata}, con la possibilità di emettere dei messaggi cosicché l'utente possa regolarsi nel caso qualcosa risulti mancante. Tuttavia l'essenza dello script bash è quella indicata. @@ -528,8 +531,8 @@ solo purché non lo si disturbi con interventi non professionali. 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 +frontespizio. Esso in effetti, oltre a leggere l'eventuale 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 @@ -544,18 +547,18 @@ piacere, per esempio, con grande fantasia, \texttt{myfile.tex}: \documentclass[12pt]{toptesi} \setmainfont[Ligatures=TeX]{TeX Gyre Termes}% o altro font \usepackage{polyglossia} +\setmainlanguage{italian}% o altra lingua \begin{document} \logosede{logopolito} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Tesi magistrale -\facolta[I]{Ingegneria} \facolta[III]{Ingegneria dell'Informazione} \corsodilaurea{delle Telecomunicazioni} \titolo{Titolo della tesi\\ di laurea magistrale} \sottotitolo{Sottotitolo della tesi di laurea magistrale} \relatore{prof.\ Enrico Rosa} -\sedutadilaurea{Dicembre 2012} +\sedutadilaurea{Dicembre 2013} \candidata{Susanna Rossi} \secondacandidata{Laura Bruni} %\retrofrontespizio{...} @@ -563,46 +566,38 @@ piacere, per esempio, con grande fantasia, \texttt{myfile.tex}: \end{document} \end{verbatim} -Se volete usare \prog{pdflatex} aggiungete la chiamata ai pacchetti \pack{inputenc} e \pack{fontenc} con le opzioni di codifica che preferite; sostituite la chiamata a \pack{polyglossia} con la chiamata a \pack{babel} con la lingua da usare; caricate, se lo volete, un pacchetto per scegliere un font per il frontespizio; per esempio: +Se volete usare \prog{pdflatex} aggiungete la chiamata ai pacchetti \pack{inputenc} e \pack{fontenc} con le opzioni di codifica che preferite; caricate, se lo volete, un pacchetto per scegliere un font per il frontespizio; per esempio: \begin{verbatim} \usepackage[utf-8]{inputenc} \usepackage[T1]{fontenc} -\usepackage[italian]{babel} -\usepackage{txfonts} +\usepackage[italian]{babel}% o altra lingua +\usepackage{txfonts}% o altro font \end{verbatim} -Passando questo piccolo file a \prog{xelatex} o a \prog{pdflatex}, si ottiene -un documento di una o due pagine, il frontespizio e facoltativamente il retrofrontepspizio, che si possonostampare in varie copie per gli scopi detti sopra. Anche se componete il frontespizio in inglese, non potete fare a meno di chiamare \texttt{babel} o \texttt{polyglossia} perché \texttt{topfront} usa alcuni comandi di quel pacchetto. Naturalmente al posto di \texttt{italian} potete specificare un'altra lingua. +Passando uno di questi piccoli file a \prog{xelatex} o a \prog{pdflatex}, si ottiene +un documento di una o due pagine, il frontespizio e facoltativamente il retrofrontespizio, che si possono 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} o \texttt{polyglossia} perché \texttt{topfront} usa alcuni comandi di quel pacchetto. Naturalmente al posto di \texttt{italian} potete specificare un'altra lingua. Il retrofrontespizio non è necessario assolutamente quando volete produrre il frontespizio isolato. Non è nemmeno necessario quando volete comporre la tesi. Tuttavia il comando è disponibile e permette di aggiungere la dichiarazione legale in merito alla licenza; il retrofrontespizio di questa documentazione è stato composto con i comandi seguenti: \begin{verbatim} -\retrofrontespizio{Questo testo à libero secondo le condizioni -stabilite dalla Creative Commons Licence, versione 3.0 o posteriore. -L'enunciato integrale della Licenza in versione~3.0 è reperibile -all'indirizzo internet -\url{http://creativecommons.org/licenses/by-nc-nd/3.0/deed.it}. + \retrofrontespizio{Questo testo à libero secondo le condizioni + stabilite dalla \LaTeX\ Project Public Licence (LPPL) riportata + nell'appendice~\ref{ch:LPPL} alla pagina~\pageref{ch:LPPL}. -Si è liberi di riprodurre, distribuire, comunicare al pubblico, esporre -in pubblico, rappresentare, eseguire e recitare quest'opera alle -seguenti condizioni: attribuzione, non commerciale, non opere derivate. -Il significato di queste caratteristiche è spiegato in dettagli nel -sito internet indicato sopra. - \bigskip - -Composto il ... + +\noindent Composto con \XeLaTeX\ il \today \vspace*{5\baselineskip}} \end{verbatim} -Non dovete dimenticare che l'editor con cui scrivete questo piccolo file (e con il quale avete eventualmente scritto il file \texttt{toptesi.cfg}) deve essere configurato con la codifica \texttt{UTF-8} se volete usare \prog{xelatex}. +Non dovete dimenticare che l'editor con cui scrivete questo piccolo file (e con il quale avete eventualmente scritto il file \meta{mainfile}\texttt{.cfg}) deve essere configurato con la codifica \texttt{UTF-8} se volete usare \prog{xelatex}. L'altro file accessorio \texttt{topcoman.sty} contiene diversi utili comandi, alcuni già incorporati nella definizione della lingua italiana del sistema \TeX\ (solo se usate \pack{babel}). 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 +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 @@ -621,6 +616,53 @@ 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{Il logo dell'ateneo} +Non è generalmente necessario inserire nel frontespizio il logo dell'ateneo; controllate presso la vostra facoltà o presso la vostra segreteria competente le regole fissate per la composizione del frontespizio. Se il logo è richiesto, allora la segreteria vi dice anche quale logo usare e da dove scaricarne il file che ne contiene la descrizione grafica. + +Controllate se è un file vettoriale (estensione \file{.pdf} oppure \file{.eps}) oppure bitmapped (estensione \file{.jpg}, \file{.png}, \file{.bmp}, \file{.wmf}, \file{.tiff},\dots). Ricordate che \prog{pdflatex} e \prog{xelatex} possono incorporare solo i formati \file{.pdf}, \file{eps}\footnote{Dall'edizione di TeX Live 2011 anche \prog{pdflatex} è in grado di incorporare file in formato \file{.eps}, mentre prima era necessario convertirli in formato \file{.pdf}.}, \file{.jpg} o \file{.png}). Se il file viene fornito in un formato diverso da questi quattro, è necessario convertirlo in uno di questi formati. + +Vale la pena di ricordare che il formato \file{.jpg} va bene per immagini a colori sfumati come le fotografie, mentre il formato \file{.png} è molto adatto per disegni al tratto con righe fortemente contrastate rispetto allo sfondo. In generale, quindi, sarebbe meglio convertire nel formato \file{.png} un logo fornito in un formato incompatibile. + +Ricordate anche che il logo dell'ateneo è di proprietà dell'ateneo stesso e va usato secondo regole precise; è per questo che il pacchetto \pack{TOPtesi} non viene distribuito con i loghi di diversi atenei, come veniva fatto nelle prime edizioni. + +Merita segnalare che le tesi svolte nell'ambito di collaborazioni fra atenei possono richiedere i loghi dei diversi atenei partecipanti all'accordo; segnalo la Scuola interpolitecnica di dottorato condotto nell'ambito di un accordo fra i politecnico di Bari, Milano e Torino. Ricordo i programmi di doppia laurea condotto nell'ambito di un accordo fra l'ateneo di appartenenza e un altro ateneo generalmente europeo. Ricordo il programma europeo Erasmus Mundus dove il titolo di studio viene condotto da consorzi di almeno quattro atenei di nazioni diverse. In queste circostanze è spesso necessario inserire nel frontespizio i loghi di tutti gli atenei partecipanti alla convenzione. + +Il pacchetto \pack{TOPtesi} contiene un comando molto potente, \cs{logosede}, che accetta la sintassi seguente: +\begin{flushleft} +\cs{logosede}\oarg{altezza}\marg{file del logo} +\end{flushleft} +dove il valore prefissato per l'\meta{altezza} del logo è 3\,cm; con l'argomento facoltativo si più specificare un'altezza leggermente maggiore o minore del valore predefinito. Il \meta{file del logo} è costituito da un solo nome di file o da una lista di nomi di file separati da virgole corrispondenti ciascuno al logo di un diverso ateneo. Questi file devono avere i formati corrispondenti a una delle quattro estensioni consentite, ma non è necessario e specificare il nome del file completo di estensione; questa specificazione potrebbe essere necessaria solo nel caso in cui si disponga del logo di una dato ateneo in diversi formati. + +Il programma codificato nel pacchetto \pack{TOPtesi} provvede a scalare tutti i loghi all'\meta{altezza specificata} e li compone affiancati su una sola riga distanziati mediante uno spazio predefinito in 3\,em, ma impostabile ad un valore leggermente maggiore o minore tramite il comando \cs{setlogodistance}, per esempio: +\begin{verbatim} +\setlogodistance{2em} +\end{verbatim} + +Se la riga di loghi, eventualmente scalati in altezza e distanziati dello spazio predefinito o esplicitamente specificato, risultasse più larga della giustezza della pagina del titolo, il programma provvede ad uno scalamento dell'intera riga di loghi in modo che non superi la giustezza della pagina. Un solo logo viene composto centrato; due o più loghi vengono ugualmente composti centrati ma distanziati come si è detto. Seguono alcuni esempi, ma si tenga presente che i loghi usati per questi esempi non sono distribuiti insieme al sorgente di questo file, a causa delle restrizioni sulla loro proprietà legale. Un solo logo appare come nel frontespizio di questo manuale; due loghi appaiono così: +\begingroup\par\centering +\logosede{logopolito,logoINPG} +\printloghi +\par +\smallskip +\endgroup + +Tre loghi appaiono cos: +\begingroup\par\centering +\logosede{logopoliba,logopolimi,logopolito} +\printloghi +\par +\smallskip +\endgroup + +Quattro loghi di altezza predefinita producono una riga di loghi di altezza ridotto per consentire che appaiono tutti e quattro nella stessa riga: +\begingroup\par\centering +\logosede{logopolimi,logopolito,logoINPG,logoepfl} +\printloghi +\par +\smallskip +\endgroup +Si noti che lo spazio a destra e a sinistra dei quattro loghi è voluto, perché si ritiene che una immagine, sia pura formata di quattro parti, appaia meglio sulla pagina se non si estende fino al filo dei margini. + \section{Come si comincia} Non vi sto a dire niente di come si scriva una tesi; so per @@ -724,7 +766,7 @@ 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. A seconda del campo disciplinare in cui si svolge la tesi può essere importante scegliere un metodo di citazione piuttosto di un altro; la collezione di pacchetti del sistema \TeX\ vi consente un'ampia scelta di personalizzazioni per gli stili di composizione e di citazione. Oggi (2012), poi, si sta diffondendo l'uso del pacchetto di estensione \pack{biblatex} che consente una gestione diretta della bibliografia mediante comandi \LaTeX; in ogni caso per queste personalizzazioni è necessario creare un database bibliografico (con estensione \texttt{.bib}) in un formato particolare, e poi è necessario elaborare questo database mediante il programma \prog{bibtex} o \prog{biber} (obbligatorio con \pack{biblatex} dal 2012), sempre facente parte della distribuzione del sistema \TeX. I risultati che si possono ottenere sono estremamente professionali. +La bibliografia conclude la tesi. A seconda del campo disciplinare in cui si svolge la tesi può essere importante scegliere un metodo di citazione piuttosto di un altro; la collezione di pacchetti del sistema \TeX\ vi consente un'ampia scelta di personalizzazioni per gli stili di composizione e di citazione. Oggi (2012), poi, si sta diffondendo l'uso del pacchetto di estensione \pack{biblatex} che consente una gestione diretta della bibliografia mediante comandi \LaTeX; in ogni caso per queste personalizzazioni è necessario creare un database bibliografico (con estensione \texttt{.bib}) in un formato particolare, e poi è necessario elaborare questo database mediante il programma \prog{bibtex} o \prog{biber} (predefinito con \pack{biblatex} dal 2012), sempre facente parte della distribuzione del sistema \TeX. I risultati che si possono ottenere sono estremamente professionali. \subsection{La scelta della codifica per il file sorgente} @@ -802,13 +844,13 @@ I file della collezione Computer Modern con codifica \texttt{T1}, conosciuti anc ... \end{verbatim} -Se il file viene gestito con \prog{xelatex}, oltre alla codifica \texttt{utf-8} di default \emph{che non va esplicitata}, basta richiedere l'uso del pacchetto \pack{fontspec} senza ulteriori opzioni e viene automaticamente caricata ed usata la collezione dei font Latin Modern nella loro versione OpenType; a questo provvede direttamente la classe TOPtesi. Usando \prog{xelatex}, gli appositi comandi per la selezione dei font sia testuali sia per la matematica può essere eseguita nel preambolo senza bisogno di ricaricare il pacchetto \pack{fontenc}. Volendo, invece di usare i font Latin Modern, si possono impostare facilmente altre famiglie di font con comodi comandi che fanno riferimento ai font OpenType installati sulla propria macchina. +Se il file viene gestito con \prog{xelatex}, oltre alla codifica \texttt{utf-8} di default \emph{che non va esplicitata}, basta richiedere l'uso del pacchetto \pack{fontspec} senza ulteriori opzioni e viene automaticamente caricata ed usata la collezione dei font Latin Modern nella loro versione OpenType; a questo provvede direttamente la classe \pack{TOPtesi}. Usando \prog{xelatex}, gli appositi comandi per la selezione dei font sia testuali sia per la matematica può essere eseguita nel preambolo senza bisogno di ricaricare il pacchetto \pack{fontenc}. Volendo, invece di usare i font Latin Modern, si possono impostare facilmente altre famiglie di font con comodi comandi che fanno riferimento ai font OpenType installati sulla propria macchina. 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, secondo me, 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, per la composizione della tesi con \prog{pdflatex} segnalo solo la collezione dei font Times eXtended, 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 il motore di composizione \prog{xelatex} usando i font OpenType TeX Gyre Termes con codifica UNICODE presenti nella distribuzione del sistema \TeX; come si vede la divisione delle parole in fin di riga non presenta 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 se si usa il motore di composizione \prog{pdflatex}; non si sa mai, ma certamente con questa codifica si hanno meno inconvenienti e le lettere accentate sono disegnate meglio. Se si usa come motore \prog{pdflatex}, è conveniente usare il pacchetto di estensione \pack{microtype} che consente di rendere ancora migliori le righe del testo composto; purtroppo le funzionalità di questo pacchetto sono solo parzialmente usabili con \prog{xelatex}, almeno fino a quando questo programma produrrà il suo file PDF di uscita convertendo un formato intermedio in formato XDV (DVI esteso). +Tanto per confronto, questo testo di documentazione su \textsf{TOPtesi} è composto con il motore di composizione \prog{xelatex} usando i font OpenType TeX Gyre Termes con codifica UNICODE presenti nella distribuzione del sistema \TeX; come si vede la divisione delle parole in fin di riga non presenta 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 se si usa il motore di composizione \prog{pdflatex}; non si sa mai, ma certamente con questa codifica si hanno meno inconvenienti e le lettere accentate sono disegnate meglio. Se si usa come motore \prog{pdflatex}, è conveniente usare il pacchetto di estensione \pack{microtype} che consente di rendere ancora migliori le righe del testo composto; purtroppo le funzionalità di questo pacchetto sono solo parzialmente usabili con \prog{xelatex}, almeno fino a quando questo programma produrrà il suo file PDF di uscita convertendo un formato intermedio in formato XDV (DVI esteso); comunque si può usare \pack{microtype} anche compilando con \prog{xelatex} anche se i miglioramenti sono meno ``vistosi''. \section{Come stampare la tesi} @@ -1027,7 +1069,7 @@ Ovviamente le parole ``Resumen'' (Sommario) e ``Agradecimientos'' (Ringraziament È 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. -Se si usa \prog{xelatex} ci si ricordi che il pacchetto \pack{polyglossia} è già caricato dalla classe TOPtesi, che provvede già a dichiarare l'italiano come lingua principale e l'inglese come lingua accessoria; si possono nominare nel preambolo della tesi diverse altre lingue accessorie, per esempio: +Se si usa \prog{xelatex} ci si ricordi che il pacchetto \pack{polyglossia} è già caricato dalla classe \pack{TOPtesi}, che provvede già a dichiarare l'italiano come lingua principale e l'inglese come lingua accessoria; si possono nominare nel preambolo della tesi diverse altre lingue accessorie, per esempio: \begin{verbatim} \setotherlanguages{french, spanish} \end{verbatim} @@ -1057,7 +1099,7 @@ servono solo per il frontespizio. Essi saranno descritti nei paragrafi seguenti. \section{Le opzioni} -La classe \texttt{toptesi} accetta diverse opzioni nel +La classe \pack{TOPtesi} accetta diverse opzioni nel comando 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 @@ -1330,8 +1372,11 @@ terzo candidato& scuola di dottorato & \cs{\scuoladidottorato\d\{SCUDO\}}\\ \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\}}\\ +\cs{\logosede[...]\{...\}}&nessuno&\raggedright Inserisce nel frontespizio il logo + dell'ateneo, specificandone opzionalmente l'altezza + (default: 3\,cm)& + \cs{\logosede\d[2cm]\{logopolito,\d logopolimi\}}\\ +\cs{setlogodistance}\{...\}& 3\,em & imposta la distanza fra i loghi& \setlogodistance{25mm}\\ \midrule \cs{\retrofrontespizio}& nessuno& \multicolumn2{p{.5\textwidth}}{Se specificato, serve solitamente per scrivere nel verso @@ -1424,7 +1469,7 @@ se devono rappresentare delle modifiche ``permanenti''; usateli anche per predisporre quelle stringhe in una lingua diversa dall'italiano. -Per comporre questo testo si è usata la classe \texttt{toptesi}, +Per comporre questo testo si è usata la classe \pack{TOPtesi}, e si è supposto di scrivere una monografia; tuttavia alcune delle stringhe di default non sono adeguate a questo uso, quindi il preambolo di questo documento contiene le seguenti specificazioni diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.pdf index 66aafd5b005..60c75f54590 100755 Binary files a/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.pdf and b/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.pdf differ diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.tex b/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.tex index b3054656bfe..51608dc230d 100755 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.tex +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.tex @@ -10,7 +10,7 @@ % % Esempio di composizione di tesi di laurea. % -% Questo esempio e' stato preparato inizialmente 13-marzo-1989 +% Questo esempio e' stato preparato inizialmente il 13-marzo-1989 % e poi e' stato modificato via via che TOPtesi andava % arricchendosi di altre possibilita'. % @@ -18,6 +18,7 @@ % % Nel seguito laurea "quinquennale" sta anche per "specialistica" o "magistrale" % +% Il file sorgente deve essere creato e modificato con la codifica utf8 % % \usepackage{fontspec} @@ -30,13 +31,15 @@ \setotherlanguage[variant=ancient]{greek} \newfontfamily{\greekfont}{GFS Didot} -% Anche se nelle opzioni della chiamata alla classe compare pdf a, il file che gestisce -% queste cose e che carica hyperref con l'opzione pdf a, non vine caricato, perché viene +% Anche se nelle opzioni della chiamata alla classe compare pdfa, il file che gestisce +% queste cose e che carica hyperref con l'opzione pdfa, non viene caricato, perché viene % caricato solo se si usa pdflatex; per avere i collegamenti ipertestuali bisogna caricare % esplicitamente hyperref, ma poi la trasformazione in file PDF/A compliant va eseguita % attraverso ghostscript. % -% Commentare le righe seguenti se NON si non si vogliono i link ipertestuali +% Commentare le righe seguenti se NON si non si vogliono i link ipertestuali; in questo +% caso non usare nemmeno l'opzione pdfa. Se si specifica pdfa e si vogliono i +% collegamenti ipertestuali, allora conservare solo le righe del comando \hypersetup. \usepackage{hyperref} \hypersetup{% pdfpagemode={UseOutlines}, @@ -52,12 +55,14 @@ % \english % ATTENZIONE: con XeLaTeX le informazioni per i frontespizio vanno inserite dopo % \begin{document} -%\ateneo{Università degli Studi di Roma} -%\nomeateneo{Tor Vergata} +\ateneo{Università degli Studi di Roma} +\nomeateneo{Tor Vergata} +\logosede{logouniroma2}% questo e' ovviamente facoltativo, ma e' richiesto per il dottorato al PoliTO +%\logosede{logopolito,logopolimi,logopoliba}% Per la scuola interpolitecnica di dottorato \facolta[III]{Matematica, Fisica\\e Scienze Naturali} %\Materia{Remote sensing} %\monografia{La pressione barometrica di Giove}% per la laurea triennale -\titolo{La pressione barometrica di Giove}% per la laurea quinquennale e il dottorato +\titolo{La pressione barometrica di~Giove}% per la laurea quinquennale e il dottorato \sottotitolo{Metodo dei satelliti medicei}% per la laurea quinquennale e il dottorato \corsodilaurea{Astronomia Applicata}% per la laurea %\corsodidottorato{Meccanica}% per il dottorato @@ -77,7 +82,6 @@ %\annoaccademico{1615-1616}% solo con l'opzione classica %\annoaccademico{2006-2007}% idem \ciclodidottorato{XV}% per il dottorato -\logosede{logopolito}% questo e' ovviamente facoltativo, ma e' richiesto per il dottorato al PoliTO % %\chapterbib %solo per vedere che cosa succede; e' preferibile comporre una sola bibliografia %\AdvisorName{Supervisors} @@ -86,19 +90,20 @@ \vspace{2\baselineskip} Stampato il \today} + \newtheorem{osservazione}{Osservazione}% Standard LaTeX %\setbindingcorrection{3mm} \ifclassica - \paginavuota + \tomo + \paginavuota% Per avere la dedica sul recto, ma non subito dopo il retrofrontepsizio \begin{dedica} A mio padre \textdagger\ A mio nonno Pino \end{dedica} - \tomo \else \frontespizio \fi diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-example.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-example.pdf index 1c8196caf78..f2879ce12fb 100644 Binary files a/Master/texmf-dist/doc/latex/toptesi/toptesi-example.pdf and b/Master/texmf-dist/doc/latex/toptesi/toptesi-example.pdf differ diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-example.tex b/Master/texmf-dist/doc/latex/toptesi/toptesi-example.tex index 7e16f36521a..e2860c6adbb 100644 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-example.tex +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-example.tex @@ -23,23 +23,26 @@ % % Esempio di composizione di tesi di laurea con PDFLATEX <---------------- ! % -% Questo esempio e' stato preparato inizialmente 13-marzo-1989 +% Questo esempio e' stato preparato inizialmente il 13-marzo-1989 % e poi e' stato modificato via via che TOPtesi andava -% arricchendosi di altre possibilita'. +% arricchendosi di altre possibilità. % -% Per comporre con XeLaTeX, invece che con pdfLaTeX, vedere il file toptesi-example-xetex.tex +% Per comporre con XeLaTeX, invece che con pdfLaTeX, vedere il file +% toptesi-example-xetex.tex % A parte i font, bisogna specificare alcune cose dopo la fine del preambolo. % % Nel seguito laurea "quinquennale" sta anche per "specialistica" o "magistrale". % % Cambiare encoding a piacere; oppure non caricare nessun encoding se si usano -% solo caratteri a 7 bit (ASCII) nei file d'entrata. +% solo caratteri a 7 bit (ASCII) nei file d'entrata. La codifica utf8 sarebbe +% quella maggiormente desiderabile; richiede però un editor che sappia gestirla. % %\usepackage[ansinew]{inputenc}% per macchine Windows \usepackage[latin1]{inputenc}% per macchine Linux/Mac/UNIX \usepackage[T1]{fontenc}\usepackage{lmodern} % -%\ateneo{Universit{\`a} degli Studi di Trieste} +\ateneo{Universit{\`a} degli Studi di Trieste} +\nomeateneo{Castello di Miramare} \facolta[III]{Matematica, Fisica\\e Scienze Naturali} %\Materia{Remote sensing} %\monografia{La pressione barometrica di Giove}% per la laurea triennale @@ -47,19 +50,37 @@ \sottotitolo{Metodo dei satelliti medicei}% per la laurea quinquennale e il dottorato \corsodilaurea{Astronomia Applicata}% per la laurea %\corsodidottorato{Meccanica}% per il dottorato -\candidato{Galileo \textsc{Galilei}}% per tutti i percorsi -\secondocandidato{Evangelista \textsc{Torricelli}}% per la laurea magistrale solamente + +%%%%%%% Trucco per inserire la matricola sotto il nome di ogni candidato +\candidato{\tabular{@{}l@{}}Galileo \textsc{Galilei}\\matricola: 123456\endtabular}% per tutti i percorsi +\secondocandidato{\tabular{@{}l@{}}Evangelista \textsc{Torricelli}\\matricola: 123457\endtabular}% per la laurea magistrale solamente + +%%%%%%% %\direttore{prof. Albert Einstein}% per il dottorato %\coordinatore{prof. Albert Einstein}% per il dottorato \relatore{prof.\ Albert Einstein}% per la laurea e/o il dottorato \secondorelatore{dipl.~ing.~Werner von Braun}% per la laurea magistrale +%%%%%%%%%% Trucco per mettere il correlatore senza usare l'opzione classica +%\relatore{\tabular{@{}l@{}} +%prof.\ Albert Enstein\\[1.5ex] +%\textbf{Correlatore:}\\ +%dipl.~ing.~Werner von Braun +%\endtabular} +%%%%%%%%%% +% +%%%%%%%%%% Trucco per far scrivere Laureando/a/i/e al posto di "Candidato/a/i/e" +%\def\Candidato{Laureando:} +%\def\Candidati{Laureandi:} +%\def\Candidata{Laureanda:} +%\def\Candidate{Laureande:} +%%%%%%%%%% %\terzorelatore{{\tabular{@{}l}dott.\ Neil Armstrong\\prof. Maria Rossi\endtabular}}% per la laurea magistrale %\tutore{ing.~Karl Von Braun}% per il dottorato \tutoreaziendale{dott.\ ing.\ Giovanni Giacosa} \NomeTutoreAziendale{Supervisore aziendale\\Centro Ricerche FIAT} -%\sedutadilaurea{Agosto 1615}% per la laurea quinquennale -%\esamedidottorato{Novembre 1610}% per il dottorato +%\sedutadilaurea{Agosto 1615}% per la laurea quinquennale; oppure: \sedutadilaurea{\textsc{Anno~accademico} 1615-1616}% per la laurea magistrale +%\esamedidottorato{Novembre 1610}% per il dottorato %\annoaccademico{1615-1616}% solo con l'opzione classica %\annoaccademico{2006-2007}% idem \ciclodidottorato{XV}% per il dottorato @@ -69,22 +90,11 @@ %\AdvisorName{Supervisors} \newtheorem{osservazione}{Osservazione}% Standard LaTeX -%\usepackage[a-1b]{pdfx} -%\hypersetup{% -% pdfpagemode={UseOutlines}, -% bookmarksopen, -% pdfstartview={FitH}, -% colorlinks, -% linkcolor={blue}, -% citecolor={green}, -% urlcolor={blue} -% } - %\setbindingcorrection{3mm} -\begin{document}\errorcontextlines=9 +\begin{document}%\errorcontextlines=9% debugging -\english +%\english: di default vale \italiano \expandafter\ifx\csname StileTrieste\endcsname\relax \frontespizio diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf index d38d0a8dc12..4c944907de2 100644 Binary files a/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf and b/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf differ diff --git a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx index 47125086e29..59737fc5613 100644 --- a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx +++ b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx @@ -85,7 +85,7 @@ another example of how to use toptesi. % \iffalse %<*driver> \documentclass{ltxdoc} -\ProvidesFile{toptesi.dtx}[2012/11/09 v.5.61d Documented TeX file for +\ProvidesFile{toptesi.dtx}[2012/12/26 v.5.62 Documented TeX file for the TOPtesi bundle] \GetFileInfo{toptesi.dtx} \title{The TOPtesi bundle} @@ -102,7 +102,7 @@ the TOPtesi bundle] % % \fi % -% \CheckSum{2571} +% \CheckSum{2613} % %% \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 @@ -370,10 +370,14 @@ the TOPtesi bundle] % \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. +% \Item[logosede] specifies the name of the file or the files that contain the university +% logos; 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. a list of logos can be specified, useful when a +% thesis is carried on in a multiple University environment such as, for +% example that takes place in a double degree Erasmus program; or under +% the Erasmus Mundus program. The ``string'' of logos is scaled properly so +% that they may fit in the |\textwidth|. % \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 the binding % correction. Its argument is not optional and is used to modify the @@ -392,32 +396,33 @@ the TOPtesi bundle] % As a final remark notice that the commands for typesetting the title page and the % copyright 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 +% typeset either 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 and copyright (if any) pages. % % \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{graphicx} -% extension package, besides those provided by the \texttt{babel} package. +% the \LaTeX\ \texttt{kernel}, the \texttt{report} document class, and the +% \texttt{graphicx} extension package, besides those provided by the \texttt{babel} +% package. % If the source thesis file is being typeset by means of \XeLaTeX\ the \texttt{babel} % package is not loaded; in its place the \texttt{polyglossia} package is loaded that % should implement in \XeLaTeX\ most of the functionality provided by \texttt{babel} to % \LaTeX. ``Most'' means that not all the functionality is available, therefore it's better % to consult the documentation of \texttt{polyglossia} before using its built in commands. % -% 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 by means of \textsf{pdflatex}, 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: +% 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 by means of \textsf{pdflatex}, it would be +% necessary to specify the option \texttt{french} among the \emph{class} options, and then +% 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 +% options \emph{must be specified} as global class options; so if the thesis has % to be typeset, for example, in French, is is necessary to do the following: %\begin{verbatim} %\documentclass[...,french,...]{toptesi} @@ -425,7 +430,7 @@ the TOPtesi bundle] %\begin{document} %\selectlanguage{french} %\end{verbatim} -% But if the thesis should be typeset in Frenche by means of \XeLaTeX, then it is perfectly +% But if the thesis should be typeset in French by means of \XeLaTeX, then it is perfectly % legal to specify the auxiliary language in this way: %\begin{verbatim} %\documentclass[...]{toptesi} @@ -441,29 +446,30 @@ the TOPtesi bundle] % Remember that \texttt{babel} and \texttt{polyglossia} 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 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 \emph{basic} distribution of the \TeX\ -% system has many language defaults, it is more likely that French is preloaded while Italian is -% not. Complete distributions don't exhibit this flaw. -% -% 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 very properly; -% it would be very upsetting to use 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. +% reading the first dozen lines of your thesis \texttt{.log} file; there the list of all +% language hyphenation rules that are available in the format file is being shown. +% While (American) English is the default and almost any \emph{basic} distribution of the +% \TeX\ system has many language defaults, it is more likely that French is preloaded while +% Italian is not. Complete distributions don't exhibit this flaw. +% +% 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 properly +% configure the system; it would be very upsetting to use 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{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 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 @@ -492,12 +498,12 @@ the TOPtesi bundle] % % % \Item[ped] inserts a subscript in upright type; the ISO regulations % require the use of italics for physical or mathematical quantities, and -% upright type for whatever is not a variable, from the names of +% upright type for anythingg that is not a variable, from the names of % functions (such as sin, cos, log, etc.), to the indices that contain % information on something that is not variable. This means that $V_i$ % requires an italic index to imply that the object $V$ is the $i$-th in % a set, while, say, $V_{\mathrm{max}}$ indicates the maximum value of the -% variable $V$. This command may be used both in math and in text mode. +% variable $V$. This command |\ped| may be used both in math and in text mode. % % % \Item[ap] similarly |\ap| inserts an apex in upright type, both in math % and in text mode. @@ -518,7 +524,7 @@ the TOPtesi bundle] % \Item[micro] sets the decimal prefix $\mu$ in typesetting units of % measure. % % -% \Item[gradi] sets the small circle that defines the sexagesimal degrees, for +% \Item[gradi] sets the small circle that defines the sexagesimal degrees, for % example $35^\circ$; it may be used also for the celsius degrees by writing in the % source file, say, |35\unit{\gradi C}| in order to get % $35\,^\circ\mathrm{C}$. @@ -532,14 +538,14 @@ the TOPtesi bundle] % English word. The imaginary unit is not a variable, and the ISO regulations % require it is typed with an upright serifed font, just as operators are. % % -% \Item[eu] inserts the Euler number symbol ``e'' in upright type; since +% \Item[eu] inserts the Napier 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 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. \XeTeX\ allows to typeset upright Greek letters, % so there is the facility to typeset an upright ``pi'' (the number) to be distinguished -% from an inclined ''pi'' (the angle). +% from an slanted ''pi'' (the angle). % % % \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 @@ -551,11 +557,12 @@ the TOPtesi bundle] % \end{description} % % All these commands are defined into the separate package \texttt{topcoman.sty} -% that can be used as an independent extension package with (possibly) any document class. +% that can be used as an independent extension package with (may be) any document class. % % \section{Format PDF suitable for archiving} % This section in general does not apply if the thesis is typeset by means of \XeLaTeX, -% because the typesetting engine in this case cannot directly produce a PDF formatted output +% because the typesetting engine in this case cannot directly produce a PDF formatted +% output % file. For this reason the option \texttt{pdfa}, that shall be described shortly, should % not specified to the class |toptesi|; at the same time if this option is specified, but % the thesis is typeset by means of \XeLaTeX, the effects of this options are be disabled. @@ -569,7 +576,9 @@ the TOPtesi bundle] % (ISO) that in 2005 published the regulation ISO~19005-1. This regulation defines a % PDF variant suitable for archiving, named PDF/A, that has two sub-formats % distinguished as PDF/A-1a, and PDF/A-1b. The `a' sub-format is more exacting, while -% the `b' one is less stringent. +% the `b' one is less stringent. Recently ISO has published an upgrade to these +% regulations, but here we stick to the older ones, that are a sub set of the newer ones, +% and for which suitable software is available. % % The requirements for the `a' sub-format imply not only those imposed on the `b' one, % but also that all characters are conforming to UNICODE and that the logical structure @@ -630,8 +639,8 @@ the TOPtesi bundle] % patch, but unfortunately its PDF byproduct is not PDF/A compliant (it must be converted % by means of \prog{ghostscript}). % \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 +% \item If you include PDF images that contain some text, be sure that the fonts for +% this text are 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 @@ -639,23 +648,23 @@ the TOPtesi bundle] % conformity. % \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 +% that 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, % although the most authoritative, is a commercial program; probably your university % has special facilities for this task. % \item If you use \prog{xelatex} for typesetting your thesis, you have to accompany your -% master file with another one that contains the metadata and othe necessary information. +% master file with another one that contains the metadata and other necessary information. % Be sure to call this auxiliary file as the masterfile name glued with |-def.ps|; so if % your mastefile is named \texttt{JohnSmithMasterThesis.tex}, name this auxiliary file as % \texttt{JohnSmithMasterThesis-def.ps} and fill in the necessary metadata and other -% thechnical information into this file in the line marked with |% Customize|. Then run +% thechnical information into this file in the lines marked with |% Customize|. Then run % the \prog{ghostscript} program with the proper name (different for Windows or UNIX-like % platforms) with the proper input parameters and options. There are strong chances that % if you follow the general recommendations shown here and in the document % |toptesi-doc-xetex.pdf| file, the output file will be PDF/A compliant. %\end{itemize} % -% Let's issue a warning: if you are using Adobe Reader X (or later), this program will open +% Let's warn you: if you are using Adobe Reader X (or later), this program will open % a PDF file beginning with an information header claiming that the file is PDF/A % compliant; maybe it's true, but do not trust this information too much, at least don't % believe that this information is a ``certification'' of the PDF/A compliance. I have seen @@ -684,19 +693,21 @@ the TOPtesi bundle] % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} \ProvidesClass{toptesi}% -[2012/11/09 v.5.61d Class for typesetting university theses] -% \end{macrocode} -% -% The class itself is very simple since it requires just the \texttt{report} -% document class and some packages with some default options. All options -% specified for the \texttt{toptesi} class are passed on to the \texttt{report} -% class; the latter, on turn, is called with the \texttt{a4paper} option. -% According to the \LaTeX\ machinery of option passing the options passed on to -% the loaded class should be appended to the existing options, so that if \texttt{letterpaper} -% was specified in the calling statement of \texttt{toptesi}, this last option would -% override the default \texttt{a4paper} option. The same holds true for the other package -% options except for the encoding name used as an option for the \texttt{inputenc} package; this % simply does not work and the package is not loaded any more as it was in the previous % versions\footnote{Thanks to Enrico Gregorio who pointed out this feature.}. -% Similarly if another language was specified in the list of \texttt{toptesi} +[2012/12/26 v.5.62 Class for typesetting university theses] +% \end{macrocode} +% +% The class itself is very simple since it requires just the \texttt{report} document +% class and some packages with some default options. All options specified for the +% \texttt{toptesi} class are passed on to the \texttt{report} class; the latter, on turn, +% is called with the \texttt{a4paper} option. According to the \LaTeX\ machinery of option +% passing, the options passed on to the loaded class should be appended to the existing +% options, so that if \texttt{letterpaper} was specified in the calling statement of +% \texttt{toptesi}, this last option would override the default \texttt{a4paper} option. +% The same holds true for the other package options except for the encoding name used +% as an option for the \texttt{inputenc} package; this simply does not work and the +% package is not loaded any more as it was in the previous versions\footnote{Thanks to +% Enrico Gregorio who pointed out this feature.}. +% Similarly if another language was specified in the list of \texttt{toptesi} % options, this language would be appended yo the \texttt{babel} package default options % and would become the default language. % \begin{macrocode} @@ -736,7 +747,7 @@ the TOPtesi bundle] % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{toptesi}% -[2012/11/09 v.5.61d Extension for toptesi.cls]% +[2012/12/26 v.5.62 Extension for toptesi.cls]% % \end{macrocode} % % We start with defining the debugging macros; these trace commands and macros @@ -1729,7 +1740,7 @@ Skipping any redefinition\MessageBreak}% % \fi % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{topfront}[2012/11/09 v.5.61d Title page for TOPtesi] +\ProvidesPackage{topfront}[2012/12/26 v.5.62 Title page for TOPtesi] % \end{macrocode} % % The title page information depends on the type of ``thesis' that is being typeset. @@ -1827,12 +1838,12 @@ Skipping any redefinition\MessageBreak}% % The |\second...| commands set the plural forms of the labels printed above % the name lists. For the candidates there are different commands to input % ladies or gentlemen names; according to the masculine (ending in `o') or feminine -% (ending in `a') commands the appropriate truth values are assigned to the +% (ending in `a') commands, the appropriate truth values are assigned to the % boolean variable \texttt{femminile} and the labels are set accordingly. % % Notice that in the case of bachelor degree final report no supervisor name is printed % even if one or more supervisor names are specified. This must be kept in mind in order -% to avoid surprises in finding missing information in the title page. Further on there +% to avoid surprises in finding missing information in the title page. Further on, there % are suggestions for circumventing this fact. % \begin{macrocode} \def\relatore#1{\gdef\@principaladviser{#1}} @@ -1846,35 +1857,33 @@ Skipping any redefinition\MessageBreak}% \def\terzacandidata#1{\gdef\@thirdauthor{#1}} % \end{macrocode} % -% The next set of macros is used to typeset the ``date'' of the thesis defense or presentation -% or whatever is done for the final exam. The macro is sort of complicated because the input -% format for this ``date'' may vary from a single year, to a year range, to a month and year -% specification so that different actions must be taken; if the option \texttt{classica} is in -% force\footnote{This option cannot be active if this extension package is used to extend a -% document class other than \texttt{toptesi}; nevertheless if the package \texttt{trieste.sty} -% is loaded before this package, the relevant information equivalent to \texttt{classica} -% is fully defined and this package works as it should.} then the formatting of the ``date'' -% may be still different. This command is aliased with |\esamendidottorato| which literally -% means ``defense of the doctoral dissertation''; nevertheless both commands refer to a simple -% date in one of those formats. -% -% |\getseduta| splits the date in its two components, month and year; -% if the argument is a single string without intervening spaces, the first one is the string -% itself and the second is empty; this emptiness may be tested and in case the date formatting -% is modified accordingly. In particular if the string is a single spaceless one, this string -% is assigned to |\@submitdate|; otherwise a different treatment is made according to the fact -% that \texttt{classica} is in force; if \texttt{classica} is not in force the total string, -% including spaces is assigned to |\@submitade|. If \texttt{classica} is in force, -% |\s@dutaTrieste| is called with the whole string. On turn |\s@dutaTrieste| verifies -% if the date should be typeset with old style numbers or in the usual way; in the latter case -% the whole string is assigned to |\@submitdate|; in the former one the year part may be a -% single year or a year range; this separation is tested by splitting the year part across -% one dash; if the dash is present the extremes of the year range are assigned to |\1| and -% |\2|, otherwise the year part is a single year. If a single year is given this is simply -% typeset with old style numbers and the appropriate commands are assigned to the -% |\@submitdate| control sequence. If a year range is given, this year range is also typeset -% with old style numbers, and the dash is executed with a regular en-dash surrounded with -% white space. +% The next set of macros is used to typeset the ``date'' of the thesis defense or +% presentation or whatever is done for the final exam. The macro is sort of complicated +% because the input format for this ``date'' may vary from a single year, to a year range, +% to a month and year specification so that different actions must be taken; if the option +% \texttt{classica} is in force\footnote{This option cannot be active if this extension +% package is used to extend a document class other than \texttt{toptesi}.} +% then the formatting of the ``date'' may be still different. This command is aliased with +% |\esamendidottorato| which literally means ``defense of the doctoral dissertation''; +% nevertheless both commands refer to a simple date in one of those formats. +% +% |\getseduta| splits the date into its two components, month and year; if the argument +% is a single string without intervening spaces, the first one is the string +% itself and the second is empty; this emptiness may be tested and in case the date +% formatting is modified accordingly. In particular if the string is a single spaceless +% one, this string is assigned to |\@submitdate|; otherwise a different treatment is made +% according to the fact that \texttt{classica} is in force; if \texttt{classica} is not +% in force the total string, including spaces, is assigned to |\@submitade|. If +% \texttt{classica} is in force, |\s@dutaTrieste| is called with the whole string. On turn +% |\s@dutaTrieste| verifies if the date should be typeset with old style numbers or in the +% usual way; in the latter case the whole string is assigned to |\@submitdate|; in the +% former one the year part may be either a single year or a year range; this separation is +% tested by splitting the year part across one dash; if the dash is present the extremes +% of the year range are assigned to |\1| and |\2|, otherwise the year part is a single +% year. If a single year is given this is simply typeset with old style numbers and the +% appropriate commands are assigned to the |\@submitdate| control sequence. If a year +% range is given, this year range is also typeset with old style numbers, and the dash +% is executed with a regular en-dash surrounded with white space. % % \begin{macrocode} \def\sedutadilaurea#1{\getseduta#1 !} @@ -1920,33 +1929,57 @@ Skipping any redefinition\MessageBreak}% % % |\scuoladidottorato| gets the name of the PhD School; |\ateneo| gets the the generic name % of the university; |\nomeateneo| gets the proper name of the university. In Italy -% Universities are generally named after the city they are in; in large cities where there are -% several universities, each one of them has a proper name. For example the generic name might -% be ``Universit\`a di Roma'' and the proper name might be ``La Sapienza''. |\facolta| -% receives an optional argument that is the uppercase roman numeral specific of the faculty -% and a compulsory argument that corresponds to the type of faculty; for example, with -% |\facolta[II]{Ingegneria}| the package typesets in the title page ``II Facolt\`a di -% Ingengeria''; if the optional argument is not specified, no roman numeral is typeset; the -% infix string \verb*+Facolt\`a di + may be changed with the configuration file depending -% on the default language. +% Universities are generally named after the city they are in; in large cities where there +% are several universities, each one of them has a proper name. For example the generic +% name might be ``Universit\`a di Roma'' and the proper name might be ``La Sapienza''. +% |\facolta| may receive an optional argument that is the uppercase roman numeral specific +% of the faculty and a compulsory argument that corresponds to the type of faculty; for +% example, with |\facolta[II]{Ingegneria}| the package typesets in the title page ``II +% Facolt\`a di Ingengeria''; if the optional argument is not specified, no roman numeral +% is typeset; the infix string \verb*+Facolt\`a di + may be changed with the configuration +% file depending on the default language. It might be necessary to define another name +% in place of ``Facolt\`a di~'', since with recent bills, the administrative structure of +% all Italian universities has been changed and the activities formally assigned to the +% Faculties may be now the responsibility of other structures that may have different +% names in different universities. +% % Finally |\logosede| gets the name of the graphic file that contains the information -% relative to the university logo. If such logo is not available, the user does not specify -% this command; if the user uses this command to insert the university logo but the file -% is not available the usual \texttt{graphicx} package warning is issued but compilation -% goes on without the logo. +% relative to the university logo; it may receive also a list of logo file names, as it +% might be necessary when a thesis is developed in a multiple university environment. If +% such logo file is not available, the user does not specify +% this command; if the user uses this command to insert one or more university logo files +% but some file is not available, the usual \texttt{graphicx} package warning is issued +% but compilation goes on without the missing logo. +% The treatment of one or more logo files, it is necessary to have available some extra +% commands and control sequences citable to store temporary data or to specify style +% parameters: one is the name of a save box; another is the default spacing between the +% logos in the typeset page; the third is the height of the logos. The default spacing +% may be set with the help of the macro |\setlogodistance| -- notice that the default +% value is |3em|, and if a different distance is desired, it should not be much larger +% or mach smaller than the default one; the default logo height is specified as an +% optional command to the |\logosede| command; the save box name is just for internal +% workings and does not require any customization. The analysis and processing to the +% possible list of logo file names id=s done through the usual means of the delimited +% argument extraction of the single names from the list; the ``string'' of logic is then +% composed in a save box; as the list has been completely processed, the box is measured; +% if its width is shorter than the |\textwidth| it is typeset without further processing; +% if it's larger, on the opposite, the box gets scaled down so that its width equals the +% |\textwidth|. +% % The |\tutoreaziendale| macro is the last title page addition; several students, who work % on their thesis or final project in a company, want to have the company supervisor name % printed in the title page; this does not preclude expressing the student's deepest thanks % in the acknowledgements section, but it does not harm to name this person also in the % title page. -% Finally the |\retrofrontespizio| command, that by default is empty, allows to typeset +% +% Eventually the |\retrofrontespizio| command, that by default is empty, allows to typeset % a copyright page; the argument of this command is in total responsibility of the user % who must write it in the thesis main language; the user can specify from zero to % several paragraphs, separated by the vertical spaces s/he thinks best; the argument -% by default is typeset at the bottom f the text block of the copyright page. The user -% can specify any permeant space at the bottom of his/her argument, so as to set the +% by default is typeset at the bottom of the text block of the copyright page. The user +% can specify any pertinent space at the bottom of his/her argument, so as to set the % text in the position s/he likes best. -% In order to handle there copyright page in the preparer way we need to test of its +% In order to handle the copyright page in the proper way we need to test if its % definition is empty or blank so we require the package |etoolbox| in order to use its % advanced macros. % \begin{macrocode} @@ -1959,7 +1992,29 @@ Skipping any redefinition\MessageBreak}% \def\ateneo#1{\gdef\@ateneo{\expandafter\uppercase{\expandafter #1}}} \def\nomeateneo#1{\gdef\@nomeat{\expandafter\uppercase{\expandafter #1}}} \newcommand\facolta[2][]{\gdef\@facname{#2}\gdef\@facnumber{#1}} -\def\logosede#1{\edef\@logosede{\noexpand\includegraphics[width=3cm]{#1}}} + +\newlength{\TPT@logospace}\TPT@logospace=3em\relax +\newsavebox{\TPT@logobox} +\newdimen\TPT@logoheight +\newcommand*\setlogodistance[1]{\TPT@logospace=#1} +\providecommand*{\@logosede}{} + +\newcommand\logosede[2][3cm]{\def\@logosede{#2}\TPT@logoheight=#1} + +\newcommand\printloghi{\ifdefvoid{\@logosede}{}{% +\begin{lrbox}{\TPT@logobox}\hskip\TPT@logospace + \expandafter\@printloghi\@logosede,!}} + +\def\@printloghi#1,#2!{% +\ifblank{#1}{\hskip\TPT@logospace\end{lrbox}\vspace*{\bigskipamount}% +\leavevmode +\ifdim\wd\TPT@logobox<\textwidth \box\TPT@logobox +\else\resizebox{\textwidth}{!}{\box\TPT@logobox}% +\fi}{\def\@logosede{#2}% +\includegraphics[height=\TPT@logoheight]{#1}\hskip\TPT@logospace + \expandafter\@printloghi\@logosede,!}} + + \def\tutoreaziendale#1{\gdef\@tutoreaziendale{#1}} \newcommand\retrofrontespizio[1]{\long\gdef\@retrofrontespizio{#1}} \RequirePackage{etoolbox} @@ -2080,16 +2135,15 @@ Skipping any redefinition\MessageBreak}% \@ifundefined{TerzoTomo}{\def\TerzoTomo{Tomo terzo}}{} \@ifundefined{QuartoTomo}{\def\QuartoTomo{Tomo quarto}}{} % \end{macrocode} -% If the final exam date is not given the default value is the current month and the current -% year typeset in Italian; therefore the user is strongly requested to enter a date either -% with the |\sedutadilaurea| or the |\esamedidottorato| commands. The university logo command -% by default is also empty. +% If the final exam date is not given the default value is the current month and the +% current year typeset in Italian; therefore the user is strongly requested to enter +% a date either with the |\sedutadilaurea| or the |\esamedidottorato| commands. The +% university logo command has already been defined empty as its default value. % \begin{macrocode} \@ifundefined{@submitdate}{\def\@submitdate{\ifcase\the\month\or% Gennaio\or Febbraio\or Marzo\or Aprile\or Maggio\or Giugno\or Luglio\or Agosto\or Settembre\or Ottobre\or Novembre\or Dicembre\fi \space \the\year}}{} -\@ifundefined{@logosede}{\let\@logosede\relax}{} % \@ifundefined{@TesiDiLaurea}{\def\@TesiDiLaurea{Tesi di Laurea}}{} \@ifundefined{@phdschool}{\def\@phdschool{SCUOLA DI DOTTORATO}}{} @@ -2116,7 +2170,7 @@ Skipping any redefinition\MessageBreak}% \hbox to \hsize{\hfill {\LARGE \@ateneo}\hfill}% \ifclassica \hbox to \hsize{\hfil\vrule\@width\z@ - \@height3.5ex\vrule\@height1.4\p@\@depth-\p@\@width50mm\hfil}% + \@height2ex\vrule\@height1.4\p@\@depth-\p@\@width50mm\hfil}% \fi }}% \def\@oddfoot{\vbox to 15mm{\vss @@ -2152,7 +2206,7 @@ Skipping any redefinition\MessageBreak}% % we set in the page is the university proper name and some vertical glue. % \begin{macrocode} \ifx\@nomeat\empty \else - {\vspace*{-2.5\topskip}\centering + {\vspace*{-1.5\baselineskip}\centering {\Large \@nomeat}\par}\vfill \fi % \end{macrocode} @@ -2245,22 +2299,22 @@ Skipping any redefinition\MessageBreak}% \fi \par % \end{macrocode} -% Going down in the title page now comes the optional insertion of the university logo; this -% is a simple task once |\@logosede| has been defined, and this was done either with an -% explicit command |\logosede| with its argument in the preamble, or a specific line in the -% configuration file. +% Going down in the title page now comes the optional insertion of the university logo(s); +% this is a simple task once |\@logosede| has been defined, and this was done either with +% an explicit command |\logosede| with its argument in the preamble, or a specific line +% in the configuration file. If the internal |\@logosede| list is empty, the already +% defined |\printloghi| macro does not do anything. % \begin{macrocode} - \ifx\@logosede\@empty\else - \vspace*{\bigskipamount} - {\centering \@logosede\par}\fi + {\centering \printloghi\par} % \end{macrocode} % -% the final task is to typeset the possible supervisors' names, the candidates' names and all -% the rest of the bureaucratical terms. We have to distinguish between a bachelor degree -% report that is not supposed to have a supervisor, from the doctoral dissertation where we do -% not indicate the supervisor, but the School Director, and the master thesis where there -% might be one or more supervisors; with the \texttt{classica} option in force no label is -% printed over the supervisor's name, unless there is a plurality of supervisors. +% The final task is to typeset the possible supervisors' names, the candidates' names +% and all the rest of the bureaucratical terms. We have to distinguish between a bachelor +% degree report that is not supposed to have a supervisor, from the doctoral dissertation +% where we do not indicate the supervisor, but the School Director, and the master thesis +% where there might be one or more supervisors; with the \texttt{classica} option in force +% no label is printed over the supervisor's name, unless there is a plurality of +% supervisors. % \begin{macrocode} \vfill \iflaureatriennale @@ -2493,7 +2547,7 @@ Skipping any redefinition\MessageBreak}% % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} % lavora solo con LaTeX 2e \ProvidesPackage{topcoman}% - [2012/11/09 v.5.61d Additional commands for the TOPtesi bundle] + [2012/12/26 v.5.62 Additional commands for the TOPtesi bundle] % \end{macrocode} % The new command |\DeclareSlantedCapitalGreekLetters| optionally sets the capital % Greek letters in math mode with the glyphs taken from the math italic fonts, not from diff --git a/Master/texmf-dist/tex/latex/toptesi/topcoman.sty b/Master/texmf-dist/tex/latex/toptesi/topcoman.sty index fdfcedf0646..4554298fa04 100644 --- a/Master/texmf-dist/tex/latex/toptesi/topcoman.sty +++ b/Master/texmf-dist/tex/latex/toptesi/topcoman.sty @@ -29,7 +29,7 @@ %% Right brace \} Tilde \~} \NeedsTeXFormat{LaTeX2e} % lavora solo con LaTeX 2e \ProvidesPackage{topcoman}% - [2012/11/09 v.5.61d Additional commands for the TOPtesi bundle] + [2012/12/26 v.5.62 Additional commands for the TOPtesi bundle] \RequirePackage{ifxetex} \ifxetex\else \newcommand*\DeclareSlantedCapitalGreekLetters{% diff --git a/Master/texmf-dist/tex/latex/toptesi/topfront.sty b/Master/texmf-dist/tex/latex/toptesi/topfront.sty index cfc6dca8350..006a3fc8fb6 100644 --- a/Master/texmf-dist/tex/latex/toptesi/topfront.sty +++ b/Master/texmf-dist/tex/latex/toptesi/topfront.sty @@ -28,7 +28,7 @@ %% Grave accent \` Left brace \{ Vertical bar \| %% Right brace \} Tilde \~} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{topfront}[2012/11/09 v.5.61d Title page for TOPtesi] +\ProvidesPackage{topfront}[2012/12/26 v.5.62 Title page for TOPtesi] \newif\iffemminile \newif\ifdottorato \dottoratofalse \newif\iflaureatriennale \laureatriennalefalse @@ -99,7 +99,28 @@ \def\ateneo#1{\gdef\@ateneo{\expandafter\uppercase{\expandafter #1}}} \def\nomeateneo#1{\gdef\@nomeat{\expandafter\uppercase{\expandafter #1}}} \newcommand\facolta[2][]{\gdef\@facname{#2}\gdef\@facnumber{#1}} -\def\logosede#1{\edef\@logosede{\noexpand\includegraphics[width=3cm]{#1}}} + +\newlength{\TPT@logospace}\TPT@logospace=3em\relax +\newsavebox{\TPT@logobox} +\newdimen\TPT@logoheight +\newcommand*\setlogodistance[1]{\TPT@logospace=#1} +\providecommand*{\@logosede}{} + +\newcommand\logosede[2][3cm]{\def\@logosede{#2}\TPT@logoheight=#1} + +\newcommand\printloghi{\ifdefvoid{\@logosede}{}{% +\begin{lrbox}{\TPT@logobox}\hskip\TPT@logospace + \expandafter\@printloghi\@logosede,!}} + +\def\@printloghi#1,#2!{% +\ifblank{#1}{\hskip\TPT@logospace\end{lrbox}\vspace*{\bigskipamount}% +\leavevmode +\ifdim\wd\TPT@logobox<\textwidth \box\TPT@logobox +\else\resizebox{\textwidth}{!}{\box\TPT@logobox}% +\fi}{\def\@logosede{#2}% +\includegraphics[height=\TPT@logoheight]{#1}\hskip\TPT@logospace + \expandafter\@printloghi\@logosede,!}} + \def\tutoreaziendale#1{\gdef\@tutoreaziendale{#1}} \newcommand\retrofrontespizio[1]{\long\gdef\@retrofrontespizio{#1}} \RequirePackage{etoolbox} @@ -165,7 +186,6 @@ Gennaio\or Febbraio\or Marzo\or Aprile\or Maggio\or Giugno\or Luglio\or Agosto\or Settembre\or Ottobre\or Novembre\or Dicembre\fi \space \the\year}}{} -\@ifundefined{@logosede}{\let\@logosede\relax}{} \@ifundefined{@TesiDiLaurea}{\def\@TesiDiLaurea{Tesi di Laurea}}{} \@ifundefined{@phdschool}{\def\@phdschool{SCUOLA DI DOTTORATO}}{} \@ifundefined{@PhDname}{\def\@PhDname{Dottorato in }}{} @@ -180,7 +200,7 @@ \hbox to \hsize{\hfill {\LARGE \@ateneo}\hfill}% \ifclassica \hbox to \hsize{\hfil\vrule\@width\z@ - \@height3.5ex\vrule\@height1.4\p@\@depth-\p@\@width50mm\hfil}% + \@height2ex\vrule\@height1.4\p@\@depth-\p@\@width50mm\hfil}% \fi }}% \def\@oddfoot{\vbox to 15mm{\vss @@ -200,7 +220,7 @@ \null\setcounter{page}{1}% \normalfont \ifx\@nomeat\empty \else - {\vspace*{-2.5\topskip}\centering + {\vspace*{-1.5\baselineskip}\centering {\Large \@nomeat}\par}\vfill \fi \begin{center} @@ -266,9 +286,7 @@ \fi \fi \par - \ifx\@logosede\@empty\else - \vspace*{\bigskipamount} - {\centering \@logosede\par}\fi + {\centering \printloghi\par} \vfill \iflaureatriennale \let\@nomerelatore\empty diff --git a/Master/texmf-dist/tex/latex/toptesi/toptesi.cls b/Master/texmf-dist/tex/latex/toptesi/toptesi.cls index f5899288c96..e5b4cdee6b3 100644 --- a/Master/texmf-dist/tex/latex/toptesi/toptesi.cls +++ b/Master/texmf-dist/tex/latex/toptesi/toptesi.cls @@ -29,7 +29,7 @@ %% Right brace \} Tilde \~} \NeedsTeXFormat{LaTeX2e} \ProvidesClass{toptesi}% -[2012/11/09 v.5.61d Class for typesetting university theses] +[2012/12/26 v.5.62 Class for typesetting university theses] \DeclareOption*{\PassOptionsToClass{\CurrentOption}{report}} \ProcessOptions\relax \LoadClass[a4paper]{report} diff --git a/Master/texmf-dist/tex/latex/toptesi/toptesi.sty b/Master/texmf-dist/tex/latex/toptesi/toptesi.sty index d945375f85c..69f63edf66f 100644 --- a/Master/texmf-dist/tex/latex/toptesi/toptesi.sty +++ b/Master/texmf-dist/tex/latex/toptesi/toptesi.sty @@ -29,7 +29,7 @@ %% Right brace \} Tilde \~} \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{toptesi}% -[2012/11/09 v.5.61d Extension for toptesi.cls]% +[2012/12/26 v.5.62 Extension for toptesi.cls]% \def\TRON{\tracingcommands \tw@ \tracingmacros \tw@} \def\TROFF{\tracingcommands\z@ \tracingmacros \z@} \let\TROF\TROFF -- cgit v1.2.3