diff options
16 files changed, 459 insertions, 909 deletions
diff --git a/Master/texmf-dist/doc/latex/toptesi/README b/Master/texmf-dist/doc/latex/toptesi/README index c1bf5b30041..faecd4fdeb7 100644 --- a/Master/texmf-dist/doc/latex/toptesi/README +++ b/Master/texmf-dist/doc/latex/toptesi/README @@ -4,7 +4,8 @@ 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. +front page to the requirements of a specific university and a specific +language. Thanks to its language management, the bundle is suited for multilanguage theses that are becoming more and more frequent thanks @@ -29,12 +30,14 @@ to /texmf/source/latex/toptesi. Run pdflatex on toptesi.dtx in order to get the class, style and configuration files (and the pdf documentation in English) and move -the .cls, sty, and .cfg files to /texmf/tex/latex/toptesi +the .cls, .sty, .xmpdata, and .cfg files to /texmf/tex/latex/toptesi If the cited folders do not exist, create them. -If you are runing a Windows platform change the slashes into backslashes +The texmf folder is your personal texmf folder. If the package is already installed the texmf folder should be the /texmf-ditr system one. + +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 your texmf tree. +that is present in the texmf tree. -In any case remeber to refresh the filename database!
\ No newline at end of file +In any case remember to refresh the filename database!
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/toptesi/README.TEXLIVE b/Master/texmf-dist/doc/latex/toptesi/README.TEXLIVE deleted file mode 100644 index 40417dbbce5..00000000000 --- a/Master/texmf-dist/doc/latex/toptesi/README.TEXLIVE +++ /dev/null @@ -1,46 +0,0 @@ -The following files have been removed in the TeX Live installation of -the current package, typically due to duplication, lack of space, or -missing source code. You can find these files on CTAN at - http://mirror.ctan.org/macros/latex/contrib/toptesi -If questions or concerns, email tex-live@tug.org. - - logounige.pdf - logouniur.pdf - logouniroma3.eps - logouniroma2.pdf - logounipi.eps - logouniroma3.pdf - logouniroma1.pdf - logoINPG.eps - logounits.eps - logounibo.eps - logounibg.pdf - logouniba.eps - logounipa.eps - logouniur.eps - logouniroma1.eps - logounibs.eps - logouniroma2.eps - logounisa.eps - logopoliba.pdf - logopolito.eps - logounisa.pdf - logopoliba.eps - logounipd.pdf - logouniba.pdf - logounipd.eps - logounito.eps - logounige.eps - logounipa.pdf - logounipi.pdf - logounibo.pdf - logounipmn.eps - logoINPG.pdf - logounibg.eps - logopolito.pdf - logounipmn.pdf - logounibs.pdf - logounits.pdf - logoEPFL.pdf - logounito.pdf - logoEPFL.eps diff --git a/Master/texmf-dist/doc/latex/toptesi/manifest.txt b/Master/texmf-dist/doc/latex/toptesi/manifest.txt index 69bd579cb12..cee037841e0 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.05) +manifest.txt (version 5.50) Copyright 2008-2011 Claudio Beccari This work may be distributed and/or modified under the conditions of @@ -18,9 +18,11 @@ This work consists of the files listed in manifest.txt This work consists of the following files manifest.txt toptesi.dtx - toptesi.ins toptesi-doc.tex + toptesi-example README + toptesi-exmple.xmpdata + toptesi-doc.xmpdata The files derived from the work are the following: @@ -29,9 +31,9 @@ The files derived from the work are the following: topcoman.sty topfront.sty toptesi.cfg - topsiz14.clo toptesi.pdf toptesi-doc.pdf + toptesi-example.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. @@ -41,30 +43,15 @@ toptesi-doc.tex The two documentations pdf files are complementary to one another. -The logos of the Institutes of Technology of Turin (Politecnico -di Torino), Bari, Lausanne and Grenoble, of the Universities of Trieste, -Torino, Bologna, Bari, Bergamo, Brescia, Genova, Palermo, Padova, -Pisa, Piemonte Orientale, Roma-1, Roma-2, Roma-3, Salerno, and -Urbino belong to the corresponding universities and are generally -of free usage. They are distributed for the convenience of the -users of this work; other logos may be downloadable from the sites -of other universities. - -In any case, before using any logo, the user must inquire at the -relevant University in order to find out if there are -any prominent or subtle limitations in the legal use of their logo. The -fraudulent or improper use of these logos is in the complete -responsibility of the user. - The file toptesi-example.tex is an example of the usage of this work; it may be used as a template, -but in itself it is not part of this Work +but in itself, although part of this Work, may be used but the end user the way s/he likes best, in order to use it as a template, but the file should not be modified unless its name is changed. -The file toptesi-example.xmpdata -is an example of the contents and format of the metadata that must be +The files toptesi-example.xmpdata and toptesi-doc.xmldata +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 for typesetting a file that hopefully is PDF/A-1b -compliant, that is in the "weak" archivable PDF format. +compliant (PDF/A-1b is the "weak" archivable PDF format). diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.pdf Binary files differindex 6cf12622491..7897bf21297 100644 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.pdf +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.pdf diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.tex b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.tex index 4dafd98d299..ab841117a5b 100644 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.tex +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.tex @@ -1,6 +1,6 @@ % % toptesi-doc.tex -%% Copyright 2005-2010 Claudio Beccari +%% Copyright 2005-2011 Claudio Beccari % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either version 1.3 @@ -35,7 +35,7 @@ \usepackage{color} \usepackage{microtype}% %%%% inserire il valore corretto della versione di toptesi -\def\fileversion{5.04} +\def\fileversion{5.50} \NomeMonografia{Manuale d'uso} \monografia{La classe \textsf{TOPtesi}} \sottotitolo{Per comporre le tesi al Poli \\e in molte altre università} @@ -62,9 +62,10 @@ \frontespizio \sommario - Questo testo serve per descrivere come comporre tipograficamente la - tesi di laurea o la monografia o la dissertazione di dottorato - mediante il noto programma di composizione \LaTeX, o meglio, mediante la sua variante pdf\LaTeX; sono previste di default le necessarie azioni per produrre il file finale in formato PDF archiviabile secondo la norma ISO 19005-1. +Questo testo serve per descrivere come comporre tipograficamente la +tesi di laurea o la monografia o la dissertazione di dottorato +mediante il noto programma di composizione \LaTeX, o meglio, mediante la sua variante +pdf\/\LaTeX; sono previste di default le necessarie azioni per produrre il file finale in formato PDF archiviabile secondo la norma ISO 19005-1. L'appendice~A contiene il testo della \LaTeX\ Project Public Licence, versione 1.3, alla quale questo lavoro è soggetto. @@ -106,7 +107,7 @@ sovrastruttura di un altro programma, \TeX, che continua ad esserne il motore. La prima versione di \TeX\ è stata creata nel 1978, ma è ancora usata oggi, naturalmente molto aggiornata, e questo fatto è una cosa insolita nel panorama turbolento di novità -dell'informatica. +dell'informatica. Oggi,poi, anche \TeX\ è caduto in disuso perché soppiantato dal suo ``figlio'' \textsf{pdftex} che fa le stesse cose, ma la cui funzionalità è enormemente ampliata; tra l'altro, importantissimo, questo programma è capace di produrre il documento finale in formato PDF: Portable Document Format. \TeX\ era e rimane la pietra di paragone per confrontare le funzionalità dei suoi ``figli''; i suoi ``figli'' possono continuare a chiamarsi \TeX\ se riescono anche a fare le stesse cose che faceva il loro genitore. Secondo me, il suo successo è dovuto a due fatti: (a) esso è stato progettato e implementato da un matematico per comporre i suoi @@ -161,13 +162,13 @@ una reliquia preziosa. Ovviamente \LaTeX\ serve per scrivere qualunque cosa; o meglio; serve per comporre tipograficamente qualunque testo. \LaTeX\ non è -un programma di impaginazione, è un programma di composizione +un programma di impaginazione, è un programma di composizione tipografica. Non aspettatevi quindi di poter fare qualunque acrobazia con le righe di testo, come per esempio piegare le righe, deformando i caratteri che vi sono appoggiati sopra, mettendovi attorno aloni di luce cangiante, sfumature, ombreggiature, evidenziandone i contorni, eccetera. Queste cose -sono riservate ai creativi che si occupano di pubblicità. +sono riservate ai creativi che si occupano di pubblicità e usano programmi apposta per realizzare le loro idee innovative nel campo della pubblicità. Aspettatevi invece di comporre testi in cui ogni capoverso è ottimizzato per avere il minor numero di parole divise in sillabe @@ -176,7 +177,7 @@ in fin di riga, e di avere il minor numero possibile di interparola; aspettatevi di comporre formule complicatissime con il minimo di sforzo da parte vostra ma con la certezza che esse saranno composte come nessun altro programma riesce a fare. -Aspettatevi uno stampato estremamente professionale. +Aspettatevi uno stampato estremamente professionale. Sembrerebbe che la Microsoft sia riuscita ad ottenere da Knuth la necessaria consulenza per arricchire il noto programma Word (dall'edizione del 2007, credo) di un \emph{equation editor} che sia all'altezza di \TeX. Sembra che la Microsoft abbia sviluppato apposta un font OpenType, il Cambria, che riuscisse a funzionare sia con il nuovo \emph{equation editor} e la miriade di segni matematico che erano disponibili con \TeX, ma non ancora con i precedenti \emph{equation editor} che affiancavano Word nelle edizioni precedenti. Questo la dice lunga sulla influenza che \TeX\ ha avuto e sta ancora avendo sul mondo dell'elaborazione dei testi e nella tipocomposizione. Per questo motivo voi studenti che userete questo pacchetto di macroistruzioni chiamato \textsf{TOPtesi} dovrete astenervi @@ -205,26 +206,26 @@ Attenzione: questa guida presuppone che voi abbiate già uno conoscenza di base d Ricordatevi però che il vostro primo problema sarà quello di superare lo scoglio psicologico di non vedere subito il frutto delle vostre fatiche; abituati come siete ai word processor che seguono il paradigma \emph{What you see is what you get}, che più realisticamente andrebbe scritto \emph{What you see is all you can get} (Quello che vedi e tutto quel che puoi ottenere), dovete passare al paradigma: \emph{What you see is what you mean}, dove l'aspetto grafico di quel che si vede sullo schermo del PC in fase di composizione non è importante, ma è importante quello che avete scritto; il suo aspetto grafico gli verrà dato da \LaTeX\ in un secondo tempo e in una maniera estremamente professionale. Non pretendo di dire che non si possano scrivere tesi ancora più professionali di come si ottengono con \textsf{TOPtesi}, ma certo il risultato è molto migliore di quello che si può ottenere con qualsiasi word processor. -Volete avere una migliore approssimazione sulla finestra di composizione, in modo da restare su una via di mezzo fra le due posizioni di composizione? Usate LyX, oppure usate la componente \texttt{Writer} di OpenOffice; questa componente può essere arricchita con una estensione, scaricabile dal sito di OpenOffice, che si chiama \texttt{Writer2LaTeX}. Mentre sto scrivendo questi appunti la versione stabile non consente di usare \texttt{Writer} come se fosse un editor per \LaTeX; ma è già disponibile una versione sperimentale, che diventerà la versione ufficiale~1.2 di questa estensione) che permette di usare con certe limitazioni il programma \texttt{Writer} come un editor per \LaTeX, per poi disporre di un comodo bottone da cliccare per ottenere la composizione del testo sorgente, ed un altro comodo bottone per la visualizzazione dell'uscita in formato PDF. Gli utenti esperti possono superare le limitazioni inserendo nel testo sorgente adeguate istruzioni in linguaggio \LaTeX, cosicché quello che non può fare \texttt{Writer} come word processor, lo fa poi \LaTeX\ nella sua qualità di text processor. +Volete avere una migliore approssimazione sulla finestra di composizione, in modo da restare su una via di mezzo fra le due posizioni di composizione? Usate LyX, oppure usate la componente \texttt{Writer} di OpenOffice; questa componente può essere arricchita con una estensione, scaricabile dal sito di OpenOffice, che si chiama \texttt{Writer2LaTeX}. Mentre sto scrivendo questi appunti la versione stabile non consente di usare \texttt{Writer} come se fosse un editor per \LaTeX; ma è già disponibile una versione sperimentale (che diventerà la versione ufficiale~1.2 di questa estensione) che permette di usare con certe limitazioni il programma \texttt{Writer} come un editor per \LaTeX, per poi disporre di un comodo bottone da cliccare per ottenere la composizione del testo sorgente, ed un altro comodo bottone per la visualizzazione dell'uscita in formato PDF. Gli utenti esperti possono superare le limitazioni inserendo nel testo sorgente adeguate istruzioni in linguaggio \LaTeX, cosicché quello che non può fare \texttt{Writer} come word processor, lo fa poi \LaTeX\ nella sua qualità di text processor. Personalmente non consiglierei queste vie di mezzo; tuttavia vale la pena sapere che esistono e che possono essere usate, sia pure con qualche limitazione. \section{Installare \LaTeX} Quindi per cominciare a lavorare con \LaTeX\ per prima cosa dovete installarvi il software; ovviamente se vi siete già installati -l'intero sistema \TeX\ ed è già calibrato per comporre +l'intero sistema \TeX\ ed è già calibrato per comporre correttamente, potete saltare questo paragrafo. Ci sono sostanzialmente tre situazioni: \begin{enumerate} -\item se siete degli utenti delle piattaforme Windows allora -collegatevi in rete al sito \texttt{www.miktex.org} e scaricatevi -ed installatevi la distribuzione di \LaTeX, o meglio, del sistema +\item se siete degli utenti delle piattaforme Windows allora poteste +collegarvi in rete al sito \texttt{www.miktex.org} e poteste scaricarvi +ed installarvi la distribuzione di \LaTeX, o meglio, del sistema \TeX\ chiamato MiK\TeX. Scaricatevi l'installazione completa, \emph{non} l'installazione minima o ``basic''. Ovviamente questo scaricamento implica una -connessione di rete sufficientemente veloce. +connessione di rete sufficientemente veloce. Però leggete attentamente il prossimo capoverso. {\tolerance=9999 -Personalmente, anche sulla mia macchina virtuale Windows, io preferisco usare la distribuzione multipiattaforma \TeX~Live; basta scaricare da \texttt{http:/"/www.ctan.org"/tex-archive"/systems"/texlive"/tlnet} il pacchetto \texttt{install-tl.zip}, decomprimere il pacchetto, leggere le istruzioni, e lanciare l'installatore specificando anche il sito da cui eseguire lo scaricamento die file sia per la prima installazione sia per i successivi aggiornamenti. Il sito più conveniente per gli utenti italiani non è il \emph{mirror} ufficiale di Roma2, quello di default, (che funziona ma può risultare lentissimo), ma è il sito \texttt{http:/"/bo.mirror.garr.it"/mirrors"/CTAN"/systems"/texlive"/tlnet}. Tenuto conto che bisogna installare circa 2\,GiB di file, ci vuole una buona mezzz'oretta per installare il tutto con un collegamento ADSL sufficientemente veloce, ma poi Il sistema è pronto per funzionare senza ulteriori configurazioni. Il bello di questa distribuzione è che i suoi moltissimi pacchetti vengono aggiornati piuttosto spesso e io personalmente il il \TeX\ Live Manager almeno una volta alla settimana per essere sempre aggiornato alle ultime versioni di qualunque pacchetto; uso la stessa distribuzione e lo stesso manager anche su una mia macchina Macintosh e su un'altra macchina Linux.\par} +Personalmente, anche sulla mia macchina virtuale Windows, io preferisco usare la distribuzione multipiattaforma \TeX~Live; basta scaricare da \texttt{http:/"/www.ctan.org"/tex-archive"/systems"/texlive"/tlnet} il pacchetto \texttt{install-tl.zip}, decomprimere il pacchetto, leggere le istruzioni, e lanciare l'installatore specificando anche il sito da cui eseguire lo scaricamento dei file sia per la prima installazione sia per i successivi aggiornamenti. Il sito più conveniente per gli utenti italiani non è il \emph{mirror} ufficiale di Roma2, quello di default, (che è funzionante, ma può risultare lentissimo), ma è il sito \texttt{http:/"/bo.mirror.garr.it"/mirrors"/CTAN"/systems"/texlive"/tlnet}. Tenuto conto che bisogna installare circa 2\,GiB di file, ci vuole una buona mezzz'oretta per installare il tutto con un collegamento ADSL sufficientemente veloce, ma poi il sistema è pronto per funzionare senza ulteriori configurazioni. Il bello di questa distribuzione è che i suoi moltissimi pacchetti vengono aggiornati piuttosto spesso e io personalmente uso il \TeX\ Live Manager almeno una volta alla settimana per essere sempre aggiornato alle ultime versioni di qualunque pacchetto; uso la stessa distribuzione e lo stesso manager anche su una mia macchina Macintosh e su un'altra macchina Linux.\par} \item Siete degli utenti di Linux; in questo caso siete particolarmente fortunati perché il sistema \TeX\ fa parte integrante di @@ -232,9 +233,9 @@ qualunque distribuzione, anche se non viene installato di default; vi basta inserire il disco di installazione o vi basta connettervi in rete e invocare uno dei vari programmi come \texttt{apt-get}, \texttt{rpm} o \texttt{yast} per scaricare tutto quanto vi serve e -per configurare l'installazione. Ricordatevi che Linux un po' +per configurare l'installazione. Ricordatevi che Linux è un po' più ``ruspante'' di Windows, e quindi la configurazione richiede -un po' più di attenzione e di smanettamento con la riga di +un po' più di attenzione e di ``smanettamento'' con la riga di comando; ma a questo, in qualità di ``pinguini doc'', ci siete abituati; in compenso avete il beneficio di avere tutto quanto il software già predisposto fin dalla nascita per macchine UNIX e @@ -257,12 +258,12 @@ scaricato sul disco che avrete indicato, ma quel che è più comodo, esso è già pronto per funzionare senza bisogno di ulteriori configurazioni. Il sistema \texttt{Mac\TeX} produce il suo output solo in formato PDF; se ne tenga conto leggendo attentamente la documentazione, perché la cosa può essere critica con -l'inserimento delle immagini. Il pacchetto è già dotato dello -shell editor \TeX{}shop e fa ricorso ad un suo previewer interno per +l'inserimento delle immagini. Il pacchetto è già dotato dello +shell editor \TeX{}Shop e fa ricorso ad un suo previewer interno per il formato PDF. Attenzione: questo previewer interno consente di eseguire -l'\textit{inverse search} mentre l'editor \TeX{}shop consente di +l'\textit{inverse search} mentre l'editor \TeX{}Shop consente di fare la \textit{forward search}. Questo è molto comodo durante la fase di editing del vostro documento. \end{enumerate} @@ -286,7 +287,7 @@ testi ASCII che sia anche un po' d'aiuto per comporre con \LaTeX. Il programma gratuito che, a detta degli appassionati, serve per fare tutto sarebbe \texttt{emacs}, disponibile per tutte e tre le piattaforme anche se è nativo di UNIX. Sarà anche vero che è -quasi onnipotente, ma per me è difficile da usare; diciamo che ha +quasi onnipotente, ma per me è difficile da usare; diciamo che ha una curva di apprendimento piuttosto ripida e per la mia età le salite ripide non sono indicate. @@ -326,7 +327,7 @@ Io ho cominciato a lavorare con \LaTeX\ a metà degli anni '80 e non ho mai usato Disponendo di una piattaforma Linux ho verificato il funzionamento sia di LyX sia di TeXmacs, ma alla fine sono tornato a usare i -miei semplici editor ASCII con i quali non ho nessuna limitazione +miei semplici editor ASCII con i quali non ho limitazioni di nessun genere per quel che riguarda la composizione dei miei testi. Bisogna dire che io faccio un grande uso di macroistruzioni adatte al mio modo di comporre; in generale le macroistruzioni non @@ -347,16 +348,16 @@ anche sull'altro significato della parola inglese ``top''. Tuttavia il pacchetto non è stato creato solo per il Politecnico di Torino; le informazioni relative a questo ateneo sono di -default, così come la facoltà di ingegneria è la facoltà di +default, così come la facoltà di ingegneria è la facoltà di default. Ma i comandi predisposti consentono di personalizzare il pacchetto per ogni ateneo e ogni facoltà e, oserei dire, in ogni lingua. -Tenete conto che \textsf{TOPtesi} è già stato usato anche per +Tenete conto che \textsf{TOPtesi} è già stato usato anche per scrivere tesi in filologia classica greca e in filologia copta; -\textsf{TOPtesi} non è limitato solo a scritti delle discipline +\textsf{TOPtesi} non è limitato solo a scritti delle discipline cosiddette esatte, quelle che fanno un grande uso del linguaggio -matematico, ma altrettanto utile per scrivere testi in +matematico, ma è altrettanto utile per scrivere testi in discipline umanistiche, perché \LaTeX\ e pdf\LaTeX\ sono altrettanto precisi nel comporre la matematica di quanto lo siano nel comporre una poesia o un romanzo. @@ -365,7 +366,7 @@ nel comporre una poesia o un romanzo. \section{Dove sono i file di \textsf{TOPtesi}?} La distribuzione di \textsf{TOPtesi} contiene molti file; ma ogni distribuzione moderna del sistema \TeX\ li carica tutti senza che dobbiate intervenire a mano. Tuttavia è importante che voi sappiate dove trovare questi file. -L'installazione del sistema \TeX\ prevede che i suoi numerosissimi file siano installati in un certo numero di strutture di cartelle, chiamate ``alberi''; ogni albero ha una radice; normalmente la radice della distribuzione si chiama \texttt{texmf-distr}, ma sulla vostra macchina e con il vostro sistema operativo potrebbe avere un altro nome. Esiste anche un albero radicato nella vostra ``home''; nei sistemi di stampo UNIX essa si indica simbolicamente con la tilde e la radice del vostro albero personale potrebbe chiamarsi \texttt{\~{}/texmf}; sulle macchine Windows invece dovete cercare in \texttt{C:\char92Documents and settings} Seguito dal vostro user nome oppure da \texttt{All users}; magari ci sono ancora altri rami di albero da percorrere, ma poi si trova \texttt{texmf} o \texttt{localtexmf}. Nei sistemi Mac la radice del vostro albero personale è sotto la vostra \texttt{Library}. +L'installazione del sistema \TeX\ prevede che i suoi numerosissimi file siano installati in un certo numero di strutture di cartelle, chiamate ``alberi''; ogni albero ha una radice; normalmente la radice della distribuzione si chiama \texttt{texmf-distr}, ma sulla vostra macchina e con il vostro sistema operativo potrebbe avere un altro nome. Esiste anche un albero radicato nella vostra ``home''; nei sistemi di tipo UNIX essa si indica simbolicamente con la tilde e la radice del vostro albero personale potrebbe chiamarsi \texttt{\textasciitilde/texmf}; sulle macchine Windows invece dovete cercare in \texttt{C:\char92Documents and settings} seguito dal vostro user nome oppure da \texttt{All users}; magari ci sono ancora altri rami di albero da percorrere, ma poi si trova \texttt{texmf} o \texttt{localtexmf}. Nei sistemi Mac la radice del vostro albero personale è radicata nella vostra cartella \texttt{\textasciitilde/Library}. Tutti i file del pacchetto \textsf{TOPtesi} vengono caricati nell'albero della distribuzione; i file della documentazione lungo il ramo \texttt{doc}; i file sorgente, lungo il ramo \texttt{source}; i file ``eseguibili'' in una cartella lungo il ramo \texttt{tex}; fra questi file ``eseguibili''\footnote{Chiamare ``eseguibili'' i file che vengono usati da \LaTeX\ è molto improprio: si tratta di file necessari durante l'esecuzione del programma, ma non sono quei file ad essere eseguibili nel senso informatico del termine.} c'è anche il file \texttt{toptesi.cfg}. Copiate questo file nella vostra cartella di lavoro come spiegato qui di seguito e modificatelo secondo le vostre necessità. @@ -383,8 +384,8 @@ Tuttavia non è necessario servirsi del file \texttt{toptesi.cfg} né di modificare il file con la configurazione di default, perché ogni comando che contenga esplicitamente materiale per il frontespizio ridefinisce quanto è definito di default e quindi -nulla è cristallizzato, fisso e immutabile. Tuttavia il file -di configurazione semplifica molto la vita e se ne consiglia +nulla è cristallizzato, fisso e immutabile. Tuttavia il file +di configurazione semplifica molto la vita e ne consiglio l'uso. Potete perciò usare un diverso file di configurazione, sempre @@ -408,17 +409,17 @@ cartella metterete i file necessari per comporre la vostra dissertazione. \section{Il formato PDF/A} -Il Politecnico di Torino, come anche molte università italiane e straniere, sta cercando di ``smaterializzare'' le copie di archivio delle tesi di laurea. Sono al corrente che oggi (fine 2008) è allo studio un processo per consegnare la copia di archivio della tesi tramite il Portale della Didattica, in modo da eliminare le copie cartacee. +Il Politecnico di Torino, come anche molte università italiane e straniere, sta cercando di ``smaterializzare'' le copie di archivio delle tesi di laurea. Sono al corrente che dal 2008 è allo studio un processo per consegnare la copia di archivio della tesi tramite il Portale della Didattica, in modo da eliminare le copie cartacee. Il problema dell'archiviazione elettronica è che il materiale archiviato deve essere reperibile, leggibile e stampabile anche di qui a, diciamo, cinquanta anni. Per questo è necessario che esso sia archiviato in un formato standard e che nel futuro continuino ad esistere i programmi per la visualizzazione e la stampa di questo formato. -L'Interntional Standards Organization ha pubblicato nel 2005 uno standard per l'archiviazione dei file con la norma ISO 19005-1:2005. Secondo questa norma i file archiviabili devono avere il formato PDF della versione 1.4 e devono soddisfare ad altri requisiti, oltre a contenere un certo numero di \emph{metadata} specificati dalla norma. Esistono due sotto"formati: il PDF/A-1a e il PDF/A-1b. Il formato PDF/A-1a deve rispondere ai requisiti del formato PDF/A-1b oltre ad altri requisiti specifici, in particolare che i font siano tutti inclusi nel file ed abbiano codifica UNICODE e che il file deve mantenere una struttura logica che possa essere esaminata con i motori di ricerca. Viceversa il formato PDF/A-1b, con meno pretese, richiede che i font siano tutti inclusi nel file, anche se non rispettano la codifica UNICODE, e che il file sia riproducibile a schermo e sia stampabile esattamente nello stesso modo di quando il file è stato archiviato. Il Politecnico richiede il sotto'formato PDF/A-1b. +L'Interntional Standards Organization ha pubblicato nel 2005 uno standard per l'archiviazione dei file con la norma ISO 19005-1:2005. Secondo questa norma i file archiviabili devono avere il formato PDF della versione 1.4 e devono soddisfare ad altri requisiti, oltre a contenere un certo numero di \emph{metadata} specificati dalla norma. Esistono due sotto"formati: il PDF/A-1a e il PDF/A-1b. Il formato PDF/A-1a deve rispondere ai requisiti del formato PDF/A-1b oltre ad altri requisiti specifici, in particolare che i font siano tutti inclusi nel file ed abbiano codifica UNICODE e che il file deve mantenere una struttura logica che possa essere esaminata con i motori di ricerca. Viceversa il formato PDF/A-1b, con meno pretese, richiede che i font siano tutti inclusi nel file, anche se non rispettano la codifica UNICODE, e che il file sia riproducibile a schermo e sia stampabile esattamente nello stesso modo di quando il file è stato archiviato. Il Politecnico richiederà il sotto"formato PDF/A-1b. -Per questo scopo è necessario usare il programma di composizione \texttt{pdflatex} e il pacchetto specifico \textsf{pdfx} richiedendo nel preambolo del file principale della tesi che sia richiamato il file \texttt{pdfx.sy} con l'opzione giusta, precisamente il preambolo, subito prima di \verb|\begin{document}|, deve contenere la richiesta: +Per questo scopo è necessario usare il programma di composizione \texttt{pdflatex} e il pacchetto specifico \textsf{pdfx} richiedendo nel preambolo del file principale della tesi che sia richiamato il file \texttt{pdfx.sty} con l'opzione giusta, precisamente il preambolo, subito prima di \verb|\begin{document}|, deve contenere la richiesta: \begin{verbatim} \usepackage[a-1b]{pdfx} \end{verbatim} -Per facilitare la composizione della tesi questa richiesta è già contenuta nella classe \texttt{TOPtesi}, quindi lo studente non deve preoccuparsi di niente, fuorché installare il pacchetto \textsf{pdfx} nel proprio albero locale. +Per facilitare la composizione della tesi, questa richiesta è già contenuta nella classe \texttt{TOPtesi} sotto forma di opzione per la classe \texttt{toptesi}, quindi lo studente non deve preoccuparsi di niente, fuorché installare il pacchetto \textsf{pdfx} nel proprio albero locale e preparare un file di \emph{metadata} come verrà spiegato più avanti. Se questo pacchetto non fosse già caricato con l'installazione del sistema \TeX\ in un albero di sistema, bisogna provvedere scaricando il pacchetto dagli archivi \textsc{ctan} e installandolo nel proprio albero locale. Siccome bisogna provvedere ad una certa personalizzazione, è consigliabile eseguire questa installazione nell'albero locale, perché quando si aggiorna il sistema \TeX, vengono riscritti tutti i file degli alberi di sistema, ma non quelli dell'albero locale. @@ -441,7 +442,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 la dichiarazione di classe e prima di invocare altri pacchetti. Naturalmente la personalizzazione indicata è solo indicativa e riportata a titolo di esempio. -I \emph{metadata} di carattere generale sono inseriti nel file di uscita dall'azione diretta del file \texttt{pdfx.sty}; ma questo non può contenere i \emph{metadata} specifici del documento che si sta componendo; è necessario allora predisporre nella cartella dove risiede il file principale della tesi (quello sul quale opera l'eseguibile \texttt{pdflatex}) un file contenente i \emph{metadata} specifici, e che abbia estensione \texttt{xmpdata}. Per esempio, il file principale di questo documento si chiama \texttt{toptesi-doc.tex}: nella cartella dove risiede è stato creato il file \texttt{toptesi-doc.xmpdat} con il seguente contenuto: +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 voi vi state componendo; è necessario allora predisporre nella cartella dove risiede il file principale della tesi (quello sul quale opera l'eseguibile \texttt{pdflatex}) un file contenente i \emph{metadata} specifici, e che abbia estensione \texttt{xmpdata}. Per esempio, il file principale di questo documento si chiama \texttt{toptesi-doc.tex}: nella cartella dove risiede è stato creato il file \texttt{toptesi-doc.xmpdata} con il seguente contenuto: \begin{verbatim} \Author{Claudio Beccari} \Title{La classe ToPtesi} @@ -450,11 +451,11 @@ I \emph{metadata} di carattere generale sono inseriti nel file di uscita dall'az \end{verbatim} Questa operazione, evidentemente va ripetuta per ogni documento da produrre in formato PDF/A, e quindi bisogna predisporre un diverso file \texttt{.xmpdata} contenente le informazioni specifiche relative allo specifico documento. -Ricordate solo che il pacchetto \textsf{TOPtesi} non contiene nessuna verifica se state componendo con \texttt{pdflatex} oppure con il semplice \texttt{latex} o con qualche altro applicativo del sistema \TeX. Il concetto è che \emph{dovete} usare \texttt{pdflatex}. +Ricordate solo che il pacchetto \textsf{TOPtesi} non contiene nessuna verifica se state componendo con \texttt{pdflatex} oppure con il semplice \texttt{latex} o con qualche altro applicativo del sistema \TeX. Il concetto è che \emph{dovete} usare \texttt{pdflatex} anche se non volete produrre un documento archiviabile; gli altri motori di composizione per il mark-up di Plain \TeX o di \LaTeX\ sono da considerarsi obsoleti, specialmente per quel che riguarda l'inserimento di figure. -Se esistono validi motivi per non usare \texttt{pdflatex} (ma è meglio che vi mettiate nelle condizioni di \emph{non usare} quei pacchetti che richiedano l'uso di comandi PostScript, come per esempio \textsf{PSTriks} o \textsf{XYpic}, ma di usare i pacchetti di grafica come \textsf{pgf} e il suo ambiente \texttt{tikz} che consento di fare quasi tutto quello che si può fare con gli altri pacchetti che richiedono il linguaggio PostScript), allora dovete usare il semplice \LaTeX, e poi convertire il file DVI ottenuto in un file PS; per la conversione in file PDF/A dovete poi usare \texttt{ghostscript}; per come fare dovete consultare il libretto \textit{Saper Comunicare -- Cenni di scrittura tecnico scientifica} e/o la documentazione di \texttt{ghostscript} (versione 8.61 o successiva) in particolare il file \texttt{ps2pdf.html}. +Se esistono validi motivi per non usare \texttt{pdflatex} (ma è meglio che vi mettiate nelle condizioni di \emph{non usare} quei pacchetti che richiedano l'uso di comandi PostScript, come per esempio \textsf{PSTriks} o \textsf{XYpic}, ma di usare i pacchetti di grafica come \textsf{pgf} e il suo ambiente \texttt{tikz} che consento di fare quasi tutto quello che si può fare con gli altri pacchetti che richiedono il linguaggio PostScript), allora dovete usare il semplice \LaTeX, e poi convertire il file DVI ottenuto in un file PS; per la conversione in file PDF/A dovete poi usare \texttt{ghostscript}; per come fare dovete consultare il libretto \textit{Saper Comunicare -- Cenni di scrittura tecnico scientifica}\footnote{Saper comunicare è scaricabile dal sito del Politecnico di Torino anche da parte di chi non è studente di quell'ateneo.} e/o la documentazione di \texttt{ghostscript} (versione 8.61 o successiva) in particolare il file \texttt{ps2pdf.html}. -Ricordate solo che produrre un file PDF/A non è semplice, ma se usate \texttt{pdflatex} con i font di default, se incorporate solo figure PNG e JPEG con profilo di colore RGB (red, green, blue), se controllate che ogni file PDF da incorporare contenga al suo interno anche i font che eventualmente sono necessari per comporre il testo che contengono, non dovreste incontrare problemi di certificazione della natura PDF/A del file della vostra tesi. +Ricordate solo che produrre un file PDF/A non è semplice, ma se usate \texttt{pdflatex} con i font di default, se incorporate solo figure PNG e JPEG e PDF con profilo di colore RGB (red, green, blue), se controllate che ogni file PDF da incorporare contenga al suo interno anche i font che eventualmente sono necessari per comporre il testo che contengono, non dovreste incontrare problemi di certificazione della natura PDF/A del file della vostra tesi. \section{Pronti? Via!} @@ -467,7 +468,7 @@ correzioni, potrete anche inserire qualche spazio fine positivo o negativo per fare degli aggiustamenti di seconda o terza approssimazione. Ricordatevi però che, anche se non c'è limite al meglio (ma nemmeno al peggio!), \LaTeX\ lavora benissimo da -solo purché non lo si disturbi con interventi non professionali. +solo purché non lo si disturbi con interventi non professionali. \section{I file accessori} @@ -496,13 +497,13 @@ piacere, per esempio, con grande fantasia, \texttt{myfile.tex}: \end{document} \end{verbatim} -Passando questo piccolo file a \LaTeX\ o a pdf\LaTeX, si ottiene +Passando questo piccolo file a \LaTeX\ o a pdf\/\LaTeX, si ottiene un documento di una sola pagina, il frontespizio, che si può stampare in varie copie per gli scopi detti sopra. Anche se componete il frontespizio in inglese, non potete fare a meno di chiamare \texttt{babel} perché \texttt{topfront} usa alcuni comandi di quel pacchetto. Naturalmente al posto di \texttt{italian} potete specificare un'altra lingua. L'altro file accessorio \texttt{topcoman.sty} contiene diversi utili comandi, alcuni già incorporati nella definizione della -lingua italiana del sistema \TeX. Tuttavia se dovete scrivere in +lingua italiana così come la gestisce \texttt{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 @@ -533,9 +534,9 @@ esperienza che all'inizio ci si sente sperduti davanti allo schermo vuoto. Ma voi studenti del Politecnico, e non solo del Politecnico, potete scaricare dal portale della didattica del sito del Politecnico \texttt{http://didattica.polito.it} l'opuscoletto -\emph{Saper Comunicare --- Cenni di scrittura tecnico-scientifica} -dove c'è scritto più o meno tutto quel che bisogna sapere per -impostare e scrivere un rapporto tecnico-scientifico qual è la +\emph{Saper Comunicare --- Cenni di scrittura tecnico scientifica} +dove c'è scritto più o meno tutto quel che bisogna sapere per +impostare e scrivere un rapporto tecnico-scientifico qual è la tesi, la monografia o la dissertazione. Qui dirò solo come si comincia a scrivere il file sorgente della @@ -587,7 +588,7 @@ inserire dei segni di commento all'inizio di alcune delle righe in modo da eseguire, per esempio, la compilazione selettiva di un solo capitolo conservando tutte le informazioni incrociate relative agli altri capitoli già compilati. Con i PC di oggi la -compilazione è rapidissima, quindi non vi invito a seguire questa +compilazione è rapidissima, quindi non vi invito a seguire questa procedura per risparmiare tempo di compilazione; faccio solo notare che il fatto di tenere separate le varie parti della tesi permette di lavorare con più ordine e di risparmiare non poco @@ -603,7 +604,7 @@ alla propria università che hanno messo a disposizione le loro strutture o le loro competenze per lo svolgimento della tesi. Non si ringraziano genitori, fidanzati/e, amici, e tutti i parenti di ogni grado, il quali saranno più che contenti di sapervi laureati, -piuttosto che non vedere il proprio nome scritto sulla tesi\dots. +piuttosto che non vedere il loro nome scritto sulla tesi\dots. Inoltre rappresenta un atto di piaggieria ringraziare il o i propri relatori; essi hanno svolto un loro compito istituzionale, non vi hanno fatto un piacere. Naturalmente questo non vieta che @@ -636,7 +637,7 @@ Perché questi due piccoli ambienti sono rudimentali? Per consentire a ciascuno d \end{dedica} \end{verbatim} Per l'ambiente \texttt{citazioni} non è stata preimpostata nessuna dichiarazione per i font, quindi l'utente è completamente responsabile della scelta dei font. -Entrambi gli ambienti sono realizzati con una composizione in bandiera, perché la giustezza è ridotta a metà di quella del testo, ma lil testo della dedica o delle citazioni è composto dentro una ``paginetta'' (\texttt{minipage}) collocata a due terzi dalla base della griglia di stampa a filo del margine esterno. +Entrambi gli ambienti sono realizzati con una composizione in bandiera, perché la giustezza è ridotta a metà di quella del testo, ma il testo della dedica o delle citazioni è composto dentro una ``paginetta'' (\texttt{minipage}) collocata a due terzi dalla base della griglia di stampa a filo del margine esterno. \subsection{La scelta della codifica per il file sorgente} @@ -661,26 +662,32 @@ suggerisco di specificare la codifica con \begin{verbatim} \usepackage[latin1]{inputenc} \end{verbatim} +Per tutti i sistemi sarebbe forse più utile usare anche nei file sorgente la codifica UNICODE, e specificare nel preambolo: +\begin{verbatim} +\usepackage[utf8]{inputenc} +\end{verbatim} +solo che non tutti i \emph{text editor} gestiscono questa codifica; sicuramente la gestiscono \TeX{Shop}, \TeX{works}, TeXmakerX, Texmaker, emacs, Aquamacs; certamente anche altri, ma io conosco solo questi; sono tutti multipiattaforma, tranne \TeX{Shop} che vale solo per la distribuzione Mac\TeX\ sulle macchine Mac. + -In particolare vanno accentate anche le lettere maiuscole; siccome la tastiera italiana non le prevede, consiglio di inserire nel preambolo la definizione del comando \verb|\E| per scrivere È. Credo che questa sia la maiuscola accentata più frequente in italiano e le altre non capitano mai all'inizio di un periodo. Il comando: +In particolare vanno accentate anche le lettere maiuscole; siccome la tastiera italiana non le prevede, se il sisteam operativo non prevede adeguate scorciatoie, consiglio di inserire nel preambolo la definizione del comando \verb|\E| per scrivere È. Credo che questa sia la maiuscola accentata più frequente in italiano e le altre non capitano mai all'inizio di un periodo. Il comando: \begin{verbatim} \newcommand*\E{\`E\space} \end{verbatim} inserisce direttamente una È all'inizio di un periodo e inserisce direttamente lo spazio successivo, per cui, senza inserire esplicitamente nessun comando di spaziatura dopo il comando \verb|\E|, si può scrivere semplicemente: \begin{verbatim} -\E conveniente rilevare che\dots +\E conveniente rilevare che... \end{verbatim} per ottenere: \begin{quote} È conveniente rilevare che\dots \end{quote} -Se il vostro editor vi consente di selezionale le maiuscole accentate da una tabella oppure vi consente di usare combinazioni di tasti per inserire direttamente le maiuscole accentate nel file sorgente, fatene uso, perché la lettura del file sorgente ne guadagna moltissimo. +Se il vostro editor vi consente di selezionare le maiuscole accentate da una tabella oppure vi consente di usare combinazioni di tasti per inserire direttamente le maiuscole accentate nel file sorgente, fatene uso, perché la lettura del file sorgente ne guadagna moltissimo. Per scrivere con in lingue dell'Europa orientale e, mi si dice, anche in francese, sono migliori altre opzioni di codifica, ma per questo si -rinvia alla documentazione di \LaTeX. +rinvia alla documentazione di \LaTeX. Con la codifica UNICODE non si hanno problemi in nessuna lingua dell'Europa Orientale o Occidentale; anzi è possibile scrivere direttamente in greco e un diverse varietà di cirillico; volendo esistono i pacchetti di estensione necessari anche per scrivere in lingue retrograde come l'ebraico e l'arabo; conoscendo la lingua si possono scrivere anche le lingue a ideogrammi dell'Asia Orientale, e anche con alfabeti particolari come il vietnamita, il tailandese, il sanscrito, eccetera. -Certo se il vostro editor lo prevede, e gli editor moderni lo prevedono, potete anche scegliere di codificare i vostri file \texttt{.tex} con la codifica UTF-8; questo, sempre se il vostro editor lo consente, vi permette di scrivere direttamente la vostra tesi inserendo anche delle parti con alfabeti diversi, tutti quelli che i vostri font di uscita vi consentono, dal greco al cirillico, per citare i più vicini a noi, fino al cinese o al giapponese. Ovviamente dovete caricare nel vostro preambolo tutto quello che è necessario per gestire quelle lingue, ma non chiedetemi come si fa, perché so dirvelo solo per il greco. Per questa lingua, se usate l'ortografica monotonika, basta inserire l'opzione della lingua \texttt{greek} fra le opzioni della classe; se usate l'ortografia polytonika, allora dovete richiedere lo specifico attributo seguendo questo procedimento: +Infatti, se il vostro editor lo prevede, e gli editor moderni lo prevedono, potete anche scegliere di codificare i vostri file \texttt{.tex} con la codifica UTF-8; questo, sempre se il vostro editor lo consente, vi permette di scrivere direttamente la vostra tesi inserendo anche delle parti con alfabeti diversi, tutti quelli che i vostri font di uscita vi consentono, dal greco al cirillico, per citare i più vicini a noi, fino al cinese o al giapponese. Ovviamente dovete caricare nel vostro preambolo tutto quello che è necessario per gestire quelle lingue, ma non chiedetemi come si fa, perché so dirvelo solo per il greco. Per questa lingua, se usate l'ortografica monotonika, basta inserire l'opzione della lingua \texttt{greek} fra le opzioni della classe; se usate l'ortografia polytonika, allora dovete richiedere lo specifico attributo seguendo questo procedimento: \begin{verbatim} \documentclass[...,greek,...]{toptesi} ... @@ -693,7 +700,7 @@ Per una tesi che tratti il greco antico in forma filologica, consiglio l'uso del Probabilmente per usare le lingue che si scrivono in cirillico, basta specificare l'opzione della lingua, come si fa per il greco. Per alcune altre lingue bisogna invece caricare l'apposito pacchetto, il quale provvede a tutte le impostazioni necessarie; in questi casi bisogna leggere con attenzione la documentazione di quei pacchetti. -Ma, tornando alla codifica UTF-8, il problema non è tanto l'editor che consenta o non consenta di usare quella codifica; quasi tutti i sistemi operativi consentono di installare diversi driver per la tastiera del PC, cosicché con un semplice click del mouse si può passare da un alfabeto all'altro; il problema sono i tasti della tastiera che hanno serigrafato sulla loro faccia il segno che si ottiene premendo quel tasto. Non è ovviamente possibile cambiare il disegno che appare sui tasti, semplicemente cliccando per cambiare driver; forse lo si può fare con le tastiere virtuali dei PC \emph{touch screen}, ma con i PC normali questo non è possibile. Ecco quindi che la difficoltà di scrivere con un alfabeto diverso richiede una memoria ferrea per ricordare a quale segno dell'altro alfabeto corrisponda il tasto della nostra tastiera. Per il greco moderno e classico, se si usano i font di default con la codifica LGR (Local GReek), che vengono installati praticamente con ogni installazione del sistema \TeX\ che non sia proprio una distribuzione essenziale, le corrispondenze con la tastiera latina sono studiate in modo da semplificare molto questo processo di ``memorizzazione''. Tuttavia ad una persona abituata a leggere il greco scritto (giustamente) in greco, vederlo scritto con caratteri latini fa un certo effetto; la documentazione di \textsf{babel} e quella di \textsf{teubner} ricordano questa corrispondenza fra i tasti latini e i segni greci (lettere, accenti, spiriti, segni speciali, ecc.). La corrispondenza fra greco e latino è abbastanza semplice perché il greco ha 24 maiuscole e 25 minuscole, mentre il latino ne ha 26 di ciscun tipo. Non so che cosa succeda con il cirillico che ha un alfabeto composto di più di 30 segni, per cui la corrispondenza con l'alfabeto latino è impossibile. +Ma, tornando alla codifica UTF-8, il problema non è tanto l'editor che consenta o non consenta di usare quella codifica; quasi tutti i sistemi operativi consentono di installare diversi driver per la tastiera del PC, cosicché con un semplice click del mouse si può passare da un alfabeto all'altro; il problema sono i tasti della tastiera che hanno serigrafato sulla loro faccia il segno che si ottiene premendo quel tasto. Non è ovviamente possibile cambiare il disegno che appare sui tasti, semplicemente cliccando per cambiare driver; forse lo si può fare con le tastiere virtuali dei PC \emph{touch screen}, ma con i PC normali questo non è possibile. Ecco quindi che la difficoltà di scrivere con un alfabeto diverso richiede una memoria ferrea per ricordare a quale segno dell'altro alfabeto corrisponda il tasto della nostra tastiera. Per il greco moderno e classico, se si usano i font di default con la codifica LGR (Local GReek), che vengono installati praticamente con ogni installazione del sistema \TeX\ che non sia proprio una distribuzione essenziale, le corrispondenze con la tastiera latina sono studiate in modo da semplificare molto questo processo di ``memorizzazione''. Tuttavia ad una persona abituata a leggere il greco scritto (giustamente) in greco, vederlo scritto con caratteri latini fa un certo effetto; la documentazione di \textsf{babel} e quella di \textsf{teubner} ricordano questa corrispondenza fra i tasti latini e i segni greci (lettere, accenti, spiriti, segni speciali, ecc.). La corrispondenza fra greco e latino è abbastanza semplice perché il greco ha 24 maiuscole e 25 minuscole, mentre il latino ne ha 26 di ciascun tipo. Non so che cosa succeda con il cirillico che ha un alfabeto composto di più di 30 segni, per cui la corrispondenza con l'alfabeto latino è impossibile. \subsection{La scelta della codifica per il file di uscita} @@ -714,11 +721,11 @@ I file della collezione Computer Modern con codifica \texttt{T1}, conosciuti anc ... \end{verbatim} -Naturalmente per gli utenti esperti di \LaTeX\ ci sono anche altri pacchetti usabili per impiegare altri font diversi da quelli della collezione Latin Modern, che comunque sono i migliori per la loro completezza; grazie al diverso disegno dei corpi minori la lettura dei pedici e degli apici ne risulta agevolata. +Naturalmente per gli utenti esperti di \LaTeX\ ci sono anche altri pacchetti usabili per impiegare altri font diversi da quelli della collezione Latin Modern, che comunque sono i migliori per la loro completezza; infatti, grazie al diverso disegno dei corpi minori, la lettura dei pedici e degli apici ne risulta agevolata. Qui segnalo solo la collezione dei font Times eXtendex, richiamabili con il pacchetto \textsf{txfonts}, e la collezione dei font Palatino eXtended, richiamabili con il pacchetto \textsf{pxfonts}. I Times sono font più stretti di quelli della collezione Latin Modern e sono forse indicati per rendere più compatta una tesi un po' voluminosa. I Palatino sono un po' più larghi dei font della collezione Latin Modern e allungano la tesi di qualche pagina. -Tanto per confronto, questo testo di documentazione su \textsf{TOPtesi} è composto con i font di default Computer Modern con codifica \texttt{OT1}; come si vede la divisione delle parole tronche in fin di riga è piuttosto rara e non si presentano inconvenienti particolari; forse con un testo di altro genere, con composizione in colonne strette o all'interno di tabelle, si potrebbe verificare la presenza di righe molto lasche, dove è stato allargato troppo lo spazio interparola. Per questo si consiglia sempre di usare la codifica \texttt{T1} anche per l'italiano; non si sa mai, ma certamente con questa codifica si hanno meno inconvenienti e le lettere accentate sono disegnate meglio\footnote{Questo testo è stato composto facendo uso anche del pacchetto \textsf{microtype}; con questo pacchetto si ottimizza la composizione delle righe di ogni capoverso allo scopo di ridurre al massimo le cesure in fin di riga (in questo testo di una sessantina di pagine, ci sono solo una decina di righe, escluse le tabelle, con la cesura in fin di riga) e di rendere il più omogenei possibile gli spazi interparola; se ne coniglia l'uso, ma certo si tratta di una \emph{raffinatezza}, non di una cosa necessaria. \textsf{microtype} produce gli effetti migliori quando si usano i font PostScript e il motore di composizione pdf\LaTeX.}. +Tanto per confronto, questo testo di documentazione su \textsf{TOPtesi} è composto con i font di default Computer Modern con codifica \texttt{OT1}; come si vede la divisione delle parole tronche in fin di riga è piuttosto rara e non si presentano inconvenienti particolari; forse con un testo di altro genere, con composizione in colonne strette o all'interno di tabelle, si potrebbe verificare la presenza di righe molto lasche, dove è stato allargato troppo lo spazio interparola. Per questo si consiglia sempre di usare la codifica \texttt{T1} anche per l'italiano; non si sa mai, ma certamente con questa codifica si hanno meno inconvenienti e le lettere accentate sono disegnate meglio\footnote{Questo testo è stato composto facendo uso anche del pacchetto \textsf{microtype}; con questo pacchetto si ottimizza la composizione delle righe di ogni capoverso allo scopo di ridurre al massimo le cesure in fin di riga (in questo testo di una sessantina di pagine, ci sono solo una decina di righe, escluse le tabelle, con la cesura in fin di riga) e di rendere il più omogenei possibile gli spazi interparola; se ne coniglia l'uso, ma certo si tratta di una \emph{raffinatezza}, non di una cosa necessaria. \textsf{microtype} produce gli effetti migliori quando si usano i font PostScript e il motore di composizione pdf\/\LaTeX.}. \section{Come stampare la tesi} @@ -729,10 +736,10 @@ della pagina. Qual è la differenza? È quella che si osserva nei libri composti meglio, cioè nei libri con i fogli stampati davanti e di dietro: -quando il libro è aperto la striscia bianca formata dai due +quando il libro è aperto la striscia bianca formata dai due margini interni delle pagine affacciate è circa uguale a ciascuno dei margini esterni. Invece quando si stampa su una facciata sola -il corpo del testo è centrato e i margini laterali sono +il corpo del testo è centrato e i margini laterali sono uguali. Inoltre nelle testatine delle pagine stampate solo in bianca compare sempre e solo il titolo del capitolo corrente, mentre nelle testatine delle pagine \emph{pari} stampate in bianca @@ -763,7 +770,7 @@ certa ampiezza e può accogliere le note marginali\marginpar{\footnotesize\sffamily Questa è una nota a margine}, se si decide di farne uso, ma anche perché, almeno al Politecnico di Torino, la copia da depositare nella segreteria di -facoltà non deve essere realizzata in carta, ma deve essere +facoltà non deve essere realizzata su carta, ma deve essere registrata su un dischetto o su un CD-ROM in formato \texttt{.pdf} (o in formato \texttt{.doc} se non si usa \LaTeX) e chi legge la tesi sullo schermo preferisce senz'altro avere il testo centrato @@ -783,6 +790,13 @@ o sul dischetto dovrà essere compilata senza specificare questa opzione, che invece sarà specificata per ricomporre il file prima della stampa su carta. +Se 7\,mm non sembrano adeguati, si può variare il valore di default usando il comando +\texttt{\char92setbindingcorrection}, scrivendo nel preambolo, per esempio: +\begin{verbatim} +\setbindingcorrection{6mm} +\end{verbatim} + + \section{Comporre la tesi in diverse lingue} Il pacchetto \textsf{TOPtesi} usa di default il pacchetto \texttt{babel} per gestire la composizione in diverse lingue. @@ -805,7 +819,7 @@ gestire diverse lingue, subito dopo l'installazione lanciate \LaTeX\ su un file di prova qualunque, per esempio \texttt{sample.tex}, poi apritene il file \texttt{.log}, nell'esempio \texttt{sample.log}; nelle prime righe di questo file -troverete le lingue per le quali il vostro sistema già +troverete le lingue per le quali il vostro sistema è già configurato. Per esempio scrivendo questo file di documentazione il file @@ -849,13 +863,15 @@ documentazione che accompagna la vostra distribuzione; qui darò alcuni cenni relativi alle distribuzioni che io conosco. \subsubsection{MiK\TeX} -Questa distribuzione nella sua versione completa è in grado di gestire tutte le lingue che il sistema \TeX\ conosce, quindi non c'è bisogno di nessuna configurazione ulteriore. +Questa distribuzione nella sua versione completa è in grado di gestire tutte le lingue che il sistema \TeX\ conosce, quindi non c'è bisogno di nessuna configurazione ulteriore. Se invece vi siete installata la versione ``basic'' non avete altro da dirvi che: ``chi è causa del suo mal, pianga se stesso''! Soluzione: disintallatela e re"installate al suo posto la versione completa. + +\subsubsection{teTeX, Debian teTeX e Debian \TeX-live } +La distribuzione \texttt{teTeX} non viene più aggiornata da quando esiste \TeX\-live; mi risulta che venga ancora distribuita da alcuni sistemi Linux basati su Debian; per esempio Slackware. Mi permetterei di consigliare di non usare \texttt{teTeX} nemmeno nella versione Debian, ma non vorrei passare per un iconoclasta di quella gloriosa distribuzione. -\subsubsection{teTeX e Debian teTeX } -La distribuzione \texttt{teTeX} non viene più aggiornata da quando esiste \TeX\-live; mi risulta che venga ancora distribuita da alcuni sistemi Linux basati su Debian; per esempio Slackware. -Tuttavia, sempre per mia esperienza, ho installato \TeX\-live sulla mia versione Debian di Ubuntu e non ho avuto nessunissimo problema; la distribuzione \TeX\-live è sempre veramente aggiornata in tempo praticamente reale e il suo ``package manager'' consente l'aggiornamento continuo, indipendentemente dalle ``uscite'' annuali di \TeX\-live; mi permetterei di consigliare di non usare \texttt{teTeX} nemmeno nella versione Debian, ma non vorrei passare per un iconoclasta di quella gloriosa distribuzione. +Spesso le versioni di Linux che sono conformi alle specifiche Debian installano una versione certificata Debian di \TeX-live ridotta e preconfigurata solo per l'inglese, (oltre che vecchia di almeno due anni) che serve per soddisfare le dipendenze per altri programmi. Quindi non si può eliminare questa distribuzione di \TeX-live, ma se ne può installare un'altra attuale e aggiornata con particolari cautele, in modo da usare quest'ultima per \LaTeX\ e soci, e usare l'altra per il corretto funzionamento degli altri programmi Debian. Per sapere come fare è conveniente scaricare il file: \texttt{http:/"/profs.sci.univr.it"/~gregorio"/texlive-ubuntu.pdf} dove la distribuzione Ubuntu è presa come modello, ma sono indicate anche le piccole modifiche per fare le operazioni equivalenti anche su Fedora e SUSE Linux. +Seguendo quelle indicazioni ho installato \TeX\-live completa sulla mia versione Debian di Ubuntu e non ho avuto nessunissimo problema; la distribuzione \TeX\-live è sempre veramente aggiornata in tempo praticamente reale e il suo ``package manager'' consente l'aggiornamento continuo, indipendentemente dalle ``uscite'' annuali di \TeX\-live. \subsubsection{\TeX-live} La distribuzione \TeX-live nasce già configurata per tutte le lingue che \LaTeX\ è capace di gestire, quindi anche l'italiano; bisogna ricorrere ai suoi comandi di configurazione solo se si vuole aggiungere una lingua la cui sillabazione non sia distribuita insieme a \TeX\-live. Questo evento è talmente raro che non vale la pena di insistervi sopra. Tuttavia un laureando che svolga la sua tesi sull'ostrogoto altomedievale e disponesse solo della sillabazione per l'ostrogoto classico e per l'ostrogoto contemporaneo, si troverebbe in difficoltà; infatti, prima ancora di inserire le regole per l'ostrogoto altomedievale, dovrebbe scriversi le regole di sillabazione e codificarle nel linguaggio specifico richiesto dal sistema \TeX; questo è tutt'altro che facile ed è riservato a specialisti molto avanzati. @@ -870,7 +886,7 @@ Dal 2007 la distribuzione di \texttt{Mac\TeX} sostanzialmente coincide con\TeX-l \subsubsection{Distribuzioni commerciali} Le distribuzioni commerciali differiscono da quelle gratuite essenzialmente per i programmi accessori che accompagnano la -distribuzione del sistema \TeX\ che, di sua natura, è gratuito; +distribuzione del sistema \TeX\ che, di sua natura, è gratuita; il costo delle distribuzioni commerciali corrisponde al valore delle parti accessorie, all'assistenza per i clienti, eccetera. @@ -896,7 +912,7 @@ inserire brani in francese si scriverà: \end{verbatim} Se invece si vuole scrivere la tesi in inglese, lingua già -inserita di default in \textsf{TOPtesi}, ma non attivata, bisogna +inserita di default in \textsf{TOPtesi}, ma non attivata di default, bisogna dare l'indicazione esplicita dopo l'inizio del documento così: \begin{verbatim} \documentclass[11pt,cucitura]{toptesi} @@ -912,7 +928,7 @@ alternare le dichiarazioni \verb|\italiano| e \verb|\english|. Attenzione: queste dichiarazioni alterano anche le parole come Chapter o Capitolo, Table o Tabella, quindi per inserire brani nell'altra lingua è opportuno servirsi dei comandi di -\texttt{babel}, in particolare l'ambiente \texttt{otherlanguage}, +\texttt{babel}, in particolare dell'ambiente \texttt{otherlanguage}, per esempio: \begin{verbatim} ... disse: @@ -986,7 +1002,7 @@ seguenti. \section{Le opzioni} La classe \texttt{toptesi} accetta diverse opzioni nel -comando di di dichiarazione della classe; negli esempi esposti ne sono +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 la classe \texttt{report}. @@ -1018,7 +1034,7 @@ d'errore ``Overfull hbox''; questo è un altro motivo per il quale sconsiglio di usare questa opzione, se non quando è strettamente necessario. Se la si usa, si verifichi che il titolo, i titoli dei capitoli, quelli dei paragrafi, eccetera siano composti -correttamente. In particolare il titolo della tesi e i titoli dei +correttamente. In particolare si ricordi che il titolo della tesi e i titoli dei capitoli possono andare a capo solo prima di articoli, preposizioni semplici o articolate, congiunzioni e brevi avverbi come ``non''; per evitare di andare a capo dopo queste parti del @@ -1034,8 +1050,8 @@ semplicemente la classe informa di aver trovato delle opzioni che né lei né altri pacchetti hanno usato. Serve per comporre la testatina di sinistra sulle pagine pari con l'indicazione del candidato e del titolo della tesi. È ovvio che il titolo della -tesi con questa opzione deve essere molto breve, ed è per questo -che è stato messo a disposizione dello studente l'argomento +tesi con questa opzione deve essere molto breve, ed è per questo +che è stato messo a disposizione dello studente l'argomento facoltativo del comando \verb|\titolo| che consente di specificare un titolo di tre o quattro parole (brevi) ma di senso compiuto, che possa sostituire il titolo normale, specialmente se questo è @@ -1110,7 +1126,7 @@ valore. La composizione tipografica non ha nulla a che vedere con la composizione dattilografica (\emph{absit iniuria verbis}!). Quest'ultima si faceva con mezzi avanzati per l'epoca, ma oggi quei -mezzi sono del tutto obsoleti; le poche macchine da scrivere +mezzi sono del tutto obsoleti; le poche macchine da scrivere meccaniche o elettromeccaniche che esistono ancora fuori da qualche museo, vengono usate per riempire formulari o compilare le informazioni sui documenti cartacei che sopravvivono alla invasione delle carte @@ -1397,50 +1413,24 @@ le tesi di dottorato né per le monografie. \item Per la monografia l'informazione della data può essere omessa se non c'è una data per la presentazione. % -\item Il pacchetto \textsf{TOPtesi} contiene i loghi del Politecnico -di Torino, del Politecnico di Bari e dell'Institut National -Polytechnique de Grenoble; delle Università di Torino, del -Piemonte Orientale, di Genova, di Pavia, di Padova, di Trieste, di -Bologna (di cui questa Università specifica il corretto uso), di -Pisa, di Urbino, delle tre Università di Roma, di quelle di Bari e -di Palermo; questi loghi sono forniti nei formati \texttt{.pdf} e -\texttt{.eps}\footnote{Ahimè , alcuni di questi loghi sono stati -ricavati con una risoluzione troppo bassa; se dovete inserire il -logo di una di queste sfortunate università il cui logo è di -bassa qualità grafica, cercate di informarvi all'ufficio giusto -per avere l'autorizzazione per scaricare un logo di qualità -grafica migliore.}. - -È ovvio che prima di usare un logo, del quale ogni università è -piuttosto gelosa, bisogna essere sicuri di non commettere un -illecito. Prima di usare qualsiasi logo informatevi -dall'istituzione rappresentata da quel simbolo sul suo uso -corretto e legale. +\item Il pacchetto \textsf{TOPtesi} nelle distribuzioni precedenti a questa conteneva un buon numero di loghi di università italiane e straniere; mi è stato fatto notare che questi loghi sono di proprietà esclusive delle università e che esse potrebbero reclamare e sollevare questioni giuridiche quando i loro loghi venissero distribuiti senza il loro consenso esplicito. Perciò con questa versione cesso la distribuzione dei loghi (con un certo rincrescimento, lo devo ammettere) per evitare conflitti, in particolare per evitare che l'archivio \textsc{ctan} possa in qualche modo essere trascinato in una controversia legale. + +Gli utenti di questo pacchetto, quindi dovranno ottenere il logo direttamente dalla loro università e, ovviamente, prima di usare un logo, del quale ogni università è piuttosto gelosa, bisogna che siano sicuri di non commettere un illecito. Prima di usare qualsiasi logo informatevi dall'istituzione rappresentata da quel simbolo sul suo uso corretto e legale. + +Se otterrete il logo dalla vostra università controllate che la sua impostazione si riferisca ad un disegno piuttosto dettagliato, con una densità di pixel non inferiore a 300 dpi, per la resa migliore, o al peggio non sia inferiore a 150 dpi. Trasformate, se non lo fosse già il formato del file nel formato PNG (Portable Network Graphics), estensione \texttt{.png}, o JPEG (Joint Photographic Expert Group), estensione \texttt{.jpg}, o anche PDF; ricorrete al formato EPS se e solo se siete costretti ad usare \LaTeX, e non a pdf\/\LaTeX, per la composizione della tesi. \end{itemize} Per quanto riguarda i loghi, la loro inserzione implica l'uso del pacchetto \texttt{graphicx}, che \textsf{TOPtesi} carica di default; specificare nuovamente quel pacchetto non produce nessun -danno, perché \LaTeX\ controlla da solo se lo deve caricare o non +danno, perché \LaTeX\ controlla da solo se lo deve caricare o non lo deve ricaricare. -Tuttavia va segnalato un punto che dovrebbe essere evidente dal -fatto che sono presenti le figure dei loghi sia nel formato -\texttt{.eps} gestibile da \LaTeX\ e \texttt{dvips}, sia nel -formato \texttt{.pdf} gestibile da {pdf\LaTeX}. I due insiemi di -formati sono disgiunti, nel senso che non esiste un formato su cui -possano operare indifferentemente sia \LaTeX\ sia pdf\LaTeX, -tranne il formato dei file prodotti dal programma MetaPost, che è -assai raro e poco usato, certamente non usato per i loghi. - -No, anzi: dal 2010 il programma {pdf\LaTeX} è capace di gestire da solo anche le figure in formato \texttt{.eps}, nel senso cha da solo se le converte nel formato \texttt{.pdf} senza bisogno di chiederglielo esplicitamente; una volta prodotta la figura convertita, {pdf\LaTeX} la riconosce e non esegue più di nuovo la conversione. Perché allora non ho distribuito loghi solo in formato \texttt{.eps}? Perché questo formato è molto ingombrante e per produrre un file finale in formato \texttt{.pdf} bisogna comunque disporre di figure in formato accettabile da {pdf\LaTeX} senza conversioni di mezzo. Forse in un prossimo futuro eliminerò dalla distribuzione tutte le figure in formato \texttt{.eps}, con buona pace di coloro che continuano ad usare \LaTeX invece di {pdf\LaTeX}. Per questi utenti ricordo che il programma GUI \texttt{gview} è in grado di aprire un file \texttt{.pdf} e di salvarlo in formato \texttt{.eps}, quindi non sarebbe difficile fare la conversione a mano nemmeno per quei pochi utenti che continuano ad usare \LaTeX. +Tuttavia va segnalato un punto che dovrebbe essere evidente -Per questo io preferisco usare sempre e solamente il compilatore -pdf\LaTeX, se non altro perché accetta un maggior numero di -formati grafici. L'unico inconveniente è che non posso usare direttamente il -pacchetto \texttt{PSTricks}; ma finora me la sono cavata molto -bene anche senza le prestazioni di questo bellissimo pacchetto. +Da quanto esposto sopra: i programmi \LaTeX\ e pdf\/\LaTeX\ non possono assorbire qualunque formato per le immagini; \LaTeX\ può includere solo figure in formato EPS, mentre pdf\/\LaTeX\ può includere i formati PNG, JPEG, PDF; dal 2010 anche pdf\/\LaTeX\ riesce ad incorporare i file in formato EPS ma, senza trucchi di vario genere, non può ancora contenere il codice PostScript, e quindi non può usare direttamente i pacchetti della collezione PSTricks. Tuttavia la collezione dei file di estensione del sistema \TeX\ contine diversi file di estensione per aggirare questa situazione. +Come già detto, dal 2010 il programma {pdf\/\LaTeX} è capace di gestire da solo anche le figure in formato \texttt{.eps}, nel senso cha da solo se le converte nel formato \texttt{.pdf} senza bisogno di chiederglielo esplicitamente; una volta prodotta la figura convertita, {pdf\/\LaTeX} la riconosce e non esegue più di nuovo la conversione. \section{Altri comandi} Il pacchetto \textsf{TOPtesi} richiede l'uso di altri comandi il @@ -1646,7 +1636,7 @@ tutti, o anche elencare solo i più importanti. Non resta che augurare: \begin {center}\Large\bfseries -Buona composizione con \LaTeX! +Buona composizione con pdf\/\LaTeX! \end{center} \appendix \input{LPPL} diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.xmpdata b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.xmpdata new file mode 100755 index 00000000000..7836041c918 --- /dev/null +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc.xmpdata @@ -0,0 +1,3 @@ +\Author{Claudio Beccari} +\Title{La classe ToPtesi} +\Keywords{LaTeX</rdf:li><rdf:li>Tesi</rdf:li><rdf:li>PDF/A</rdf:li><rdf:li>Dissertazione</rdf:li><rdf:li>Monografia}
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-example.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-example.pdf Binary files differindex df9e3b8c377..81434eaf384 100644 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-example.pdf +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-example.pdf diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-example.tex b/Master/texmf-dist/doc/latex/toptesi/toptesi-example.tex index 7b4bdc25685..ac9febf40cc 100644 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-example.tex +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-example.tex @@ -15,6 +15,8 @@ %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% 3.o Esempio con la classe toptesi % \documentclass[11pt,twoside,oldstyle,autoretitolo,classica,greek]{toptesi} % \usepackage[or]{teubner} +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% 4.o esempio con classe toptesi +%\documentclass[14pt,twoside,cucitura]{toptesi} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% % % Esempio di composizione di tesi di laurea. @@ -38,8 +40,8 @@ \nomeateneo{Tor Vergata} \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 +%\monografia{La~pressione barometrica di~Giove}% per la laurea triennale +\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 @@ -59,7 +61,7 @@ %\annoaccademico{1615-1616}% solo con l'opzione classica %\annoaccademico{2006-2007}% idem \ciclodidottorato{XV}% per il dottorato -\logosede{logouniroma2}% questo e' ovviamente facoltativo, ma e' richiesto per il dottorato al PoliTO +\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} diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf Binary files differindex 1a5617a501f..6cec96c9b41 100644 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf diff --git a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx index 0e006e96844..2bf9d7ef74f 100644 --- a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx +++ b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx @@ -25,7 +25,7 @@ This work is "author-maintained" This work consists of this file toptesi.dtx, a README file and the derived files: -toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, topsize14, +toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, toptesi.cfg, and the English documentation toptesi.pdf; Furthermore the bundle contains the documentation source file toptesi-doc.tex @@ -39,7 +39,7 @@ frontpages. The toptesi.cfg file is a sample of a local configuration file that can be freely edited and modified. -By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files +By running pdflatex on toptesi.dtx the user gets the cls, sty and cfg files and the English documentation file in pdf format. The documentation file toptesi-doc.pdf is in Italian; its source file is @@ -51,7 +51,6 @@ another example of how to use toptesi. \generateFile{toptesi.sty}{t}{\from{toptesi.dtx}{topsty}} \generateFile{topcoman.sty}{t}{\from{toptesi.dtx}{topcmn}} \generateFile{topfront.sty}{t}{\from{toptesi.dtx}{topfrn}} -\generateFile{topsiz14.clo}{t}{\from{toptesi.dtx}{top14}} \generateFile{toptesi.cfg}{t}{\from{toptesi.dtx}{topcfg}} \def\tmpa{plain} @@ -59,7 +58,7 @@ another example of how to use toptesi. \endgroup %</internal> % -% Copyright 1989--2006 Claudio Beccari +% Copyright 2005--2011 Claudio Beccari % % This file is part of the TOPtesi bundle % ------------------------------------------- @@ -86,7 +85,7 @@ another example of how to use toptesi. % \iffalse %<*driver> \documentclass{ltxdoc} -\ProvidesFile{toptesi.dtx}[2011/05/11 v.5.05 Documented TeX file for +\ProvidesFile{toptesi.dtx}[2011/05/25 v.5.50 Documented TeX file for the TOPtesi bundle] \GetFileInfo{toptesi.dtx} \title{The TOPtesi bundle} @@ -101,7 +100,7 @@ the TOPtesi bundle] %</driver> % \fi % -% \CheckSum{2933} +% \CheckSum{2441} % %% \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 @@ -134,7 +133,7 @@ the TOPtesi bundle] % \end{abstract} % % \section{Introduction} -% The TOPtesi bundle collects a certain number of files, specifically +% The TOPtesi bundle collects a certain number of files, specifically: % \begin{itemize} % \item a class file \texttt{toptesi.cls} to be used as the main document class; the main % document may be any of a certain number of reports that in Italy @@ -143,8 +142,8 @@ the TOPtesi bundle] % magistrale'', ``tesi di dottorato'', ``dissertazione di dottorato'', and so on. % All these documents have in common the fact that they all conclude a period of university % education. Moreover since they may conclude a double degree university program, they may -% receive foreign names such as, for example, ``Projet de fin d'\'etudes'', ``Master thesis'', -% and the like. +% receive foreign names such as, for example, ``Projet de fin d'\'etudes'', ``Master +% thesis'', and the like. % \item An extension package \texttt{toptesi.sty} that contains most of the code % for the real typesetting; it might be used as an extension to the report class file, % although this use is discouraged. @@ -155,19 +154,14 @@ the TOPtesi bundle] % title page fixed information in languages different from Italian. % \item A third extension package \texttt{topcoman.sty} that defines a certain number % of user commands suitable for typesetting technical matters. -% \item A fourth extension package \texttt{trieste.sty} and its accompanying package option -% \texttt{topsiz14.clo} that is used as an option by -% \texttt{toptesi.cls} in order to define a certain number of variations required -% for theses in humanities at the university of Trieste; these variations are not that -% important, but they may be preferred also in other faculties so that the suitable option -% comes handy also in other situations. -% \item The logos of a certain number of Italian universities in \texttt{.eps}, -% \texttt{.jpg}, and \texttt{.pdf} formats; such logos are included for the user sake, but -% the user should pay attention to use them according to the rules and limitations of -% each university and it is strongly advised to look up such regulations in each -% university Web site. +% \item Previous version of this bundle contianed also the logos of a certain number of +% universities; These logos are not distributed anymore because of legal constraints. Every +% one who is working on his/her degree course final report must retrieve the logo of his/her +% university, but s/he should pay attention to use it according to the rules and limitations +% of the university. % \item A documentation file \texttt{toptesi-doc.pdf} written in Italian where every feature -% is explained in detail; essential information is given in this English documentation. +% is explained in detail; this English documentation gives a summary of the necessary +% information and contains the code description. % \end{itemize} % % The above files are complemented with a configuration file that any user may @@ -193,7 +187,7 @@ the TOPtesi bundle] % texts written in non latin alphabets, special symbols for philological mark-up, and % the like; a common typewriter would not be suitable and the quality of the contents % requires professional typesetting; this is why I strongly believe that instructions -% on typesetting styles that refer to the good old times of mechanical typewriters +% on typesetting styles that refer to the ``good old times'' of mechanical typewriters % should be banned. % % Most new commands refer themselves to the information that should be typeset in the @@ -210,7 +204,7 @@ the TOPtesi bundle] % indication. % % \Item[classica] Specifies a general modification of certain details that are -% supposed to be more adequate in the humanities; specifically this option +% supposed to be more adequate in the humanities fields; specifically this option % lets old style numbers to be used for certain numerical pieces of information; % some variations are also introduced in the title page. % @@ -223,18 +217,14 @@ the TOPtesi bundle] % \Item[14pt] Extends the normal size choice to 14 points; it is appreciated % in various fields of humanities, but I would discourage this use in a technical % thesis, where 10 point perhaps is too small, but 11 point or 12 point typesetting -% may be adequate. It is worth mentioning that this option implements the font -% settings in a different way from what is being done with the \texttt{extsizes} package -% bundle; this is why the original \texttt{size14.clo} class option file has been renamed -% \texttt{topsiz14.clo} so as to avoid conflicts with the \texttt{size14.clo} file belonging -% to that bundle. +% may be adequate. % % \Item[autoretitolo] This option modifies the left hand (even numbered) pages % in two side typesetting; normally the even numbered page headings contain % the chapter title, while the odd numbered ones contain the current section title. -% If the \texttt{classica} option has been specified, then with this option it is possible to -% have even numbered headings contain the author's name and the thesis title, while the odd -% numbered ones contain the chapter title. Since the thesis title might be too +% If the \texttt{classica} option has been specified, then with this option it is possible +% to have even numbered headings contain the author's name and the thesis title, while the +% odd numbered ones contain the chapter title. Since the thesis title might be too % long to fit in the header together with the author's name, the |\title| macro % as been modified so as to accept an optional short title, similarly to the % sectioning commands. @@ -293,8 +283,8 @@ the TOPtesi bundle] % \Item[tutore] gets the name of the doctorate tutor; there is no difference with regards % to the \cs{relatore}, but the default phrase ``Tutore'' is printed above % this person's name. -% \Item[TutorName] gets the phrase that describes the tutor position, possibly in a different -% language. +% \Item[TutorName] gets the phrase that describes the tutor position, possibly in a +% different language. % \Item[AdvisorName] gets the string that qualifies the supervisor(s); the default string % is ``Relatore:'' or ``Relatori:'' for the plural; in another language % this command is used to define the string, say, ``Supervisors:'' if the @@ -310,13 +300,13 @@ the TOPtesi bundle] % \Item[terzocandidato] gets the name of the third male author % \Item[terzacandidata] gets the name of the third female author; most often the thesis % author is just one person; but there are some institutions where group -% final works are accepted; it is assumed that the group does not contain more -% than three authors. The specification of the gender allows the software -% to determine the correct labeling phrase in the proper gender and proper -% number. +% final works are accepted; it is assumed that the group does not contain +% more than three authors. The specification of the gender allows the +% software to determine the correct labeling phrase in the proper gender +% and proper number. % For different languages there might be no difference in gender but % there is a difference in the plural ending. -% \Item[CandidateName] gets the string that describes the student status in a foreign +% \Item[CandidateName] gets the string that describes the student status in a foreign % language or even in Italian; the default string is ``Candidato:'' (with % colons) adjusted to masculine or feminine, singular or plural; with the % option \texttt{classica} the string becomes ``Laureando:''; in other @@ -352,12 +342,12 @@ the TOPtesi bundle] % 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. +% given or the file is missing, but typesetting goes on without the +% inclusion of any logo. % \Item[setbindingcorrection] sets up the length to displace the text block to the external -% margin so as to have a wider internal margin to accommodate for the binding -% correction. Its argument is not optional and is used to modify the default -% correction of 7\,mm. +% margin so as to have a wider internal margin to accommodate for the +% binding correction. Its argument is not optional and is used to modify +% the default correction of 7\,mm. % \end{description} % % Since the infix strings are all memorized into control sequences and for each of them it @@ -409,17 +399,16 @@ the TOPtesi bundle] % not. % % Should the required language(s) be missing, the user is forced to read his/her -% distribution -% instructions, so as to find out how to configure his/her system so as to consider the -% languages s/he wants to work with, and finally s/he must recreate the format files and put -% them in the proper places of the standard or the local folder tree. The user is invited to -% carefully investigate on these fine points and to configure the system properly; it would -% be very upsetting using fine software for producing a perfectly typeset thesis that, -% unfortunately, has wrong hyphenation points! Luckily enough, recent distributions of the -% \TeX\ system have all the known hyphenation rules preloaded; in any case even older -% distributions have available command line commands or graphical user interfaces that make -% it easy to perform the tasks of changing the list of preloaded hyphenation rules and -% rebuilding all the format files, moving them to the proper places. +% distribution instructions, so as to find out how to configure his/her system so as to +% consider the languages s/he wants to work with, and finally s/he must recreate the format +% files and put them in the proper places of the standard or the local folder tree. The user +% is invited to carefully investigate on these fine points and to configure the system +% properly; it would be very upsetting using fine software for producing a perfectly typeset +% thesis that, unfortunately, has wrong hyphenation points! Luckily enough, recent +% distributions of the \TeX\ system have all the known hyphenation rules preloaded; in any +% case even older distributions have available command line commands or graphical user +% interfaces that make it easy to perform the tasks of changing the list of preloaded +% hyphenation rules and rebuilding all the format files, moving them to the proper places. % \end{itemize} % % The TOPtesi bundle adds very little to the user commands; nevertheless the package @@ -487,7 +476,7 @@ the TOPtesi bundle] % nowadays the letter ``j'' in Italian is called with the English name % (much shorter than the traditional Italian name ``i~lunga'') and the % indicated spelling ``gei'' is the phonetic Italian rendering of the -% English word. The imaginary unit is not a variable, it is a vector operator, +% English word. The imaginary unit is not a variable, it may be viewed as a vector operator, % so that the ISO regulations require for this symbol an upright type. % % % \Item[eu] inserts the Euler number symbol ``e'' in upright type; since @@ -502,13 +491,13 @@ the TOPtesi bundle] % written for the thesis; for best results it is recommended that the source program has % lines not longer than 80 characters. There exists an external package \texttt{listings}, % that the user might want to load, that does a similar work in a more professional and -% configurable way; our package simpler command might be preferable for its simplicity. +% configurable way; this package simpler command might be preferable for its simplicity. % \end{description} % % All these commands are defined into the separate package \texttt{topcoman.sty} % that can be used as an independent extension package with (possibly) any document class. % -% \section{Format PDF suitable for archiving} +% \section{PDF format suitable for archiving} % Politecnico di Torino as well as many other Italian and foreign universities are % moving towards archiving theses in electronic format, specifically in the PDF one. The % problem of course is: ``Will it be possible to read the archived documents, say, fifty @@ -559,12 +548,12 @@ the TOPtesi bundle] % not already part of your \TeX\ system installation. % \item Install in the main \texttt{pdfx} directory a good version of a color model % profile file, such as, for example, \texttt{ECI-RGB-V1.0.icc} (see in the download -% page of the site \texttt{www.eci.org}). +% page of the web site \texttt{www.eci.org}). % \item If your thesis main file, the one you run your \texttt{pdflatex} on, is named, % say, \texttt{JohnSmithMasterThesis.tex}, prepare in the same directory another file % named \texttt{JohnSmithMasterThesis.xmpdata} that contains the \emph{metadata} % relative to the thesis; pay attention to follow the stringent syntax described and -% exemplified in the \textsf{pdfx} documetation. A minimal set of \emph{metadata} +% exemplified in the \textsf{pdfx} documentation. A minimal set of \emph{metadata} % example would be the following one: % \begin{verbatim} % \Title{Experiments in Trichotetratomy} @@ -576,7 +565,7 @@ the TOPtesi bundle] % and the standard mathematical fonts require some patching that is already included % in this \texttt{ToPtesi} bundle; but it is not excluded that with other fonts similar % patches might be requested. -% \item Use only PNG and JPEG images with RGB color profiles. +% \item Use only PNG and JPEG or PDF images with RGB color profiles. % \item If you include PDF images that contain some text, be sure that the font for % this text is completely embedded in the included file. Should the PDF file come % from an external drawing program be sure to configure that program so that it embeds @@ -586,7 +575,7 @@ 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. @@ -595,7 +584,7 @@ the TOPtesi bundle] % Up to day the realization of a PDF/A conforming file sets forth several problems % that are of great concern for the large Institutions that have thousands of document % a year to archive; it is not a question implied in the free nature of the -% \texttt{pdflatex} program, that, on the opposite, according to our experience has +% \texttt{pdflatex} program, that, on the opposite, according to my experience has % a very high rate of success in producing PDF/A conforming documents. If you stick to % the default \TeX\ system fonts and use this patched version of \texttt{ToPtesi} you % should be able to avoid most problems. @@ -605,14 +594,14 @@ the TOPtesi bundle] % \section{Documented code} % \subsection{The class code} % -% Here begins the usual machinery for stating the required \TeX\ format -% and for sharing some code between the driver and the class part of the code, since they are +% Here begins the usual machinery for stating the required \TeX\ format and for sharing some +% code between the driver and the class part of the code, since they are % supposed to carry the same date and version number, besides the description string. % \begin{macrocode} %<*class> \NeedsTeXFormat{LaTeX2e} \ProvidesClass{toptesi}% -[2011/05/11 v.5.05 Class for typesetting university theses] +[2011/05/25 v.5.50 Class for typesetting university theses] % \end{macrocode} % % The class itself is very simple since it requires just the \texttt{report} @@ -620,12 +609,14 @@ the TOPtesi bundle] % 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} +% 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.}. +% 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 +% options, this language would be appended to the \texttt{babel} package default options % and would become the default language. % \begin{macrocode} \DeclareOption*{\PassOptionsToClass{\CurrentOption}{report}} @@ -640,17 +631,18 @@ the TOPtesi bundle] % \subsection{The \texttt{toptesi.sty} code} % The greatest part of the \texttt{toptesi} class code is saved into a separate file % partly for backward compatibility reasons (before version 3.x \texttt{toptesi} was just -% an extension to the \texttt{report} class) and partly because it might be used as a standaolone -% package, although, take notice, it might conflict with the \texttt{book} class code and certainly -% it is incompatible with the \texttt{article} class. This package must contain its own \TeX\ -% format declaration and might have different version and subversion numbers compared to the -% class file and the other invoked packages that are part of the same bundle. +% an extension to the \texttt{report} class) and partly because it might be used as a +% standalone package, although, take notice, it might conflict with the \texttt{book} class +% code and certainly it is incompatible with the \texttt{article} class. This package must +% contain its own \TeX\ format declaration and might have different version and subversion +% numbers compared to the class file and the other invoked packages that are part of the +% same bundle. % % \begin{macrocode} %<*topsty> \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{toptesi}% -[2011/05/11 v.5.05 Extension for toptesi.cls]% +[2011/05/25 v.5.50 Extension for toptesi.cls]% % \end{macrocode} % % We start by defining the debugging macros; these trace commands and macros @@ -664,16 +656,21 @@ the TOPtesi bundle] % Now we define the specific package options: \texttt{classica} and \texttt{trieste} % are identical; \texttt{trieste} is maintained for backward compatibility. % The option \texttt{14pt} is for choosing a normal size of 14pt; the class option -% file \texttt{topsiz14.clo} has a name that should not conflict with other -% similar class option packages and is in line with the other standard \texttt{size??.clo} -% files. \texttt{chapterbib} allows to set a list of references at the end of each chapter. +% file \texttt{size14.clo} is distributed with the \texttt{extsizes} pacckage and is already +% included in any complete distribution of the major \TeX\ system ones; in previous versions +% of this bundle there was a specific option class file for this large size, but with the +% latest complete distributions available, there is no chance that the existing option file +% is missing. +% +% \texttt{chapterbib} allows to set a list of references at the end of each chapter. % For the options specific to the \texttt{classica} style a couple of boolean variables are % defined and the option definitions set them to the value ``true''. % \begin{macrocode} \newif\if@utoretitolo \@utoretitolofalse \newif\if@ldstyle \@ldstylefalse +\newif\if@xivpt \@xivptfalse % \end{macrocode} - +% % \begin{macrocode} \newlength\T@Pbinding\setlength\T@Pbinding{7mm}\def\setbindingcorrection#1{\T@Pbinding=#1} \newif\if@binding \@bindingfalse @@ -681,9 +678,9 @@ the TOPtesi bundle] \newif\ifchapterbibliography \chapterbibliographyfalse \newif\ifclassica \classicafalse \DeclareOption{cucitura}{\@bindingtrue} -\DeclareOption{14pt}{\input{topsiz14.clo}} +\DeclareOption{14pt}{\@xivpttrue} \DeclareOption{chapterbib}{\chapterbibliographytrue} -\DeclareOption{trieste}{\classicatrue} +\DeclareOption{trieste}{\classicatrue}% Just for backwards compatibility \DeclareOption{classica}{\classicatrue} \DeclareOption{autoretitolo}{\ifclassica\@utoretitolotrue\fi} \DeclareOption{oldstyle}{\ifclassica\@ldstyletrue\fi} @@ -691,14 +688,14 @@ the TOPtesi bundle] % \ProcessOptions\relax % \end{macrocode} -% The \texttt{graphicx} package is loaded by default; it is required for -% inserting the university logo; if the user forgets that this package has already -% been loaded +% The \texttt{graphicx} package is loaded by default; it is required for inserting the +% university logo; if the user forgets that this package has already been loaded % nothing dramatic happens, because the |\usepackage| and |\RequirePackage| macros % perform the necessary tests in order to avoid reloading the same packages again % and again. % \begin{macrocode} \RequirePackage{graphicx} +\if@xivpt\input{size14.clo}\fi % \end{macrocode} % % The text height gets set so as to cope with the standard UNI A4 size; in @@ -808,12 +805,12 @@ the TOPtesi bundle] Use the optional argument of command \string#1\MessageBreak See the LaTeX Handbook (1994) on section C.4.1\MessageBreak}} % \end{macrocode} -% The various tables of contents or figures or tables require some boolean variables to -% be defined; in facts, although the ISO regulations require that every technical report contains -% the list of figures and/or tables, in Italy theses rarely contain these lists; after all: is -% a thesis a technical report? We require also some other boolean variables to handle -% the difference between front matter and main matter; this differences are already defined -% in the \texttt{book} document class, but not in the \texttt{report} one. +% The various tables of contents or figures or tables require some boolean variables to be +% defined; in facts, although the ISO regulations require that every technical report +% contains the list of figures and/or tables, in Italy theses rarely contain these lists; +% after all: is a thesis a technical report? We require also some other boolean variables to +% handle the difference between front matter and main matter; this differences are already +% defined in the \texttt{book} document class, but not in the \texttt{report} one. % \begin{macrocode} \newif\iffigurespage \newif\iftablespage @@ -831,8 +828,8 @@ the TOPtesi bundle] \AtBeginDocument{\frontmatter} % \end{macrocode} % The main matter is automatically established with the first |\chapter| command issued by -% the user; this means that every command that starts a section at the ``chapter'' level within -% the front matter must be executed without an explicit call to |\chapter|. +% the user; this means that every command that starts a section at the ``chapter'' level +% within the front matter must be executed without an explicit call to |\chapter|. % % By default we set to false the boolean variables that control the typesetting of the % list of figures and the list of tables. @@ -970,15 +967,15 @@ the TOPtesi bundle] \brokenpenalty=10000 % \end{macrocode} % -% Here comes a questionable command and/or environment; good typesetting -% requires the baseline skip to be proportioned to the font size, generally it is some 10--20\% -% larger than the font size. In some reasonable instances a wider or a narrower baseline skip +% Here comes a questionable command and/or environment; good typesetting requires the +% baseline skip to be proportioned to the font size, generally it is some 10--20\% larger +% than the font size. In some reasonable instances a wider or a narrower baseline skip % might be required; the \LaTeX\ kernel allows to use the |\linespread| command; % in the previous versions of this bundle a command |\interlinea| and an environment % \texttt{interlinea} were defined so as to allow to set the line spread factor. % The experience has shown that students tend to use this command so as to typeset a poor -% and thin thesis on more pages. Well, every instrument can be judiciously or maliciously used; -% this is one of those double sided instruments. +% and thin thesis on more pages. Well, every instrument can be judiciously or maliciously +% used; this is one of those double sided instruments. % \begin{macrocode} \def\interlinea#1{\linespread{#1}\selectfont} \def\endinterlinea{\par} @@ -994,17 +991,18 @@ the TOPtesi bundle] \@setminipage } % \end{macrocode} -% Since we are at it we define the floating bodies placing parameters; not only the -% values ``here'', ``top of the page'' and ``bottom of the page'', that we set as default ones -% leaving to the user to explicitly specify the ``page of floats'', but also the numerical and -% geometrical parameters that control the float placements. -% These geometrical parameters are critical and everybody has his/her own ideas of -% what are the best values for them. According to my experience these parameters work quite well +% Since we are at it we define the floating bodies placing parameters; not only the values +% ``here'', ``top of the page'' and ``bottom of the page'', that we set as default ones +% leaving to the user to explicitly specify the ``page of floats'', but also the numerical +% and geometrical parameters that control the float placements. +% These geometrical parameters are critical and everybody has his/her own ideas of what are +% the best values for them. According to my experience these parameters work quite well % but I would not suggest them for every kind of typewritten document. % In particular the zero value for the text fraction appears strange, but students have -% the tendency to create large figures (more than large tables) and these tend to clog the figure queue. -% A 100\% space for the top of page figures and a requirement of 0\% text allows large floats -% to exit the queue provided they do not exceed the text height. +% the tendency to create large figures (more than large tables) and these tend to clog the +% figure queue. +% A 100\% space for the top of page figures and a requirement of 0\% text allows large +% floats to exit the queue provided they do not exceed the text height. % \begin{macrocode} \def\fps@figure{htb} \def\fps@table{htb} % @@ -1019,24 +1017,24 @@ the TOPtesi bundle] \def\dbltopfraction{1} \def\dblfloatpagefraction{0} % \end{macrocode} -% One command that the default definition does not satisfy me very much is the caption command; -% actually it is the internal |\@makecaption| macro that performs the job. The point is that -% I prefer a narrower justified caption rather than a caption where the last line is just a short word -% or the right segment of an hyphenated word. If one sets the +%I don't like too much the default definition of the |\caption| command; actually +% it is the internal |\@makecaption| macro that performs the job i don't like. The +% point is that I prefer a narrower justified caption rather than a caption where the last +% line is just a short word or the right segment of an hyphenated word. If one sets the % |\finalhyphendemerits| counter to an incredibly high value, one might succeed % in avoiding hyphenation in the last word of a caption; but this might lead % to a very loose typesetting of the caption paragraph, especially -% if the horizontal box that contains it hardly exceeds the caption width. -% I initially set the caption width (a new length) to the overall text width diminished by 3em; +% if the horizontal box that contains it hardly exceeds the caption width. I initially set +% the caption width (a new length) to the overall text width diminished by 3em; % then if the caption text, inclusive of the caption type string and number, is shorter than -% the text width it is typeset as centered text; if it exceeds the text width -% it is set as a justified paragraph whose line width equals the established caption width; -% but in any case the last line of the paragraph is measured and if it is shorter than one third -% of the caption width, this width is shortened a little bit and the paragraph is set again +% the text width it is typeset as centered text; if it exceeds the text width it is set as a +% justified paragraph whose line width equals the established caption width; but in any case +% the last line of the paragraph is measured and if it is shorter than one third of the +% caption width, this latter width is shortened a little bit and the paragraph is set again % with this shortened caption width; in order to be sure that one iteration is % sufficient, the shrinking of the caption width must be computed according to % the number of lines the paragraph occupies. -% In order to count the number of lines the caption paragraph occupies it is +% In order to count the number of lines the caption paragraph occupies, it is % necessary to recall that the first line occupies a vertical space that equals % |\topskip| while the other lines occupy a vertical space equal to % |\baselineskip|; the latter one is generally larger than |\topskip| therefore @@ -1051,7 +1049,7 @@ the TOPtesi bundle] % and we must remember the presence of this line in our arithmetics. % If the length of the stripped last line is longer that one third of the % caption width, then the vertical box is recomposed by restacking the -% individual lines, but if this last line is shorter than one third of the +% individual lines; on the opposite, if this last line is shorter than one third of the % caption width, this width is recomputed in this way: let $N-1$ be the number % of lines obtained with the integer division, i.e.\ one line less than those % actually contained in the vertical box. Let $x$ be the initial caption @@ -1064,7 +1062,7 @@ the TOPtesi bundle] % space, some words might have been hyphenated in a different way, and so on. % Moreover we do not want a caption that barely exceeds the length of % |\captionwidth| to be retyped into a two line caption width that is about one half -% of the width of the other captions. Therefore we allow for some white space in +% the width of the other captions. Therefore we allow for some white space in % the last line by computing the new caption width with the following formula % \[ y=\frac{(N+0.5)x + x_2}{N+1} \] % \begin{macrocode} @@ -1158,14 +1156,28 @@ the TOPtesi bundle] % old time files might still be around. % % The cryptic code that redefines the comma in math mode establishes that this -% character is a normal math character, instead of a math punctuation mark; -% this should not be necessary with the Italian option for the \texttt{babel} -% package and it is possible that in a future version it will be eliminated. +% character is a normal math character, instead of a math punctuation mark. Actually the +% code that defines the mathematical active comma is a new addition that lets the comma +% perform correctly in its double function (decimal separator and punctuation mark). The +% only point where this code fails is when a list of numbers is typeset: When a numeric list +% must be typeset, such as, for example, $\forall i=0,\,1,\,2,\,3, n$, in the source code +% a space \emph{must} be inserted after every punctuating comma while no space follows a +% decimal comma: for example \verb*+$\forall i=0, 1, 2, 3,n$+. The space before the |n| is +% not necessary (but it wouldn't hurt) beecause |n| is not recognized as a digit, therefore +% the ``intelligent'' comma inserts the necessary space by itself. % % |\topmargin| set to 0pt simply means that the real top margin is 25.4mm, i.e.\ one % inch, since the output offset is one inch by default. % \begin{macrocode} -\mathcode`\,="013B + \DeclareMathSymbol{\virgola}{\mathpunct}{letters}{"3B} + \DeclareMathSymbol{\virgoladecimale}{\mathord}{letters}{"3B} + \AtBeginDocument{\mathcode`\,=\string"8000} + {\catcode `,=\active \gdef,{\futurelet\let@token\m@thcomma}} +\def\m@thcomma{\let\@tempB\virgola +\@tfor\@tempA:=0123456789\do{% +\expandafter\ifx\@tempA\let@token\let\@tempB\virgoladecimale +\@break@tfor\fi}\@tempB} +% \catcode`\^^Z=10 \topmargin 0pt % \end{macrocode} @@ -1175,14 +1187,14 @@ the TOPtesi bundle] % that start these sections depend on the used language. % % Because of this it is necessary to extend the list of infix string definitions provided -% the |\captions|$\langle$\texttt{language}$\rangle$ macros defined by the -% language description files of \texttt{babel}; for this purpose we define a macro for -% adding new items for these two new sectioning commands. This macro receives three arguments: -% the first is the babel language name, the second is the string for the summary name, and finally -% the third is the string for the acknowledgements name; everything is contained within a group -% and only the relevant captions macro is globally redefined. The token register `0' is normally -% for scratch usage, but the fact that its value is restored upon exiting the -% group provides the necessary protection against an involuntary reassignment +% the |\captions|$\langle$\texttt{language}$\rangle$ macros defined by the language +% description files of \texttt{babel}; for this purpose we define a macro for adding new +% items for these two new sectioning commands. This macro receives three arguments: the +% first is the babel language name, the second is the string for the summary name, and +% finally the third is the string for the acknowledgements name; everything is contained +% within a group and only the relevant captions macro is globally redefined. The token +% register `0' is normally for scratch usage, but the fact that its value is restored upon +% exiting the group provides the necessary protection against an involuntary reassignment % to this register. At the same time if a specific language option was not % specified, a warning message is issued, but compilations goes on any way % without the sectioning string names. For being sure no other undefined error @@ -1204,7 +1216,7 @@ Skipping any redefinition\MessageBreak}% }}}% % \end{macrocode} % For Italian and English there are no problems; we provide immediately these extensions -% by means of the newly available macro: +% by means of the newly available macros: % \begin{macrocode} \ExtendCaptions{italian}{Sommario}{Ringraziamenti} \ExtendCaptions{english}{Summary}{Acknowledgements} @@ -1213,8 +1225,8 @@ Skipping any redefinition\MessageBreak}% % default; therefore both caption macros |\captionsitalian| and |\captionsenglish| are % already defined and can be freely extended. For any other language the corresponding % language option must be entered in the class opening statement, otherwise a warning -% is issued but compilation is not stopped. Therefore if, for example, the user wants to write the -% thesis in Spanish, the thesis main file shall start like this: +% is issued but compilation is not stopped. Therefore if, for example, the user wants to +% write the thesis in Spanish, the thesis main file shall start like this: % \begin{verbatim} % \documentclass[...,spanish]{toptesi} % \ExtendCaptions{spanish}{Resumen}{Agradecimientos} @@ -1239,16 +1251,18 @@ Skipping any redefinition\MessageBreak}% \def\english{\selectlanguage{english}}% \let\inglese\english % \end{macrocode} -% At the beginning of the document the following commands are executed; the general macro |\italiano| sets the -% summary and the acknowledgements names in Italian, as the default language; and the |\@chapapp| -% macro is redefined so as to agree with the default language. If a different default language is desired, -% we recall it again, it is necessary to do the following: +% At the beginning of the document the following commands are executed; the general macro +% |\italiano| sets the summary and the acknowledgements names in Italian, as the default +% language; and the |\@chapapp| macro is redefined so as to agree with the default language. +% If a different default language is desired, we recall it again, it is necessary to do the +% following: % \begin{itemize} % \item specify |\english| \emph{after} the |\begin{document}| statement, if English is -% supposed to be the default language, or -% \item specify the language name, other than Italian or English, among the class options; use -% the |\ExtendCaptions| macro for extending the list of sectioning commands infix strings as explained above; -% specify with |\selectlanguage| the new language as the default one \emph{after} the |\begin{document}| statement. +% supposed to be the default language, or +% \item specify the language name, other than Italian or English, among the class options; +% use the |\ExtendCaptions| macro for extending the list of sectioning commands infix +% strings as explained above; specify with |\selectlanguage| the new language as the default +% one \emph{after} the |\begin{document}| statement. % \end{itemize} % \begin{macrocode} \AtBeginDocument{% @@ -1262,7 +1276,6 @@ Skipping any redefinition\MessageBreak}% % \begin{macrocode} \RequirePackage{topfront} \RequirePackage{topcoman} -\def\sf@size{7} % \end{macrocode} % % \subsection{The \texttt{classica} option} @@ -1270,10 +1283,10 @@ Skipping any redefinition\MessageBreak}% % in humanities and the specifications came from Paolo Ciacchi, a student of the University % of Trieste, who was preparing a master thesis in classical Greek philology. The necessity % of the large normal size derived from the necessity of having clear mark-up signs among -% the myriad philologists use, that sometimes let me believe that the philological mark-up -% requires typesetting environments similar to the mathematical ones, since the material to -% be typeset does not form a linear sequence, as in plain text, but a bi-dimensional -% structure as in mathematics. +% the myriad signs philologists use, that sometimes let me believe that the philological +% mark-up requires typesetting environments similar to the mathematical ones, since the +% material to be typeset does not form a linear sequence, as in plain text, but a +% bi-dimensional structure as in mathematics. % % The other requirements involve the title page and I agreed to implement them, since they % are likely to be useful for other universities as well; the effort for localizing this @@ -1405,7 +1418,7 @@ Skipping any redefinition\MessageBreak}% % \end{macrocode} % Here |\annoaccademico| is defined that typesets the infix string corresponding to % ``Anno accademico'' followed by the year range in old style numbers (irrespective -% of the \texttt{oldstyle} option); Commands for the localization are provided so as +% of the \texttt{oldstyle} option); localization commands are provided so as % to set a different string, possibly through the configuration file. In order to set % an adequate en-dash between the old style numbers a new definition is given that % takes care to set the dash at a height above the base line that copes the specific @@ -1432,14 +1445,14 @@ Skipping any redefinition\MessageBreak}% \vrule\@width\dimen@\@height\dimen4\@depth-\dimen\tw@}}} % \end{macrocode} % The footnote rule separator is also longer that the default one. Dealing with notes -% the footnote separator is also changes as well as the footnote skip. But the humanists +% the footnote separator is also changed as well as the footnote skip. But the humanists % like to have also unnumbered notes within numbered ones, as if they were two separate % sets; of course specialized extensions are available on CTAN, but as a poor man solution % the command |\nota| was introduced that inserts a note with a symbol as a note mark; -% the symbol \emph{must} be a mathematica symbol as the dagger or the double dagger; +% the symbol \emph{must} be a mathematical symbol as the dagger or the double dagger; % by default it is the asterisk. At the same time the default definition of the mathematical % asterisk is that of a binary operator; I have experienced that the note symbol gets a -% better positioning if if is declared an ordinary symbol, treated as, say, a letter. This +% better positioning if it is used as an ordinary symbol through |\mathord|. This % is why its math code is redefined. A final unusual request was to be able to put a blank % unnumbered note, as a (rather wide) note separator. The command |\NoteWhiteLine| has to % be used at the end of the text of the preceding note. @@ -1450,8 +1463,7 @@ Skipping any redefinition\MessageBreak}% \kern5.6\p@} \setlength\footnotesep{12\p@} \setlength{\skip\footins}{24\p@ \@plus 4\p@ \@minus 2\p@} -\DeclareMathSymbol{*}{\mathalpha}{symbols}{"03} -\newcommand*\nota[1][*]{% +\newcommand*\nota[1][\mathord{*}]{% \xdef\@thefnmark{\ensuremath{\m@th#1}}\@footnotemark\@footnotetext } \newcommand*{\NoteWhiteLine}{\par\vspace*{-.3\baselineskip}} @@ -1506,7 +1518,7 @@ Skipping any redefinition\MessageBreak}% % all the patches to the macros |\not| and |\mapstochar| that produce problems with % the format, because they have a declared width of 0\,pt; this is no problem for % \texttt{latex} or \texttt{pdflatex}, but it is a problem for the PDF/A format. -% Therefore these command must be replaced by equivalent ones that do not use zero-width +% Therefore these commands must be replaced by equivalent ones that do not use zero-width % glyps. For |\not|, another slash can be used, but in order to have it the right size % in all math typesetting modes it is necessary to have a different command for % every mode; this is achieved with the |\mathchoice| primitive as such: @@ -1545,7 +1557,7 @@ Skipping any redefinition\MessageBreak}% % a PDF/A compliant file; one might need to produce a traditional PDF file, or even a % DVI file, to be converted to the PS format, in order to possibly further transform % it to PDF/A by means of \texttt{ghostscript} (see the details in the -% \texttt{ps2pdf.html} file belonging to the \texttt{ghostscript} documentationx). +% \texttt{ps2pdf.html} file belonging to the \texttt{ghostscript} documentation). % % Finally, if the class option |pdfa| was specified, we load the |pdfx.sty| file % with the suitable option for typesetting a (hopefully) PDF/A conforming file. @@ -1557,40 +1569,42 @@ Skipping any redefinition\MessageBreak}% \ifT@Ppdfa\RequirePackage[a-1b]{pdfx}\fi %</topsty> % \end{macrocode} +% % \subsection{The package file \texttt{topfront.sty}} -% This file is input by \texttt{toptesi}, version 5.x, but it can be used as an -% independent extension package. +% This file is input by \texttt{toptesi}, but it can be used as an +% independent extension package also with other classes. % -% It contains all the definition for the composition of just the title page -% along the style requirements of \texttt{toptesi}, version 5.x. -% It makes use of an optional configuration file where the user can define +% It contains all the definitions for the composition of just the title page +% along the style requirements of \texttt{toptesi}. Since version 5.x +% it makes use of an optional configuration file where the user can define % a lot of default information and all the infix language dependent strings % that are peculiar to this title page. % % This file specifies that it requires the \LaTeXe\ format and identifies itself. Since the % package might be used to extend the performances of other classes, this package does not -% specify any input encoding, assuming that the calling class already provided this information. +% specify any input encoding, assuming that the calling class already provided this +% information. % \begin{macrocode} %<*topfrn> \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{topfront}[2011/04/11 v.5.04 Title page for TOPtesi] +\ProvidesPackage{topfront}[2011/05/25 v.5.50 Title page for TOPtesi] % \end{macrocode} % % The title page information depends on the type of ``thesis' that is being typeset. % The following commands specify the kind of information that is going to be typeset. % Some boolean variables are automatically set by the commands in order to change some -% formatting depending on the kind of thesis. For languages that distinguish -% feminine from masculine adjectives or qualifications some automatic machinery is -% set up in order to format some infix strings in a way that copes with the singular or plural -% forms; in particular when there is a multitude of authors (maximum three) of different gender -% the adjectives or qualifications are set masculine plurals, while when there is just one author -% or the authors are of the same gender the adjectives or qualifications are set according to -% number and gender. Al this is done by setting or resetting the truth value associated to -% the boolean variable \texttt{femminile}. The boolean variable \texttt{dottorato} -% controls the PhD thesis format, while the other variable \texttt{laureatriennale} -% controls the formatting of the bachelor's degree report. All other theses are treated -% as master theses, and in all cases the appropiate infix string is typeset in the title -% page +% formatting depending on the kind of thesis. For languages that distinguish feminine from +% masculine adjectives or qualifications some automatic machinery is set up in order to +% format some infix strings in a way that copes with the singular or plural forms; in +% particular when there is a multitude of authors (maximum three) of different gender the +% adjectives or qualifications are set masculine plurals, while when there is just one +% author or the authors are of the same gender the adjectives or qualifications are set +% according to number and gender. Al this is done by setting or resetting the truth value +% associated to the boolean variable \texttt{femminile}. The boolean variable +% \texttt{dottorato} controls the PhD thesis format, while the other variable +% \texttt{laureatriennale} controls the formatting of the bachelor's degree report. All +% other theses are treated as master theses, and in all cases the appropriate infix string +% is typeset in the title page % \begin{macrocode} \newif\iffemminile \newif\ifdottorato \dottoratofalse @@ -1690,36 +1704,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 si 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, +% 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 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. +% 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. % % \begin{macrocode} \def\sedutadilaurea#1{\getseduta#1 !} @@ -1765,29 +1776,26 @@ Skipping any redefinition\MessageBreak}% % depending on the default language and the configuration file. % % |\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 non -% roman numeral is typeset; the infix string \verb*+Facolt\`a di + may be -% changed with the configuration file depending on the default language. -% 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. -% The |\tutoreaziendale| macro is the last 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 ro name this person also in the title page. +% 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 non roman +% numeral is typeset; the infix string \verb*+Facolt\`a di + may be changed with the +% configuration file depending on the default language. +% 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. +% The |\tutoreaziendale| macro is the last 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 ro name this person also in the title page. % \begin{macrocode} \def\ciclodidottorato#1{\gdef\@ciclo{#1 \@cyclename}}% \def\corsodilaurea#1{\global\dottoratofalse\gdef\@corso{#1}} @@ -1856,18 +1864,19 @@ Skipping any redefinition\MessageBreak}% \newcommand\NomeQuartoTomo[1]{\gdef\QuartoTomo{#1}} % \end{macrocode} % -% Now we can read the configuration file if it exists; in any case what is possibly -% defined or redefined in the configuration file must not be redefined in the following -% Lines and this is why everything is subject to the test |\@ifundefined|. Most default -% definitions are simply ``blank''; the others are in Italian. All of them, except the -% supervisor and candidate strings may be individually be redefined in the configuration file -% or in the preamble. Those that cannot be redefined such as the four ``candidate'' strings -% may be actually redefined through the only |\CandidateName| that should be used in a language depended -% way and with the correct number and gender once for all. The four endings in the Italian -% strings allow to exercise the correct selection only for Italian; a specific test is made -% inside the |\frontespizio| command; because of this the same machinery cannot be used, say, for French -% but may be in the future this feature is resolved in a proper way. The same is true for the supervisor -% and the co-supervisor strings that may be changed once for all with |\AdvisorName| and |\CoAdvisorName|. +% Now we can read the configuration file if it exists; in any case what is possibly defined +% or redefined in the configuration file must not be redefined in the following lines and +% this is why everything is subject to the test |\@ifundefined|. Most default definitions +% are simply ``blank''; the others are in Italian. All of them, except the supervisor and +% candidate strings may be individually be redefined in the configuration file or in the +% preamble. Those that cannot be redefined such as the four ``candidate'' strings may be +% actually redefined through the only |\CandidateName| that should be used in a language +% dependent way and with the correct number and gender once for all. The four endings in the +% Italian strings allow to exercise the correct selection only for Italian; a specific test +% is made inside the |\frontespizio| command; because of this the same machinery cannot be +% used, say, for French but may be in the future this feature is resolved in a proper way. +% The same is true for the supervisor and the co-supervisor strings that may be changed once +% for all with |\AdvisorName| and |\CoAdvisorName|. % \begin{macrocode} \IfFileExists{toptesi.cfg}{\input{toptesi.cfg}}{} % @@ -1977,11 +1986,11 @@ Skipping any redefinition\MessageBreak}% \evensidemargin \oddsidemargin % \end{macrocode} % -% We select the \texttt{myheadings} page style; setting the page counter to zero -% is a remain of old settings, but it does not hurt; the |\null| command inserts a void horizontal box -% into the vertical list; it is useful to act as a block against which the vertical glue pushes -% for setting the subsequent material. The normal font is chosen in case preceding commands did change -% the font characteristics. +% We select the \texttt{myheadings} page style; setting the page counter to zero is a remain +% of old settings, but it does not hurt; the |\null| command inserts a void horizontal box +% into the vertical list; it is useful to act as a block against which the vertical glue +% pushes for setting the subsequent material. The normal font is chosen in case preceding +% commands did change the font characteristics. % \begin{macrocode} \thispagestyle{myheadings}% \null\setcounter{page}{1}% @@ -2011,9 +2020,9 @@ Skipping any redefinition\MessageBreak}% \fi \par\medskip}% % \end{macrocode} -% Further specification: it inserts the field of the PhD research or the degree course name; for example -% it inserts the line ``Philosophy Degree in Applied Tetratricotomy~--~XVI~cycle'' or -% ``Master of Science in Applied Tetratricotomy''. +% Further specification: it inserts the field of the PhD research or the degree course name; +% for example it inserts the line ``Philosophy Degree in Applied Tetratricotomy~--VI~cycle'' +% or ``Master of Science in Applied Tetratricotomy''. % \begin{macrocode} \ifx\@corso\empty \else{\large \ifdottorato @@ -2025,8 +2034,9 @@ Skipping any redefinition\MessageBreak}% \fi \end{center} % \end{macrocode} -% It now centers the name of the report, be it ``Doctoral Dissertation'' or ``Master Thesis'' or whatever; in case -% the command |\materia| was used, it then centers the area which the thesis deals with. +% It now centers the name of the report, be it ``Doctoral Dissertation'' or ``Master +% Thesis'' or whatever; in case the command |\materia| was used, it then centers the area +% which the thesis deals with. % \begin{macrocode} \vfill \begin{center} @@ -2045,7 +2055,8 @@ Skipping any redefinition\MessageBreak}% \fi \end{center} % \end{macrocode} -% Next comes the real title entered with |\titolo| or |\monografia| and the possible subtitle. +% Next comes the real title entered with |\titolo| or |\monografia| and the possible +% subtitle. % \begin{macrocode} \vfill \begin{center} @@ -2059,11 +2070,11 @@ Skipping any redefinition\MessageBreak}% \end{center}% \fi % \end{macrocode} -% If the option \texttt{classica} is in force the thesis might be divided in several volumes; -% apparently these in humanities are often oversized. In this case the |\frontespizio| -% command may be given at the beginning of every volume and the counter \texttt{tomo} is -% stepped up; the volume number is therefore printed in each title page; the infix string -% may be redefined as it was shown above. +% If the option \texttt{classica} is in force the thesis might be divided in several +% volumes; apparently these in humanities are often oversized. In this case the +% |\frontespizio| command may be given at the beginning of every volume and the counter +% \texttt{tomo} is stepped up; the volume number is therefore printed in each title page; +% the infix string may be redefined as it was shown above. % \begin{macrocode} \expandafter \ifx\csname StileTrieste\endcsname\relax @@ -2087,21 +2098,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; +% 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. % \begin{macrocode} \ifx\@logosede\@empty\else \vspace*{\bigskipamount} {\centering \@logosede\par}\fi % \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 od 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 od supervisors. % \begin{macrocode} \vfill \iflaureatriennale @@ -2120,10 +2132,11 @@ Skipping any redefinition\MessageBreak}% \fi \fi % \end{macrocode} -% Similarly the label names for the exam candidates are chosen; in Italian the names are infix strings -% that are selected according the gender and the number; if these labels have to be set in a different language -% it is necessary to define one string that has to be selected by the user according to number and gender. -% The label for the doctorship is left empty. +% Similarly the label names for the exam candidates are chosen; in Italian the names are +% infix strings that are selected according the gender and the number; if these labels have +% to be set in a different language it is necessary to define one string that has to be +% selected by the user according to number and gender. The label for the doctorship is left +% empty. % \begin{macrocode} \ifdottorato \let\@nomecandidato\empty @@ -2144,23 +2157,25 @@ Skipping any redefinition\MessageBreak}% \fi % \end{macrocode} % -% For the names of the supervisor(s) and of the candidate(s) a different approach is used for each one -% of the three categories of theses. If a bachelor degree report is dealt with, the name of the \emph{only} -% candidate is centerd and written in caps-and-small-caps. +% For the names of the supervisor(s) and of the candidate(s) a different approach is used +% for each one of the three categories of theses. If a bachelor degree report is dealt with, +% the name of the \emph{only} candidate is centerd and written in caps-and-small-caps. % \begin{macrocode} \iflaureatriennale \begin{center}% \large\mdseries\textsc{\@author} \end{center}% % \end{macrocode} -% For doctoral and master theses two virtual boxes (actually macros) are filled up so as to align -% the supervisor name(s) and, in second virtual box, the candidate name(s). The label is set in the -% first line with proper number and gender; in the second line the first name, and in the subsequent lines, -% if there are any, the other names. These virtual boxes actually contain a tabular environment each; these -% environments shall be actually typeset when these virtual box macros are executed. If the \texttt{classica} -% option is in force no label is set over the principal advisor name, but a label is set over the co-advisor -% name(s). The type size is also e little different for the \texttt{classica} option. The |\protect| command -% is used to protect the names in case they contain accent macros that might be expanded at the wrong moment. +% For doctoral and master theses two virtual boxes (actually macros) are filled up so as to +% align the supervisor name(s) and, in second virtual box, the candidate name(s). The label +% is set in the first line with proper number and gender; in the second line the first name, +% and in the subsequent lines, if there are any, the other names. These virtual boxes +% actually contain a tabular environment each; these environments shall be actually typeset +% when these virtual box macros are executed. If the \texttt{classica} option is in force no +% label is set over the principal advisor name, but a label is set over the co-advisor +% name(s). The type size is also e little different for the \texttt{classica} option. The +% |\protect| command is used to protect the names in case they contain accent macros that +% might be expanded at the wrong moment. % \begin{macrocode} \else % Per laurea e dottorato con relatori e correlatori... @@ -2205,12 +2220,12 @@ Skipping any redefinition\MessageBreak}% }% % \end{macrocode} % The real typesetting of these name lists takes place now; if the thesis is referred to the -% PhD school one type of layout is used, otherwise the default master thesis layout is used; remember -% that the bachelor degree case has already taken place. For the doctoral dissertation the doctoring -% person name is typeset centered in one line by itself and everything else is set 3em below -% into a three column table extended to the |\hsize|, the first line containing the person labels -% and the second line containing the true names. The central column is used just for spacing, but it does -% not contain anything. +% PhD school one type of layout is used, otherwise the default master thesis layout is used; +% remember that the bachelor degree case has already taken place. For the doctoral +% dissertation the doctoring person name is typeset centered in one line by itself and +% everything else is set 3em below into a three column table extended to the |\hsize|, the +% first line containing the person's qualifiers and the second line containing the true +% names. The central column is used just for spacing, but it does not contain anything. % \begin{macrocode} \ifdottorato \begin{center}\large @@ -2237,9 +2252,10 @@ Skipping any redefinition\MessageBreak}% \end{center} \else % \end{macrocode} -% For the master thesis the two virtual boxes are set one besides the other but skewed -% so that to the right or, respectively, to the left of every name there is enough space for the signatures. -% With the \texttt{classica} option in force the two boxes are simply aligned. +% For the master thesis the two virtual boxes are set one besides the other but skewed so +% that to the right or, respectively, to the left of every name there is enough space for +% the signatures. With the \texttt{classica} option in force the two boxes are simply +% aligned. % \begin{macrocode} \@ifundefined{StileTrieste}{% \begin{flushleft}% @@ -2262,8 +2278,8 @@ Skipping any redefinition\MessageBreak}% \@tutoreaziendale\par} \fi % \end{macrocode} -% All the material now is on the page; we put some more vertical glue and we close -% the page sending it to the output file; the final |\endgroup| closes the |\begingroup| that was +% All the material now is on the page; we put some more vertical glue and we close the page +% sending it to the output file; the final |\endgroup| closes the |\begingroup| that was % set at the beginning of this long macro. % \begin{macrocode} \vfill\par\null @@ -2307,7 +2323,7 @@ Skipping any redefinition\MessageBreak}% %<*topcmn> \NeedsTeXFormat{LaTeX2e} % lavora solo con LaTeX 2e \ProvidesPackage{topcoman}% - [2008/12/15 v.5.00 Additional commands for the TOPtesi bundle] + [2011/05/25 v.5.50 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 @@ -2334,11 +2350,11 @@ Skipping any redefinition\MessageBreak}% % \begin{macrocode} \providecommand{\ensuremath}[1]{\ifmmode#1\else$#1$\fi}% % \end{macrocode} -% The following commands may be already defined; should they be missing they are supplied here. -% The greatest part of them is already defined in the Italian option to the -% \texttt{babel} language; but remember; this package may be used as a stand alone one, without -% the initial call by the \texttt{toptesi} document class, so that the language Italian might -% be undefined. +% The following commands may be already defined; should they be missing they are supplied +% here. The greatest part of them is already defined in the Italian option to the +% \texttt{babel} language; but remember; this package may be used as a stand alone one, +% without the initial call by the \texttt{toptesi} document class, so that the language +% Italian might be undefined. % \begin{macrocode} \providecommand{\ohm}{\ensuremath{{\mathrm{\Omega}}}} \providecommand{\ped}[1]{\ensuremath{_{\mathrm{#1}}}} @@ -2433,192 +2449,6 @@ Skipping any redefinition\MessageBreak}% \DisableFigTabNames %</topcmn> % \end{macrocode} -% \subsection{The class option file \texttt{topsiz14.clo}} -% Among the options available there is the possibility of typesetting the thesis with -% a large normal font size, specifically 14pt. The following file is just a copy of the -% other size??.clo class option files where the font dimensions have been modified so -% as to be coherent whit a normal size of 14pt. There is nothing unusual except that -% the font sizes are taken from the kernel macros where the magic numbers of non -% integer sizes are specified. The baseline skips are substantially the ones taken -% from the 10pt default size and multiplied by 1.44, or those of the 12pt option -% multiplied by 12; in both cases they were rounded to integers most of the times. -% Since the whole bundle works only under \LaTeXe, we deleted all the tests for -% compatibility with \LaTeX\,209 and the corresponding test branches. -% \begin{macrocode} -%<*top14> -\NeedsTeXFormat{LaTeX2e} -\ProvidesFile{topsiz14.clo}% - [2008/12/15 v.5.00 TopTesi 14pt size-option file] -\renewcommand\normalsize{% - \@setfontsize\normalsize\@xivpt{18}% - \abovedisplayskip 14\p@ \@plus3\p@ \@minus7\p@ - \abovedisplayshortskip \z@ \@plus3\p@ - \belowdisplayshortskip 8.5\p@ \@plus3.5\p@ \@minus3\p@ - \belowdisplayskip \abovedisplayskip - \let\@listi\@listI} -\normalsize -\renewcommand\small{% - \@setfontsize\small\@xiipt{14}% - \abovedisplayskip 13\p@ \@plus3\p@ \@minus6\p@ - \abovedisplayshortskip \z@ \@plus3\p@ - \belowdisplayshortskip 7.5\p@ \@plus3.5\p@ \@minus3\p@ - \def\@listi{\leftmargin\leftmargini - \topsep 9\p@ \@plus3\p@ \@minus5\p@ - \parsep 4.5\p@ \@plus2\p@ \@minus\p@ - \itemsep \parsep}% - \belowdisplayskip \abovedisplayskip -} -\renewcommand\footnotesize{% - \@setfontsize\footnotesize\@xipt{13} - \abovedisplayskip 12\p@ \@plus2\p@ \@minus5\p@ - \abovedisplayshortskip \z@ \@plus3\p@ - \belowdisplayshortskip 7\p@ \@plus3\p@ \@minus3\p@ - \def\@listi{\leftmargin\leftmargini - \topsep 6\p@ \@plus2\p@ \@minus2\p@ - \parsep 3\p@ \@plus2\p@ \@minus\p@ - \itemsep \parsep}% - \belowdisplayskip \abovedisplayskip -} -\renewcommand\scriptsize{\@setfontsize\scriptsize\@xpt{12}} -\renewcommand\tiny{\@setfontsize\tiny\@viiipt\@xpt} -\renewcommand\large{\@setfontsize\large\@xviipt{22}} -\renewcommand\Large{\@setfontsize\Large\@xxpt{25}} -\renewcommand\LARGE{\@setfontsize\LARGE\@xxvpt{30}} -\renewcommand\huge{\@setfontsize\huge\@xxvpt{30}} -\let\Huge=\huge -\if@twocolumn - \setlength\parindent{1em} -\else - \setlength\parindent{1.5em} -\fi -\setlength\smallskipamount{3.5\p@ \@plus 1\p@ \@minus 1\p@} -\setlength\medskipamount{7\p@ \@plus 2\p@ \@minus 2\p@} -\setlength\bigskipamount{14\p@ \@plus 4\p@ \@minus 4\p@} -\setlength\headheight{14\p@} -\setlength\headsep {36\p@} -\setlength\topskip {14\p@} -\setlength\footskip{30\p@} -\if@compatibility \setlength\maxdepth{4\p@} \else -\setlength\maxdepth{.5\topskip} \fi - \setlength\@tempdima{\paperwidth} - \addtolength\@tempdima{-2in} - \setlength\@tempdimb{390\p@} - \if@twocolumn - \ifdim\@tempdima>2\@tempdimb\relax - \setlength\textwidth{2\@tempdimb} - \else - \setlength\textwidth{\@tempdima} - \fi - \else - \ifdim\@tempdima>\@tempdimb\relax - \setlength\textwidth{\@tempdimb} - \else - \setlength\textwidth{\@tempdima} - \fi - \fi - \@settopoint\textwidth - \setlength\@tempdima{\paperheight} - \addtolength\@tempdima{-2in} - \addtolength\@tempdima{-1.5in} - \divide\@tempdima\baselineskip - \@tempcnta=\@tempdima - \setlength\textheight{\@tempcnta\baselineskip} -\addtolength\textheight{\topskip} -\if@twocolumn - \setlength\marginparsep{10\p@} -\else - \setlength\marginparsep{10\p@} -\fi -\setlength\marginparpush{7\p@} - \if@twoside - \setlength\@tempdima {\paperwidth} - \addtolength\@tempdima {-\textwidth} - \setlength\oddsidemargin {.4\@tempdima} - \addtolength\oddsidemargin {-1in} - \setlength\marginparwidth {.6\@tempdima} - \addtolength\marginparwidth {-\marginparsep} - \addtolength\marginparwidth {-0.4in} - \else - \setlength\@tempdima {\paperwidth} - \addtolength\@tempdima {-\textwidth} - \setlength\oddsidemargin {.5\@tempdima} - \addtolength\oddsidemargin {-1in} - \setlength\marginparwidth {.5\@tempdima} - \addtolength\marginparwidth {-\marginparsep} - \addtolength\marginparwidth {-0.4in} - \addtolength\marginparwidth {-.4in} - \fi - \ifdim \marginparwidth >2in - \setlength\marginparwidth{2in} - \fi - \@settopoint\oddsidemargin - \@settopoint\marginparwidth - \setlength\evensidemargin {\paperwidth} - \addtolength\evensidemargin{-2in} - \addtolength\evensidemargin{-\textwidth} - \addtolength\evensidemargin{-\oddsidemargin} - \@settopoint\evensidemargin - \setlength\topmargin{\paperheight} - \addtolength\topmargin{-2in} - \addtolength\topmargin{-\headheight} - \addtolength\topmargin{-\headsep} - \addtolength\topmargin{-\textheight} - \addtolength\topmargin{-\footskip} - \addtolength\topmargin{-.5\topmargin} - \@settopoint\topmargin -\setlength\footnotesep{10.4\p@} -\setlength{\skip\footins}{13\p@ \@plus 4\p@ \@minus 2\p@} -\setlength\floatsep {14\p@ \@plus 2\p@ \@minus 4\p@} -\setlength\textfloatsep{20\p@ \@plus 2\p@ \@minus 4\p@} -\setlength\intextsep {16\p@ \@plus 4\p@ \@minus 4\p@} -\setlength\dblfloatsep {16\p@ \@plus 2\p@ \@minus 4\p@} -\setlength\dbltextfloatsep{20\p@ \@plus 2\p@ \@minus 4\p@} -\setlength\@fptop{0\p@ \@plus 1fil} -\setlength\@fpsep{10\p@ \@plus 2fil} -\setlength\@fpbot{0\p@ \@plus 1fil} -\setlength\@dblfptop{0\p@ \@plus 1fil} -\setlength\@dblfpsep{10\p@ \@plus 2fil} -\setlength\@dblfpbot{0\p@ \@plus 1fil} -\setlength\partopsep{3\p@ \@plus 2\p@ \@minus 2\p@} -\def\@listi{\leftmargin\leftmargini - \parsep 5\p@ \@plus2.5\p@ \@minus\p@ - \topsep 10\p@ \@plus4\p@ \@minus6\p@ - \itemsep5\p@ \@plus2.5\p@ \@minus\p@} -\let\@listI\@listi -\@listi -\def\@listii {\leftmargin\leftmarginii - \labelwidth\leftmarginii - \advance\labelwidth-\labelsep - \topsep 5\p@ \@plus2.5\p@ \@minus\p@ - \parsep 2.5\p@ \@plus\p@ \@minus\p@ - \itemsep \parsep} -\def\@listiii{\leftmargin\leftmarginiii - \labelwidth\leftmarginiii - \advance\labelwidth-\labelsep - \topsep 2.5\p@\@plus\p@\@minus\p@ - \parsep \z@ - \partopsep \p@ \@plus\z@ \@minus\p@ - \itemsep \topsep} -\def\@listiv {\leftmargin\leftmarginiv - \labelwidth\leftmarginiv - \advance\labelwidth-\labelsep} -\def\@listv {\leftmargin\leftmarginv - \labelwidth\leftmarginv - \advance\labelwidth-\labelsep} -\def\@listvi {\leftmargin\leftmarginvi - \labelwidth\leftmarginvi - \advance\labelwidth-\labelsep} -%</top14> -% \end{macrocode} % \Finale % \endinput -% -%@OldClaudio: se ci leggi, ricordati di correggere nel file toptesi.cfg fornito di default la riga -%Codice: -%\FacoltaDi{Facolt\`a di }% fatto 2010/05/09 -% -%che è sbagliata: con l'impostazione data, tra "Facoltà di" e il nome della facoltà ci sono due spazi. Probabilmente è meglio che quelle righe siano commentate. La riga 222 di topfront.sty dovrebbe essere -%Codice: -%\@faculty\space\@facname -% -%Ci sono altri \expandafter inutili alle righe 214, 253, 257, 263, 346 e 384. +%
\ No newline at end of file diff --git a/Master/texmf-dist/tex/latex/toptesi/topcoman.sty b/Master/texmf-dist/tex/latex/toptesi/topcoman.sty index 0d5849ccae2..8ec87eacc84 100644 --- a/Master/texmf-dist/tex/latex/toptesi/topcoman.sty +++ b/Master/texmf-dist/tex/latex/toptesi/topcoman.sty @@ -30,7 +30,7 @@ \NeedsTeXFormat{LaTeX2e} % lavora solo con LaTeX 2e \ProvidesPackage{topcoman}% - [2008/12/15 v.5.00 Additional commands for the TOPtesi bundle] + [2011/05/25 v.5.50 Additional commands for the TOPtesi bundle] \newcommand*\DeclareSlantedCapitalGreekLetters{% \mathchardef\Gamma="7100 \mathchardef\Delta="7101 @@ -97,7 +97,7 @@ %% This work consists of this file toptesi.dtx, a README file %% and the derived files: %% -%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, topsize14, +%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, %% toptesi.cfg, and the English documentation toptesi.pdf; %% %% Furthermore the bundle contains the documentation source file toptesi-doc.tex @@ -111,7 +111,7 @@ %% The toptesi.cfg file is a sample of a local configuration file that can be %% freely edited and modified. %% -%% By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files +%% By running pdflatex on toptesi.dtx the user gets the cls, sty and cfg files %% and the English documentation file in pdf format. %% %% The documentation file toptesi-doc.pdf is in Italian; its source file is diff --git a/Master/texmf-dist/tex/latex/toptesi/topfront.sty b/Master/texmf-dist/tex/latex/toptesi/topfront.sty index 3b94a8f1e39..f9cf61213b9 100644 --- a/Master/texmf-dist/tex/latex/toptesi/topfront.sty +++ b/Master/texmf-dist/tex/latex/toptesi/topfront.sty @@ -29,7 +29,7 @@ %% Right brace \} Tilde \~} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{topfront}[2011/04/11 v.5.04 Title page for TOPtesi] +\ProvidesPackage{topfront}[2011/05/25 v.5.50 Title page for TOPtesi] \newif\iffemminile \newif\ifdottorato \dottoratofalse \newif\iflaureatriennale \laureatriennalefalse @@ -404,7 +404,7 @@ %% This work consists of this file toptesi.dtx, a README file %% and the derived files: %% -%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, topsize14, +%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, %% toptesi.cfg, and the English documentation toptesi.pdf; %% %% Furthermore the bundle contains the documentation source file toptesi-doc.tex @@ -418,7 +418,7 @@ %% The toptesi.cfg file is a sample of a local configuration file that can be %% freely edited and modified. %% -%% By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files +%% By running pdflatex on toptesi.dtx the user gets the cls, sty and cfg files %% and the English documentation file in pdf format. %% %% The documentation file toptesi-doc.pdf is in Italian; its source file is diff --git a/Master/texmf-dist/tex/latex/toptesi/topsiz14.clo b/Master/texmf-dist/tex/latex/toptesi/topsiz14.clo deleted file mode 100644 index c618ff1ad5b..00000000000 --- a/Master/texmf-dist/tex/latex/toptesi/topsiz14.clo +++ /dev/null @@ -1,225 +0,0 @@ -%% -%% This is file `topsiz14.clo', -%% generated with the docstrip utility. -%% -%% The original source files were: -%% -%% toptesi.dtx (with options: `top14') -%% ______________________________________________________ -%% The TOPtesi package -%% Copyright (C) 2010 Claudio Beccari -%% All rights reserved -%% -%% License information appended -%% -%% \CharacterTable -%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z -%% Lower-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 -%% Digits \0\1\2\3\4\5\6\7\8\9 -%% Exclamation \! Double quote \" Hash (number) \# -%% Dollar \$ Percent \% Ampersand \& -%% Acute accent \' Left paren \( Right paren \) -%% Asterisk \* Plus \+ Comma \, -%% Minus \- Point \. Solidus \/ -%% Colon \: Semicolon \; Less than \< -%% Equals \= Greater than \> Question mark \? -%% Commercial at \@ Left bracket \[ Backslash \\ -%% Right bracket \] Circumflex \^ Underscore \_ -%% Grave accent \` Left brace \{ Vertical bar \| -%% Right brace \} Tilde \~} - -\NeedsTeXFormat{LaTeX2e} -\ProvidesFile{topsiz14.clo}% - [2008/12/15 v.5.00 TopTesi 14pt size-option file] -\renewcommand\normalsize{% - \@setfontsize\normalsize\@xivpt{18}% - \abovedisplayskip 14\p@ \@plus3\p@ \@minus7\p@ - \abovedisplayshortskip \z@ \@plus3\p@ - \belowdisplayshortskip 8.5\p@ \@plus3.5\p@ \@minus3\p@ - \belowdisplayskip \abovedisplayskip - \let\@listi\@listI} -\normalsize -\renewcommand\small{% - \@setfontsize\small\@xiipt{14}% - \abovedisplayskip 13\p@ \@plus3\p@ \@minus6\p@ - \abovedisplayshortskip \z@ \@plus3\p@ - \belowdisplayshortskip 7.5\p@ \@plus3.5\p@ \@minus3\p@ - \def\@listi{\leftmargin\leftmargini - \topsep 9\p@ \@plus3\p@ \@minus5\p@ - \parsep 4.5\p@ \@plus2\p@ \@minus\p@ - \itemsep \parsep}% - \belowdisplayskip \abovedisplayskip -} -\renewcommand\footnotesize{% - \@setfontsize\footnotesize\@xipt{13} - \abovedisplayskip 12\p@ \@plus2\p@ \@minus5\p@ - \abovedisplayshortskip \z@ \@plus3\p@ - \belowdisplayshortskip 7\p@ \@plus3\p@ \@minus3\p@ - \def\@listi{\leftmargin\leftmargini - \topsep 6\p@ \@plus2\p@ \@minus2\p@ - \parsep 3\p@ \@plus2\p@ \@minus\p@ - \itemsep \parsep}% - \belowdisplayskip \abovedisplayskip -} -\renewcommand\scriptsize{\@setfontsize\scriptsize\@xpt{12}} -\renewcommand\tiny{\@setfontsize\tiny\@viiipt\@xpt} -\renewcommand\large{\@setfontsize\large\@xviipt{22}} -\renewcommand\Large{\@setfontsize\Large\@xxpt{25}} -\renewcommand\LARGE{\@setfontsize\LARGE\@xxvpt{30}} -\renewcommand\huge{\@setfontsize\huge\@xxvpt{30}} -\let\Huge=\huge -\if@twocolumn - \setlength\parindent{1em} -\else - \setlength\parindent{1.5em} -\fi -\setlength\smallskipamount{3.5\p@ \@plus 1\p@ \@minus 1\p@} -\setlength\medskipamount{7\p@ \@plus 2\p@ \@minus 2\p@} -\setlength\bigskipamount{14\p@ \@plus 4\p@ \@minus 4\p@} -\setlength\headheight{14\p@} -\setlength\headsep {36\p@} -\setlength\topskip {14\p@} -\setlength\footskip{30\p@} -\if@compatibility \setlength\maxdepth{4\p@} \else -\setlength\maxdepth{.5\topskip} \fi - \setlength\@tempdima{\paperwidth} - \addtolength\@tempdima{-2in} - \setlength\@tempdimb{390\p@} - \if@twocolumn - \ifdim\@tempdima>2\@tempdimb\relax - \setlength\textwidth{2\@tempdimb} - \else - \setlength\textwidth{\@tempdima} - \fi - \else - \ifdim\@tempdima>\@tempdimb\relax - \setlength\textwidth{\@tempdimb} - \else - \setlength\textwidth{\@tempdima} - \fi - \fi - \@settopoint\textwidth - \setlength\@tempdima{\paperheight} - \addtolength\@tempdima{-2in} - \addtolength\@tempdima{-1.5in} - \divide\@tempdima\baselineskip - \@tempcnta=\@tempdima - \setlength\textheight{\@tempcnta\baselineskip} -\addtolength\textheight{\topskip} -\if@twocolumn - \setlength\marginparsep{10\p@} -\else - \setlength\marginparsep{10\p@} -\fi -\setlength\marginparpush{7\p@} - \if@twoside - \setlength\@tempdima {\paperwidth} - \addtolength\@tempdima {-\textwidth} - \setlength\oddsidemargin {.4\@tempdima} - \addtolength\oddsidemargin {-1in} - \setlength\marginparwidth {.6\@tempdima} - \addtolength\marginparwidth {-\marginparsep} - \addtolength\marginparwidth {-0.4in} - \else - \setlength\@tempdima {\paperwidth} - \addtolength\@tempdima {-\textwidth} - \setlength\oddsidemargin {.5\@tempdima} - \addtolength\oddsidemargin {-1in} - \setlength\marginparwidth {.5\@tempdima} - \addtolength\marginparwidth {-\marginparsep} - \addtolength\marginparwidth {-0.4in} - \addtolength\marginparwidth {-.4in} - \fi - \ifdim \marginparwidth >2in - \setlength\marginparwidth{2in} - \fi - \@settopoint\oddsidemargin - \@settopoint\marginparwidth - \setlength\evensidemargin {\paperwidth} - \addtolength\evensidemargin{-2in} - \addtolength\evensidemargin{-\textwidth} - \addtolength\evensidemargin{-\oddsidemargin} - \@settopoint\evensidemargin - \setlength\topmargin{\paperheight} - \addtolength\topmargin{-2in} - \addtolength\topmargin{-\headheight} - \addtolength\topmargin{-\headsep} - \addtolength\topmargin{-\textheight} - \addtolength\topmargin{-\footskip} - \addtolength\topmargin{-.5\topmargin} - \@settopoint\topmargin -\setlength\footnotesep{10.4\p@} -\setlength{\skip\footins}{13\p@ \@plus 4\p@ \@minus 2\p@} -\setlength\floatsep {14\p@ \@plus 2\p@ \@minus 4\p@} -\setlength\textfloatsep{20\p@ \@plus 2\p@ \@minus 4\p@} -\setlength\intextsep {16\p@ \@plus 4\p@ \@minus 4\p@} -\setlength\dblfloatsep {16\p@ \@plus 2\p@ \@minus 4\p@} -\setlength\dbltextfloatsep{20\p@ \@plus 2\p@ \@minus 4\p@} -\setlength\@fptop{0\p@ \@plus 1fil} -\setlength\@fpsep{10\p@ \@plus 2fil} -\setlength\@fpbot{0\p@ \@plus 1fil} -\setlength\@dblfptop{0\p@ \@plus 1fil} -\setlength\@dblfpsep{10\p@ \@plus 2fil} -\setlength\@dblfpbot{0\p@ \@plus 1fil} -\setlength\partopsep{3\p@ \@plus 2\p@ \@minus 2\p@} -\def\@listi{\leftmargin\leftmargini - \parsep 5\p@ \@plus2.5\p@ \@minus\p@ - \topsep 10\p@ \@plus4\p@ \@minus6\p@ - \itemsep5\p@ \@plus2.5\p@ \@minus\p@} -\let\@listI\@listi -\@listi -\def\@listii {\leftmargin\leftmarginii - \labelwidth\leftmarginii - \advance\labelwidth-\labelsep - \topsep 5\p@ \@plus2.5\p@ \@minus\p@ - \parsep 2.5\p@ \@plus\p@ \@minus\p@ - \itemsep \parsep} -\def\@listiii{\leftmargin\leftmarginiii - \labelwidth\leftmarginiii - \advance\labelwidth-\labelsep - \topsep 2.5\p@\@plus\p@\@minus\p@ - \parsep \z@ - \partopsep \p@ \@plus\z@ \@minus\p@ - \itemsep \topsep} -\def\@listiv {\leftmargin\leftmarginiv - \labelwidth\leftmarginiv - \advance\labelwidth-\labelsep} -\def\@listv {\leftmargin\leftmarginv - \labelwidth\leftmarginv - \advance\labelwidth-\labelsep} -\def\@listvi {\leftmargin\leftmarginvi - \labelwidth\leftmarginvi - \advance\labelwidth-\labelsep} -%% -%% Copyright 2005-2011 Claudio Beccari -%% -%% Distributable under the LaTeX Project Public License, -%% version 1.3c or higher (your choice). The latest version of -%% this license is at: http://www.latex-project.org/lppl.txt -%% -%% This work is "author-maintained" -%% -%% This work consists of this file toptesi.dtx, a README file -%% and the derived files: -%% -%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, topsize14, -%% toptesi.cfg, and the English documentation toptesi.pdf; -%% -%% Furthermore the bundle contains the documentation source file toptesi-doc.tex -%% and the derived file toptesi-doc.pdf. -%% -%% The toptesi-example.tex source file is just an example that shows how -%% to use the various commands; by commenting or uncommenting certain -%% source lines it is possible to typeset different kind of theses and their -%% frontpages. -%% -%% The toptesi.cfg file is a sample of a local configuration file that can be -%% freely edited and modified. -%% -%% By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files -%% and the English documentation file in pdf format. -%% -%% The documentation file toptesi-doc.pdf is in Italian; its source file is -%% another example of how to use toptesi. -%% -%% End of file `topsiz14.clo'. diff --git a/Master/texmf-dist/tex/latex/toptesi/toptesi.cfg b/Master/texmf-dist/tex/latex/toptesi/toptesi.cfg index d84d6095d2a..d60a0fc4cf8 100644 --- a/Master/texmf-dist/tex/latex/toptesi/toptesi.cfg +++ b/Master/texmf-dist/tex/latex/toptesi/toptesi.cfg @@ -60,7 +60,7 @@ %% This work consists of this file toptesi.dtx, a README file %% and the derived files: %% -%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, topsize14, +%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, %% toptesi.cfg, and the English documentation toptesi.pdf; %% %% Furthermore the bundle contains the documentation source file toptesi-doc.tex @@ -74,7 +74,7 @@ %% The toptesi.cfg file is a sample of a local configuration file that can be %% freely edited and modified. %% -%% By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files +%% By running pdflatex on toptesi.dtx the user gets the cls, sty and cfg files %% and the English documentation file in pdf format. %% %% The documentation file toptesi-doc.pdf is in Italian; its source file is diff --git a/Master/texmf-dist/tex/latex/toptesi/toptesi.cls b/Master/texmf-dist/tex/latex/toptesi/toptesi.cls index 033b0a5f506..3b2bf38aed8 100644 --- a/Master/texmf-dist/tex/latex/toptesi/toptesi.cls +++ b/Master/texmf-dist/tex/latex/toptesi/toptesi.cls @@ -30,7 +30,7 @@ \NeedsTeXFormat{LaTeX2e} \ProvidesClass{toptesi}% -[2011/05/11 v.5.05 Class for typesetting university theses] +[2011/05/25 v.5.50 Class for typesetting university theses] \DeclareOption*{\PassOptionsToClass{\CurrentOption}{report}} \ProcessOptions\relax \LoadClass[a4paper]{report} @@ -48,7 +48,7 @@ %% This work consists of this file toptesi.dtx, a README file %% and the derived files: %% -%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, topsize14, +%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, %% toptesi.cfg, and the English documentation toptesi.pdf; %% %% Furthermore the bundle contains the documentation source file toptesi-doc.tex @@ -62,7 +62,7 @@ %% The toptesi.cfg file is a sample of a local configuration file that can be %% freely edited and modified. %% -%% By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files +%% By running pdflatex on toptesi.dtx the user gets the cls, sty and cfg files %% and the English documentation file in pdf format. %% %% The documentation file toptesi-doc.pdf is in Italian; its source file is diff --git a/Master/texmf-dist/tex/latex/toptesi/toptesi.sty b/Master/texmf-dist/tex/latex/toptesi/toptesi.sty index cb92cff2b75..a727632b4a1 100644 --- a/Master/texmf-dist/tex/latex/toptesi/toptesi.sty +++ b/Master/texmf-dist/tex/latex/toptesi/toptesi.sty @@ -30,28 +30,29 @@ \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{toptesi}% -[2011/05/11 v.5.05 Extension for toptesi.cls]% +[2011/05/25 v.5.50 Extension for toptesi.cls]% \def\TRON{\tracingcommands \tw@ \tracingmacros \tw@} \def\TROFF{\tracingcommands\z@ \tracingmacros \z@} \let\TROF\TROFF \newif\if@utoretitolo \@utoretitolofalse \newif\if@ldstyle \@ldstylefalse - +\newif\if@xivpt \@xivptfalse \newlength\T@Pbinding\setlength\T@Pbinding{7mm}\def\setbindingcorrection#1{\T@Pbinding=#1} \newif\if@binding \@bindingfalse \newif\ifT@Ppdfa \T@Ppdfafalse \newif\ifchapterbibliography \chapterbibliographyfalse \newif\ifclassica \classicafalse \DeclareOption{cucitura}{\@bindingtrue} -\DeclareOption{14pt}{\input{topsiz14.clo}} +\DeclareOption{14pt}{\@xivpttrue} \DeclareOption{chapterbib}{\chapterbibliographytrue} -\DeclareOption{trieste}{\classicatrue} +\DeclareOption{trieste}{\classicatrue}% Just for backwards compatibility \DeclareOption{classica}{\classicatrue} \DeclareOption{autoretitolo}{\ifclassica\@utoretitolotrue\fi} \DeclareOption{oldstyle}{\ifclassica\@ldstyletrue\fi} \DeclareOption{pdfa}{\T@Ppdfatrue} \ProcessOptions\relax \RequirePackage{graphicx} +\if@xivpt\input{size14.clo}\fi \textheight 585pt \divide\textheight by \baselineskip \multiply\textheight by \baselineskip @@ -304,7 +305,14 @@ \hsize\columnwidth \@parboxrestore \edef\@currentlabel{\csname p@footnote\endcsname\@thefnmark}% \@makefntext{\rule{\z@}{\footnotesep}\ignorespaces#1\strut}}} -\mathcode`\,="013B + \DeclareMathSymbol{\virgola}{\mathpunct}{letters}{"3B} + \DeclareMathSymbol{\virgoladecimale}{\mathord}{letters}{"3B} + \AtBeginDocument{\mathcode`\,=\string"8000} + {\catcode `,=\active \gdef,{\futurelet\let@token\m@thcomma}} +\def\m@thcomma{\let\@tempB\virgola +\@tfor\@tempA:=0123456789\do{% +\expandafter\ifx\@tempA\let@token\let\@tempB\virgoladecimale +\@break@tfor\fi}\@tempB} \catcode`\^^Z=10 \topmargin 0pt \let\summaryname\empty @@ -331,7 +339,6 @@ Skipping any redefinition\MessageBreak}% } \RequirePackage{topfront} \RequirePackage{topcoman} -\def\sf@size{7} \ifclassica \def\Candidato{Laureando} \def\Candidata{Laureanda} @@ -418,8 +425,7 @@ Skipping any redefinition\MessageBreak}% \kern5.6\p@} \setlength\footnotesep{12\p@} \setlength{\skip\footins}{24\p@ \@plus 4\p@ \@minus 2\p@} -\DeclareMathSymbol{*}{\mathalpha}{symbols}{"03} -\newcommand*\nota[1][*]{% +\newcommand*\nota[1][\mathord{*}]{% \xdef\@thefnmark{\ensuremath{\m@th#1}}\@footnotemark\@footnotetext } \newcommand*{\NoteWhiteLine}{\par\vspace*{-.3\baselineskip}} @@ -478,7 +484,7 @@ Skipping any redefinition\MessageBreak}% %% This work consists of this file toptesi.dtx, a README file %% and the derived files: %% -%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, topsize14, +%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, %% toptesi.cfg, and the English documentation toptesi.pdf; %% %% Furthermore the bundle contains the documentation source file toptesi-doc.tex @@ -492,7 +498,7 @@ Skipping any redefinition\MessageBreak}% %% The toptesi.cfg file is a sample of a local configuration file that can be %% freely edited and modified. %% -%% By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files +%% By running pdflatex on toptesi.dtx the user gets the cls, sty and cfg files %% and the English documentation file in pdf format. %% %% The documentation file toptesi-doc.pdf is in Italian; its source file is |