diff options
Diffstat (limited to 'Master')
17 files changed, 501 insertions, 2329 deletions
diff --git a/Master/texmf-dist/doc/latex/toptesi/FrontespizioLandscape.pdf b/Master/texmf-dist/doc/latex/toptesi/FrontespizioLandscape.pdf Binary files differdeleted file mode 100644 index aa4e48455e5..00000000000 --- a/Master/texmf-dist/doc/latex/toptesi/FrontespizioLandscape.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/toptesi/README b/Master/texmf-dist/doc/latex/toptesi/README index f78417af4c5..7f999448225 100644 --- a/Master/texmf-dist/doc/latex/toptesi/README +++ b/Master/texmf-dist/doc/latex/toptesi/README @@ -1,11 +1,10 @@ -TOPtesi bundle version 5.80 of 2014/10/05 +TOPtesi bundle version 5.81 of 2014/10/55 Copyright 2014 Claudio Beccari LaTeX Project Public Licence LPPL v.1.3 (or later) The TOPtesi bundle contains everything is needed for typesetting a bachelor, master or PhD thesis in Italian (or in any other language -supported by LaTeX: the bundle is constructed to support multi-language -use). +supported by LaTeX: the bundle supports multi-language use). The infix strings may be selected and specified at will by means of a configuration file, so as to customise the information of the @@ -17,15 +16,13 @@ multi-language theses that are more and more frequent thanks to the double degree programs of the European Union Erasmus programs or the Life Long Learning European programs. -This important upgrade is intended to be compliant also with XeLaTeX -and LuaLaTeX; the documentation explains how to obtain PDF/A-1b +This version of TOPtesi is intended to be compliant also with XeLaTeX +and LuaLaTeX; the documentation explains also how to obtain PDF/A-1b archivable files from pdfLaTeX, XeLaTeX, and LuaLaTeX. -Since version number 5.70 this is a stable bundle, although some -corrections are introduced from time to time. -To say the whole truth, version 5.80 has been enhanced with few more -class options that allow toptesi to be used with external packages -for typesetting the title page with different styles. +Version 5.81 has been enhanced with few more class options that allow +TOPtesi to be used with external packages for typesetting the title +page with different styles. For installation, if the package is not already installed in your TeX system distribution, either read the Italian documentation in @@ -55,7 +52,7 @@ that is present in your texmf tree. In any case remember to refresh the filename database! If the package is already installed (it is with a complete TeXLive or -complete MiKTeX TeX system distributions), the texmf folder should be the +complete MiKTeX distributions), the texmf folder should be the <prefix>/texmf-dist system one. But in this case you don't need to decompress anything and move files around. Possibly check if the CTAN repository contains a newer version and, in case, use your package diff --git a/Master/texmf-dist/doc/latex/toptesi/manifest.txt b/Master/texmf-dist/doc/latex/toptesi/manifest.txt index a0fdaadc305..75842cf5462 100644 --- a/Master/texmf-dist/doc/latex/toptesi/manifest.txt +++ b/Master/texmf-dist/doc/latex/toptesi/manifest.txt @@ -18,7 +18,6 @@ This work consists of the files listed in manifest.txt This work consists of the following files manifest.txt toptesi.dtx - toptesi-doc-xetex.tex toptesi-example.tex toptesi-example-xetex.tex toptesi-example-frontespizio.tex @@ -35,16 +34,14 @@ The files derived from the work are the following: topfront.sty toptesi.cfg toptesi.pdf - toptesi-doc-xetex.pdf - toptesi-doc-xetex-a.pdf toptesi-example.pdf toptesi-example-xetex.pdf toptesi-example-frontespizio.pdf topfront-example.pdf The toptesi.dtx file is self extracting and self documenting; if you run -pdflatex on it you get at the same time the class, the style and the -configuration files, together with the English documented file. +pdflatex on it you get at the same time the class, the style files besides +the toptesi configuration file, together with the English documented file. The Italian documentation is obtained by running XeLaTeX on toptesi-it-xetex.tex diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex-def.ps b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex-def.ps deleted file mode 100644 index 7a894f7a191..00000000000 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex-def.ps +++ /dev/null @@ -1,45 +0,0 @@ -%! -% $Id: PDFA_def.ps 8284 2007-10-10 17:40:38Z giles $ -% This is a sample prefix file for creating a PDF/A document. -% Feel free to modify entries marked with "Customize". - -% This assumes an ICC profile to reside in the file (ISO Coated sb.icc), -% unless the user modifies the corresponding line below. - - -systemdict /ProcessColorModel known { - systemdict /ProcessColorModel get dup /DeviceGray ne exch /DeviceRGB ne and -} { - true -} ifelse -{ (ERROR: ProcessColorModel must be /DeviceGray or DeviceRGB.)= - /ProcessColorModel cvx /rangecheck signalerror -} if - - -% Define entries to the document Info dictionary : - -/ICCProfile (/Users/claudio/icc/ECI-RGB.V1.0.icc) def -%/ICCProfile (/System/Library/ColorSync/Profiles/Generic CMYK Profile.icc) def - -[ /Title (La classe TOPtesi) % Customize. -/Author (Claudio Beccari) % Customize. -/Subject (File PDF ottenuto con XeLaTeX) % Customize. - /DOCINFO pdfmark - -% Define an ICC profile : - -[/_objdef {icc_PDFA} /type /stream /OBJ pdfmark -[{icc_PDFA} <</N systemdict /ProcessColorModel get /DeviceGray eq {1} {4} ifelse >> /PUT pdfmark -[{icc_PDFA} ICCProfile (r) file /PUT pdfmark - -% Define the output intent dictionary : - -[/_objdef {OutputIntent_PDFA} /type /dict /OBJ pdfmark -[{OutputIntent_PDFA} << - /Type /OutputIntent % Must be so (the standard requires). - /S /GTS_PDFA1 % Must be so (the standard requires). - /DestOutputProfile {icc_PDFA} % Must be so (see above). - /OutputConditionIdentifier (CGATS TR001) % Customize ->> /PUT pdfmark -[{Catalog} <</OutputIntents [ {OutputIntent_PDFA} ]>> /PUT pdfmark diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.cfg b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.cfg deleted file mode 100644 index e294bd83f58..00000000000 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.cfg +++ /dev/null @@ -1,92 +0,0 @@ -%% -%% This is file `toptesi.cfg', -%% generated with the docstrip utility. -%% -%% The original source files were: -%% -%% toptesi.dtx (with options: `topcfg') -%% ______________________________________________________ -%% The TOPtesi package -%% Copyright (C) 2012 Claudio Beccari -%% All rights reserved -%% -%% License information appended -%% -%% \CharacterTable -%% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z -%% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z -%% Digits \0\1\2\3\4\5\6\7\8\9 -%% Exclamation \! Double quote \" Hash (number) \# -%% Dollar \$ Percent \% Ampersand \& -%% Acute accent \' Left paren \( Right paren \) -%% Asterisk \* Plus \+ Comma \, -%% Minus \- Point \. Solidus \/ -%% Colon \: Semicolon \; Less than \< -%% Equals \= Greater than \> Question mark \? -%% Commercial at \@ Left bracket \[ Backslash \\ -%% Right bracket \] Circumflex \^ Underscore \_ -%% Grave accent \` Left brace \{ Vertical bar \| -%% Right brace \} Tilde \~} -%% -%%================================================================ -%% This file is the only file of the TOPtesi bundle that the user -%% can modify without restrictions in order to customize the -%% contents of this configuration file to his/her needs. The user -%% can add or remove lines, comment or uncomment lines, change the -%% arguments to the macros, add definitions and so on. -%% A better use of this file consists into copying it to another -%% file to be named as the thesis main file and with extension -%% .cfg; This bundle will try to read "\jobname.cfg"; if this file -%% does not exist, it looks for toptesi.cfg and if this further -%% does not exist, it does nothing. This means that the provided -%% file toptesi.cfg is to be used preferably as a model, not to -%% be used directly. -%%================================================================ -%% -\ateneo{} - \NomeMonografia{Manuale d'uso} - \monografia{La classe \textsf{TOPtesi}} - \sottotitolo{Per comporre le tesi al Poli \\e in molte altre università} - \candidato{Claudio Beccari} - \logosede{logo_blu} - \retrofrontespizio{Questo testo à libero secondo le condizioni stabilite dalla \LaTeX\ Project Public Licence (LPPL) riportata nell'appendice~\ref{ch:LPPL} alla pagina~\pageref{ch:LPPL}. - -\bigskip - -\noindent Composto con \XeLaTeX\ il \today -\vspace*{5\baselineskip}} -%% -%% Copyright 2005-2012 Claudio Beccari -%% -%% Distributable under the LaTeX Project Public License, -%% version 1.3c or higher (your choice). The latest version of -%% this license is at: http://www.latex-project.org/lppl.txt -%% -%% This work is "author-maintained" -%% -%% This work consists of this file toptesi.dtx, a README file -%% and the derived files: -%% -%% toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, -%% toptesi.cfg, and the English documentation toptesi.pdf. -%% -%% Furthermore the bundle contains the documentation source -%% file toptesi-doc-xetex.tex and the derived file -%% toptesi-doc-xetex.pdf. -%% -%% The toptesi-example.tex source file is just an example -%% that shows how to use the various commands; by commenting -%% or uncommenting certain source lines it is possible to -%% typeset different kind of theses and their frontpages. -%% -%% The toptesi.cfg file is a sample of a local configuration -%% file that can be freely edited and modified. -%% -%% By running pdflatex on toptesi.dtx the user gets the class, -%% sty and cfg files and the English documentation file in -%% pdf format. -%% -%% The documentation file toptesi-doc-xetex.pdf is in Italian; -%% its source file is another example of how to use toptesi. -%% -%% End of file `toptesi.cfg'. diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.pdf Binary files differdeleted file mode 100644 index cca5904b1e8..00000000000 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.tex b/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.tex deleted file mode 100644 index 66a65a99e2c..00000000000 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-doc-xetex.tex +++ /dev/null @@ -1,1811 +0,0 @@ -% !TEX encoding = UTF-8 Unicode -% !TEX TS-program = XeLaTeX -% -% toptesi-doc-xetex.tex -%% Copyright 2013 Claudio Beccari -% -% This work may be distributed and/or modified under the -% conditions of the LaTeX Project Public License, either version 1.3 -% of this license or (at your option) any later version. -% The latest version of this license is in -% http://www.latex-project.org/lppl.txt -% and version 1.3 or later is part of all distributions of LaTeX -% version 2003/12/01 or later. -% -% This work has the LPPL maintenance status "author-maintained". -% -% -% Version 1.3 of the LaTeX Project Public License is included in the -% appendix of this documentation, but the primary source remains in -% http://www.latex-project.org/ -% -\documentclass[12pt,twoside,pdfa% -]{toptesi}\errorcontextlines=9 -\setmainfont[Ligatures=TeX]{TeX Gyre Termes} -\setsansfont[Ligatures=TeX, Scale=MatchLowercase]{TeX Gyre Heros} -\setmonofont{UM Typewriter} -\usepackage{amsmath} -\usepackage{unicode-math} -\setmathfont{XITS Math} -\usepackage{metalogo} -\usepackage{longtable,booktabs} -\usepackage{hyperref} -\hypersetup{% - pdfpagemode={UseOutlines}, - bookmarksopen, - pdfstartview={FitH}, - colorlinks, - linkcolor={blue}, - citecolor={blue}, - urlcolor={blue} - } -\newcommand*\prog[1]{\textsf{#1}} -\newcommand*\pack[1]{\textsl{\sffamily #1}} -\let\class\pack -\newcommand*\meta[1]{$\langle${\normalfont\textit{#1}}$\rangle$} -\newcommand*\file[1]{\texttt{#1}} -\providecommand\cs[1]{\texttt{\char92#1}} -\newcommand*\oarg[1]{\texttt{[}\meta{#1}\texttt{]}} -\newcommand*\marg[1]{\texttt{\{}\meta{#1}\texttt{\}}} -\makeatletter -\def\GetFileInfo#1{% - \def\filename{#1}% - \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} -% -\GetFileInfo{toptesi.cls} -% - \sedutadilaurea{Classe \textsf{toptesi} versione \fileversion\ del \filedate} - - -\thispagestyle{empty} -\vspace*{.2\textheight} -\hrule -\bigskip -\centerline{\Huge \textsf{La classe TOPtesi}} -\bigskip -\hrule -\clearpage - - - - -\frontespizio -\sommario - Questo testo serve per descrivere come comporre tipograficamente la tesi di laurea o la monografia o la dissertazione di dottorato mediante il noto programma di composizione \LaTeX, o meglio, mediante le sue varianti pdf\LaTeX, \XeLaTeX\ o \LuaLaTeX; per produrre con \XeLaTeX\ il file finale in formato PDF archiviabile secondo la norma ISO \mbox{19005-1} bisogna procedere attraverso il programma \prog{ghostscript} e le indicazioni contenute nel paragrafo~\ref{sec:XePDFA}. - -\english -\sommario -This text describes how to typeset a university master thesis, or the bachelor final report, or the PhD dissertation through the well known typesetting program \LaTeX, or rather through its variants pdf\/\LaTeX, \XeLaTeX, or \LuaLaTeX; in order to produce the final document in a PDF archivable format according to the ISO regulation \mbox{19005-1} it's necessary to proceed through the \prog{ghostscript} program and by following what is described in section~\ref{sec:XePDFA}. - - -\italiano -\ringraziamenti - -Ringrazio gli studenti del Politecnico di Torino che mi hanno sollecitato a mettere la mia esperienza a loro disposizione per predisporre e rendere disponibile il software necessario per preparare le loro tesi, monografie o dissertazioni con la qualità che solo pdf\/\LaTeX, \XeLaTeX\ o \LuaLaTeX\ riescono a produrre\footnote{Questa particolare composizione è stata eseguita con \XeLaTeX. Questo motore di composizione presenta numerosi vantaggi su \prog{pdflatex} per quel che riguarda l'uso dei font, anche per la matematica, ma non è ancora (2014) in grado di produrre l'uscita direttamente nel formato PDF, anche se apparentemente lo fa. In realtà la sua uscita è in un formato intermedio che viene poi trasformato automaticamente in PDF. L'esperienza mi insegna che in realtà le limitazioni di \XeLaTeX\ sono pochissime e, con la classe \pack{TOPtesi}, quella forse più importante, ma facilmente risolvibile, riguarda il formato PDF archiviabile che non è ottenibile direttamente, tanto che bisogna procedere come indicato nel paragrafo~\ref{sec:XePDFA}.}. - -\indici - -\chapter{Introduzione} - -Si legge ancora nelle istruzioni per scrivere le tesi di molte -università italiane come di moltissime università straniere: -\begin{quote}\ttfamily -Comporre la tesi con interlinea 2 e con righe di 60 battute;~\dots -\end{quote} - -Quelle università non si sono ancora accorte che le macchine da -scrivere meccaniche o elettromeccaniche sono rimasti oggetti di -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 processor'', che fanno parte più o meno di -default di ogni dotazione iniziale di qualsiasi PC di qualunque -marca e con qualunque sistema operativo. - -Fra i vari programmi di elaborazione testi, uno in particolare -spicca per la sua particolarità: \LaTeX. Esso è nato come -sovrastruttura di un altro programma, \TeX, che continua ad -esserne il motore. La prima versione di \TeX\ è stata creata nel -1978, ma è ancora usata oggi, naturalmente molto aggiornata, e -questo fatto è una cosa insolita nel panorama turbolento di novità -dell'informatica. - -Secondo me, il suo successo è dovuto a due fatti: (a) esso è stato -progettato e implementato da un matematico per comporre i suoi -stessi libri di informatica; (b) egli l'ha messo a disposizione di -chiunque, sin dal primo momento, come software libero. - -Oggi il software libero è piuttosto diffuso, ma nel 1978 parlare -di software libero era quasi una bestemmia. - -D'altra parte Donald E.\ Knuth non era soddisfatto della bassa -professionalità che anno dopo anno manifestavano i compositori -delle case editrici, i quali anno dopo anno si abituavano a quanto -i programmi di elaborazione mettevano loro a disposizione, ma -contemporaneamente perdevano le loro conoscenze professionali via -via che si adattavano a quanto quei programmi consentivano loro di -fare. - -La cosa era o stava diventando insostenibile durante i vari anni -in cui uscivano i successivi volumi dell'opera di Knuth \emph{The Art -of Computer Programming}, e così Knuth si dedicò alla creazione -della tipografia elettronica realizzando il programma \TeX\ che, -ripeto, è ancora in ottima salute dopo oltre trent'anni di -onorato servizio. - -L'uso di \TeX\ per eseguire direttamente la composizione era piuttosto -difficile, e ogni utente doveva prima o poi imparare a scriversi delle -macroistruzioni che gli consentissero di agevolare il suo lavoro. - -Nel 1984 \TeX\ era già così diffuso in tutto il mondo, -specialmente in ambito accademico, che Leslie Lamport decise di -produrre un sistema quasi completo di macro che consentiva agli -utenti di usare \TeX\ lasciandolo dietro alle quinte, in modo da -potersi concentrare sul contenuto dei loro scritti e non sulla -forma da dare a questo o a quel dettaglio. - -Nel 1990 Knuth pubblicò la versione di \TeX\ che consentiva di -comporre in diverse lingue simultaneamente; nel 1994 molti utenti -di \LaTeX\ costituirono il \LaTeX3 Team al fine di rendere -gestibile la mole enorme delle estensioni di \LaTeX\ che in -10~anni utenti entusiasti avevano messo a disposizione della -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 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 -di Knuth, non l'hanno incassato ma l'hanno incorniciato come fosse -una reliquia preziosa. - -\section{\LaTeX\ e le tesi di laurea} - -Ovviamente \LaTeX\ serve per scrivere qualunque cosa; o meglio; -serve per comporre tipograficamente qualunque testo. \LaTeX\ non è -un programma di impaginazione, è un programma di composizione -tipografica. Non aspettatevi quindi di poter fare qualunque -acrobazia con le righe di testo, come per esempio piegare le -righe, deformando i caratteri che vi sono appoggiati sopra, -mettendovi attorno aloni di luce cangiante, sfumature, -ombreggiature, evidenziandone i contorni, eccetera. Queste cose -sono riservate ai creativi che si occupano di pubblicità. - -Aspettatevi invece di comporre testi in cui ogni capoverso è -ottimizzato per avere il minor numero di parole divise in sillabe -in fin di riga, e di avere il minor numero possibile di -``ruscelli'' fra le parole grazie alla uniformità dello spazio -interparola; aspettatevi di comporre formule complicatissime con -il minimo di sforzo da parte vostra ma con la certezza che esse -saranno composte come nessun altro programma riesce a fare. -Aspettatevi uno stampato estremamente professionale. - -Per questo motivo voi studenti che userete questo pacchetto di -macroistruzioni chiamato \textsf{TOPtesi} dovrete astenervi -dall'introdurre errori compositivi così da vanificare quanto di -bello riesce a produrre \LaTeX. - -Inizialmente vi troverete un po' a disagio perché vi siete -abituati anche voi ai programmi commerciali che consentono la -``composizione sincrona''; vi consentono di vedere subito sullo -schermo il frutto del vostro lavoro. Per ottenere questo risultato -questi programmi hanno necessariamente rinunciato a diverse -funzioni, massimizzando invece la velocità di presentazione del -risultato. - -\LaTeX\ richiede che voi scriviate un testo non formattato in puri -caratteri ASCII\footnote{In realtà potete scrivere con qualunque set di caratteri e con qualunque \emph{codepage}; oggi poi è possibile avere editor testuali che usano la codifica UNICODE, che consente, essendone capaci, di scrivere anche in cinese. Il documento che state leggendo è stato composto usando un file sorgente scritto in UNICODE; non contiene caratteri cinesi, ma avrei potuto farlo se fossi stato capace!}, ma marcato con un particolare sistema di -\emph{mark-up} che consente di sapere che cosa sia ogni parte del -vostro scritto. Ci pensa poi \LaTeX\ in un secondo tempo a dare forma -al vostro testo e, in particolare, a dare la stessa forma a ogni -elemento del vostro scritto a seconda di come lo abbiate ``marcato''; -elementi marcati nello stesso modo vengono composti nello stesso modo. -Così si evitano quelle disuniformità compositive che si notano assai -spesso quando si usa un word processor comune. - -Attenzione: questa guida presuppone che voi abbiate già uno conoscenza di base del linguaggio di \emph{mark-up} di \LaTeX. Se non l'avete ancora, installate pure il programma, ma non usate questa guida per imparare a comporre testi con \LaTeX. Esistono diversi testi gratuiti in rete, da \emph{\LaTeX\ per l'impaziente} a \emph{L'arte di scrivere con \LaTeX} a \emph{Introduzione all'arte della composizione tipografica con \LaTeX}; vi basta cercare questi titoli con un qualunque motore di ricerca e troverete da dove scaricarli. - -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} (Quello che vedi è quello che ottieni), che più realisticamente andrebbe scritto \emph{What you see is all you can get} (Quello che vedi è 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. - -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 mettete a ``giocare'' con la sua forma. Non solo, ma quando vorrete estendere le capacità di presentare il testo che volete scrivere alla ``\LaTeX'', scoprirete ben presto che con LyX è difficile e con TeXmacs è impossibile. - -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, ma 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} -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. - -Ci sono sostanzialmente tre situazioni: -\begin{enumerate} -\item se siete degli utenti delle piattaforme Windows allora collegatevi in rete al sito \texttt{www.miktex.org} e scaricatevi ed installatevi la distribuzione di \LaTeX, o meglio, del sistema \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 distribuione 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 qualunque distribuzione, anche se non viene installato di default; vi basta inserire il disco di installazione o vi basta connettervi in rete e invocare uno dei vari programmi come \prog{apt-get}, \prog{rpm}, \prog{yast} o\dots\ per scaricare tutto quanto vi serve e per configurare l'installazione. Ricordatevi che Linux è un po' più ``ruspante'' di Windows, e quindi la configurazione richiede un po' più di attenzione e di smanettamento con la riga di comando; ma a questo, in qualità di ``pinguini doc'', ci siete abituati; in compenso avete il beneficio di avere tutto quanto il software già predisposto fin dalla nascita per macchine UNIX e Linux e quindi evitate tutti i (pochi) piccoli bug che si incontrano quando le cose sono tradotte per altri sistemi. - -Fate solo attenzione alle distribuzioni Debian; sono eccellenti e ne è garantita la compatibilità con lo specifico sistema operativo, ma solitamente sono in ritardo di un paio di anni rispetto alle versioni aggiornate pubblicate dal \TeX\ Users Group! Se appena potete installate la distribuzione TeX Live completa scaricata dal sito \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 possessori di un portatile o di un desktop che funziona con il sistema operativo Mac~OS~X. Anche voi avete a disposizione una distribuzione che si chiama \prog{Mac\TeX}, che viene installata e configurata con un particolare software adatto alla specificità del sistema che state usando. Cercate il nome MacTeX con un qualunque motore di ricerca e sarete portati ad un sito dal quale potrete scaricare il pacchetto di installazione (piuttosto grosso); alla fine del download vi viene chiesto se continuare con l'installazione; rispondendo affermativamente, il software vi viene scaricato sul disco che avrete indicato, ma quel che è più comodo, esso è già completo, come ogni distribuzione e installazione TeX Live. Il sistema \prog{Mac\TeX} produce il suo output essenzialmente in formato PDF; se ne tenga conto leggendo attentamente la documentazione. Il pacchetto è già dotato dello shell editor \TeX{}shop che fa ricorso ad un suo previewer interno per il formato PDF; potrebbe essere una buona idea scaricare dalla rete anche l'applicativo freeware Adobe Reader che dalla versione 9 in poi è anche in grado di riconoscere se un file è o potrebbe essere conforme al formato PDF/A, anche se non è in grado di validarlo come tale; Adobe Reader X, quando apre un file che potrebbe essere conforme allo standard PDF/A, apre in testa alla schermata una riga di informazione nella quale dice che il file è conforme a questo standard; non è il caso di prendere per verità assoluta quella affermazione, perché i file che vengono classificati conformi allo standard PDF/A da Adobe Reader X, talvolta non passano il test di Preflight di Adobe Acrobat. Tuttavia consente di estrarre delle informazioni che sono difficili da estrarre con altri visualizzatori dei file in formato PDF e consente di aggiungere annotazioni. Naturalmente esistono altri visualizzatori dei file in formato PDF; sulle macchine Apple il visualizzatore di sistema consente di aprire e di editare parzialmente anche altri formati grafici e consente di eseguire molte operazioni, in particolare sui file PDF, che in generale richiedono 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. Oggi (2012) Texmaker e TeXstudio, entrambi multipiattaforma, sono dotati di visualizzatori interni che consentono la ricerca diretta e inversa; TeXstudio dalla versione 2.5 è anche in grado di interpretare le righe di autoconfigurazione scritte con le sintassi di \TeX{}shop e \TeX{}works. - -\end{enumerate} - -Merita di segnalare che per tutte e tre le piattaforme è disponibile e, generalmente, è già installato di default anche l'editor \TeX{}works (multipiattaforma) che con il suo visualizzatore interno consente di eseguire su tutte le piattaforme la ricerca diretta e inversa. Ad alcuni, abituati a interfacce grafiche fornite di molte barre cariche di icone per eseguire il possibile e l'impossibile, \TeX{}works piace poco perché la sua schermata è minimale, ma c'è un motivo: nei moderni schermi larghi, con rapporto di forma 16:9, lo schermo contiene accostate e senza sovrapposizioni sia la finestra di editing sia quella del testo composto; questo è molto comodo, più di quanto si possa immaginare, per ``lavorare'' agevolmente il documento da comporre. Benché anche Texmaker e TeXstudio siano in grado di accostare le due schermate, essi consumano molto spazio per le barre superiori, inferiori e laterali, cosicché le vere aree destinate all'editing o alla visualizzazione ne risultano corrispondentemente ristrette, tanto da far preferire \TeX{}works sui laptop e ancor di più sui netbook. - -Poi avete bisogno di programmi accessori per visualizzare sullo schermo e/o stampare su carta i prodotti delle vostre composizioni. Ognuna delle tre piattaforme tipo può avere già -installati sia i visualizzatori dei file in formato \texttt{.dvi}, \texttt{.ps} o \texttt{.pdf}. Il formato \texttt{.dvi} è il formato nativo del sistema \TeX\ quindi il software per visualizzare e stampare arriva insieme alla distribuzione che avete già installato, però oggi è un formato che non si usa quasi più. Per il formato \texttt{.ps} bisogna disporre di qualcosa come \prog{ghostscript} e/o \prog{GSView} o altri simili software che con Linux sono solitamente già disponibili insieme al sistema. In ogni caso non è difficile trovare in rete i luoghi da dove scaricarli. Per il formato \texttt{.pdf} Linux, come al solito è già attrezzato, ma non è male per tutti e tre i tipi di piattaforme il programma \prog{Adobe Reader} che la Adobe mette a disposizione di chiunque 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, ma possono venire ``sincronizzati'' con visualizzatori esterni; per esempio su piattaforme Windows il visualizzatore sincronizzabile è SumatraPDF; su Linux è Okular; su Mac ne posso citare altri due: TeXnicle (gratuito) e Texpad (commerciale, ma con un costo accessibilissimo) che non solo hanno il visualizzatore integrato, ma le loro ``finestre'' sono in realtà due parti di una stessa finestra; ingrandendola a pieno schermo si ottiene una comodità di composizione difficilmente ottenibile con altri sistemi. - -Anche Emacs (multipiattaforma), arricchito del plug-in Auctex, che lo rende particolarmente adatto 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 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} -(un simulatore di UNIX compatibile con la maggior parte dei -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 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 MiK\TeX\ e 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. Suo ``figlio'' \TeX{}works (multipiattaforma) sembra avere qualche funzionalità in meno (non è così vero), ma ha una interfaccia comodissima per scoprire la codifica di un file \file{.tex} e per convertire il file in un'altra codifica; \TeX{}shop e \TeX{}works sono autoconfigurabili per ciascun file \file{.tex} grazie ad alcune righe di commenti speciali da scrivere in testa la file, cosa che rende il loro uso incredibilmente comodo. TeXstudio dalla versione 2.4 in poi è in grado di interpretare le stesse righe speciali di \TeX{}shop e di autoconfigurarsi di conseguenza (settembre 2012). Emacs con Auctex è in grado di usare righe di autoconfigurazione che però hanno una sintassi diversa da quelle di \TeX{}shop. Questa affermazione vale anche per Aquamacs, che è una applicazione per Mac che integra direttamente emacs e Auctex. - -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 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 nativamente la ricerca inversa anche con il formato PDF, e questa particolarità è estremamente comoda. Per le piattaforme Windows esiste il visualizzatore PDF \prog{SumatraPDF} che può essere configurato per interagire con molti editor per poter essere usati assieme sia con la ricerca diretta sia con quella inversa. Va da sé, che se non ci sono esigenze diverse, il formato di uscita PDF è sicuramente quello da preferire. - -\section{Ora siete pronti} -Ora che avete scaricato tutto il software gratuito o commerciale di cui -avete bisogno siete pronti per cominciare. - -{\color{red}Dopo avere letto un po' di documentazione e aver giocato un poco con i programmi già predisposti sia dalla distribuzione del sistema \TeX\ sia dai vari editor ASCII, siete in grado di capire come funziona il tutto. - -Attenzione: non si minimizzi la frase precedente: la documentazione va letta sempre e capita fino in fondo; se c'è qualcosa che non capite, provate ad esercitarvi con qualche piccolo esercizio, visto che la pratica permette di capire la teoria (e viceversa), ma non andate a cercare in rete aiuto nei vari forum dedicati a \LaTeX\ per farvi dire: ``guarda nella pagina tal-dei-tali della documentazione''; per voi sarebbe una vera umiliazione\dots} - -A qualcuno può venire in mente: ``Ma non sarà mica che ci siano in giro dei programmi che permettono di fare tutto questo in modo WYSIWYG?'' Come noto, WYSIWYG è l'acronimo che si forma con le iniziali di ``what you see is what you get''. \LaTeX\ dovrebbe essere classificato con l'acronimo WYSIWYM che sta per ``what you see is what you mean''. Certo per ottenere esattamente quello che si voleva bisogna lavorare (apparentemente) di più; in realtà bisogna usare di più la testa e di meno il mouse. - -Tuttavia là fuori nei negozi ci sono diversi prodotti che consentono di usare \LaTeX\ praticamente in modo WYSIWYG; da Scientific Word a LyX a TeXmacs a Textures ce ne è per ogni piattaforma; LyX e TeXmacs sono freeware mentre gli altri costano attorno ai 500\textdollar. Poi c'è la soluzione gratuita di OpenOffice con l'estensione~1.2 di \prog{Writer2LaTeX}. Io le sconsiglio tutte, come ho già avuto modo di dire, e qui ne ripeto i motivi. - -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. - -Disponendo di una piattaforma Linux ho anche verificato il funzionamento sia di LyX sia di TeXmacs, ma alla fine sono tornato a usare i miei semplici editor ASCII con i quali non ho assolutamente nessuna limitazione per quel che riguarda la composizione dei miei testi. Bisogna dire che io faccio un grande uso di macroistruzioni adatte al mio modo di comporre; in generale le macroistruzioni non sono interpretabili da quei sistemi che sono un po' chiusi in se stessi, proprio per poter massimizzare la velocità di rendering. - -\textcolor{red}{Nel seguito partirò dal presupposto che abbiate già una certa -conoscenza di \LaTeX\ e che conosciate la differenza fra \LaTeX, -pdf\LaTeX\ e \XeLaTeX.} - -Ma dubito che qualcuno abbia conoscenze sufficientemente approfondite 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}. - -\begin{table}[tbp]{\centering -\begin{tabular}{lp{.3\textwidth}p{.25\textwidth}} -\toprule - & \centering pdf\LaTeX & \centering \XeLaTeX \tabularnewline -\midrule -Formati di uscita & \centering DVI e PDF & \centering XDV e PDF \tabularnewline -Font & \raggedright Font di 256 caratteri con codifiche OT1, T1, T2, LY1, LGR, eccetera - & \raggedright Font OpenType con codifica UNICODE\tabularnewline -Alfabeti diversi & \raggedright Solo mediante pacchetti esterni - & \centering Font OpenType \tabularnewline -Lingue retrograde & \raggedright Solo mediante pacchetti esterni - & \centering Font OpenType \tabularnewline -Ideogrammi & \raggedright Solo mediante pacchetti esterni - & \centering Font OpenType \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 mediante altri programmi, forse, in modo ancor più sicuro che con pdf\/\LaTeX. - -\noindent ($\dagger$) Dalla versione del 2010 pdf\LaTeX\ converte automaticamente in formato PDF i file EPS, conservandone quindi il carattere vettoriale; provvede anche a scontornarli. -\end{table} - - -\chapter{L'uso di \textsf{TOPtesi}} - -L'insieme di macro contenute in \textsf{TOPtesi} realizza esattamente -le specifiche di composizione per le monografie, tesi di laurea e -dissertazioni di dottorato da comporre presso il Politecnico di Torino; -l'acronimo TOP sta per \textcolor{red}{TO}rino \textcolor{red}{P}olitecnico e naturalmente gioca un po' anche sull'altro significato della parola inglese ``top''. - -Tuttavia il pacchetto non è stato creato solo per il Politecnico -di Torino, il cui nome è il nome preimpostato; invece la stringa ``Facoltà di~'' e il nome della facoltà sono vuote. Questo dipende dall'ultima riforma universitaria approvata in Italia, che ha obbligato gli atenei a riformulare gli statuti in modo da eliminare sostanzialmente le facoltà; in alcuni casi strutture didattiche equivalenti alle facoltà sono sopravvissute sotto altro nome, in altri sono sparite definitivamente. In alcuni casi il coordinamento delle attività didattiche è passato ai dipartimenti. Lo studente deve quindi informarsi presso la sua segreteria didattica competente per sapere come debba essere intestato il frontespizio delle monografie, tesi magistrali o dissertazioni di dottorato. I comandi predisposti in questo pacchetto consentono di personalizzare la composizione del proprio lavoro finale per ogni ateneo e ogni struttura didattica e, oserei dire, in ogni lingua. - -Presso il Politecnico di Torino, l'ateneo preso come riferimento, le facoltà non esistono più; perciò il valore preimpostato per la stinga ``Facoltà di~'' è nullo; un test per la composizione del frontespizio verifica la presenza di questa stringa nulla e omette completamente di indicare qualsiasi informazione sulla struttura didattica; in altri atenei potrebbe essere utile inserire nel file di configurazione qualcosa come: -\begin{verbatim*} -\StrutturaDidattica{Dipartimento di } -\struttura{Ingegneria Strutturale} -\corsodilaurea{Ingegneria di Ponti e Strade} -\end{verbatim*} -Il nome del corso di laurea potrebbe essere facoltativo se la struttura didattica competente cura la didattica per un solo corso di laurea, ma sicuramente questo corso non ha lo stesso nome della struttura didattica, quindi è opportuno specificarlo anche in questi casi; se invece la segreteria competente non richiede il nome di nessuna struttura didattica, allora il corso degli studi deve essere necessariamente indicato. Si noti: per facilitare l'inserimento di queste informazioni sono stati predisposti i comandi \verb|\StrutturaDidattica|, equivalente a \verb|\FacoltaDi|, e \verb|\struttura|, equivalente a \verb|\facolta|. - - -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 -cosiddette esatte, quelle che fanno un grande uso del linguaggio -matematico, ma è altrettanto utile per scrivere testi in -discipline umanistiche, perché pdf\LaTeX\ e \XeLaTeX\ sono -altrettanto precisi nel comporre la matematica di quanto lo siano -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 \emph{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, cambiategli il nome ma non l'estensione, e modificatelo secondo le vostre necessità. - - -\section{Il file di configurazione} - - -È comodo, ma non è obbligatorio, disporre di un file di configurazione. Il pacchetto \textsf{TOPtesi} contiene già un file con una configurazione di default da usare come modello; chiunque se lo può copiare in un altro file mantenendo l'estensione \texttt{.cfg} e con il nome identico a quello del file principale della tesi. Questo file, se esiste, verrà letto durante l'esecuzione del programma e verranno eseguiti tutti i comandi che esso contiene; se quindi l'utente ne fa uso, deve servirsi del modello per cambiarne i dati e metterci le informazioni che l'utente ritiene utili per la sua tesi. Se non viole servirsi del file di configurazione deve solo inserire nel suo file principale tutte le informazioni necessarie al frontespizio (e al retrofrontespizio, se lo vuole usare) prima di specificare il comando \cs{frontespizio}. - -Potete perciò usare un diverso file di configurazione, sempre chiamato \meta{mainfile}\texttt{.cfg}, collocato nella stessa cartella dove risiede il materiale da comporre. Per esempio, potreste comporre la monografia di laurea creando da qualche parte la cartella \texttt{/monografia} e in questa cartella vi create \meta{mainfile}\texttt{.cfg} nel quale scriverete quello che vi è necessario; in questa cartella sistemerete anche i file per comporre la monografia. Quando due anni dopo componete la vostra tesi di laurea magistrale, create da qualche parte la cartella \texttt{/tesi} e mettetevi dentro un'altro file \meta{mainfile}\texttt{.cfg} con la vostra configurazione adattata alla tesi magistrale; in questa stessa cartella metterete i file relativi alla vostra tesi magistrale. Se dopo tre anni prenderete il dottorato e vi scriverete la vostra dissertazione dottorale, createvi da qualche parte la cartella \texttt{/dissertazione} e mettetevi dentro un'altro file \meta{mainfile}\texttt{.cfg} che configurerete per la vostra dissertazione; sempre in questa stessa cartella metterete i file necessari per comporre la vostra dissertazione. Ovviamente nei tre casi \meta{mainfile} conterrà il nome del vostro file principale che, altrettanto ovviamente, avrà un nome diverso per ciascuna delle tre tesi. - -\section{Il formato PDF/A} -Le istruzioni che seguono per la produzione di un file conforme alla normativa PDF/A sono applicabili se si compone la tesi sia con il programma \prog{pdflatex} sia con \prog{xelatex}. In particolare, se si usa \prog{xelatex} e se si vogliono realizzare gli hyperlink interni non si deve chiamare esplicitamente il pacchetto \pack{hyperref}, ma lo si può configurare come meglio si crede usando solo il comando \verb|\hypersetup| per impostare le opzioni e le personalizzazioni; per sfruttare al meglio le possibilità offerte da \prog{xelatex} è necessario caricare il pacchetto \pack{fontspec} che, senza ulteriori opzioni o specificazioni, usa di default i font Latin Modern nella versione OpenType; volendo si possono usare i comandi specifici disponibili con quel pacchetto per caricare font diversi. Notate che se avete predisposto il preambolo del vostro file sorgente per la tesi in modo da poterlo compilare con \prog{pdflatex} e avete anche specificato l'opzione \texttt{pdfa}, come indicato qui di seguito, potrete ugualmente compilare il vostro documento anche con \prog{xelatex}, perché TOPtesi è perfettamente conscio del motore di composizione che state usando e sa che il vostro file sorgente parte dal presupposto che volevate creare gli hyperlink, sfruttando il fatto di aver specificato quell'opzione. In altre parole, non avete bisogno di modificare il file sorgente per passare da \prog{pdflatex} a \prog{xelatex}. Però il file prodotto con \prog{xelatex}, per soddisfare le specifiche richieste dalla norma ISO relativa al formato archiviabile, necessita di ulteriore elaborazione. - -Il Politecnico di Torino, come anche molte università italiane e straniere, intende ``smaterializzare'' le copie di archivio delle tesi di laurea. Questo intendimento è cominciato nel 2008 ma non sono al corrente dell'esito di questo studio a cui ho collaborato all'inizio prima di andare in pensione. - -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 (nel 2011 è stato approvato un nuovo standard, 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 sarebbe sufficiente il sottoformato PDF/A-1b. - - -\subsection{\texorpdfstring{\prog}{}{pdflatex} e il formato PDF/A} -Usando \prog{pdflatex} è necessario usare il modulo 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 istruzione è 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. - -{\tolerance=9999 -Non solo, ma il formato PDF/A richiede che sia specificato un profilo di colore; se il disco fisso non contenesse già il file indicato nella documentazione del pacchetto \textsf{pdfx}, si consiglia di scaricare dalla pagina di download del sito \texttt{www.eci.org} il file \texttt{ECI-RGB.V1.0.icc} e di modificare con questo nome le varie righe del file \pack{pdfx.sty} che contengono il riferimento ad un file \texttt{.icc} o \texttt{.icm} diverso.\par} - -Il file \texttt{pdfx.sty} carica anche il file \texttt{hyperref.sty} che permette di eseguire i link interni e (parzialmente) quelli esterni del file PDF. Non è quindi possibile fare a meno di questo file; tuttavia, subito all'inizio del preambolo è possibile personalizzare le informazioni da inserire nel file PDF mediante i parametri dell'argomento del comando \verb|\hypersetup|; a titolo di esempio questo documento informativo può venire composto con questa personalizzazione: -\begin{verbatim} -\documentclass[12pt,twoside,pdfa]{toptesi} -\hypersetup{% - pdfpagemode={UseOutlines}, - bookmarksopen, - pdfstartview={FitH}, - colorlinks, - linkcolor={blue}, - citecolor={blue}, - urlcolor={blue} - } -... -\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 risiedeva era stato creato il file \texttt{toptesi-doc.xmpdata} con il seguente contenuto: -\begin{verbatim} -\Author{Claudio Beccari} -\Title{La classe TOPtesi} -\Keywords{LaTeX</rdf:li>% -<rdf:li>Tesi</rdf:li>% -<rdf:li>PDF/A</rdf:li>% -<rdf:li>Dissertazione</rdf:li>% -<rdf:li>Monografia} -\end{verbatim} -Questa operazione, evidentemente va ripetuta per ogni documento da produrre in formato - PDF/A, e quindi bisogna predisporre un diverso file \texttt{.xmpdata} contenente le informazioni specifiche relative allo specifico documento. - -Ricordate solo che il pacchetto \pack{TOPtesi} non contiene nessuna verifica se state componendo con \prog{pdflatex} oppure con il semplice \prog{latex} o con qualche altro applicativo del sistema \TeX; controlla solo se state usando \prog{xelatex}. Il concetto è che \emph{dovete} usare \prog{pdflatex}. E se usate qualunque altro programma di composizione, o ottenete un messaggio di errore (con \prog{latex}), oppure non avete messaggi di errore ma il file PDF non è conforme alla norma PDF/A (per esempio con con \prog{xelatex}, che però può essere ulteriormente elaborato per raggiungere lo scopo). - -Se esistono validi motivi per non usare \prog{pdflatex}\footnote{Ma è meglio che vi mettiate nelle condizioni di \emph{non usare} quei pacchetti che richiedano l'uso di comandi PostScript, come per esempio \pack{PSTriks} o \pack{XYpic}, ma di usare i pacchetti di grafica come \pack{pgf} e il suo ambiente \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. Lo stesso avviene con \LuaLaTeX\ sebbene questo programma disponga di ulteriori meccanismi per eseguire questo compito; il lettore che abbia la necessità di usare \LuaLaTeX\ lo conosce bene, altrimenti non si accingerebbe ad usarlo senza saperlo usare\dots - -\subsection{\texorpdfstring{\prog}{}{xelatex} e il formato PDF/A}\label{sec:XePDFA} -Se invece usate o dovete usare il programma \prog{xelatex} per comporre la tesi e volete avere un file finale conforme alle specifiche PDF/A, allora dovete procedere in modo diverso\footnote{Questa procedura serve anche quando usate \prog{latex} e usate pacchetti com \pack{PSTricks} che richiedono di inserire del codice PostScript nel file di uscita.}; precisamente usate le stesse cautele raccomandate per quando usate il programma \prog{pdflatex}, cioè specificate l'opzione \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 usate solo font OpenType; \prog{xelatex} è fatto apposta per usare questi font. Per la matematica usate una delle collezioni di font OpenType oggi (2014) disponibili: XITS Math, Asana Math, Latin Modern Math, TeX\ Gyre Pagella Math, \TeX\ Gyre Termes Math. Controllate che qualunque file incluso \emph{non} contenga i font Computer Modern con codifica OT1 (la vecchia codifica senza lettere accentate); apparentemente la funzione di \emph{overlay} che questi font usano per sovrapporre gli accenti sulle lettere da accentare non è più compatibile con la certificazione eseguibile da Preflight di Adobe Acrobat. Tuttavia la distribuzione del sistema \TeX\ contiene una collezione abbastanza ampia di font OpenType, compresi i CM in formato OpenType, e non ci sono in realtà veri problemi con il testo che componente voi; potrebbero essercene se incorporate pagine o figure PDF tratte da altri documenti composti in passato che contengono i font CM di tipo Type~1, la cui funzione di \emph{overlay} evidentemente non è conforme. - -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} -%! -% $Id: PDFA_def.ps 8284 2007-10-10 17:40:38Z giles $ -% This is a sample prefix file for creating a PDF/A document. -% Feel free to modify entries marked with "Customize". - -% This assumes an ICC profile to reside in the file (ISO Coated sb.icc), -% unless the user modifies the corresponding line below. - -systemdict /ProcessColorModel known { - systemdict /ProcessColorModel get dup /DeviceGray ne exch /DeviceCMYK ne and -} { - true -} ifelse -{ (ERROR: ProcessColorModel must be /DeviceGray or DeviceCMYK.)= - /ProcessColorModel cvx /rangecheck signalerror -} if - -% Define entries to the document Info dictionary: - -/ICCProfile (/Users/claudio/icc/ECI-RGB.V1.0.icc) def % Modificato - -[ /Title (La Classe TOPtesi) % Customize. -/Author (Claudio Beccari) % Customize. -/Subject (File PDF ottenuto con XeLaTeX) % Customize. -/DOCINFO pdfmark - -% Define an ICC profile: - -[/_objdef {icc_PDFA} /type /stream /OBJ pdfmark -[{icc_PDFA} <</N systemdict /ProcessColorModel get -/DeviceGray eq {1} {4} ifelse >> /PUT pdfmark -[{icc_PDFA} ICCProfile (r) file /PUT pdfmark - -% Define the output intent dictionary: - -[/_objdef {OutputIntent_PDFA} /type /dict /OBJ pdfmark -[{OutputIntent_PDFA} << - /Type /OutputIntent % Must be so (the standard requires). - /S /GTS_PDFA1 % Must be so (the standard requires). - /DestOutputProfile {icc_PDFA} % Must be so (see above). - /OutputConditionIdentifier (CGATS TR001) % Customize ->> /PUT pdfmark -[{Catalog} <</OutputIntents [ {OutputIntent_PDFA} ]>> /PUT pdfmark -\end{verbatim} - -Questo file è formato dal nome del file \texttt{.tex.}, \texttt{toptesi-doc-xetex}, agglutinato alla ``desinenza'' \texttt{-def.ps}, per un nome complessivo \texttt{toptesi-doc-xetex-def.ps}. Ripeto: deve essere memorizzato nella stessa cartella dove si trova il main file del documento. - -Per eseguire la conversione conviene predisporsi una procedura .bat (per Windows) o bash {per UNIX} del tipo seguente (mostro la procedura bash che con minime modifiche si trasforma in una procedura bat) dal nome \texttt{pdf2pdfa}: -\begin{verbatim} -#!/bin/bash -file1=$1.pdf -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=DeviceRGB --sPDFACompatibilityPolicy=1 -o $file2 ./$file3 $file1 -\end{verbatim} -Ora basta dare il comando nella finestra comandi: -\begin{flushleft} -\texttt{pdf2pdfa} \meta{Nome del main file senza estensione} -\end{flushleft} -e \prog{ghostscript} si mette a lavorare finché produce in uscita un file PDF con il nome del file originario allungato con \texttt{-a}. A questo punto si può procedere con il software di verifica della natura PDF/A del file ottenuto; a me, seguendo le istruzioni che ho indicato, la verifica su questo file ha avuto sempre esito positivo al primo colpo, almeno usando Adobe Acrrobat Pro~8.1. - -Dispongo personalmente di Adobe Acrobat Pro XI, versione 11.0.04 che dovrebbe avere una versione più moderna della funzione Preflight, in grado di verificare la conformità anche con la norma PDF/A-2, pubblicate più recentemente. Evidentemente questa versione è più selettiva della versione 8.1, tanto che la procedura indicata sopra non sembra essere corretta, per un dettaglio che non sono riuscito ad identificare. Tuttavia se si compila il documento con \prog{xelatex} secondo le indicazioni esposta sopra, e non si usa \prog{ghostscript} ma si dà il file PDF appena ottenuto in pasto direttamente ad Adobe Acrobat Professional XI, la sua funzione Preflight è in grado di convertire il file originale in un file conforme alle norme PDF/A e di certificarne la natura. - -Ritengo che disporre del programma Adobe Acrobat Professional sia molto utile in generale, non solo per produrre file PDF/A compatibili; mi sento di suggerire agli studenti di prendere in considerazione l'acquisto di questo programma finché sono studenti; l'azienda che lo produce ha un programma Education che viene incontro agli studenti (e ai docenti) con sconti molto significativi sui suoi prodotti. Non mi permetto assolutamente di fare réclame per questo programma: ce ne sono altri in commercio che fanno questo genere di cose e quindi ogni utente è libero di acquistare quello di sua scelta, oppure di non acquistare nulla. Siccome i programmi commerciali sono costosi, la decisione di acquistare, eventualmente avvalendosi di condizioni di acquisto favorevoli, spetta solo e soltanto all'acquirente. - -Le variazioni per Windows consistono nel fatto che l'eseguibile di \prog{ghostscript} si chiama \texttt{gswin32c} invece che \texttt{gs} e che i parametri di una macro si indicano con \verb|%1|, \verb|%2|, -eccetera, mentre quelli per UNIX si indicano con \verb|$1|, \verb|$2|, eccetera; in bash i commenti iniziano con il segno \texttt{\#} mentre in bat essi cominciano con \texttt{REM}. - -Nessuno vieta di arricchire la definizione della procedura per verificare l'esistenza del file PDF da convertire, o l'esistenza del file dei \emph{metadata}, con la possibilità di emettere dei messaggi cosicché l'utente possa regolarsi nel caso qualcosa risulti mancante. Tuttavia l'essenza dello script bash è quella indicata. - -\section{Pronti? Via!} - -Ora siete pronti per comporre la vostra tesi o monografia o -dissertazione. Ricordate solo di non giocare con quei pochi -comandi di \LaTeX\ che permettono di fare pasticcetti alla -WYSIWYG; \LaTeX\ compone da solo benissimo; al massimo, alla fine, -quando tutto sarà finito e non sarà più necessario apportare -correzioni, potrete anche inserire qualche spazio fine positivo o -negativo per fare degli aggiustamenti di seconda o terza -approssimazione. Ricordatevi però che, anche se non c'è limite -al meglio (ma nemmeno al peggio!), \LaTeX\ lavora benissimo da -solo purché non lo si disturbi con interventi non professionali. - -\section{I file accessori} - -Il pacchetto \textsf{TOPtesi} contiene fra le sue parti il file -\texttt{topfront.sty} che può essere usato per comporre il solo -frontespizio. Esso in effetti, oltre a leggere l'eventuale file di -configurazione, contiene solo i comandi per definire gli elementi -del frontespizio e per comporlo. La cosa può tornare utile in -diverse circostanze, per esempio quando dovete ancora modificare -la tesi quasi ultimata, ma dovete cercare il o i relatori per far -loro firmare alcune copie del frontespizio. - -Basta predisporre un piccolo file come questo, salvandolo con un nome a -piacere, per esempio, con grande fantasia, \texttt{myfile.tex}: -\begin{verbatim} -% !TEX TS-program = XeLaTeX -% !TEX encoding = UTF-8 Unicode - -\documentclass[12pt]{toptesi} -\setmainfont[Ligatures=TeX]{TeX Gyre Termes}% o altro font -\setmainlanguage{italian}% o altra lingua - -\begin{document} -\ateneo{Università di Marconia} -\logosede{logouno} -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Tesi magistrale -\corsodilaurea{delle Telecomunicazioni} -\titolo{Titolo della tesi\\ di laurea magistrale} -\sottotitolo{Sottotitolo della tesi di laurea magistrale} -\relatore{prof.\ Enrico Rosa} -\sedutadilaurea{Dicembre 2014} -\candidata{Susanna Rossi} -\secondacandidata{Laura Bruni} -%\retrofrontespizio{...} -\frontespizio* -\end{document} -\end{verbatim} -Attenzione: la riga \verb|\documentclass| deve essere identica alla corrispondente riga del vostro main file; siccome \pack{TOPtesi} può usare diversi formati di carta, è necessario che il frontespizio sia composto su carta dello stesso formato. Non è invece necessario usare come font normale un font dello stesso corpo della tesi; con carte particolarmente piccole potrebbe essere più opportuno usare il corpo di 10\,pt invece che quello di 12\,pt. -Se dovete scrivere in inglese o in un'altra lingua specificatelo con \verb|\setmainlanguae|. - -Se volete usare \prog{pdflatex} aggiungete la chiamata ai pacchetti \pack{inputenc} e \pack{fontenc} con le opzioni di codifica che preferite; caricate, se lo volete, un pacchetto per scegliere un font per il frontespizio; per esempio: -\begin{verbatim} -\usepackage[utf-8]{inputenc} -\usepackage[T1]{fontenc} -\usepackage[italian]{babel}% o altra lingua -\usepackage{txfonts}% o altro font -\end{verbatim} -Ma se dovete scrivere il frontespizio in un'altra ligia bisogna agire come spiegato poco più avanti. - -In realtà il pacchetto \texttt{topfront} lavora bene in italiano e distingue i singolari dai plurali, i maschili dai femminili; non fa nulla di particolare se la lingua di composizione del frontespizio è l'inglese o un'altra lingua. Se volete comporre il frontespizio in inglese, allora specificatela come unica lingua o come lingua principale nelle opzioni di \verb|\documentclass| oppure, usando \prog{xelatex}, mediante il comando \cs{setmainlanguage}, ma fatelo prima di usare il comando \cs{frontespizio} o \cs{frontespizio*}, poi inserite i seguenti comandi, modificando gli argomenti a vostro piacimento e in accordo con le restrizioni burocratiche per i frontespizi delle tesi nella vostra università:\small -\begin{verbatim} - \retrofrontespizio{This work is subject to the Creative Commons Licence} - \DottoratoIn{PhD Course in\space} - \NomeMonografia{Bachelor Degree Thesis} - \TesiDiLaurea{Master Degree Thesis} - \NomeDissertazione{PhD Dissertation} - \InName{in} - \CandidateName{Candidates}% or Candidate - \AdvisorName{Supervisors}% or Supervisor - \TutorName{Tutor} - \NomeTutoreAziendale{Internship Tutor} - \CycleName{cycle} - \NomePrimoTomo{First volume} - \NomeSecondoTomo{Second Volume} - \NomeTerzoTomo{Third Volume} - \NomeQuartoTomo{Fourth Volume} - \logosede{logouno,logodue}% one logo or a comma separated list of logos -\end{verbatim} -\normalsize - -Passando uno di questi piccoli file a \prog{xelatex} o a \prog{pdflatex}, si ottiene -un documento di una o due pagine, il frontespizio e, facoltativamente, il retrofrontespizio, che si possono stampare in varie copie per gli scopi detti sopra. Ricordate che \class{TOPtesi} pre"carica \pack{babel} o \pack{polyglossia} a seconda che usiate \prog{pdflatex} oppure \prog{xelatex}; non avete quindi l'obbligo di invocare di nuovo questi pacchetti se componenti il solo frontespizio usando \class{TOptesi}, ma dove specificare la lingua che volete usare nei modi descritti sopra. - -Il retrofrontespizio non è necessario in senso assoluto quando volete produrre il frontespizio isolato. Non è nemmeno necessario quando volete comporre la tesi. Tuttavia il comando è disponibile e permette di aggiungere la dichiarazione legale in merito alla licenza; il retrofrontespizio di questa documentazione è stato composto con i comandi seguenti\footnote{Siccome questo codice contiene dei comandi \texttt{\string\ref}, può essere usato solo nella composizione del corpo della tesi dove le etichette invocate sono definite; se si vuole usare questo codice per comporre il retrofrontespizio assieme al frontespizio, ma isolatamente dalla tesi (lo sconsiglio), bisogna sostituire quei comandi e i loro argomenti con i valori reali.}: -\begin{verbatim} -\retrofrontespizio{Questo testo è libero secondo le condizioni -stabilite dalla \LaTeX\ Project Public Licence (LPPL) riportata -nell'appendice~\ref{ch:LPPL} alla pagina~\pageref{ch:LPPL}. - -\bigskip - -\noindent Composto con \XeLaTeX\ il \today -\vspace*{5\baselineskip}} -\end{verbatim} - - -Non dovete dimenticare che, se volete usare \prog{xelatex}, l'editor con cui scrivete questo piccolo file (e con il quale avete eventualmente scritto il file \meta{mainfile}\texttt{.cfg}) deve essere configurato con la codifica \texttt{UTF-8}. - -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 e qui viene utile di avere quei comandi in un pacchetto distinto da \pack{babel} e non soggetto a test sulla lingua in uso. - -Il file contiene anche un comando per la stampa in -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 -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 -\begin{verbatim} -\documentclass{report} -\usepackage{topcoman} -\begin{document} -\chapter{Il programma myprogram.c} -\listing{myprogram.c} -\end{document} -\end{verbatim} -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 -programma non fossero più lunghe di una ottantina di caratteri -per la carta A4, proporzionalmente di meno per formati di carta più piccoli. - -\section{Il logo dell'ateneo} -Non è generalmente necessario inserire nel frontespizio il logo dell'ateneo; controllate presso la vostra la vostra segreteria competente le regole fissate per la composizione del frontespizio. Se il logo è richiesto, allora la segreteria vi dice anche quale logo usare e da dove scaricarne il file che ne contiene la descrizione grafica. - -Controllate se è un file vettoriale (estensione \file{.pdf} oppure \file{.eps}) oppure bitmapped (estensione \file{.jpg}, \file{.png}, \file{.bmp}, \file{.wmf}, \file{.tiff},\dots). Ricordate che \prog{pdflatex} e \prog{xelatex} possono incorporare solo i formati \file{.pdf}, \file{eps}\footnote{Dall'edizione di TeX Live 2011 anche \prog{pdflatex} è in grado di incorporare file in formato \file{.eps}, mentre prima era necessario convertirli preventivamente in formato \file{.pdf}.}, \file{.jpg} o \file{.png}). Se il file viene fornito in un formato diverso da questi quattro, è necessario convertirlo in uno di questi formati. - -Vale la pena di ricordare che il formato \file{.jpg} va bene per immagini a colori sfumati come le fotografie, mentre il formato \file{.png} è più adatto per disegni al tratto con righe fortemente contrastate rispetto allo sfondo. In generale, quindi, sarebbe meglio convertire nel formato \file{.png} un logo bitmapped fornito in un formato diverso da quelli elencati sopra. Potendo disporne, sarebbe sempre meglio usare un disegno veramente vettoriale del logo. - -Ricordate anche che il logo dell'ateneo è di proprietà dell'ateneo stesso e va usato secondo regole precise; è per questo che il pacchetto \pack{TOPtesi} non viene distribuito più con i loghi di diversi atenei, come veniva fatto nelle prime edizioni. - -Merita segnalare che le tesi svolte nell'ambito di collaborazioni fra atenei possono richiedere i loghi dei diversi atenei partecipanti all'accordo; segnalo la Scuola Interpolitecnica di Dottorato condotto nell'ambito di un accordo fra i politecnici di Bari, Milano e Torino. Ricordo i programmi di doppia laurea condotti nell'ambito di accordi fra l'ateneo di appartenenza e un altro ateneo, generalmente europeo. Ricordo il programma europeo Erasmus Mundus dove il titolo di studio viene condotto da consorzi di almeno quattro atenei di nazioni diverse. In queste circostanze è spesso necessario inserire nel frontespizio i loghi di tutti gli atenei partecipanti alla convenzione. - -Il pacchetto \pack{TOPtesi} contiene un comando molto potente, \cs{logosede}, che accetta la sintassi seguente: -\begin{flushleft}\obeylines -\cs{logosede}\oarg{altezza}\marg{file del logo} -\medskip -oppure -\medskip -\cs{logosede}\oarg{altezza}\marg{lista di nomi di file di loghi separati da virgole} -\end{flushleft} -dove il valore prefissato per l'\meta{altezza} del logo è 2,5\,cm per la carta A4, e scalato proporzionalmente per carte di formato diverso; con l'argomento facoltativo si può specificare un'altezza leggermente maggiore o minore del valore predefinito. Il \meta{file del logo} o \meta{lista di nomi di file di loghi separati da virgole} è costituito da un solo nome di file o da una lista di nomi di file separati da virgole, corrispondenti ciascuno al logo di un diverso ateneo. Questi file devono avere i formati corrispondenti a una delle quattro estensioni consentite, ma non è necessario specificare il nome del file completo di estensione; questa specificazione potrebbe essere necessaria solo nel caso in cui si disponga del logo di uno stesso ateneo in diversi formati. - -Il programma codificato nel pacchetto \pack{TOPtesi} provvede a scalare tutti i loghi all'\meta{altezza} specificata e li compone affiancati su una sola riga distanziati mediante uno spazio predefinito di 3\,em; lo può impostare ad un valore leggermente maggiore o minore tramite il comando \cs{setlogodistance}, per esempio: -\begin{verbatim} -\setlogodistance{2em} -\end{verbatim} - -Se la riga di loghi, eventualmente scalati in altezza e distanziati dello spazio predefinito o esplicitamente specificato, risultasse più larga della giustezza della pagina del titolo, il programma provvede ad uno scalamento dell'intera riga di loghi in modo che non superi la giustezza della pagina. Un solo logo viene composto centrato; due o più loghi vengono ugualmente composti centrati ma distanziati come si è detto. Seguono alcuni esempi, ma si tenga presente che i loghi usati per questi esempi sono solo dei disegni creati in modo tale da avere la forma di un logo; loghi veri di diverse università non sono distribuiti insieme al sorgente di questo file, a causa delle restrizioni sulla loro proprietà legale; solo il vero logo del Politecnico di Torino appare nel frontespizio, perché questa è una pubblicazione ufficiale di quell'ateneo. Un solo logo appare come nel frontespizio di questo manuale; due loghi appaiono così:\\*[\smallskipamount] -\centerline{\logosede{logouno,logodue}\printloghi} - -Tre loghi appaiono così:\\*[\medskipamount] -\centerline{\logosede{logodue,logotre,logoquattro} -\printloghi} -\ -Quattro loghi, nonostante sia stata conservata l'\meta{altezza} predefinita, producono una riga di loghi di altezza ridotta per consentire che appaiano tutti e quattro nella stessa riga:\\*[\medskipamount] -\centerline{\logosede{logoquattro,logouno,logotre,logodue} -\printloghi} - -Si noti che il logo in testa alla pagina del frontespizio di questo documento è una esplicita richiesta espressa del Politecnico di Torino; molte altre sedi come la quasi totalità delle case editrici che mettono il loro logo nel frontespizio, lo mettono nella metà inferiore della pagina; ma la tesi di laurea o di dottorato è una documento particolare, il cui frontespizio deve soddisfare ad alcune esigenze burocratiche, e non può, quindi, soddisfare a criteri estetici molto stringenti. Per questo motivo, lo si vedrà meglio avanti, la classe \pack{TOPtesi} consente una variante del comando per creare i frontespizi, che intesta la pagina col nome dell'ateneo e mette i loghi nella metà inferiore della pagina. Se, come per il Politecnico di Torino, il nome fa parte del logo\footnote{Il logo di questo Politecnico è fatto di due parti: quella tonda di sinistra prende il nome di ``marchio'', mentre quello letterale a destra prende il nome di ``logotipo''; l'Ufficio Comunicazione e Immagine che si occupa di questi aspetti formali ha emesso una normativa specifica sui colori e le forme sia del marchio sia dei font usati per il logotipo.} non è il caso di ripetere il nome dell'ateneo nella parte alta della pagina perché vi appare già nel logotipo. -Comunque, volendo, si può inserire in testa alla pagina sia il logo, sia il nome generico dell'ateneo sia il nome proprio dell'ateneo.; si veda più avanti come fare. - -\section{Come si comincia} -Non vi sto a dire niente di come si scriva una tesi; so per -esperienza che all'inizio ci si sente sperduti davanti allo -schermo vuoto. Ma voi studenti del Politecnico, e non solo del -Politecnico, potete scaricare dal portale della didattica del sito -del Politecnico \texttt{http://didattica.polito.it} l'opuscoletto -\emph{Saper Comunicare --- Cenni di scrittura tecnico-scientifica} -dove c'è scritto più o meno tutto quel che bisogna sapere per -impostare e scrivere un rapporto tecnico-scientifico qual è la -tesi, la monografia o la dissertazione. - -Qui dirò solo come si comincia a scrivere il file sorgente della tesi. Ci sono essenzialmente due vie, ognuna delle quali offre vantaggi e svantaggi, quindi non si può dire a priori quale via sia la più indicata: -\begin{enumerate} -\item si compone un unico file come esemplificato con il file \texttt{toptesi-example.tex} -il file \texttt{toptesi-example-xetex.tex} allegati alla documentazione di \textsf{TOPtesi}. Questi file permettono di sperimentare diverse cose semplicemente mettendo o togliendo dei segni di commento all'inizio delle righe del preambolo che contengono alcuni comandi particolari. Esso è completo di bibliografia e quell'unico file permette di comporre una tesi completa; ovviamente può essere usato come modello per la vostra tesi; basta cambiare il contenuto dei comandi che contengono i nomi dei candidati, dei relatori, del titolo, dell'ateneo, della eventuale facoltà, eccetera. Ovviamente bisogna cambiare anche il contenuto dei capitoli e della bibliografia. - -\item Si spezza il file sorgente in un numero adeguato di file parziali da gestire come specificato qui di seguito; ogni file parziale conterrà solo una parte della tesi, per esempio un solo capitolo; siccome il tutto è gestito dal master file, ciascun file parziale non dovrà più contenere la dichiarazione della classe né il preambolo né le righe \verb|\begin{document}| e \verb|\end{document}|, ma solo il materiale relativo ad uno specifico capitolo cominciando appunto con la riga che ne specifica il titolo: -\verb|\chapter{Il titolo di questo capitolo}|. -Il file che contiene il capitolo può venire chiuso con il comando \verb|\endinput|, dopo il quale il file può contenere qualunque cosa che non verrà mai letta dal programma di tipocomposizione, ma per voi potrebbe essere molto utile per scrivere vostre annotazioni personali. -\end{enumerate} - -Avendo già predisposto una scaletta da seguire per comporre la -tesi e avendo dato un nome a ciascun capitolo (nome un po' più -espressivo di quelli che scriverò io qui a titolo di esempio), -predisponete un master file con un nome ``diverso'' da -\texttt{tesi.tex}; sbizzarrite la fantasia, ma che il nome sia -mnemonico e vi ricordi subito a che cosa vi riferite. Questo -master file sarà dunque composto, per esempio, così: -\begin{verbatim} -\documentclass[b5paper,11pt]{toptesi} - \includeonly{% - preliminari,% - capitolo1,% - capitolo2,% - capitolo3,% - appendici,% - bibliografia% - } -\begin{document} - \ateneo{Università di Bengodi} - \nomeateneo{La Saggezza} - \titolo{Studi di tricotetratomia applicata} - \sottotitolo{Cosa succede quando si spacca un capello in quattro} - \candidata{Maria Chiomafolta} - \relatore{prof.\ Piero Scapigliati} - \sedutadilaurea{Maggio 2015} -% - \include{preliminari} - \include{capitolo1} - \include{capitolo2} - \include{capitolo3} - \appendix - \include{appendici} - \include{bibliografia} -\end{document} -\end{verbatim} - -È da osservare in particolare che l'aver scritto l'argomento 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 -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 -tempo nella gestione dei vari file sorgente e nelle loro -correzioni. - -Il file \texttt{preliminari.tex} conterrà presumibilmente il -comando per comporre il frontespizio, il sommario, molto -facoltativamente i ringraziamenti\footnote{I ringraziamenti in una -tesi non sono quasi mai necessari; lo sono quando bisogna -ringraziare una istituzione o una o più persone \emph{esterne} -alla propria università che hanno messo a disposizione le loro -strutture o le loro competenze per lo svolgimento della tesi. Non -si ringraziano genitori, fidanzati/e, amici, e tutti i parenti di -ogni grado, il quali saranno più che contenti di sapervi laureati, -piuttosto che vedere il proprio nome scritto sulla tesi\dots. -Inoltre rappresenta un atto di piaggeria ringraziare il o i -propri relatori; essi hanno svolto un loro compito istituzionale, -non vi hanno fatto un piacere. Naturalmente questo non vieta che -la consuetudine del lavoro assieme non abbia dato origine a -sentimenti di reciproca stima e anche di amicizia, ma questa è -un'altra faccenda.} e gli indici. - -Il file \texttt{capitolo1.tex} conterrà l'introduzione e in -pratica esporrà lo stato dell'arte oltre allo scopo del lavoro e -ai risultati che si vorrebbero ottenere. - -I file \texttt{capitolo2.tex}, \texttt{capitolo3.tex}, eccetera, -conterranno la descrizione del lavoro svolto e l'analisi critica -dei risultati via via ottenuti; l'ultimo file prima delle -appendici conterrà i commenti finali, quali ad esempio un sunto dei risultati raggiunti, una breve esposizione degli ulteriori sviluppi, possibili approfondimenti, eccetera. - -Nelle varie appendici verranno raccolte le misure eseguite, gli -sviluppi matematici, i listati dei programmi, le note critiche, le -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. Da alcuni anni, 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 il programma \prog{biber} (predefinito con \pack{biblatex} dal 2012), sempre facente parte della distribuzione del sistema \TeX. I risultati che si possono ottenere sono estremamente professionali. - - -\subsection{La scelta della codifica per il file sorgente} - -Si noti che per comporre i file del corpo della tesi si possono -usare direttamente le lettere accentate della tastiera italiana o -quelle che si possono ottenere con combinazioni di tasti sia sotto -Windows sia sotto Linux o Mac~OS~X; per default \textsf{TOPtesi} -non specifica nessuna particolare codifica per l'input; ma perché -il programma di tipocomposizione elabori correttamente i file sorgente o si usa \prog{xelatex} ricordando di salvare i file con la codifica UNICODE o UTF-8, oppure non si specifica nessuna particolare codifica ma si usano solo i caratteri ASCII a -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 -\begin{verbatim} -\usepackage[utf-8]{inputenc} -\end{verbatim} -che va bene sia per le macchine Windows, sia per quelle basate su UNIX. - -Gli editor \TeX{}Shop, \TeX{}works, TeXmaker, TeXStudio, e qualcun altro, consentono di usare la codifica \texttt{utf8} che permette di inserire qualunque segno fra le decine di migliaia che la codifica UNICODE consente -- se usate \prog{xelatex} questa codifica è necessaria ma non bisogna esplicitarla nel file sorgente. Il problema, in effetti, non è la codifica, ma è la tastiera. Con sistemi operativi diversi si sono sviluppati programmi di vario genere per scrivere in alfabeti diversi da quello latino esteso, qual è quello invocato, per esempio, con l'opzione \texttt{latin1} oppure anche \texttt{utf8}. Ma se dovete scrivere la vostra tesi con brani in greco o in russo o in arabo o in lingue con segni sillabici o ideogrammi, questo problema si presenterebbe qualunque sia l'editor e il programma di composizione che usate, ed è un problema che dovete risolvere da soli. - -Bisogna notare che vanno accentate anche le lettere maiuscole; siccome la tastiera italiana non le prevede, consiglio di inserire nel preambolo la definizione del comando \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} -\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} -\E conveniente rilevare che\dots -\end{verbatim} -per ottenere: -\begin{quote} -È conveniente rilevare che\dots -\end{quote} -L'uso del pacchetto \pack{xspace} fa sì che esso, tramite il comando \verb|\xspace| inserisca 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 il vostro editor vi consente di selezionare le maiuscole accentate da una tabella oppure vi consente di usare combinazioni di tasti per inserire direttamente le maiuscole accentate nel file sorgente, fatene uso, perché la lettura del file sorgente ne guadagna moltissimo. - -Se volete o dovete usare \prog{pdflatex} dovete caricare nel vostro preambolo tutto quello che è necessario per gestire quelle lingue scritte con alfabeti diversi, ma non chiedetemi come si fa, perché so dirvelo solo per il greco. Per questa lingua, se usate l'ortografia monotonica, basta inserire l'opzione della lingua \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} -... -\languageattribute{greek}{polutoniko} -\begin{document} -... -\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 (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!!!! - -Probabilmente per usare le lingue che si scrivono in cirillico, basta specificare l'opzione della lingua, come si fa per il greco. Per alcune altre lingue bisogna invece caricare l'apposito pacchetto, il quale provvede a tutte le impostazioni necessarie; in questi casi bisogna leggere con attenzione la documentazione di quei pacchetti. - -Ma, tornando alla codifica UTF-8, il problema non è tanto l'editor che consenta o non consenta di usare quella codifica; quasi tutti i sistemi operativi consentono di installare diversi driver per la tastiera del PC, cosicché con un semplice click del mouse si può passare da un alfabeto all'altro; il problema sono i tasti della tastiera sulla cui faccia hanno serigrafato il segno che si ottiene premendo quel tasto quando è attivo il driver corrispondente a quella specifica tastiera. Non è ovviamente possibile cambiare il disegno che appare sui tasti, semplicemente cliccando per cambiare driver; forse lo si può fare con le tastiere virtuali dei PC \emph{touch screen}, ma con i PC normali questo non è possibile. Ecco quindi che la difficoltà di scrivere con un alfabeto diverso richiede una memoria ferrea per ricordare a quale segno dell'altro alfabeto corrisponda il tasto della nostra tastiera. Per il greco moderno e classico, se si usano i font di default con la codifica LGR (Local GReek), che vengono installati praticamente con ogni installazione non minimale del sistema \TeX, le corrispondenze con la tastiera latina sono studiate in modo da semplificare molto questo processo di ``memorizzazione''. Tuttavia ad una persona abituata a leggere il greco scritto (giustamente) in greco, vederlo scritto con caratteri latini fa un certo effetto; la documentazione di \textsf{babel} e quella di \textsf{teubner} ricordano questa corrispondenza fra i tasti latini e i segni greci (lettere, accenti, spiriti, segni speciali, ecc.). La corrispondenza fra greco e latino è abbastanza semplice perché il greco ha 24 maiuscole e 25 minuscole, mentre il latino ne ha 26 di ciascun tipo. Non so che cosa succeda con il cirillico che ha un alfabeto composto di più di 30 segni, per cui la corrispondenza con l'alfabeto latino è impossibile. - -Con le macchine Macintosh il sistema operativo Mac OS X mette a disposizione una specie di tastiera virtuale sui tasti della quale si può cliccare con il mouse; si possono installare diverse tastiere che possono venire intercambiate con un semplice click sulla bandierina disegnata nella barra superiore; per cui scrivere in greco politonico o un russo o in ebraico, o in\dots, non è un problema. Temo che lo sia con altre macchine e altri sistemi operativi. - -Mi dicono che sulle macchine Linux l'editor \prog{Vim} e, su tutte le macchine, l'editor \prog{emacs} prevedano delle combinazioni di tasti che consentono di scrivere sullo schermo, nella finestra del file \texttt{.tex}, direttamente in greco. Confermo di avere letto qualcosa in merito, ma non sono in grado di confermare per esperienza diretta. - -\subsection{La scelta della codifica per il file di uscita} - -Solo per scrivere in inglese non è necessario specificare nessuna codifica per i font da usare per comporre la tesi; questo è vero in quanto l'inglese, fra le lingue più comuni nel mondo occidentale, è l'unica che non fa uso di accenti o altri segni diacritici. Perciò la codifica di default \texttt{OT1} per i font di uscita adatti a scrivere in inglese va benissimo e non è necessario specificare nulla. Ma attenzione: come ho già detto se si deve inserire anche una sola parola diversa dall'inglese e che contenga un accento, o se si deve scrivere in ``middle English'', che aveva gli accenti, questa vecchia codifica non va assolutamente bene per produrre file PDF/A compatibili. Quindi anche per l'inglese sarebbe opportuno usare una codifica più avanzata. - -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 (2013) i font di default usati da 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 la collezione di font \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} -... -\usepackage[T1]{fontenc} -\usepackage{lmodern} -... -\begin{document} -... -\end{verbatim} - -Se il file viene gestito con \prog{xelatex}, oltre alla codifica \texttt{utf8} di default \emph{che non va esplicitata}, basta richiedere l'uso del pacchetto \pack{fontspec} senza ulteriori opzioni e viene automaticamente caricata ed usata la collezione dei font Latin Modern nella loro versione OpenType; a questo provvede direttamente la classe \pack{TOPtesi}. Usando \prog{xelatex}, gli appositi comandi per la selezione dei font sia testuali sia per la matematica può essere eseguita nel preambolo senza bisogno di ricaricare il pacchetto \pack{fontenc}. Volendo, invece di usare i font Latin Modern, si possono impostare facilmente altre famiglie di font con comodi comandi che fanno riferimento ai font OpenType installati sulla propria macchina. - -Naturalmente per gli utenti esperti di \LaTeX\ ci sono anche altri pacchetti usabili per impiegare altri font diversi da quelli della collezione Latin Modern, che comunque, secondo me, sono i migliori per la loro completezza; grazie al diverso disegno dei corpi minori la lettura dei pedici e degli apici ne risulta agevolata. - -Qui, per la composizione della tesi con \prog{pdflatex} segnalo solo la collezione dei font Times eXtended, richiamabili con il pacchetto \textsf{txfonts}, e la collezione dei font Palatino eXtended, richiamabili con il pacchetto \textsf{pxfonts}. I Times sono font più stretti di quelli della collezione Latin Modern e sono forse indicati per rendere più compatta una tesi un po' voluminosa. I Palatino sono un po' più larghi dei font della collezione Latin Modern e allungano la tesi di qualche pagina. Recentemente il nuovo pacchetto \pack{newtx} mette a disposizione per i Times due file \texttt{.sty}, uno per i font testuali e ono per i font matematici; sono configurabili con diverse opzioni e consentono prestazioni migliori dei font usabili con il pacchetto \pack{pxfonts}; li consiglio a coloro che vogliono usare i font Times, ma se devo dare un consiglio assoluto, direi che sia sempre preferibile usare i font Latin Modern dalle prestazioni molto migliori grazie ai corpi ottici; volendo si può usare il pacchetto \pack{cfr-lm} che consente di personalizzare fortemente qi font da usare, per esempio permettendo l'uso delle cifre minuscole {\addfontfeature{Numbers=OldStyle}{1234567890}} nel testo, e le cifre maiuscole 1234567890 nella composizione della matematica. - -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, quando si usa il motore di composizione \prog{pdflatex}, si consiglia sempre di usare la codifica \texttt{T1} anche per l'italiano; non si sa mai, ma certamente con questa codifica si hanno meno inconvenienti e le lettere accentate sono disegnate meglio. Se si usa come motore \prog{pdflatex}, è conveniente usare anche il pacchetto di estensione \pack{microtype} che consente di rendere ancora migliori le righe del testo composto; con \prog{xelatex}, invece, le funzionalità di questo pacchetto sono solo parzialmente usabili; comunque si può usare \pack{microtype} anche compilando con \prog{xelatex} anche se i miglioramenti sono meno ``vistosi'' che con \prog{pdflatex}. - - -\section{Come stampare la tesi} - -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 -meglio, cioè nei libri con i fogli stampati davanti e di dietro: -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 -uguali. Inoltre nelle testatine delle pagine stampate solo in -bianca compare sempre e solo il titolo del capitolo corrente, -mentre nelle testatine delle pagine \emph{pari} stampate in bianca -e volta compare il titolo del capitolo, mentre nelle pagine -\emph{dispari} compare il titolo del paragrafo con cui comincia la -pagina. - -Molti laureandi ritengono di fare una cosa utile stampando fronte -e retro, o, come dicono i tipografi, in bianca e volta. Certamente -è una buona idea, sia perché il fascicolo della tesi viene ad -assumere un aspetto più professionale, sia perché, ecologicamente -parlando, si consuma meno carta. - -Per questo ho cambiato le impostazioni di default della classe -\texttt{report}, sulla quale è basata la classe \texttt{TOPtesi}, -per far sì che comunque la stampa della pagina, sia essa solo in -bianca o in bianca e volta, appaia sempre con i margini laterali -uguali. - -Ho deciso per questa soluzione perché quando si rilega la tesi, -necessariamente dal lato della cucitura o dell'incollatura le -pagine sono piegate e l'insieme dei due margini interni delle -pagine affacciate appare visivamente più piccolo di ciascuno dei -margini esterni. Se si stampa solo in bianca invece sarebbe il -caso di aumentare il margine sinistro; tuttavia non ho realizzato -questo spostamento non solo perché il margine destro resta di una -certa ampiezza e può accogliere le note -marginali\marginpar{\footnotesize\sffamily\raggedright Questa è una nota -marginale}, se si decide di farne uso, ma anche perché, almeno al -Politecnico di Torino, la copia da depositare nella segreteria -didattica non deve essere realizzata su carta, ma deve essere -registrata su un CD-ROM in formato \texttt{.pdf} (o in formato -\texttt{.doc} se non si usa \LaTeX) e chi legge la -tesi sullo schermo preferisce senz'altro avere il testo centrato -piuttosto che spostato alternativamente da un lato o dall'altro -dello schermo. - -Però questa soluzione potrebbe non piacere ad alcuni laureandi, -specialmente se compongono tesi piuttosto voluminose e/o se le -rilegano con una costola piuttosto rigida. In questo caso la -classe \texttt{toptesi} accetta l'opzione \texttt{cucitura} -mediante la quale le facciate di sinistra e di destra vengono -spostate all'esterno di -7\,mm, per compensare la rigidezza della cucitura e la forte -curvatura delle pagine causate dallo spessore e/o dal tipo di -rilegatura. Questo implica che la copia da memorizzare sul CD-ROM -dovrà essere compilata senza specificare questa -opzione, che invece sarà specificata per ricomporre il file prima -della stampa su carta. - -\section{Comporre la tesi in diverse lingue} -Il pacchetto \textsf{TOPtesi} usa di default il pacchetto \texttt{babel} o il pacchetto \texttt{polyglossia} per gestire la composizione in diverse lingue. -Tuttavia la composizione in lingue diverse dall'inglese (che è la -lingua di default per una installazione ``vergine'' del sistema -\TeX) richiede che il sistema sia configurato per gestire diverse -lingue; perciò le operazioni da fare sono essenzialmente due: -\begin{enumerate} -\item configurare il sistema \TeX\ per gestire diverse lingue; -\item specificare nel comando di apertura del master file di quali altre -lingue ci si vuole servire \textcolor{red}{oltre all'italiano e all'inglese che sono già automaticamente invocati da \textsf{TOPtesi}}. Si ricorda che non si può più invocare nel preambolo il pacchetto \textsf{babel} per la gestione delle lingue una seconda volta, quando esso è già stato invocato una prima volta nel corpo della classe. Si veda nel seguito come bisogna specificare le ulteriori lingue oltre all'italiano e all'inglese. - -\end{enumerate} - - -\subsection{Configurazione iniziale} - -Per la prima parte, cioè per configurare il sistema \TeX\ per -gestire diverse lingue, subito dopo l'installazione lanciate -\LaTeX\ su un file di prova qualunque, per esempio -\texttt{sample.tex}, poi apritene il file \texttt{.log}, -nell'esempio \texttt{sample.log}; nelle prime righe di questo file -troverete le lingue per le quali il vostro sistema è già -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.4-0.9998 (TeX Live 2012) - (format=xelatex 2012.7.10) 9 SEP 2012 16:04 -entering extended mode - \write18 enabled. - file:line:error style messages enabled. - %&-line parsing enabled. -**toptesi-doc-xetex.tex -(./toptesi-doc-xetex.tex -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 per dare una idea di quello che contengono le prime righe del file in questione. Se, come è possibile, dopo la prima installazione il vostro primo file \texttt{.log} non contiene fra le lingue elencate anche l'italiano, allora questa è la cosa più urgente da fare; non vorrete mica che la vostra tesi, scritta in italiano, abbia le parole divise in sillabe in fin di riga con le regole angloamericane? Se poi siete su un programma di doppia laurea e dovete scrivere parte della tesi nella lingua dell'università straniera di cui prendete l'altro titolo, allora è necessario avere disponibile almeno anche quella lingua. Questo inghippo avviene quando si scarica una versione ridotta delle distribuzioni del sistema \TeX, oppure quando si usa la distribuzione \TeX~Live/Debian (sempre sconsigliabile per vari motivi, non escluso il fatto che l'installazione di default prevede solo la sillabazione per l'inglese). - -Le regole per inizializzare le lingue gestibili differiscono da -distribuzione a distribuzione del sistema \TeX. Leggete quindi la -documentazione che accompagna la vostra distribuzione; qui darò -alcuni cenni relativi alle distribuzioni che io conosco. - -\subsubsection{MiK\TeX} -Questa distribuzione è forse quella che più sovente viene installata nella forma ``basic'' (errore! mai installare la versione di base, perché è tutt'altro che completa) e perciò è fra quelle che hanno bisogno di essere gestite. Si apre il wizard da \texttt{Avvio\discretionary{}{|}{|}Programmi\discretionary{}{|}{|}MiKTeX\discretionary{}{|}{|}MiKTeX\textvisiblespace Settings}. Esso apre una finestra di dialogo con diverse linguette; si clicca sulla linguetta \textsf{Languages} e viene aperta un'altra finestra con l'elenco di tutte le lingue gestibili, alcune già con il segno di spunta alla loro sinistra nell'apposito quadratino, altre senza il segno di spunta. Potete cliccare per togliere il segno di spunta sulle lingue già spuntate, ma che non userete mai, e potete aggiungere il segno di spunta cliccando nel quadratino corrispondente alle lingue desiderate. - -Poi uscite dal dialogo per la scelta delle lingue cliccando \texttt{OK} e tornate sulla linguetta \textsf{General}; qui trovate due bottoni il primo dei quali serve per aggiornare il database dei nomi dei file, mentre il secondo serve per re-inizializzare i file di formato, cioè quei file che contengono già la traduzione in linguaggio macchina di tutte le operazioni che la vostra distribuzione del sistema \TeX\ è capace di compiere con i suoi vari applicativi. La divisione in sillabe è una di quelle operazioni che deve essere inizializzata, perché richiede strutture dati particolari che sarebbe troppo lungo generare di volta in volta. Cliccate sul bottone per re-inizializzare i file di formato; alla fine di questa operazione 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{\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{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 - - -\subsubsection{Distribuzioni commerciali} -Le distribuzioni commerciali differiscono da quelle gratuite essenzialmente per i programmi accessori che accompagnano la distribuzione del sistema \TeX\ che, di sua natura, è gratuito; il costo delle distribuzioni commerciali corrisponde al valore delle parti accessorie, all'assistenza per i clienti, eccetera. - -Fra le parti accessorie in generale ci sono anche i programmi realizzati attraverso comode interfacce grafiche per la inizializzazione e l'aggiornamento del software. - -Perciò con queste distribuzioni bisogna leggere il manuale di istruzioni e provvedere corrispondentemente. - -\subsection{Le lingue della tesi} - -Di default \textsf{TOPtesi} compone la tesi in italiano e per scrivere la tesi in italiano non occorre altro. - -Se si devono inserire nella tesi brani di testo in lingua straniera, ma lasciando la struttura della tesi in italiano, se si usa \prog{pdflatex} basta elencare fra le altre opzioni nel comando di apertura del master file i nomi (inglesi) delle lingue da usare; per esempio, per inserire brani in francese si scriverà: -\begin{verbatim} -\documentclass[12pt,twoside,french]{toptesi} -\end{verbatim} - -Se invece si vuole scrivere la tesi in inglese, lingua già inserita di default in \textsf{TOPtesi}, ma non attivata, bisogna dare l'indicazione esplicita dopo l'inizio del documento così: -\begin{verbatim} -\documentclass[11pt,cucitura]{toptesi} -... -\begin{document} -\english -... -\end{verbatim} - -\begin{sloppypar} -Per commutare dall'italiano all'inglese e viceversa basta alternare le dichiarazioni \verb|\italiano| e \verb|\english|. Attenzione: queste dichiarazioni alterano anche le parole come Chapter o Capitolo, Table o Tabella, quindi per inserire brani nell'altra lingua è opportuno servirsi dei comandi di \texttt{babel}, in particolare l'ambiente \texttt{otherlanguage}, per esempio: -\begin{verbatim} -... disse: -``\begin{otherlanguage}{english} - Mr Livingstone, I suppose\dots -\end{otherlanguage}'' -e si strinsero la mano. -\end{verbatim} -\end{sloppypar} - -L'ambiente \texttt{otherlanguage} è adatto per citazioni relativamente lunghe; per citazioni brevi, come quella dell'esempio, sarebbe meglio usare così il comando -\verb|\foreignlanguage|: -\begin{verbatim} -disse: ``\foreignlanguage{english}{Mr Livingstone, I suppose\dots}'' -e si strinsero la mano. -\end{verbatim} - -Con il programma \prog{xelatex} le lingue ausiliarie, oltre l'italiano e l'inglese già preinstallate in \pack{TOPtesi}, basta specificare nel preambolo, per esempio: -\begin{verbatim} -\setotherlanguages{french,spanish} -\end{verbatim} -Oppure, se la lingua richiede un alfabeto speciale, se ne può specificare il font specifico e prescrivere, per esempio: -\begin{verbatim} -\newfontfamily{\greekfont}{GFS Didot} -... -\setotherlanguage[variant=ancient]{greek} -\end{verbatim} -Ciò fatto si dispone per ogni lingua, tranne quella principale, di un ambiente dal nome uguale alla lingua, che all'occorrenza seleziona anche il font specifico, la cui famiglia abbia un nome che comincia con lo stesso nome della lingua. Per esempio: -\begin{verbatim} -\begin{greek} -Οἰόνται τινές, βασιλεῦ Γέλων, τοῦ ψάμμον τὸν ἀριθμὸν ἄπειρον εἶμεν -τῷ πλήθει· λέγω δὲ οὐ μόνον τοῦ περὶ Συρακούσας τε καὶ τὰν ἄλλαν -Σικελίαν ὑπάρχοντος, ἀλλὰ καὶ τοῦ κατὰ πᾶσαν χώραν τάν τε οἰκημέναν -καὶ τὰν ἀοὶκητον. -\end{greek} -\end{verbatim} -Anche usando \prog{xelatex} bisogna definire i comandi \verb|\sommario| e \verb|\ringraziamenti| nella stessa maniera illustrata qui di seguito per comporre con il programma \prog{pdflatex}. - -Invece per comporre la tesi in una lingua diversa dall'italiano e dall'inglese bisogna lavorare un pochino di più perché bisogna ridefinire alcune cose; per esempio per scrivere la tesi in spagnolo bisogna agire così: -\begin{verbatim} -\documentclass[12pt,spanish]{toptesi}% <--- la lingua come opzione - % della classe! -\ExtendCaptions{spanish}{Resumen}{Agradecimientos} -\newcommand*{\spagnolo}{\selectlanguage{spanish}}% -... -\begin{document} -\spagnolo -... -\end{document} -\end{verbatim} - -Ovviamente le parole ``Resumen'' (Sommario) e ``Agradecimientos'' (Ringraziamenti) andranno scelte accuratamente; io ho indicato solo ciò che ho trovato sul vocabolario. - -È anche possibile servirsi del file di configurazione; per esempio le definizioni dei comandi suddetti possono venire scritte nel file di configurazione e alternando i comandi \verb|\italiano|, \verb|\english| e \verb|\spagnolo| si possono alternare le regole di sillabazione oltre a cambiare le parole \emph{infix}, come Chapter, Capitolo, Capítulo, eccetera. - -Se si usa \prog{xelatex} ci si ricordi che il pacchetto \pack{polyglossia} è già caricato dalla classe \pack{TOPtesi}, che provvede già a dichiarare l'italiano come lingua principale e l'inglese come lingua accessoria; si possono nominare nel preambolo della tesi diverse altre lingue accessorie, per esempio: -\begin{verbatim} -\setotherlanguages{french, spanish} -\end{verbatim} -e per le lingue che richiedono un trattamento particolare si usa un comando simile (al singolare), per esempio: -\begin{verbatim} -\setotherlanguage[variant=ancient]{greek} -\end{verbatim} - -Per scrivere in lingue che implicano alfabeti diversi da quello latino, ovviamente, bisogna aver curato di disporre di una configurazione del sistema \TeX\ completa anche dei font che servono. Non dovrebbero esserci problemi con il cirillico e con il greco; per altri alfabeti e per le lingue che si scrivono da destra a sinistra bisogna ovviamente disporre dei pacchetti necessari. Si tenga presente che le versioni moderne del sistema \TeX\ \emph{non} usano come interprete il programma originario di Knuth, ma la sua estensione che in origine si chiamava $\epsilon$\TeX; la variante che produce il file del documento composto in formato \texttt{.pdf} si chiama \prog{pdftex}, ma questa versione comprende tutte le estensioni di $\epsilon$\TeX. Bene, queste estensioni servono anche per gestire le lingue con scrittura retrograda pur di disporre dei pacchetti relativi a queste lingue. - -Anche \prog{xelatex} è in grado di gestire le lingue retrograde ed è capace con modesti adattamenti di comporre in verticale (cinese, giapponese,\dots). - -\chapter{I comandi specifici introdotti da \textsf{TOPtesi}} - -\section{Introduzione} - -I comandi specifici introdotti da \textsf{TOPtesi} si aggiungono a -tutti quelli definiti da \LaTeX\ e dalla sua classe standard -\texttt{report}; mentre questi sono tutti in inglese o sono -abbreviazioni inglesi, i comandi introdotti da \textsf{TOPtesi} sono -prevalentemente in italiano o sono abbreviazioni italiane. - -Questi comandi sono di diverse categorie; alcuni si possono usare solo -in modo matematico altri solo in modo testo; alcuni solo nel preambolo, -alcuni hanno senso solo durante la composizione del testo; alcuni -servono solo per il frontespizio. Essi saranno descritti nei paragrafi -seguenti. - -\section{Le opzioni} -La classe \pack{TOPtesi} accetta diverse opzioni nel -comando di dichiarazione della classe; negli esempi esposti ne sono -state usate diverse, ma qui forse vale la pena di elencarle tutte -in ordine, senza ripetere le opzioni già presenti di default per -la classe \texttt{report}. - - -\begin{description}\def\Item[#1]{\item[\normalfont\texttt{#1}]} -\Item[chapterbib] serve per specificare che si desidera la composizione della bibliografia alla fine di ogni capitolo; la bibliografia va composta a mano; se si desidera comporla con \textsc{Bib\TeX} si invochi invece il pacchetto \texttt{chapterbib.sty} con il solito comando \verb|\usepackage|. Si abbia cura di leggere attentamente la documentazione di quel pacchetto. -% -\Item[classica] Serve per usare delle denominazioni un po' diverse -dei comandi e per dare una forma diversa al loro contenuto; il -frontespizio ne viene un poco modificato con un look più adatto -alle tesi in discipline classiche. Si veda la -tabella~\ref{tab:front5} per i nuovi comandi disponibili. -% -\Item[cucitura] Serve per spostare il testo scritto verso l'esterno -quando si teme che la piegatura delle pagine verso il centro del -fascicolo rilegato possa impedire la lettura agevole delle parole -vicino al margine interno. -% -\Item[14pt] Aumenta la possibilità di scelta del corpo normale per -la composizione della tesi; può contribuire a migliorare la -lettura quando il testo è fitto di notazioni molto articolate, ma in -generale il corpo così grande è un trucco per rimpolpare una -tesi di modeste dimensioni; ne sconsiglio l'uso per questo secondo -scopo. Avverto che con un corpo così grande è facile che certe -righe risultino troppo lunghe e vadano a capo in punti non -adeguati e producano delle righe non giustificate con i messaggi -d'errore ``Overfull hbox''; questo è un altro motivo per il quale -sconsiglio di usare questa opzione, se non quando è strettamente -necessario. Se la si usa, si verifichi che il titolo, i titoli dei -capitoli, quelli dei paragrafi, eccetera siano composti -correttamente. In particolare il titolo della tesi e i titoli dei -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 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|. -% -\Item[autoretitolo] {\leavevmode\tolerance=9999 Questa opzione funziona solo se viene -specificata anche l'opzione \texttt{classica}; se la si inserisce -senza specificare \texttt{classica}, non succede nulla di male, -semplicemente la classe informa di aver trovato delle opzioni che -né lei né altri pacchetti hanno usato. Serve per comporre la -testatina di sinistra sulle pagine pari con l'indicazione del -candidato e del titolo della tesi. È ovvio che il titolo della -tesi con questa opzione deve essere molto breve, ed è per questo -che è stato messo a disposizione dello studente l'argomento -facoltativo del comando \verb|\titolo| che consente di specificare -un titolo di tre o quattro parole (brevi) ma di senso compiuto, -che possa sostituire il titolo normale, specialmente se questo è -un po' lungo.\par} -% -\Item[oldstyle] Anche questa opzione funziona solamente insieme -all'opzione \texttt{classica}; serve per scrivere i numeri delle -pagine con i numeri all'antica, cioè con segni di altezze e -profondità diverse; si confronti \oldstylenums{1234567890} con -1234567890. -% -\Item[pdfa] Serve per attivare la composizione di un file PDF che possa passare la verifica per la certificazione del formato PDF/A. Attenzione: si ricorda che questa operazione viene eseguita tramite l'uso del file \texttt{pdfx.sty} che a sua volta richiama il file \texttt{hyperref.sty} con la giusta opzione per il formato PDF/A. Eventuali personalizzazioni per configurare gli stili di composizione dei link generati da \texttt{hyperref.sty} devono essere dichiarate subito dopo la dichiarazione della classe. Se si specificano queste personalizzazioni, ma non è stata data l'opzione \texttt{pdfa}, viene prodotto un errore terminale. Inoltre bisogna ricordarsi di predisporre il file \texttt{.xmpdata} oppure \texttt{-def.ps} contenente i \emph{metadata} relativi al documento specifico come si è già spiegato in precedenza. -\end{description} - - -\section{Comandi di tipo generale} -I comandi di tipo generale si possono usare in ogni contesto, in -particolare alcuni sono fatti per essere usati sia in modo testo sia in -modo matematico. Essi sono raccolti nella tabella~\ref{tab:generale}. - -\begin{table}\def\V{\rule{0pt}{2.5ex}} -\def\cs#1{\texttt{\string#1}} -\centering \footnotesize -\begin{tabular}{llp{.26\textwidth}p{.30\textwidth}} - \hline - Comando\V & Default & Scopo & Esempio d'uso \\[.5ex] - \hline - \cs{\interlinea\{...\}} & - 1.0 & Modifica l'argomento di - \cs{\linespread}\newline \textcolor{red}{NON usare se non - costretti con la forza!}\newline Modo testo - &\cs{\interlinea\string{1.05\string}} \newline - oppure \newline - \cs{\begin\string{interlinea\string}\{1.05\}}\newline - \dots\newline - \cs{\end\{interlinea\}}\newline - Vedi annotazioni sull'\hskip0pt interlinea nel testo \\ -\cs{\ohm} & & Omega ``diritto''\newline - Modi testo e matematico & \texttt{45\string\ohm}\\ -\cs{\ped\string{...\string}}& - nessuno & Pedice in tondo\newline - Modi testo e matematico & \texttt{\string$V\string\ped\string{eff\string}\string$} \\ -\cs{\unit\string{...\string}}& - nessuno & Unità di misura in - tondo unite al numero\newline - Modi testo e matematico & - \texttt{15\string\unit\string{k\string\ohm\string}} \\ -\cs{\gei} & & Unità immaginaria in - tondo \newline - Solo modo matematico & - \texttt{\string$\string\eu\string^\string{\string\gei\string\omega\ t\string}\string$} \\ -\cs{\eu} & & Numero ``e'' in tondo\newline Solo modo matematico & - \texttt{\string$\string\eu\string^\string{\string\gei\string\omega\ t\string}\string$} \\ -\cs{\gradi} & & circoletto alzato\newline Modo testo e - matematico & - \texttt{27\string\unit\string{\string\gradi\ C\string}} \\ -\cs{\listing\string{...\string}}& - nessuno & Listato di un programma in caratteri typewriter & - \texttt{\string\listing - \string{toptesi.tex\string}}\\ -\cs{\blankpagestyle\{...\}}&plain & impostazione dello stile della pagina eventualmente - emessa da \cs{\cleardoublepage} quando deve passare ad una - pagina dispari in composizione fronte retro - & \cs{\blankpagestyle\{empty\}} - \\[.5ex] -\hline -\end{tabular} -\caption{Comandi di tipo generale}\label{tab:generale} -\end{table} - -Vale la pena di commentare sull'uso dell'ambiente \texttt{interlinea} e del comando \cs{in\-terlinea}. - -Il primo confina il suo effetto all'interno dell'ambiente da lui -stesso formato; il secondo agisce come una dichiarazione che resta -in vigore finché una dichiarazione contraria non ne modifica il -valore. - -\textcolor{red}{Tuttavia sia l'ambiente sia il comando non dovrebbero essere mai usati!} -La composizione tipografica non ha nulla a che vedere con la -composizione dattilografica (\emph{absit iniuria verbis}!). -Quest'ultima si faceva con mezzi avanzati per l'epoca, ma oggi quei -mezzi sono del tutto obsoleti; le poche macchine da scrivere -meccaniche o elettromeccaniche che esistono ancora fuori da qualche -museo, vengono usate per riempire formulari o compilare le informazioni -sui documenti cartacei che sopravvivono alla invasione delle carte -plastificate; ma tolti gli usi burocratici non mi viene in mente nessun -altro uso degno di nota. - -La composizione tipografica esige un perfetto equilibrio fra il corpo del font usato e la distanza fra due righe successive, distanza che prende il nome tecnico di \emph{avanzamento di riga}, ma spesso chiamato \emph{interlinea}; questo avanzamento a seconda del font in uso può essere dal 10\% al 20\% maggiore del corpo del font usato. - -Questa documentazione è scritta in corpo 12\,pt e l'avanzamento di riga è di 14,5\,pt; si dice che questo testo è composto in corpo 12/14,5. - -\begin{interlinea}{1.05} -L'interlinea era originariamente lo spazio aggiuntivo da inserire fra una linea e l'altra; quando la composizione tipografica era eseguita con font ricavati da punzoni metallici, l'interlinea era la striscia di metallo che veniva interposta fra una riga di caratteri metallici e la successiva. Il comando \texttt{\string\interlinea} e l'ambiente corrispondente hanno pertanto dei nomi che si rifanno alla tipografia tradizionale, ma vengono usati come in dattilografia. In effetti l'argomento del comando e dell'ambiente serve solo come fattore moltiplicativo dell'avanzamento di riga; porre questo fattore al valore \texttt{1.05} vuol dire moltiplicare l'avanzamento di riga per 1,05 portandolo quindi al valore di 15,5225\,pt. Questo capoverso è composto con questo fattore impostato con l'ambiente \texttt{interlinea} e, nonostante si tratti solo di un aumento del 5\% dell'avanzamento di riga, l'occhio lo percepisce in modo più grande di quanto non faccia pensare il suo piccolo valore. -\end{interlinea} - -L'avanzamento di default scelto per i caratteri in uso è -l'avanzamento otticamente ottimale; se desideraste usare un font -diverso da quello di default, potreste, per esempio, invocare il -pacchetto \texttt{pxfonts} per usare il Palatino esteso come font -di testo. Siccome questo font a pari corpo ha le minuscole -decisamente più grandi di quelle dei font di default, potrebbe -essere una idea sensata quello di sperimentare con diversi valori -del fattore di \texttt{interlinea}, ma poi si scoprirebbe che -questo fattore differirebbe di pochi centesimi dall'unità e quindi -ci sarebbe da domandarsi se ne valga la pena. - -Se proprio volete stampare delle bozze su carta scritte abbastanza -larghe per potervi inserire le correzioni e le annotazioni a mano, -allora impostate il fattore di \texttt{interlinea} al massimo a -\texttt{1.5}, ma quando stampate la bella copia, la versione finale, -ricordatevi di re-impostare per \texttt{interlinea} il valore unitario -di default. - -Tra l'altro non vorreste mica usare l'espediente di un grande fattore -di interlinea solo per rimpolpare una tesi dal volume modesto? Esso -sarebbe un espediente talmente puerile che sarebbe scoperto al primo -sguardo. Ricordate che ci sono state in passato tesi che non superavano -le 30~pagine dattiloscritte o scritte a mano (!) e sulle quali si sta -studiando ancora oggi dopo più di 50~anni! - -Vale la pena di commentare il misterioso comando \cs{blankpagestyle}. Quando si compone fronte e retro senza usare l'opzione di classe \texttt{openright}, i capitoli vengono sempre aperti nelle pagine di destra, cioè nelle pagine dispari. Per fare questo il comando \cs{chapter} agisce eseguendo subito il comando \cs{cleardoublepage} che, fra le altre cose, controlla se la nuova pagina su cui scrivere il titolo del capitolo sia dispari. Se non lo fosse provocherebbe la stampa di una pagina ``bianca''; bianca nel senso che non contiene testo ma contiene la testatina e il piedino. -fino alla versione 0.62, questa eventuale pagina bianca prima dell'apertura di un nuovo capitolo conteneva la testatina e il piedino; d'accordo nel piedino c'è solo il numero della pagina, e ci può stare, ma nella testatina rimaneva il titolo del capitolo precedente: tipograficamente molto antiestetico ed errato. Ora di default questa pagina bianca viene composta solo con il piedino che, ricordiamo, contiene solo il numero della pagina. Alcuni preferiscono che questa pagina bianca sia bianca per davvero e non contenga nemmeno il piedino; ecco, in questo caso basta specificare: -\begin{flushleft}\ttfamily -\string\blankpagestyle\{empty\} -\end{flushleft} -e il problema è risolto. Volendo si potrebbe specificare il nome di qualunque altro stile di pagina già definito, ma ad essere franchi non vedo alternative fra lo stile \texttt{plain} o \texttt{empty} e gli altri stili che contengono sempre le testatine, eventualmente ridotte al solo loro filetto. - -Se lo si vuole usare, consiglio di farlo subito dopo \verb|\begin{document}|. - - -\section{Comandi per il frontespizio} - -I comandi per la composizione del frontespizio \emph{possono} essere tutti inseriti nel preambolo, cioè prima di \verb|\begin{document}| se si compone con il programma \prog{pdflatex}, mentre \emph{debbono} essere inseriti dopo il preambolo, ma prima del comando \verb|\frontespizio| (con o senza asterisco), se si compone con \prog{xelatex}. - -\begin {table}[p] -\def\V{\rule{0pt}{2.5ex}} -\def\cs#1{\texttt{\string#1}}\let\s\string -\def\d{\discretionary{\%}{}{}} -\makebox[\textwidth]{\tolerance=9999\finalhyphendemerits=0\relax% -\begin {tabular}{p{.3\textwidth}p{.2\textwidth}p{.2\textwidth}p{.25\textwidth}} -\toprule -Comando & Default & Scopo & Esempio d'uso \\ -\midrule -\cs{\ateneo\s{...\s}}\V&POLITECNICO DI TORINO& Definisce il nome generico dell'Ateneo & - \cs{\ateneo\{II Università di Roma\}} \\ -\cs{\nomeateneo\s{...\s}}& nessuno& Definisce il nome proprio dell'Ateneo & - \cs{\nomeateneo\{Tor Vergata\}} \\ -\cs{\facolta[...]\s{...\s}}& nessuno & Definisce il nome della -Facoltà opzionalmente con l'indicazione dell'ordinale& - \cs{\facolta[III]\d\{Scienze\}} \\ -\cs{\struttura} && sinonimo del comando \cs{\facolta}&\\ -\cs{\corsodilaurea\s{...\s}}& nessuno& Definire il nome del corso di laurea & - \cs{\corsodilaurea\d\{Fisica\}} \\ -\cs{\corsodidottorato\{...\}}& nessuno&Definisce il nome del corso di dottorato& - \cs{\corsodidottorato\d\{Fisica\}} \\ -\cs{\monografia\{...\}}&nessuno&Definisce il titolo della monografia e imposta lo stile del frontespizio& - \cs{\monografia\d\{Il~teorema di Eulero\}}\\ -\cs{\titolo[...]\{...\}}&nessuno&Definisce il titolo della tesi o della dissertazione& - \cs{\titolo\d[La~pressione]\d\{La~pressione di Giove\}}\\ -\cs{\sottotitolo\{...\}}&nessuno&Definisce il sottotitolo della tesi o della dissertazione& - \cs{\sottotitolo\{Metodo Barometrico\}} \\ -\cs{\Materia\{...\}}&nessuno&Definisce la materia su cui verte la tesi & - \cs{\Materia\{Remote Sensing\}} \\ -\cs{\materia\{...\}}&nessuno&sinonimo del comando \cs{\Materia} & - \cs{\materia\d\{Letteratura ostrogota\}} \\ -\bottomrule -\end{tabular}} -\caption{Comandi per il frontespizio della monografia di laurea, della -tesi di laurea e della dissertazione di dottorato -(\emph{continua})}\label{tab:front1} -\end{table} - -\addtocounter{table}{-1} -\begin{table}[p] -\def\V{\rule{0pt}{2.5ex}} -\def\cs#1{\texttt{\string#1}}\let\s\string -\def\d{\discretionary{\%}{}{}} -\makebox[\textwidth]{% -\begin {tabular}{p{.3\textwidth}p{.2\textwidth}p{.2\textwidth}p{.25\textwidth}} -\toprule -Comando & Default & Scopo & Esempio d'uso \\ -\midrule -\cs{\relatore\{...\}}\V&nessuno& Definisce il nome del relatore& - \cs{\relatore\d\{prof.\s~Albert Einstein\}} \\ -\cs{\secondorelatore\{...\}}&nessuno&Se c'è, definisce il nome del secondo relatore& - \cs{\secondorelatore\d\{dott.\s~Grazia Deledda\}}\\ -\cs{\terzorelatore\{...\}}&nessuno&Se c' è, definisce il nome del -terzo relatore& - \cs{\terzorelatore\d\{ing.\s~Thomas A.\s~Edison\}}\\ -\cs{\direttore\{...\}}&nessuno&Definisce il nome del direttore del ciclo di dottorato& - \cs{\direttore\d\{prof.\s~Albert Enstein\}}\\ -\cs{\coordinatore\{...\}}&nessuno&Definisce il nome del coordinatore del ciclo di dottorato& - \cs{\coordinatore\d\{prof.\s~Albert Einstein\}}\\ -\small\cs{\QualificaDirettore\{...\}}& Direttore o Coordinatore& Definisce il titolo da inserire - prima del nome del direttore della scuola di dottorato& - \cs{\Qualifica\d Direttore\{PhD Director\}}\\ -\cs{\tutore\{...\}}&nessuno&Definisce il nome del tutore& - \cs{\tutore\d\{prof.\s~Karl Von Braun\}} \\ -\cs{\tutoreaziendale\{...\}} & nessuno& Definisce la qualifica del tutore aziendale & - \cs{\tutoreaziendale\d\{Supervisore\}}\\ -\cs{\candidato\{...\}}&nessuno&Definisce il nome del candidato& - \cs{\candidato\{Galileo Galilei\}} \\ -\cs{\candidata\{...\}}&nessuno&Definisce il nome della candidata& - \cs{\candidata\{Maria Curie\}} \\ -\cs{\secondocandidato\{...\}}&nessuno&Se c'è , definisce il nome -del secondo candidato& - \cs{\secondocandidato\d\{Evangelista Torricelli\}}\\ -\cs{\secondacandidata\{...\}}&nessuno&Se c'è , definisce il nome -della seconda candidata& - \cs{\secondacandidata\d\{Rita Levi Montalcini\}}\\ -\bottomrule -\end{tabular}} -\caption{Comandi per il frontespizio della monografia di laurea, della -tesi di laurea e della dissertazione di dottorato (\emph{continua})}\label{tab:front2} -\end{table} - -\addtocounter{table}{-1} -\begin{table} -\def\V{\rule{0pt}{2.5ex}} -\def\cs#1{\texttt{\string#1}}\let\s\string -\def\d{\discretionary{\%}{}{}} -\makebox[\textwidth]{% -\begin {tabular}{p{.3\textwidth}p{.2\textwidth}p{.2\textwidth}p{.25\textwidth}} -\toprule -Comando & Default & Scopo & Esempio d'uso \\ -\midrule -\cs{\terzocandidato\{...\}}&nessuno& Se c'è, definisce il nome del -terzo candidato& - \cs{\terzocandidato\d\{Alessandro Volta\}} \\ -\cs{\terzacandidata\{...\}}&nessuno&Se c'è, definisce il nome della terza candidata& - \cs{\terzacandidata\d\{Eleonora Duse\}}\\\cs{\sedutadilaurea\{...\}}\V&data corrente &Definisce il mese e l'anno (volendo il giorno) della seduta di laurea& - \cs{\sedutadilaurea\d{Dicembre~2005}}\\ -\cs{\esamedidottorato\{...\}}&data corrente&Definisce il mese e l'anno (volendo il giorno) della seduta di discussione& - \cs{\esamedidottorato\d\{Febbraio~2013\}}\\ -\small\cs{\scuoladidottorato\{...\}}& SCUOLA DI DOTTORATO&Definisce il nome ufficiale della - scuola di dottorato & \cs{\scuoladidottorato\d\{SCUDO\}}\\ -\cs{\ciclodidottorato\{...\}}&nessuno&Definisce il numero ordinale del ciclo di dottorato& - \cs{\ciclodidottorato\d\{XV~ciclo\}} \\ -\cs{\logosede[...]\{...\}}&nessuno&\raggedright Inserisce nel frontespizio il logo - dell'ateneo, specificandone opzionalmente l'altezza - (default: 3\,cm)& - \cs{\logosede\d[2cm]\{logounio,\d logodue\}}\\ -\cs{setlogodistance}\{...\}& 3\,em & imposta la distanza fra i loghi& \setlogodistance{25mm}\\ -\midrule -\cs{\retrofrontespizio}& nessuno& \multicolumn2{p{.5\textwidth}}{Se specificato, serve - solitamente per scrivere nel verso - della pagina del frontespizio alcune dichiarazioni di - carattere legale; accetta un argomento composto anche da - diversi capoversi}\\ -\bottomrule -\end{tabular}} -\caption{Comandi per il frontespizio della monografia di laurea, della -tesi di laurea e della dissertazione di dottorato. Comando per comporre il verso del frontespizio.}\label{tab:front3} -\end{table} - - -\begin{table}[p]\tabcolsep=3pt -\def\V{\rule{0pt}{2.5ex}} -\def\cs#1{\texttt{\string#1}}\let\s\string -\def\d{\discretionary{\%}{}{}} -\def\serve{definisce una stringa equivalente a } -\makebox[\textwidth]{\small% -\begin{tabular}{@{}p{.35\textwidth}p{.63\textwidth}@{}} -\toprule -\cs{\FacoltaDi\{...\}}\V & definisce una stringa con il nome generico della - struttura didattica, per esempio ``Scuola di~'', - prima del nome della struttura; di default è - impostata una stringa nulla, cosicché non viene - scritto nulla nel frontespizio in merito alla struttura - didattica competente\\ -\cs{\StrutturaDidattica\{...\}} & sinonimo del comando \cs{\FacoltaDi}\\ -\cs{\DottoratoIn\{...\}} & \serve ``Dottorato in'' prima del nome del dottorato\\ -\cs{\CorsoDiLaureaIn\{...\}} & \serve ``Corso di Laurea in'' prima del nome del corso di laurea\\ -\cs{\TesiDiLaurea\{...\}} & \serve ``Tesi di Laurea''\\ -\cs{\NomeMonografia\{...\}} & \serve ``Monografia di Laurea''\\ -\cs{\NomeDissertazione\{...\}} & \serve ``Dissertazione di Dottorato''\\ -\cs{\InName\{...\}} & \serve ``in''; in tedesco potrebbe essere ``auf'', in francese ``en'', ecc.\\ -\cs{\CandidateName\{...\}} & \serve ``Candidato''; per questo e i due comandi - successivi il programma riesce - a scegliere la stringa giusta adattata in numero e genere; - nel cambiare queste stringhe - il compositore ha una sola possibilità e deve scegliere - direttamente il genere e il numero.\\ -\cs{\AdvisorName\{...\}} & \serve ``Relatore''\\ -\cs{\CoAdvisorName\{...\}} & \serve ``Correlatore''; questo comando si può usare - sempre, ma il suo contenuto viene effettivamente usato - solo se si specifica l'opzione \texttt{classica}; se in - italiano non piace ``Correlatore'' ma si preferisce - ``Corelatore'' o ``Co-relatore'', sempre con l'opzione - \texttt{classica}, si può correggere la versione di - default.\\ -\cs{\TutorName\{...\}} & \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{\CycleName\{...\}} & \serve ``ciclo''; serve essenzialmente per indicare il - ciclo di dottorato\\ -\cs{\NomePrimoTomo\{...\}} & \serve ``Tomo primo''\\ -\cs{\NomeSecondoTomo\{...\}} & \serve ``Tomo secondo''\\ -\cs{\NomeTerzoTomo\{...\}} & \serve ``Tomo terzo''\\ -\cs{\NomeQuartoTomo\{...\}} & \serve ``Tomo quarto''; tutte e quattro queste stringhe - dipendono dalla lingua usata e dall'ordine che si vuole o - si deve dare alle due parole.\\ -\bottomrule -\end{tabular}} - \caption{Comandi per modificare le parole e/o le brevi frasi scritte -nel frontespizio o per cambiare le parole italiane di default in altre -parole diverse, o per esprimere gli stessi concetti in un'altra -lingua}\label{tab:front4} -\end{table} - -I comandi di questa sezione possono essere introdotti in un ordine qualunque, ma è più chiaro se sono introdotti nell'ordine in cui sono elencati. - -Essi possono anche essere scritti nel file di configurazione -\meta{mainfile}\texttt{.cfg}, anzi, direi che è meglio che siano inseriti -in quel file, lasciando nel preambolo solo quelli che cambiano i -valori di default o che inseriscono informazioni non presenti di -default. - -Alcuni comandi sono generali; altri si riferiscono specificatamente -alla monografia di laurea, alla tesi laurea, o alla dissertazione di -dottorato. - -La differenza è che generalmente la monografia di laurea non ha -un relatore; se nella vostra facoltà anche la monografia di laurea -ha un relatore comportatevi come per la tesi di laurea. Se nel -vostro ateneo o nella vostra facoltà succede così, allora inserite -nel file di configurazione il seguente comando -\begin{verbatim} -\TesidiLaurea{Tesi di Laurea} -\end{verbatim} -Per la tesi del secondo ciclo aggiungete dopo la parola ``laurea'' l'indicazione ``specialistica'', oppure ``magistrale'' se così è l'uso nella vostra facoltà o nel vostro ateneo. - -Similmente cambiate le stringhe inserite dai vari comandi facendo ampio uso -di quelli esposti nelle tabelle~\ref{tab:front1}--\ref{tab:front4}; in -particolare inseriteli nel file di configurazione, specialmente se devono -rappresentare delle modifiche ``permanenti''. \textcolor{red}{Usateli -anche per predisporre quelle stringhe in una lingua diversa -dall'italiano}. - -Per comporre questo testo si è usata la classe \pack{TOPtesi}, -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 -che illustrano l'impiego di diversi fra i comandi descritti nelle -tabelle citate\footnote{In verità ho imbrogliato un poco. I comandi qui elencati producono un frontespizio molto simile a quello effettivamente presente in questo documento, ma non esattamente identico; in fondo questo documento non è una vera monografia di laurea, quindi mi sono permesso qualche lieve ``abbellimento''. Questo esempio, tra l'altro, mostra come mettere sia il logo sia il nome generico dell'ateneo in testa alla pagina.}: -\begin{verbatim} - \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} - \ateneo{Politecnico di Torino} - \logosede{logo_blu} - - \frontespizio -\end{verbatim} - -Vale la pena di fare le seguenti osservazioni: -\begin {itemize} -\item se si usa il comando \cs{frontespizio} il logo viene messo in testa; se si usa la forma asteriscata \cs{frontespizio*} il logo viene messo nella metà inferiore della pagina del titolo. Se il logo dell'ateneo confine per disteso il logotipo, cioè il nome per disteso, allora l'uso del comando \cs{ateneo} contenente il nome generico dell'ateneo implica una ridondanza di informazioni che potrebbe anche essere antiestetica; quid i, contrariamente a quanto si è fatto nella pagina del titolo di questo documento, -se si usa il comando \cs{ateneo} sarebbe meglio usare il comando \cs{frontepizio*}, e viceversa. ma questa elasticità di scelta per la posizione del logo e la presenza del nome dell'ateneo consente di rispettare le diverse specifiche indicate dalle segreterie didattiche degli atenei. -% -\item \texttt{\string\titolo} non deve -essere usato per la monografia (ma \texttt{\string\sottotitolo} si -può usare, come si è fatto per il frontespizio di questo -manuale); per la monografia il comando \texttt{\string\monografia} -imposta sia il titolo sia le altre informazioni che distinguono la -monografia da una tesi di laurea magistrale. -% -\item Il comando \texttt{\string\titolo} accetta un argomento facoltativo, la versione breve del titolo del frontespizio; serve con l'opzione \texttt{classica} e l'opzione \texttt{autoretitolo}, dove il titolo breve va nella testatina delle pagine; se il titolo del frontespizio fosse troppo lungo la testatina verrebbe molto male! -% -\item Non dare i comandi \texttt{\string\relatore}, \texttt{\string\secondorelatore} -e \texttt{\string\terzorelatore} né per la dissertazione di dottorato né per la monografia. -% -\item L'indicazione della materia su cui si svolge la tesi di laurea o di dottorato non viene normalmente indicata se non, talvolta, nelle facoltà umanistiche. -% -\item I secondi e terzi candidati non hanno senso né per le tesi di dottorato né per le monografie. Per tutti i candidati il comando per inserirne il nominativo accetta due forme: -\begin{flushleft}\obeylines -\cs{candidato}\marg{Nome Cognome} -oppure -\cs{candidato}\marg{Nome Cognome {\normalfont\cs{IDN}} numero di matricola} -\end{flushleft} -Il \meta{numero di matricola} non è quasi mai necessario, quindi la sequenza \verb|\IDN| viene inserita solo se si vuole indicare anche il numero di matricola. La macro \cs{IDN} è predefinita per contenere la stringa \verb|\\\quad matricola:\space|; può venire ridefinita per contenere il nome dell'\emph{Identification number} oppure semplicemente \emph{ID}, e i due punti prima del comando \verb|\space| potrebbero essere sostituiti con qualche altro segno o semplicemente eliminati. Ovviamente questo è possibile anche per il comando \cs{candidata}. -% -\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. -\end{itemize} - -Per quanto riguarda i loghi, la loro inserzione implica l'uso del pacchetto \texttt{graphicx}, che \textsf{TOPtesi} carica di default; specificare nuovamente quel pacchetto non produce nessun danno, perché \LaTeX\ controlla da solo se lo deve caricare o non lo deve ricaricare. - -\textcolor{red}{Per i formati dei file grafici da includere, le versioni recenti sia di pdf\LaTeX\ sia di \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 sa di più, compagni o professori, ma che anche loro talvolta dimenticano.} - -\textcolor{red}{Esistono programmi per passare da un formato all'altro, ma anche disponendo di quei programmi e conoscendo i vantaggi e gli svantaggi di un formato rispetto ad un altro, questa operazione viene dimenticata troppo spesso, perché troppo spesso ci si dimentica di queste limitazioni sui formati.} - -Per questo io preferisco usare sempre e solamente i compilatori -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. - - -\section{Altri comandi} -Il pacchetto \textsf{TOPtesi} richiede l'uso di altri comandi il più notevole dei quali è senza dubbio \verb|\frontespizio| con la sua variante \verb|\frontespizio*|. È un comando che non vuole argomenti e che va dato all'inizio, subito dopo l'apertura del documento o all'inizio del primo file incluso dal master file. Si veda comunque la tabella~\ref{tab:comandi}. - -La differenza fra i due comandi consiste nel fatto che \verb|\frontespizio| compone il frontespizio della tesi come richiesto dal Politecnico di Torino, con il logo dell'ateneo in testa alla pagina. Invece la variante asteriscata compone il frontespizio scrivendo in testa il nome dell'ateneo e mettendo il logo nella metà inferiore della gabbia di stampa. Il risultato si vede chiaramente nella figura~\ref{fig:frontespizi}. - -Merita sottolineare che il formato richiesto dal Politecnico di Torino va bene nel senso che il logo di quell'ateneo contiene già il suo logotipo\footnote{ Il logo del Politecnico di Torino è formato da due parti accostate con un piccolo spazio fra le due; nella parte di sinistra compare il marchio dell'ateneo, il solito simbolo tondo, mentre la parte di destra contiene il logotipo, cioè il nome \textsf{POLITECNICO DI TORINO} su due righe scritto con certi font e con un colore particolare; font e colore non possono venire modificati, pena la violazione d'uso del logo.}. Sarebbe quanto mai inestetico, infatti, se in testa al frontespizio comparisse due volte il nome del Politecnico; quindi non è strano che l'intestazione della tesi contenga formalmente solo il logo. Lo stesso potrebbe essere fatto, per esempio, con i loghi di diverse università, per esempio quella di Torino, di Ca' Foscari a Venezia, di Bologna, dell'Università Cattolica, di Padova, oltre al logo del Politecnico di Milano, giusto per citarne alcuni, che contengono il marchio e il logotipo. - -Per le università che hanno un nome proprio, come per esempio \emph{Tor Vergata} per la seconda università di Roma, ma, che io sappia, non hanno il logotipo nel loro logo, sarebbe quanto mai inestetico Usare il logo sopra,, in testa, poi il nome proprio, poi tutto il resto; io non consiglierei mai di usare \verb|\frontespizio| in questi casi, ma userei solo \verb|\frontespizio*|. - - -Ovviamente perché il comando esegua il suo compito, tutte le informazioni rilevanti devono già essere state scritte prima di dare il comando \cs{frontespizio} o nel file di configurazione. - -Nella figura~\ref{fig:frontespizi} sono riportati quattro esempi di frontespizi relativi ai tipi di tesi seguenti: -\begin{itemize} -\item tesi di laurea specialistica o magistrale, -\item dissertazione di dottorato -\item tesi di laurea del Vecchio Ordinamento, -\item monografia di laurea, -\end{itemize} -Con questi modelli lo studente che compila la sua tesi usando \textsf{TOPtesi} può scegliere la versione che fa al caso suo e sa anche che cosa deve configurare per eseguire alcuni cambiamenti.\enlargethispage*{3\baselineskip} - - -\clearpage - -\begin{figure}[p]\centering -\includegraphics[height=.9\textheight]{FrontespiziAssemblati} -\caption{I quattro frontespizi fondamentali}\label{fig:frontespizi} -\end{figure} - -\begin{table}[p] -\def\V{\rule{0pt}{2.5ex}} -\def\cs#1{\texttt{\string#1}}\let\s\string -\def\d{\discretionary{\%}{}{}} -\makebox[\textwidth]{% -\begin {tabular}{p{.25\textwidth}p{.25\textwidth}p{.4\textwidth}} -\hline -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 ed eventualmente il - retrofrontespizio; il logo dell'ateneo appare in testa - alla pagina \\ -\cs{\frontespizio*} & nessuno & Come \cs{\frontespizio} ma con il logo dell'ateneo - nella metà inferiore della pagina\\ -\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 - che ha per intestazione la parola - RINGRAZIAMENTI (anche in lingua)\\ -\cs{\indici} &nessuno & Fa stampare l'indice generale, e, - se sono stati dati i comandi - \texttt{\char92figures\-page\-true} e - \texttt{\char92tables\-page\-true}, - anche gli indici delle figure e delle - tabelle.\\ -\cs{\paginavuota} &nessuno & Emette nel file di uscita una pagina totalmente - bianca, senza nemmeno il numero della pagina. Non so - a che cosa possa servire, ma non costa niente - mettere a disposizione anche questo comando che mi è - stato richiesto a gran voce.\\ -\cs{\NoteWhiteLine} &nessuno & Anche questo comando mi è stato richiesto a gran - voce e serve per mettere in nota una riga - completamente bianca.\\[.5ex] -\hline -\end{tabular}} -\caption{Comandi ulteriori di \textsf{TOPtesi}}\label{tab:comandi} -\end{table} - - -\begin{table}[p] -\def\V{\rule{0pt}{2.5ex}} -\def\cs#1{\texttt{\string#1}}\let\s\string -\def\d{\discretionary{\%}{}{}} -\makebox[\textwidth]{% -\begin {tabular}{p{.2\textwidth}p{.7\textwidth}} -\hline -Comando\V & Scopo \\[.5ex] -\hline -\cs{\candidato}\V &Si usa come di solito ma con l'opzione \texttt{classica} - produce la scrittura ``Laureando'' invece che ``Candidato''.\\ -\cs{\candidata} & Come sopra al femminile. Sia questo comando, sia il precedente - accettano che l'argomento sia scritto nella forma \meta{Nome Cognome - {\normalfont\cs{\IDN}} matricola} in alternativa a - \meta{Nome Cognome}.\\ -\cs{\tomo} & Esegue i frontespizi successivi di una tesi divisa in tomi - scrivendovi Tomo primo, Tomo secondo, eccetera, - a seconda del numero progressivo dei volumi in cui è suddivisa l - a tesi (massimo quattro).\\ -\cs{\annoaccademico} & Il suo argomento può essere un anno solare o - due anni separati da una lineetta. - Viene scritto nel frontespizio della tesi o del singolo tomo - con la specificazione che si tratta dell'anno accademico e non - della data della presentazione della tesi.\\ -\cs{\EnDash} & Produce una lineetta lunga come ---, ma ribassata in modo che stia - bene fra numeri di stile antico.\\ -\cs{\nota[...]} & Serve per comporre una nota senza ricorrere al contatore numerico - di default. - Il simbolo con cui viene richiamata di default è l'asterisco, ma - si può mettere qualunque segno matematico senza esplicitare i segni - di dollaro, per esempio si può scrivere - \cs{\nota[\s\dagger]\{Questa nota \dots\}}\\ -\texttt{dedica} & È un ambiente con cui si può stampare una - pagina di dedica; generalmente questa pagina viene dopo il - frontespizio.\\ -\texttt{citazioni} & È un ambiente che consente di scrivere una pagina con frasi argute. - L'arguzia dipende dall'autore; spesso nei libri, raramente nelle - tesi, l'autore cita frasi celebri o che in qualche modo hanno - a che fare con il contenuto del testo.\\[.5ex] -\hline -\end{tabular}} -\caption{Comandi ulteriori per il frontespizio e per il corpo -della tesi definiti con l'opzione \texttt{classica}}\label{tab:front5} -\end{table} - - -\chapter*{Conclusioni} -\addcontentsline{toc}{chapter}{Conclusioni} - -Il pacchetto \textsf{TOPtesi} fa quasi tutto quello che è -necessario per comporre uno qualunque di quegli scritti che -vengono chiamati \emph{monografia di laurea}, oppure \emph{tesi di -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. - -Da un lato alcuni devono adattarsi a quello che è disponibile, -magari dandosi da fare per creare qualche cosa di nuovo per se -stessi e forse anche per gli altri. Qualcun altro deve sapersi -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ù -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 -sistema dovrebbe essere completo ma richiede un po' di attenzione -da parte dell'utente. - -\begin {sloppypar} -Un'altra possibilità sarebbe quella di predisporre altri file con -i nomi, per esempio, \texttt{topfrnten.sty}, -\texttt{topfrntfr.sty}, \texttt{topfrntsp.sty}, eccetera, che -siano cloni del file \texttt{topfront.sty} e che si possono -richiamare come pacchetti aggiuntivi. Ognuno definisce il comando -\texttt{\string\frontespizioinglese}, -\texttt{\string\frontespiziofrancese}, -\texttt{\string\frontespiziospagnolo}, eccetera, e questo comando -può quindi essere usato in sostituzione del comando per il -frontespizio italiano. Questi file differirebbero da quello per il -frontespizio in italiano perché vi sarebbero ridefinite tutte le -definizioni di default delle stringhe in lingua. Ovviamente -bisogna che chi clona e modifica il file \texttt{topfront.sty} e -lo modifica per adattarlo ad una determinata lingua, deve -conoscere quella lingua da maestro. Suggerirei però di non -modificare le strutture con cui è composto il frontespizio, -perché effettivamente contiene tutti gli -elementi richiesti ``per legge'' ed è tipograficamente abbastanza -equilibrato; la sfalsatura del blocco dei relatori e di quello dei -candidati lascia abbastanza spazio per le firme di legge, anche se -introduce un elemento di asimmetria; tuttavia~\dots -\end{sloppypar} - -Il pacchetto \textsf{TOPtesi} carica di default sia \texttt{babel} o -\texttt{polyglossia} sia \texttt{graphicx}; certo potrebbe caricare di -default anche \texttt{amsmath} e i suoi compagni, ma non tutti hanno -bisogno di scrivere e comporre matematica avanzata e se non vengono -usati essi comportano uno spreco di memoria e un sia pur piccolo -rallentamento nell'esecuzione. Ritengo quindi che sia meglio che ognuno -si carichi i pacchetti che intende davvero usare. - -Si ricordi che specificando l'opzione \texttt{pdfa}, bisogna usare -esclusivamente \texttt{pdflatex} (con il parametro \verb|\pdfoutput| -caricato con un numero positivo, generalmente~1); viene caricato un -file di estensione specifico che a sua volta attiva la possibilità -di disporre dei link interni ed esterni, che sono così comodi per -``navigare'' dentro il documento. Eventuali personalizzazioni devono -perciò venire eseguite immediatamente dopo la dichiarazione della -classe, altrimenti non vengono recepite correttamente. Bisogna -altresì ricordarsi di predisporre il file con i \emph{metadata} -richiesti dal formato PDF/A. - -È possibile usare il semplice \texttt{latex} (o anche \texttt{pdflatex}, -con il valore di \verb|\pdfoutput| caricato con il valore~0); ma questo -serve solo per produrre un file in formato DVI, che può servire solo per -una stampa della tesi su carta; può venire trasformato nel formato PS -tramite l'applicativo \texttt{dvips}, ma questo formato non stamperebbe -meglio di quel che si potrebbe ottenere dai ``previewer'' recenti per -il formato DVI che siano anche in grado di inviare i file DVI in stampa. -Viceversa è più interessante disporre della versione finale in formato PDF, -cosa che si può ottenere mediante il programma \texttt{ps2pdf} il quale, -con opportuni artifici, permette anche di produrre un file in formato PDF/A. -Ma allora perché non ottenere questo risultato in un passaggio solo? Certo, -potrebbe esserci l'esigenza di usare estensioni che fanno uso del linguaggio -PostScript, ma, solitamente, agendo direttamente con \texttt{pdflatex} si -possono usare altri pacchetti di estensione che consentono di evitare del -tutto il linguaggio PostScript. Non consiglierei, invece, l'uso generalizzato -di \XeLaTeX, ma lo consiglierei solo per quelle tesi, specialmente di -carattere umanistico, che hanno bisogno di maneggiare agevolmente font di -diversi tipi per scrivere con alfabeti o sillabari o sistemi di ideogrammi -per i quali pdf\/\LaTeX\ è, sì, attrezzato, ma rende molto più faticosa -l'intera operazione. Molto interessante sarebbe anche il programma di -composizione \LuaLaTeX, che incorpora una buona parte del linguaggio di -scripting Lua; questo a sua volta permette di compiere diverse azioni -esternamente al programma di tipocomposizione, e in certi casi esso si -può considerare una estensione molto utile del programma pdf\LaTeX. Benché -questo programma possa usare la microtipografia come pdf\LaTeX\ e i font -OpenType come \XeLaTeX, non vale la pena farne uso se non si ha davvero -bisogno di sfruttarne le funzionalità. Inoltre oggi il nuovo linguaggio -di programmazione interno del sistema \TeX, L3, viene usato prevalentemente -proprio per creare il formato di questo programma di tipocomposizione. - -So per certo che le tesi di filologia classica possono essere -composte molto bene con \LaTeX\ e \textsf{TOPtesi}; se bisogna -usare una buona dose di lingua greca classica è conveniente -caricare il pacchetto \texttt{teubner}; gli intenditori sanno -perfettamente che i font della casa editrice Teubner di Lipsia -sono fra i più gradevoli che esistano; il pacchetto -\texttt{teubner} fa uso di un'ottima imitazione di quei font e -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{eledmac}; io non -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 -tutti, o anche elencare solo i più importanti. - -Non resta che augurare: -\begin {center}\Large\bfseries -Buona composizione con pdf\/\LaTeX\ o \XeLaTeX\ o \LuaLaTeX! -\end{center} -\appendix -\input{LPPL} - - - \end{document} - - diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-example-frontespizio-frn.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-example-frontespizio-frn.pdf Binary files differdeleted file mode 100644 index 8894b0b4163..00000000000 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-example-frontespizio-frn.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-example-frontespizio-frn.tex b/Master/texmf-dist/doc/latex/toptesi/toptesi-example-frontespizio-frn.tex deleted file mode 100644 index 2f8afddaba0..00000000000 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-example-frontespizio-frn.tex +++ /dev/null @@ -1,29 +0,0 @@ -%% This file has been automatically generated by `frontespizio'. -%% Don't use it as a model for a new frontispiece, use the -%% `frontespizio' environment in you document instead. -\documentclass [titlepage]{article} -\usepackage[latin1]{inputenc} -\usepackage [a4paper,left=1cm,bottom=1.5cm,right=1cm,top=1cm]{geometry} -\usepackage {graphicx} -\usepackage [svgnames]{xcolor} -\usepackage[nowrite,infront,standard]{frontespizio} -\nofiles -\fontoptionnormal -\Universita {Marconia} -\Logo [1.5cm]{logodue} -\Facolta {Matematica, Fisica e~Scienze Naturali} -\Corso [Laurea Magistrale]{Astronomia Applicata} -\Annoaccademico {1615-1616} -\Titoletto {Tesi di laurea magistrale} -\Titolo {La pressione barometrica di~Giove} -\Sottotitolo {Alcune considerazioni mutevoli} -\Sottotitolo {Metodo dei satelliti medicei} -\Candidato [123456]{Galileo Galilei} -\Candidato [123457]{Evangelista Torricelli} -\Relatore {Prof.~Albert Einstein} -\Relatore {Dipl.~ing.~Werner von Braun} -\NCorrelatore {Tutore aziendale}{Tutori aziendali} -\Correlatore {Dott.~ing.~Giovanni Giacosa\\\textmd {\quad Centro Ricerche FIAT}} -\begin {document} -\preparefrontpagestandard -\end {document} diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.pdf Binary files differindex a0e6704c5bd..a16b534cac7 100644 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.pdf +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-it-xetex.pdf diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf Binary files differindex 33770a3ac81..837a126dd4a 100644 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf diff --git a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx index b6f86db134f..5ea70162b84 100644 --- a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx +++ b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx @@ -8,7 +8,7 @@ \preamble ______________________________________________________ The TOPtesi package - Copyright (C) 2013 Claudio Beccari + Copyright (C) 2014 Claudio Beccari All rights reserved License information appended @@ -16,7 +16,7 @@ \endpreamble \postamble -Copyright 2005-2013 Claudio Beccari +Copyright 2005-2014 Claudio Beccari Distributable under the LaTeX Project Public License, version 1.3c or higher (your choice). The latest version of @@ -31,22 +31,26 @@ toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, toptesi.cfg, and the English documentation toptesi.pdf. Furthermore the bundle contains the documentation source -file toptesi-doc-xetex.tex and the derived file -toptesi-doc-xetex.pdf. +file toptesi-it-xetex.tex and the derived file +toptesi-it-xetex.pdf. The toptesi-example.tex source file is just an example that shows how to use the various commands; by commenting or uncommenting certain source lines it is possible to -typeset different kind of theses and their frontpages. +typeset different kind of theses and their front pages. + +The topfront-example.tex source file is an example of how +to produce just the title page with toptesi and the external +package frontespizio. The toptesi.cfg file is a sample of a local configuration file that can be freely edited and modified. By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files and the English documentation file in - pdf format. +pdf format. -The documentation file toptesi-doc-xetex.pdf is in Italian; +The documentation file toptesi-it-xetex.pdf is in Italian; its source file is another example of how to use toptesi. \endpostamble @@ -91,7 +95,7 @@ its source file is another example of how to use toptesi. % \iffalse %<*driver> \documentclass{ltxdoc} -\ProvidesFile{toptesi.dtx}[2014/09/15 v.5.77 Documented TeX file for +\ProvidesFile{toptesi.dtx}[2014/10/15 v.5.81 Documented TeX file for the TOPtesi bundle] \GetFileInfo{toptesi.dtx} \title{The TOPtesi bundle} @@ -112,7 +116,7 @@ the TOPtesi bundle] %</driver> % \fi % -% \CheckSum{2787} +% \CheckSum{2870} % %% \CharacterTable %% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z @@ -132,39 +136,39 @@ the TOPtesi bundle] % % \begin{abstract} % This file describes the TOPtesi bundle; it is a set of files designed to -% typeset with \LaTeX\ a university final report that in Italian is generally +% typeset a university final report that in Italian is generally % called ``tesi''; it was originally developed at the Technical University % of Turin (Politecnico di Torino) but it was adapted for typesetting theses in any % Italian university. Well\dots\ since the Erasmus student mobility is very % extended and many Italian students participate in the so called \textit{double degree} % programs, their theses, or whatever they are called in other countries, % may be typeset so as to comply also with the host university rules; therefore this -% set of files has the ambition to be suited for typesetting theses in any university in the -% world\dots\ This ambition can't be fulfilled, though, because of the complexity of the -% title page (and possibly of the legal page) requirements. This version is experimentally -% compliant with the \XeLaTeX\ program. Up to now the few conflicts that have been spotted -% have been solved with suitable corrections or additions. The most important feature with -% XeLaTeX is that the option pdfa cannot be used any more, because it resorts to a -% compilation with pdf\LaTeX; the typesetting engine \XeTeX\ does not produce directly -% any PDF output but a modified, extended DVI output, even if this format is immediately -% transformed into a PDF file through a special version, xdvipdfmx, of the conversion -% program. Another minor XeLaTeX feature is that it cannot fully exploit the -% typesetting facilities of the micro type package, but the wide choice of -% OpenType fonts replaces almost completely such missing feature. +% set of files has the ambition to be suited for typesetting theses in any university +% in the world\dots\ This ambition can't be fulfilled, though, because of the complexity +% of the title page (and possibly of the legal page) requirements. This version is +% experimentally compliant with the \XeLaTeX\ and the \LuaLaTeX\ programs. Up to now +% the few conflicts that have been spotted have been solved with suitable corrections +% or additions. The most important feature with \XeLaTeX\ is that the option pdfa +% cannot be used any more, because it resorts to a compilation with pdf\LaTeX; +% the typesetting engine \XeTeX\ does not produce directly any PDF output but +% a modified, extended DVI output, that is immediately converted into a PDF file +% through xdvipdfmx, a special version of the conversion program. Another minor +% \XeLaTeX\ feature is that it cannot fully exploit the typesetting facilities +% of the microtype package, but the wide choice of OpenType fonts replaces almost +% completely such missing features. % \end{abstract} % % \section{Introduction} % The TOPtesi bundle contains a certain number of files, specifically -% \begin{itemize} +% \begin{enumerate} % \item a class file \texttt{toptesi.cls} to be used as the main document class; the main % document may be any of a certain number of reports that in Italy % are called with various names: ``monografia'', ``monografia di laurea'', % ``tesi di laurea'', ``tesi di laurea specialistica'', ``tesi di laurea % magistrale'', ``tesi di dottorato'', ``dissertazione di dottorato'', and so on. -% All these documents have in common the fact that they all conclude a period of university -% education. Moreover since they may conclude a double degree university program, they may -% receive foreign names such as, for example, ``Projet de fin d'\'etudes'', -% ``Master thesis'', and the like. +% All these documents have in common the fact that they all conclude a period of +% university education. Moreover since they may conclude a double degree university +% program, they may receive foreign names such as, for example, ``Projet de fin d'\'etudes'', ``Master thesis'', and the like. % \item An extension package \texttt{toptesi.sty} that contains most of the code % for the real typesetting; it might be used as an extension to the report class file, % although this use is discouraged. @@ -173,6 +177,11 @@ the TOPtesi bundle] % independent extension package to be added to, say, the report class file for % typesetting just the title page; this file might be used as a template for setting % up the title page fixed information in languages different from Italian. +% This package is part of the bundle, but it is loaded automatically only if +% the user did not specify the class option |usefrontespizio|; if this option +% is specified the user is free to use whotever other external package s/he +% prefers in order to typeset the tile page; in this case we suggest to use +% the package |frontespizio| and we address the user to its documentation. % \item A third extension package \texttt{topcoman.sty} that defines a certain number % of user commands suitable for typesetting technical matters. % \item Previous version of this bundle contained also the logos of a certain number of @@ -180,39 +189,43 @@ the TOPtesi bundle] % Every one who is working on his/her degree course final report must retrieve the % logo of his/her university, but s/he should pay attention to use it according % to the rules and limitations of the university. -% \item A documentation file \texttt{toptesi-doc-xetex.pdf} written in Italian where -% every feature is explained in detail; essential information is given in this English -% documentation. The source file of the documentation \texttt{toptesi-doc-xetex.tex} -% may be used as a sample or template for typesetting one's thesis with XeLaTeX. -% \end{itemize} +% \item A documentation file \texttt{toptesi-it-xetex.pdf} written in Italian +% where every feature is explained in detail; essential information is given +% in this English documentation. The source file of the documentation +% \texttt{toptesi-it-xetex.tex} may be used as a sample or template for +% typesetting one's thesis with XeLaTeX. +% \end{enumerate} % % The above files are complemented with a configuration file that any user may -% customize at will; these customizations make it easy to configure the +% customise at will; these customisations make it easy to configure the % bundle so as to make it suitable for another language; in facts the -% \textsf{babel} and \textsf{polyglossia} packages contain localizations +% \textsf{babel} and \textsf{polyglossia} packages contain localisations % for many languages, but such localizations deal with the standard infix % \LaTeX\ names and phrases and do not cope with the thesis title page requirements. -% -% TOPtesi was specifically conceived for typesetting theses with the \LaTeX\ mark-up, and -% initially was using the \textsf{tex} typesetting engine; later on this engine was -% substantially substituted by the \textsf{pdftex} engine, which was capable of direct -% output of PDF files. Since about 2006 the typesetting engine \XeTeX\ is available; the -% most important feature of this engine is its capability of using OpentType fonts, -% among which those that are available to the operating system of the specific -% platform where the document is being typeset. For what concerns theses this -% might be of essential importance when the thesis deals with specific languages -% that use different scripts (Greek, Russian, Bulgarian, Chinese, Japanese, -% Korean, Arabic, Farsi, Thai, and so on). +% This customisation is usable only if Non |usefrontespizio| option had been +% declared to the class. +% +% TOPtesi was specifically conceived for typesetting theses with the \LaTeX\ mark-up, +% and initially it was using the \textsf{tex} typesetting engine; later on this engine +% was substantially substituted by the \textsf{pdftex} engine, which was capable +% of direct output of PDF files. Since about 2006 the typesetting engine \XeTeX\ +% is available; the most important feature of this engine is its capability +% of using OpentType fonts, among which those that are available to the +% operating system of the specific platform where the document is being typeset. +% For what concerns theses this might be of essential importance when the thesis +% deals with specific languages that use different scripts (Greek, Russian, +% Bulgarian, Chinese, Japanese, Korean, Hebrew, Arabic, Farsi, Thai, and so on). % % This version of TOPtesi has been tested with \XeLaTeX. Some conflicts have % been spotted and solved; may be there are still hidden ones, so that feedback -% from users is particularly welcome. The only main drawback still present when running -% \XeLaTeX\ is the fact that this program cannot still \emph{directly} produce the output -% file in PDF format, although it automatically transforms its specific output file into -% PDF format. This implies that the specific \textsf{pdftex} features required to produce -% a PDF/A compliant output PDF file suitable for long term archiving cannot be used. But -% with some attention the PDF file output by \XeLaTeX\ may be converted to PDF/A by using -% the program \prog{ghostscript}. +% from users is particularly welcome. The only main drawback still present +% when running \XeLaTeX\ is the fact that this program cannot still +% \emph{directly} produce the output file in PDF format, although it +% automatically transforms its specific output file into PDF format. This +% implies that the specific \textsf{pdftex} features required to produce +% a PDF/A compliant output PDF file suitable for long term archiving cannot +% be used. But with some attention the PDF file output by \XeLaTeX\ may be +% converted to PDF/A by using the program \prog{ghostscript}. % % \section{User commands} % The \texttt{toptesi.cls} is basically an extension of the standard class @@ -222,7 +235,7 @@ the TOPtesi bundle] % to typeset the thesis with the quality of a \LaTeX\ well typeset document, % not as a typewriter written one. % -% Theses very often are full of specialized material: formulas, diagrams and pictures, +% Theses very often are full of specialised material: formulas, diagrams and pictures, % texts written in non latin alphabets, special symbols for philological mark-up, and % the like; a common typewriter would not be suitable and the quality of the contents % requires professional typesetting; this is why I strongly believe that instructions @@ -234,13 +247,28 @@ the TOPtesi bundle] % than A4 or letter paper. With smaller paper sizes the layout changes % automatically, but the title page might require some more attention. The % default paper size is A4, but the user can seta any paper size among those -% accepted by the |report| standard class. -% -% Most new commands refer themselves to the information that should be typeset in the -% title page; some class options specify special stylistic page details; the rest is simple -% and traditional \LaTeX\ mark-up as it is implemented in the \LaTeX\ kernel and in the -% report document class. If \XeLaTeX\ has to be used, some essential preamble specific -% commands are to be used, but essentially the body of the thesis has the same mark-up. +% accepted by the |report| standard class. If the |usefrontespizio| option +% was specified and the package |frontepsizio| was loaded by the user, it +% is necessary to remind that it can easily create pretty nice title pages, but only +% either on A4 paper or on a paper format that mimics that of the famous book +% \emph{Elements of typographic style} by Robert Bringhurst; this is so at +% least with |frontespizio|'s version 1.4a of 2011/09/21 or earlier. +% +% Therefore if you want to typeset your thesis while typesetting the title +% page by means of the functionalities of package |frontespizio| you have +% to follow carefully how to use that package's options in the proper way +% as to bypassa the two fixed formats that it can produce; May be when you +% happen to use the TOPtesi bundle, the author of |frontespizio| has already +% extended his package in order to let it recognise the various paper formats +% used for the rest of the thesis. See also the Italian documentation contained +% in the document |toptesi-it-xetex.pdf|. +% +% Most new commands refer themselves to the information that should be typeset +% in the title page; some class options specify special stylistic page details; +% the rest is simple and traditional \LaTeX\ mark-up as it is implemented in +% the \LaTeX\ kernel and in the report document class. If \XeLaTeX\ has to be +% used, some essential preamble specific commands are to be used, but essentially +% the body of the thesis has the same mark-up. % % \subsection{Class options} % The class accepts all the options accepted by the |report| document class @@ -283,15 +311,33 @@ the TOPtesi bundle] % % \Item[oldstyle] Also this option works only if \texttt{classica} had already been % specified; it typesets several numerical data with the old style numbers. +% +% \Item[usefrontespizio] allows the user to load a different package for +% creating and typesetting the title page; of course if this option is +% specified, the native package |topfront| is not loaded, and the commands +% described in the next section are not available. On the opposite commands available +% with the chosen package become available, while possible package conflicts are +% eliminated at the root. +% +% \Item[noTOPfront] is basically equivalent to the previous option; both +% options set up the |\ifTOPfront| switch that is more mnemonic than the long +% (actually not defined) |\iffrontespizio| one; actually |\ifTOPfront| would +% be true when |\iffrontespizio| is false. % \end{description} % % \subsection{Title page commands} -% The user must specify a certain number of commands in order to have the +% Note: Skip this section if you decide to load an external package for +% the title~page. Notice also that if you want to load an external package for +% typesetting the title page, you should load it \emph{after} specifying +% the input encoding you use for your text files.\bigskip +% +% \noindent The user must specify a certain number of commands in order to have the % title page contain all the required information. It must be specified that % most of these commands may be used in the configuration file so as to avoid repeating % the same data for different ``reports''; well, a university student might write a % bachelor's ``monografia'', then a master thesis and finally a doctoral dissertation; % why should s/he repeat his/her name, the name of the institution, and so on? +% % All the user commands for the title page redefine default values or strings; % therefore if none of the required information is given, the default values and strings % are typeset, possibly with hilarious results\dots @@ -321,26 +367,29 @@ the TOPtesi bundle] % \Item[direttore] gets the name of the Doctoral School Director % \Item[coordinatore] gets the name of the Doctoral School Coordinator % \Item[QualificaDirettore] gets the phrase that describes the director or coordinator -% official position; by using the command \cs{direttore} the default phrase +% official position; by using the command \cs{direttore} the +% default phrase % ``Direttore della Scuola di Dottorato'' is printed above the % ``director's'' name; % if \cs{coordinatore} is used the default phrase ``Coordinatore della -% Scuola di Dottorato'' is printed instead. If neither one is applicable or a -% description in another language is required, this macro is available for +% Scuola di Dottorato'' is printed instead. +% If neither one is applicable or a description +% in another language is required, this macro is available for % specifying such position. % \Item[relatore] gets the name of the thesis first supervisor % \Item[secondorelatore] gets the name of the second supervisor % \Item[terzorelatore] gets the name of the third supervisor; it is assumed that the % number of supervisors never exceeds three. -% \Item[tutore] gets the name of the doctorate tutor; there is no difference with regards -% to the \cs{relatore}, but the default phrase ``Tutore'' is printed above -% this person's name. -% \Item[TutorName] gets the phrase that describes the tutor position, possibly in a different -% language. +% \Item[tutore] gets the name of the doctorate tutor; there is no difference +% with regards to the \cs{relatore}, but the default phrase +% ``Tutore'' is printed above this person's name. +% \Item[TutorName] gets the phrase that describes the tutor position, possibly +% in a different language. % \Item[AdvisorName] gets the string that qualifies the supervisor(s); the default string -% is ``Relatore:'' or ``Relatori:'' for the plural; in another language -% this command is used to define the string, say, ``Supervisors:'' if the -% thesis has been supervised by more than one person. +% is ``Relatore:'' or ``Relatori:'' for the plural; +% in another language this command is used to define the string, +% say, ``Supervisors:'' if the thesis has been supervised +% by more than one person. % \Item[CoAdvisorName] gets the string that qualifies the co-supervisor(s); the default % string is ``Correlatore:'' or ``Correlatori:'' in the plural; this % command may be used to define the string, say, ``Corapporteur:'' in a @@ -352,20 +401,20 @@ the TOPtesi bundle] % \Item[terzocandidato] gets the name of the third male author % \Item[terzacandidata] gets the name of the third female author; most often the thesis % author is just one person; but there are some institutions where group -% final works are accepted; it is assumed that the group does not contain more -% than three authors. The specification of the gender allows the software -% to determine the correct labeling phrase in the proper gender and proper -% number. +% final works are accepted; it is assumed that the group does not contain +% more than three authors. The specification of the gender allows the +% software to determine the correct labelling phrase in the proper +% gender and proper number. % For different languages there might be no difference in gender but % there is a difference in the plural ending. % \Item[CandidateName] gets the string that describes the student status in a foreign % language or even in Italian; the default string is ``Candidato:'' (with % colons) adjusted to masculine or feminine, singular or plural; with the % option \texttt{classica} the string becomes ``Laureando:''; in other -% languages it is necessary to specify this string in the proper gender and -% number. -% \Item[sedutadilaurea] gets the date of the final exam, or presentation, or defense of the -% thesis; if this date is omitted the default date is the current +% languages it is necessary to specify this string in the proper gender +% and number. +% \Item[sedutadilaurea] gets the date of the final exam, or presentation, or defense +% of the thesis; if this date is omitted the default date is the current % month and year in Italian. % \Item[esamedidottorato] an alias for \cs{sedutadilaurea} to be used for doctoral % dissertations. @@ -373,31 +422,33 @@ the TOPtesi bundle] % \Item[CycleName] redefines the string that expresses the name of the doctoral cycle; % by default this is ``ciclo'' but this command is useful to set the % name in a different language. -% \Item[corsodilaurea] gets the proper name of the degree course; the phrase that describes -% the degree course is specified, if necessary, with the following -% command; with this one you specify just, say, ``Electrical Engineering'' +% \Item[corsodilaurea] gets the proper name of the degree course; the phrase that +% describes the degree course is specified, if necessary, with the +% following command; with this one you specify just, say, +% ``Electrical Engineering'' % \Item[CorsoDiLaureaIn] gets the generic name of the degree course, for example -% ``Bachelor Degree in'' +% ``Bachelor Degree in\textvisiblespace'' % \Item[TesiDiLaurea] gets the generic phrase that describes the thesis; by default it is % ``Tesi di Laurea''; in English one might set it to ``Master Thesis''. % \Item[NomeMonografia] gets the phrase that describes the bachelor's report; by default % it is ``Monografia di Laurea''. In some Italian universities it might % be called ``Tesi di Laurea'', so that the master thesis should be given % another qualification, for example ``Tesi di Laurea Magistrale''. -% \Item[NomeDissertazione] gets the phrase that describes the doctoral thesis; by default -% it is ``Tesi di Dottorato''. -% \Item[InName] infix strings often require adjusting of the prepositions; this macro gets -% the preposition that stands for ``in'' (the default). In German it might -% become ``auf''. +% \Item[NomeDissertazione] gets the phrase that describes the doctoral thesis; +% by default it is ``Tesi di Dottorato''. +% \Item[InName] infix strings often require adjusting of the prepositions; this macro +% gets the preposition that stands for ``in'' (the default). In German +% it might become ``auf''. % \Item[NomeAnnoAccademico] defines the infix string that stands for ``Academic year''. % This macro is defined only if the option \texttt{classica} is in force; -% after all the command |\annoaccademico| is defined only with that option. +% after all the command |\annoaccademico| is defined only with that +% option. % \Item[logosede] specifies the name of the file or the files that contain the university % logos; no default is defined; rather a warning message is issued if no % name is given or the file is missing, but typesetting goes on without % the inclusion of any logo. a list of logos can be specified, useful % when a thesis is carried on in a multiple University environment -% such as, for example that takes place in a double degree Erasmus +% such as, for example, in a double degree Erasmus % program; or under the Erasmus Mundus program. The ``string'' of % logos is scaled properly so that they may fit in the |\textwidth|. % \Item[setbindingcorrection] sets up the length to displace the text block to the @@ -410,17 +461,17 @@ the TOPtesi bundle] % text or if it is not used at all, no copyright page is assumed. % \end{description} % -% Since the infix strings are all memorized into control sequences and for each of them it -% is possible to use a defining command, all strings can be modified at will, so that there -% is no difficulty to localize the package in another language; this comes particularly -% handy for the Erasmus students on double degree programs. +% Since the infix strings are all memorised into control sequences and for each of +% them it is possible to use a defining command, all strings can be modified at will, +% so that there is no difficulty to localise the package in another language; +% this comes particularly handy for the Erasmus students on double degree programs. % % As a final remark notice that the commands for typesetting the title page and the % copyright page are contained in the package \texttt{topfront.sty}, which can be used % as an autonomous extension to the \texttt{report} document class. One could easily % typeset either just the title page with a separate \TeX\ source file so as to test the % completeness of the commands and coherence of the configuration file, or for just -% printing the isolated title and copyright (if any) pages. +% printing the isolated title and copyright pages (if any). % % \subsection{Typesetting commands} % The bundle and the TOPtesi document class accept all \LaTeX\ commands provided by @@ -430,21 +481,22 @@ the TOPtesi bundle] % If the source thesis file is being typeset by means of \XeLaTeX\ the \texttt{babel} % package is not loaded; in its place the \texttt{polyglossia} package is loaded that % should implement in \XeLaTeX\ most of the functionality provided by \texttt{babel} to -% \LaTeX. ``Most'' means that not all the functionality is available, therefore it's better -% to consult the documentation of \texttt{polyglossia} before using its built in commands. +% \LaTeX. ``Most'' means that not all the functionality is available, therefore it's +% better to consult the documentation of \texttt{polyglossia} before using its built +% in commands. % % With this respect it must be underlined that the Italian and English languages are % specified by default, the Italian one being the default language. An initial -% specification of |\selectlanguage{english}| sets the English language as default. +% specification of |\selectlanguage{english}| sets the English language as the default. % Should a student typeset the thesis in French by means of \textsf{pdflatex}, it % would be necessary to specify the option \texttt{french} among the \emph{class} % options, and then start the document by specifying |\selectlanguage{french}|. % But the user should pay attention to use \texttt{babel} in the proper way: -% \begin{itemize} +% \begin{enumerate} % \item Due to the way \LaTeX\ classes load the requested files, and to the fact that the % \texttt{babel} package has already been loaded by the \texttt{toptesi} class, the user -% cannot reload it with a different list of language options; therefore the latter language -% options \emph{must be specified} as global class options; so if the thesis has +% cannot reload it with a different list of language options; therefore the latter +% language options \emph{must be specified} as global class options; so if the thesis has % to be typeset, for example, in French, is is necessary to do the following: %\begin{verbatim} %\documentclass[...,french,...]{toptesi} @@ -452,7 +504,7 @@ the TOPtesi bundle] %\begin{document} %\selectlanguage{french} %\end{verbatim} -% But if the thesis should be typeset in French by means of \XeLaTeX, then it is perfectly +% But if the thesis should be typeset in French by means of \XeLaTeX, then it i perfectly % legal to specify the auxiliary language in this way: %\begin{verbatim} %\documentclass[...]{toptesi} @@ -478,36 +530,35 @@ the TOPtesi bundle] % Should the required language(s) be missing, the user is forced to read his/her % distribution instructions, so as to find out how to configure his/her system so as to % consider the languages s/he wants to work with, and finally s/he must recreate the -% format files and put them in the proper places of the standard or the local folder -% tree. +% format files. % The user is invited to carefully investigate on these fine points and to properly % configure the system; it would be very upsetting to use fine software for producing a % perfectly typeset thesis that, unfortunately, has wrong hyphenation points! Luckily % enough, recent distributions of the \TeX\ system have all the known hyphenation rules -% preloaded; in any case even older distributions have available command line commands +% preloaded; in any case even older distributions have available command-line commands % or graphical user interfaces that make it easy to perform the tasks of changing the % list of preloaded hyphenation rules and rebuilding all the format files, moving them % to the proper places. -% \end{itemize} +% \end{enumerate} % % The TOPtesi bundle adds very little to the user commands; nevertheless the package % \texttt{topcoman.sty}, that is part of this bundle and is automatically loaded, defines -% some useful commands for typesetting technical matters in such a way as to fulfill the +% some useful commands for typesetting technical matters in such a way as to fulfil the % ISO regulations. -% Some of these commands are already defined with the \texttt{babel} Italian option, but if -% your thesis is written in different languages it may happen that such commands are not -% available any more when you select another language; with the presence of the definitions -% contained in \texttt{topcoman.sty} such useful commands remain available with every -% language. The \texttt{polyglossia} package does not produce any useful additional command -% for writing in a ISO compliant way, therefore the macros contained in the -% \texttt{topcoman.sty} package come very handy. +% Some of these commands are already defined with the \texttt{babel} Italian option, +% but if your thesis is written in different languages it may happen that such +% commands are not available any more when you select another language; with the +% presence of the definitions contained in \texttt{topcoman.sty} such useful commands +% remain available with every language. The \texttt{polyglossia} package does not +% produce any useful additional command for writing in a ISO compliant way, therefore +% the macros contained in the \texttt{topcoman.sty} package come very handy. % % The following description specifies these particular commands. % \begin{description} % \def\Item[#1]{\item[\normalfont\texttt{\char92#1}]} % \Item[DeclareSlantedCapitalGreekLetters] does exactly what its name -% means: it changes the definitions of the mathematical capital Greek -% letters so that they are typeset in ``italics''; they are in effects taken from the math +% means: it changes the definitions of the mathematical capital Greek letters so that +% they are typeset in ``italics''; they are in effects taken from the math % italic alphabet, instead of the default roman one. This option is useful with \LaTeX, % while with \XeLaTeX\ it is unnecessary due to the larger set of math alphabets and math % font commands that are available with proper UNICODE math fonts. @@ -522,7 +573,7 @@ the TOPtesi bundle] % % % \Item[ped] inserts a subscript in upright type; the ISO regulations % require the use of italics for physical or mathematical quantities, and -% upright type for anythingg that is not a variable, from the names of +% upright type for anything that is not a variable, from the names of % functions (such as sin, cos, log, etc.), to the indices that contain % information on something that is not variable. This means that $V_i$ % requires an italic index to imply that the object $V$ is the $i$-th in @@ -572,16 +623,16 @@ the TOPtesi bundle] % from an slanted ''pi'' (the angle). % % % \Item[listing] requires for its argument the name of a file and typesets it in verbatim -% mode; this command is very useful for typesetting the listings of the programs that were -% written for the thesis; for best results it is recommended that the source program has -% lines not longer than 80 characters. There exists an external package \texttt{listings}, -% that the user might want to load, that does a similar work in a more professional and -% configurable way; this package simpler command might be preferable for its simplicity, -% but of course it is not compulsory. +% mode; this command is very useful for typesetting the listings of the programs that +% were written for the thesis; for best results it is recommended that the source +% program has lines not longer than 80 characters. There exists an external package +% \texttt{listings}, that the user might want to load, that does a similar work in +% a more professional and configurable way; this package simpler command might be +% preferable for its simplicity, but of course it is not compulsory. % \end{description} % % All these commands are defined into the separate package \texttt{topcoman.sty} -% that can be used as an independent extension package with (may be) any document class. +% that might be used as an independent extension package with any document class. % % \section{PDF format suitable for archiving} % This section in general does not apply if the thesis is typeset by means of \XeLaTeX, @@ -596,7 +647,7 @@ the TOPtesi bundle] % problem of course is: ``Will it be possible to read the archived documents, say, fifty % years from now?'' % -% This essential question has been answered by the International Standards Organization +% This essential question has been answered by the International Standards Organisation % (ISO) that in 2005 published the regulation ISO~19005-1. This regulation defines a % PDF variant suitable for archiving, named PDF/A, that has two sub-formats % distinguished as PDF/A-1a, and PDF/A-1b. The `a' sub-format is more exacting, while @@ -615,20 +666,20 @@ the TOPtesi bundle] % optional information, such as the keywords that ease up library searches. % % Since version 1.40, the program \texttt{pdflatex} is capable of producing PDF/A-1b -% conforming files, provided that some attention is put into the manipulation of the source -% file of the thesis. With the distribution of the 2008 version of the \TeX\ system, the -% executable \texttt{pdflatex} has version number 1.40.9 and is capable of producing -% PDF/A-1b files. +% conforming files, provided that some attention is put into the manipulation of the +% source file of the thesis. With the distribution of the 2008 version of the \TeX\ +% system, the executable \texttt{pdflatex} has version number 1.40.9 (or higher) +% and is capable of producing PDF/A-1b files. % % The particular attention needed to avoid problems with the PDF/A certification is -% summarized as follows: -% \begin{itemize} -% \item The preliminary essential requirement is that the \texttt{pdflatex} engine used to -% typeset the thesis be sufficiently recent to support the PDF/A requirements. It's +% summarised as follows: +% \begin{enumerate} +% \item The preliminary essential requirement is that the \texttt{pdflatex} engine used +% to typeset the thesis be sufficiently recent to support the PDF/A requirements. It's % better to have the most recent distribution of the \TeX\ system installed on your PC. -% Do not try to typeset the thesis with the `old' \LaTeX; you \emph{must} process the input -% thesis file(s) with \texttt{pdflatex} or with \prog{xelatex}; in the following, no -% specific check will be made in order to verify if you are actually using +% Do not try to typeset the thesis with the `old' \LaTeX; you \emph{must} process the +% input thesis file(s) with \texttt{pdflatex} or with \prog{xelatex}; in the following, +% no specific check will be made in order to verify if you are actually using % \texttt{pdflatex}. If you really need to use the `old' \LaTeX, you get a DVI % file and you need to transform it with |dvips| into a PS file; at this point you % have lost the possibility of exploiting the internal commands of |pdflatex| version @@ -639,11 +690,13 @@ the TOPtesi bundle] % thesis is typeset by means of \XeLaTeX, and produces valid results provided some % caution is exercised when using fonts. % -% \item Download from \textsc{ctan} and install the package \textsf{pdfx}, if it is -% not already part of your \TeX\ system complete distribution. +% \item Your up-to-date complete \TeX\ distribution should contain the package +% \textsf{pdfx}; if it does not, upgrade your \TeX\ system complete distribution. +% % \item Install in the main \texttt{pdfx} directory a good version of a color model % profile file, such as, for example, \texttt{ECI-RGB-V1.0.icc} (see the download % page of the site \texttt{www.eci.org}). +% % \item If your thesis main file, the one you run your \texttt{pdflatex} on, is named, % say, \texttt{JohnSmithMasterThesis.tex}, prepare in the same directory another file % named \texttt{JohnSmithMasterThesis.xmpdata} that contains the \emph{metadata} @@ -656,13 +709,16 @@ the TOPtesi bundle] % \end{verbatim} % Keywords require a specific XML style format that can be examined in the package % documentation. +% % \item Some mathematical symbol commands obtained from the standard \LaTeX\ set-up % and the standard mathematical fonts require some patching that is already included % in this \texttt{TOPtesi} bundle; but it is not excluded that with other fonts similar % patches might be requested. The UNICODE math fonts used by \XeLaTeX\ do not require any % patch, but unfortunately its PDF byproduct is not PDF/A compliant (it must be converted % by means of \prog{ghostscript}). +% % \item Use only PNG and JPEG images with RGB color profiles. +% % \item If you include PDF images that contain some text, be sure that the fonts for % this text are completely embedded in the included file. Should the PDF file come % from an external drawing program be sure to configure that program so that it embeds @@ -670,38 +726,41 @@ the TOPtesi bundle] % the free program \texttt{inkscape} and save it back in PDF format; the missing fonts % will be replaced with their traced outlines and this will not disturb the PDF/A % conformity. +% % \item Verify your final PDF file with a suitable program and do not give up doing the % necessary corrections or modifications while the verification program keeps saying % that this or that is not conforming to the PDF/A specification. A suitable program % is the Preflight plug-in of Adobe Acrobat Professional version 8 or later, but this, % although the most authoritative, is a commercial program; probably your university % has special facilities for this task. +% % \item If you use \prog{xelatex} for typesetting your thesis, you have to accompany your -% master file with another one that contains the metadata and other necessary information. -% Be sure to call this auxiliary file as the masterfile name glued with |-def.ps|; so if +% master file with another one that contains the metadata and other necessary +% information. +% Be sure to call this auxiliary file has the masterfile name glued with |-def.ps|; so if % your mastefile is named \texttt{JohnSmithMasterThesis.tex}, name this auxiliary file as % \texttt{JohnSmithMasterThesis-def.ps} and fill in the necessary metadata and other -% thechnical information into this file in the lines marked with |% Customize|. Then run +% technical information into this file in the lines marked with |% Customize|. Then run % the \prog{ghostscript} program with the proper name (different for Windows or UNIX-like % platforms) with the proper input parameters and options. There are strong chances that % if you follow the general recommendations shown here and in the document -% |toptesi-doc-xetex.pdf| file, the output file will be PDF/A compliant. -%\end{itemize} +% |toptesi-it-xetex.pdf| file, the output file will be PDF/A compliant. +%\end{enumerate} % % Let's warn you: if you are using Adobe Reader X (or later), this program will open % a PDF file beginning with an information header claiming that the file is PDF/A % compliant; maybe it's true, but do not trust this information too much, at least don't -% believe that this information is a ``certification'' of the PDF/A compliance. I have seen -% files with this comforting information that did not pass the Preflight test! -% -% Up to today the realization of PDF/A conforming files sets forth several problems -% that are of great concern for the large Institutions that have thousands of document -% a year to archive; it is not a question implied in the free nature of the \prog{pdflatex} -% and \prog{xelatex} programs, that, on the opposite, according to my experience have -% a very high rate of success in producing PDF/A compliant documents. If you stick to -% the default \TeX\ system Type~1 256-glyph, or to the UNICODE encoded otf or ttf fonts -% and use this patched version of \texttt{TOPtesi} you should be able to avoid most -% problems. +% believe that this information is a ``certification'' of the PDF/A compliance. I have +% seen files with this comforting information that did not pass the Preflight test! +% +% Up to today the realisation of PDF/A conforming files sets forth several problems +% that are of great concern for the large Institutions that have thousands of documents +% a year to archive; it is not a question implied in the free nature of the +% \prog{pdflatex} and \prog{xelatex} programs, that, on the opposite, according to my +% experience have a very high rate of success in producing PDF/A compliant documents. +% If you stick to the default \TeX\ system Type~1 256-glyph, or to the UNICODE encoded +% otf or ttf fonts and use this patched version of \texttt{TOPtesi} you should be able +% to avoid most problems. % % \StopEventually{} ^^A qui si puo' mettere una bibliografia % @@ -717,7 +776,7 @@ the TOPtesi bundle] % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} \ProvidesClass{toptesi}% -[2014/09/15 v.5.77 Class for typesetting university theses] +[2014/10/15 v.5.81 Class for typesetting university theses] % \end{macrocode} % % The class itself is very simple since it requires just the \texttt{report} document @@ -728,16 +787,17 @@ the TOPtesi bundle] % the |\ExecuteOption| command assures that |a4paper| is the default size, % but it is not being used if another paper size code is specified to the class. % The same holds true for the other class options, except for the encoding code -% string because they passing machinery does not hold true for the \pack{inputenc} +% string because their passing machinery does not hold true for the \pack{inputenc} % package; therefore this package is not loaded any more as it was in previous % versions\footnote{Thanks to Enrico Gregorio who pointed out this feature.} -% of the class. On the opposite if another language iss specified in the list of +% of the class. On the opposite if another language is specified in the list of % \pack{toptesi} class options, this language would be appended to the \pack{babel} % package default options and, beware!, it would become the default language. % \begin{macrocode} \DeclareOption{a4paper}{\PassOptionsToClass{\CurrentOption}{report}} +\DeclareOption{titlepage}{\PassOptionsToClass{\CurrentOption}{report}} \DeclareOption*{\PassOptionsToClass{\CurrentOption}{report}} -\ExecuteOptions{a4paper} +\ExecuteOptions{a4paper,titlepage} \ProcessOptions\relax \LoadClass{report} \RequirePackage{ifxetex} @@ -761,11 +821,11 @@ the TOPtesi bundle] % The greatest part of the \texttt{toptesi} class code is saved into a separate file % partly for backward compatibility reasons (before version 3.x \texttt{toptesi} was just % an extension to the \texttt{report} class) and partly because it might be used as a -% stand aolone package, although, take notice, it might conflict with the \texttt{book} class -% code and certainly it is incompatible with the \texttt{article} class. This package must -% contain its own \TeX\ format declaration and might have different version and subversion -% numbers compared to the class file and the other invoked packages that are part of the same -% bundle. +% stand alone package, although, take notice, it might conflict with the \texttt{book} +% class code and certainly it is incompatible with the \texttt{article} class. This +% package must contain its own \TeX\ format declaration and might have different +% version and subversion numbers compared to the class file and the other invoked +% packages that are part of the same bundle. % % \iffalse %<*topsty> @@ -773,7 +833,7 @@ the TOPtesi bundle] % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{toptesi}% -[2014/09/15 v.5.77 Extension for toptesi.cls]% +[2014/10/15 v.5.81 Extension for toptesi.cls]% % \end{macrocode} % % We start with defining the debugging macros; these trace commands and macros @@ -785,7 +845,8 @@ the TOPtesi bundle] \let\TROF\TROFF % \end{macrocode} % Now we define the specific package macros: \texttt{classica} and \texttt{trieste} -% are identical; \texttt{trieste} is maintained for backward compatibility. +% are identical; the use of \texttt{trieste} is discouraged, but this option is +% maintained for backward compatibility. % The option \texttt{14pt} is for choosing a normal size of 14pt; the class option % file \texttt{size14.clo} is distributed with the \pack{extsizes} package and % is already included in any complete distribution of the major \TeX\ system ones; @@ -795,21 +856,25 @@ the TOPtesi bundle] % % \texttt{chapterbib} allows to set a list of references at the end of each chapter. % -% For the options specific to the \texttt{classica} style a couple of boolean variables are +% For the options some boolean variables are % defined and the option definitions set them to the value ``true''. % \begin{macrocode} \newif\if@utoretitolo \@utoretitolofalse \newif\if@ldstyle \@ldstylefalse \newif\if@xivpt \@xivptfalse +\newif\ifT@Pfrontespizio \T@Pfrontespiziofalse +\newif\ifTOPfront \TOPfronttrue % \end{macrocode} % -% A binding correction is established; its default value is parametrized to +% A binding correction is established; its default value is parametrised to % the paper dimensions, even if this correction should actually not depend % on the aper size; the paper flexibility at the spine margin should be % independent from its width; nevertheless large sizes allow for larger % default corrections. In any case the user can override this setting by % using the specific command |\setbindingcorrection|. The recommendation -% to the user is to not exaggerate with this correction. +% to the user is to not exaggerate with this correction. The options +% |usefrontespizio| and |noTOPfront| are synonymous; the latter one should be +% preferred to the former one. % \begin{macrocode} \newlength\T@Pbinding\setlength\T@Pbinding{7mm} \def\setbindingcorrection#1{\T@Pbinding=#1} @@ -825,11 +890,13 @@ the TOPtesi bundle] \DeclareOption{autoretitolo}{\ifclassica\@utoretitolotrue\fi} \DeclareOption{oldstyle}{\ifclassica\@ldstyletrue\fi} \DeclareOption{pdfa}{\T@Ppdfatrue} +\DeclareOption{usefrontespizio}{\T@Pfrontespiziotrue\TOPfrontfalse} +\DeclareOption{noTOPfront}{\T@Pfrontespiziotrue\TOPfrontfalse} % \ProcessOptions\relax % \end{macrocode} % The \texttt{graphicx} package is loaded by default; it is required for inserting the -% university logo; if the user forgets that this package has already been loaded +% university logo(s); if the user forgets that this package has already been loaded % nothing dramatic happens, because the |\usepackage| and |\RequirePackage| macros % perform the necessary tests in order to avoid reloading the same packages again % and again. @@ -839,7 +906,9 @@ the TOPtesi bundle] \if@xivpt\input{size14.clo}\fi % \end{macrocode} % -% The |\texheight| is parametrized to the paper height and adjusted so as to contain an integer number of normal text lines. A new dimension is defined to hold the actual value of the inner/spine margin. +% The |\texheight| is parametrised to the paper height and adjusted so as to +% contain an integer number of normal text lines. A new dimension is defined +% to hold the actual value of the inner/spine margin. % % \begin{macrocode} \newlength\interno @@ -848,8 +917,8 @@ the TOPtesi bundle] \multiply\textheight by \baselineskip \advance\textheight by \topskip % \end{macrocode} -% The inner margin is parametrized to the paper width, but a small correction -% is made if the extra size of 14pt is chosen. Also footskip is parametrized +% The inner margin is parametrised to the paper width, but a small correction +% is made if the extra size of 14pt is chosen. Also |\footskip| is parametrised % to the paper height in a slightly different way when the large |14pt| size is chosen. % \begin{macrocode} \ifx\f@size\@xivpt @@ -860,7 +929,7 @@ the TOPtesi bundle] \footskip=2\baselineskip \fi % \end{macrocode} -% The convenience pod holding the spine margin didth in a dimensional register +% The convenience of holding the spine margin width in a dimensional register % becomes really useful now in order to define the other text body grid dimensions. % Without binding correction the inner and outer margin are chosen equal, but % the grid is moved outwards if the binding correction option is specified. @@ -886,7 +955,7 @@ the TOPtesi bundle] % \end{macrocode} % -% We now establish the page style. We start by setting to ``empy'' the tokens that +% We now establish the page style. We start by setting to ``empty'' the tokens that % keep the left and the right marks; we define a box so as to set the headers % inside this box; we redefine also the plain page styles; it is actually a leftover % from the previous versions when the page number was set at the foot in bold face, @@ -906,10 +975,11 @@ the TOPtesi bundle] \def\@evenhead{}\let\@evenfoot\@oddfoot} % \end{macrocode} % Other page styles are defined in a different way according to the choice of -% one side or two side printing. In any case the header is set without capitalization +% one side or two side printing. In any case the header is set without capitalisation % as it happens in all the default document classes, and it is underlined at a fixed -% distance from the base line. If the chapter or section heading a warning is issued -% so as to invite the user to exploit the sectioning commands optional short argument. +% distance from the base line. If the chapter or section heading exceed the +% |\textwidth| a warning is issued so as to invite the user to exploit the +% sectioning commands optional short argument. % \begin{macrocode} \if@twoside \def\ps@headings{\let\@mkboth\markboth% @@ -967,11 +1037,12 @@ the TOPtesi bundle] \fi} % \end{macrocode} % The various tables of contents or figures or tables require some boolean variables to -% be defined; in facts, although the ISO regulations require that every technical report contains -% the list of figures and/or tables, in Italy theses rarely contain these lists; after all: is -% a thesis a technical report? We require also some other boolean variables to handle -% the difference between front matter and main matter; this differences are already defined -% in the \texttt{book} document class, but not in the \texttt{report} one. +% be defined; in facts, although the ISO regulations require that every technical report +% contains the list of figures and/or tables, in Italy theses rarely contain these lists; +% after all: is a thesis a technical report? We require also some other boolean variables +% to handle the difference between front matter and main matter; this differences are +% already defined in the \texttt{book} document class, but not in the \texttt{report} +% one. % \begin{macrocode} \newif\iffigurespage \newif\iftablespage @@ -982,15 +1053,16 @@ the TOPtesi bundle] % of the document the default situation of front matter is established. % \begin{macrocode} \def\frontmatter{\clearpage\ps@plain\pagenumbering{roman}% - \numeriromanitrue\frontmattertrue\@openrightfalse} + \numeriromanitrue\frontmattertrue\@openrightfalse\c@secnumdepth=-2} \def\mainmatter{\if@twoside\@openrighttrue\fi + \numeriromanifalse\frontmatterfalse\c@secnumdepth=2 \clearpage\ps@headings\pagenumbering{arabic}% - \numeriromanifalse\frontmatterfalse} + } \AtBeginDocument{\frontmatter} % \end{macrocode} -% The main matter is automatically established with the first |\chapter| command issued by -% the user; this means that every command that starts a section at the ``chapter'' level -% within the front matter must be executed without an explicit call to |\chapter|. +% The main matter is automatically established with the first |\chapter| command issued +% by the user; this means that every command that starts a section at the ``chapter'' +% level within the front matter must be executed without an explicit call to |\chapter|. % % By default we set to false the boolean variables that control the typesetting of the % list of figures and the list of tables. @@ -1000,20 +1072,13 @@ the TOPtesi bundle] % \end{macrocode} % % Before going further on, we redefine the |\cleardoublepage| command so that -% it uses by default the plain page style, but it can be set to any other style; -% we define a blahk page style as an alias to an existing page style; then we -% define a command to let this page style to be an alias of some other page -% style; eventually we use this alias as the page style that |\cleardoublepage| -% uses for outputting the blank page in case it is necessary so as to open on -% a right page. The user can redefine the blank page style as often as he -% whishes, and, of course, it is better he plans such a redefinition in advance, -% before the need arises to output a blank page. -% \begin{macrocode} -\newcommand\blankpagestyle[1]{\def\blank@ps{#1}} -\def\blank@ps{plain} -\renewcommand\cleardoublepage{\clearpage\ifodd\value{page}\else +% it uses by default the plain page style, but it can be set to any other style. +% \begin{macrocode} +\let\ps@blank\ps@plain +\newcommand*\blankpagestyle[1]{\expandafter\let\expandafter\blank@ps\csname ps@#1\endcsname} +\renewcommand\cleardoublepage[1][blank]{\clearpage\ifodd\value{page}\else \if@twoside\if@openright -\clearpage\null\thispagestyle{\blank@ps}\clearpage\fi\fi\fi} +\clearpage\null\thispagestyle{#1}\clearpage\fi\fi\fi} % \end{macrocode} % % We have to define the front matter sectioning names |\sommario| and |\ringraziamenti| @@ -1021,19 +1086,13 @@ the TOPtesi bundle] % \begin{macrocode} \def\sommario{% \iffrontmatter\else\frontmattertrue\fi - \if@openright\cleardoublepage\else\clearpage\fi - \global\@topnum\z@ - \@afterindentfalse - \@schapter{\summaryname}% + \chapter*{\summaryname}% \addcontentsline{toc}{chapter}{\summaryname}% } % \def\ringraziamenti{% \iffrontmatter\else\frontmattertrue\fi - \if@openright\cleardoublepage\else\clearpage\fi - \global\@topnum\z@ - \@afterindentfalse - \@schapter{\acknowledgename}% + \chapter*{\acknowledgename}% \addcontentsline{toc}{chapter}{\acknowledgename}% } % \end{macrocode} @@ -1043,24 +1102,64 @@ the TOPtesi bundle] % Italian and English. % % We have to modify the |\chapter| and |\part| commands so that as the user -% first issues one of these commands the typesetting style is switched to the -% one for the main matter. -% \begin{macrocode} -\renewcommand\chapter{% - \iffrontmatter\mainmatter\fi - \if@openright\cleardoublepage\else\clearpage\fi - \thispagestyle{plain}% - \global\@topnum\z@ - \@afterindentfalse - \secdef\@chapter\@schapter} -% -\renewcommand\part{% - \iffrontmatter\mainmatter\fi - \if@openright\cleardoublepage\else\clearpage\fi - \thispagestyle{empty}% - \if@twocolumn\onecolumn\@tempswatrue\else\@tempswafalse\fi - \null\vfil - \secdef\@part\@spart} +% first issues one of these commands the typesetting style is switched to that +% of the main matter. Actually it is not necessary to redefine the whole +% commands, but just those of the unstarred versions. In facts the starred +% chapter commands to typeset the Summary and the Acknowledgements chapters, +% as defined above, are regularly typeset in the style of the front matter, +% opening on any page (even or odd) and numbered with small caps roman numerals. +% \begin{macrocode} +%\renewcommand\chapter{% +% \iffrontmatter\mainmatter\fi +% \if@openright\cleardoublepage\else\clearpage\fi +% \thispagestyle{plain}% +% \global\@topnum\z@ +% \@afterindentfalse +% \secdef\@chapter\@schapter} +\def\@chapter[#1]#2{\iffrontmatter\mainmatter\fi + \ifnum \c@secnumdepth >\m@ne + \refstepcounter{chapter}% + \typeout{\@chapapp\space\thechapter.}% + \addcontentsline{toc}{chapter}% + {\protect\numberline{\thechapter}#1}% + \else + \addcontentsline{toc}{chapter}{#1}% + \fi + \chaptermark{#1}% + \addtocontents{lof}{\protect\addvspace{10\p@}}% + \addtocontents{lot}{\protect\addvspace{10\p@}}% + \if@twocolumn + \@topnewpage[\@makechapterhead{#2}]% + \else + \@makechapterhead{#2}% + \@afterheading + \fi} +% +%\renewcommand\part{% +% \iffrontmatter\mainmatter\fi +% \if@openright\cleardoublepage\else\clearpage\fi +% \thispagestyle{empty}% +% \if@twocolumn\onecolumn\@tempswatrue\else\@tempswafalse\fi +% \null\vfil +% \secdef\@part\@spart} +\def\@part[#1]#2{\iffrontmatter\mainmatter\fi + \ifnum \c@secnumdepth >-2\relax + \refstepcounter{part}% + \addcontentsline{toc}{part}{\thepart\hspace{1em}#1}% + \else + \addcontentsline{toc}{part}{#1}% + \fi + \markboth{}{}% + {\centering + \interlinepenalty \@M + \normalfont + \ifnum \c@secnumdepth >-2\relax + \huge\bfseries \partname\nobreakspace\thepart + \par + \vskip 20\p@ + \fi + \Huge \bfseries #2\par}% + \@endpart} % \end{macrocode} % At the same time we have to make sure that |\tableofcontents|, % |\listoftables| and |\listoffigures| do not exit from the front matter style. @@ -1434,21 +1533,21 @@ Skipping any redefinition\MessageBreak}% % redefined so as to agree with the default language. If a different % default language is desired, we recall it again, it is necessary to do % the following: -% \begin{itemize} +% \begin{enumerate} % \item specify |\english| \emph{after} the |\begin{document}| statement, % if English is supposed to be the default language, or % \item specify the language name, other than Italian or English, among % the class options; use the |\ExtendCaptions| macro for extending the % list of sectioning commands infix strings as explained above; % specify with |\selectlanguage| the new language as the default one -% \emph{after} the |\begin{document}| statement. -% \item If XeLaTeX is being used for typesetting it suffices to specify +% \emph{after} the |\begin{document}| statement; +% \item if XeLaTeX is being used for typesetting it suffices to specify % in the preamble the name of the other language to be used, by means % of the |setotherlanguage| command, and to define the summary and % acknowledgments names in the same way as with pdf\/\LaTeX; the same % must be done at the beginning of the document to declare the new % language a the default one. -% \end{itemize} +% \end{enumerate} % \begin{macrocode} \AtBeginDocument{% \italiano @@ -1457,7 +1556,9 @@ Skipping any redefinition\MessageBreak}% % \end{macrocode} % % At last the subsidiary and independent packages \texttt{topcoman} and -% \texttt{topfront} are requested for input. For using XeLaTeX as the +% \texttt{topfront} are requested for input the former is loaded only if +% at the |documentclass| level the option |usefrontespizio| has NOT been +% declared. For using XeLaTeX as the % typesetting engine it's necessary to load such packages at the ``begin % document'' step, so that all a the other settings, especially fonts % are already established. May be it should be better done also when @@ -1465,11 +1566,16 @@ Skipping any redefinition\MessageBreak}% % has not shown any inconvenience. % \begin{macrocode} \ifxetex -\AtBeginDocument{% - \RequirePackage{topfront}% - \RequirePackage{topcoman}% -}\else - \RequirePackage{topfront}% + \AtBeginDocument{% + \unless\ifT@Pfrontespizio + \RequirePackage{topfront} + \fi + \RequirePackage{topcoman}% + } +\else + \unless\ifT@Pfrontespizio + \RequirePackage{topfront} + \fi \RequirePackage{topcoman}% \fi % \end{macrocode} @@ -1563,12 +1669,13 @@ Skipping any redefinition\MessageBreak}% % The singular and plural masculine and feminine strings for ``candidate'' are redefined. % For other languages the configuration file comes in handy. % \begin{macrocode} +\ifTOPfront \ifclassica \def\Candidato{Laureando} \def\Candidata{Laureanda} \def\Candidati{Laureandi} \def\Candidate{Laureande} -\fi +\fi\fi % \end{macrocode} % % Since theses in humanities may end up to occupy several volumes (classically @@ -1786,7 +1893,7 @@ Skipping any redefinition\MessageBreak}% %</topsty> % \fi % -% \subsection{The package file \texttt{topfront.sty}} +% \subsection{The \texttt{topfront.sty} code} % This file is input by \texttt{toptesi}, version 5.x, but it can be used as an % independent extension package. % @@ -1805,7 +1912,7 @@ Skipping any redefinition\MessageBreak}% % \fi % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{topfront}[2014/09/15 v.5.77 Title page for TOPtesi] +\ProvidesPackage{topfront}[2014/10/15 v.5.81 Title page for TOPtesi] % \end{macrocode} % Per l'uso di topfront come pacchetto autonomo bisogna verificare che l'opzione |classica| % corrisponda ad una impostazione corretta di |\ifclassica|; siccome questo |\if| è definito @@ -1824,9 +1931,9 @@ Skipping any redefinition\MessageBreak}% % in the header and some other in the footer, without actually changing the % page layout, except for centering the grid horizontally in the page. % The headers, due to a specific request of Politecnico di Torino, is to have -% the university logo(s) in the header; other universities maintains their +% the university logo(s) in the header; other universities maintain their % logo(s) in the lower part of the page as it was done all the time in the -% past. We need the some device to switch positions to the logos, without +% past. We need some device to switch positions to the logos, without % actually changing the page layout. Since the logo(s) are sort of large, % the header must smash the header contents, so as to avoid any modification % of the position and size of the other parts of the page. The |TPT@logobox| @@ -1854,7 +1961,7 @@ Skipping any redefinition\MessageBreak}% } % \end{macrocode} % -% similarly a different title page style for typesetting the logos in the +% Similarly a different title page style for typesetting the logos in the % lower half of the page is defined; since it is the only style usable % with the |classica| option, we call it the |classica| page style: % \begin{macrocode} @@ -1877,23 +1984,24 @@ Skipping any redefinition\MessageBreak}% \let\@evenfoot\@oddfoot }% % \end{macrocode} - % -% The title page information depends on the type of ``thesis' that is being typeset. -% The following commands specify the kind of information that is going to be typeset. -% Some boolean variables are automatically set by the commands in order to change some -% formatting depending on the kind of thesis. For languages that distinguish feminine from -% masculine adjectives or qualifications some automatic machinery is set up in order to -% format some infix strings in a way that copes with the singular or plural forms; in -% particular when there is a multitude of authors (maximum three) of different gender the -% adjectives or qualifications are set masculine plurals, while when there is just one -% author or the authors are of the same gender the adjectives or qualifications are set -% according to number and gender. Al this is done by setting or resetting the truth value -% associated to the boolean variable \texttt{femminile}. The boolean variable -% \texttt{dottorato} controls the PhD thesis format, while the other variable -% \texttt{laureatriennale} controls the formatting of the bachelor's degree report. All -% other theses are treated as master theses, and in all cases the appropriate infix string -% is typeset in the title page: +% The title page information depends on the type of ``thesis'' that is being +% typeset. The following commands specify the kind of information that is +% going to be typeset. Some boolean variables are automatically set by the +% commands in order to change some formatting depending on the kind of thesis. +% For languages that distinguish feminine from masculine adjectives or +% qualifications some automatic machinery is set up in order to format some +% infix strings in a way that copes with the singular or plural forms; in +% particular when there is a multitude of authors (maximum three) of different +% gender the adjectives or qualifications are set masculine plurals, while +% when there is just one author or the authors are of the same gender the +% adjectives or qualifications are set according to number and gender. +% All this is done by setting or resetting the truth value associated to +% the boolean variable \texttt{femminile}. The boolean variable +% \texttt{dottorato} controls the PhD thesis format, while the other +% variable \texttt{laureatriennale} controls the formatting of the +% bachelor's degree report. All other theses are treated as master theses, +% and in all cases the appropriate infix string is typeset in the title page: % \begin{macrocode} \newif\iffemminile \newif\ifdottorato \dottoratofalse @@ -2749,7 +2857,7 @@ Skipping any redefinition\MessageBreak}% %</topcfg> % \fi % -% \subsection{The package file \texttt{topcoman.sty}} +% \subsection{The \texttt{topcoman.sty} code} % This file may be used as an independent extension package for the \texttt{report} % document class, and possibly for other classes % \iffalse @@ -2758,7 +2866,7 @@ Skipping any redefinition\MessageBreak}% % \begin{macrocode} \NeedsTeXFormat{LaTeX2e} % lavora solo con LaTeX 2e \ProvidesPackage{topcoman}% - [2014/09/15 v.5.77 Additional commands for the TOPtesi bundle] + [2014/10/15 v.5.81 Additional commands for the TOPtesi bundle] % \end{macrocode} % The new command |\DeclareSlantedCapitalGreekLetters| optionally sets the capital % Greek letters in math mode with the glyphs taken from the math italic fonts, not from diff --git a/Master/texmf-dist/tex/latex/toptesi/topcoman.sty b/Master/texmf-dist/tex/latex/toptesi/topcoman.sty index 94573af9bca..cff1b58b6cb 100644 --- a/Master/texmf-dist/tex/latex/toptesi/topcoman.sty +++ b/Master/texmf-dist/tex/latex/toptesi/topcoman.sty @@ -7,7 +7,7 @@ %% toptesi.dtx (with options: `topcmn') %% ______________________________________________________ %% The TOPtesi package -%% Copyright (C) 2013 Claudio Beccari +%% Copyright (C) 2014 Claudio Beccari %% All rights reserved %% %% License information appended @@ -29,7 +29,7 @@ %% Right brace \} Tilde \~} \NeedsTeXFormat{LaTeX2e} % lavora solo con LaTeX 2e \ProvidesPackage{topcoman}% - [2014/09/15 v.5.77 Additional commands for the TOPtesi bundle] + [2014/10/15 v.5.81 Additional commands for the TOPtesi bundle] \RequirePackage{ifxetex} \ifxetex\else \newcommand*\DeclareSlantedCapitalGreekLetters{% @@ -95,7 +95,7 @@ \let\p@figure\empty\let\p@table\empty} \DisableFigTabNames %% -%% Copyright 2005-2013 Claudio Beccari +%% Copyright 2005-2014 Claudio Beccari %% %% Distributable under the LaTeX Project Public License, %% version 1.3c or higher (your choice). The latest version of @@ -110,22 +110,26 @@ %% toptesi.cfg, and the English documentation toptesi.pdf. %% %% Furthermore the bundle contains the documentation source -%% file toptesi-doc-xetex.tex and the derived file -%% toptesi-doc-xetex.pdf. +%% file toptesi-it-xetex.tex and the derived file +%% toptesi-it-xetex.pdf. %% %% The toptesi-example.tex source file is just an example %% that shows how to use the various commands; by commenting %% or uncommenting certain source lines it is possible to -%% typeset different kind of theses and their frontpages. +%% typeset different kind of theses and their front pages. +%% +%% The topfront-example.tex source file is an example of how +%% to produce just the title page with toptesi and the external +%% package frontespizio. %% %% The toptesi.cfg file is a sample of a local configuration %% file that can be freely edited and modified. %% %% By running pdflatex on toptesi.dtx the user gets the class, %% sty and cfg files and the English documentation file in -%% pdf format. +%% pdf format. %% -%% The documentation file toptesi-doc-xetex.pdf is in Italian; +%% The documentation file toptesi-it-xetex.pdf is in Italian; %% its source file is another example of how to use toptesi. %% %% End of file `topcoman.sty'. diff --git a/Master/texmf-dist/tex/latex/toptesi/topfront.sty b/Master/texmf-dist/tex/latex/toptesi/topfront.sty index 58ad7801aa1..2b24d38be65 100644 --- a/Master/texmf-dist/tex/latex/toptesi/topfront.sty +++ b/Master/texmf-dist/tex/latex/toptesi/topfront.sty @@ -7,7 +7,7 @@ %% toptesi.dtx (with options: `topfrn') %% ______________________________________________________ %% The TOPtesi package -%% Copyright (C) 2013 Claudio Beccari +%% Copyright (C) 2014 Claudio Beccari %% All rights reserved %% %% License information appended @@ -28,7 +28,7 @@ %% Grave accent \` Left brace \{ Vertical bar \| %% Right brace \} Tilde \~} \NeedsTeXFormat{LaTeX2e} -\ProvidesPackage{topfront}[2014/09/15 v.5.77 Title page for TOPtesi] +\ProvidesPackage{topfront}[2014/10/15 v.5.81 Title page for TOPtesi] \@ifpackageloaded{etoolbox}{}{\RequirePackage{etoolbox}} \ifcsundef{ifclassica}{% \newif\ifclassica @@ -69,7 +69,6 @@ \let\@evenhead\@oddhead \let\@evenfoot\@oddfoot }% - \newif\iffemminile \newif\ifdottorato \dottoratofalse \newif\iflaureatriennale \laureatriennalefalse @@ -444,7 +443,7 @@ {\null\vfill\pagestyle{empty}\@retrofrontespizio\par\clearpage}% \endgroup} %% -%% Copyright 2005-2013 Claudio Beccari +%% Copyright 2005-2014 Claudio Beccari %% %% Distributable under the LaTeX Project Public License, %% version 1.3c or higher (your choice). The latest version of @@ -459,22 +458,26 @@ %% toptesi.cfg, and the English documentation toptesi.pdf. %% %% Furthermore the bundle contains the documentation source -%% file toptesi-doc-xetex.tex and the derived file -%% toptesi-doc-xetex.pdf. +%% file toptesi-it-xetex.tex and the derived file +%% toptesi-it-xetex.pdf. %% %% The toptesi-example.tex source file is just an example %% that shows how to use the various commands; by commenting %% or uncommenting certain source lines it is possible to -%% typeset different kind of theses and their frontpages. +%% typeset different kind of theses and their front pages. +%% +%% The topfront-example.tex source file is an example of how +%% to produce just the title page with toptesi and the external +%% package frontespizio. %% %% The toptesi.cfg file is a sample of a local configuration %% file that can be freely edited and modified. %% %% By running pdflatex on toptesi.dtx the user gets the class, %% sty and cfg files and the English documentation file in -%% pdf format. +%% pdf format. %% -%% The documentation file toptesi-doc-xetex.pdf is in Italian; +%% The documentation file toptesi-it-xetex.pdf is in Italian; %% its source file is another example of how to use toptesi. %% %% End of file `topfront.sty'. diff --git a/Master/texmf-dist/tex/latex/toptesi/toptesi.cfg b/Master/texmf-dist/tex/latex/toptesi/toptesi.cfg index 4386f0b4440..8dac35306b2 100644 --- a/Master/texmf-dist/tex/latex/toptesi/toptesi.cfg +++ b/Master/texmf-dist/tex/latex/toptesi/toptesi.cfg @@ -7,7 +7,7 @@ %% toptesi.dtx (with options: `topcfg') %% ______________________________________________________ %% The TOPtesi package -%% Copyright (C) 2013 Claudio Beccari +%% Copyright (C) 2014 Claudio Beccari %% All rights reserved %% %% License information appended @@ -56,7 +56,7 @@ %%\CycleName{ciclo} %%\retrofrontespizio{Questo testo è soggetto alla Creative Commons Licence} %% -%% Copyright 2005-2013 Claudio Beccari +%% Copyright 2005-2014 Claudio Beccari %% %% Distributable under the LaTeX Project Public License, %% version 1.3c or higher (your choice). The latest version of @@ -71,22 +71,26 @@ %% toptesi.cfg, and the English documentation toptesi.pdf. %% %% Furthermore the bundle contains the documentation source -%% file toptesi-doc-xetex.tex and the derived file -%% toptesi-doc-xetex.pdf. +%% file toptesi-it-xetex.tex and the derived file +%% toptesi-it-xetex.pdf. %% %% The toptesi-example.tex source file is just an example %% that shows how to use the various commands; by commenting %% or uncommenting certain source lines it is possible to -%% typeset different kind of theses and their frontpages. +%% typeset different kind of theses and their front pages. +%% +%% The topfront-example.tex source file is an example of how +%% to produce just the title page with toptesi and the external +%% package frontespizio. %% %% The toptesi.cfg file is a sample of a local configuration %% file that can be freely edited and modified. %% %% By running pdflatex on toptesi.dtx the user gets the class, %% sty and cfg files and the English documentation file in -%% pdf format. +%% pdf format. %% -%% The documentation file toptesi-doc-xetex.pdf is in Italian; +%% The documentation file toptesi-it-xetex.pdf is in Italian; %% its source file is another example of how to use toptesi. %% %% End of file `toptesi.cfg'. diff --git a/Master/texmf-dist/tex/latex/toptesi/toptesi.cls b/Master/texmf-dist/tex/latex/toptesi/toptesi.cls index edd327a70fd..40d4e50f22d 100644 --- a/Master/texmf-dist/tex/latex/toptesi/toptesi.cls +++ b/Master/texmf-dist/tex/latex/toptesi/toptesi.cls @@ -7,7 +7,7 @@ %% toptesi.dtx (with options: `class') %% ______________________________________________________ %% The TOPtesi package -%% Copyright (C) 2013 Claudio Beccari +%% Copyright (C) 2014 Claudio Beccari %% All rights reserved %% %% License information appended @@ -29,10 +29,11 @@ %% Right brace \} Tilde \~} \NeedsTeXFormat{LaTeX2e} \ProvidesClass{toptesi}% -[2014/09/15 v.5.77 Class for typesetting university theses] +[2014/10/15 v.5.81 Class for typesetting university theses] \DeclareOption{a4paper}{\PassOptionsToClass{\CurrentOption}{report}} +\DeclareOption{titlepage}{\PassOptionsToClass{\CurrentOption}{report}} \DeclareOption*{\PassOptionsToClass{\CurrentOption}{report}} -\ExecuteOptions{a4paper} +\ExecuteOptions{a4paper,titlepage} \ProcessOptions\relax \LoadClass{report} \RequirePackage{ifxetex} @@ -48,7 +49,7 @@ \fi \RequirePackage{toptesi} %% -%% Copyright 2005-2013 Claudio Beccari +%% Copyright 2005-2014 Claudio Beccari %% %% Distributable under the LaTeX Project Public License, %% version 1.3c or higher (your choice). The latest version of @@ -63,22 +64,26 @@ %% toptesi.cfg, and the English documentation toptesi.pdf. %% %% Furthermore the bundle contains the documentation source -%% file toptesi-doc-xetex.tex and the derived file -%% toptesi-doc-xetex.pdf. +%% file toptesi-it-xetex.tex and the derived file +%% toptesi-it-xetex.pdf. %% %% The toptesi-example.tex source file is just an example %% that shows how to use the various commands; by commenting %% or uncommenting certain source lines it is possible to -%% typeset different kind of theses and their frontpages. +%% typeset different kind of theses and their front pages. +%% +%% The topfront-example.tex source file is an example of how +%% to produce just the title page with toptesi and the external +%% package frontespizio. %% %% The toptesi.cfg file is a sample of a local configuration %% file that can be freely edited and modified. %% %% By running pdflatex on toptesi.dtx the user gets the class, %% sty and cfg files and the English documentation file in -%% pdf format. +%% pdf format. %% -%% The documentation file toptesi-doc-xetex.pdf is in Italian; +%% The documentation file toptesi-it-xetex.pdf is in Italian; %% its source file is another example of how to use toptesi. %% %% End of file `toptesi.cls'. diff --git a/Master/texmf-dist/tex/latex/toptesi/toptesi.sty b/Master/texmf-dist/tex/latex/toptesi/toptesi.sty index 0ae7076ef2f..566af875499 100644 --- a/Master/texmf-dist/tex/latex/toptesi/toptesi.sty +++ b/Master/texmf-dist/tex/latex/toptesi/toptesi.sty @@ -7,7 +7,7 @@ %% toptesi.dtx (with options: `topsty') %% ______________________________________________________ %% The TOPtesi package -%% Copyright (C) 2013 Claudio Beccari +%% Copyright (C) 2014 Claudio Beccari %% All rights reserved %% %% License information appended @@ -29,13 +29,15 @@ %% Right brace \} Tilde \~} \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{toptesi}% -[2014/09/15 v.5.77 Extension for toptesi.cls]% +[2014/10/15 v.5.81 Extension for toptesi.cls]% \def\TRON{\tracingcommands \tw@ \tracingmacros \tw@} \def\TROFF{\tracingcommands\z@ \tracingmacros \z@} \let\TROF\TROFF \newif\if@utoretitolo \@utoretitolofalse \newif\if@ldstyle \@ldstylefalse \newif\if@xivpt \@xivptfalse +\newif\ifT@Pfrontespizio \T@Pfrontespiziofalse +\newif\ifTOPfront \TOPfronttrue \newlength\T@Pbinding\setlength\T@Pbinding{7mm} \def\setbindingcorrection#1{\T@Pbinding=#1} \newif\if@binding \@bindingfalse @@ -50,6 +52,8 @@ \DeclareOption{autoretitolo}{\ifclassica\@utoretitolotrue\fi} \DeclareOption{oldstyle}{\ifclassica\@ldstyletrue\fi} \DeclareOption{pdfa}{\T@Ppdfatrue} +\DeclareOption{usefrontespizio}{\T@Pfrontespiziotrue\TOPfrontfalse} +\DeclareOption{noTOPfront}{\T@Pfrontespiziotrue\TOPfrontfalse} \ProcessOptions\relax \RequirePackage{graphicx} \RequirePackage{etoolbox} @@ -146,48 +150,65 @@ \newif\ifnumeriromani \newif\iffrontmatter \def\frontmatter{\clearpage\ps@plain\pagenumbering{roman}% - \numeriromanitrue\frontmattertrue\@openrightfalse} + \numeriromanitrue\frontmattertrue\@openrightfalse\c@secnumdepth=-2} \def\mainmatter{\if@twoside\@openrighttrue\fi + \numeriromanifalse\frontmatterfalse\c@secnumdepth=2 \clearpage\ps@headings\pagenumbering{arabic}% - \numeriromanifalse\frontmatterfalse} + } \AtBeginDocument{\frontmatter} \figurespagefalse \tablespagefalse -\newcommand\blankpagestyle[1]{\def\blank@ps{#1}} -\def\blank@ps{plain} -\renewcommand\cleardoublepage{\clearpage\ifodd\value{page}\else +\let\ps@blank\ps@plain +\newcommand*\blankpagestyle[1]{\expandafter\let\expandafter\blank@ps\csname ps@#1\endcsname} +\renewcommand\cleardoublepage[1][blank]{\clearpage\ifodd\value{page}\else \if@twoside\if@openright -\clearpage\null\thispagestyle{\blank@ps}\clearpage\fi\fi\fi} +\clearpage\null\thispagestyle{#1}\clearpage\fi\fi\fi} \def\sommario{% \iffrontmatter\else\frontmattertrue\fi - \if@openright\cleardoublepage\else\clearpage\fi - \global\@topnum\z@ - \@afterindentfalse - \@schapter{\summaryname}% + \chapter*{\summaryname}% \addcontentsline{toc}{chapter}{\summaryname}% } \def\ringraziamenti{% \iffrontmatter\else\frontmattertrue\fi - \if@openright\cleardoublepage\else\clearpage\fi - \global\@topnum\z@ - \@afterindentfalse - \@schapter{\acknowledgename}% + \chapter*{\acknowledgename}% \addcontentsline{toc}{chapter}{\acknowledgename}% } -\renewcommand\chapter{% - \iffrontmatter\mainmatter\fi - \if@openright\cleardoublepage\else\clearpage\fi - \thispagestyle{plain}% - \global\@topnum\z@ - \@afterindentfalse - \secdef\@chapter\@schapter} -\renewcommand\part{% - \iffrontmatter\mainmatter\fi - \if@openright\cleardoublepage\else\clearpage\fi - \thispagestyle{empty}% - \if@twocolumn\onecolumn\@tempswatrue\else\@tempswafalse\fi - \null\vfil - \secdef\@part\@spart} +\def\@chapter[#1]#2{\iffrontmatter\mainmatter\fi + \ifnum \c@secnumdepth >\m@ne + \refstepcounter{chapter}% + \typeout{\@chapapp\space\thechapter.}% + \addcontentsline{toc}{chapter}% + {\protect\numberline{\thechapter}#1}% + \else + \addcontentsline{toc}{chapter}{#1}% + \fi + \chaptermark{#1}% + \addtocontents{lof}{\protect\addvspace{10\p@}}% + \addtocontents{lot}{\protect\addvspace{10\p@}}% + \if@twocolumn + \@topnewpage[\@makechapterhead{#2}]% + \else + \@makechapterhead{#2}% + \@afterheading + \fi} +\def\@part[#1]#2{\iffrontmatter\mainmatter\fi + \ifnum \c@secnumdepth >-2\relax + \refstepcounter{part}% + \addcontentsline{toc}{part}{\thepart\hspace{1em}#1}% + \else + \addcontentsline{toc}{part}{#1}% + \fi + \markboth{}{}% + {\centering + \interlinepenalty \@M + \normalfont + \ifnum \c@secnumdepth >-2\relax + \huge\bfseries \partname\nobreakspace\thepart + \par + \vskip 20\p@ + \fi + \Huge \bfseries #2\par}% + \@endpart} \renewcommand\tableofcontents{% \if@twocolumn\@restonecoltrue\onecolumn\else\@restonecolfalse\fi \if@openright\cleardoublepage\else\clearpage\fi @@ -368,11 +389,16 @@ Skipping any redefinition\MessageBreak}% \renewcommand\@chapapp{\chaptername}% } \ifxetex -\AtBeginDocument{% -\RequirePackage{topfront}% -\RequirePackage{topcoman}% -}\else -\RequirePackage{topfront}% + \AtBeginDocument{% + \unless\ifT@Pfrontespizio + \RequirePackage{topfront} + \fi + \RequirePackage{topcoman}% + } +\else +\unless\ifT@Pfrontespizio + \RequirePackage{topfront} +\fi \RequirePackage{topcoman}% \fi \ifxetex\else @@ -403,12 +429,13 @@ Skipping any redefinition\MessageBreak}% \RequirePackage{hyperref} \fi \fi +\ifTOPfront \ifclassica \def\Candidato{Laureando} \def\Candidata{Laureanda} \def\Candidati{Laureandi} \def\Candidate{Laureande} -\fi +\fi\fi \newcounter{tomo} \newcommand*{\tomo}{\clearpage\stepcounter{tomo}\frontespizio} \renewcommand*{\lapagina}{% @@ -516,7 +543,7 @@ Skipping any redefinition\MessageBreak}% \endlist\clearpage } %% -%% Copyright 2005-2013 Claudio Beccari +%% Copyright 2005-2014 Claudio Beccari %% %% Distributable under the LaTeX Project Public License, %% version 1.3c or higher (your choice). The latest version of @@ -531,22 +558,26 @@ Skipping any redefinition\MessageBreak}% %% toptesi.cfg, and the English documentation toptesi.pdf. %% %% Furthermore the bundle contains the documentation source -%% file toptesi-doc-xetex.tex and the derived file -%% toptesi-doc-xetex.pdf. +%% file toptesi-it-xetex.tex and the derived file +%% toptesi-it-xetex.pdf. %% %% The toptesi-example.tex source file is just an example %% that shows how to use the various commands; by commenting %% or uncommenting certain source lines it is possible to -%% typeset different kind of theses and their frontpages. +%% typeset different kind of theses and their front pages. +%% +%% The topfront-example.tex source file is an example of how +%% to produce just the title page with toptesi and the external +%% package frontespizio. %% %% The toptesi.cfg file is a sample of a local configuration %% file that can be freely edited and modified. %% %% By running pdflatex on toptesi.dtx the user gets the class, %% sty and cfg files and the English documentation file in -%% pdf format. +%% pdf format. %% -%% The documentation file toptesi-doc-xetex.pdf is in Italian; +%% The documentation file toptesi-it-xetex.pdf is in Italian; %% its source file is another example of how to use toptesi. %% %% End of file `toptesi.sty'. |