summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/toptesi
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-09-10 22:52:57 +0000
committerKarl Berry <karl@freefriends.org>2012-09-10 22:52:57 +0000
commitae7109f2fab6c082ec89fb538add7cdd9c0fafb5 (patch)
tree8e93beaf297f6a75d7efd809005fe8dba0676500 /Master/texmf-dist/doc/latex/toptesi
parent609646087cbaa858a54237f6d1682bb6b4bbef9d (diff)
toptesi (10sep12)
git-svn-id: svn://tug.org/texlive/trunk@27640 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/toptesi')
-rw-r--r--Master/texmf-dist/doc/latex/toptesi/README8
-rw-r--r--Master/texmf-dist/doc/latex/toptesi/manifest.txt2
-rw-r--r--Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex-a.pdfbin344737 -> 347069 bytes
-rwxr-xr-xMaster/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.pdfbin288741 -> 290568 bytes
-rw-r--r--Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.tex316
-rwxr-xr-xMaster/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.pdfbin67474 -> 67837 bytes
-rwxr-xr-xMaster/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.tex5
-rw-r--r--Master/texmf-dist/doc/latex/toptesi/toptesi.pdfbin362512 -> 364222 bytes
8 files changed, 173 insertions, 158 deletions
diff --git a/Master/texmf-dist/doc/latex/toptesi/README b/Master/texmf-dist/doc/latex/toptesi/README
index c4a37cb362c..f0678668f4f 100644
--- a/Master/texmf-dist/doc/latex/toptesi/README
+++ b/Master/texmf-dist/doc/latex/toptesi/README
@@ -1,5 +1,5 @@
-TOPtesi bundle version 5.60 of 2012/07/31
-Copyright 2011 Claudio Beccari
+TOPtesi bundle version 5.61 of 2012/09/09
+Copyright 2012 Claudio Beccari
LaTeX Project Public Licence LPPL v.1.3 (or later)
The TOPtesi bundle contains everything is needed for typesetting a
@@ -15,11 +15,11 @@ Thanks to its language management, the bundle is suited for
multilanguage theses that are more and more frequent thanks
to the double degree programs of the European Union Erasmus programs.
-This important upgrade is intended to be compliant with XeLaTeX and the documentation explains how to obtain PDF/A-1b archivable files from both pdfLaTeX and XeLaTeX. The version number 5.59 is to be considered as a stable beta version; in the sense that it should be equivalento to version 5.50 when used with pdfLaTeX, and an experimental version when used with XeLaTeX.
+This important upgrade is intended to be compliant with XeLaTeX and the documentation explains how to obtain PDF/A-1b archivable files from both pdfLaTeX and XeLaTeX. The version number 5.61 is a stable version.
For installation, if the package is not already installed in your
TeX system distribution, either read the Italian documentation in
-toptesi-doc.pdf or quickly decompress the toptesi.zip file and move
+toptesi-doc-xetex.pdf or quickly decompress the toptesi.zip file and move
all the pdf files
to /texmf/doc/latex/toptesi.
diff --git a/Master/texmf-dist/doc/latex/toptesi/manifest.txt b/Master/texmf-dist/doc/latex/toptesi/manifest.txt
index a8e263bec2c..edeb0730fac 100644
--- a/Master/texmf-dist/doc/latex/toptesi/manifest.txt
+++ b/Master/texmf-dist/doc/latex/toptesi/manifest.txt
@@ -1,4 +1,4 @@
-manifest.txt (version 5.60)
+manifest.txt (version 5.61)
Copyright 2008-2012 Claudio Beccari
This work may be distributed and/or modified under the conditions of
diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex-a.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex-a.pdf
index 278fb039e19..b312213aea2 100644
--- a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex-a.pdf
+++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex-a.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.pdf
index 52bdf2cd6df..d959a43b78b 100755
--- a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.pdf
+++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.tex b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.tex
index 5720ae61d63..819a3c633f0 100644
--- a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.tex
+++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.tex
@@ -3,7 +3,7 @@
%
% toptesi-doc-xetex.tex
-%% Copyright 2011 Claudio Beccari
+%% Copyright 2012 Claudio Beccari
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3
@@ -44,18 +44,38 @@
}
\newcommand*\prog[1]{\textsf{#1}}
\newcommand*\pack[1]{\textsl{\sffamily #1}}
-\newcommand\meta[1]{$\langle$\textit{#1}$\rangle$}
+\newcommand*\meta[1]{$\langle$\textit{#1}$\rangle$}
+\newcommand*\file[1]{\texttt{#1}}
+\makeatletter
+\def\GetFileInfo#1{%
+ \def\filename{#1}%
+ \def\@tempb##1 ##2 ##3\relax##4\relax{%
+ \def\filedate{##1}%
+ \def\fileversion{##2}%
+ \def\fileinfo{##3}}%
+ \edef\@tempa{\csname ver@#1\endcsname}%
+ \expandafter\@tempb\@tempa\relax? ? \relax\relax}
\begin{document}%\lccode39=39
%%%% inserire il valore corretto della versione di toptesi
-\def\fileversion{5.59}
+\GetFileInfo{toptesi.cls}
\NomeMonografia{Manuale d'uso}
\monografia{La classe \textsf{TOPtesi}}
\sottotitolo{Per comporre le tesi al Poli \\e in molte altre università}
\candidato{Claudio Beccari}
\sedutadilaurea{Versione \fileversion}
\logosede{logopolito}
+ \retrofrontespizio{Questo testo à libero secondo le condizioni stabilite dalla Creative Commons Licence, versione 3.0 o posteriore. L'enunciato integrale della Licenza in versione~3.0 è reperibile all'indirizzo internet \url{http://creativecommons.org/licenses/by-nc-nd/3.0/deed.it}.
+
+Si è liberi di riprodurre, distribuire, comunicare al pubblico, esporre in pubblico, rappresentare, eseguire e recitare quest'opera alle seguenti condizioni: attribuzione, non commerciale, non opere derivate. Il significato di queste caratteristiche è spiegato in dettagli nel sito internet indicato sopra.
+
+
+ \bigskip
+
+Composto il 9 settembre 2012
+\vspace*{5\baselineskip}}
+
\thispagestyle{empty}
\vspace*{.2\textheight}
@@ -80,7 +100,7 @@
\ringraziamenti
-Ringrazio gli studenti del Politecnico di Torino che mi hanno sollecitato a mettere la mia esperienza a loro disposizione per predisporre e rendere disponibile il software necessario per preparare le loro tesi, monografie o dissertazioni con la qualità che solo pdf\/\LaTeX\ e \XeLaTeX\ riescono a produrre\footnote{Questa particolare composizione è stata eseguita con \XeLaTeX. Questo motore di composizione presenta numerosi vantaggi su \prog{pdflatex} per quel che riguarda l'uso dei font, anche per la matematica, ma non è ancora (2011) 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 in PDF. Per questo motivo alcune delle cose descritte in questo documento possono risultare non adatte alla composizione con \prog{xelatex}. L'esperienza mi insegna che in realtà le limitazioni sono pochissime, e quella forse più preoccupante, con la classe \pack{toptesi}, riguarda il formato PDF archiviabile che non è ottenibile con \XeLaTeX.}.
+Ringrazio gli studenti del Politecnico di Torino che mi hanno sollecitato a mettere la mia esperienza a loro disposizione per predisporre e rendere disponibile il software necessario per preparare le loro tesi, monografie o dissertazioni con la qualità che solo pdf\/\LaTeX\ e \XeLaTeX\ riescono a produrre\footnote{Questa particolare composizione è stata eseguita con \XeLaTeX. Questo motore di composizione presenta numerosi vantaggi su \prog{pdflatex} per quel che riguarda l'uso dei font, anche per la matematica, ma non è ancora (2012) in grado di produrre l'uscita direttamente nel formato PDF, anche se apparentemente lo fa. In realtà la sua uscita è in un formato intermedio che viene poi trasformato in PDF. Per questo motivo alcune delle cose descritte in questo documento possono risultare non adatte alla composizione con \prog{xelatex}. L'esperienza mi insegna che in realtà le limitazioni sono pochissime, e quella forse più preoccupante, con la classe \pack{toptesi}, riguarda il formato PDF archiviabile che non è ottenibile con \XeLaTeX.}.
\indici
@@ -98,7 +118,7 @@ sola curiosità, ammesso che ce ne sia ancora qualcuna disponibile
e le poche superstiti non siano tutte nei musei.
Oggi si scrive con uno dei tanti sistemi di elaborazione di testi,
-detti anche ``word processors'', che fanno parte più o meno di
+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.
@@ -152,7 +172,7 @@ gestibile la mole enorme delle estensioni di \LaTeX\ che in
comunità degli altri utenti. Insomma è successo con \TeX\ e
\LaTeX\ quello che succede normalmente con il software libero.
-Attenzione: Knuth paga di tasca sua un dollaro a chiunque trovi un
+Attenzione: Knuth paga di tasca sua un assegno a chiunque trovi un
errore nel suo software; a tutt'oggi non è andato in bancarotta,
sia perché gli errori sono rarissimi, sia perché quelle poche
persone che hanno segnalato errori veri e hanno ricevuto l'assegno
@@ -207,12 +227,12 @@ Attenzione: questa guida presuppone che voi abbiate già uno conoscenza di base
Ricordatevi però che il vostro primo problema sarà quello di superare lo scoglio psicologico di non vedere subito il frutto delle vostre fatiche; abituati come siete ai word processor che seguono il paradigma \emph{What you see is what you get}, che più realisticamente andrebbe scritto \emph{What you see is all you can get} (Quello che vedi e tutto quel che puoi ottenere), dovete passare al paradigma: \emph{What you see is what you mean}, dove l'aspetto grafico di quel che si vede sullo schermo del PC in fase di composizione non è importante, ma è importante quello che avete scritto; il suo aspetto grafico gli verrà dato da \LaTeX\ in un secondo tempo e in una maniera estremamente professionale. Non pretendo di dire che non si possano scrivere tesi ancora più professionali di come si ottengono con \textsf{TOPtesi}, ma certo il risultato è molto migliore di quello che si può ottenere con qualsiasi word processor.
-Volete avere una migliore approssimazione sulla finestra di composizione, in modo da restare su una via di mezzo fra le due posizioni di composizione? Usate LyX, oppure usate la componente \prog{Writer} di OpenOffice; questa componente può essere arricchita con una estensione, scaricabile dal sito di OpenOffice, che si chiama \prog{Writer2LaTeX}. Mentre sto scrivendo questi appunti la versione stabile non consente di usare \prog{Writer} come se fosse un editor per \LaTeX; ma è già disponibile una versione sperimentale, che diventerà la versione ufficiale~1.2 di questa estensione, che permette di usare con certe limitazioni il programma \prog{Writer} come un editor per \LaTeX, per poi disporre di un comodo bottone da cliccare per ottenere la composizione del testo sorgente, ed un altro comodo bottone per la visualizzazione dell'uscita in formato PDF. Gli utenti esperti possono superare le limitazioni inserendo nel testo sorgente adeguate istruzioni in linguaggio \LaTeX, cosicché quello che non può fare \prog{Writer} come word processor, lo fa poi \LaTeX\ nella sua qualità di text processor.
+Vi sconsiglio fortemente di lasciarvi ``attrarre'' dall'usare programmi come LyX o TeXmacs' vi danno l'illusione di comporre come fareste con un comune word processor, anzi TeXmacs usa gli stessi font che userebbe \LaTeX; è tutta una illusione; la comodità del comporre in modo da vedere sullo schermo qualcosa che vorrebbe essere molto simile a quanto \LaTeX\ produrrà, vi distrae dal vostro compito di fare attenzione al significato di quello che scrivete, e vi mettere a ``giocare'' con la sua forma. Non solo, ma quando vorrete estendere le capacità di presentare il testo alla \LaTeX\ di quello che volete scrivere, scoprirete ben presto che con LyX e difficile e con TeXmacs è impossibile.
-Personalmente non consiglierei queste vie di mezzo; tuttavia vale la pena sapere che esistono e che possono essere usate, sia pure con qualche limitazione. Non le consiglio, perché il fatto di non poter vedere subito l'aspetto grafico di quanto si scrive è un pregio, non un difetto; chi scrive non è distratto dai dettagli grafici e concentra la sua attenzione su quello che scrive.
+Procuratevi invece un ottimo \emph{shell editor} predisposto per lavorare con \LaTeX\ e, possibilmente, anche con \XeLaTeX; supererete ben presto l'imbarazzo di non poter vedere subito il risultato del vostro scrivere, am sarete abbondantemente ricompensati dalle infinite possibilità compositive dei programmi del sistema \TeX. Più avanti ne parlerò diffusamente, ma qui ho voluto avvisarvi subito di non farvi incantare dal canto delle sirene come LyX e TeXmacs.
\section{Installare \LaTeX}
-Quindi per cominciare a lavorare con \LaTeX\ per prima cosa dovete
+Per cominciare a lavorare con \LaTeX\ per prima cosa dovete
installarvi il software; ovviamente se vi siete già installati
l'intero sistema \TeX\ ed è già calibrato per comporre
correttamente, potete saltare questo paragrafo.
@@ -222,16 +242,16 @@ Ci sono sostanzialmente tre situazioni:
\item se siete degli utenti delle piattaforme Windows allora
collegatevi in rete al sito \texttt{www.miktex.org} e scaricatevi
ed installatevi la distribuzione di \LaTeX, o meglio, del sistema
-\TeX\ chiamato MiK\TeX. Scaricatevi l'installazione completa, anche se potreste installarvi la versione di base \texttt{small-miktex} e, seguendo le istruzioni di installazione,
-potreste configurare il programma in modo da consentirgli di scaricare
+\TeX\ chiamato MiK\TeX. Scaricatevi l'installazione completa, anche se potreste installarvi la versione di base \texttt{small-miktex} che, seguendo le istruzioni di installazione,
+potreste configurare in modo da consentirgli di scaricare
dalla rete ogni possibile pacchetto di estensione che possa via
via esservi necessario.
Ovviamente questo scaricamento implica una
connessione di rete sufficientemente veloce; personalmente ero solito scaricare la versione completa. Poi ho cambiato piattaforma (sono passato ad una marca che sembra di origine scozzese) e non uso più MiKTeX (che però ho usato con la massima soddisfazione fin dai suoi primi passi).
-Oggi su una macchina Windows preferirei installare la versione TeX Live che viene gestita nello stesso modo sia sulle piattaforme Windows, Linux e Mac. Il pregio è che la versione TeX Live viene aggiornata quasi quotidianamente sui server e comunque è la versione dalla quale Christian Schenk (il curatore di MiKTeX) attinge per creare gli aggiornamenti di MiKTeX.
-Saltuariamente aggiorno l'installazione, mediante un comodo TeX Live Manager con interfaccia grafica, diciamo ogni due o tre settimane, per cui il mio software è sempre aggiornatissimo.
+Oggi su una macchina Windows preferirei installare la versione TeX Live che viene gestita nello stesso modo sia sulle piattaforme Windows, Linux e Mac. Il pregio è che la versione TeX Live viene aggiornata quasi quotidianamente sui server e comunque è la versione dalla quale Christian Schenk (il curatore di MiKTeX) attinge per creare gli aggiornamenti di MiKTeX; necessariamente, quindi, prima che Christian sia riuscito a portare MiK\TeX\ allo stesso livello di TeX Live, passano di solito alcune settimane, a volte anche di più; non voglio togliere niente alla bravura di Christian, ma il progetto MiK\TeX\ è il lavoro di un solo uomo, mentre TeX Live è il frutto del lavoro di una squadra completa e attivissima.
+Disponendo di TeX Live sulle tre piattaforme che sono solito usare, Windows XP, Ubuntu Linux e Mac, saltuariamente aggiorno ciascuna installazione, mediante un comodo TeX Live Manager con interfaccia grafica, diciamo ogni due o tre settimane, per cui il mio software è sempre aggiornatissimo; lo consiglio anche a voi.
\item Siete degli utenti di Linux; in questo caso siete particolarmente
fortunati perché il sistema \TeX\ fa parte integrante di
@@ -239,14 +259,16 @@ qualunque distribuzione, anche se non viene installato di default;
vi basta inserire il disco di installazione o vi basta connettervi
in rete e invocare uno dei vari programmi come \prog{apt-get},
\prog{rpm} o \prog{yast} per scaricare tutto quanto vi serve e
-per configurare l'installazione. Ricordatevi che Linux un po'
+per configurare l'installazione. Ricordatevi che Linux è un po'
più ``ruspante'' di Windows, e quindi la configurazione richiede
un po' più di attenzione e di smanettamento con la riga di
comando; ma a questo, in qualità di ``pinguini doc'', ci siete
abituati; in compenso avete il beneficio di avere tutto quanto il
software già predisposto fin dalla nascita per macchine UNIX e
Linux e quindi evitate tutti i (pochi) piccoli bug che si
-incontrano quando le cose sono tradotte per altri sistemi. Fate solo attenzione alle distribuzioni Debian; sono eccellenti e ne è garantita la compatibilità con lo specifico sistema operativo, ma solitamente sono in ritardo di un paio di anni rispetto alle versioni aggiornate pubblicate dal \TeX\ Users Group! Se appena potete installate la distribuzione TeX Live completa scaricata dal sito \texttt{ctan} ufficiale.
+incontrano quando le cose sono tradotte per altri sistemi.
+
+Fate solo attenzione alle distribuzioni Debian; sono eccellenti e ne è garantita la compatibilità con lo specifico sistema operativo, ma solitamente sono in ritardo di un paio di anni rispetto alle versioni aggiornate pubblicate dal \TeX\ Users Group! Se appena potete installate la distribuzione TeX Live completa scaricata dal sito \texttt{ctan} ufficiale. Esiste in rete un testo intitolato \emph{texlive-ubuntu.pdf}\footnote{Questo testo è stato scritto nel 2010 per installare TeX Live su Ubuntu, che è di tipo Debian, ma ci sono anche le istruzioni per Fedora e OpenSuse; con piccole varianti sono istruzioni che vanno bene per qualunque macchina Linux.}, che trovate con qualunque motore di ricerca; vi istruisce su come installare TeX Live fresco di giornata (e aggiornabile sistematicamente come detto sopra per le macchine Windows) a fianco della distribuzione Debian di TeX Live; quest'ultima serve per soddisfare le dipendenze di altri programmi Debian; la prima, invece, vi serve per lavorare davvero.
\item Siete degli utenti delle piattaforme Macintosh e siete i
fortunati possessori di un portatile o di un desktop che funziona
@@ -257,36 +279,33 @@ specificità del sistema che state usando. Cercate il nome MacTeX
con un qualunque motore di ricerca e sarete portati ad un sito dal
quale potrete scaricare il pacchetto di installazione (piuttosto
grosso); alla fine del download vi viene chiesto se continuare con
-l'installazione; rispondendo affermativamente, il software vi vene
-scaricato sul disco che avrete indicato, ma quel che è più
-comodo, esso già configurato per scrivere e sillabare anche in
-italiano. Il sistema \prog{Mac\TeX} produce il suo output solo
+l'installazione; rispondendo affermativamente, il software vi viene
+scaricato sul disco che avrete indicato, ma quel che è più
+comodo, esso è già ccompleto, come ogni distribuzione e installazione TeX Live.
+Il sistema \prog{Mac\TeX} produce il suo output solo
in formato PDF; se ne tenga conto leggendo attentamente la
-documentazione, perché la cosa può essere critica con
-l'inserimento delle immagini. Il pacchetto è già dotato dello
-shell editor \TeX{}shop e fa ricorso ad un suo previewer interno per
+documentazione. Il pacchetto è già dotato dello
+shell editor \TeX{}shop che fa ricorso ad un suo previewer interno per
il formato PDF; potrebbe essere una buona idea scaricare dalla
-rete anche l'applicativo freeware Adobe Reader che dalla versione 9 in poi è anche in grado di riconoscere se un file è conforme al formato PDF/A, anche se non è in grado di validarlo come tale; Adobe Reader X quando apre un file che potrebbe essere conforme allo standard PDF/A apre in testa una riga di informazione nella quale dice che il file è conforme a questo standard; non è il caso di prendere per verità assoluta quella affermazione assoluta, perché talvolta i file che passano il test di Adobe Reader X non passano il test di Preflight di Adobe Acrobat.. Consente di estrarre delle informazioni che sono difficili da estrarre con altri visualizzatori dei file in formato PDF e consente di aggiungere annotazioni. Naturalmente esistono altri visualizzatori dei file in formato PDF; il visualizzatore di sistema consente di aprire e di editare parzialmente anche altri formati grafici e consente di eseguire molte operazioni, in particolare sui file PDF, che in generale richiedono sofisticati programmi di editing grafico.
+rete anche l'applicativo freeware Adobe Reader che dalla versione 9 in poi è anche in grado di riconoscere se un file è conforme al formato PDF/A, anche se non è in grado di validarlo come tale; Adobe Reader X, quando apre un file che potrebbe essere conforme allo standard PDF/A, apre in testa alla schermata una riga di informazione nella quale dice che il file è conforme a questo standard; non è il caso di prendere per verità assoluta quella affermazione assoluta, perché talvolta i file che vengono classificati conformi allo standard PDF/A da Adobe Reader X, talvolta non passano il test di Preflight di Adobe Acrobat. Consente di estrarre delle informazioni che sono difficili da estrarre con altri visualizzatori dei file in formato PDF e consente di aggiungere annotazioni. Naturalmente esistono altri visualizzatori dei file in formato PDF; il visualizzatore di sistema consente di aprire e di editare parzialmente anche altri formati grafici e consente di eseguire molte operazioni, in particolare sui file PDF, che in generale richiedono sofisticati programmi di editing grafico.
Attenzione, però: il previewer interno di \TeX{}shop e \TeX{works} consentono di eseguire l'\textit{inverse search} e, ovviamente, anche di fare la \textit{forward search}. Questo è molto comodo durante la fase di editing del vostro documento. Gli altri visualizzatori hanno difficoltà se non proprio l'impossibilità di ``accordarsi'' con la parte di editing testuale per consentire la ricerca diretta e inversa.
\end{enumerate}
-Merita di segnalare che per tutte e tre le piattaforme è disponibile e, generalmente, è già installato di default anche l'editor \TeX{}works (multipiattaforma) che con il suo visualizzatore interno consente di eseguire su tutte le piattaforme la ricerca diretta e inversa. Ad alcuni, abituati a interfacce grafiche fornite di molte barre cariche di icone per eseguire il possibile e l'impossibile, \TeX{}works piace poco perché la sua schermata è scarna ed essenziale, ma c'è un motivo: nei moderni schermi larghi, con rapporto di forma 16:9, lo schermo contiene accostate e senza sovrapposizioni sia la finestra di editing sia quella del testo composto; questo è molto comodo, più di quanto si possa immaginare, per ``lavorare'' agevolmente il documento da comporre.
+Merita di segnalare che per tutte e tre le piattaforme è disponibile e, generalmente, è già installato di default anche l'editor \TeX{}works (multipiattaforma) che con il suo visualizzatore interno consente di eseguire su tutte le piattaforme la ricerca diretta e inversa. Ad alcuni, abituati a interfacce grafiche fornite di molte barre cariche di icone per eseguire il possibile e l'impossibile, \TeX{}works piace poco perché la sua schermata è minimale, ma c'è un motivo: nei moderni schermi larghi, con rapporto di forma 16:9, lo schermo contiene accostate e senza sovrapposizioni sia la finestra di editing sia quella del testo composto; questo è molto comodo, più di quanto si possa immaginare, per ``lavorare'' agevolmente il documento da comporre.
Poi avete bisogno di programmi accessori per visualizzare sullo schermo e/o stampare su carta i prodotti delle vostre composizioni. Ognuna delle tre piattaforme tipo può avere già
-installati sia i visualizzatori dei file in formato \texttt{.dvi}, \texttt{.ps} o \texttt{.pdf}. Il formato \texttt{.dvi} è il formato nativo del sistema \TeX\ quindi il software per visualizzare e stampare arriva insieme alla distribuzione che avete già installato. Per il formato \texttt{.ps} bisogna disporre di qualcosa come \prog{ghostscript} e/o \prog{GSView} o altri simili software che con Linux sono solitamente già disponibili insieme al sistema. In ogni caso non è difficile trovare in rete i luoghi da dove scaricarli. Per il formato \texttt{.pdf} Linux, come al solito è già attrezzato, ma suggerisco per tutti e tre i tipi di piattaforme il programma \prog{Adobe Reader} che la Adobe mette a disposizione di chiunque e gratuitamente per tutte le possibili piattaforme. Naturalmente l'\prog{Adobe Reader} è una specie di programma dimostrativo, per altro eccellente; ma credo che la Adobe lo metta a disposizione per far venire l'acquolina in bocca e per invogliare a comperare il prodotto commerciale completo \prog{Adobe Acrobat}, che per gli studenti non costa molto. Secondo me vale ogni dollaro che costa, ma ovviamente questo giudizio dipende dall'uso che se ne fa.
-
-Infine è necessario disporre di un programma di composizione di
-testi ASCII che sia anche un po' d'aiuto per comporre con \LaTeX.
-Il programma gratuito che, a detta degli appassionati, serve per
-fare tutto sarebbe \prog{emacs}, disponibile per tutte e tre le
-piattaforme anche se è nativo di UNIX. Sarà anche vero che è
-quasi onnipotente, ma per me è difficile da usare; diciamo che ha
+installati sia i visualizzatori dei file in formato \texttt{.dvi}, \texttt{.ps} o \texttt{.pdf}. Il formato \texttt{.dvi} è il formato nativo del sistema \TeX\ quindi il software per visualizzare e stampare arriva insieme alla distribuzione che avete già installato, però oggi è un formato che non si usa quasi più. Per il formato \texttt{.ps} bisogna disporre di qualcosa come \prog{ghostscript} e/o \prog{GSView} o altri simili software che con Linux sono solitamente già disponibili insieme al sistema. In ogni caso non è difficile trovare in rete i luoghi da dove scaricarli. Per il formato \texttt{.pdf} Linux, come al solito è già attrezzato, ma non è male per tutti e tre i tipi di piattaforme il programma \prog{Adobe Reader} che la Adobe mette a disposizione di chiunque e gratuitamente per tutte le possibili piattaforme. Naturalmente l'\prog{Adobe Reader} è una specie di programma dimostrativo, per altro eccellente; ma credo che la Adobe lo metta a disposizione per far venire l'acquolina in bocca e per invogliare a comperare il prodotto commerciale completo \prog{Adobe Acrobat}, che per gli studenti non costa molto. Secondo me vale ogni dollaro che costa, ma ovviamente questo giudizio dipende dall'uso che se ne fa.
+
+Oggi, invece, è molto importante disporre di visualizzatori PDF integrati con l'editor, in modo che siano predisposti per lavorare in tandem sia per mostrare costantemente a fianco della finestra di editing la finestra del file composto in formato PDF, sia per fare la ricerca diretta e inversa; oltre ai già citati \TeX{}shop (solo Mac) e \TeX{]works (multipattaforma) posso citare gli editor TeXsudio e Texmaker (multipiattaforma e molto simili fra loro); altri \emph{shell editor} non dispongono di un visualizzatore integrato, am possono venire ``sincronizzati'' con visualizzatori esterni; per esempio su piattaforme Windows il visualizzatore sincronizzabile è SumatraPDF; si Linux è Okular; su Mac ne posso citare altri due: TeXnicle (gratuito) e Texpad (commerciale, ma con un costo accessibilissimo) che non solo hanno il visualizzatore integrato, ma le loro ``finestre'' sono in realtà due parti di una stessa finestra; ingrandendola a pieno schermo si ottiene una comodità di composizione difficilmente ottenibile con altri sistemi.
+
+Anche Emacs (multipiattaforma), arricchito del plug-in Auctex, che lo rende particolarmente adatta per gestire i file del sistema \TeX, è sincronizzabile con vari visualizzatori PDF; avendo la pazienza di imparare ad usarlo in modo non superficiale, Emacs assieme ad Auctex rendono il lavoro con il sistema \TeX\ particolarmente comodo. Sarà anche vero che è
+quasi onnipotente, ma per me è difficile da usare; diciamo che ha
una curva di apprendimento piuttosto ripida e per la mia età le
salite ripide non sono indicate.
-Per le piattaforme Linux esiste un bel software che si chiama
+Per le piattaforme Linux esiste un bello \emph{shell editor} che si chiama
\prog{Kile} (KDE Integrated \LaTeX\ Environment) ed è fatto
apposta per lavorare con \LaTeX. Esso è montabile anche sulle
piattaforme Windows pur di disporre dell'ambiente \prog{Cygwin}
@@ -295,15 +314,13 @@ sistemi Operativi per Windows) dentro il quale si sia già
installato tanto KDE (K Desktop Environment) quanto le sue
librerie di sviluppo.
-Per le piattaforme Windows ci sono diverse soluzioni di tipo
-freeware, per esempio \prog{TeXnicCenter}, \prog{TeXmaker} e \prog{TeXStudio}, questi ultimi multipiattaforma, molto versatili e, dalla versione 2 in pi, sono dotati di un visualizzatore interno per il formato PDF estremamente valido (vedi più avanti).
-Esiste il prodotto shareware WinEdt scaricabile da \texttt{www.winedt.com}. Vale ogni dollaro che costa e non serve solo per lavorare con \LaTeX; io l'ho usato anche per i miei linguaggi di programmazione preferiti e credo di avere risparmiato un bel po' di tempo grazie alle sue funzionalità.
+Per le piattaforme Windows Il programma di installazione di MiK\TeX\ offre la possibilità di installare \prog{TeXnicCenter}, ma lo sconsiglio vivamente, perché non è all'altezza delle distribuzioni moderne di TeX Live. C'è anche lo \emph{shell editor} WinEdt (shareware), ottimo e dalla versione 8 in poi sembra che sia dotato di un visualizzatore integrato PDF (comunque è sincronizzabile con SumatraPDF).
Per le piattaforme Mac esistono diversi programmi; a me sembra che il migliore
di tutti sia \TeX{}shop, automaticamente installato quando si usa la
-distribuzione \prog{Mac\TeX}. ``Migliore'' significa qui il giusto compromesso fra la semplicità e l'efficienza e la validissima integrazione con un suo visualizzatore interno che consente di eseguire con un semplice click di mouse il passaggio da un punto della finestra di composizione del file sorgente al punto corrispondente nella finestra del documento composto in formato PDF, e viceversa.
+distribuzione \prog{Mac\TeX}. ``Migliore'' significa qui il giusto compromesso fra la semplicità e l'efficienza e la validissima integrazione con un suo visualizzatore interno che consente di eseguire con un semplice click di mouse il passaggio da un punto della finestra di composizione del file sorgente al punto corrispondente nella finestra del documento composto in formato PDF, e viceversa. Suo ``filgio'' \TeX{}works (multipiattaforma) sembra avere qualche funzionalità in meno (non è così vero), ma ha una interfaccia comodissima per scoprire al codifica di un file \file{.tex} e per convertire il file in un'altra codifica; \TeX{}shop e \TeX{}works sono autoconfigurabili per ciascun file \file{.tex} grazie ad alcune righe di commenti speciali da scrivere in testa la file, cosa che rende il loro uso incredibilmente comodo. TeXstudio dalla versione 2.4 in poi è in grado di interpretare le stesse ricche speciali di \TeX{}shop e di autoconfigurarsi di conseguenza (settembre 2012). Emacs con Auctex sono in grado di usare righe di autoconfigurazione che però hanno una sintassi divera da quelle di \TeX{}shop.
-Per tutte e tre le piattaforme principali \prog{TeXStudio} offre notevoli vantaggi, compresa la visualizzazione di parti del testo da comporre che richiedano più interazione fra il compositore il il software. Permette anche di disporre di una finestra laterale che contiene tutta la struttura ad albero del documento da comporre; cliccando su ogni ramo o rametto di questo albero, il programma sposta la finestra sul punto del file sorgente dove quella sezione comincia. Anche \prog{Kile} ha questa funzionalità; risulta molto comoda. Quasi tutti gli editor citati \emph{non} consentono di fare la ricerca inversa con il formato di uscita PDF, ma solo con il formato DVI. \prog{TeXShop} per Mac, e \prog{TeXworks} e le due versioni \prog{TeXmaker} e \prog{TeXStudio} per tutte le piattaforme permettono di eseguire la ricerca inversa anche con il formato PDF, e questa particolarità è estremamente comoda. Per le piattaforme Windows esiste il visualizzatore PDF \prog{SumatraPDF} che può essere configurato per interagire con l'editor per poter essere usati assieme sia con la ricerca diretta sia con quella inversa. Va da sé, che se non ci sono esigenze diverse, il formato di uscita PDF è sicuramente quello da preferire.
+Per tutte e tre le piattaforme principali \prog{TeXStudio} offre notevoli vantaggi, compresa la visualizzazione di parti del testo da comporre che richiedano più interazione fra il compositore il il software. Permette anche di disporre di una finestra laterale che contiene tutta la struttura ad albero del documento da comporre; cliccando su ogni ramo o rametto di questo albero, il programma sposta la finestra sul punto del file sorgente dove quella sezione comincia. Anche \prog{Kile} ha questa funzionalità; risulta molto comoda. Quasi tutti gli editor citati \emph{non} consentono di fare la ricerca inversa con il formato di uscita PDF, ma solo con il formato DVI. \prog{TeXShop} per Mac, e \prog{TeXworks} e le due versioni \prog{TeXmaker} e \prog{TeXStudio} per tutte le piattaforme permettono di eseguire la ricerca inversa anche con il formato PDF, e questa particolarità è estremamente comoda. Per le piattaforme Windows esiste il visualizzatore PDF \prog{SumatraPDF} che può essere configurato per interagire con molti editor per poter essere usati assieme sia con la ricerca diretta sia con quella inversa. Va da sé, che se non ci sono esigenze diverse, il formato di uscita PDF è sicuramente quello da preferire.
\section{Ora siete pronti}
Ora che avete scaricato tutto il software gratuito o commerciale di cui
@@ -315,9 +332,9 @@ Attenzione: non si minimizzi la frase precedente: la documentazione va letta sem
A qualcuno può venire in mente: ``Ma non sarà mica che ci siano in giro dei programmi che permettono di fare tutto questo in modo WYSIWYG?'' Come noto, WYSIWYG è l'acronimo che si forma con le iniziali di ``what you see is what you get''. \LaTeX\ dovrebbe essere classificato con l'acronimo WYSIWYM che sta per ``what you see is what you mean''. Certo per ottenere esattamente quello che si voleva bisogna lavorare (apparentemente) di più; in realtà bisogna usare di più la testa e di meno il mouse.
-Tuttavia là fuori nei negozi ci sono diversi prodotti che consentono di usare \LaTeX\ praticamente in modo WYSIWYG; da Scientific Word a LyX a TeXmacs a Textures ce ne è per ogni piattaforma; LyX e TeXmacs sono freeware mentre gli altri costano attorno ai 500\textdollar. Poi c'è la soluzione gratuita di OpenOffice con l'estensione~1.2 di \prog{Writer2LaTeX}.
+Tuttavia là fuori nei negozi ci sono diversi prodotti che consentono di usare \LaTeX\ praticamente in modo WYSIWYG; da Scientific Word a LyX a TeXmacs a Textures ce ne è per ogni piattaforma; LyX e TeXmacs sono freeware mentre gli altri costano attorno ai 500\textdollar. Poi c'è la soluzione gratuita di OpenOffice con l'estensione~1.2 di \prog{Writer2LaTeX}. Io le sconsiglio tutte, come ho già avuto modo di dire, e qui ne ripeto i motivi.
-Sia però chiaro; per poter operare in modo ``sincrono'' così da avere immediatamente sullo schermo una cosa molto simile a quello che si otterrà sulla carta, il programma deve essere velocissimo ad eseguire il rendering grafico di quanto viene via via composto; per questo motivo deve rinunciare a non poche funzionalità del sistema \TeX. Però tutti questi software hanno la possibilità di salvare i file in formato \texttt{.tex}, cioè nel formato sorgente del sistema \TeX, per cui una volta finito l'editing si può eseguire la composizione finale con il programma vero, e non tramite le funzionalità del programma di editing.
+Per poter operare in modo ``sincrono'' così da avere immediatamente sullo schermo una cosa molto simile a quello che si otterrà sulla carta, il programma deve essere velocissimo ad eseguire il rendering grafico di quanto viene via via composto; per questo motivo deve rinunciare a non poche funzionalità del sistema \TeX. Però tutti questi software hanno la possibilità di salvare i file in formato \texttt{.tex}, cioè nel formato sorgente del sistema \TeX, per cui una volta finito l'editing si può eseguire la composizione finale con il programma vero, e non tramite le funzionalità del programma di editing.
Io ho cominciato a lavorare con \LaTeX\ a metà degli anni '80 e non ho mai usato editor sincroni. Una ventina di anni fa ho esaminato Textures per aiutare un collega statunitense che stava scrivendo un libro con quel software, ma non sapeva come fare per disporre di macro adatte per la composizione della matematica di cui aveva bisogno; ma dopo poco ho lasciato perdere perché dovevo lavorare su una piattaforma Mac altrui e non potevo seccarlo in continuazione per chiedergli come si fa questo, come si fa quello; allora il sistema operativo era molto diverso dall'attuale Mac~OS~X e solo gli addetti ai lavori sapevano come usarlo al meglio. Però non ne ero rimasto particolarmente impressionato, anche perché allora i font vettoriali venivano gestiti in modo molto più complesso di oggi.
@@ -334,7 +351,7 @@ stessi, proprio per poter massimizzare la velocità di rendering.
conoscenza di \LaTeX\ e che conosciate la differenza fra \LaTeX,
pdf\LaTeX\ e \XeLaTeX.}
-Nello stesso modo dubito che qualcuno abbia conoscenze a proposito del programma e mark-up \XeLaTeX; è un tipo di mark-up molto simile a quello di \LaTeX\ e di pdf\LaTeX, ma ha una gestione dei font diversa e può usare anche i font del sistema operativo della vostra macchina, senza dover fare nessuna acrobazia. Esso ha delle limitazioni per quel che riguarda la creazione dei file in formato PDF archiviabile, benché l'uscita finale sia in formato PDF; gli si possono dare in pasto le figure nei formati accettati sia dal programma \prog{latex} (formato EPS), sia dal programma \prog{pdflatex} (formati PDF, PNG, JPG). Per la gestione delle lingue dispone di un suo pacchetto \pack{polyglossia} che è specifico per questo programma di composizione. L'uso di \XeLaTeX\ non è ancora molto sviluppato, ma certamente è il motore di composizione più adatto alle tesi di carattere letterario, specialmente se contengono estesi brani composti con ``lettere'' non appartenenti all'alfabeto latino.
+Nello stesso modo dubito che qualcuno abbia conoscenze a proposito del programma e mark-up \XeLaTeX; è un tipo di mark-up molto simile a quello di \LaTeX\ e di pdf\LaTeX, ma ha una gestione dei font diversa e può usare anche i font del sistema operativo della vostra macchina, senza dover fare nessuna acrobazia. Esso ha delle limitazioni per quel che riguarda la creazione dei file in formato PDF archiviabile, benché l'uscita finale sia in formato PDF; gli si possono dare in pasto le figure nei formati accettati sia dal programma \prog{latex} (formato EPS), sia dal programma \prog{pdflatex} (formati PDF, PNG, JPG). Per la gestione delle lingue dispone di un suo pacchetto \pack{polyglossia} che è specifico per questo programma di composizione. L'uso di \XeLaTeX\ non è ancora molto sviluppato, ma sta guadagnando terreno specialmente fra i linguisti; certamente è il motore di composizione più adatto alle tesi di carattere letterario, specialmente se contengono estesi brani composti con ``lettere'' non appartenenti all'alfabeto latino.
Merita qui segnalare con una tabellina le principali differenze fra pdf\/\LaTeX\ e \XeLaTeX, tabella~\ref{tab:pdflatex-vs-xelatex}.
@@ -352,19 +369,19 @@ Lingue retrograde & \raggedright Solo mediante pacchetti esterni
& \centering Font OpenType \tabularnewline
Ideogrammi & \raggedright Solo mediante pacchetti esterni
& \centering Font OpenType \tabularnewline
-Gestione Lingue & \centering circa 50 lingue &\centering circa 40 lingue \tabularnewline
-Formati immagini & \raggedright EPS per uscita in DVI oppure PDF, JPG, PNG per uscita in PDF & PDF, JPG, PNG, EPS \tabularnewline
-Possibilità di scontornare&\centering SI & \raggedright Ridotta e accessibile solo attraverso i comandi primitivi del motore \prog{xetex}\tabularnewline
-Microgiustificazione& \centering Completa & \centering Quasi assente \tabularnewline
+Gestione Lingue & \centering quasi 80 lingue &\centering quasi 70 lingue \tabularnewline
+Formati immagini & \raggedright EPS($\dagger$), PDF, JPG, PNG & PDF, JPG, PNG, EPS \tabularnewline
+Possibilità di scontornare&\centering SI & \raggedright Ridotta ma può essere migliorata attraverso i comandi primitivi del motore \prog{xetex}\tabularnewline
+Microgiustificazione& \centering Completa & \centering Solo protrusione \tabularnewline
Formato archiviabile& \centering PDF/A-1b & \centering NO (*) \tabularnewline
\bottomrule
\end{tabular}\par}
\caption{Le principali differenze fra pdf\/\LaTeX\ e \XeLaTeX}\label{tab:pdflatex-vs-xelatex}
+\vspace{\smallskipamount}
\small \noindent (*) \XeLaTeX\ non consente la produzione diretta del formato PDF/A, ma ne consente la trasformazione, forse, in modo più sicuro che con pdf\/\LaTeX.
-\end{table}
-
-
+\noindent ($\dagger$) Dalla versione del 2010 pdf\LaTeX converte automaticamente in formato PDF i file EPS, conservandone quindi il carattere vettoriale; provvede anche a scontornarli.
+\end{table}
\chapter{L'uso di \textsf{TOPtesi}}
@@ -376,14 +393,14 @@ l'acronimo TOP sta per \textcolor{red}{TO}rino \textcolor{red}{P}olitecnico e na
Tuttavia il pacchetto non è stato creato solo per il Politecnico
di Torino; le informazioni relative a questo ateneo sono di
-default, così come la facoltà di ingegneria è la facoltà di
+default, così come la facoltà di ingegneria è la facoltà di
default. Ma i comandi predisposti consentono di personalizzare il
pacchetto per ogni ateneo e ogni facoltà e, oserei dire, in ogni
lingua.
-Tenete conto che \textsf{TOPtesi} è già stato usato anche per
+Tenete conto che \textsf{TOPtesi} è già stato usato anche per
scrivere tesi in filologia classica greca e in filologia copta;
-\textsf{TOPtesi} non è limitato solo a scritti delle discipline
+\textsf{TOPtesi} non è limitato solo a scritti delle discipline
cosiddette esatte, quelle che fanno un grande uso del linguaggio
matematico, ma è altrettanto utile per scrivere testi in
discipline umanistiche, perché \LaTeX\ e pdf\LaTeX\ sono
@@ -394,7 +411,7 @@ nel comporre una poesia o un romanzo o un'edizione critica.
\section{Dove sono i file di \textsf{TOPtesi}?}
La distribuzione di \textsf{TOPtesi} contiene molti file; ma ogni distribuzione moderna del sistema \TeX\ li carica tutti senza che dobbiate intervenire a mano. Tuttavia è importante che voi sappiate dove trovare questi file.
-L'installazione del sistema \TeX\ prevede che i suoi numerosissimi file siano installati in un certo numero di strutture di cartelle, chiamate ``alberi''; ogni albero ha una radice; normalmente la radice della distribuzione si chiama \texttt{texmf-dist}, ma sulla vostra macchina e con il vostro sistema operativo potrebbe avere un altro nome. Esiste anche un albero radicato nella vostra ``home''; nei sistemi di stampo UNIX essa si indica simbolicamente con la tilde e la radice del vostro albero personale potrebbe chiamarsi \texttt{\~{}/texmf}; sulle macchine Windows invece dovete cercare in \texttt{C:\char92Documents and settings} seguito dal vostro user name oppure da \texttt{All users}; magari ci sono ancora altri rami di albero da percorrere, ma poi si trova \texttt{texmf} o \texttt{localtexmf}. Nei sistemi Mac la radice del vostro albero personale è sotto la vostra \texttt{\textasciitilde/Library}. L'albero personale non è mai inizialmente predisposto con l'installazione del sistema \TeX; ve lo dovete creare voi. In esso creerete una struttura di rami identica a quella degli alberi di sistema, magari sarà un albero più semplice e non così ramificato come gli alberi di sistema, ma i gruppi di cartelle presenti dovranno essere innestati nello stesso modo. Qui metterete i vostri file di classe, di stile, di definizioni, eccetera, personali. quando aggiornate la vostra distribuzione del sistema \TeX\ le cartelle degli alberi di sistema potranno essere completamente riscritte, mentre il vostro albero personale non verrà assolutamente modificato.
+L'installazione del sistema \TeX\ prevede che i suoi numerosissimi file siano installati in un certo numero di strutture di cartelle, chiamate ``alberi''; ogni albero ha una radice; normalmente la radice della distribuzione si chiama \texttt{texmf-dist}, ma sulla vostra macchina e con il vostro sistema operativo potrebbe avere un altro nome. Esiste anche un albero radicato nella vostra ``home''; nei sistemi di stampo UNIX essa si indica simbolicamente con la tilde e la radice del vostro albero personale potrebbe chiamarsi \texttt{\~{}/texmf}; sulle macchine Windows invece dovete cercare in \texttt{C:\char92Documents and settings} seguito dal vostro user name, oppure da \texttt{All users}, oppure da \texttt{Users} seguito dal vostro nome; magari ci sono ancora altri rami di albero da percorrere, ma poi si trova \texttt{texmf} o \texttt{localtexmf}. Nei sistemi Mac la radice del vostro albero personale è sotto la vostra \texttt{\textasciitilde/Library}. L'albero personale non è mai inizialmente predisposto con l'installazione del sistema \TeX; ve lo dovete creare voi. In esso creerete una struttura di rami identica a quella degli alberi di sistema, magari sarà un albero più semplice e non così ramificato come gli alberi di sistema, ma i gruppi di cartelle presenti dovranno essere innestati nello stesso modo. Qui metterete i vostri file di classe, di stile, di definizioni, eccetera, personali. quando aggiornate la vostra distribuzione del sistema \TeX\ le cartelle degli alberi di sistema potranno essere completamente riscritte, mentre il vostro albero personale non verrà assolutamente modificato.
Tutti i file del pacchetto \textsf{TOPtesi} vengono caricati nell'albero della distribuzione; i file della documentazione lungo il ramo \texttt{doc}; i file sorgente, lungo il ramo \texttt{source}; i file ``eseguibili'' in una cartella lungo il ramo \texttt{tex}; fra questi file ``eseguibili''\footnote{Chiamare ``eseguibili'' i file che vengono usati da \LaTeX\ è molto improprio: si tratta di file necessari durante l'esecuzione del programma, ma non sono quei file ad essere eseguibili nel senso informatico del termine.} c'è anche il file \texttt{toptesi.cfg}. Copiate questo file nella vostra cartella di lavoro come spiegato qui di seguito e modificatelo secondo le vostre necessità.
@@ -416,26 +433,24 @@ nulla è cristallizzato, fisso e immutabile. Tuttavia il file
di configurazione semplifica molto la vita e se ne consiglia
l'uso.
-Potete perciò usare un diverso file di configurazione, sempre chiamato però \texttt{toptesi.cfg}, collocato nella stessa cartella dove risiede il materiale da comporre. Per esempio, poteste comporre la monografia di laurea creando da qualche parte la cartella \texttt{/monografia} e in questa cartella vi copiate \texttt{toptesi.cfg} che poi modificherete a vostro piacimento; in questa cartella sistemerete anche i file per comporre la monografia. Quando due anni dopo componete la vostra tesi di laurea magistrale, create da qualche parte la cartella \texttt{/tesi} e mettetevi dentro un copia del file \texttt{toptesi.cfg} con la vostra configurazione adattata alla tesi magistrale; in questa stessa cartella metterete i file relativi alla vostra tesi magistrale. Se dopo tre anni prenderete il dottorato e vi scriverete la vostra dissertazione dottorale, createvi da qualche parte la cartella \texttt{/dissertazione} e mettetevi dentro un'altra copia di \texttt{toptesi.cfg} che configurerete per la vostra dissertazione; sempre in questa stessa cartella metterete i file necessari per comporre la vostra dissertazione.
+Potete perciò usare un diverso file di configurazione, sempre chiamato però \texttt{toptesi.cfg}, collocato nella stessa cartella dove risiede il materiale da comporre. Per esempio, potreste comporre la monografia di laurea creando da qualche parte la cartella \texttt{/monografia} e in questa cartella vi copiate \texttt{toptesi.cfg} che poi modificherete a vostro piacimento; in questa cartella sistemerete anche i file per comporre la monografia. Quando due anni dopo componete la vostra tesi di laurea magistrale, create da qualche parte la cartella \texttt{/tesi} e mettetevi dentro un copia del file \texttt{toptesi.cfg} con la vostra configurazione adattata alla tesi magistrale; in questa stessa cartella metterete i file relativi alla vostra tesi magistrale. Se dopo tre anni prenderete il dottorato e vi scriverete la vostra dissertazione dottorale, createvi da qualche parte la cartella \texttt{/dissertazione} e mettetevi dentro un'altra copia di \texttt{toptesi.cfg} che configurerete per la vostra dissertazione; sempre in questa stessa cartella metterete i file necessari per comporre la vostra dissertazione.
\section{Il formato PDF/A}
-Le istruzioni che seguono per la produzione di un file conforme alla normativa PDF/A sono applicabili se si compone la tesi sia con il programma \prog{pdflatex} sia con \prog{xelatex}. In particolare, se si usa \prog{xelatex} e se si vogliono realizzare gli hyperlink interni si deve chiamare esplicitamente il pacchetto \pack{hyperref} configurandolo come meglio si crede, ma usando solo il comando \verb|hypersetup| per impostare le opzioni e le personalizzazioni; per sfruttare al meglio le possibilità offerte da \prog{xelatex} è necessario caricare il pacchetto \pack{fontspec} che, senza ulteriori opzioni o specificazioni, usa di default i font Latin Modern nella versione OpenType; volendo si possono usare i comandi specifici disponibili con quel pacchetto per caricare font diversi. Notate che se avete predisposto il preambolo del vostro file sorgente per la tesi in modo da poterlo compilare con \prog{pdflatex} e avete anche specificato l'opzione \texttt{pdfa}, come indicato qui di seguito, potrete ugualmente compilare il vostro documento anche con \prog{xelatex}, perché TOPtesi è perfettamente conscio del motore di composizione che state usando e sa che il vostro file sorgente parte dal presupposto che volevate creare gli hyperlink, sfruttando il fatto di aver specificato quell'opzione. In altre parole, non avete bisogno di modificare il file sorgente per passare da \prog{pdflatex} a \prog{xelatex}. Però il file prodotto con \prog{xelatex}, per soddisfare le specifiche richieste dalla norma ISO relativo al formato archiviabile, necessita di ulteriore elaborazione.
-
-
+Le istruzioni che seguono per la produzione di un file conforme alla normativa PDF/A sono applicabili se si compone la tesi sia con il programma \prog{pdflatex} sia con \prog{xelatex}. In particolare, se si usa \prog{xelatex} e se si vogliono realizzare gli hyperlink interni si deve chiamare esplicitamente il pacchetto \pack{hyperref} configurandolo come meglio si crede, ma usando solo il comando \verb|\hypersetup| per impostare le opzioni e le personalizzazioni; per sfruttare al meglio le possibilità offerte da \prog{xelatex} è necessario caricare il pacchetto \pack{fontspec} che, senza ulteriori opzioni o specificazioni, usa di default i font Latin Modern nella versione OpenType; volendo si possono usare i comandi specifici disponibili con quel pacchetto per caricare font diversi. Notate che se avete predisposto il preambolo del vostro file sorgente per la tesi in modo da poterlo compilare con \prog{pdflatex} e avete anche specificato l'opzione \texttt{pdfa}, come indicato qui di seguito, potrete ugualmente compilare il vostro documento anche con \prog{xelatex}, perché TOPtesi è perfettamente conscio del motore di composizione che state usando e sa che il vostro file sorgente parte dal presupposto che volevate creare gli hyperlink, sfruttando il fatto di aver specificato quell'opzione. In altre parole, non avete bisogno di modificare il file sorgente per passare da \prog{pdflatex} a \prog{xelatex}. Però il file prodotto con \prog{xelatex}, per soddisfare le specifiche richieste dalla norma ISO relativo al formato archiviabile, necessita di ulteriore elaborazione.
-Il Politecnico di Torino, come anche molte università italiane e straniere, sta cercando di ``smaterializzare'' le copie di archivio delle tesi di laurea. Sono al corrente che dal 2008 è allo studio un processo per consegnare la copia di archivio della tesi tramite il Portale della Didattica, in modo da eliminare le copie cartacee; non sono al corrente dell'esito di questo studio a cui ho collaborato all'inizio, ma che non posso più seguire da quando sono in pensione.
+Il Politecnico di Torino, come anche molte università italiane e straniere, intende ``smaterializzare'' le copie di archivio delle tesi di laurea. Questo intendimento è cominciato nel 2008 ma non sono al corrente dell'esito di questo studio a cui ho collaborato all'inizio prima di andare in pensione.
Il problema dell'archiviazione elettronica è che il materiale archiviato deve essere reperibile, leggibile e stampabile anche di qui a, diciamo, cinquanta anni. Per questo è necessario che esso sia archiviato in un formato standard e che nel futuro continuino ad esistere i programmi per la visualizzazione e la stampa di questo formato.
-L'Interntional Standards Organization (ISO) ha pubblicato nel 2005 uno standard per l'archiviazione dei file con la norma ISO 19005-1:2005. Secondo questa norma i file archiviabili devono avere il formato PDF della versione 1.4 e devono soddisfare ad altri requisiti, oltre a contenere un certo numero di \emph{metadata} specificati dalla norma stessa. Esistono due sottoformati: il PDF/A-1a e il PDF/A-1b. Il formato PDF/A-1a deve rispondere ai requisiti del formato PDF/A-1b oltre ad altri requisiti specifici, in particolare che i font siano tutti inclusi nel file ed abbiano codifica UNICODE e che il file deve mantenere le informazioni relative alla sua struttura logica e che queste possano essere esaminate con i motori di ricerca. Viceversa il formato PDF/A-1b, con meno pretese, richiede che i font siano tutti inclusi nel file, anche se non rispettano la codifica UNICODE, e che il file sia riproducibile a schermo e sia stampabile esattamente nello stesso modo di quando il file è stato archiviato. Per il Politecnico è sufficiente il sottoformato PDF/A-1b.
+L'Interntional Standards Organization (ISO) ha pubblicato nel 2005 uno standard per l'archiviazione dei file con la norma ISO 19005-1:2005 (nel 2011 è stato approvato un nuovo stanrd, ma per quello che interessa qui non è necessario vederne le modifiche in dettaglio). Secondo questa norma i file archiviabili devono avere il formato PDF della versione 1.4 e devono soddisfare ad altri requisiti, oltre a contenere un certo numero di \emph{metadata} specificati dalla norma stessa. Esistono due sottoformati: il PDF/A-1a e il PDF/A-1b. Il formato PDF/A-1a deve rispondere ai requisiti del formato PDF/A-1b oltre ad altri requisiti specifici, in particolare che i font siano tutti inclusi nel file ed abbiano codifica UNICODE, che il file debba mantenere le informazioni relative alla sua struttura logica, e che queste possano essere esaminate con i motori di ricerca. Viceversa il formato PDF/A-1b, con meno pretese, richiede che i font siano tutti inclusi nel file, anche se non rispettano la codifica UNICODE, e che il file sia riproducibile a schermo e sia stampabile esattamente nello stesso modo di quando il file è stato archiviato. Per il Politecnico è sufficiente il sottoformato PDF/A-1b.
\subsection{\texorpdfstring{\prog}{}{pdflatex} e il formato PDF/A}
-Usando \prog{pdflatex} è necessario usare il pacchetto specifico \pack{pdfx} richiedendo nel preambolo del file principale della tesi che sia richiamato il file \texttt{pdfx.sty} con l'opzione giusta, precisamente il preambolo, subito prima di \verb|\begin{document}|, deve contenere la richiesta:
+Usando \prog{pdflatex} è necessario usare il pacchetto specifico \pack{pdfx} richiedendo nel preambolo del file principale della tesi che sia richiamato il file \texttt{pdfx.sty} con l'opzione giusta, precisamente il preambolo, subito prima di \verb|\begin{document}|, deve contenere la richiesta:
\begin{verbatim}
\usepackage[a-1b]{pdfx}
\end{verbatim}
-Per facilitare la composizione della tesi questa richiesta è già contenuta nella classe \pack{TOPtesi}, quindi lo studente non deve preoccuparsi di niente, fuorché installare il pacchetto \pack{pdfx} nel proprio albero locale.
+Per facilitare la composizione della tesi questa richiesta è già contenuta nella classe \pack{TOPtesi}, quindi lo studente non deve preoccuparsi di niente, fuorché installare il pacchetto \pack{pdfx} nel proprio albero locale\footnote{Basta copiarlo dall'albero di sistema, ma bisogna apportare qualche piccola modifica, cosa che non è lecito fare nell'albero di sistema.}.
Se questo pacchetto non fosse già caricato con l'installazione del sistema \TeX\ in un albero di sistema, bisogna provvedere scaricando il pacchetto dagli archivi \textsc{ctan} e installandolo nel proprio albero personale. Siccome bisogna provvedere ad una certa personalizzazione, è consigliabile eseguire questa installazione nell'albero personale, perché quando si aggiorna il sistema \TeX, vengono riscritti tutti i file degli alberi di sistema, ma non quelli dell'albero personale.
@@ -458,10 +473,10 @@ Il file \texttt{pdfx.sty} carica anche il file \texttt{hyperref.sty} che permett
\end{verbatim}
e, come si vede, la personalizzazione è stata eseguita subito dopo il caricamento di \pack{hyperref} (operazione eseguita dal file di classe) e prima di invocare altri eventuali pacchetti. Naturalmente la personalizzazione indicata è solo indicativa e riportata a titolo di esempio.
-I \emph{metadata} di carattere generale sono inseriti nel file di uscita dall'azione diretta del file \texttt{pdfx.sty}; ma questo non può contenere i \emph{metadata} specifici del documento che si sta componendo; è necessario allora predisporre nella cartella dove risiede il file principale della tesi (quello sul quale opera l'eseguibile \prog{pdflatex}) un file contenente i \emph{metadata} specifici, e che abbia estensione \texttt{xmpdata}. Per esempio, il file principale di questo documento (quando veniva compilato con \prog{pdflatex}) si chiamava \texttt{toptesi-doc.tex}: nella cartella dove risiede era stato creato il file \texttt{toptesi-doc.xmpdat} con il seguente contenuto:
+I \emph{metadata} di carattere generale sono inseriti nel file di uscita dall'azione diretta del file \texttt{pdfx.sty}; ma questo non può contenere i \emph{metadata} specifici del documento che si sta componendo; è necessario allora predisporre nella cartella dove risiede il file principale della tesi (quello sul quale opera l'eseguibile \prog{pdflatex}) un file contenente i \emph{metadata} specifici, e che abbia estensione \texttt{xmpdata}. Per esempio, il file principale di questo documento (quando veniva compilato con \prog{pdflatex}) si chiamava \texttt{toptesi-doc.tex}: nella cartella dove risiede era stato creato il file \texttt{toptesi-doc.xmpdata} con il seguente contenuto:
\begin{verbatim}
\Author{Claudio Beccari}
-\Title{La classe ToPtesi}
+\Title{La classe TOPtesi}
\Keywords{LaTeX</rdf:li>%
<rdf:li>Tesi</rdf:li>%
<rdf:li>PDF/A</rdf:li>%
@@ -472,12 +487,12 @@ 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 (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 \texttt{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 \texttt{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 ambiente \texttt{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 \texttt{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.
\subsection{\texorpdfstring{\prog}{}{xelatex} e il formato PDF/A}
-Se invece usate il programma \prog{xelatex} per comporre la tesi e volete avere un file finale conforme alle specifiche PDF/A, allora dovete procedere in modo diverso\footnote{Questa procedura serve anche quando usate \prog{latex} e usate pacchetti com \pack{PSTricks} che richiedono di inserire del codice PostScript nel file di uscita.}; Precisamente usate le stesse cautele raccomandate per quando usate il programma \prog{pdflatex}, cioè specificate l'opzione \texttt{pdfa} nella dichiarazione di classe che chiama \texttt{toptesi}, usate \verb|\hypersetup| all'inizio del preambolo per personalizzare il pacchetto \pack{hyperref} già invocato da \texttt{toptesi}; incorporate figure che abbiano solo il profilo di colore RGB e che contengano al loro interno i font vettoriali di cui si servono, Ma usato solo font UNICODE; \prog{xelatex} è fatto per questo. Per la matematica usat una delle tre collezioni di font UNICODE oggi (2011) disponibili: XITS Math, Asana Math, Latin Modern Math. Fate attenzione a che qualunque file incluso \emph{non} contenga i font Computer Modern con codifica OT1 (la vecchia codifica senza lettere accentate); apparentemente la funzione di \emph{overlay} che questi font usano per sovrapporre gli accenti sulle lettere da accentare non è più compatibile con la certificazione eseguibile da Preflight di Adobe Acrobat. Tuttavia la distribuzione del sistema TeX contiene una collezione abbastanza ampi di font UNICODE, compresi i CM in formato UNICODE, che non ci sono in realtà veri problemi con il testo che componente voi; potrebbero essercene se incorporate pagine o figure PDF tratte da altri documenti composti in passato che contengono i font CM di tipo Type~1, la cui funzione di \emph{overlay} evidentemente non è conforme.
+Se invece usate il programma \prog{xelatex} per comporre la tesi e volete avere un file finale conforme alle specifiche PDF/A, allora dovete procedere in modo diverso\footnote{Questa procedura serve anche quando usate \prog{latex} e usate pacchetti com \pack{PSTricks} che richiedono di inserire del codice PostScript nel file di uscita.}; Precisamente usate le stesse cautele raccomandate per quando usate il programma \prog{pdflatex}, cioè specificate l'opzione \texttt{pdfa} nella dichiarazione di classe che chiama \texttt{toptesi}, usate \verb|\hypersetup| all'inizio del preambolo per personalizzare il pacchetto \pack{hyperref} già invocato da \texttt{toptesi}; incorporate figure che abbiano solo il profilo di colore RGB e che contengano al loro interno i font vettoriali di cui si servono, ma usato solo font UNICODE; \prog{xelatex} è fatto per questo. Per la matematica usate una delle tre collezioni di font UNICODE oggi (2012) disponibili: XITS Math, Asana Math, Latin Modern Math. Fate attenzione a che qualunque file incluso \emph{non} contenga i font Computer Modern con codifica OT1 (la vecchia codifica senza lettere accentate); apparentemente la funzione di \emph{overlay} che questi font usano per sovrapporre gli accenti sulle lettere da accentare non è più compatibile con la certificazione eseguibile da Preflight di Adobe Acrobat. Tuttavia la distribuzione del sistema TeX contiene una collezione abbastanza ampia di font UNICODE, compresi i CM in formato UNICODE, che non ci sono in realtà veri problemi con il testo che componente voi; potrebbero essercene se incorporate pagine o figure PDF tratte da altri documenti composti in passato che contengono i font CM di tipo Type~1, la cui funzione di \emph{overlay} evidentemente non è conforme.
Dopo aver eseguito \prog{xelatex} sui file sorgente della vostra tesi vi ritrovate con un file PDF che non è ancora conforme allo standard PDF/A, ma basta usare \prog{ghostscript} per trasformarlo in un file conforme. Bisogna predisporre nella stessa cartella dove si trova il main file del documento un file che contenga i \emph{metadata}; per questo documento, composto con \prog{xelatex}, il file adatto a \prog{ghostscript} è il seguente:
\begin{verbatim}
@@ -504,10 +519,10 @@ systemdict /ProcessColorModel known {
/ICCProfile (/Users/claudio/icc/ECI-RGB.V1.0.icc) def
-[ /Title (La Classe TOPtesi) % Customize.
+[ /Title (La Classe TOPtesi) % Customize.
/Author (Claudio Beccari) % Customize.
/Subject (File PDF ottenuto con XeLaTeX) % Customize.
- /DOCINFO pdfmark
+/DOCINFO pdfmark
% Define an ICC profile:
@@ -530,7 +545,7 @@ systemdict /ProcessColorModel known {
Questo file è formato dal nome del file .tex. \texttt{toptesi-doc-xetex} agglutinato alla ``desinenza'' \texttt{-def.ps}, per un nome complessivo \texttt{toptesi-doc-xetex-def.ps}. Ripeto: deve essere memorizzato nella stessa cartella dove si trova il main file del documento.
-Per eseguire la conversione conviene predisporsi una procedura .bat (per Windows) o bash {per UNIX} del tipo seguente (mostro la procedura bash che con minime modifiche si trasforama in una procedura bat) dal nome \texttt{pdf2pdfa}:
+Per eseguire la conversione conviene predisporsi una procedura .bat (per Windows) o bash {per UNIX} del tipo seguente (mostro la procedura bash che con minime modifiche si trasforma in una procedura bat) dal nome \texttt{pdf2pdfa}:
\begin{verbatim}
#!/bin/bash
file1=$1.pdf
@@ -538,7 +553,7 @@ file2=$1-a.pdf
file3=$1-def.ps
# QUANTO SEGUE DEVE ESSERE SCRITTO SU UNA SOLA RIGA
gs -dPDFA -dNOOUTERSAVE -dUseCIEColor -dCompatibilityLevel=1.4
--sDEVICE=pdfwrite -sProcessColorModel=DeviceCMYK
+-sDEVICE=pdfwrite -sProcessColorModel=DeviceRGB
-sPDFACompatibilityPolicy=1 -o $file2 ./$file3 $file1
\end{verbatim}
Ora basta dare il comando nella finestra comandi:
@@ -595,9 +610,10 @@ piacere, per esempio, con grande fantasia, \texttt{myfile.tex}:
\titolo{Titolo della tesi\\ di laurea magistrale}
\sottotitolo{Sottotitolo della tesi di laurea magistrale}
\relatore{prof.\ Enrico Rosa}
-\sedutadilaurea{Dicembre 2011}
+\sedutadilaurea{Dicembre 2012}
\candidata{Susanna Rossi}
\secondacandidata{Laura Bruni}
+%\retrofrontespizio{...}
\frontespizio
\end{document}
\end{verbatim}
@@ -611,20 +627,38 @@ Se volete usare \prog{pdflatex} aggiungete la chiamata ai pacchetti \pack{inpute
\end{verbatim}
Passando questo piccolo file a \prog{xelatex} o a \prog{pdflatex}, si ottiene
-un documento di una sola pagina, il frontespizio, che si può
-stampare in varie copie per gli scopi detti sopra. Anche se componete il frontespizio in inglese, non potete fare a meno di chiamare \texttt{babel} o \texttt{polyglossia} perché \texttt{topfront} usa alcuni comandi di quel pacchetto. Naturalmente al posto di \texttt{italian} potete specificare un'altra lingua.
+un documento di una o due pagine, il frontespizio e facoltativamente il retrofrontepspizio, che si possonostampare in varie copie per gli scopi detti sopra. Anche se componete il frontespizio in inglese, non potete fare a meno di chiamare \texttt{babel} o \texttt{polyglossia} perché \texttt{topfront} usa alcuni comandi di quel pacchetto. Naturalmente al posto di \texttt{italian} potete specificare un'altra lingua.
-Non dovete dimenticare che l'editor con cui scrivete questo piccolo file (e con il quale avete eventualmente scritto il file \texttt{toptesi.cfg}) deve essere configurato con la codifica \texttt{UTF8} se volete usare \prog{xelatex}.
+Il retrofrontespizio non è necessario assolutamente quando volete produrre il frontespizio isolato. Non è nemmeno necessario quando volete comporre la tesi. Tuttavia il comando è disponibile e permette di aggiungere la dichiarazione legale in merito alla licenza; il retrofrontespizio di questa documentazione è stato composto con i comandi seguenti:
+\begin{verbatim}
+\retrofrontespizio{Questo testo à libero secondo le condizioni
+stabilite dalla Creative Commons Licence, versione 3.0 o posteriore.
+L'enunciato integrale della Licenza in versione~3.0 è reperibile
+all'indirizzo internet
+\url{http://creativecommons.org/licenses/by-nc-nd/3.0/deed.it}.
+
+Si è liberi di riprodurre, distribuire, comunicare al pubblico, esporre
+in pubblico, rappresentare, eseguire e recitare quest'opera alle
+seguenti condizioni: attribuzione, non commerciale, non opere derivate.
+Il significato di queste caratteristiche è spiegato in dettagli nel
+sito internet indicato sopra.
+
+\bigskip
-L'altro file accessorio \texttt{topcoman.sty} contiene diversi
-utili comandi, alcuni già incorporati nella definizione della
-lingua italiana del sistema \TeX\ (solo se usate \pack{babel}) . Tuttavia se dovete scrivere in
+Composto il ...
+\vspace*{5\baselineskip}}
+\end{verbatim}
+
+
+Non dovete dimenticare che l'editor con cui scrivete questo piccolo file (e con il quale avete eventualmente scritto il file \texttt{toptesi.cfg}) deve essere configurato con la codifica \texttt{UTF-8} se volete usare \prog{xelatex}.
+
+L'altro file accessorio \texttt{topcoman.sty} contiene diversi utili comandi, alcuni già incorporati nella definizione della lingua italiana del sistema \TeX\ (solo se usate \pack{babel}). Tuttavia se dovete scrivere in
una lingua diversa dall'italiano quei comandi non sono
disponibili. Il file contiene anche un comando per la stampa in
pulito di un programma; ci sono altri pacchetti \LaTeX\ che
consentono di stampare il listato di un programma, ma visto che vi
può servire per la tesi e visto che una volta che lo conoscete vi
-potrebbe piacere e poi vorreste continuare ad usarlo, è meglio
+potrebbe piacere e poi vorreste continuare ad usarlo, è meglio
disporne come pacchetto separato. Non sarebbe difficile per
esempio stamparsi in pulito il listato del proprio programma
\texttt{myprogram.c}: si scrive semplicemente un file del tipo
@@ -636,7 +670,7 @@ esempio stamparsi in pulito il listato del proprio programma
\listing{myprogram.c}
\end{document}
\end{verbatim}
-e lo si passa a \prog{pdflatex} per ottenere poi una stampa
+e lo si passa a \prog{pdflatex} per ottenere poi una stampa
ben composta da conservare per documentazione; per evitare che le
righe sbordino fuori della larghezza normale del testo, o, peggio
ancora, fuori dalla carta, sarebbe opportuno che le righe del
@@ -688,7 +722,7 @@ master file sarà dunque composto così:
\sottotitolo{Cosa succede quando si spacca un capello in quattro}
\candidata{Maria Chiomafolta}
\relatore{prof.\ Piero Scapigliati}
- \sedutadilaurea{Maggio 2012}
+ \sedutadilaurea{Maggio 2013}
%
\include{preliminari}
\include{capitolo1}
@@ -701,12 +735,12 @@ master file sarà dunque composto così:
\end{verbatim}
È da osservare in particolare che l'aver scritto l'argomento di
-\verb+\includeonly+ nel modo esemplificato sopra, permette di
+\verb|\includeonly| nel modo esemplificato sopra, permette di
inserire dei segni di commento all'inizio di alcune delle righe in
modo da eseguire, per esempio, la compilazione selettiva di un
solo capitolo conservando tutte le informazioni incrociate
relative agli altri capitoli già compilati. Con i PC di oggi la
-compilazione è rapidissima, quindi non vi invito a seguire questa
+compilazione è rapidissima, quindi non vi invito a seguire questa
procedura per risparmiare tempo di compilazione; faccio solo
notare che il fatto di tenere separate le varie parti della tesi
permette di lavorare con più ordine e di risparmiare non poco
@@ -745,7 +779,7 @@ lunghe citazioni e tutte le altre cose che rovinerebbero la
fluidità del testo, se fossero inserite direttamente nel corpo
della tesi.
-La bibliografia conclude la tesi. A seconda del campo disciplinare in cui si svolge la tesi può essere importante scegliere un metodo di citazione piuttosto di un altro; la collezione di pacchetti del sistema \TeX\ vi consente un'ampia scelta di personalizzazioni per gli stili di composizione e di citazione. Oggi, poi, si sta diffondendo l'uso del pacchetto di estensione \pack{biblatex} che consente una gestione diretta della bibliografia mediante comandi \LaTeX; in ogni caso per queste personalizzazioni è necessario creare un database bibliografico (con estensione \texttt{.bib}) in un formato particolare, e poi è necessario elaborare questo database mediante il programma \prog{bibtex}, sempre facente parte della distribuzione del sistema \TeX. I risultati che si possono ottenere sono estremamente professionali.
+La bibliografia conclude la tesi. A seconda del campo disciplinare in cui si svolge la tesi può essere importante scegliere un metodo di citazione piuttosto di un altro; la collezione di pacchetti del sistema \TeX\ vi consente un'ampia scelta di personalizzazioni per gli stili di composizione e di citazione. Oggi (2012), poi, si sta diffondendo l'uso del pacchetto di estensione \pack{biblatex} che consente una gestione diretta della bibliografia mediante comandi \LaTeX; in ogni caso per queste personalizzazioni è necessario creare un database bibliografico (con estensione \texttt{.bib}) in un formato particolare, e poi è necessario elaborare questo database mediante il programma \prog{bibtex} o \prog{biber} (obbligatorio con \pack{biblatex} dal 2012), sempre facente parte della distribuzione del sistema \TeX. I risultati che si possono ottenere sono estremamente professionali.
\subsection{La scelta della codifica per il file sorgente}
@@ -756,7 +790,7 @@ quelle che si possono ottenere con combinazioni di tasti sia sotto
Windows sia sotto Linux o Mac~OS~X; per default \textsf{TOPtesi}
non specifica nessuna particolare codifica dell'input; ma perché
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
+7~bit; oppure ancora si usano i caratteri nazionali direttamente da
tastiera ma si specifica la codifica che l'editor usato ha
impiegato per salvare nei file i codici dei caratteri non ASCII,
per esempio le lettere accentate; a meno che non usiate \prog{xelatex} vi suggerisco di specificare esplicitamente la codifica mediante il comando
@@ -765,11 +799,12 @@ per esempio le lettere accentate; a meno che non usiate \prog{xelatex} vi sugger
\end{verbatim}
che va bene sia per le macchine Windows, sia per quelle basate su UNIX.
-Glieditor \TeX{}Shop, \TeX{}works, TeXmaker, TeXStudio, e qualcun altro, consentono di usare la codifica \texttt{utf8} che permette di inserire qualunque segno fa le decine di migliaia che la codifica UNICODE consente -- se usate \prog{xelatex} questa codifica è necessaria ma non è necessario 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 \texttt{latin1}. 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 \texttt{utf8} che permette di inserire qualunque segno fa le decine di migliaia che la codifica UNICODE consente -- se usate \prog{xelatex} questa codifica è necessaria ma non è necessario 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 \texttt{latin1}. 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 \verb|\E| per scrivere È. Credo che questa sia la maiuscola accentata più frequente in italiano e le altre non capitano mai all'inizio di un periodo. Il comando:
\begin{verbatim}
-\newcommand*\E{\`E\space}
+\usepackage{xspace}
+\newcommand*\E{\`E\xspace}
\end{verbatim}
inserisce direttamente una È all'inizio di un periodo e inserisce direttamente lo spazio successivo, per cui, senza inserire esplicitamente nessun comando di spaziatura dopo il comando \verb|\E|, si può scrivere semplicemente:
\begin{verbatim}
@@ -779,9 +814,11 @@ per ottenere:
\begin{quote}
È conveniente rilevare che\dots
\end{quote}
-Se il vostro editor vi consente di selezionale le maiuscole accentate da una tabella oppure vi consente di usare combinazioni di tasti per inserire direttamente le maiuscole accentate nel file sorgente, fatene uso, perché la lettura del file sorgente ne guadagna moltissimo.
+L'uso del pacchetto \pack{space} fa sì che esso, tramite il comando \verb|\xspace| inseriva uno spazio, a meno che il comando \verb|\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 \verb|\xspace|.
-Se volete o dovete usare \prog{pdflatex} dovete caricare nel vostro preambolo tutto quello che è necessario per gestire quelle lingue, ma non chiedetemi come si fa, perché so dirvelo solo per il greco. Per questa lingua, se usate l'ortografica monotonica, basta inserire l'opzione della lingua \texttt{greek} fra le opzioni \emph{della classe}; se usate l'ortografia politonica, allora dovete richiedere per \texttt{babel} lo specifico attributo seguendo questo procedimento (per \pack{polyglossia} si veda più avanti):
+Se il vostro editor vi consente di selezionare le maiuscole accentate da una tabella oppure vi consente di usare combinazioni di tasti per inserire direttamente le maiuscole accentate nel file sorgente, fatene uso, perché la lettura del file sorgente ne guadagna moltissimo.
+
+Se volete o dovete usare \prog{pdflatex} dovete caricare nel vostro preambolo tutto quello che è necessario per gestire quelle lingue, ma non chiedetemi come si fa, perché so dirvelo solo per il greco. Per questa lingua, se usate l'ortografica monotonica, basta inserire l'opzione della lingua \texttt{greek} fra le opzioni \emph{della classe}; se usate l'ortografia politonica, allora dovete richiedere per \texttt{babel} lo specifico attributo seguendo questo procedimento (per \pack{polyglossia} si veda più avanti):
\begin{verbatim}
\documentclass[...,greek,...]{toptesi}
...
@@ -790,7 +827,8 @@ Se volete o dovete usare \prog{pdflatex} dovete caricare nel vostro preambolo t
...
\end{document}
\end{verbatim}
-Per una tesi che tratti il greco antico in forma filologica, consiglio l'uso del pacchetto \textsf{teubner}; visto che l'ho scritto io, un po' di réclame non guasta~\dots\ Bisogna però leggerne la documentazione con attenzione. In particolare conviene ricordare che \pack{teubner} non viene installato se non è stato precedentemente specificata la lingua greca fra le opzioni, ma poi provvede da solo ad impostare l'attributo \texttt{polutoniko} e tutte le altre caratteristiche necessarie per comporre in greco con il \emph{mark-up} filologico. A tutt'oggi il pacchetto \pack{teubner} non è stato controllato sotto \XeLaTeX. Probabilmente non è completamente compatibile, ma non sono ancora in grado di dire niente né in positivo né in negativo.
+
+Per una tesi che tratti il greco antico in forma filologica, consiglio l'uso del pacchetto \textsf{teubner}; visto che l'ho scritto io, un po' di réclame non guasta~\dots\ Bisogna però leggerne la documentazione con attenzione. In particolare conviene ricordare che \pack{teubner} non viene installato se non è stato precedentemente specificata la lingua greca fra le opzioni, ma poi provvede da solo ad impostare l'attributo \texttt{polutoniko} e tutte le altre caratteristiche necessarie per comporre in greco con il \emph{mark-up} filologico. A tutt'oggi (2012) il pacchetto \pack{teubner} non è stato adeguatamente controllato sotto \XeLaTeX. Probabilmente non è completamente compatibile, ma non sono ancora in grado di dire niente né in positivo né in negativo.
%%% MODIFICARE LA FRASE PRECEDENTE QUANDO TEUBNER SARÀ A POSTO!!!!
@@ -806,9 +844,9 @@ Solo per scrivere in inglese non è necessario specificare nessuna codifica per
Inoltre con questa codifica la presenza di accenti impedisce la divisione in sillabe o ne riduce molto l'efficacia; per l'italiano il problema è relativamente modesto perché normalmente gli accenti compaiono solo sull'ultima vocale delle parole \emph{tronche}. Quindi con questa codifica la parola ``qualità'' viene divisa in ``qua-lità'' invece che in ``qua-li-tà''. Invece in francese una parola come ``électricité'' non viene divisa per niente a causa dell'accento sulla prima vocale.
-Allora per tutte le lingue diverse dall'inglese, ma anche per l'inglese, è quanto mai opportuno specificare per i font di uscita la codifica \texttt{T1}. C'è però un problemino, facilmente risolubile, ma bisogna pensarci: fino ad oggi (2011) i font di default usati da \LaTeX\ e pdf\LaTeX\ sono i font della collezione Computer Modern con codifica \texttt{OT1}; e ogni installazione del sistema \TeX\ li può usare sia nella versione ``bitmapped'' sia in quella PostScript Type~1. Quest'ultima dovrebbe essere quella da usare sempre con il formato PDF del file di uscita, perché questo formato è portabile da una macchina ad un'altra, indipendentemente dal sistema operativo usato. Se poi il file deve essere archiviato esso deve essere in formato PDF, quindi, di fatto non ci sono scelte.
+Allora per tutte le lingue diverse dall'inglese, ma anche per l'inglese, è quanto mai opportuno specificare per i font di uscita la codifica \texttt{T1}. C'è però un problemino, facilmente risolubile, ma bisogna pensarci: fino ad oggi (2012) i font di default usati da \LaTeX\ e pdf\LaTeX\ sono i font della collezione Computer Modern con codifica \texttt{OT1}; e ogni installazione del sistema \TeX\ li può usare sia nella versione ``bitmapped'' sia in quella PostScript Type~1. Quest'ultima dovrebbe essere quella da usare sempre con il formato PDF del file di uscita, perché questo formato è portabile da una macchina ad un'altra, indipendentemente dal sistema operativo usato. Se poi il file deve essere archiviato esso deve essere in formato PDF, quindi, di fatto non ci sono scelte.
-I file della collezione Computer Modern con codifica \texttt{T1}, conosciuti anche come font EC, sono invece distribuiti solo nella forma bitmapped, la quale, oltre ad essere vietata nei file PDF archiviabili, si legge molto male sullo schermo, se il programma di visualizzazione non è molto ben adattato ai font bitmapped. Esiste il pacchetto \textsf{cm-super} per ovviare a questo inconveniente, ma scaricare dalla rete questo pacchetto enorme richiede molto tempo e poi occupa molto spazio sul disco del vostro~PC (per altro questa collezione è installata di default in ogni installazione completa del sistema \TeX). Per aggirare questi inconvenienti bisogna usare i font della collezione Latin Modern, normalmente preinstallati, per cui nel preambolo del file da gestire con \prog{pdflatex} si specificherà:
+I file della collezione Computer Modern con codifica \texttt{T1}, conosciuti anche come font EC, sono invece distribuiti solo nella forma bitmapped, la quale, oltre ad essere vietata nei file PDF archiviabili, si legge molto male sullo schermo, se il programma di visualizzazione non è molto ben adattato ai font bitmapped. Esiste il pacchetto \textsf{cm-super} per ovviare a questo inconveniente, ma scaricare dalla rete questo pacchetto enorme richiede molto tempo e poi occupa molto spazio sul disco del vostro~PC (però questa collezione è installata di default in ogni installazione completa del sistema \TeX). Per aggirare questi inconvenienti bisogna usare i font della collezione Latin Modern, normalmente preinstallati, per cui nel preambolo del file da gestire con \prog{pdflatex} si specificherà:
\begin{verbatim}
\documentclass[...]{toptesi}
...
@@ -819,13 +857,13 @@ I file della collezione Computer Modern con codifica \texttt{T1}, conosciuti anc
...
\end{verbatim}
-Se il file viene gestito con \prog{xelatex}, oltre alla codifica \texttt{utf-8} di default che non va esplicitata, basta richiedere l'uso del pacchetto \pack{fontspec} senza ulteriori opzioni e viene automaticamente caricata ed usata la collezione dei font Latin Modern nella loro versione OpenType; a questo provvede direttamente la classe TOPtesi. Usando \prog{xelatex} gli appositi comandi per la selezione dei font sia testuali sia per la matematica può essere eseguita nel preambolo senza bisogno di ricaricare il pacchetto \pack{fontenc}. Volendo, invece di usare i font latin Modern, si possono impostare facilmente altre famiglie di font con comodi comandi che fanno riferimento ai font OpenType installati sulla propria macchina.
+Se il file viene gestito con \prog{xelatex}, oltre alla codifica \texttt{utf-8} di default \emph{che non va esplicitata}, basta richiedere l'uso del pacchetto \pack{fontspec} senza ulteriori opzioni e viene automaticamente caricata ed usata la collezione dei font Latin Modern nella loro versione OpenType; a questo provvede direttamente la classe TOPtesi. Usando \prog{xelatex}, gli appositi comandi per la selezione dei font sia testuali sia per la matematica può essere eseguita nel preambolo senza bisogno di ricaricare il pacchetto \pack{fontenc}. Volendo, invece di usare i font Latin Modern, si possono impostare facilmente altre famiglie di font con comodi comandi che fanno riferimento ai font OpenType installati sulla propria macchina.
Naturalmente per gli utenti esperti di \LaTeX\ ci sono anche altri pacchetti usabili per impiegare altri font diversi da quelli della collezione Latin Modern, che comunque, secondo me, sono i migliori per la loro completezza; grazie al diverso disegno dei corpi minori la lettura dei pedici e degli apici ne risulta agevolata.
Qui, per la composizione della tesi con \prog{pdflatex} segnalo solo la collezione dei font Times eXtended, richiamabili con il pacchetto \textsf{txfonts}, e la collezione dei font Palatino eXtended, richiamabili con il pacchetto \textsf{pxfonts}. I Times sono font più stretti di quelli della collezione Latin Modern e sono forse indicati per rendere più compatta una tesi un po' voluminosa. I Palatino sono un po' più larghi dei font della collezione Latin Modern e allungano la tesi di qualche pagina.
-Tanto per confronto, questo testo di documentazione su \textsf{TOPtesi} è composto con il motore di composizione \prog{xelatex} usando i font OpenType TeX Gyre Termes con codifica UNICODE presenti nella distribuzione del sistema \TeX; come si vede la divisione delle parole tronche in fin di riga non presenta inconvenienti particolari; forse con un testo di altro genere, con composizione in colonne strette o all'interno di tabelle, si potrebbe verificare la presenza di righe molto lasche, dove è stato allargato troppo lo spazio interparola. Per questo si consiglia sempre di usare la codifica \texttt{T1} anche per l'italiano se si usa il motore di composizione \prog{pdflatex}; non si sa mai, ma certamente con questa codifica si hanno meno inconvenienti e le lettere accentate sono disegnate meglio. Se si usa come motore \prog{pdflatex}, è conveniente usare il pacchetto di estensione \pack{microtype} che consente di rendere ancora migliori le righe del testo composto; purtroppo questo pacchetto non è ancora completamente usabile con \prog{xelatex}, almeno fino a quando questo programma produrrà il suo file PDF di uscita convertendo un formato intermedio che si chiama XDV (DVI esteso).
+Tanto per confronto, questo testo di documentazione su \textsf{TOPtesi} è composto con il motore di composizione \prog{xelatex} usando i font OpenType TeX Gyre Termes con codifica UNICODE presenti nella distribuzione del sistema \TeX; come si vede la divisione delle parole in fin di riga non presenta inconvenienti particolari; forse con un testo di altro genere, con composizione in colonne strette o all'interno di tabelle, si potrebbe verificare la presenza di righe molto lasche, dove è stato allargato troppo lo spazio interparola. Per questo si consiglia sempre di usare la codifica \texttt{T1} anche per l'italiano se si usa il motore di composizione \prog{pdflatex}; non si sa mai, ma certamente con questa codifica si hanno meno inconvenienti e le lettere accentate sono disegnate meglio. Se si usa come motore \prog{pdflatex}, è conveniente usare il pacchetto di estensione \pack{microtype} che consente di rendere ancora migliori le righe del testo composto; purtroppo le funzionalità di questo pacchetto sono solo parzialmente usabili con \prog{xelatex}, almeno fino a quando questo programma produrrà il suo file PDF di uscita convertendo un formato intermedio in formato XDV (DVI esteso).
\section{Come stampare la tesi}
@@ -834,9 +872,9 @@ Il pacchetto \textsf{TOPtesi} contiene anche l'opzione di composizione
\emph{in bianca e volta}, ma di default compone su una facciata sola
della pagina.
-Qual è la differenza? È quella che si osserva nei libri composti
+Qual è la differenza? È quella che si osserva nei libri composti
meglio, cioè nei libri con i fogli stampati davanti e di dietro:
-quando il libro è aperto la striscia bianca formata dai due
+quando il libro è aperto la striscia bianca formata dai due
margini interni delle pagine affacciate è circa uguale a ciascuno
dei margini esterni. Invece quando si stampa su una facciata sola
il corpo del testo è centrato e i margini laterali sono
@@ -917,29 +955,28 @@ configurato.
Per esempio, componendo con \prog{xelatex} questo file di documentazione, il file
\texttt{toptesi\discretionary{}{-}{-}doc\discretionary{}{-}{-}xetex.log} contiene nelle prime righe quanto segue:
\begin{verbatim}
-This is XeTeX, Version 3.1415926-2.3-0.9997.5 (TeX Live 2011)
-(format=xelatex 2011.7.3) 27 JUL 2011 20:03
+This is XeTeX, Version 3.1415926-2.4-0.9998 (TeX Live 2012)
+ (format=xelatex 2012.7.10) 9 SEP 2012 16:04
entering extended mode
- restricted \write18 enabled.
+ \write18 enabled.
file:line:error style messages enabled.
%&-line parsing enabled.
**toptesi-doc-xetex.tex
(./toptesi-doc-xetex.tex
-LaTeX2e <2009/09/24>
-Babel <v3.8l> and hyphenation patterns for english, dumylang,
-nohyphenation, german-x-2009-06-19, ngerman-x-2009-06-19,
-afrikaans, ancientgreek, ibycus, arabic, armenian, basque,
-bulgarian, catalan, pinyin, coptic, croatian, czech, danish,
-dutch, ukenglish, usenglishmax, esperanto, estonian, ethiopic,
-farsi, finnish, french, galician, german, ngerman,
-swissgerman, monogreek, greek, hungarian, icelandic,
-assamese, bengali, gujarati, hindi, kannada, malayalam,
-marathi, oriya, panjabi, tamil, telugu, indonesian,
-interlingua, irish, italian, kurmanji, lao, latin, latvian,
-lithuanian, mongolian, mongolianlmc, bokmal, nynorsk, polish,
-portuguese, romanian, russian, sanskrit, serbian, serbianc,
-slovak, slovenian, spanish, swedish, turkish, turkmen,
-ukrainian, uppersorbian, welsh, loaded.
+LaTeX2e <2011/06/27>
+Babel <v3.8m> and hyphenation patterns for english, dumylang,
+nohyphenation, german-x-2012-05-30, ngerman-x-2012-05-30, afrikaans,
+ancientgreek, ibycus, arabic, armenian, basque, bulgarian, catalan,
+pinyin, coptic, croatian, czech, danish, dutch, ukenglish,
+usenglishmax, esperanto, estonian, ethiopic, farsi, finnish, french,
+friulan, galician, german, ngerman, swissgerman, monogreek, greek,
+hungarian, icelandic, assamese, bengali, gujarati, hindi, kannada,
+malayalam, marathi, oriya, panjabi, tamil, telugu, indonesian,
+interlingua, irish, italian, kurmanji, latin, latvian, lithuanian,
+mongolian, mongolianlmc, bokmal, nynorsk, polish, portuguese,
+romanian, romansh, russian, sanskrit, serbian, serbianc, slovak,
+slovenian, spanish, swedish, turkish, turkmen, ukrainian,
+uppersorbian, welsh, loaded.
\end{verbatim}
Questo listato è quanto appare sempre quando si usa la distribuzione \TeX Live completa o quando si usa la distribuzione MiK\TeX~2.9 (o successiva) completa; serve
@@ -977,28 +1014,14 @@ potete chiudere il wizard e controllare, dopo aver ricomposto, per
esempio, \texttt{sample.tex} che le prime righe del file
\texttt{.log} contengano tutte le lingue che volete usare.
-\subsubsection{teTeX e Debian teTeX }
-La distribuzione \texttt{teTeX} non viene più aggiornata da quando esiste \TeX\-Live; mi risulta che venga ancora distribuita da alcuni sistemi Linux basati su Debian.
-
-Queste distribuzioni di \textsf{teTeX} per Linux basate su Debian per
-la mia esperienza non richiedono nessuna configurazione, perché
-sono già inizializzate per trattare \emph{tutte} le lingue di cui
-il sistema \TeX\ è capace. Però si tratta sempre di una versione datata; la distribuzione \textsf{teTeX}, poi, lo è certamente perché il suo aggiornamento è cessato nel 2005.
-
-Tuttavia, sempre per mia esperienza, ho installato \TeX\-live completa ottenuta scaricando il file ISO della distribuzione di \TeX~Live sulla mia versione (Debian) di Ubuntu e non ho avuto nessunissimo problema; la distribuzione \TeX\-live completa è sempre veramente aggiornata in tempo praticamente reale e il suo ``package manager'' consente l'aggiornamento continuo, indipendentemente dalle ``uscite'' annuali di \TeX\-live; mi permetterei di consigliare di non usare \texttt{teTeX} nemmeno nella versione Debian, ma non vorrei passare per un iconoclasta di quella gloriosa distribuzione. Invece la versione Debian di \TeX~Live installabile su Ubuntu con i suoi programmi di installazione è vecchia e molto parziale e richiede di specificare l'installazione di ciascun pacchetto specifico per ciascuna lingua che si desidera usare; l'unica preinstallata è quella relativa all'inglese; tutte le altre vanno installate esplicitamente. È possibile far convivere sulla stessa macchina due diverse distribuzioni di \TeX~Live, perché le dipendenze Debian impongono la presenza della versione Debian.
\subsubsection{\TeX Live}
La distribuzione \TeX~Live completa distribuita sul circuito \textsc{ctan} nasce già configurata per tutte le lingue che \LaTeX\ è capace di gestire, quindi anche l'italiano; bisogna ricorrere ai suoi comandi di configurazione solo se si vuole aggiungere una lingua la cui sillabazione non sia distribuita insieme a \TeX\ Live. Questo evento è talmente raro che non vale la pena di insistervi sopra. Tuttavia un laureando che svolga la sua tesi sull'ostrogoto altomedievale e disponesse solo della sillabazione per l'ostrogoto classico e per l'ostrogoto contemporaneo, si troverebbe in difficoltà; infatti, prima ancora di inserire le regole per l'ostrogoto altomedievale, dovrebbe scriversi le regole di sillabazione e codificarle nel linguaggio specifico richiesto dal sistema \TeX; questo è tutt'altro che facile ed è riservato a specialisti molto avanzati.
-\subsubsection{Pro\TeX}
-La distribuzione \textsf{pro\TeX} è per le macchine Windows ma di fatto installa MiK\TeX\ e i programmi accessori con una procedura guidata che dovrebbe semplificare le cose. Essa è distribuita con lo stesso DVD con il quale viene distribuito anche \TeX-live e dovrebbe avere il vantaggio di avere la stessa disponibilità di estensioni che ha \TeX-live. Il DVD è prodotto annualmente dall'associazione degli utenti di \TeX, TUG (\texttt{www.tug.org}); non disponendo di un collegamento internet veloce, si potrebbe risparmiare sulla bolletta del telefono chiedendo alla associazione di inviare per posta il DVD. La configurazione delle lingue gestibili si esegue come indicato per MiK\TeX.
-
\subsubsection{Mac\TeX}
-Dal 2007 la distribuzione di \prog{Mac\TeX} sostanzialmente coincide con\TeX-live, salvo che contiene anche programmi accessori specifici per le macchine Macintosh; è preconfigurato per gestire tutte le lingue di cui il sistema è capace, compreso l'italiano. Ma per l'ostrogoto altomedievale\dots
-
-
+Dal 2007 la distribuzione di \prog{Mac\TeX} sostanzialmente coincide con \TeX-live, salvo che contiene anche programmi accessori specifici per le macchine Macintosh; è preconfigurato per gestire tutte le lingue di cui il sistema è capace, compreso l'italiano. Ma per l'ostrogoto altomedievale\dots
\subsubsection{Distribuzioni commerciali}
@@ -1131,7 +1154,7 @@ che produce il file del documento composto in formato
\texttt{.pdf} si chiama \prog{pdftex}, ma questa versione comprende tutte le estensioni di $\epsilon$\TeX. Bene, queste estensioni servono anche per gestire le lingue
con scrittura retrograda pur di disporre dei pacchetti relativi a queste lingue.
-Anche \prog{xelatex} è in grado di gestire le lingue retrograde ed è capace con modesti adattamenti di comporre in verticale (cinese, giapponese,\dots).
+Anche \prog{xelatex} è in grado di gestire le lingue retrograde ed è capace con modesti adattamenti per comporre in verticale (cinese, giapponese,\dots).
\chapter{I comandi specifici introdotti da \textsf{TOPtesi}}
@@ -1187,7 +1210,7 @@ correttamente. In particolare il titolo della tesi e i titoli dei
capitoli possono andare a capo solo prima di articoli,
preposizioni semplici o articolate, congiunzioni e brevi avverbi
come ``non''; per evitare di andare a capo dopo queste parti del
-titolo si abbia l'accortezza di inserire il segno di legame
+titolo si abbia l'accortezza di inserire il segno di legatura
\verb|~| fra queste brevi parole e le parole seguenti; per
esempio, il titolo della tesi fornita come modello va scritto
nella forma \verb|La~pressione barometrica di~Giove|.
@@ -1449,6 +1472,7 @@ tesi di laurea e della dissertazione di dottorato}\label{tab:front3}
\cs{\TutorName\{...\}} & \serve ``Tutore''\\
\cs{\NomeTutoreAziendale\{...\}}& \serve ``Supervisore aziendale''; usando un argomento che contenga anche
indicazioni di ``a capo'', nella seconda riga si può scrivere il nome dell'azienda.\\
+\cs{\retrofrontespizio} & Se specificato serve solitamente per scrivere nel verso della pagina del frontespizio alcune dichiarazioni di carattere legale; accetta un argomento composto anche da diversi capoversi.\\
\cs{\CycleName\{...\}} & \serve ``ciclo''; serve essenzialmente per indicare il ciclo di dottorato\\
\cs{\NomePrimoTomo\{...\}} & \serve ``Tomo primo''\\
\cs{\NomeSecondoTomo\{...\}} & \serve ``Tomo secondo''\\
@@ -1460,7 +1484,7 @@ tesi di laurea e della dissertazione di dottorato}\label{tab:front3}
\caption{Comandi per modificare le parole e/o le brevi frasi scritte
nel frontespizio o per cambiare le parole italiane di default in altre
parole diverse, o per esprimere gli stessi concetti in un'altra
-lingua}\label{tab:front4}
+lingua; comando per comporre il verso del frontespizio.}\label{tab:front4}
\end{table}
I comandi di questa sezione possono essere introdotti in un ordine qualunque, ma è più chiaro se sono introdotti nell'ordine in cui sono elencati.
@@ -1492,7 +1516,7 @@ se devono rappresentare delle modifiche ``permanenti''; usateli
anche per predisporre quelle stringhe in una lingua diversa
dall'italiano.
-Per comporre questo manuale si è usata la classe \texttt{toptesi},
+Per comporre questo testo si è usata la classe \texttt{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
@@ -1537,7 +1561,7 @@ le tesi di dottorato né per le monografie.
\item Per la monografia l'informazione della data può essere omessa
se non c'è una data per la presentazione.
%
-\item Il pacchetto \textsf{TOPtesi} inizialmente veniva distribuito con un certo numero di loghi di università italiane e straniere; La politica di \TeX~Live ẁ quella di distribuire solo materiale con licenza libera e incondizionata; i loghi delle varie università certamente non lo sono, quindi i loghi non vengono più distribuiti con \pack{TOPtesi}. Ogni laureando è quindi tenuto a chiedere il logo alla sua università accettandone tutte le limitazioni d'uso che l'università potrebbe imporgli.
+\item Il pacchetto \textsf{TOPtesi} inizialmente veniva distribuito con un certo numero di loghi di università italiane e straniere. La politica di \TeX~Live è quella di distribuire solo materiale con licenza libera e incondizionata; i loghi delle varie università certamente non lo sono, quindi i loghi non vengono più distribuiti con \pack{TOPtesi}. Ogni laureando è quindi tenuto a chiedere il logo alla sua università accettandone tutte le limitazioni d'uso che l'università potrebbe imporgli.
\end{itemize}
Per quanto riguarda i loghi, la loro inserzione implica l'uso del
@@ -1546,19 +1570,7 @@ default; specificare nuovamente quel pacchetto non produce nessun
danno, perché \LaTeX\ controlla da solo se lo deve caricare o non
lo deve ricaricare.
-Tuttavia va segnalato un punto che dovrebbe essere evidente dal
-fatto che sono presenti le figure dei loghi sia nel formato
-\texttt{.eps} gestibile da \LaTeX\ e \texttt{dvips}, sia nel
-formato \texttt{.pdf} gestibile da {pdf\LaTeX}. I due insiemi di
-formati sono disgiunti, nel senso che non esiste un formato su cui
-possano operare indifferentemente sia \LaTeX\ sia pdf\LaTeX,
-tranne il formato dei file prodotti dal programma MetaPost, che è
-assai raro e poco usato, certamente non è usato per i loghi.
-
-\XeLaTeX, invece, gestisce tranquillamente sia i file \texttt{.eps}, sia quelli \texttt{.pdf}, \texttt{.png}, \texttt{.jpg}.
-
-\textcolor{red}{Questa osservazione vale anche per tutte le altre figure da
-importare nel documento da file esterni. La cosa è scritta a
+\textcolor{red}{Per i formati dei file grafici da includere, sia pdf\LaTeX\ sia \XeLaTeX\ accettano i formati PDF, PNG, JPG, MPS, EPS. La cosa è scritta a
chiare lettere nella guida \texttt{grfguide} che accompagna ogni
distribuzione del sistema \TeX, ma è un fatto che viene
dimenticato troppo spesso e che obbliga a cercare aiuto da chi ne
@@ -1569,11 +1581,10 @@ dimenticano.}
disponendo di quei programmi e conoscendo i vantaggi e gli
svantaggi di un formato rispetto ad un altro, questa operazione
viene dimenticata troppo spesso, perché troppo spesso ci si
-dimentica di questa incompatibilità.}
+dimentica di queste limitazioni sui formati.}
Per questo io preferisco usare sempre e solamente i compilatori
-pdf\/\LaTeX\ o \XeLaTeX, se non altro perché accettano un maggior numero di
-formati grafici. L'unico inconveniente è che non posso usare il
+pdf\/\LaTeX\ o \XeLaTeX. L'unico inconveniente è che non posso usare il
pacchetto \texttt{PSTricks}; ma finora me la sono cavata molto
bene anche senza le prestazioni di questo bellissimo pacchetto.
@@ -1601,7 +1612,8 @@ Comando\V & Default & Scopo \\[.5ex]
\hline
\cs{\figurespagetrue}&\cs{\figurespagefalse}& Fa o non fa stampare l'indice delle figure\\
\cs{\tablespagetrue}&\cs{\tablespagefalse}&Fa o non fa stampare l'indice delle tabelle\\
-\cs{\frontespizio} & nessuno & Fa stampare il frontespizio \\
+\cs{\frontespizio} & nessuno & Fa stampare il frontespizio ed eventualmente il
+ retrofrontespizio \\
\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
@@ -1679,8 +1691,7 @@ gran voce e serve per mettere
\hline
\end{tabular}}
\caption{Comandi ulteriori per il frontespizio e per il corpo
-della tesi definiti con l'opzione
-\texttt{classica}}\label{tab:front5}
+della tesi definiti con l'opzione \texttt{classica}}\label{tab:front5}
\end{table}
@@ -1694,7 +1705,6 @@ laurea}, oppure \emph{tesi di laurea specialistica}, oppure
\emph{tesi di laurea magistrale}, oppure \emph{dissertazione di
dottorato}.
-
Non fa tutto, ci mancherebbe altro, visto che nessuna persona è in
grado di prevedere tutte le necessità delle altre persone.
@@ -1705,7 +1715,7 @@ immedesimare nelle necessità altrui e magari deve darsi da fare
per creare qualcosa di nuovo che possa essere utile agli altri e
forse anche a se stesso.
-Una cosa certamente che rimane da fare è un procedimento più
+Una cosa certamente che rimane da fare è un procedimento più
semplice per la composizione del frontespizio in una lingua
diversa dall'italiano. Attualmente il procedimento si rifà all'uso
delle macro che servono per definire le stringhe in lingua; il
@@ -1759,7 +1769,7 @@ mette a disposizione una miriade di comandi per comporre quei
segni ``strani'' che i filologi usano per scrivere le loro opere.
Per le edizioni critiche esiste il pacchetto \texttt{ledmac}; io non
-l'ho mai usato, ma sembra che sia di grande aiuto per i letterati.
+l'ho mai usato, ma sembra che sia di grande aiuto per gli umanisti.
Per gli scienziati e i tecnologi esistono troppi pacchetti
specializzati e sarebbe impossibile, e forse inutile, elencarli
diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.pdf
index 72511da14e4..3d9a9508443 100755
--- a/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.pdf
+++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.tex b/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.tex
index 0e1bccde90a..1cd777fa4a7 100755
--- a/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.tex
+++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.tex
@@ -75,6 +75,11 @@
%
%\chapterbib %solo per vedere che cosa succede; e' preferibile comporre una sola bibliografia
%\AdvisorName{Supervisors}
+\retrofrontespizio{Questo testo è sottoposto alla Creative Common Licence
+
+\vspace{2\baselineskip}
+
+Stampato il \today}
\newtheorem{osservazione}{Osservazione}% Standard LaTeX
diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf
index a14af5d1b26..782b4f97cc3 100644
--- a/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf
+++ b/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf
Binary files differ