summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.tex')
-rw-r--r--Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.tex320
1 files changed, 213 insertions, 107 deletions
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 4e8b8fe77e0..db814e74dc3 100644
--- a/Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.tex
+++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.tex
@@ -20,15 +20,16 @@
% http://www.latex-project.org/
%
\documentclass[12pt,twoside]{toptesi}
-\ProvidesFile{toptesi-it.tex}[2014 v,099b]
+\ProvidesFile{toptesi-it.tex}[2014 v,099c]
\setmainfont[Ligatures=TeX]{TeX Gyre Termes}
\setsansfont[Ligatures=TeX, Scale=MatchLowercase]{TeX Gyre Heros}
\setmonofont{UM Typewriter}
+\setmainlanguage[babelshorthands]{italian}
\usepackage{amsmath}
\usepackage{unicode-math}
\setmathfont{XITS Math}
-\usepackage{metalogo}
-\usepackage{longtable,booktabs,fancyvrb}
+\usepackage{metalogo,mflogo}
+\usepackage{longtable,booktabs,array,tabularx,fancyvrb}
\usepackage{guit}
\usepackage{imakeidx}
\usepackage{hyperref}
@@ -42,7 +43,7 @@
urlcolor={blue}
}
-\makeindex[intoc,columns=1]
+\makeindex[intoc,columns=2]
\newcommand*\prog[1]{\textsf{#1}\index{programma!#1@\textsf{#1}}}
\newcommand*\pack[1]{\textsf{\slshape#1}\index{pacchetto!#1@\textsf{\slshape#1}}}
@@ -73,6 +74,7 @@
\def\fileinfo{##3}}%
\edef\@tempa{\csname ver@#1\endcsname}%
\expandafter\@tempb\@tempa\relax? ? \relax\relax}
+
\begin{document}
%
@@ -89,12 +91,14 @@
\bigskip
\hrule
\clearpage
+\ifbool{@twoside}{\thispagestyle{empty}\null\clearpage}{}
\frontespizio
+
\sommario
Questo testo serve per descrivere come comporre tipograficamente la tesi di laurea o la monografia o la dissertazione di dottorato mediante il noto programma di composizione \LaTeX, o meglio, mediante le sue varianti \pdfLaTeX, \XeLaTeX\ o \LuaLaTeX; per produrre con \XeLaTeX\ il file finale in formato PDF archiviabile secondo la norma ISO \mbox{19005-1} bisogna procedere attraverso il programma \prog{ghostscript} e le indicazioni contenute nel paragrafo~\ref{sec:XePDFA}.
@@ -108,8 +112,11 @@ This text describes how to typeset a university master thesis, or the bachelor f
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}.}.
+\figurespagetrue
+\tablespagetrue
\indici
+
\chapter{Guida rapida all'uso di questo manuale}
Nella pagina~\pageref{warn:avvertenza} c'è scritto in rosso quanto segue.
\begin{quote}{\color{red}Dopo avere letto un po' di documentazione e aver giocato un poco con i programmi già predisposti sia dalla distribuzione del sistema \TeX\ sia dai vari editor ASCII, siete in grado di capire come funziona il tutto.
@@ -145,9 +152,9 @@ TOPtesi serve anche per fornire alcune altre semplici estensioni che rendono piÃ
Come tutti i pacchetti che estendono la funzionalità di \LaTeX, TOPtesi definisce la geometria della pagina e dispone le informazioni accessorie come le testatine e i piedini. Queste impostazioni non sono modificabili né con TOPtesi né con la maggior parte degli altri pacchetti destinati alle tesi. Vale il concetto ``prendere o lasciare''.
-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}, \file{toptesi-example-con-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.
+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 nei modelli.\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.
@@ -162,7 +169,7 @@ Il paragrafo~\ref{sec:cominciare} espone come impostare inizialmente il document
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: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 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.
Per la questione codifiche e la questione lingue, che sono due aspetti che hanno forti collegamenti, è opportuno tenere presenti le seguenti considerazioni.
@@ -174,10 +181,10 @@ Infine il capitolo~\ref{cap:comandispecifici} contiene tutti i comandi e gli amb
\section{Errori da evitare}
-Tuttavia si abbia anche cura di \textcolor{red}{non copiare nel preambolo di una tesi da comporre con TOPtesi un preambolo recuperato dalla tesi di un amico o, peggio ancora, dalla rete!}. Sarebbe una operazione fonte di molte delusioni, perché da una parte potrebbero venire caricati pacchetti incompatibili con TOPtesi, dall'altro alcuni comandi di TOPtesi ne potrebbero venire modificati con funzionalità diverse da quelle previste per TOPtesi.
+Tuttavia si abbia anche cura di \textcolor{red}{non copiare nel preambolo di una tesi da comporre con TOPtesi un preambolo recuperato dalla tesi di un amico o, peggio ancora, dalla rete!}. Sarebbe una operazione fonte di molte delusioni, perché da una parte potrebbero venire caricati pacchetti incompatibili con TOPtesi, dall'altro alcuni comandi di TOPtesi ne potrebbero venire modificati con funzionalità diverse da quelle previste per TOPtesi. Potrebbero anche manifestarsi dei conflitti fra pacchetti caricati nel preambolo e quelli già caricati da TOPtesi.
\section{Pacchetti già caricati da TOPtesi}
-Vale la penda di elencare i pacchetti già caricati dalla classe \class{toptesi}, al fine di evitare di ricaricarli nel preambolo.
+Vale la pena di elencare i pacchetti già caricati dalla classe \class{toptesi}, al fine di evitare di ricaricarli nel preambolo.
\begin{description}\def\Item[#1]{\item[\normalfont\pack{#1}]}
\Item[toptesi] è il file di macro di TOPtesi; potrebbe anche essere usato con una classe diversa da \class{toptesi}.
%
@@ -185,17 +192,18 @@ Vale la penda di elencare i pacchetti già caricati dalla classe \class{toptesi}
%
\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[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 se ne può inibile 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}.
+\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.
%
\Item[topcoman] un piccolo pacchetto che contiene alcuni comandi utili in generale, non solo per l'uso con TOPtesi. Non è possibile inibirne il caricamento, ma spero che provveda da solo a non entrare in conflitto con altri pacchetti; finora non ho incontrato conflitti.
%
\Item[ifxetex] serve per distinguere il motore di composizione con cui si compila la tesi.
%
-\item[\normalfont\meta{nome del main file}.\file{cfg}] Il file di configurazione specifico per una data tesi viene caricato solo se esiste nella medesima cartella dove risiede il main file della tesi stessa.
+\item[\normalfont\meta{nome del main file}\file{.cfg}] Il file di configurazione specifico per una data tesi viene caricato solo se esiste nella medesima cartella dove risiede il main file della tesi stessa.
%
-\Item[babel] viene caricato con le opzioni \opt{english,italian}, cosicché l'italiano risulta svolgere le funzioni della lingua principale; questo pacchetto viene caricato solo se si compone la tesi con \pdfLaTeX, e TOPtesi riconosce da solo quale sia il motore di composizione usato.
+\Item[babel] viene caricato con le opzioni \opt{english}, \opt{italian}, cosicché l'italiano risulta svolgere le funzioni della lingua principale; questo pacchetto viene caricato solo se si compone la tesi con \pdfLaTeX, e TOPtesi riconosce da solo quale sia il motore di composizione usato.
%
-\Item[polyglossia] viene caricato solo se la tesi viene composta con \XeLaTeX\ o \LuaLaTeX. L'italiana viene specificato come lingua principale, e l'inglese come altra lingua.
+\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.
%
@@ -216,9 +224,9 @@ Si noti: non sono precaricati i pacchetti \pack{inputenc} per definire la codifi
È voluto: \pack{inputenc} non deve essere caricato se si usano \XeLaTeX\ o \LuaLaTeX, ma in entrambi i casi l'editor che si usa per comporre il file sorgente \emph{deve} essere configurato in modo che salvi i file sorgente con la codifica \opt{utf8}. Con \pdfLaTeX\ ci sarebbe una certa libertà nello scegliere la codifica d'entrata, ma, insisto, sarebbe meglio in ogni caso evitare di usare qualunque altra codifica diversa da \opt{utf8}.
-Per i font di uscita la o le codifiche da specificare dipendono dalle lingue usate; ripeto la raccomandazione di preferire i font espressamente confezionati per l'uso con \pdfLaTeX, quando si compone con questo programma; se si usano i programmi \XeLaTeX\ o \LuaLaTeX\ si abbia l'accortezza di usare il pacchetto \pack{fontspec} specificandogli le opzioni giuste e caricando poi, mediante se sue funzionalità, i font OpenType di cui si sia accertata la presenza sulla propria macchina, e si sia verificato che contengono tutti i glifi che si intendono usare nella tesi. Tanto per citare l'importanza di questa verifica, questi programmi lavorano di default con i font Latin Modern, che, come dice il nome, contengono \emph{solo} i caratteri latini. se ci fosse bisogno di scrivere in greco o in cirillico, per esempio, allora i font OpenType UCM (distribuiti con il sistema \TeX\ completo e aggiornato) contengono anche questi alfabeti.
+Per i font di uscita la o le codifiche da specificare dipendono dalle lingue usate; ripeto la raccomandazione di preferire i font espressamente confezionati per l'uso con \pdfLaTeX, quando si compone con questo programma; se si usano i programmi \XeLaTeX\ o \LuaLaTeX\ si abbia l'accortezza di usare il pacchetto \pack{fontspec} specificandogli le opzioni giuste e caricando poi, mediante se sue funzionalità, i font OpenType di cui si sia accertata la presenza sulla propria macchina, e si sia verificato che contengono tutti i glifi che si intendono usare nella tesi. Tanto per citare l'importanza di questa verifica, questi programmi lavorano di default con i font Latin Modern, che, come dice il nome, contengono \emph{solo} i caratteri latini. Se ci fosse bisogno di scrivere in greco o in cirillico, per esempio, allora i font OpenType UCM (distribuiti con il sistema \TeX\ completo e aggiornato) contengono anche questi alfabeti.
-Ecco quindi che la specificazione delle codifiche dei font di uscita è importante per \pdfLaTeX\ perché con questo programma i font predefiniti sono i Computer Modern codificati in \opt{OT1}, cioè mancano di qualunque segno accentato e non sono nemmeno completamente compatibili con la codifica \acro{ascii}. Questi font preimpostati potevano (forse) andare bene ai primordi dell'esistenza del sistema \TeX\ ma non vanno bene oggi nemmeno per l'inglese, visto che anche in inglese si fanno citazioni di testi o di nomi di persone in lingue straniere che usano di caratteri latini accentati.
+Ecco quindi che la specificazione delle codifiche dei font di uscita è importante per \pdfLaTeX\ perché con questo programma i font predefiniti sono i Computer Modern codificati in \opt{OT1}, cioè mancano di qualunque segno accentato e non sono nemmeno completamente compatibili con la codifica \acro{ascii}. Questi font preimpostati potevano (forse) andare bene ai primordi dell'esistenza del sistema \TeX\ ma non vanno bene oggi nemmeno per l'inglese, visto che anche in inglese si fanno citazioni di testi o di nomi di persone in lingue straniere che usano caratteri latini accentati.
Per motivi diversi non si sono caricati i pacchetti per la composizione della matematica estesa, \pack{amsmath}, \pack{amssymb} (che a sua volta carica \pack{amsfonts}); né i pacchetti \pack{amsthm} per la definizione di enunciati come teoremi, lemmi corollari, definizioni e simili, né il pacchetto \pack{bm} per comporre in neretto simboli isolati di una espressione matematica.
@@ -234,7 +242,7 @@ Se il laureando va a cercare in rete altri pacchetti per comporre tesi, si trova
Nel capitolo~\ref{cap:comandispecifici} sono descritti i comandi specifici e gli ambienti introdotti da TOPtesi in aggiunta a quelli della classe \class{report} o quelli della classe \class{report} che sono stati modificati da TOPtesi.
-La maggior parte di questi comandi si riferisce alla compilazione del frontespizio, ma è bene che il laureando li abbia sempre a portata di mano per poter eseguire le molteplici personalizzazioni che sono offerte da TOPtesi, in particolare dal pacchetto \pack{topfront}. Quel capitolo contiene anche le figure che rappresentano quattro tipici frontespizi in italiano, per elaborati finali della laurea triennale, per la laurea magistrale, per la dissertazione dottorale, sia svolte in singoli atenei, sia svolte in atenei associati. Sia con i loghi in testa alla pagina sia con questi loghi nella metà inferiore della pagina. Sono tante varianti che possono soddisfare molte esigenze, ma che evidentemente non le soddisfano tutte. Ma queste sono quelle previste e il pacchetto \pack{topfront} non è abbastanza elastico per gestirne altre. Se si vogliono stili diversi esiste sempre il pacchetto \pack{frontespizio} creato apposta da un altro docente universitario di un altro ateneo, quindi con un'altra visione d'insieme sull'aspetto dei frontespizi. Infine esiste sempre la possibilità di usare l'ambiente \amb{titlepage} per creare il frontespizio con modalità assolutamente libere nella loro disposizione.
+La maggior parte di questi comandi si riferisce alla compilazione del frontespizio, ma è bene che il laureando li abbia sempre a portata di mano per poter eseguire le molteplici personalizzazioni che sono offerte da TOPtesi, in particolare dal pacchetto \pack{topfront}. Quel capitolo contiene anche le figure che rappresentano otto tipici frontespizi in italiano, per elaborati finali della laurea triennale, per la laurea magistrale, per la dissertazione dottorale, sia svolte in singoli atenei, sia svolte in atenei associati. Sia con i loghi in testa alla pagina sia con questi loghi nella metà inferiore della pagina. Sono tante varianti che possono soddisfare molte esigenze, ma che evidentemente non le soddisfano tutte. Queste sono quelle previste e il pacchetto \pack{topfront} non è abbastanza elastico per gestirne altre. Se si vogliono stili diversi esiste sempre il pacchetto \pack{frontespizio} creato apposta da un altro docente universitario di un altro ateneo, quindi con un'altra visione d'insieme sull'aspetto dei frontespizi. Infine esiste sempre la possibilità di usare l'ambiente \amb{titlepage} per creare il frontespizio in modo assolutamente libero da ogni vincolo.
In questo capitolo sono anche rappresentati i quattro frontespizi fondamentali nella figura~\ref{fig:frontespizi}; è importante avere queste quattro figurine sotto gli occhi per sapere come comporre il proprio frontespizio in modo che corrisponda alle prescrizioni del proprio ateneo.
@@ -266,8 +274,7 @@ detti anche ``word processor'', che fanno parte più o meno di
default di ogni dotazione iniziale di qualsiasi PC di qualunque
marca e con qualunque sistema operativo.
-Fra i vari programmi di elaborazione testi, uno in particolare
-spicca per la sua particolarità: \LaTeX. Veramente esso non è un programma di elaborazione testi, anche se a prima vista lo sembrerebbe, visto che serve per elaborare testi; ma il suo scopo non è finalizzato al testo in quanto tale, bensì alla sua composizione tipografica; esso è un programma di \emph{tipocomposizione}.
+Fra i vari programmi disponibili, uno in particolare spicca per la sua particolarità: \LaTeX. Veramente esso non è un programma di elaborazione testi, anche se a prima vista lo sembrerebbe; il suo scopo non è finalizzato al testo in quanto tale, bensì alla sua composizione tipografica; esso è un programma di \emph{tipocomposizione}.
\LaTeX\ è nato come
sovrastruttura di un altro programma, \TeX, che continua ad
@@ -481,9 +488,9 @@ Merita qui segnalare con una tabellina le principali differenze fra \pdfLaTeX\ e
\chapter{L'uso di \textsf{TOPtesi}}\label{cap:uso}
-la maggior parte delle macro definite nel Pacchetto TOPtesi servono per comporre il frontespizio; siccome l'utente potrebbe desiderare comporre il frontespizio in modo diverso da quello preimpostato in questa classe, prima esporrò come e perché la classe si comporta in un certo modo per comporre questa prima e importante pagina della tesi, poi esporrò che cosa bisogna fare se si usano altri pacchetti o altre tecniche per comporre il frontespizio.
+la maggior parte delle macro definite nel pacchetto TOPtesi servono per comporre il frontespizio; siccome l'utente potrebbe desiderare comporre il frontespizio in modo diverso da quello preimpostato in questa classe, prima esporrò come e perché la classe si comporta in un certo modo per comporre questa prima e importante pagina della tesi, poi esporrò che cosa bisogna fare se si usano altri pacchetti o altre tecniche per comporre il frontespizio.
-Ci si ricordi comunque che l'aspetto generale dalla pagina, i font usati o gli altri font alternativi che si possono usare, il frontespizio, e altri elementi che costituiscono il ``look' della tesi composta con questa classe, sono abbastanza rigidi; non dico che questa classe sia rigorosamente del tipo ``prendere o lasciare'', ma sicuramente non è un classe generica da poter personalizzare a piacere in ogni dettaglio. Ci sono altre classi disponibili già distribuite con il sistema \TeX\ (aggiornato e completo); ne cito alcune: i modelli \file{TesiClassica} e \file{TesiModerna} (non distribuiti con il sistema \TeX, ma scaricabili dalla sezione Documentazione del sito \url{www.guitex.org}); la classe \class{sapthesis}, impostata sulle prescrizioni dell'università di Roma La~Sapienza, la classe \class{suftesi}, che in realtà non serve solo per comporre tesi, ma serve anche per comporre diversi altri tipi di documenti in diversi formati e con diversi stili; il pacchetto \pack{ClassicThesis} che richiede la classe \class{scrreprt}, dall'aspetto molto bello, ma potrebbe non essere adatta per tesi nelle discipline delle scienze sperimentali. Nessuna di queste classi è configurabile a piacere, ma solo nei limiti delle personalizzazioni previste. Quella più configurabile mi pare sia la classe \class{suftesi}, ma anche questa classe, esplicitamente predisposta per tesi nel campo delle scienze umane, forse è meno flessibile per le scienze sperimentali.
+Ci si ricordi comunque che l'aspetto generale dalla pagina, i font usati o gli altri font alternativi che si possono usare, il frontespizio, e altri elementi che costituiscono il ``look' della tesi composta con questa classe, sono abbastanza rigidi; non dico che questa classe sia rigorosamente del tipo ``prendere o lasciare'', ma sicuramente non è una classe generica da poter personalizzare a piacere in ogni dettaglio. Ci sono altre classi disponibili già distribuite con il sistema \TeX\ (aggiornato e completo); ne cito alcune: i modelli \file{TesiClassica} e \file{TesiModerna} (non distribuiti con il sistema \TeX, ma scaricabili dalla sezione Documentazione del sito \url{www.guitex.org}); la classe \class{sapthesis}, impostata sulle prescrizioni dell'università di Roma La~Sapienza, la classe \class{suftesi}, che in realtà non serve solo per comporre tesi, ma serve anche per comporre diversi altri tipi di documenti in diversi formati e con diversi stili; il pacchetto \pack{ClassicThesis} che richiede la classe \class{scrreprt}, dall'aspetto molto bello, ma potrebbe non essere adatta per tesi nelle discipline delle scienze sperimentali. Nessuna di queste classi è configurabile a piacere, ma solo nei limiti delle personalizzazioni previste. Quella più configurabile mi pare sia la classe \class{suftesi}, ma anche questa classe, esplicitamente predisposta per tesi nel campo delle scienze umane, forse è meno flessibile per le scienze sperimentali.
@@ -529,13 +536,14 @@ Tutti i file del pacchetto \textsf{TOPtesi} vengono caricati nell'albero della d
\subsection{Il file di configurazione}\label{sec:configurazione}
-È 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.
+È 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 il comando \cs{frontespizio}.
+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}.
-{\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 mettete 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 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}
-Nota bene: il pacchetto \pack{TOPfront} che contiene i comandi per la composizione del frontespizio oltre al comando per caricare l'eventuale file di configurazione, chiam quest'ultimo file col nome |\jobname.cfg|. La macro |\jobname| è la stessa usata dal \LaTeX per conservare il nome senza estensione del min file del documento che si sta componendo; quindi se il main file si chiamasse \texttt{GiorgioRossiTesiMagisrale.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 fiel, 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.
+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.
\section{Pronti? Via!}
@@ -553,50 +561,65 @@ solo purché non lo si disturbi con interventi non professionali; se non siete u
\section{I file accessori}
-\subsection{Comporre il solo frontespizio con TOPfront}
+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.
+
+\subsection{Comporre il frontespizio con topfront}\label{sec:frontespizi}
-Il pacchetto \textsf{TOPtesi} contiene fra le sue parti il file
+Il pacchetto TOPtesi contiene fra le sue parti il file
\pack{topfront} che serve solo per comporre il
-frontespizio può essere usato per comporre il solo frontespizio, ma in questo caso, talvolta, può essere meglio ricorrere a quanto esposto nel paragrafo\ref{sec:solofrontespizio}. In questo paragrafo, comunque spiego come comporre il frontespizio separatamente dalla tesi usando questo pacchetto \pack{topfront}.
+frontespizio; può essere usato per comporre il solo frontespizio separatamente dalla tesi, ma in questo caso, talvolta, può essere meglio ricorrere a quanto esposto nel paragrafo~\ref{sec:solofrontespizio}.
+
+In questo paragrafo, comunque spiego come comporre il frontespizio indipendentemente dal fatto che rappresenti il frontespizio isolato della tesi o sia quello della tesi intera.
Questo pacchetto in effetti, oltre a leggere l'eventuale file di
configurazione, contiene solo i comandi per definire gli elementi
-del frontespizio e per comporlo. La cosa può tornare utile in
+del frontespizio e per comporlo.
+
+Comporre il frontespizio isolatamente può tornare utile in
diverse circostanze, per esempio quando si deve ancora modificare
la tesi quasi ultimata, ma è necessario cercare il o i relatori per far
loro firmare alcune copie del solo frontespizio.
Basta predisporre un piccolo file come questo, salvandolo con un nome a
piacere, per esempio, con grande fantasia, \file{myfile.tex}:
-\begin{verbatim}
-% !TEX TS-program = XeLaTeX
-% !TEX encoding = UTF-8 Unicode
+\begin{flushleft}\ttfamily\obeylines
+\% !TEX TS-program = XeLaTeX
+\% !TEX encoding = UTF-8 Unicode
+
+\verb|\documentclass[12pt]{toptesi}|
+\verb|%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%|
+\% Impostazioni per comporre con XeLaTeX
+\verb|\setmainfont[Ligatures=TeX]{TeX Gyre Termes}% o altro font|
+\verb|\setmainlanguage{italian}% o altra lingua|
+\verb|%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%|
+~
+\meta{il resto del preambolo}
+~
+\verb|\begin{document}|
+~
+\verb|\begin{frontespizio*}|
+\verb|\ateneo{Università di Marconia}|
+\verb|\logosede{logouno}|
+\verb|%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Tesi magistrale|
+\verb|\corsodilaurea{delle Telecomunicazioni}|
+\verb|\titolo{Titolo della tesi\\ di laurea magistrale}|
+\verb|\sottotitolo{Sottotitolo della tesi di laurea magistrale}|
+\verb|\relatore{prof.\ Enrico Rosa}|
+\verb|\sedutadilaurea{Dicembre 2114}|
+\verb|\candidata{Susanna Rossi}|
+\verb|\secondacandidata{Laura Bruni}|
+\verb|%\retrofrontespizio{...}|
+\verb|\end{frontespizio*}|
+~
+\meta{il resto della tesi}
+~
+\verb|\end{document}|
+\end{flushleft}
-\documentclass[12pt]{toptesi}
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-% Impostazioni per comporre con XeLaTeX
-\setmainfont[Ligatures=TeX]{TeX Gyre Termes}% o altro font
-\setmainlanguage{italian}% o altra lingua
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+La parte che ho indicato con \meta{il resto del preambolo} e \meta{il resto della tesi} sono facoltative; certo sono necessarie quando si compone l'intera tesi; per comporre il solo frontespizio si possono omettere.
-\begin{document}
-\ateneo{Università di Marconia}
-\logosede{logouno}
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Tesi magistrale
-\corsodilaurea{delle Telecomunicazioni}
-\titolo{Titolo della tesi\\ di laurea magistrale}
-\sottotitolo{Sottotitolo della tesi di laurea magistrale}
-\relatore{prof.\ Enrico Rosa}
-\sedutadilaurea{Dicembre 2114}
-\candidata{Susanna Rossi}
-\secondacandidata{Laura Bruni}
-%\retrofrontespizio{...}
-\frontespizio*
-\end{document}
-\end{verbatim}
+Perciò bisogna fare attenzione: se si compone il frontespizio separatamente dalla tesi, la riga \cs{documentclass} deve essere identica alla corrispondente riga del vostro main file della tesi; siccome \pack{toptesi} può usare diversi formati di carta, è necessario che il frontespizio sia composto su carta dello stesso formato. Non è invece necessario usare come font normale un font dello stesso corpo della tesi; con carte particolarmente piccole potrebbe essere più opportuno usare il corpo di 10\,pt invece che quello di 12\,pt. Se dovete scrivere in inglese o in un'altra lingua specificatelo con \cs{setmainlanguage}. Si noti che l'esempio precedente è impostato per comporre il frontespizio con \XeLaTeX, ma se si lavora con \pdfLaTeX, allora vanno specificati i font da usare, e le codifiche di entrata e di uscita; bisogna anche impostare la lingua nella maniera specifica di \pack{babel}. Non scendo nei dettagli, perché fra i vari modelli forniti con il pacchetto TOPtesi, ce ne sono alcuni predisposti per lavorare con \pdfLaTeX\ e altri con \XeLaTeX\ (o \LuaLaTeX).
-Attenzione: la riga \cs{documentclass} deve essere identica alla corrispondente riga del vostro main file; siccome \pack{toptesi} può usare diversi formati di carta, è necessario che il frontespizio sia composto su carta dello stesso formato. Non è invece necessario usare come font normale un font dello stesso corpo della tesi; con carte particolarmente piccole potrebbe essere più opportuno usare il corpo di 10\,pt invece che quello di 12\,pt. Se dovete scrivere in inglese o in un'altra lingua specificatelo con \cs{setmainlanguae}. Si noti che l'esempio precedente è impostato per comporre il frontespizio con \XeLaTeX, ma se si lavora con \pdfLaTeX, allora vanno specificati i font da usare, e le codifiche di entrata e di uscita; bisogna anche impostare la lingua nella maniera specifica di \pack{babel}. Non scendo nei dettagli, perché fra i vari modelli forniti con il pacchetto TOPtesi, ce ne sono alcuni predisposti per lavorare con \pdfLaTeX\ e altri con \XeLaTeX (o \LuaLaTeX).
-
-Comunque se si vuole usare \prog{pdflatex} la parte fra le due righe \verb|%%%|
+Comunque, se si vuole usare \prog{pdflatex}, la parte fra le prime due righe \verb|%%%|
va sostituita, per esempio, con:
\begin{verbatim}
\usepackage[utf8]{inputenc}
@@ -605,7 +628,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 il comando \cs{frontespizio} o \cs{frontespizio*}, 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 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}
@@ -625,10 +648,10 @@ In realtà il pacchetto \pack{topfront} lavora bene in italiano e distingue i si
\logosede{logouno,logodue}% one logo or a comma separated list of logos
\end{Verbatim}
-Passando uno di questi piccoli file a \prog{xelatex} o a \prog{pdflatex}, si ottiene
-un documento di una o due pagine, il frontespizio e, facoltativamente, il retrofrontespizio, che si possono stampare in varie copie per gli scopi detti sopra. Ricordate che \class{toptesi} pre"carica \pack{babel} o \pack{polyglossia} a seconda che usiate \prog{pdflatex} oppure \prog{xelatex}; non avete quindi l'obbligo di invocare di nuovo questi pacchetti se componete il solo frontespizio usando \class{toptesi}, ma dovete specificare la lingua che volete usare nei modi descritti sopra.
+Passando uno di questi file a \prog{xelatex} o a \prog{pdflatex}, si ottiene
+un documento con il frontespizio e, facoltativamente, il retrofrontespizio, che si possono stampare in varie copie per gli scopi detti sopra. Ricordate che \class{toptesi} precarica \pack{babel} o \pack{polyglossia} a seconda che usiate \prog{pdflatex} oppure \prog{xelatex}; non avete quindi l'obbligo di invocare di nuovo questi pacchetti se componete il solo frontespizio usando \class{toptesi}, ma dovete specificare la lingua che volete usare nei modi descritti sopra.
-Il retrofrontespizio non è necessario in senso assoluto quando volete produrre il frontespizio isolato. Non è nemmeno necessario quando volete comporre la tesi. Tuttavia il comando è disponibile e permette di aggiungere la dichiarazione legale in merito alla licenza; il retrofrontespizio di questa documentazione è stato composto con i comandi seguenti\footnote{Siccome questo codice contiene dei comandi \cs{ref}, può essere usato solo nella composizione del corpo della tesi dove le etichette invocate sono definite; se si vuole usare questo codice per comporre il retrofrontespizio assieme al frontespizio, ma isolatamente dalla tesi (lo sconsiglio), bisogna sostituire quei comandi e i loro argomenti con i valori reali.}:
+Il retrofrontespizio non è necessario in senso assoluto quando volete produrre il frontespizio isolato. Non è nemmeno necessario quando volete comporre la tesi. Tuttavia il comando è disponibile e permette di aggiungere la dichiarazione legale in merito alla licenza; il retrofrontespizio di questa documentazione è stato composto con i comandi seguenti\footnote{Questo codice contiene dei comandi \cs{ref} perché è servito per comporre l'intero documento dove le etichette invocate sono definite. Se si vuole usare questo codice per comporre il retrofrontespizio assieme al frontespizio, ma isolatamente dalla tesi (lo sconsiglio), bisogna sostituire quei comandi e i loro argomenti con i valori reali.}:
\begin{verbatim}
\retrofrontespizio{Questo testo è libero secondo le condizioni
stabilite dalla \LaTeX\ Project Public Licence (LPPL) riportata
@@ -641,10 +664,78 @@ nell'appendice~\ref{ch:LPPL} alla pagina~\pageref{ch:LPPL}.
\end{verbatim}
-Non dovete dimenticare che, se volete usare \prog{xelatex}, l'editor con cui scrivete questo piccolo file (e con il quale avete eventualmente scritto il file \meta{mainfile}\texttt{.cfg}) deve essere configurato con la codifica \texttt{UTF-8}.
+Non dovete dimenticare che, se volete usare \prog{xelatex}, l'editor con cui scrivete i vostri file deve essere configurato per registrarli sul disco fisso con la codifica \texttt{UTF-8}.
+
+Nell'esempio di frontespizio presentato sopra si è usato l'ambiente \amb{frontespizio*} che è una novità a partire dalla versione del pacchetto TOPtesi 5.85. I comandi \cs{frontespizio} e \cs{frontespizio*} funzionano ancora, ma suggerisco di usare gli ambienti.
+
+Vediamo le differenze: nella figura~\ref{fig:4frontespizi} si vedono sempre i loghi all'inizio della pagina, non ci sono filetti di nessun genere, il nome dell'università ci può essere o può mancare, le diverse tipologie di tesi hanno informazioni diverse. I loghi sono tutti in testa alla pagina ma potrebbero essere anche nella parte inferiore; la differenza dipende dall'usare l'ambiente \amb{frontespizio} che mette i loghi in testa, o l'ambiente \amb{frontespizio*} che mette i loghi nella parte inferiore della pagina; la figura~\ref{fig:frontespizi} nella pagina~\pageref{fig:frontespizi}, infatti, mostra i fontespizi di sinistra che sono stati composti con l'ambiente \amb{frontespizio} e quelli di destra composti con l'ambiente \amb{frontespizio*}. Il nome dell'ateneo appare o non appare a seconda che il comando \cs{ateneo} contenga un argomento vuoto o un argomento con un nome esplicito. Le altre informazioni dipendono da quali comandi si sono usati per caratterizzare la tesi triennale, magistrale o dottorale. Questi comandi verrano descritti dettagliatamnte più avanti.
+
+\begin{figure}[p]\centering
+\includegraphics[height=0.875\textheight]{FrontespiziAssemblati1}
+\caption[Frontespizi composti con lo stile standard]{Frontespizi composti con lo stile standard. In questo stile mancano i filetti e i loghi delle università possono essere messi in posti diversi della pagina; il nome dell'università può essere presente esplicitamente oppure può essere compreso nel logo.}\label{fig:4frontespizi}
+\end{figure}
-\subsection{I comandi accessori di TOPcoman}
+Nella figura~\ref{fig:altri4frontespizi} sono mostrati invece i quattro frontespizi che si ottengono quando alla classe (o anche al solo modulo \pack{topfront} quando lo si usa con una classe diversa da \class{toptesi}) viene specificata l'opzione \opt{classica}. Si nota che il nome dell'ateneo è separato dal resto della pagina da un filetto orizzontale; analogamente l'anno accademico in calce alla pagina è separato da un filetto orizzontale. I candidati sono chiamati ``Laureandi''. Il blocco contenente i nomi dei relatori e correlatori e quello contenente i nomi dei laureandi sono allineati superiormente e non sono sfasati come nello stile standard. La seduta di esame è indicata con la dicitura ``Anno accademico'' in maiuscoletto e l'anno, o l'intervallo di anni è indicato con le cifre arabe minuscole (old style). Con questo stile più classico, il logo o i loghi sono collocati fra i titolo e i blocchi dei relatori e dei laureandi.
+
+Si noti infine che in entrambi gli stili esistono esempi con due loghi, per i quali i nomi dei due atenei vanno scritti in forma un poco ellittica, ma piuttosto antiestetica; in generale potrebbero formare una riga così lunga da non entrare nella pagina fisica.
+
+Lo si potrebbe considerare una ``feature'', una particolarità del pacchetto TOPtesi. In realtà non conosco altre classi o moduli di estensione dove sia possibile fare riferimento a diversi loghi e a diversi nomi.
+
+Quello che consiglierei in questi casi sarebbe di aggiungere il nome dell'ateneo al logo, se già non lo contenesse, e lo farei un con un font di contrasto, per esempio con un font senza grazie maiuscolo o maiuscoletto con iniziali maiuscole, magari su due righe collocato sotto il logo vero che non contenga a sua volta già il nome dell'ateneo; come per esempio nel logo modificato mostrato nella figura~\ref{fig:logomodificato}.
+
+\begin{figure}
+\centering
+\begin{minipage}[t]{30mm}\centering
+\includegraphics[width=30mm]{logodue}\\[3pt]
+\fontsize{17}{16}\sffamily U\simulatedSC{NIVERSITÀ}\\
+\simulatedSC{DI} M\simulatedSC{ARCONIA}
+\end{minipage}
+\caption{Un logo modificato con l'aggiunta del nome dell'ateneo}\label{fig:logomodificato}
+\end{figure}
+
+Fatta questa modifica per tutti i loghi privi del nome dell'università che è necessario usare, si compone il frontespizio con lo stile standard usando semplicemente un nome vuoto come argomento di \cs{ateneo}. Si veda poco più avanti come usare una pluralità di loghi.
+
+
+Vale la pena di ricordare che la retrocompatibilità con i comandi \cs{frontespizio} e \cs{frontespizio*} è conservata.
+
+Perciò merita ricordare la molteplicità di configurazioni offerta dal modulo \pack{topfront} mediante una tabella comparativa~\ref{tab:modalitaperfrontespizi}.
+
+\begin{table}\centering
+\begin{tabularx}{\textwidth}{*3{>\raggedright X}}\toprule
+Comando o ambiente & Stile standard & Stile classica \tabularnewline
+\midrule
+\amb{frontespizio} & loghi in testa & loghi in basso \tabularnewline
+\cs{ateneo} vuoto & senza nome dell'ateneo & messaggio d'errore\tabularnewline
+\cs{ateneo} non vuoto& Nome dell'ateneo in testa & nome dell'ateneo in testa
+ \tabularnewline
+filetti & assenti & presenti \tabularnewline
+\midrule
+\amb{frontespizio*} & loghi in basso & loghi in basso \tabularnewline
+\cs{ateneo} vuoto & senza nome dell'ateneo & messaggio d'errore\tabularnewline
+\cs{ateneo} non vuoto& nome dell'ateneo in testa & nome dell'ateneo in testa
+ \tabularnewline
+filetti & assenti & presenti \tabularnewline
+\midrule
+\cs{frontespizio} & come \amb{frontespizio} &come \amb{frontespizio}
+ \tabularnewline
+\midrule
+\cs{frontespizio*} & come \amb{frontespizio*} & come \amb{frontespizio*} \tabularnewline
+\bottomrule
+\end{tabularx}
+\caption{Varie modalità di ocmposizione del frontespizio}\label{tab:modalitaperfrontespizi}
+\end{table}
+
+
+
+
+\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}
+\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
@@ -671,7 +762,7 @@ per la carta A4, proporzionalmente di meno per formati di carta più piccoli.
\section{La composizione del frontespizio}
Non è generalmente necessario inserire nel frontespizio il logo dell'ateneo; controllate presso la vostra la vostra segreteria competente le regole fissate per la composizione del frontespizio. Se il logo è richiesto, allora la segreteria vi dice anche quale logo usare e da dove scaricarne il file che ne contiene la descrizione grafica; \textcolor{red}{siate precisi nel richiedere le limitazioni legali d'uso del logo dell'ateneo, perché il logo è proprietà esclusiva dell'ateneo e l'uso indebito potrebbe essere fonte di problemi legali non indifferenti.} Siccome tali limitazioni esistono, il pacchetto TOPtesi non viene più distribuito con i file dei loghi di diversi atenei, come veniva fatto nelle prime edizioni.
-Controllate se si tratta di un file vettoriale (estensione \file{.pdf} oppure \file{.eps}) oppure bitmapped (estensione \file{.jpg}, \file{.png}, \file{.bmp}, \file{.wmf}, \file{.tiff},\dots). Ricordate che \prog{pdflatex} e \prog{xelatex} possono incorporare solo i formati \file{.pdf}, \file{eps}\footnote{Dall'edizione di TeX Live 2010 anche \prog{pdflatex} è in grado di incorporare file in formato \file{.eps}, mentre prima era necessario convertirli preventivamente in formato \file{.pdf}.}, \file{.jpg} o \file{.png}). Se il file viene fornito in un formato diverso da questi quattro, è necessario convertirlo in uno dei formati accettati, preferibilmente nel formato \file{png}.
+Controllate se si tratta di un file vettoriale (estensione \file{.pdf} oppure \file{.eps}) oppure bitmapped (estensione \file{.jpg}, \file{.png}, \file{.bmp}, \file{.wmf}, \file{.tiff},\dots). Ricordate che \prog{pdflatex}, \prog{xelatex} e \prog{lualatex} possono incorporare solo i formati \file{.pdf}, \file{.eps}\footnote{Dall'edizione di TeX Live 2010 anche \prog{pdflatex} è in grado di incorporare file in formato \file{.eps}, mentre prima era necessario convertirli preventivamente in formato \file{.pdf}.}, \file{.jpg}, \file{.png} o \file{.mps}\footnote{I file in formato \file{.mps} sono ottenuti con il programma \MP; l'estensione normale delle figure create con questo programma di default hanno una estensione numerica; si può impostare il programma per assegnare l''estensione \file{.mps} oppure si può cambiare il nome e l'estensione.}. Se il file viene fornito in un formato diverso da questi cinque, è necessario convertirlo in uno dei formati accettati, preferibilmente nel formato \file{.png}.
Vale la pena di ricordare che il formato \file{.jpg} va bene per immagini a colori sfumati come le fotografie, mentre il formato \file{.png} è più adatto per disegni al tratto con righe fortemente contrastate rispetto allo sfondo. In generale, quindi, sarebbe meglio convertire nel formato \file{.png} un logo bitmapped fornito in un formato diverso da quelli elencati sopra. Potendo disporne, sarebbe sempre meglio usare un disegno veramente vettoriale del logo.
@@ -687,14 +778,14 @@ oppure
\medskip
\cs{logosede}\oarg{altezza}\marg{lista di nomi di file di loghi separati da virgole}
\end{flushleft}
-dove il valore prefissato per l'\meta{altezza} del logo è 2,5\,cm per la carta A4, ed è scalato proporzionalmente per carte di formato diverso; con l'argomento facoltativo si può specificare un'altezza leggermente maggiore o minore del valore predefinito. L'argomento \meta{file del logo} o \meta{lista di nomi di file di loghi separati da virgole} è costituito da un solo nome di file o da una lista di nomi di file separati da virgole, corrispondenti ciascuno al logo di un diverso ateneo. Questi file devono avere i formati corrispondenti a una delle quattro estensioni consentite, ma non è necessario specificare il nome del file completo di estensione; questa specificazione potrebbe essere necessaria solo nel caso in cui si disponga del logo di uno stesso ateneo in diversi formati.
+dove il valore prefissato per l'\meta{altezza} del logo è 2,5\,cm per la carta A4, ed è scalato proporzionalmente per carte di formato diverso; con l'argomento facoltativo si può specificare un'altezza leggermente maggiore o minore del valore predefinito. L'argomento \meta{file del logo} o \meta{lista di nomi di file di loghi separati da virgole} è costituito da un solo nome di file o da una lista di nomi di file separati da virgole, corrispondenti ciascuno al logo di un diverso ateneo. Questi file devono avere i formati corrispondenti a una delle cinque estensioni consentite, ma non è necessario specificare il nome del file completo di estensione; questa specificazione potrebbe essere necessaria solo nel caso in cui si disponga del logo di uno stesso ateneo in diversi formati (o, cosa da non fare mai, immagini o loghi diversi con il nome del loro file uguale e l'estensione diversa; questo genere di pasticci è fonte di numerosi errori, facilmente evitabili se si mantiene in ordine la scelta dei nomi e delle estensioni).
Il programma codificato nel pacchetto \pack{toptesi} provvede a scalare tutti i loghi all'\meta{altezza} specificata e li compone affiancati su una sola riga distanziati mediante uno spazio predefinito di 3\,em; lo si può impostare ad un valore leggermente maggiore o minore tramite il comando \cs{setlogodistance}, per esempio:
\begin{verbatim}
\setlogodistance{2em}
\end{verbatim}
-Se la riga di loghi, eventualmente scalati in altezza e distanziati dello spazio predefinito o esplicitamente specificato, risultasse più larga della giustezza della pagina del titolo, il programma provvede ad uno scalamento dell'intera riga di loghi in modo che non superi la giustezza della pagina. Un solo logo viene composto centrato; due o più loghi vengono ugualmente composti centrati ma distanziati come si è detto. Seguono alcuni esempi, ma si tenga presente che i loghi usati per questi esempi sono solo dei disegni creati in modo tale da avere la forma di un logo; loghi veri di diverse università non sono distribuiti insieme a TOPtesi, a causa delle restrizioni sulla loro proprietà legale; solo il vero logo del Politecnico di Torino appare nel frontespizio, perché questa è una pubblicazione ufficiale di quell'ateneo. Un solo logo appare come nel frontespizio di questo manuale; due loghi appaiono così:\\*[\smallskipamount]
+Se la riga di loghi, eventualmente scalati in altezza e distanziati dello spazio predefinito o esplicitamente specificato, risultasse più larga della giustezza della pagina del titolo, il programma provvede ad uno scalamento dell'intera riga di loghi in modo che non superi la giustezza della pagina. Un solo logo viene composto centrato; due o più loghi vengono ugualmente composti centrati ma distanziati come si è detto. Seguono alcuni esempi, ma si tenga presente che i loghi usati per questi esempi sono solo dei disegni creati in modo tale da avere la forma di un logo; loghi veri di diverse università non sono distribuiti insieme a TOPtesi, a causa delle restrizioni sulla loro proprietà legale; solo il vero logo del Politecnico di Torino appare nel frontespizio, perché questa è una pubblicazione ufficiale di quell'ateneo. Un solo logo appare come nel frontespizio di questo manuale; due loghi appaiono così:\\*[2pt]
\makebox[\textwidth]{\logosede{logouno,logodue}\printloghi}
\noindent Tre loghi appaiono così:\\*[\medskipamount]
@@ -706,15 +797,15 @@ Se la riga di loghi, eventualmente scalati in altezza e distanziati dello spazio
\makebox[\textwidth]{\logosede{logoquattro,logouno,logotre,logodue}
\printloghi}
-Si noti che il logo in testa alla pagina del frontespizio di questo documento è una esplicita richiesta espressa del Politecnico di Torino; molte altre sedi come la quasi totalità delle case editrici che mettono il loro logo nel frontespizio, lo mettono nella metà inferiore della pagina; ma la tesi di laurea o di dottorato è una documento particolare, il cui frontespizio deve soddisfare ad alcune esigenze burocratiche, e non può, quindi, soddisfare a criteri estetici molto stringenti. Per questo motivo, lo si vedrà meglio avanti, il pacchetto \pack{topfront} consente una variante del comando per creare i frontespizi: essa intesta la pagina col nome dell'ateneo e mette i loghi nella metà inferiore della pagina. Se, come per il Politecnico di Torino, il nome fa parte del logo\footnote{Il logo di questo Politecnico è fatto di due parti: quella tonda di sinistra prende il nome di ``marchio'', mentre quello letterale a destra prende il nome di ``logotipo''; l'Ufficio Comunicazione e Immagine che si occupa di questi aspetti formali ha emesso una normativa specifica sui colori e le forme sia del marchio sia dei font usati per il logotipo.} non è il caso di ripetere il nome dell'ateneo nella parte alta della pagina perché vi appare già nel logotipo.
-Comunque, volendo, si può inserire in testa alla pagina sia il logo, sia il nome generico dell'ateneo sia il nome proprio dell'ateneo.; si veda più avanti come fare.
+Si noti che il logo in testa alla pagina del frontespizio di questo documento è una esplicita richiesta espressa dal Politecnico di Torino; molte altre sedi come la quasi totalità delle case editrici che mettono il loro logo nel frontespizio, lo mettono nella metà inferiore della pagina; ma la tesi di laurea o di dottorato è una documento particolare, il cui frontespizio deve soddisfare ad alcune esigenze burocratiche, e non può, quindi, soddisfare a criteri estetici molto stringenti. Per questo motivo, lo si vedrà meglio avanti, il modulo \pack{topfront} consente una variante del comando per creare i frontespizi: essa intesta la pagina col nome dell'ateneo e mette i loghi nella metà inferiore della pagina. Se, come per il Politecnico di Torino, il nome fa parte del logo\footnote{Il logo di questo Politecnico è fatto di due parti: quella tonda di sinistra prende il nome di ``marchio'', mentre quella letterale a destra prende il nome di ``logotipo''; l'Ufficio Comunicazione e Immagine che si occupa di questi aspetti formali ha emesso una normativa specifica sui colori e le forme sia del marchio sia dei font usati per il logotipo.} non è il caso di ripetere il nome dell'ateneo nella parte alta della pagina perché vi appare già nel logotipo.
+Comunque, volendo, si può inserire in testa alla pagina sia il logo, sia il nome generico dell'ateneo sia il nome proprio dell'ateneo.; come fare lo sì è già descritto in precedenza e lo si è riassunto nella tabella~\ref{tab:modalitaperfrontespizi} nella pagina~\pageref{tab:modalitaperfrontespizi}.
\section{Comporre il frontespizio senza ricorrere a TOPfront}\label{sec:solofrontespizio}
-Potrebbe essere necessario comporre il frontespizio in modo diverso da come viene composto tramite i comandi contenuti nel pacchetto \pack{topfront}, sia pure ricorrendo alle due varianti del comando \cs{frontespizio} e \cs{frontespizio*}.
+Potrebbe essere necessario comporre il frontespizio in modo diverso da come viene composto tramite i comandi contenuti nel pacchetto \pack{topfront}, sia pure ricorrendo alle due varianti dell'ambiente \amb{frontespizio} e \amb{frontespizio*}.
Esistono alcune strade: una è quella di usare l'ambiente \amb{titlepage} e scriverci dentro quello che si vuole in accordo con le prescrizioni del proprio ateneo; l'altra è quella di usare altri pacchetti espressamente creati per comporre frontespizi, in particolare il pacchetto \pack{frontespizio}.
-Ci sono diversi motivi per i quali un laureando o dottorando vorrebbe comporre un frontespizio diverso da quello predefinito da TOPtesi con il suo pacchetto \pack{topfront}.
+Ci sono diversi motivi per i quali un laureando o dottorando vorrebbe comporre un frontespizio diverso da quello predefinito da TOPtesi con il suo modulo \pack{topfront}.
\begin{enumerate}
\item Le specifiche per le tesi di una data università sono inconciliabili con quelle preimpostate da TOPtesi.
\item Le informazioni da inserire nel frontespizio sono diverse da quelle preimpostate da TOPtesi.
@@ -725,7 +816,7 @@ A seconda dei motivi per i quali il laureando non vuole o non può usare il layo
La prima via, quella di usare l'ambiente \env{titlepage}, permette il massimo della libertà e consente di comporre il frontespizio come il laureando lo vuole, ma ha lo svantaggio che il laureando dentro quell'ambiente deve specificare ogni dettaglio di composizione. Se conosce bene \LaTeX\ e ha buone conoscenze tipografiche può ottenere un risultato gradevole, ma può anche cadere negli errori tipografici più comuni e produrre un frontespizio impresentabile.
-La secondo via può dare risultati buoni, grazie alla possibilità di personalizzazione che offre, in particolare con il pacchetto \pack{frontespizio}. Ma non si può fare sempre tutto; in particolare questo pacchetto è preimpostato per produrre il frontespizio in nel formato di carta A4 e con due stili, ``standard'' ed ``elements'' per \class{suftesi}. Più avanti indicherò come produrre frontespizi con qualunque formato di carta.
+La secondo via può dare risultati buoni, grazie alla possibilità di personalizzazione che offre, in particolare con il pacchetto \pack{frontespizio}. Ma non si può fare sempre tutto; anche questo pacchetto è preimpostato per produrre il frontespizio nel formato di carta A4 e con due stili, ``standard'' ed ``elements'' specifico per l'uso con la classe \class{suftesi}. Più avanti indicherò come produrre frontespizi con altri formati di carta.
\subsection{Comporre il frontespizio con l'ambiente titlepage}
Per seguire questa strada, qui posso dare solo delle indicazioni generiche.
@@ -734,7 +825,7 @@ Per seguire questa strada, qui posso dare solo delle indicazioni generiche.
\begin{flushleft}
\cs{thispagestyle}\marg{stile}
\end{flushleft}
-dove \meta{stile} è stato precedentemente definito usando il pacchetto \pack{geometry} o altri pacchetti. Sarebbe opportuno ridefinire i due margini interno ed esterno in modo che siano uguali. Qualcono desidera apportare un piccolo spostamento verso l'esterno di non più di 5\,mm per compensare la curvatura della prima pagina; questa curvatura dipenderebbe dal modo di confezionare/legare la tesi; di solito con una buona brossura ben eseguita o una legatura a filo, non è necessario apportare questa correzione, con una tesi spillata con punti metallici, probabilmente una piccola correzione non guasta; ma questa correzione va bene per le pagine interne, ma . siccome il frontespizio è la prima pagina della tesi, la curvature della pagina è irrilevante e questo piccolo spostamento è del tutto superfluo.
+dove \meta{stile} è stato precedentemente definito usando il pacchetto \pack{geometry} o altri pacchetti. Sarebbe opportuno ridefinire i due margini interno ed esterno in modo che siano uguali. Qualcuno desidera apportare un piccolo spostamento verso l'esterno di non più di 5\,mm per compensare la curvatura della prima pagina; questa curvatura dipenderebbe dal modo di confezionare/legare la tesi; di solito con una buona brossura ben eseguita o una legatura a filo, non è necessario apportare questa correzione, con una tesi spillata con punti metallici, probabilmente una piccola correzione non guasta; però questa correzione va bene per le pagine interne ma, siccome il frontespizio è la prima pagina della tesi, la curvatura della pagina è irrilevante e questo piccolo spostamento è del tutto superfluo.
\item Non è necessario che i margini laterali siano complessivamente equivalenti ai margini del corpo della tesi, ma non guasta se lo sono.
@@ -769,7 +860,7 @@ Un esempio di un frontespizio costruito per questa via è quello che un utente h
\newcommand {\pretitlefont}{\fontsize {16}{16}\rmfamily}
\newcommand {\titlefont}{\fontsize {18}{22}\usefont{T1}%
{iwona}{bx}{n}}
-\newcommand {\fixednamesfont}{\fontsize {14}{20}\mdseries}
+\newcommand {\fixednamesfont}{\fontsize {14}{17}\mdseries}
\newcommand {\namesfont}{\fontsize {15}{18}\bfseries}
\newcommand {\footfont}{\fontsize {15}{18}\rmfamily}
@@ -819,7 +910,7 @@ Un esempio di un frontespizio costruito per questa via è quello che un utente h
\end{titlepage}
\end{verbatim}
-Nel codice precedente appaiono alcuni comandi per i font i cui nomi per le corrispondenti dichiarazioni sono ispirati a quelli contenuti nel pacchetto \pack{frontespizio}, ma i nomi sono irrilevanti, nel senso che qualunque altro nome sarebbe stato altrettanto valido.
+Nel codice precedente appaiono alcuni comandi per i font i cui nomi per le corrispondenti dichiarazioni sono ispirati a quelli contenuti nel pacchetto \pack{frontespizio}, ma i nomi sono irrilevanti, nel senso che qualunque altro nome sarebbe stato altrettanto valido; è invece utile che i nomi dei font siano scelti in modo che ricordino la funzione per la quale sono stati definiti.
La pagina che l'utente ha ottenuto è contenuta nella figura~\ref{fig:frontespizio-landscape}. Per inserirla come frontespizio della tesi egli ha poi usato il pacchetto \pack{pdfpages} che permette di inserire pagine scelte di un file PDF in un documento da comporre con \LaTeX. Se ne veda la documentazione aprendo un terminale o un prompt dei comandi, scrivendoci dentro \verb|texdoc pdfpages| e poi premendo il tasto \fbox{invio}.
@@ -832,13 +923,13 @@ La pagina che l'utente ha ottenuto è contenuta nella figura~\ref{fig:frontespiz
Esistono altri pacchetti, oltre a \pack{frontespizio}, per comporre pagine di titoli; ma per le tesi questo pacchetto sembra il più indicato. Definisce comandi per inserire virtualmente qualsiasi informazione necessaria per un frontespizio di testi di laurea triennale, magistrale o dottorale; per impostazione predefinita tutte le informazioni fisse sono in italiano, ma ciascuna può essere modificata come si vuole in qualsiasi lingua.
-Fra le opzioni della classe \class{toptesi} si deve inserire l'opzione \opt{noTOPfront} per evitare conflitti fra i comandi del pacchetto \pack{topfront} e quelli del pacchetto \pack{frontespizio}. \textcolor{red}{Dimenticarsi di specificare questa opzione vuol dire andare incontro a messaggi d'errore causati dai conflitti fra i due pacchetti}.
+Fra le opzioni della classe \class{toptesi} si deve inserire l'opzione \opt{noTOPfront} per evitare conflitti fra i comandi del modulo \pack{topfront} e quelli del pacchetto \pack{frontespizio}. \textcolor{red}{Dimenticarsi di specificare questa opzione vuol dire andare incontro a messaggi d'errore causati dai conflitti fra i due pacchetti}.
Questo pacchetto \pack{frontespizio} si avvale di un file ausiliario \file{.tex} per comporre il frontespizio vero e proprio; questo implica che per disporne come frontespizio del documento finito, bisogna comporre anche questo file ausiliario.
Precisamente tutte le informazioni riguardanti il frontespizio devono essere messe dentro un ambiente \amb{frontespizio} collocato dopo l'istruzione \cs{begin}\Arg{document}. Qui si metteranno i comandi per definire il nome del o dei candidati, il nome del o dei relatori e degli eventuali correlatori, il nome dell'università, il nome del corso di laurea, il nome del tipo di tesi, il titolo e il sottotitolo della tesi, eccetera.
-Eseguendo \prog{pdflatex} o \prog{xelatex} viene scritto il file ausiliario; se la tesi ha il main file che si chiama \file{MarioRossiTesiMagistrale.tex}, dopo averlo compilato, nella cartella di lavoro ci sarà anche il file ausiliario \file{MarioRossiTesiMagistrale-frn.tex}; bisognerà dunque compilare questo file ausiliario, e poi ricompilare il documento che \emph{riscriverà il file ausiliario} con i nuovi eventuali dati modificati, ma intanto ingloberà il file PDF appena prodotto. La sequenza delle compilazioni sarà dunque:
+Eseguendo \prog{pdflatex} o \prog{xelatex} viene scritto il file ausiliario; se la tesi ha il main file che si chiama \texttt{MarioRossiTesiMagistrale.tex}, dopo averlo compilato, nella cartella di lavoro ci sarà anche il file ausiliario \texttt{MarioRossiTesiMagistrale-frn.tex}; bisognerà dunque compilare questo file ausiliario, e poi ricompilare il documento che \emph{riscriverà il file ausiliario} con i nuovi eventuali dati modificati, ma intanto ingloberà il file PDF appena prodotto. La sequenza delle compilazioni sarà dunque:
\begin{verbatim}
pdflatex MarioRossiTesiMagistrale
pdflatex MarioRossiTesiMagistrale-frn
@@ -847,7 +938,8 @@ pdflatex MarioRossiTesiMagistrale
Se il frontespizio deve essere composto con font diversi da quelli di default, con codifiche particolari, con altre impostazioni particolari è meglio che il file ausiliario sia dotato di un preambolo adeguato; quindi il file principale avrà la struttura seguente;
\begin{flushleft}\obeylines
-\cs{documentclass}\oarg{opzioni-classe}\Arg{toptesi}\texttt{\% Preambolo del main file}
+\cs{documentclass}\oarg{opzioni-classe}\Arg{toptesi}
+\texttt{\% Preambolo del main file}
...
\cs{usepackage}\oarg{codifche}\Arg{inputenc}
...
@@ -866,7 +958,7 @@ Se il frontespizio deve essere composto con font diversi da quelli di default,
\quad\cs{begin}\Arg{frontespizio}
\qquad\cs{Universita}\marg{nome corto dell'università}
\qquad\cs{Logo}\oarg{altezza-logo}\marg{logo}
-\qquad\cs{Facolta}\marg{nome della facoltà}
+\qquad\cs{facolta}\marg{nome della facoltà}
\qquad...
\qquad\cs{NCorrelatore}\marg{singolare}\marg{plurale}
\qquad\cs{Correlatore}\marg{Nome-Cognome di un correlatore}
@@ -882,11 +974,11 @@ Però, come già detto, questo pacchetto compone di default il frontespizio in u
Se si volesse comporre la tesi in formato B5, per esempio, bisogna sfruttare adeguatamente il contenuto dell'ambiente \amb{Preambolo*}.
-La procedura da seguire, dunque dovrebbe essere modificata come segue. Assumiamo che non si debbano apportare modifiche al contenuto del frontespizio; in caso contrario bisogna ripetere la procedura diverse dopo ogni modifica del suo contento all'interno dell'ambiente \amb{frontespizio}.
+La procedura da seguire, dunque dovrebbe essere modificata come segue. Assumiamo che non si debbano apportare modifiche al contenuto del frontespizio; in caso contrario bisogna ripetere la procedura dopo ogni modifica del suo contenuto all'interno dell'ambiente \amb{frontespizio}.
\begin{Verbatim}[fontsize=\small]
\documentclass [11pt,b5paper]{book}
-% Preambolo del documentO
+% Preambolo del documento
\usepackage[norules,swapnames]{frontespizio}
\usepackage[T1]{fontenc}
\usepackage{iwona}
@@ -908,16 +1000,16 @@ La procedura da seguire, dunque dovrebbe essere modificata come segue. Assumiamo
\end{document}
\end{Verbatim}
-Si noti che nell'argomento dell'ambiente \amb{Preambolo*} si può inserire un intero preambolo, non semplicemente la chiamata al pacchetto \pack{geometry} con le sue opzioni; questo ambiente può contenere qualsiasi cosa sia ragionevole in un preambolo; l'importante è che l'opzione relativa al formato della carta sia identica sia fra le opzioni della classe, sia fra quelle di \pack{geometry} nell'ambiente \amb{Preambolo*}.
+Si noti che nel corpo dell'ambiente \amb{Preambolo*} si può inserire un intero preambolo, non semplicemente la chiamata al pacchetto \pack{geometry} con le sue opzioni; questo ambiente può contenere qualsiasi cosa sia ragionevole in un preambolo; l'importante è che l'opzione relativa al formato della carta sia identica sia fra le opzioni della classe, sia fra quelle di \pack{geometry} nell'ambiente \amb{Preambolo*}.
-Compilando questo documento si ottiene un'unica pagina contenente il frontespizio composto, che può poi venire incorporato nella tesi mediante l'uso del pacchetto \pack{pdfpages} che, come si è già detto, consente di inserire pagine scelte di un file PDF dentro un documento da comporre con \LaTeX. In questo modo la composizione del frontespizio e quello della tesi procedono separatamente e non c'è bisogno, ogni volta che si cambiano i dati per il frontespizio, di eseguire le tre compilazioni.
+Compilando questo documento si ottiene un'unica pagina contenente il frontespizio composto, che può poi venire incorporato nella tesi mediante l'uso del pacchetto \pack{pdfpages} che, come si è già detto, consente di inserire pagine scelte di un file PDF dentro un documento da comporre con \pdfLaTeX. In questo modo la composizione del frontespizio e quello della tesi procedono separatamente e non c'è bisogno, ogni volta che si cambino i dati per il frontespizio, di eseguire le tre compilazioni.
\section{Come si comincia}\label{sec:cominciare}
Non vi dico niente di come si scriva una tesi; so per
esperienza che all'inizio ci si sente sperduti davanti allo
schermo vuoto. Ma voi laureandi potete scaricare dal portale della didattica del sito
-del Politecnico \url{http://didattica.polito.it} l'opuscoletto
+del Politecnico \url{http://didattica.polito.it} l'opuscoletto
\emph{Saper Comunicare --- Cenni di scrittura tecnico-scientifica}
dove c'è scritto più o meno tutto quel che bisogna sapere per
impostare e scrivere un rapporto tecnico-scientifico qual è la
@@ -925,7 +1017,7 @@ tesi, la monografia o la dissertazione.
Qui dirò solo come si comincia a scrivere il file sorgente della tesi. Ci sono essenzialmente due vie, ognuna delle quali offre vantaggi e svantaggi, quindi non si può dire a priori quale via sia la più indicata.
\begin{enumerate}
-\item Si compone un unico file come esemplificato con i file \file{toptesi-example.tex}, \file{toptesi-example-xetex.tex} e \file{toptesi-example-con-frontespizio.tex} allegati alla documentazione di TOPtesi. Questi file permettono di sperimentare diverse cose semplicemente mettendo o togliendo dei segni di commento all'inizio delle righe del preambolo che contengono alcuni comandi particolari. Essi sono completi di bibliografia e quell'unico file permette di comporre una tesi completa; ovviamente può essere usato come modello per una tesi; basta cambiare il contenuto dei comandi che contengono i nomi dei candidati, dei relatori, del titolo, dell'ateneo, della eventuale facoltà, eccetera. Ovviamente bisogna cambiare anche il contenuto dei capitoli e della bibliografia.
+\item Si compone un unico file come esemplificato con i file \file{toptesi-example.tex}, \file{toptesi-example-xetex.tex} e \texttt{toptesi-example-con-frontespizio.tex}\index{file!toptesi-example-con-frontespizio.tex@\texttt{toptesi\discretionary{-}{}{-}example\discretionary{-}{}{-}con\discretionary{-}{}{-}frontespizio.tex}} allegati alla documentazione di TOPtesi. Questi file permettono di sperimentare diverse cose semplicemente mettendo o togliendo dei segni di commento all'inizio delle righe del preambolo che contengono alcuni comandi particolari. Essi sono completi di bibliografia e quell'unico file permette di comporre una tesi completa; ovviamente può essere usato come modello per una tesi; basta cambiare il contenuto dei comandi che contengono i nomi dei candidati, dei relatori, del titolo, dell'ateneo, della eventuale facoltà, eccetera. Ovviamente bisogna cambiare anche il contenuto dei capitoli e della bibliografia.
\item Si spezza il file sorgente in un numero adeguato di file parziali da gestire come specificato qui di seguito; ogni file parziale conterrà solo una parte della tesi, per esempio un solo capitolo; siccome il tutto è gestito dal master file, ciascun file parziale non dovrà più contenere la dichiarazione della classe né il preambolo né le righe \cs{begin}\Arg{document} e \cs{end}\Arg{document}, ma solo il materiale relativo ad uno specifico capitolo cominciando appunto con la riga che ne specifica il titolo:
\cs{chapter}\Arg{Il titolo di questo capitolo}.
@@ -979,7 +1071,7 @@ compilazione è rapidissima, quindi non raccomando di seguire questa
procedura al fine di risparmiare tempo di compilazione; faccio invece
notare che tenere separate le varie parti della tesi
permette di lavorare con più ordine e di risparmiare non poco
-tempo nella gestione dei vari file sorgente e nelle loro
+tempo per la gestione dei vari file sorgente e per le loro
correzioni.
Non sarebbe male nemmeno tenere sgombra la cartella di lavoro,
@@ -1034,9 +1126,9 @@ usare direttamente le lettere accentate della tastiera italiana o
quelle che si possono ottenere con combinazioni di tasti sia sotto
Windows sia sotto Linux o Mac~OS~X; per default \textsf{TOPtesi}
non specifica nessuna particolare codifica per l'input; ma perché
-il programma di tipocomposizione elabori correttamente i file sorgente o si usa \prog{xelatex} ricordando di salvare i file con la codifica UNICODE o UTF-8, oppure non si specifica nessuna particolare codifica ma si usano solo i caratteri ASCII a
+il programma di tipocomposizione elabori correttamente i file sorgente, o si usa \prog{xelatex} ricordando di salvare i file con la codifica UNICODE o UTF-8, oppure non si specifica nessuna particolare codifica ma si usano solo i caratteri ASCII a
7~bit; oppure ancora si usano i caratteri nazionali direttamente da
-tastiera ma si specifica la codifica che l'editor usato ha
+tastiera ma si specifica la codifica che l'editor ha
impiegato per salvare nei file i codici dei caratteri non ASCII,
per esempio le lettere accentate; a meno che non usiate \prog{xelatex}, vi suggerisco di specificare esplicitamente la codifica mediante il comando
\begin{verbatim}
@@ -1044,7 +1136,7 @@ per esempio le lettere accentate; a meno che non usiate \prog{xelatex}, vi sugge
\end{verbatim}
che va bene sia per le macchine Windows, sia per quelle basate su UNIX.
-Gli editor \TeX{}Shop, \TeX{}works, TeXmaker, TeXStudio, e qualcun altro, consentono di usare la codifica \opt{utf8} che permette di inserire qualunque segno fra le decine o centinaia di migliaia che la codifica UNICODE consente -- se usate \prog{xelatex} questa codifica è necessaria ma non bisogna esplicitarla nel file sorgente. Il problema, in effetti, non è la codifica, ma è la tastiera. Con sistemi operativi diversi si sono sviluppati programmi di vario genere per scrivere in alfabeti diversi da quello latino esteso, qual è quello invocato, per esempio, con l'opzione \opt{latin1} oppure anche \opt{utf8}. Ma se dovete scrivere la vostra tesi con brani in greco o in russo o in arabo o in lingue con segni sillabici o ideogrammi, questo problema si presenterebbe qualunque sia l'editor e il programma di composizione che usate, ed è un problema che dovete risolvere da soli.
+Gli editor \TeX{}Shop, \TeX{}works, Texmaker, TeXstudio, e qualcun altro, consentono di usare la codifica \opt{utf8} che permette di inserire qualunque segno fra le decine o centinaia di migliaia che la codifica UNICODE consente -- se usate \prog{xelatex} questa codifica è necessaria ma non bisogna esplicitarla nel file sorgente. Il problema, in effetti, non è la codifica, ma è la tastiera. Con sistemi operativi diversi si sono sviluppati programmi di vario genere per scrivere in alfabeti diversi da quello latino esteso, qual è quello invocato, per esempio, con l'opzione \opt{latin1} oppure anche \opt{utf8}. Ma se dovete scrivere la vostra tesi con brani in greco o in russo o in arabo o in lingue con segni sillabici o ideogrammi, questo problema si presenterebbe qualunque sia l'editor e il programma di composizione che usate, ed è un problema che dovete risolvere da soli.
Bisogna notare che vanno accentate anche le lettere maiuscole; siccome la tastiera italiana non le prevede, consiglio di inserire nel preambolo la definizione del comando \cs{E} per scrivere È. Credo che questa sia la maiuscola accentata più frequente in italiano e le altre non capitano mai all'inizio di un periodo; possono capitare nei titoli e allora bisognaa arrangiarsi con codici numerici o con tabelle di caratteri. Il comando:
\begin{verbatim}
@@ -1059,7 +1151,7 @@ per ottenere:
\begin{quote}
È conveniente rilevare che\dots
\end{quote}
-L'uso del pacchetto \pack{xspace} fa sì che esso, tramite il comando \cs{xspace} inserisca uno spazio, a meno che il comando \cs{E} non sia seguito da qualunque cosa non sia uno spazio, per esempio un segno di interpunzione, o una tilde di legatura; anche il comando esplicito di spazio \verb*|\ | impedisce l'inserimento di un ulteriore spazio da parte di \cs{xspace}.
+L'uso del pacchetto \pack{xspace} fa sì che esso, tramite il comando \cs{xspace} inserisca uno spazio, a meno che il comando \cs{E} non sia seguito da qualunque cosa che non sia uno spazio, per esempio un segno di interpunzione, o una tilde di legatura; anche il comando esplicito di spazio \verb*|\ | impedisce l'inserimento di un ulteriore spazio da parte di \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.
@@ -1417,7 +1509,7 @@ Questa operazione, evidentemente va ripetuta per ogni documento da produrre in f
Ricordate solo che il pacchetto \pack{toptesi} non contiene nessuna verifica se state componendo con \prog{pdflatex} oppure con il semplice \prog{latex} o con qualche altro applicativo del sistema \TeX; controlla solo se state usando \prog{xelatex}. Il concetto è che \emph{dovete} usare \prog{pdflatex}. E se usate qualunque altro programma di composizione, o ottenete un messaggio di errore (con \prog{latex}), oppure non avete messaggi di errore ma il file PDF non è conforme alla norma PDF/A (per esempio con con \prog{xelatex}, che però può essere ulteriormente elaborato per raggiungere lo scopo).
-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 ambiente \amb{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}.
+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
@@ -1581,7 +1673,7 @@ profondità diverse; si confronti \oldstylenums{1234567890} con
%
\Item[pdfa] Serve per attivare la composizione di un file PDF che possa passare la verifica per la certificazione del formato PDF/A. Attenzione: si ricorda che questa operazione viene eseguita tramite l'uso del file \texttt{pdfx.sty} che a sua volta richiama il file \texttt{hyperref.sty} con la giusta opzione per il formato PDF/A. Eventuali personalizzazioni per configurare gli stili di composizione dei link generati da \texttt{hyperref.sty} devono essere dichiarate subito dopo la dichiarazione della classe. Se si specificano queste personalizzazioni, ma non è stata data l'opzione \texttt{pdfa}, viene prodotto un errore terminale. Inoltre bisogna ricordarsi di predisporre il file \texttt{.xmpdata} oppure \texttt{-def.ps} contenente i \emph{metadata} relativi al documento specifico come si è già spiegato in precedenza.
%
-\Item[usefrontespizio] e \opt{noTOPfront} sono opzioni equivalenti; servono per evitare il caricamento del pacchetto nativo di TOPtesi, \pack{topfront} in modo da poter comporre il frontespizio con pacchetti esterni, evitando conflitti con quei pacchetti.
+\Item[noTOPfront] e \opt{usefrontespizio} sono opzioni equivalenti; servono per evitare il caricamento del pacchetto nativo di TOPtesi, \pack{topfront} in modo da poter comporre il frontespizio con pacchetti esterni, evitando conflitti con quei pacchetti.
\end{description}
@@ -1721,7 +1813,11 @@ subito dopo \cs{begin}\Arg{document}. Se si desidera una pagina vuota saltuariam
\section{Comandi per il frontespizio}
\textcolor{red}{Questo paragrafo descrive i comandi per comporre il frontespizio con il pacchetto \pack{topfront}, nativo della classe \class{toptesi}. Se si vuole comporre il frontespizio con una altro pacchetto, non si usino questi comandi ma quelli descritti nella documentazione del pacchetto alternativo. Naturalmente si sarà specificata l'opzione \opt{noTOPfront} fra le opzioni della classe, al fine di evitare conflitti con i pacchetti esterni.}
-I comandi per la composizione del frontespizio \emph{possono} essere tutti inseriti nel preambolo, cioè prima di \cs{begin}\Arg{document} se si compone con il programma \prog{pdflatex}, mentre \emph{debbono} essere inseriti dopo il preambolo, ma prima del comando \cs{frontespizio} (con o senza asterisco), se si compone con \prog{xelatex}.
+{\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.
+
+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}}
@@ -1870,7 +1966,8 @@ tesi di laurea e della dissertazione di dottorato. Comando per comporre il verso
\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{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;
@@ -1910,7 +2007,7 @@ lingua}\label{tab:front4}
I comandi di questa sezione possono essere introdotti in un ordine qualunque, ma è più chiaro se sono introdotti nell'ordine in cui sono elencati.
Essi possono anche essere scritti nel file di configurazione
-\meta{mainfile}\texttt{.cfg}, anzi, direi che è meglio che siano inseriti
+\meta{mainfile}\texttt{.cfg}, anzi, direi che è meglio che siano inseriti
in quel file, lasciando nel preambolo solo quelli che cambiano i
valori di default o che inseriscono informazioni non presenti di
default.
@@ -1919,7 +2016,7 @@ Alcuni comandi sono generali; altri si riferiscono specificatamente
alla monografia di laurea, alla tesi laurea, o alla dissertazione di
dottorato.
-La differenza è che generalmente la monografia di laurea non ha
+La differenza è che generalmente la monografia di laurea non ha
un relatore; se nella vostra facoltà anche la monografia di laurea
ha un relatore comportatevi come per la tesi di laurea. Se nel
vostro ateneo o nella vostra facoltà succede così, allora inserite
@@ -1936,7 +2033,7 @@ rappresentare delle modifiche ``permanenti''. \textcolor{red}{Usateli
anche per predisporre quelle stringhe in una lingua diversa
dall'italiano}.
-Per comporre questo testo si è usata la classe \pack{toptesi},
+Per comporre questo testo si è usata la classe \class{toptesi},
e si è supposto di scrivere una monografia; tuttavia alcune
delle stringhe di default non sono adeguate a questo uso, quindi il
preambolo di questo documento contiene le seguenti specificazioni
@@ -1962,8 +2059,8 @@ tabelle citate\footnote{In verità ho imbrogliato un poco. I comandi qui elencat
Vale la pena di fare le seguenti osservazioni.
\begin {enumerate}
-\item Se si usa il comando \cs{frontespizio} il logo viene messo in testa; se si usa la forma asteriscata \cs{frontespizio*} il logo viene messo nella metà inferiore della pagina del titolo. Se il logo dell'ateneo contiene per disteso il logotipo, cioè il nome per disteso, allora l'uso del comando \cs{ateneo} contenente il nome generico dell'ateneo implica una ridondanza di informazioni che potrebbe anche essere antiestetica; quindi
-se si usa il comando \cs{ateneo} sarebbe meglio usare il comando \cs{frontepizio*}, e viceversa. Ma questa possibilità di scelta per la posizione del logo e la presenza del nome dell'ateneo consente di rispettare le diverse specifiche indicate dalle segreterie didattiche degli atenei.
+\item Se si usa l'ambiente \amb{frontespizio} o il comando \cs{frontespizio} il logo viene messo in testa; se si usa la forma asteriscata dell'ambiente \amb{frontespizio*} il logo viene messo nella metà inferiore della pagina del titolo. Se il logo dell'ateneo contiene per disteso il logotipo, cioè il nome per disteso, allora l'uso del comando \cs{ateneo} contenente il nome generico dell'ateneo implica una ridondanza di informazioni che potrebbe anche essere antiestetica; quindi
+se si usa il comando \cs{ateneo} sarebbe meglio usare l'ambiente \amb{frontespizio*}, e viceversa. Ma questa possibilità di scelta per la posizione del logo e la presenza del nome dell'ateneo consente di rispettare le diverse specifiche indicate dalle segreterie didattiche degli atenei; si veda la tabella riassuntiva~\ref{tab:modalitaperfrontespizi} nella pagina~\pageref{tab:modalitaperfrontespizi}.
%
\item \cs{titolo} non deve
essere usato per la monografia (ma \cs{sottotitolo} si
@@ -1994,7 +2091,7 @@ Il \meta{numero di matricola} non è quasi mai necessario, quindi la sequenza \c
Per quanto riguarda i loghi, la loro inserzione implica l'uso del pacchetto \pack{graphicx}, che \class{toptesi} carica di default; specificare nuovamente quel pacchetto non produce nessun danno, perché \LaTeX\ controlla da solo se lo deve caricare o non lo deve ricaricare. Però, evidentemente, lo si è già detto all'inizio, non è bene caricare una seconda volta i pacchetti che sono già stati caricati
-\textcolor{red}{Per i formati dei file grafici da includere, le versioni recenti di \pdfLaTeX, di \XeLaTeX\ e di \LuaLaTeX\ accettano i formati PDF, PNG, JPG, MPS, EPS. La cosa è scritta a chiare lettere nella guida \file{grfguide.pdf} (già presente nella propria installazione del sistema \TeX\ aggiornata e completa), ma è un fatto che viene dimenticato troppo spesso e che obbliga a cercare aiuto da chi ne sa di più, compagni o professori, ma che anche loro talvolta dimenticano.}
+\textcolor{red}{Per i formati dei file grafici da includere, le versioni recenti di \pdfLaTeX, di \XeLaTeX\ e di \LuaLaTeX\ accettano i formati PDF, PNG, JPG, MPS, EPS. La cosa è scritta a chiare lettere nella guida \file{grfguide.pdf} (già presente nella propria installazione del sistema \TeX\ aggiornata e completa), ma è un fatto che viene dimenticato troppo spesso e che obbliga a cercare aiuto da chi ne sa di più, compagni o professori; ma che anche loro talvolta dimenticano.}
\textcolor{red}{Esistono programmi per passare da un formato all'altro, ma anche disponendo di quei programmi e conoscendo i vantaggi e gli svantaggi di un formato rispetto ad un altro, questa operazione viene dimenticata troppo spesso, perché troppo spesso ci si dimentica di queste limitazioni sui formati.}
@@ -2004,13 +2101,13 @@ bene anche senza le prestazioni di questo bellissimo pacchetto.
\section{Altri comandi}
-La classe \class{toptesi} richiede l'uso di altri comandi il più notevole dei quali è senza dubbio \cs{frontespizio} con la sua variante \cs{frontespizio*}. È un comando che non vuole argomenti e che va dato all'inizio, subito dopo l'apertura del documento o all'inizio del primo file incluso dal master file. Si veda comunque la tabella~\ref{tab:comandi}. Ricordo che i comandi \cs{frontespizio} è \cs{frontespizio*} sono definiti dal pacchetto \pack{topfront}; se si vuole comporre il frontespizio con un pacchetto esterno, si è specificata l'opzione \opt{noTOPfront}, che inibisce il caricamento del pacchetto, perciò questi comandi non sono più disponibili.
+La classe \class{toptesi} richiede l'uso di altri comandi il più notevole dei quali è senza dubbio \cs{frontespizio} e la sua variante \cs{frontespizio*} si veda la tabella riassuntiva~\ref{tab:modalitaperfrontespizi} nella pagina~\pageref{tab:modalitaperfrontespizi}). È un comando che non vuole argomenti e che va dato all'inizio, subito dopo l'apertura del documento o all'inizio del primo file incluso dal master file. Si veda comunque la tabella~\ref{tab:comandi}. Ricordo che i comandi \cs{frontespizio} e \cs{frontespizio*} sono definiti dal pacchetto \pack{topfront}; se si vuole comporre il frontespizio con un pacchetto esterno, si è specificata l'opzione \opt{noTOPfront}, che inibisce il caricamento del pacchetto, perciò questi comandi non sono più disponibili.
La differenza fra i due comandi consiste nel fatto che \cs{frontespizio} compone il frontespizio della tesi come richiesto dal Politecnico di Torino, con il logo dell'ateneo in testa alla pagina. Invece la variante asteriscata compone il frontespizio scrivendo in testa il nome dell'ateneo e mettendo il logo nella metà inferiore della gabbia di stampa. Il risultato si vede chiaramente nella figura~\ref{fig:frontespizi}.
Merita sottolineare che il formato richiesto dal Politecnico di Torino va bene nel senso che il logo di quell'ateneo contiene già il suo logotipo\footnote{Il logo del Politecnico di Torino è formato da due parti accostate con un piccolo spazio e un filetto verticale fra le due; nella parte di sinistra compare il marchio dell'ateneo, il solito simbolo tondo, mentre la parte di destra contiene il logotipo, cioè il nome \textsf{POLITECNICO DI TORINO} su due righe scritto con certi font e con un colore particolare; font e colore non possono venire modificati, pena la violazione d'uso del logo.}. Sarebbe quanto mai inestetico se in testa al frontespizio comparisse due volte il nome del Politecnico; quindi non è strano che l'intestazione della tesi contenga formalmente solo il logo. Lo stesso potrebbe essere fatto, per esempio, con i loghi di diverse università, per esempio quello dell'Università di Torino, di Ca' Foscari a Venezia, di Bologna, dell'Università Cattolica, di Padova, oltre al logo del Politecnico di Milano, giusto per citarne alcuni, perché contengono il marchio e il logotipo.
-Per le università che hanno un nome proprio, come per esempio \emph{Tor Vergata} per la seconda università di Roma ma, che io sappia, non hanno il logotipo nel loro logo, sarebbe quanto mai inestetico usare il logo sopra, in testa, poi il nome proprio, poi tutto il resto; io non consiglierei mai di usare \cs{frontespizio} in questi casi, ma userei solo \cs{frontespizio*}.
+Per le università che hanno un nome proprio, come per esempio \emph{Tor Vergata} per la seconda università di Roma ma, che io sappia, non hanno il logotipo nel loro logo, sarebbe quanto mai inestetico usare il logo sopra, in testa, poi il nome proprio, poi tutto il resto; io non consiglierei mai di usare \cs{frontespizio} in questi casi, ma userei solo \cs{frontespizio*} o l'ambiente corrsipondente.
Ovviamente perché il comando esegua il suo compito, tutte le informazioni rilevanti devono già essere state scritte prima di dare il comando \cs{frontespizio} o nel file di configurazione o nel preambolo.
@@ -2026,7 +2123,7 @@ Con questi modelli lo studente che compila la sua tesi usando \textsf{TOPtesi} p
\clearpage
-\begin{table}[p]
+\begin{table}[p]\small
\def\V{\rule{0pt}{2.5ex}}
\def\d{\discretionary{\%}{\rule{1em}{0pt}}{}}\let\t\ttfamily
\makebox[\textwidth]{%
@@ -2034,13 +2131,22 @@ Con questi modelli lo studente che compila la sua tesi usando \textsf{TOPtesi} p
\hline
Comando\V & Default & Scopo \\[.5ex]
\hline
-\cs{figurespagetrue}&\cs{figurespagefalse}& Fa o non fa stampare l'indice delle figure\\
+\cs{figurespagetrue}&\cs{figurespagefalse}&\V Fa o non fa stampare l'indice delle
+ figure\\
\cs{tablespagetrue}&\cs{tablespagefalse}&Fa o non fa stampare l'indice delle tabelle\\
+\amb{frontespizio} & & Contiene i dati per il frontespizio e l'eventuale
+ retrofrontespizio e lo compone
+ con i loghi nella testatina\\
+\amb{frontespizio*} & & Contiene i dati per il frontespizio e l'eventuale
+ retrofrontespizio e lo compone
+ con il loghi nella parte bassa della pagina\\
\cs{frontespizio} & nessuno & Fa stampare il frontespizio ed eventualmente il
- retrofrontespizio; il logo dell'ateneo appare in testa
- alla pagina \\
-\cs{frontespizio*} & nessuno & Come \cs{frontespizio} ma con il logo dell'ateneo
- è nella metà inferiore della pagina\\
+ retrofrontespizio; il logo dell'ateneo appare in
+ testa alla pagina \\
+\cs{frontespizio*} & nessuno & Fa stampare il frontespizio ed eventualmente il
+ retrofrontespizio; il logo dell'ateneo appare in
+ basso nella pagina; vedi ta tabella
+ riassuntiva~\ref{tab:modalitaperfrontespizi}\\
\cs{sommario} &nessuno & Inizia un capitolo non numerato che ha per
intestazione la parola SOMMARIO (anche in lingua)\\
\cs{ringraziamenti}&nessuno & Inizia un capitolo non numerato
@@ -2055,11 +2161,11 @@ Comando\V & Default & Scopo \\[.5ex]
\cs{paginavuota} &nessuno & Emette nel file di uscita una pagina totalmente
bianca, senza nemmeno il numero della pagina. Non so
a che cosa possa servire, ma non costa niente
- mettere a disposizione anche questo comando che mi è
+ mettere a disposizione questo comando che mi è
stato richiesto a gran voce.\\
\cs{NoteWhiteLine} &nessuno & Anche questo comando mi è stato richiesto a gran
voce e serve per mettere in nota una riga
- completamente bianca.\\[.5ex]
+ bianca.\\[.5ex]
\hline
\end{tabular}}
\caption{Comandi ulteriori di \class{toptesi}}\label{tab:comandi}