diff options
author | Karl Berry <karl@freefriends.org> | 2015-11-05 00:01:47 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2015-11-05 00:01:47 +0000 |
commit | 42a577ac94f87e590dbafc8bcc466fbf1cf7618c (patch) | |
tree | 98024247df5a3207bf2c4a0158fd5b7c00258f27 /Master/texmf-dist/doc/latex/toptesi | |
parent | e6cb7eab17b3ef76d3f96c8e23782a91190102a8 (diff) |
toptesi (4nov15)
git-svn-id: svn://tug.org/texlive/trunk@38777 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/toptesi')
-rw-r--r-- | Master/texmf-dist/doc/latex/toptesi/FrontespizioLandscape.pdf | bin | 0 -> 108158 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/toptesi/README | 10 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/toptesi/manifest.txt | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.pdf | bin | 878299 -> 879224 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.tex | 464 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/toptesi/toptesi.pdf | bin | 385776 -> 386686 bytes |
6 files changed, 241 insertions, 235 deletions
diff --git a/Master/texmf-dist/doc/latex/toptesi/FrontespizioLandscape.pdf b/Master/texmf-dist/doc/latex/toptesi/FrontespizioLandscape.pdf Binary files differnew file mode 100644 index 00000000000..aa4e48455e5 --- /dev/null +++ b/Master/texmf-dist/doc/latex/toptesi/FrontespizioLandscape.pdf diff --git a/Master/texmf-dist/doc/latex/toptesi/README b/Master/texmf-dist/doc/latex/toptesi/README index 6d26c70cd9e..72815abae58 100644 --- a/Master/texmf-dist/doc/latex/toptesi/README +++ b/Master/texmf-dist/doc/latex/toptesi/README @@ -1,5 +1,5 @@ -TOPtesi bundle version 5.86 of 2014/12/13 -Copyright 2014 Claudio Beccari +TOPtesi bundle version 5.86 of 2015 +Copyright 2015 Claudio Beccari LaTeX Project Public Licence LPPL v.1.3 (or later) The TOPtesi bundle contains everything is needed for typesetting a @@ -20,11 +20,11 @@ This version of TOPtesi is intended to be compliant also with XeLaTeX and LuaLaTeX; the documentation explains also how to obtain PDF/A-1b archivable files from pdfLaTeX, XeLaTeX, and LuaLaTeX. -Version 5.81 has been enhanced with some more class options that allow +Version 5.86 has been enhanced with some more class options that allow TOPtesi to be used with external packages for typesetting the title page with different styles. -Version 5.82 has a completely enhanced and redone Italian documentation file +Version 5.86 has a completely enhanced and redone Italian documentation file toptesi-it-xetex.pdf. For installation, if the package is not already installed in your @@ -53,7 +53,7 @@ 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. Remember to refresh the filename database! -If the package is already installed (it is with a complete TeXLive or +If the package is already installed (it is with complete TeXLive or complete MiKTeX distributions), the texmf folder should be the <prefix>/texmf-dist system one. But in this case you don't need to decompress anything and move files around. Possibly check if the diff --git a/Master/texmf-dist/doc/latex/toptesi/manifest.txt b/Master/texmf-dist/doc/latex/toptesi/manifest.txt index d88db4bd7d3..5c2645af4e7 100644 --- a/Master/texmf-dist/doc/latex/toptesi/manifest.txt +++ b/Master/texmf-dist/doc/latex/toptesi/manifest.txt @@ -1,5 +1,5 @@ manifest.txt (TOPtesi version 5.86) -Copyright 2008-2014 Claudio Beccari +Copyright 2008-2015 Claudio Beccari This work may be distributed and/or modified under the conditions of the LaTeX Project Public License, either version 1.3 of this license or diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.pdf Binary files differindex cdd347f935a..b3f6f77416f 100644 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.pdf +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.pdf diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.tex b/Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.tex index db814e74dc3..f64458ea0db 100644 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.tex +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.tex @@ -20,7 +20,7 @@ % http://www.latex-project.org/ % \documentclass[12pt,twoside]{toptesi} -\ProvidesFile{toptesi-it.tex}[2014 v,099c] +\ProvidesFile{toptesi-it.tex}[2015 v.0.99d] \setmainfont[Ligatures=TeX]{TeX Gyre Termes} \setsansfont[Ligatures=TeX, Scale=MatchLowercase]{TeX Gyre Heros} \setmonofont{UM Typewriter} @@ -110,7 +110,7 @@ This text describes how to typeset a university master thesis, or the bachelor f \italiano \ringraziamenti -Ringrazio gli studenti del Politecnico di Torino che mi hanno sollecitato a mettere la mia esperienza a loro disposizione per predisporre e rendere disponibile il software necessario per preparare le loro tesi, monografie o dissertazioni con la qualità che solo \pdfLaTeX, \XeLaTeX\ o \LuaLaTeX\ riescono a produrre\footnote{Questa particolare composizione è stata eseguita con \XeLaTeX. Questo motore di composizione presenta numerosi vantaggi su \prog{pdflatex} per quel che riguarda l'uso dei font, anche per la matematica, ma non è ancora (2014) in grado di produrre l'uscita direttamente nel formato PDF, anche se apparentemente lo fa. In realtà la sua uscita è in un formato intermedio che viene poi trasformato automaticamente in PDF. L'esperienza mi insegna che in realtà le limitazioni di \XeLaTeX\ sono pochissime e, con la classe \pack{toptesi}, quella forse più importante, ma facilmente risolvibile, riguarda il formato PDF archiviabile che non è ottenibile direttamente, tanto che bisogna procedere come indicato nel paragrafo~\ref{sec:XePDFA}.}. +Ringrazio gli studenti del Politecnico di Torino che mi hanno sollecitato a mettere la mia esperienza a loro disposizione per predisporre e rendere disponibile il software necessario per preparare le loro tesi, monografie o dissertazioni con la qualità che solo \pdfLaTeX, \XeLaTeX\ o \LuaLaTeX\ riescono a produrre\footnote{Questa particolare composizione è stata eseguita con \XeLaTeX. Questo motore di composizione presenta numerosi vantaggi su \prog{pdflatex} per quel che riguarda l'uso dei font, anche per la matematica, ma non è ancora (2015) in grado di produrre l'uscita direttamente nel formato PDF, anche se apparentemente lo fa. In realtà la sua uscita è in un formato intermedio che viene poi trasformato automaticamente in PDF. L'esperienza mi insegna che in realtà le limitazioni di \XeLaTeX\ sono pochissime e, con la classe \pack{toptesi}, quella forse più importante, ma facilmente risolvibile, riguarda il formato PDF archiviabile che non è ottenibile direttamente, tanto che bisogna procedere come indicato nel paragrafo~\ref{sec:XePDFA}.}. \figurespagetrue \tablespagetrue @@ -130,8 +130,8 @@ Detto in altre parole, non cominciate nemmeno a leggere questo manuale e non usa \item[Formato] Nel mondo \TeX\ la parola \emph{formato}, in inglese \emph{format}, ha almeno tre significati; i principali significati sono i seguenti. \begin{description} \item[Forma del mark up] Con questo significato ci si riferisce al file con estensione \file{.fmt} che contiene la traduzione in linguaggio macchina dell'insieme di macro che definiscono il mark up specifico del linguaggio usato; qui potrebbero interessare i file di formato \file{pdflatex.fmt}, \file{xelatex.fmt}, \file{lualatex,fmt}; ne esistono diversi altri. -\item[Forma della pagina del testo composto] Le varie carte disponibili vengono vendute in diversi formati; per esempio A4 (201\unit{mm} per 297\unit{mm}), B5 (176\unit{mm} per 210\unit{mm}), eccetera. Si può usare questa parola anche per riferirsi alla forma della gabbia del testo e al layout della pagina composta tipograficamente. -\item[Codifica di registrazione delle immagini] La parola formato viene usata per specificare in realtà il modo di codificare una immagine, e si parla del formato JPEG, del formato PDF, eccetera. Esistono formati vettoriali e formati raster (o a matrici di punti, o bitmapped); i formati raster possono essere \emph{lossless} oppure \emph{lossy}; in questo caso la perdita, da cui il prefisso ``loss'', si riferisce al modo di comprimere l'informazione dell'immagine: la compressione senza perdita permette di recuperare esattamente l'immagine di partenza, mentre la compressione con perdita permette di comprimere di più ma a spese di una approssimazione nel recupero dell'immagine di partenza; il formato PNG è di tipo lossless; il formato JPG o JPEG è lossy. +\item[Forma della pagina del testo composto] Le varie carte disponibili vengono vendute in diversi formati; per esempio A4 (210\unit{mm} per 297\unit{mm}), B5 (176\unit{mm} per 210\unit{mm}), eccetera. Si può usare questa parola anche per riferirsi alla forma della gabbia del testo e al layout della pagina composta tipograficamente. +\item[Codifica di registrazione delle immagini] La parola formato viene usata per specificare in realtà il modo di codificare una immagine, e si parla del formato JPEG, del formato PDF, eccetera. Esistono formati vettoriali e formati raster (o a matrici di punti, o bitmapped); i formati raster possono essere \emph{lossless} oppure \emph{lossy}; in questo caso la perdita, da cui il prefisso ``loss'', si riferisce al modo di comprimere l'informazione dell'immagine: la compressione senza perdita permette di recuperare esattamente l'immagine di partenza, mentre la compressione con perdita permette di comprimere di più ma a spese di una approssimazione nel recupero dell'immagine di partenza; il formato PNG è di tipo lossless; il formato JPG (o JPEG) è lossy. \end{description} \end{description} @@ -154,7 +154,7 @@ Come tutti i pacchetti che estendono la funzionalità di \LaTeX, TOPtesi definis Prima di usare TOPtesi si esaminino i semplici esempi contenuti nei file accessori di questo pacchetto: \file{toptesi-example.pdf}, \file{toptesi-example-xetex.pdf}, \file{topfront.example.pdf}, \texttt{toptesi-example-con-frontespizio.pdf}\index{file!toptesi-example-con-frontespizio.pdf@\texttt{toptesi\discretionary{-}{}{-}example\discretionary{-}{}{-}con\discretionary{-}{}{-}frontespizio.pdf}}. Si potrà vedere se l'impaginazione aggrada oppure se si desidera un'altra impaginazione; in questo secondo caso ci si rivolga ad altre classi e ad altri pacchetti: in rete non è difficile usare un motore di ricerca per trovare il pacchetto \pack{frontespizio}, le classi \class{sapthesis}, \class {suftesi}, \class{TesiModerna}, \class{TesiClassica} e diverse altre classi prodotte specialmente nel mondo angloamericano e ancor meno adatte ad una personalizzazione multilingue. Alcune di queste classi sono dotate di eccellenti file di documentazione, altre sono usabili grazie a ``template'' o modelli di tesi scritte facendo uso di testo fittizio, ma tali da rendere immediatamente l'idea di come usare quei software. -Volendo, anche i file sorgente di questi esempi d'uso del pacchetto TOPtesi, elencati sopra con i nomi dei corrispondenti file PDF, possono essere usati come modelli; persino il file sorgente di questo manuale può essere usato come modello; basta cercare nelle cartelle dell'installazione di TOPtesi i file \file{.tex}, copiarseli in una propria cartella personale, cambiare loro il nome (attenzione, questo è importantissimo) e modificarne il contenuto a proprio piacimento. Con un minimo di attenzione si possono eliminare quelle parti che non servono; si possono modificare le opzioni della classe, si possono compilare con diversi motori di tipocomposizione del sistema \TeX. Non è forse fuori luogo sottolineare che l'uso dei modelli può essere molto utile per cominciare, ma fa perdere di vista il fatto che \LaTeX\ può fare molte più cose di quelle che si inseriscono solitamente nei modelli.\enlargethispage{-1\baselineskip} +Volendo, anche i file sorgente di questi esempi d'uso del pacchetto TOPtesi, elencati sopra con i nomi dei corrispondenti file PDF, possono essere usati come modelli; persino il file sorgente di questo manuale può essere usato come modello; basta cercare nelle cartelle dell'installazione di TOPtesi i file \file{.tex}, copiarseli in una propria cartella personale, cambiare loro il nome (attenzione, questo è importantissimo) e modificarne il contenuto a proprio piacimento. Con un minimo di attenzione si possono eliminare quelle parti che non servono; si possono modificare le opzioni della classe, si possono compilare con diversi motori di tipocomposizione del sistema \TeX. Non è forse fuori luogo sottolineare che l'uso dei modelli può essere molto utile per cominciare, ma fa perdere di vista il fatto che \LaTeX\ può fare molte più cose di quelle che si inseriscono solitamente negli esempi.\enlargethispage{-1\baselineskip} \section{Cosa leggere} Un manuale di solito non è da leggere dalla prima pagina all'ultima. Se ne possono saltare diverse sezioni, ma è bene sapere che cosa si salta, quindi una rapida sfogliata delle pagine che si saltano non fa male. @@ -167,9 +167,9 @@ Conviene leggere l'uso dei loghi nel paragrafo~\ref{ssec:loghi}, perché TOPtesi Il paragrafo~\ref{sec:cominciare} espone come impostare inizialmente il documento principale della tesi e di come frazionarne il contenuto in diversi file. Non esiste un unico metodo e i vari metodi presentano vantaggi e svantaggi. Conviene conoscere bene questi metodi e i loro pro e contro, anche perché nell'uso elementare di \LaTeX\ questi concetti non vengono mai affrontati. -Il paragrafo~\ref{sec:codifica} è fondamentale; disporre di un editor che salva i file sorgente con una certa codifica e poi cercare di compilare quei file con \LaTeX\ impostato per una codifica diversa, vuol dire combinare pasticci inenarrabili; in questo manuale si consiglia di usare sia per l'editor si per \LaTeX\ la codifica \opt{utf8} ma è i laureando che deve sceglierla in base alle caratteristiche del suo software e ai programmai che intende usare per la compilazione. Tutti e tre i programmi principali di composizione, \pdfLaTeX, \XeLaTeX, e \LuaLaTeX\ funzionano bene con la codifica \opt{utf8}; \pdfLaTeX\ funziona anche con altre codifiche; gli editor un po' datati non funzionano con la codifica \opt{utf8}, quindi è evidente che le varie situazioni richiedono impostazioni attente e accurate. Se fosse necessario, l'argomento codifiche può essere approfondito anche su altri testi liberi, per esempio la guida tematica che si trova nella sezione documentazione dell'associazione \GuIT, in \url{http://guitex.org/home/images/doc/GuideGuIT/introcodifiche.pdf} dal titolo \emph{Introduzione alle codifiche in entrata e in uscita}. +Il paragrafo~\ref{sec:codifica} è fondamentale; disporre di un editor che salva i file sorgente con una certa codifica e poi cercare di compilare quei file con \LaTeX\ impostato per una codifica diversa, vuol dire combinare pasticci inenarrabili; in questo manuale si consiglia di usare sia per l'editor si per \LaTeX\ la codifica \opt{utf8} ma è i laureando che deve sceglierla in base alle caratteristiche del suo software e ai programmi che intende usare per la compilazione. Tutti e tre i programmi principali di composizione, \pdfLaTeX, \XeLaTeX, e \LuaLaTeX\ funzionano bene con la codifica \opt{utf8}; \pdfLaTeX\ funziona anche con altre codifiche; gli editor un po' datati non funzionano con la codifica \opt{utf8}, quindi è evidente che le varie situazioni richiedono impostazioni attente e accurate. Se fosse necessario, l'argomento codifiche può essere approfondito anche su altri testi liberi, per esempio la guida tematica che si trova nella sezione documentazione dell'associazione \GuIT, in \url{http://guitex.org/home/images/doc/GuideGuIT/introcodifiche.pdf} dal titolo \emph{Introduzione alle codifiche in entrata e in uscita}. -Il paragrafo~\ref{sec:lingue} descrive com impostare il file sorgente della tesi per comporre il testo in diverse lingue o per impostare una lingua principale diversa dall'italiano. È essenziale per comporre tesi in programmi di doppia laurea. Infatti TOPtesi è stato creato anche per poter soddisfare le esigenze che un numero sempre maggiore di laureandi incontrano quando partecipano a programmi di doppio titolo con i vari programmi europei Erasmus, Life Long Learning, Erasmus Mundus, eccetera; le tesi svolte in questi percorsi solitamente richiedono l'uso di altre lingue oltre o in sostituzione dell'italiano. TOPtesi viene incontro a queste esigenze sia grazie all'uso di \LaTeX\ o \XeLaTeX\ o \LuaLaTeX\ che sono in grado di gestire una ottantina di lingue, sia perché quasi tutti i comandi che devono essere usati per il frontespizio e per molte strutture interne sono completamente configurabili in accordo con le lingue usate. Il paragrafo~\ref{sec:lingue} provvede a spiegare come eseguire queste configurazioni. +Il paragrafo~\ref{sec:lingue} descrive come impostare il file sorgente della tesi per comporre il testo in diverse lingue o per impostare una lingua principale diversa dall'italiano. È essenziale per comporre tesi in programmi di doppia laurea. Infatti TOPtesi è stato creato anche per poter soddisfare le esigenze che un numero sempre maggiore di laureandi incontrano quando partecipano a programmi di doppio titolo con i vari programmi europei Erasmus, Life Long Learning, Erasmus Mundus, eccetera; le tesi svolte in questi percorsi solitamente richiedono l'uso di altre lingue oltre o in sostituzione dell'italiano. TOPtesi viene incontro a queste esigenze sia grazie all'uso di \LaTeX\ o \XeLaTeX\ o \LuaLaTeX\ che sono in grado di gestire una ottantina di lingue, sia perché quasi tutti i comandi che devono essere usati per il frontespizio e per molte strutture interne sono completamente configurabili in accordo con le lingue usate. Il paragrafo~\ref{sec:lingue} provvede a spiegare come eseguire queste configurazioni. Per la questione codifiche e la questione lingue, che sono due aspetti che hanno forti collegamenti, è opportuno tenere presenti le seguenti considerazioni. @@ -190,7 +190,7 @@ Vale la pena di elencare i pacchetti già caricati dalla classe \class{toptesi}, % \Item[graphicx] serve per gestire diverse funzioni grafiche e per l'inclusione di file grafici esterni, come fotografie, disegni, e simili. % -\Item[etoolbox] è una pacchetto di servizio, le cui funzionalità possono essere usate anche da un laureando molto competente; questo pacchetto agevola moltissimo la gestione dei file di classe e di quelli di estensione. Se il laureando ha sufficiente padronanza di \LaTeX, può definirsi altri comandi specifici per la sua tesi, sfruttando le funzionalità avanzate di questo pacchetto. +\Item[etoolbox] è un pacchetto di servizio, le cui funzionalità possono essere usate anche da un laureando molto competente; questo pacchetto agevola moltissimo la gestione dei file di classe e di quelli di estensione. Se il laureando ha sufficiente padronanza di \LaTeX, può definirsi altri comandi specifici per la sua tesi, sfruttando le funzionalità avanzate di questo pacchetto. % \Item[topfront] contiene i comandi specifici per comporre il frontespizio; potrebbe venire anche usato da solo con un'altra classe; mediante l'opzione \opt{noTOPfront} per la classe \class{toptesi} se ne può inibire il caricamento, così che l'operatore possa comporre il frontespizio con altri pacchetti esterni, o possa comporlo a modo suo sfruttando come meglio crede l'ambiente \env{titlepage}. La classe \class{toptesi} carica questo modulo solo durante l'esecuzione del comando \verb|\begin{document}|, quindi nessun comando che abbia a che fare con il frontespizio può essere usato nel preambolo, in quanto \pack{topfront} non è ancora stato letto e quindi i comandi non sono ancora stati definiti. @@ -205,9 +205,9 @@ La classe \class{toptesi} carica questo modulo solo durante l'esecuzione del com % \Item[polyglossia] viene caricato solo se la tesi viene composta con \XeLaTeX\ o \LuaLaTeX. L'italiano viene specificato come lingua principale, e l'inglese come altra lingua. % -\Item[pdfx] viene caricato solo se è stata specificata l'opzione \opt{pdfa} per produrre un file possibilmente conforme all formato PDF/A. +\Item[pdfx] viene caricato solo se è stata specificata l'opzione \opt{pdfa} per produrre un file possibilmente conforme al formato PDF/A. % -\Item[hyperref] serve per comporre i collegamenti ipertestuali. Non è il caso di preoccuparsi di quando TOPtesi carica \pack{hyperref} perché ci pensa lui a ritardarne la chiamata al momento di iniziare la composizione del documento. Si veda più avanti per sapere come e quando eventualmente configurare l\pack{hyperref} con opzioni. +\Item[hyperref] serve per comporre i collegamenti ipertestuali. Non è il caso di preoccuparsi di quando TOPtesi carica \pack{hyperref} perché ci pensa lui a ritardarne la chiamata al momento di iniziare la composizione del documento. Si veda più avanti per sapere come e quando eventualmente configurare \pack{hyperref} con le sue opzioni. \end{description} Il laureando è tenuto a documentarsi su ciascuno di quei pacchetti; normalmente egli dispone di tutta la documentazione di cui necessita già nella sua installazione del sistema TeX\ completo e aggiornato; basta che apra un terminale e vi scriva dentro; @@ -218,7 +218,7 @@ e, dopo aver premuto il tasto \fbox{invio}, sullo schermo del suo PC si apre la Conoscere l'elenco di questi pacchetti è importante proprio per non ricaricarli e per evitare conflitti quando si specificano opzioni diverse. -\section{Pacchetti che il laureando deve caricare personalmente} +\section[Pacchetti che il laureando deve caricare personalmente]{\fontsize{16.5}{16.5}\selectfont Pacchetti che il laureando deve caricare personalmente} Si noti: non sono precaricati i pacchetti \pack{inputenc} per definire la codifica d'entrata; \pack{fontenc} per definire la codifica dei font di uscita; e non è preimpostato nessun font particolare da usare per la composizione della tesi. @@ -250,7 +250,7 @@ Il laureando non dedichi invece troppo tempo alla lettura del paragrafo~\ref{sec \section{Modelli di tesi e di frontespizi} -Ricordo infine che il pacchetto TOPtesi contiene anche un certo campionario di modelli di tesi e di frontespizi di vario genere, che possono essere composti con diversi motori di composizione. Il laureando può servirsene in modo molto semplice: copia il file di esempio nella propria cartella di lavoro, gli cambia nome e poi modifica il modello commentando o de-commentando alcune riche, togliendo parti che non servono; per esempio vi ho messo un piccolo esempio di ringraziamenti, ma i ringraziamenti non andrebbero mai usati -- vedi più avanti perché; vi ho messo un piccolo esempio di dedica, ma le dediche son superflue nel 99\% dei casi; eccetera. +Ricordo infine che il pacchetto TOPtesi contiene anche un certo campionario di modelli di tesi e di frontespizi di vario genere, che possono essere composti con diversi motori di composizione. Il laureando può servirsene in modo molto semplice: copia il file di esempio nella propria cartella di lavoro, gli cambia nome e poi modifica il modello commentando o de-commentando alcune riche, togliendo parti che non servono; per esempio vi ho messo un piccolo esempio di ringraziamenti, ma i ringraziamenti non andrebbero mai usati -- vedi più avanti perché; vi ho messo un piccolo esempio di dedica, ma le dediche sono superflue nel 99\% dei casi; eccetera. Ripulito il preambolo delle cose che non servono, e scelte le righe ritenute necessarie, basta cambiare i nomi di fantasia che ho usato e i testi di fantasia che ho inserito per ottenere lo schema della tesi, che va poi riempito del contenuto relativo alla tesi che si vuole effettivamente comporre. @@ -355,8 +355,8 @@ abituati anche voi ai programmi commerciali che consentono la ``composizione sincrona''; vi consentono di vedere subito sullo schermo il frutto del vostro lavoro. Per ottenere questo risultato questi programmi hanno necessariamente rinunciato a diverse -funzioni, badando invece a presentare il testo composto sullo -schermo con la massima velocità. +funzioni, badando invece a presentare sullo schermo con la massima +velocità il testo composto. \LaTeX\ richiede che voi scriviate un testo non formattato in puri caratteri ASCII\footnote{In realtà potete scrivere con qualunque set di caratteri e con qualunque \emph{codepage}; oggi poi è possibile avere editor testuali che usano la codifica UNICODE, che consente, essendone capaci, di scrivere anche in cinese. Il documento che state leggendo è stato composto usando un file sorgente codificato in UNICODE; non contiene caratteri cinesi, ma avrei potuto farlo se conoscessi il cinese!}, ma marcato con un particolare sistema di @@ -394,17 +394,17 @@ Disponendo di TeX Live sulle tre piattaforme che sono solito usare, Windows XP, \item Siete degli utenti di Linux; in questo caso siete particolarmente fortunati perché il sistema \TeX\ fa parte integrante di qualunque distribuzione, anche se non viene installato di default; vi basta inserire il disco di installazione o vi basta connettervi in rete e invocare uno dei vari programmi come \prog{apt-get}, \prog{rpm}, \prog{yast} o\dots\ per scaricare tutto quanto vi serve e per configurare l'installazione. Ricordatevi che Linux è un po' più ``ruspante'' di Windows, e quindi la configurazione richiede un po' più di attenzione e di smanettamento con la riga di comando; ma a questo, in qualità di ``pinguini doc'', ci siete abituati; in compenso avete il beneficio di avere tutto quanto il software già predisposto fin dalla nascita per macchine UNIX e Linux e quindi evitate tutti i (pochi) piccoli bug che si incontrano quando le cose sono tradotte per altri sistemi. -Fate solo attenzione alle distribuzioni Debian; sono eccellenti e ne è garantita la compatibilità con lo specifico sistema operativo, ma solitamente sono in ritardo di un paio di anni rispetto alle versioni aggiornate pubblicate dal \TeX\ Users Group! Se appena potete installate la distribuzione TeX Live completa scaricata dal sito \url{http://www.tug.org/ctan.html} ufficiale. Esiste in rete un testo intitolato \emph{texlive-ubuntu.pdf}\footnote{Questo testo è stato scritto nel 2010 per installare TeX Live su Ubuntu, che è di tipo Debian, ma ci sono anche le istruzioni per Fedora e OpenSuse; con piccole varianti sono istruzioni che vanno bene per qualunque macchina Linux.}, che trovate con qualunque motore di ricerca; vi istruisce su come installare TeX Live fresco di giornata (e aggiornabile sistematicamente come detto sopra per le macchine Windows) a fianco della distribuzione Debian di TeX Live; quest'ultima serve per soddisfare le dipendenze di altri programmi Debian; la prima, invece, vi serve per lavorare davvero. +Fate solo attenzione alle distribuzioni Debian; sono eccellenti e ne è garantita la compatibilità con lo specifico sistema operativo, ma solitamente sono in ritardo di alcuni mesi, in passato di un paio di anni, rispetto alle versioni aggiornate pubblicate dal \TeX\ Users Group! Se appena potete installate la distribuzione TeX Live completa scaricata dal sito \url{http://www.tug.org/ctan.html} ufficiale. Esiste in rete un testo intitolato \emph{texlive-ubuntu.pdf}\footnote{Questo testo è stato scritto nel 2010 per installare TeX Live su Ubuntu, che è di tipo Debian, ma ci sono anche le istruzioni per Fedora e OpenSuse; con piccole varianti sono istruzioni che vanno bene per qualunque macchina Linux.}, che trovate con qualunque motore di ricerca; vi istruisce su come installare TeX Live fresco di giornata (e aggiornabile sistematicamente come detto sopra per le macchine Windows) a fianco della distribuzione Debian di TeX Live; quest'ultima serve per soddisfare le dipendenze di altri programmi Debian; la prima, invece, vi serve per lavorare davvero. \item Siete degli utenti delle piattaforme Macintosh e siete i possessori di un portatile o di un desktop che funziona con il sistema operativo Mac~OS~X. Anche voi avete a disposizione una distribuzione che si chiama \prog{Mac\TeX}, che viene installata e configurata con un particolare software adatto alla specificità del sistema che state usando. Cercate il nome MacTeX con un qualunque motore di ricerca e sarete portati ad un sito dal quale potrete scaricare il pacchetto di installazione (piuttosto grosso); alla fine del download vi viene chiesto se continuare con l'installazione; rispondendo affermativamente, il software vi viene scaricato sul disco che avrete indicato, ma quel che è più comodo, esso è già completo, come ogni distribuzione e installazione TeX Live. Il sistema \prog{Mac\TeX} produce il suo output essenzialmente in formato PDF; se ne tenga conto leggendo attentamente la documentazione. Il pacchetto è già dotato dello shell editor \TeX{}Shop che fa ricorso ad un suo previewer interno per il formato PDF; potrebbe essere una buona idea scaricare dalla rete anche l'applicativo freeware Adobe Reader che dalla versione 9 in poi è anche in grado di riconoscere se un file è o potrebbe essere conforme al formato PDF/A, anche se non è in grado di validarlo come tale; Adobe Reader X, quando apre un file che potrebbe essere conforme allo standard PDF/A, apre in testa alla schermata una riga di informazione nella quale dice che il file è conforme a questo standard; non è il caso di prendere alla lettera quella affermazione, perché i file che vengono classificati conformi allo standard PDF/A da Adobe Reader X, talvolta non passano il test di Preflight di Adobe Acrobat. Tuttavia consente di estrarre delle informazioni che sono difficili da estrarre con altri visualizzatori dei file in formato PDF e consente di aggiungere annotazioni. Naturalmente esistono altri visualizzatori dei file in formato PDF; sulle macchine Apple il visualizzatore di sistema consente di aprire e di editare parzialmente anche altri formati grafici e consente di eseguire molte operazioni, in particolare sui file PDF, che in generale richiedono altri sofisticati programmi di editing grafico. -Attenzione, però: i previewer interni di \TeX{}shop e \TeX{works} consentono di eseguire l'\textit{inverse search} e, ovviamente, anche di fare la \textit{forward search}. Questo è molto comodo durante la fase di editing del vostro documento. Gli altri visualizzatori hanno difficoltà se non proprio l'impossibilità di ``accordarsi'' con la parte di editing testuale per consentire la ricerca diretta e inversa. Oggi (2012) Texmaker e TeXstudio, entrambi multipiattaforma, sono dotati di visualizzatori interni che consentono la ricerca diretta e inversa; TeXstudio dalla versione 2.5 è anche in grado di interpretare le righe di autoconfigurazione scritte con le sintassi di \TeX{}shop e \TeX{}works. Anche TeXstudio si è aggiunto alla lista degli \emph{shell editor} che sanno interpretare le righe di autoconfigurazione. L'editor \prog{emacs} con il suo plug-in \pack{auktex}, funziona benissimo come shell editor per lavorare con \LaTeX, sembrerebbe che possa venire ``sincronizzato'' con un visualizzatore PDF con il quale poter eseguire la ricerca diretta e inversa; sa riconoscere le righe di autoconfigurazione che però sono scritte con una sintassi diversa da quella degli altri programmi nominati prima. +Attenzione, però: i previewer interni di \TeX{}shop e \TeX{works} consentono di eseguire l'\textit{inverse search} e, ovviamente, anche di fare la \textit{forward search}. Questo è molto comodo durante la fase di editing del vostro documento. Gli altri visualizzatori hanno difficoltà se non proprio l'impossibilità di ``accordarsi'' con la parte di editing testuale per consentire la ricerca diretta e inversa. Oggi (2012) Texmaker e TeXstudio, entrambi multipiattaforma, sono dotati di visualizzatori interni che consentono la ricerca diretta e inversa; TeXstudio dalla versione 2.5 è anche in grado di interpretare le righe di autoconfigurazione scritte con le sintassi di \TeX{}shop e \TeX{}works, e si è aggiunto alla lista degli \emph{shell editor} che sanno interpretare le righe di autoconfigurazione. L'editor \prog{emacs} con il suo plug-in \pack{auktex}, funziona benissimo come shell editor per lavorare con \LaTeX, sembrerebbe che possa venire ``sincronizzato'' con un visualizzatore PDF con il quale poter eseguire la ricerca diretta e inversa; sa riconoscere le righe di autoconfigurazione che però sono scritte con una sintassi diversa da quella degli altri programmi nominati prima. \end{enumerate} -Merita di segnalare che per tutte e tre le piattaforme è disponibile e, generalmente, è già installato di default anche l'editor \TeX{}works (multipiattaforma) che, con il suo visualizzatore interno, consente di eseguire su tutte le piattaforme la ricerca diretta e inversa. Ad alcuni, abituati a interfacce grafiche fornite di molte barre cariche di icone per eseguire il possibile e l'impossibile, \TeX{}works piace poco perché la sua schermata è minimale, ma c'è un motivo: nei moderni schermi larghi, con rapporto di forma 16:9, lo schermo contiene accostate e senza sovrapposizioni sia la finestra di editing sia quella del testo composto; questo è molto comodo, più di quanto si possa immaginare, per ``lavorare'' agevolmente il documento da comporre. Benché anche Texmaker e TeXstudio siano in grado di accostare le due schermate, essi consumano molto spazio per le barre superiori, inferiori e laterali, cosicché le vere aree destinate all'editing o alla visualizzazione ne risultano corrispondentemente ristrette, tanto da far preferire \TeX{}works sui laptop e ancor di più sui netbook. +Merita di segnalare che per tutte e tre le piattaforme è disponibile e, talvolta, è già installato di default anche l'editor \TeX{}works (multipiattaforma) che, con il suo visualizzatore interno, consente di eseguire su tutte le piattaforme la ricerca diretta e inversa. Ad alcuni, abituati a interfacce grafiche fornite di molte barre cariche di icone per eseguire il possibile e l'impossibile, \TeX{}works piace poco perché la sua schermata è minimale, ma c'è un motivo: nei moderni schermi larghi, con rapporto di forma 16:9, lo schermo contiene accostate e senza sovrapposizioni sia la finestra di editing sia quella del testo composto; questo è molto comodo, più di quanto si possa immaginare, per ``lavorare'' agevolmente il documento da comporre. Benché anche Texmaker e TeXstudio siano in grado di accostare le due schermate, essi consumano molto spazio per le barre superiori, inferiori e laterali, cosicché le vere aree destinate all'editing o alla visualizzazione ne risultano corrispondentemente ristrette, tanto da far preferire \TeX{}works sui laptop e ancor di più sui netbook. -Poi avete bisogno di programmi accessori per visualizzare sullo schermo e/o stampare su carta i prodotti delle vostre composizioni. Ognuna delle tre piattaforme tipo può avere già installati sia i visualizzatori dei file in formato \texttt{.dvi}, \texttt{.ps} o \texttt{.pdf}. Il formato \texttt{.dvi} è il formato nativo del sistema \TeX\ quindi il software per visualizzare e stampare arriva insieme alla distribuzione che avete già installato, però oggi è un formato che non si usa quasi più. Per il formato \texttt{.ps} bisogna disporre di qualcosa come \prog{ghostscript} e/o \prog{GSView} o altri simili software che con Linux sono solitamente già disponibili insieme al sistema. In ogni caso non è difficile trovare in rete i luoghi da dove scaricarli. Per il formato \texttt{.pdf} Linux, come al solito è già attrezzato, ma non è male per tutti e tre i tipi di piattaforme il programma \prog{Adobe Reader} che la Adobe mette a disposizione di chiunque gratuitamente e per tutte le possibili piattaforme. Naturalmente l'\prog{Adobe Reader} è una specie di programma dimostrativo, per altro eccellente; ma credo che la Adobe lo metta a disposizione per far venire l'acquolina in bocca e per invogliare a comperare il prodotto commerciale completo \prog{Adobe Acrobat}, che per gli studenti non costa molto con il programma Education di quella casa. Secondo me vale ogni dollaro che costa, ma ovviamente questo giudizio dipende dall'uso che se ne fa. +Poi avete bisogno di programmi accessori per visualizzare sullo schermo e/o stampare su carta i prodotti delle vostre composizioni. Ognuna delle tre piattaforme tipo può avere già installati sia i visualizzatori dei file in formato \texttt{.dvi}, \texttt{.ps} o \texttt{.pdf}. Il formato \texttt{.dvi} è il formato nativo del sistema \TeX\ quindi il software per visualizzare e stampare arriva insieme alla distribuzione che avete già installato, però oggi è un formato che non si usa quasi più. Per il formato \texttt{.ps} bisogna disporre di qualcosa come \prog{ghostscript} e/o \prog{GSView} o altri simili software che con Linux sono solitamente già disponibili insieme al sistema. In ogni caso non è difficile trovare in rete i luoghi da dove scaricarli. Per il formato \texttt{.pdf} Linux, come al solito è già attrezzato, ma non è male per tutti e tre i tipi di piattaforma il programma \prog{Adobe Reader} che la Adobe mette a disposizione di chiunque gratuitamente e per tutte le possibili piattaforme\footnote{Sembra che con Linux le cose non stiano più così, ma in rete si trovano ancora delle installazioni non recentissime, ma funzionanti, anche per Linux.}. Naturalmente l'\prog{Adobe Reader} è una specie di programma dimostrativo, per altro eccellente; ma credo che la Adobe lo metta a disposizione per far venire l'acquolina in bocca e per invogliare a comperare il prodotto commerciale completo \prog{Adobe Acrobat}, che per gli studenti non costa molto con il programma Education di quella casa. Secondo me vale ogni dollaro che costa, ma ovviamente questo giudizio dipende dall'uso che se ne fa. Oggi, invece, è molto importante disporre di visualizzatori PDF integrati con l'editor, in modo che siano predisposti per lavorare in tandem sia per mostrare costantemente a fianco della finestra di editing la finestra del file composto in formato PDF, sia per fare la ricerca diretta e inversa; oltre ai già citati \TeX{}shop (solo Mac) e \TeX{}works (multipattaforma) posso citare gli editor TeXsudio e Texmaker (multipiattaforma e molto simili fra loro); altri \emph{shell editor} non dispongono di un visualizzatore integrato, ma possono venire ``sincronizzati'' con visualizzatori esterni; per esempio su piattaforme Windows il visualizzatore sincronizzabile è SumatraPDF; su Linux è Okular; su Mac ne posso citare altri due: TeXnicle (gratuito) e Texpad (commerciale, ma con un costo accessibilissimo) che non solo hanno il visualizzatore integrato, ma le loro ``finestre'' sono in realtà due parti di una stessa finestra; ingrandendola a pieno schermo si ottiene una comodità di composizione difficilmente ottenibile con altri sistemi. @@ -423,10 +423,12 @@ Per le piattaforme Windows il programma di installazione di MiK\TeX\ offriva la Per le piattaforme Mac esistono diversi programmi; a me sembra che il migliore di tutti sia \TeX{}shop, automaticamente installato quando si usa la -distribuzione \prog{Mac\TeX}. ``Migliore'' significa qui il giusto compromesso fra la semplicità e l'efficienza e la validissima integrazione con un suo visualizzatore interno che consente di eseguire con un semplice click di mouse il passaggio da un punto della finestra di composizione del file sorgente al punto corrispondente nella finestra del documento composto in formato PDF, e viceversa. Suo ``figlio'' \TeX{}works (multipiattaforma) sembra avere qualche funzionalità in meno (non è così vero), ma ha una interfaccia comodissima per scoprire la codifica di un file \file{.tex} e per convertire il file in un'altra codifica; \TeX{}shop e \TeX{}works sono autoconfigurabili per ciascun file \file{.tex} grazie ad alcune righe di commenti speciali da scrivere in testa al file, cosa che rende il loro uso incredibilmente comodo. TeXstudio dalla versione 2.5 in poi è in grado di interpretare le stesse righe speciali di \TeX{}shop e di autoconfigurarsi di conseguenza (settembre 2012). Emacs con Auctex è in grado di usare righe di autoconfigurazione che però hanno una sintassi diversa da quelle di \TeX{}shop. Questa affermazione vale anche per Aquamacs, che è una applicazione per Mac che integra direttamente emacs e Auctex. +distribuzione \prog{Mac\TeX}. ``Migliore'' significa qui il giusto compromesso fra la semplicità e l'efficienza e la validissima integrazione con un suo visualizzatore interno che consente di eseguire con un semplice click di mouse il passaggio da un punto della finestra di composizione del file sorgente al punto corrispondente nella finestra del documento composto in formato PDF, e viceversa. Suo ``figlio'' \TeX{}works (multipiattaforma) sembra avere qualche funzionalità in meno (non è così vero), ma ha una interfaccia comodissima per scoprire la codifica di un file \file{.tex} e per convertire il file in un'altra codifica; \TeX{}shop e \TeX{}works sono autoconfigurabili per ciascun file \file{.tex} grazie ad alcune righe di commenti speciali da scrivere in testa al file, cosa che rende il loro uso incredibilmente comodo. TeXstudio dalla versione 2.5 in poi è in grado di interpretare le stesse righe speciali di \TeX{}shop e di autoconfigurarsi di conseguenza (settembre 2012). Emacs con Auctex è in grado di usare righe di autoconfigurazione che però hanno una sintassi diversa da quelle di \TeX{}shop. Questa affermazione vale anche per Aquamacs, che è una applicazione per Mac che integra direttamente emacs e Auctex.\looseness=-1 Per tutte e tre le piattaforme principali \prog{TeXStudio} offre notevoli vantaggi, compresa la visualizzazione di parti del testo da comporre che richiedano più interazione fra il compositore e il software. Permette anche di disporre di una finestra laterale che contiene tutta la struttura ad albero del documento da comporre; cliccando su ogni ramo o rametto di questo albero, il programma sposta la finestra sul punto del file sorgente dove quella sezione comincia. Anche \prog{Kile} ha questa funzionalità. Quasi tutti gli editor citati \emph{non} consentono di fare la ricerca inversa con il formato di uscita PDF, ma solo con il formato DVI. \prog{TeXShop} per Mac, e \prog{TeXworks} e le due versioni \prog{TeXmaker} e \prog{TeXStudio} per tutte le piattaforme permettono di eseguire nativamente la ricerca inversa anche con il formato PDF, e questa particolarità è estremamente comoda. Per le piattaforme Windows esiste il visualizzatore PDF \prog{SumatraPDF} che può essere configurato per interagire con molti editor per poter essere usati assieme sia con la ricerca diretta sia con quella inversa. Va da sé, che se non ci sono esigenze diverse, il formato di uscita PDF è sicuramente quello da preferire. +Mi sono ripetuto diverse volte nel descrivere gli editor per lavorare con il sistema \TeX? L'ho fatto apposta, a costo di essere noioso. Lavorare con editor efficienti, ben adattati al lavoro che si deve fare e che consentano la ricerca diretta e inversa fra la finestra di editing e quella del file composto in formato PDF è talmente importante, che le ripetizioni non sono mai abbastanza. + \section{Ora siete pronti} Ora che avete scaricato tutto il software gratuito o commerciale di cui avete bisogno siete pronti per cominciare. @@ -437,7 +439,7 @@ Attenzione: non si minimizzi la frase precedente: la documentazione va letta sem A qualcuno può venire in mente: ``Ma non sarà mica che ci siano in giro dei programmi che permettono di fare tutto questo in modo WYSIWYG?'' Come noto, WYSIWYG è l'acronimo che si forma con le iniziali di ``what you see is what you get''. \LaTeX\ dovrebbe essere classificato con l'acronimo WYSIWYM che sta per ``what you see is what you mean''. Certo per ottenere esattamente quello che si voleva bisogna lavorare (apparentemente) di più; in realtà bisogna usare di più la testa e di meno il mouse. -Tuttavia là fuori nei negozi ci sono diversi prodotti che consentono di usare \LaTeX\ praticamente in modo WYSIWYG; da Scientific Word a LyX a TeXmacs a Textures ce ne è per ogni piattaforma; LyX e TeXmacs sono freeware mentre gli altri costano attorno ai 500\textdollar. Poi c'è la soluzione gratuita di OpenOffice con l'estensione~1.2 di \prog{Writer2LaTeX}. Io le sconsiglio tutte, come ho già avuto modo di dire, e qui ne ripeto i motivi. +Tuttavia là fuori nei negozi ci sono diversi prodotti che consentono di usare \LaTeX\ praticamente in modo WYSIWYG; da Scientific Word a LyX a TeXmacs a Textures ce ne è per ogni piattaforma; LyX e TeXmacs sono freeware mentre gli altri costano attorno ai 500\textdollar. Poi c'è la soluzione gratuita di OpenOffice e di LibreOffice con l'estensione~1.2 di \prog{Writer2LaTeX}. Io le sconsiglio tutte, come ho già avuto modo di dire, e qui ne ripeto i motivi. Per poter operare in modo ``sincrono'' così da avere immediatamente sullo schermo una cosa molto simile a quello che si otterrà sulla carta, il programma deve essere velocissimo ad eseguire il rendering grafico di quanto viene via via composto; per questo motivo deve rinunciare a non poche funzionalità del sistema \TeX. Però tutti questi software hanno la possibilità di salvare i file in formato \texttt{.tex}, cioè nel formato sorgente del sistema \TeX, per cui una volta finito l'editing si può eseguire la composizione finale con il programma vero, e non tramite le funzionalità del programma di editing. @@ -464,7 +466,7 @@ Microgiustificazione& \centering Completa & \centering Solo protrusione \tabular Formato archiviabile& \centering PDF/A-1b & \centering NO (*) \tabularnewline \bottomrule \end{tabular}\par} -\caption[]{Le principali differenze fra \pdfLaTeX\ e \protect\XeLaTeX }\label{tab:pdflatex-vs-xelatex} +\caption[Le principali differenze fra \textsf{pdflatex} e \textsf{xelatex}]{Le principali differenze fra \pdfLaTeX\ e \protect\XeLaTeX }\label{tab:pdflatex-vs-xelatex} \vspace{\smallskipamount} \small \noindent (*) \XeLaTeX\ non consente la produzione diretta del formato PDF/A, ma ne consente la trasformazione mediante altri programmi, forse, in modo ancor più sicuro che con \pdfLaTeX. @@ -539,11 +541,11 @@ Tutti i file del pacchetto \textsf{TOPtesi} vengono caricati nell'albero della d È comodo, ma non è obbligatorio, disporre di un file di configurazione. Esso serve essenzialmente per contenere i comandi con i loro argomenti necessari per comporre il frontespizio della tesi. Ma se usate qualche altro pacchetto o qualche altro metodo per creare il frontespizio, il file di configurazione, anche se presente, non viene usato. Il pacchetto \textsf{TOPtesi} contiene già alcuni file con configurazioni di default da usare come modello; chiunque se ne può può copiare uno in un altro file mantenendo l'estensione \texttt{.cfg} e con il nome identico a quello del file principale della tesi. Questo file, se esiste, verrà letto durante l'esecuzione del programma e verranno eseguiti tutti i comandi che esso contiene; se quindi il laureando ne fa uso, deve servirsi del modello per cambiarne i dati e metterci le informazioni che ritiene utili per la sua tesi. Se non vuole servirsi del file di configurazione deve solo inserire nel suo file principale tutte le informazioni necessarie al frontespizio (e al retrofrontespizio, se lo vuole usare) prima di specificare l'ambiente -amb{frontespizio} o il comando \cs{frontespizio}. +\amb{frontespizio} o il comando \cs{frontespizio}. -{\tolerance=3000 Il laureando perciò può usare un diverso file di configurazione, sempre chiamato \meta{mainfile}\texttt{.cfg}, collocato nella stessa cartella dove risiede il materiale da comporre. Per esempio, potrebbe comporre la monografia di laurea creando da qualche parte la cartella \texttt{/monografia} e in questa cartella si crea \meta{mainfile}\texttt{.cfg} nel quale scrive quello che vi è necessario; in questa cartella sistema anche i file per comporre la monografia. Quando due anni dopo compone la sua tesi di laurea magistrale, crea da qualche parte la cartella \texttt{/tesi} e ci mette dentro un'altro file \meta{mainfile}\texttt{.cfg} con la sua configurazione adattata alla tesi magistrale; in questa stessa cartella mette i file relativi alla sua tesi magistrale. Se dopo tre anni prende il dottorato e si scrive la sua dissertazione dottorale, si crea da qualche parte la cartella \texttt{/dissertazione} e vi mette dentro un altro file \meta{mainfile}\texttt{.cfg} che configura per la sua dissertazione; sempre in questa stessa cartella mette i file necessari per comporre la sua dissertazione. Ovviamente nei tre casi \meta{mainfile} è il nome del file principale che, altrettanto ovviamente, sarà diverso per ciascuna delle tre tesi.\par} +{\tolerance=3000 Il laureando perciò può usare un diverso file di configurazione, sempre chiamato \meta{mainfile}\texttt{.cfg}, collocato nella stessa cartella dove risiede il materiale da comporre. Per esempio, potrebbe comporre la monografia di laurea creando da qualche parte la cartella \texttt{/monografia} e in questa cartella si crea \meta{mainfile}\texttt{.cfg} nel quale scrive quello che gli è necessario; in questa cartella sistema anche i file per comporre la monografia. Quando due anni dopo compone la sua tesi di laurea magistrale, crea da qualche parte la cartella \texttt{/tesi} e ci mette dentro un'altro file \meta{mainfile}\texttt{.cfg} con la sua configurazione adattata alla tesi magistrale; in questa stessa cartella mette i file relativi alla sua tesi magistrale. Se dopo tre anni prende il dottorato e si scrive la sua dissertazione dottorale, si crea da qualche parte la cartella \texttt{/dissertazione} e vi mette dentro un altro file \meta{mainfile}\texttt{.cfg} che configura per la sua dissertazione; sempre in questa stessa cartella mette i file necessari per comporre la sua dissertazione. Ovviamente nei tre casi \meta{mainfile} è il nome del file principale che, altrettanto ovviamente, sarà diverso per ciascuna delle tre tesi.\par} -Nota bene: il modulo \pack{topfront} che contiene i comandi per la composizione del frontespizio oltre al comando per caricare l'eventuale file di configurazione, chiama quest'ultimo file col nome |\jobname.cfg|. La macro |\jobname| è la stessa usata da \LaTeX\ per conservare il nome senza estensione del main file del documento che si sta componendo; quindi se il main file si chiamasse \texttt{GiorgioRossi"TesiMagisrale.tex} il file di configurazione associato a questo main file si deve chiamare obbligatoriamente \texttt{GiorgioRossiTesiMagisrale.cfg}. Siccome i sistemi operativi di tipo UNIX distinguono le lettere maiuscole dalla minuscole nei nomi dei file, se il file di configurazione si chiamasse \texttt{giorgiorossitesimagisrale."cfg} non verrebbe letto da Linux o da Mac~OS~X perché il nome proprio del file è scritto in tutte lettere minuscole, e non sarebbe uguale al nome proprio del main file che contiene anche delle lettere maiuscole. Per evitare problemi si consiglia di rispettare le maiuscole e le minuscole anche agli utenti dei sistemi operativi Windows, anche se questi sistemi operativi non distinguono i nome dei file in base al fatto che contengano lettere maiuscole o minuscole. +{\tolerance=3000 Nota bene: il modulo \pack{topfront} che contiene i comandi per la composizione del frontespizio di oltre al comando per caricare l'eventuale file di configurazione, chiama quest'ultimo file col nome \verb|\jobname.cfg|. La macro \verb|\jobname| è la stessa usata da \LaTeX\ per conservare il nome senza estensione del main file del documento che si sta componendo; quindi se il main file si chiamasse \texttt{GiorgioRossi"TesiMagisrale.tex} il file di configurazione associato a questo main file si deve chiamare obbligatoriamente \texttt{GiorgioRossiTesiMagisrale.cfg}. Siccome i sistemi operativi di tipo UNIX distinguono le lettere maiuscole dalla minuscole nei nomi dei file, se il file di configurazione si chiamasse \texttt{giorgiorossitesimagisrale."cfg} non verrebbe letto da Linux o da Mac~OS~X perché il nome proprio del file è scritto in tutte lettere minuscole, e non sarebbe uguale al nome proprio del main file che contiene anche delle lettere maiuscole. Per evitare problemi si consiglia di rispettare le maiuscole e le minuscole anche agli utenti dei sistemi operativi Windows, anche se questi sistemi operativi non distinguono i nome dei file in base al fatto che contengano lettere maiuscole o minuscole.\par} \section{Pronti? Via!} @@ -559,6 +561,8 @@ 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; se non siete un tipografo professionista, lasciate perdere ogni modifica tipografica; \LaTeX, lo ripeto, lavora generalmente meglio di molti tipografi; è proprio il motivo per il quale Knuth ha realizzato il sistema \TeX. +\newpage + \section{I file accessori} Qui verranno descritti alcuni usi del modulo \pack{topfront} e del modulo \pack{topcoman}. Il primo serve per comporre il frontespizio; il secondo mette a disposizione alcuni comandi utili. Né l'uno né latro sono indispensabili, ma sono utili. @@ -628,7 +632,7 @@ va sostituita, per esempio, con: \end{verbatim} Ma se si deve scrivere il frontespizio in un'altra lingua bisogna agire come spiegato poco più avanti. -In realtà il pacchetto \pack{topfront} lavora bene in italiano e distingue i singolari dai plurali, i maschili dai femminili; non fa nulla di particolare se la lingua di composizione del frontespizio è l'inglese o un'altra lingua; ricordate che l'inglese è già impostato ma non attivato; lo si attiva nel main document con il comando \cs{english}. Se si vuole comporre il frontespizio in un'altra lingua, allora, usando \prog{xelatex}, la si specifica mediante il comando \cs{setmainlanguage}; invece usando \pdfLaTeX\ la si indica fra le opzioni di \cs{documentclass} e poi, prima di usare l'ambiente \amb{frontespizio} o \cs{frontespizio*} o o i comandi corrispondenti, la si imposta con \cs{selectlanguage}. Poi si inseriscono i seguenti comandi, modificando gli argomenti in accordo con le restrizioni burocratiche per i frontespizi delle tesi nella vostra università: +In realtà il pacchetto \pack{topfront} lavora bene in italiano e distingue i singolari dai plurali, i maschili dai femminili; non fa nulla di particolare se la lingua di composizione del frontespizio è l'inglese o un'altra lingua; ricordate che l'inglese è già impostato ma non attivato; lo si attiva nel main document con il comando \cs{english}. Se si vuole comporre il frontespizio in un'altra lingua, allora, usando \prog{xelatex}, la si specifica mediante il comando \cs{setmainlanguage}; invece usando \pdfLaTeX\ la si indica fra le opzioni di \cs{documentclass} e poi, prima di usare l'ambiente \amb{frontespizio} o \cs{frontespizio*} o i comandi corrispondenti, la si imposta con \cs{selectlanguage}. Poi si inseriscono i seguenti comandi, modificando gli argomenti in accordo con le restrizioni burocratiche per i frontespizi delle tesi nella vostra università: \begin{Verbatim}[fontsize=\small] \retrofrontespizio{This work is subject to the Creative Commons Licence} \DottoratoIn{PhD Course in\space} @@ -731,15 +735,15 @@ filetti & assenti & presenti \tabularnewline \begin{figure}[p]\centering \includegraphics[height=0.875\textheight]{FrontespiziAssemblati2} -\caption[Frontespizio composti con lo stile \texttt{classica}]{Frontespizio composti con lo stile \texttt{classica}. Con questo stile si ha una disposizione diversa delle varie informazioni e i loghi sono sempre posti nella parte inferiore della pagina. Il nome dell'università è sempre presente.}\label{fig:altri4frontespizi} +\caption[Frontespizi composti con lo stile \texttt{classica}]{Frontespizi composti con lo stile \texttt{classica}. Con questo stile si ha una disposizione diversa delle varie informazioni e i loghi sono sempre posti nella parte inferiore della pagina. Il nome dell'università è sempre presente.}\label{fig:altri4frontespizi} \end{figure} \subsection{I comandi accessori di topcoman} L'altro file accessorio \pack{topcoman} contiene diversi utili comandi, alcuni già incorporati nella definizione della lingua italiana del sistema \TeX\ (solo se usate \pack{babel}). Tuttavia se dovete scrivere in una lingua diversa dall'italiano quei comandi non sono disponibili e qui viene utile avere quei comandi in un pacchetto distinto da \pack{babel} e non soggetto a test sulla lingua in uso. -Il file contiene anche un comando per la stampa in modo verbatim il contenuto di un file esterno, per esempio il listato di un programma; ci sono altri pacchetti \LaTeX\ che consentono di stampare il listato di un programma in modo anche migliore, per esempio il pacchetto \pack{listings}, ma, visto che vi può servire per la tesi e, visto che una volta che lo conoscete vi -potrebbe piacere e poi vorreste continuare ad usarlo, è meglio +Il file contiene anche un comando per la stampa in modo verbatim il contenuto di un file esterno, per esempio il listato di un programma; ci sono altri pacchetti \LaTeX\ che consentono di stampare il listato di un programma in modo anche migliore, per esempio il pacchetto \pack{listings}, ma, visto che può servire per la tesi e, visto che una volta che lo si conosce +potrebbe piacere e poi si vorrebbe continuare ad usarlo, è meglio disporne come pacchetto separato. Non sarebbe difficile per esempio stamparsi in pulito il listato del proprio programma contenuto nel file \texttt{myprogram.c}: si scrive semplicemente un file del tipo @@ -891,7 +895,7 @@ Un esempio di un frontespizio costruito per questa via è quello che un utente h \begin{tabular}[t]{@{}l@{}} \fixednamesfont Relatore\\ \namesfont Prof. ing. Mario Rossi\\[1ex] - \ffixednamesfont Correlatore\\ + \fixednamesfont Correlatore\\ \namesfont Dott. ing. Giuseppe Scapigliati \end{tabular} \end{minipage} @@ -1155,7 +1159,7 @@ L'uso del pacchetto \pack{xspace} fa sì che esso, tramite il comando \cs{xspace 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. -Se volete o dovete usare \prog{pdflatex}, dovete caricare nel vostro preambolo tutto quello che è necessario per gestire quelle lingue scritte con alfabeti diversi, ma non chiedetemi come si fa, perché so dirvelo solo per il greco. Per questa lingua, se usate l'ortografia monotonica, basta inserire l'opzione della lingua \opt{greek} fra le opzioni \emph{della classe}; se usate l'ortografia politonica\footnote{Il greco moderno può essere politonico o monotonico; quello antico è sempre e solo politonico; però le regole di sillabazione sono diverse; con \pack{polyglossia} non ci sono problemi; con \pack{babel} a tutt'oggi (ottobre 2014) esiste l'attributo \opt{ancient} per selezionare la sillabazione antica oltre alla grafia politonica, ma non è ancora possibile disporre effettivamente della sillabazione antica completa.}, allora dovete richiedere per \pack{babel} lo specifico attributo seguendo questo procedimento (per \pack{polyglossia} si veda più avanti): +Se volete o dovete usare \prog{pdflatex}, dovete caricare nel vostro preambolo tutto quello che è necessario per gestire quelle lingue scritte con alfabeti diversi, ma non chiedetemi come si fa, perché so dirvelo solo per il greco. Per questa lingua, se usate l'ortografia monotonica, basta inserire l'opzione della lingua \opt{greek} fra le opzioni \emph{della classe}; se usate l'ortografia politonica\footnote{Il greco moderno può essere politonico o monotonico; quello antico è sempre e solo politonico; però le regole di sillabazione sono diverse; con \pack{polyglossia} non ci sono problemi; con \pack{babel} a tutt'oggi (ottobre 2015) esiste l'attributo \opt{ancient} per selezionare la sillabazione antica oltre alla grafia politonica, ma non è ancora possibile disporre effettivamente della sillabazione antica completa.}, allora dovete richiedere per \pack{babel} lo specifico attributo seguendo questo procedimento (per \pack{polyglossia} si veda più avanti): \begin{verbatim} \documentclass[...,greek,...]{toptesi} ... @@ -1175,7 +1179,7 @@ oppure Al posto di \opt{ancient} si può specificare \opt{polutoniko}; \opt{polutoniko} si riferisce al greco moderno scritto con tutta la varietà di accenti e diviso in sillabe con i criteri adatti alla lingua moderna; \opt{ancient} si riferisce al greco classico, che oltre ad usare la solita varietà di accenti, usa altre regole per la sillabazione di questa varietà di lingua. -Per una tesi che tratti il greco antico in forma filologica, consiglio l'uso del pacchetto \pack{teubner}; visto che l'ho scritto io, un po' di réclame non guasta~\dots\ Bisogna però leggerne la documentazione con attenzione. In particolare conviene ricordare che \pack{teubner} non viene caricato se non è stato precedentemente specificata la lingua greca fra le opzioni, ma poi provvede da solo ad impostare l'attributo \opt{ancient} e tutte le altre caratteristiche necessarie per comporre in greco con il \emph{mark-up} filologico. A tutt'oggi (2014) il pacchetto \pack{teubner} non è stato adeguatamente controllato sotto \XeLaTeX. Probabilmente non è completamente compatibile, ma non sono ancora in grado di dire niente né in positivo né in negativo. +Per una tesi che tratti il greco antico in forma filologica, consiglio l'uso del pacchetto \pack{teubner}; visto che l'ho scritto io, un po' di réclame non guasta~\dots\ Bisogna però leggerne la documentazione con attenzione. In particolare conviene ricordare che \pack{teubner} non viene caricato se non è stato precedentemente specificata la lingua greca fra le opzioni, ma poi provvede da solo ad impostare l'attributo \opt{ancient} e tutte le altre caratteristiche necessarie per comporre in greco con il \emph{mark-up} filologico. A tutt'oggi (2015) il pacchetto \pack{teubner} non è stato adeguatamente controllato sotto \XeLaTeX. Probabilmente non è completamente compatibile, ma non sono ancora in grado di dire niente né in positivo né in negativo. %%% MODIFICARE LA FRASE PRECEDENTE QUANDO TEUBNER SARÀ A POSTO!!!! @@ -1183,7 +1187,7 @@ Immagino che per usare le lingue che si scrivono in cirillico, basti specificare 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 sulla cui faccia riportano il segno che si ottiene premendo quel tasto quando è attivo il driver corrispondente a quella specifica tastiera. 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\ aggiornata e, soprattutto, completa, 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. -Con le macchine Macintosh il sistema operativo Mac OS X mette a disposizione una specie di tastiera virtuale sui tasti della quale si può cliccare con il mouse; si possono installare diverse tastiere che possono venire intercambiate con un semplice click sulla bandierina disegnata nella barra superiore; per cui scrivere in greco politonico o in russo o in ebraico, o in\dots, non è un problema. Temo che lo sia con altre macchine e altri sistemi operativi. +Con le macchine Macintosh il sistema operativo Mac OS X mette a disposizione una specie di tastiera virtuale sui tasti della quale si può cliccare con il mouse; si possono installare diverse tastiere che possono venire intercambiate con un semplice click sulla icona disegnata nella barra superiore; per cui scrivere in greco politonico o in russo o in ebraico, o in\dots, non è un problema. Temo che lo sia con altre macchine e altri sistemi operativi. Mi dicono che sulle macchine Linux l'editor \prog{Vim} e, su tutte le macchine, l'editor \prog{emacs} prevedano delle combinazioni di tasti che consentono di scrivere direttamente in greco sullo schermo, nella finestra del file \texttt{.tex}. Confermo di avere letto qualcosa in merito, ma non sono in grado di confermare per esperienza diretta. @@ -1196,9 +1200,9 @@ Solo per scrivere in inglese non è necessario specificare nessuna codifica per Inoltre con questa codifica \opt{OT1} la presenza di accenti impedisce la divisione in sillabe o ne riduce molto l'efficacia; per l'italiano il problema è relativamente modesto perché normalmente gli accenti compaiono solo sull'ultima vocale delle parole \emph{tronche}. Quindi con questa codifica la parola \emph{qualità} viene divisa in ``qua-lità'' invece che in ``qua-li-tà''. Invece in francese una parola come \emph{électricité} non viene divisa per niente a causa dell'accento sulla prima vocale. -Allora per tutte le lingue diverse dall'inglese, ma anche per l'inglese, è quanto mai opportuno specificare per i font di uscita la codifica \opt{T1}. C'è però un problemino, facilmente risolubile, ma bisogna pensarci: fino ad oggi (2014) i font di default usati da \pdfLaTeX\ sono i font della collezione Computer Modern con codifica \opt{OT1}; e ogni installazione del sistema \TeX\ li può usare sia nella versione ``bitmapped'' sia in quella PostScript Type~1. Quest'ultimo formato dei font dovrebbe essere quello da usare sempre con qualunque font per il formato PDF del file di uscita, perché questo formato è portabile da una macchina ad un'altra, indipendentemente dal sistema operativo usato. Se poi il file deve essere archiviato, esso deve essere in formato PDF, quindi, di fatto non ci sono scelte. +Allora per tutte le lingue diverse dall'inglese, ma anche per l'inglese, è quanto mai opportuno specificare per i font di uscita la codifica \opt{T1}. C'è però un problemino, facilmente risolubile, ma bisogna pensarci: fino ad oggi (2015) i font di default usati da \pdfLaTeX\ sono i font della collezione Computer Modern con codifica \opt{OT1}; e ogni installazione del sistema \TeX\ li può usare sia nella versione ``bitmapped'' sia in quella PostScript Type~1. Quest'ultimo formato dei font dovrebbe essere quello da usare sempre con qualunque font per il formato PDF del file di uscita, perché questo formato è portabile da una macchina ad un'altra, indipendentemente dal sistema operativo usato. Se poi il file deve essere archiviato, esso deve essere in formato PDF, quindi, di fatto non ci sono scelte. -I file della collezione Computer Modern con codifica \opt{T1}, conosciuti anche come font EC, sono invece distribuiti solo nella forma bitmapped, la quale, oltre ad essere vietata nei file PDF archiviabili, si legge molto male sullo schermo, se il programma di visualizzazione non è molto ben adattato ai font bitmapped. Esiste la collezione di font \textsf{cm-super} per ovviare a questo inconveniente (questa collezione è installata di default in ogni installazione completa del sistema \TeX), ma l'uso di questi font implica un aumento non trascurabile del file di uscita. Per aggirare questi inconvenienti è meglio usare i font della collezione Latin Modern, per cui nel preambolo del file da gestire con \prog{pdflatex} si specificherà: +I file della collezione Computer Modern con codifica \opt{T1}, conosciuti anche come font EC, sono invece distribuiti solo nella forma bitmapped, la quale, oltre ad essere vietata nei file PDF archiviabili, si legge molto male sullo schermo, se il programma di visualizzazione non è molto ben adattato ai font bitmapped. Esiste la collezione di font \textsf{cm-super} per ovviare a questo inconveniente (questa collezione è installata di default in ogni installazione completa del sistema \TeX), ma l'uso di questi font implica un aumento non trascurabile delle dimensioni del file di uscita. Per aggirare questi inconvenienti è meglio usare i font della collezione Latin Modern, per cui nel preambolo del file da gestire con \prog{pdflatex} si specificherà: \begin{verbatim} \documentclass[...]{toptesi} ... @@ -1336,7 +1340,7 @@ slovenian, spanish, swedish, turkish, turkmen, ukrainian, uppersorbian, welsh, loaded. \end{verbatim} -Oggi, 2014, purtroppo l'elenco delle lingue è sostituito dalla seguente breve frase: +Dal 2014, purtroppo l'elenco delle lingue è sostituito dalla seguente breve frase: \begin{verbatim} Babel <3.9k> and hyphenation patterns for 81 languages loaded. \end{verbatim} @@ -1361,7 +1365,7 @@ La distribuzione \TeX~Live completa distribuita sul circuito \url{ctan} nasce gi \subsubsection{Mac\TeX} -Dal 2007 la distribuzione di \prog{Mac\TeX} sostanzialmente coincide con \TeX-live, salvo che contiene anche programmi accessori specifici per le macchine Macintosh; è preconfigurato per gestire tutte le lingue di cui il sistema è capace, compreso l'italiano. Ma per l'ostrogoto altomedievale\dots +Dal 2007 la distribuzione di \prog{Mac\TeX} sostanzialmente coincide con \TeX-live, salvo che contiene anche programmi accessori specifici per le macchine Macintosh; è pre"configurato per gestire tutte le lingue di cui il sistema è capace, compreso l'italiano. Ma per l'ostrogoto altomedievale\dots \subsubsection{Distribuzioni commerciali} @@ -1453,7 +1457,7 @@ e per le lingue che richiedono un trattamento particolare si usa un comando simi \setotherlanguage[variant=ancient]{greek} \end{verbatim} -Per scrivere in lingue che implicano alfabeti diversi da quello latino, ovviamente, bisogna aver curato di disporre di una configurazione del sistema \TeX\ completa anche dei font che servono. Non dovrebbero esserci problemi con il cirillico e con il greco; per altri alfabeti e per le lingue che si scrivono da destra a sinistra bisogna ovviamente disporre dei pacchetti necessari. Si tenga presente che le versioni moderne del sistema \TeX\ \emph{non} usano come interprete il programma originario di Knuth, ma la sua estensione che in origine si chiamava $\epsilon$\TeX; la variante che produce il file del documento composto in formato \texttt{.pdf} si chiama \prog{pdftex}, ma questa versione comprende tutte le estensioni di $\epsilon$\TeX. Bene, queste estensioni servono anche per gestire le lingue con scrittura retrograda pur di disporre dei pacchetti relativi a queste lingue. +Per scrivere in lingue che implicano alfabeti diversi da quello latino, ovviamente, bisogna aver curato di disporre di una configurazione del sistema \TeX\ completa anche dei font che servono. Non dovrebbero esserci problemi con il cirillico e con il greco; per altri alfabeti e per le lingue che si scrivono da destra a sinistra bisogna ovviamente disporre dei pacchetti necessari. Si tenga presente che le versioni moderne del sistema \TeX\ \emph{non} usano come interprete il programma originario di Knuth, ma la sua estensione che in origine si chiamava $\epsilon$-\TeX; la variante che produce il file del documento composto in formato \texttt{.pdf} si chiama \prog{pdftex}, ma questa versione comprende tutte le estensioni di $\epsilon$-\TeX. Bene, queste estensioni servono anche per gestire le lingue con scrittura retrograda pur di disporre dei pacchetti relativi a queste lingue. Anche \prog{xelatex} è in grado di gestire le lingue retrograde ed è capace con modesti adattamenti di alcuni comandi di comporre in verticale (cinese, giapponese,\dots). @@ -1511,10 +1515,10 @@ Ricordate solo che il pacchetto \pack{toptesi} non contiene nessuna verifica se Se esistono validi motivi per non usare \prog{pdflatex}\footnote{Ma è meglio che vi mettiate nelle condizioni di \emph{non usare} quei pacchetti che richiedano l'uso di comandi PostScript, come per esempio \pack{PSTriks} o \pack{XYpic}, ma di usare i pacchetti di grafica come \pack{pgf} e il suo modulo \pack{tikz} che consentono di fare quasi tutto quello che si può fare con gli altri pacchetti che richiedono il linguaggio PostScript.}, allora dovete usare il semplice \prog{latex}, e poi convertire il file DVI ottenuto in un file PS e, per la conversione in file PDF/A, dovete poi usare \prog{ghostscript}; per come fare dovete consultare il libretto \textit{Saper Comunicare -- Cenni di scrittura tecnico scientifica} e/o la documentazione di \prog{ghostscript} (versione 8.61 o successiva) in particolare il file \file{ps2pdf.html}. -Ricordate solo che produrre un file PDF/A non è semplice, ma se usate \prog{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. Lo stesso avviene con \LuaLaTeX\ sebbene questo programma disponga di ulteriori meccanismi per eseguire questo compito; il lettore che abbia la necessità di usare \LuaLaTeX\ lo conosce bene, altrimenti non si accingerebbe ad usarlo senza saperlo usare\dots +Bisogna ricordare che produrre un file PDF/A non è semplice, ma se usate \prog{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. Lo stesso avviene con \LuaLaTeX\ sebbene questo programma disponga di ulteriori meccanismi per eseguire questo compito; il lettore che abbia la necessità di usare \LuaLaTeX\ lo conosce bene, altrimenti non si accingerebbe ad usarlo senza saperlo usare\dots \subsection{\texorpdfstring{\prog}{}{xelatex} e il formato PDF/A}\label{sec:XePDFA} -Se invece usate o dovete usare il programma \prog{xelatex} per comporre la tesi e volete avere un file finale conforme alle specifiche PDF/A, allora dovete procedere in modo diverso\footnote{Questa procedura serve anche quando usate \prog{latex} e usate pacchetti com \pack{PSTricks} che richiedono di inserire del codice PostScript nel file di uscita.}; precisamente usate le stesse cautele raccomandate per quando usate il programma \prog{pdflatex}, cioè specificate l'opzione \opt{pdfa} nella dichiarazione di classe che usa la classe \class{toptesi}, usate \cs{hypersetup} all'inizio del preambolo per personalizzare il pacchetto \pack{hyperref} già invocato da \class{toptesi}; incorporate figure che abbiano solo il profilo di colore RGB e che contengano al loro interno i font vettoriali di cui si servono, ma usate solo font OpenType; \prog{xelatex} è fatto apposta per usare questi font. Per la matematica usate una delle collezioni di font OpenType oggi (2014) disponibili: XITS Math, Asana Math, Latin Modern Math, TeX\ Gyre Pagella Math, \TeX\ Gyre Termes Math. Controllate che qualunque file incluso \emph{non} contenga i font Computer Modern con codifica OT1 (la vecchia codifica senza lettere accentate); apparentemente la funzione di \emph{overlay} che questi font usano per sovrapporre gli accenti sulle lettere da accentare non è più compatibile con la certificazione eseguibile da Preflight di Adobe Acrobat. Tuttavia la distribuzione del sistema \TeX\ contiene una collezione abbastanza ampia di font OpenType, compresi i CM in formato OpenType, e non ci sono in realtà veri problemi con il testo che componente voi; potrebbero essercene se incorporate pagine o figure PDF tratte da altri documenti composti in passato che contengono i font CM di tipo Type~1, la cui funzione di \emph{overlay} evidentemente non è conforme. +Se invece usate o dovete usare il programma \prog{xelatex} per comporre la tesi e volete avere un file finale conforme alle specifiche PDF/A, allora dovete procedere in modo diverso\footnote{Questa procedura serve anche quando usate \prog{latex} e usate pacchetti com \pack{PSTricks} che richiedono di inserire del codice PostScript nel file di uscita.}; precisamente usate le stesse cautele raccomandate per quando usate il programma \prog{pdflatex}, cioè specificate l'opzione \opt{pdfa} nella dichiarazione di classe che usa la classe \class{toptesi}, usate \cs{hypersetup} all'inizio del preambolo per personalizzare il pacchetto \pack{hyperref} già invocato da \class{toptesi}; incorporate figure che abbiano solo il profilo di colore RGB e che contengano al loro interno i font vettoriali di cui si servono, ma usate solo font OpenType; \prog{xelatex} è fatto apposta per usare questi font. Per la matematica usate una delle collezioni di font OpenType oggi (2015) disponibili: XITS Math, Asana Math, Latin Modern Math, TeX\ Gyre Pagella Math, \TeX\ Gyre Termes Math. Controllate che qualunque file incluso \emph{non} contenga i font Computer Modern con codifica OT1 (la vecchia codifica senza lettere accentate); apparentemente la funzione di \emph{overlay} che questi font usano per sovrapporre gli accenti sulle lettere da accentare non è più compatibile con la certificazione eseguibile da Preflight di Adobe Acrobat. Tuttavia la distribuzione del sistema \TeX\ contiene una collezione abbastanza ampia di font OpenType, compresi i CM in formato OpenType, e non ci sono in realtà veri problemi con il testo che componente voi; potrebbero essercene se incorporate pagine o figure PDF tratte da altri documenti composti in passato che contengono i font CM di tipo Type~1, la cui funzione di \emph{overlay} evidentemente non è conforme. Dopo aver eseguito \prog{xelatex} sui file sorgente della vostra tesi vi ritrovate con un file PDF che non è ancora conforme allo standard PDF/A, ma basta usare \prog{ghostscript} per trasformarlo in un file conforme. Bisogna predisporre nella stessa cartella dove si trova il main file del documento un file che contenga i \emph{metadata}; per questo documento, composto con \prog{xelatex}, il file adatto a \prog{ghostscript} è il seguente: \begin{Verbatim}[fontsize=\small] @@ -1736,12 +1740,11 @@ modo matematico. Essi sono raccolti nella tabella~\ref{tab:generale}. \caption{Comandi di tipo generale}\label{tab:generale} \end{table} -{\tolerance=3000 Vale la pena di commentare sull'uso dell'ambiente \amb{interlinea} e del comando \cs{interlinea}.\par} - +{\tolerance=6000 Vale la pena di commentare sull'uso dell'ambiente \amb{interlinea} e del comando \cs{interlinea}. Il primo confina il suo effetto all'interno dell'ambiente da lui stesso formato; il secondo agisce come una dichiarazione che resta in vigore finché una dichiarazione contraria non ne modifica il -valore. +valore.\par} \textcolor{red}{Tuttavia sia l'ambiente sia il comando non dovrebbero essere mai usati!} La composizione tipografica non ha nulla a che vedere con la @@ -1815,196 +1818,11 @@ subito dopo \cs{begin}\Arg{document}. Se si desidera una pagina vuota saltuariam {\tolerance=3000\textcolor{red}{I comandi per la composizione del frontespizio \emph{non possono} essere inseriti nel preambolo, cioè prima di \cs{begin}\Arg{document}, qualunque sia il programma di compilazione usato, perché nessuno di quei comandi è definito prima di che il modulo \pack{topfront} sia stato eventualmente caricato, il che avviene solo al momento di eseguire il comando \cs{begin}\Arg{document}; se si specifica l'opzione \opt{noTOPfront} il modulo \pack{topfront} non viene nemmeno caricato.}\par} -È per questo che si consiglia di usare facoltativamente il file di configurazione e comunque tutti i comando necessari per il frontespizio, non present nel file di configurazione all'interno, all'interno dell'ambiente \amb{frontespizio} o \amb{frontespizio*}. In questo modo non si corre il rischio di inserirli nel preambolo. Se poi si usa un pacchetto esterno per comporre il frontespizio, a maggior ragione bisogna specificare i comandi necessari come specificato nella documentazione di quel pacchetto esterno. +È per questo che si consiglia di usare facoltativamente il file di configurazione e comunque tutti i comandi necessari per il frontespizio, non presenti nel file di configurazione all'interno, all'interno dell'ambiente \amb{frontespizio} o \amb{frontespizio*}. In questo modo non si corre il rischio di inserirli nel preambolo. Se poi si usa un pacchetto esterno per comporre il frontespizio, a maggior ragione bisogna specificare i comandi necessari come specificato nella documentazione di quel pacchetto esterno. Con le ultime variazioni della versione 5.85 e successive, lo si ripete, la cosa migliore da fare è quella di usare questi comandi dentro uno degli ambienti \amb{frontespizio} o \amb{frontespizio*}; si pigliano due piccioni con una fava; siccome questi ambienti compongono direttamente il frontespizio, essi devono trovarsi dopo \cs{begin}\Arg{document} e questo va bene sia per \pdfLaTeX\ sia per \XeLaTeX. -\begin {table}[p] -\def\V{\rule{0pt}{2.5ex}} -\let\s\string\let\t\ttfamily -\def\d{\discretionary{\%}{\rule{1em}{0pt}}{}} -\makebox[\textwidth]{\tolerance=9999\finalhyphendemerits=0\relax% -\begin {tabular}{p{.3\textwidth}p{.2\textwidth}p{.2\textwidth}p{.25\textwidth}} -\toprule -Comando & Default & Scopo & Esempio d'uso \\ -\midrule -\cs{ateneo}\t\s{...\s}\V&POLITECNICO DI TORINO& Definisce il nome generico dell'Ateneo & - \cs{ateneo}\Arg{II Università di Roma} \\ -\cs{nomeateneo}\t\s{...\s}& nessuno& Definisce il nome proprio dell'Ateneo & - \cs{nomeateneo}\Arg{Tor Vergata} \\ -\cs{facolta}\t[...]\s{...\s}& nessuno & Definisce il nome della - Facoltà opzionalmente con l'indicazione dell'ordinale& - \cs{facolta}\t[III]\d\Arg{Scienze} \\ -\cs{struttura} && sinonimo del comando \cs{facolta}&\\ -\cs{corsodilaurea}\t\s{...\s}& nessuno& Definire il nome del corso di laurea & - \cs{corsodilaurea}\d\Arg{Fisica} \\ -\cs{corsodidottorato}\t\d\{...\}& nessuno&Definisce il nome del corso di dottorato& - \cs{corsodidottorato}\d\Arg{Fisica} \\ -\cs{monografia}\t\{...\}&nessuno&Definisce il titolo della monografia e imposta lo stile del frontespizio& - \cs{monografia}\d\Arg{Il~teorema di Eulero}\\ -\cs{titolo}\t[...]\{...\}&nessuno&Definisce il titolo della tesi o della dissertazione& - \cs{titolo}\t\d[La~pressione]\d\Arg{La~pressione di Giove}\\ -\cs{sottotitolo}\t\{...\} &nessuno - &Definisce il sottotitolo della tesi o della - dissertazione - & \cs{sottotitolo}\Arg{Metodo Barometrico} \\ -\cs{Materia}\t\{...\}&nessuno&Definisce la materia su cui verte la tesi & - \cs{Materia}\Arg{Remote Sensing} \\ -\cs{materia}\t\{...\}&nessuno&sinonimo del comando \cs{Materia} & - \cs{materia}\d\Arg{Letteratura ostrogota} \\ -\bottomrule -\end{tabular}} -\caption{Comandi per il frontespizio della monografia di laurea, della -tesi di laurea e della dissertazione di dottorato -(\emph{continua})}\label{tab:front1} -\end{table} - -\addtocounter{table}{-1} -\begin{table}[p] -\def\V{\rule{0pt}{2.5ex}} -\let\s\string \let\t\ttfamily -\def\d{\discretionary{\%}{\rule{1em}{0pt}}{}} -\makebox[\textwidth]{% -\begin {tabular}{p{.3\textwidth}p{.15\textwidth}p{.2\textwidth}p{.3\textwidth}} -\toprule -Comando & Default & Scopo & Esempio d'uso \\ -\midrule -\cs{relatore}\t\{...\}\V&nessuno& Definisce il nome del relatore& - \cs{relatore}\d\Arg{prof.\s~Albert Einstein} \\ -\cs{secondorelatore}\t\{...\}&nessuno&Se c'è, definisce il nome del secondo relatore& - \cs{secondorelatore}\d\Arg{dott.\s~Grazia Deledda}\\ -\cs{terzorelatore}\t\{...\}&nessuno&Se c' è, definisce il nome del -terzo relatore& - \cs{terzorelatore}\d\Arg{ing.\s~Thomas A.\s~Edison}\\ -\cs{direttore}\t\{...\}&nessuno&Definisce il nome del direttore del ciclo di dottorato& - \cs{direttore}\d\Arg{prof.\s~Albert Enstein}\\ -\cs{coordinatore}\t\{...\}&nessuno&Definisce il nome del coordinatore del ciclo di dottorato& - \cs{coordinatore}\d\Arg{prof.\s~Albert Einstein}\\ -\small\cs{QualificaDirettore}\t\d\{...\}& Direttore o Coordinatore& Definisce il titolo da inserire - prima del nome del direttore della scuola di dottorato& - \cs{QualificaDirettore}\d\Arg{PhD~Director}\\ -\cs{tutore}\t\{...\}&nessuno&Definisce il nome del tutore& - \cs{tutore}\d\Arg{prof.\s~Karl Von Braun} \\ -\cs{tutoreaziendale}\t\{...\} & nessuno& Definisce la qualifica del tutore aziendale & - \cs{tutoreaziendale}\d\Arg{Supervisore}\\ -\cs{candidato}\t\{...\}&nessuno&Definisce il nome del candidato& - \cs{candidato}\Arg{Galileo Galilei} \\ -\cs{candidata}\t\{...\}&nessuno&Definisce il nome della candidata& - \cs{candidata}\Arg{Maria Curie} \\ -\cs{secondocandidato}\t\d\{...\}&nessuno&Se c'è , definisce il nome -del secondo candidato& - \cs{secondocandidato}\d\Arg{Evangelista Torricelli}\\ -\cs{secondacandidata}\t\d\{...\}&nessuno&Se c'è , definisce il nome -della seconda candidata& - \cs{secondacandidata}\d\Arg{Rita Levi Montalcini}\\ -\bottomrule -\end{tabular}} -\caption{Comandi per il frontespizio della monografia di laurea, della -tesi di laurea e della dissertazione di dottorato (\emph{continua})}\label{tab:front2} -\end{table} - -\addtocounter{table}{-1} -\begin{table} -\def\V{\rule{0pt}{2.5ex}} -\def\d{\discretionary{\%}{\rule{1em}{0pt}}{}}\let\t\ttfamily -\makebox[\textwidth]{% -\begin {tabular}{p{.3\textwidth}p{.175\textwidth}p{.2\textwidth}p{.275\textwidth}} -\toprule -Comando & Default & Scopo & Esempio d'uso \\ -\midrule -\cs{terzocandidato}\t\{...\} -&nessuno -& Se c'è, definisce il nome del -terzo candidato -& \cs{terzocandidato}\t\d\Arg{Alessandro~Volta} - \\ -\cs{terzacandidata}\t\{...\}&nessuno&Se c'è, definisce il nome della terza candidata& - \cs{terzacandidata}\t\d\Arg{Eleonora~Duse}\\\cs{sedutadilaurea}\t\{...\}\V&data corrente &Definisce il mese e l'anno (volendo il giorno) della seduta di laurea& - \cs{sedutadilaurea}\t\d\Arg{Dicembre~2025}\\ -\cs{esamedidottorato}\t\d\{...\}&data corrente&Definisce il mese e l'anno (volendo il giorno) della seduta di discussione& - \cs{esamedidottorato}\t\d\Arg{Febbraio~2013}\\ -\small\cs{scuoladidottorato}\t\d\{...\}& SCUOLA DI DOTTORATO&Definisce il nome ufficiale - della scuola di dottorato & - \cs{scuoladidottorato}\t\d\Arg{SCUDO}\\ -\cs{ciclodidottorato}\t\d\{...\}&nessuno&Definisce il numero ordinale del ciclo di dottorato& - \cs{ciclodidottorato}\t\d\Arg{XV~ciclo} \\ -\cs{logosede}\t[...]\{...\}&nessuno&\raggedright Inserisce nel frontespizio il logo - dell'ateneo, specificandone opzionalmente l'altezza - (default: 3\,cm)& - \cs{logosede}\t\d[2cm]\Arg{logouno,\d logodue}\\ -\cs{setlogodistance}\t\d\{...\}& 3\,em & imposta la distanza fra i loghi& - \cs{setlogodistance}\t\d\Arg{25mm}\\ -\midrule -\cs{retrofrontespizio}\t\d\{...\}& nessuno& \multicolumn2{p{.5\textwidth}}{Se specificato, serve - solitamente per scrivere nel verso - della pagina del frontespizio alcune dichiarazioni di - carattere legale; accetta un argomento composto anche da - diversi capoversi}\\ -\bottomrule -\end{tabular}} -\caption{Comandi per il frontespizio della monografia di laurea, della -tesi di laurea e della dissertazione di dottorato. Comando per comporre il verso del frontespizio.}\label{tab:front3} -\end{table} - - -\begin{table}[p]\tabcolsep=3pt -\def\V{\rule{0pt}{2.5ex}} -\def\d{\discretionary{\%}{\rule{1em}{0pt}}{}} -\def\serve{definisce una stringa equivalente a } -\makebox[\textwidth]{\small% -\begin{tabular}{@{}p{.35\textwidth}p{.63\textwidth}@{}} -\toprule -\cs{FacoltaDi}\t\{...\}\V & definisce una stringa con il nome generico della - struttura didattica, per esempio ``Scuola di~'', - prima del nome della struttura; di default è - impostata una stringa nulla, cosicché non viene - scritto nulla nel frontespizio in merito alla struttura - didattica competente\\ -\cs{StrutturaDidattica}\t\{...\} & sinonimo del comando \cs{FacoltaDi}\\ -\cs{DottoratoIn}\t\{...\} & \serve ``Dottorato in'' prima del nome del dottorato\\ -\cs{CorsoDiLaureaIn}\t\{...\} & \serve ``Corso di Laurea in'' prima del nome del corso di laurea\\ -\cs{TesiDiLaurea}\t\{...\} & \serve ``Tesi di Laurea''\\ -\cs{NomeMonografia}\t\{...\} & \serve ``Monografia di Laurea''\\ -\cs{NomeDissertazione}\t\{...\} & \serve ``Dissertazione di Dottorato''\\ -\cs{InName}\t\{...\} & \serve ``in''; in tedesco potrebbe essere ``auf'', - in francese ``en'', ecc.\\ -\cs{CandidateName}\t\{...\} & \serve ``Candidato''; per questo e i due comandi - successivi il programma riesce - a scegliere la stringa giusta adattata in numero genere; - nel cambiare queste stringhe - il compositore ha una sola possibilità e deve scegliere - direttamente il genere e il numero.\\ -\cs{AdvisorName}\t\{...\} & \serve ``Relatore''\\ -\cs{CoAdvisorName}\t\{...\} & \serve ``Correlatore''; questo comando si può usare - sempre, ma il suo contenuto viene effettivamente usato - solo se si specifica l'opzione \texttt{classica}; se in - italiano non piace ``Correlatore'' ma si preferisce - ``Corelatore'' o ``Co-relatore'', sempre con l'opzione - \texttt{classica}, si può correggere la versione di - default.\\ -\cs{TutorName}\t\{...\} & \serve ``Tutore''\\ -\cs{NomeTutoreAziendale}\t\{...\}& \serve ``Supervisore aziendale''; usando un argomento - che contenga anche - indicazioni di ``a capo'', nella seconda riga si può - scrivere il nome dell'azienda.\\ -\cs{CycleName}\t\{...\} & \serve ``ciclo''; serve essenzialmente per indicare il - ciclo di dottorato\\ -\cs{NomePrimoTomo}\t\{...\} & \serve ``Tomo primo''\\ -\cs{NomeSecondoTomo}\t\{...\} & \serve ``Tomo secondo''\\ -\cs{NomeTerzoTomo}\t\{...\} & \serve ``Tomo terzo''\\ -\cs{NomeQuartoTomo}\t\{...\} & \serve ``Tomo quarto''; tutte e quattro queste - stringhe - dipendono dalla lingua usata e dall'ordine che si vuole o - si deve dare alle due parole.\\ -\bottomrule -\end{tabular}} - \caption{Comandi per modificare le parole e/o le brevi frasi scritte -nel frontespizio o per cambiare le parole italiane di default in altre -parole diverse, o per esprimere gli stessi concetti in un'altra -lingua}\label{tab:front4} -\end{table} - -I comandi di questa sezione possono essere introdotti in un ordine qualunque, ma è più chiaro se sono introdotti nell'ordine in cui sono elencati. +I comandi di questa sezione possono essere introdotti in un ordine qualunque, ma è più chiaro se sono introdotti nell'ordine in cui sono elencati nelle tabelle~\ref{tab:front1}-\ref{tab:front4} riportate dalla pagina~\pageref{tab:front1} alla pagina~\pageref{tab:front4}. Essi possono anche essere scritti nel file di configurazione \meta{mainfile}\texttt{.cfg}, anzi, direi che è meglio che siano inseriti @@ -2217,6 +2035,194 @@ Comando\V & Scopo \\[.5ex] della tesi definiti con l'opzione \opt{classica}}\label{tab:front5} \end{table} +\clearpage + +\begin {table}[p] +\def\V{\rule{0pt}{2.5ex}} +\let\s\string\let\t\ttfamily +\def\d{\discretionary{\%}{\rule{1em}{0pt}}{}} +\makebox[\textwidth]{\tolerance=9999\finalhyphendemerits=0\relax% +\begin {tabular}{p{.3\textwidth}p{.2\textwidth}p{.2\textwidth}p{.25\textwidth}} +\toprule +Comando & Default & Scopo & Esempio d'uso \\ +\midrule +\cs{ateneo}\t\s{...\s}\V&POLITECNICO DI TORINO& Definisce il nome generico dell'Ateneo & + \cs{ateneo}\Arg{II Università di Roma} \\ +\cs{nomeateneo}\t\s{...\s}& nessuno& Definisce il nome proprio dell'Ateneo & + \cs{nomeateneo}\Arg{Tor Vergata} \\ +\cs{facolta}\t[...]\s{...\s}& nessuno & Definisce il nome della + Facoltà opzionalmente con l'indicazione dell'ordinale& + \cs{facolta}\t[III]\d\Arg{Scienze} \\ +\cs{struttura} && sinonimo del comando \cs{facolta}&\\ +\cs{corsodilaurea}\t\s{...\s}& nessuno& Definire il nome del corso di laurea & + \cs{corsodilaurea}\d\Arg{Fisica} \\ +\cs{corsodidottorato}\t\d\{...\}& nessuno&Definisce il nome del corso di dottorato& + \cs{corsodidottorato}\d\Arg{Fisica} \\ +\cs{monografia}\t\{...\}&nessuno&Definisce il titolo della monografia e imposta lo stile del frontespizio& + \cs{monografia}\d\Arg{Il~teorema di Eulero}\\ +\cs{titolo}\t[...]\{...\}&nessuno&Definisce il titolo della tesi o della dissertazione& + \cs{titolo}\t\d[La~pressione]\d\Arg{La~pressione di Giove}\\ +\cs{sottotitolo}\t\{...\} &nessuno + &Definisce il sottotitolo della tesi o della + dissertazione + & \cs{sottotitolo}\Arg{Metodo Barometrico} \\ +\cs{Materia}\t\{...\}&nessuno&Definisce la materia su cui verte la tesi & + \cs{Materia}\Arg{Remote Sensing} \\ +\cs{materia}\t\{...\}&nessuno&sinonimo del comando \cs{Materia} & + \cs{materia}\d\Arg{Letteratura ostrogota} \\ +\bottomrule +\end{tabular}} +\caption{Comandi per il frontespizio della monografia di laurea, della +tesi di laurea e della dissertazione di dottorato +(\emph{continua})}\label{tab:front1} +\end{table} + +\addtocounter{table}{-1} +\begin{table}[p] +\def\V{\rule{0pt}{2.5ex}} +\let\s\string \let\t\ttfamily +\def\d{\discretionary{\%}{\rule{1em}{0pt}}{}} +\makebox[\textwidth]{% +\begin {tabular}{p{.3\textwidth}p{.15\textwidth}p{.2\textwidth}p{.3\textwidth}} +\toprule +Comando & Default & Scopo & Esempio d'uso \\ +\midrule +\cs{relatore}\t\{...\}\V&nessuno& Definisce il nome del relatore& + \cs{relatore}\d\Arg{prof.\s~Albert Einstein} \\ +\cs{secondorelatore}\t\{...\}&nessuno&Se c'è, definisce il nome del secondo relatore& + \cs{secondorelatore}\d\Arg{dott.\s~Grazia Deledda}\\ +\cs{terzorelatore}\t\{...\}&nessuno&Se c' è, definisce il nome del +terzo relatore& + \cs{terzorelatore}\d\Arg{ing.\s~Thomas A.\s~Edison}\\ +\cs{direttore}\t\{...\}&nessuno&Definisce il nome del direttore del ciclo di dottorato& + \cs{direttore}\d\Arg{prof.\s~Albert Enstein}\\ +\cs{coordinatore}\t\{...\}&nessuno&Definisce il nome del coordinatore del ciclo di dottorato& + \cs{coordinatore}\d\Arg{prof.\s~Albert Einstein}\\ +\small\cs{QualificaDirettore}\t\d\{...\}& Direttore o Coordinatore& Definisce il titolo da inserire + prima del nome del direttore della scuola di dottorato& + \cs{QualificaDirettore}\d\Arg{PhD~Director}\\ +\cs{tutore}\t\{...\}&nessuno&Definisce il nome del tutore& + \cs{tutore}\d\Arg{prof.\s~Karl Von Braun} \\ +\cs{tutoreaziendale}\t\{...\} & nessuno& Definisce la qualifica del tutore aziendale & + \cs{tutoreaziendale}\d\Arg{Supervisore}\\ +\cs{candidato}\t\{...\}&nessuno&Definisce il nome del candidato& + \cs{candidato}\Arg{Galileo Galilei} \\ +\cs{candidata}\t\{...\}&nessuno&Definisce il nome della candidata& + \cs{candidata}\Arg{Maria Curie} \\ +\cs{secondocandidato}\t\d\{...\}&nessuno&Se c'è , definisce il nome +del secondo candidato& + \cs{secondocandidato}\d\Arg{Evangelista Torricelli}\\ +\cs{secondacandidata}\t\d\{...\}&nessuno&Se c'è , definisce il nome +della seconda candidata& + \cs{secondacandidata}\d\Arg{Rita Levi Montalcini}\\ +\bottomrule +\end{tabular}} +\caption{Comandi per il frontespizio della monografia di laurea, della +tesi di laurea e della dissertazione di dottorato (\emph{continua})}\label{tab:front2} +\end{table} + +\addtocounter{table}{-1} +\begin{table} +\def\V{\rule{0pt}{2.5ex}} +\def\d{\discretionary{\%}{\rule{1em}{0pt}}{}}\let\t\ttfamily +\makebox[\textwidth]{% +\begin {tabular}{p{.3\textwidth}p{.175\textwidth}p{.2\textwidth}p{.275\textwidth}} +\toprule +Comando & Default & Scopo & Esempio d'uso \\ +\midrule +\cs{terzocandidato}\t\{...\} +&nessuno +& Se c'è, definisce il nome del +terzo candidato +& \cs{terzocandidato}\t\d\Arg{Alessandro~Volta} + \\ +\cs{terzacandidata}\t\{...\}&nessuno&Se c'è, definisce il nome della terza candidata& + \cs{terzacandidata}\t\d\Arg{Eleonora~Duse}\\\cs{sedutadilaurea}\t\{...\}\V&data corrente &Definisce il mese e l'anno (volendo il giorno) della seduta di laurea& + \cs{sedutadilaurea}\t\d\Arg{Dicembre~2025}\\ +\cs{esamedidottorato}\t\d\{...\}&data corrente&Definisce il mese e l'anno (volendo il giorno) della seduta di discussione& + \cs{esamedidottorato}\t\d\Arg{Febbraio~2013}\\ +\small\cs{scuoladidottorato}\t\d\{...\}& SCUOLA DI DOTTORATO&Definisce il nome ufficiale + della scuola di dottorato & + \cs{scuoladidottorato}\t\d\Arg{SCUDO}\\ +\cs{ciclodidottorato}\t\d\{...\}&nessuno&Definisce il numero ordinale del ciclo di dottorato& + \cs{ciclodidottorato}\t\d\Arg{XV~ciclo} \\ +\cs{logosede}\t[...]\{...\}&nessuno&\raggedright Inserisce nel frontespizio il logo + dell'ateneo, specificandone opzionalmente l'altezza + (default: 3\,cm)& + \cs{logosede}\t\d[2cm]\Arg{logouno,\d logodue}\\ +\cs{setlogodistance}\t\d\{...\}& 3\,em & imposta la distanza fra i loghi& + \cs{setlogodistance}\t\d\Arg{25mm}\\ +\midrule +\cs{retrofrontespizio}\t\d\{...\}& nessuno& \multicolumn2{p{.5\textwidth}}{Se specificato, serve + solitamente per scrivere nel verso + della pagina del frontespizio alcune dichiarazioni di + carattere legale; accetta un argomento composto anche da + diversi capoversi}\\ +\bottomrule +\end{tabular}} +\caption{Comandi per il frontespizio della monografia di laurea, della +tesi di laurea e della dissertazione di dottorato. Comando per comporre il verso del frontespizio.}\label{tab:front3} +\end{table} + + +\begin{table}[p]\tabcolsep=3pt +\def\V{\rule{0pt}{2.5ex}} +\def\d{\discretionary{\%}{\rule{1em}{0pt}}{}} +\def\serve{definisce una stringa equivalente a } +\makebox[\textwidth]{\small% +\begin{tabular}{@{}p{.35\textwidth}p{.63\textwidth}@{}} +\toprule +\cs{FacoltaDi}\t\{...\}\V & definisce una stringa con il nome generico della + struttura didattica, per esempio ``Scuola di~'', + prima del nome della struttura; di default è + impostata una stringa nulla, cosicché non viene + scritto nulla nel frontespizio in merito alla struttura + didattica competente\\ +\cs{StrutturaDidattica}\t\{...\} & sinonimo del comando \cs{FacoltaDi}\\ +\cs{DottoratoIn}\t\{...\} & \serve ``Dottorato in'' prima del nome del dottorato\\ +\cs{CorsoDiLaureaIn}\t\{...\} & \serve ``Corso di Laurea in'' prima del nome del corso di laurea\\ +\cs{TesiDiLaurea}\t\{...\} & \serve ``Tesi di Laurea''\\ +\cs{NomeMonografia}\t\{...\} & \serve ``Monografia di Laurea''\\ +\cs{NomeDissertazione}\t\{...\} & \serve ``Dissertazione di Dottorato''\\ +\cs{InName}\t\{...\} & \serve ``in''; in tedesco potrebbe essere ``auf'', + in francese ``en'', ecc.\\ +\cs{CandidateName}\t\{...\} & \serve ``Candidato''; per questo e i due comandi + successivi il programma riesce + a scegliere la stringa giusta adattata in numero genere; + nel cambiare queste stringhe + il compositore ha una sola possibilità e deve scegliere + direttamente il genere e il numero.\\ +\cs{AdvisorName}\t\{...\} & \serve ``Relatore''\\ +\cs{CoAdvisorName}\t\{...\} & \serve ``Correlatore''; questo comando si può usare + sempre, ma il suo contenuto viene effettivamente usato + solo se si specifica l'opzione \texttt{classica}; se in + italiano non piace ``Correlatore'' ma si preferisce + ``Corelatore'' o ``Co-relatore'', sempre con l'opzione + \texttt{classica}, si può correggere la versione di + default.\\ +\cs{TutorName}\t\{...\} & \serve ``Tutore''\\ +\cs{NomeTutoreAziendale}\t\{...\}& \serve ``Supervisore aziendale''; usando un argomento + che contenga anche + indicazioni di ``a capo'', nella seconda riga si può + scrivere il nome dell'azienda.\\ +\cs{CycleName}\t\{...\} & \serve ``ciclo''; serve essenzialmente per indicare il + ciclo di dottorato\\ +\cs{NomePrimoTomo}\t\{...\} & \serve ``Tomo primo''\\ +\cs{NomeSecondoTomo}\t\{...\} & \serve ``Tomo secondo''\\ +\cs{NomeTerzoTomo}\t\{...\} & \serve ``Tomo terzo''\\ +\cs{NomeQuartoTomo}\t\{...\} & \serve ``Tomo quarto''; tutte e quattro queste + stringhe + dipendono dalla lingua usata e dall'ordine che si vuole o + si deve dare alle due parole.\\ +\bottomrule +\end{tabular}} + \caption{Comandi per modificare le parole e/o le brevi frasi scritte +nel frontespizio o per cambiare le parole italiane di default in altre +parole diverse, o per esprimere gli stessi concetti in un'altra +lingua}\label{tab:front4} +\end{table} + + \chapter*{Conclusioni} \addcontentsline{toc}{chapter}{Conclusioni} diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf Binary files differindex bee34e99550..8e1f68d3ac2 100644 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf |