diff options
author | Karl Berry <karl@freefriends.org> | 2016-07-03 20:44:48 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2016-07-03 20:44:48 +0000 |
commit | f0c23554405bd929a290a9a0532aeecaaf94a255 (patch) | |
tree | 4a9730b12ca293aff5d45d29dacd8c857014c3c9 /Master/texmf-dist/doc/latex/toptesi | |
parent | 94626ee0ec44f738d36151189f2e0ef4327d91b7 (diff) |
toptesi (3jul16)
git-svn-id: svn://tug.org/texlive/trunk@41608 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/toptesi')
13 files changed, 472 insertions, 915 deletions
diff --git a/Master/texmf-dist/doc/latex/toptesi/README b/Master/texmf-dist/doc/latex/toptesi/README index efcf0fba14d..7eb518c5609 100644 --- a/Master/texmf-dist/doc/latex/toptesi/README +++ b/Master/texmf-dist/doc/latex/toptesi/README @@ -1,5 +1,5 @@ -TOPtesi bundle version 5.91 of 2015 -Copyright 2015 Claudio Beccari +TOPtesi bundle version 5.92 of 2016 +Copyright 2008-2016 Claudio Beccari LaTeX Project Public Licence LPPL v.1.3 (or later) The TOPtesi bundle contains everything is needed for typesetting a @@ -16,10 +16,10 @@ 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 version 5.91 of TOPtesi is intended to be compliant also with XeLaTeX +This version 5.92 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. This particular part -is up to date with respect to package pdfx dated 2015/02/17 v.1.5.3 and +is up to date with respect to package pdfx dated 2016/05/03 v.1.5.8 and to ghostscript 9.16. Version 5.90 has been enhanced with some more class options that allow @@ -29,17 +29,26 @@ page in different styles. Version 5.90 has a completely enhanced and redone Italian documentation file toptesi-it-pdftex.pdf. +Version 5.91 contained some small enhancements and bug corrections. + +Version 5.92, besides some more little enhancements and bug correction, +has its documentation completely redone in order to upgrade it to the +most recent version (1.5.8) of the pdfx package needed to produce PDF/A +compliant PDF output files; in particular now PDF/A compliant files can +be produced also with LuaLaTeX that require a little more care than +pdfLaTeX, but no tricks are now needed to use LuaLaTeX (version 0.95). + For installation, if the package is not already installed in your TeX system distribution, either read the Italian documentation -toptesi-it-pdftex.pdf or quickly decompress the toptesi.zip file +toptesi-it.pdf or quickly decompress the toptesi.zip file and move all files to: .../texmf/source/latex/toptesi. Run pdflatex on toptesi.dtx in order to get the class, style and configuration files (and the pdf documentation in English) and move -the .tex, .cls, .sty, .xmpdata, .ps and .cfg files (including the +the .tex, .cls, .sty, and .cfg files (including the example .tex and .pdf files) to .../texmf/tex/latex/toptesi/; move to this folder also the GuITlogo.pdf, MPlogo.pdf, Logouno.pdf, Logodue.pdf, Logotre.pdf, Logoquattro.pdf, and Logoblu.pdf files. @@ -61,8 +70,8 @@ that is present in your texmf tree. Remember to refresh the filename database if you are using a MiKTeX installation! -If the package is already installed (it is with complete TeXLive or -complete MiKTeX distributions. In this case you don't need to +The package is already installed with complete TeXLive or +MiKTeX distributions. 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 manager to upgrade your installation, but don't ever move or change diff --git a/Master/texmf-dist/doc/latex/toptesi/manifest.txt b/Master/texmf-dist/doc/latex/toptesi/manifest.txt index a728753c7be..256c7a57a3a 100644 --- a/Master/texmf-dist/doc/latex/toptesi/manifest.txt +++ b/Master/texmf-dist/doc/latex/toptesi/manifest.txt @@ -1,5 +1,5 @@ -manifest.txt (TOPtesi version 5.91) -Copyright 2008-2015 Claudio Beccari +manifest.txt (TOPtesi version 5.92) +Copyright 2008-2016 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 @@ -20,13 +20,10 @@ This work consists of the following files: manifest.txt toptesi.dtx toptesi-example.tex - toptesi-example-xetex.tex + toptesi-example-luatex.tex toptesi-example-con-frontespizio.tex topfront-example README - toptesi-example.xmpdata - toptesi-it-xetex-def.ps - toptesi-it-pdftex.xmpdata toptesi-it-pdftex.tex The files derived from the work are the following: @@ -47,17 +44,17 @@ 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 files besides the toptesi configuration file, together with the English documented file. -The Italian documentation is obtained by running pdfLaTeX on -toptesi-it-pdftex.tex; this documentation has been completely redone compared -to previous versions. +The Italian documentation is obtained by running pdfLaTeX or LuaLaTeX on +toptesi-it.tex; this documentation has been completely redone compared +to previous versions. With both compilers the result should be PDF/A-1b compliant -The two documentations pdf files, toptesi.pdf and toptesi-it-pdftex.pdf, +The two documentations pdf files, toptesi.pdf and toptesi-it.pdf, are complementary to one another. The four files toptesi-example.tex -toptesi-example-xetex.tex +toptesi-example-luatex.tex topfront-example.tex toptesi-example-con-frontespizio.tex diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-example-luatex.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-example-luatex.pdf Binary files differnew file mode 100644 index 00000000000..a34d3c0e5ca --- /dev/null +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-example-luatex.pdf diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.pdf Binary files differdeleted file mode 100644 index 5b8539fee04..00000000000 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.tex b/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.tex deleted file mode 100644 index 0c9089eaff4..00000000000 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-example-xetex.tex +++ /dev/null @@ -1,328 +0,0 @@ -%!TEX encoding = UTF-8 Unicode -%!TEX TS-program = xelatex - -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% Esempio di composizione con XeLaTeX o LuaLatex -\documentclass[% -% 10pt -% 11pt -12pt, -twoside, -%,classica -%,autoreanno -%,oldstile -%,cucitura -]{toptesi} -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% Impostazione dei font e delle lingue % -\usepackage{fontspec} % -\setmainfont[Ligatures=TeX]{TeX Gyre Termes}% font Times % -\setsansfont[Ligatures=TeX, Scale=MatchLowercase]{TeX Gyre Heros}% font Helvetica % -\setmonofont{UM Typewriter}% font typewriter un po' più scuri del font Courier % -\usepackage{amsmath} % per la matematica estesa % -\usepackage[math-style=TeX]{unicode-math}% per la matematica UNICODE % -\setmathfont{XITS Math}% font matematici UNICODE che van bene con i Times % -\setotherlanguage[variant=ancient]{greek} % -\newfontfamily{\greekfont}{GFS Didot} % -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% - -\usepackage{pict2e}% per togliere ogni limitazione all'ambiente picture - -%%%%%%%%% da caricare per ultimo e solo se non e' gia' stato caricato -\expandafter\csname @ifpackageloaded\endcsname{hyperref}{}{\usepackage{hyperref}} -\hypersetup{% - pdfpagemode={UseOutlines}, - bookmarksopen, - pdfstartview={FitH}, - colorlinks, - linkcolor={blue}, - citecolor={red}, - urlcolor={blue} - } -%%%%%%%%%% fine impostazioni di hyperref - -\begin{document} - -% \english % la lingua di default e' l'italiano - - -\ateneo{Università degli Studi di Einstenia}% nome generico dell'Universita' -\nomeateneo{Weiss Turm}% eventuale nome proprio dell'universita' -\logosede{logouno}% logo dell'universita' -%\logosede{logopolito,logopolimi,logopoliba}% Per la scuola interpolitecnica di dottorato -\FacoltaDi{Facoltà di\space}% Etichetta della facolta' -\facolta[III]{Matematica, Fisica\\e Scienze Naturali}% campo delle facolta' -%\Materia{Remote sensing} -%\monografia{La pressione barometrica di Giove}% per la laurea triennale -\titolo{La pressione barometrica di~Giove}% per la laurea quinquennale e il dottorato -\sottotitolo{Metodo dei satelliti medicei}% per la laurea quinquennale e il dottorato -\corsodilaurea{Astronomia Applicata}% per la laurea -%\corsodidottorato{Meccanica}% per il dottorato -\candidato{Galileo \textsc{Galilei}}% per tutti i percorsi -\secondocandidato{Evangelista \textsc{Torricelli}}% solo per la laurea magistrale -%\direttore{prof. Albert Einstein}% solo per il dottorato -%\coordinatore{prof. Albert Einstein}% solo per il dottorato -\relatore{prof.\ Albert Einstein}% per la laurea e/o il dottorato -\secondorelatore{dipl.~ing.~Werner von Braun}% per la laurea magistrale -%\terzorelatore{{\tabular{@{}l}dott.\ Neil Armstrong\\prof. Maria Rossi\endtabular}}% per la laurea magistrale - -%\tutore{ing.~Karl Von Braun}% per il dottorato -\tutoreaziendale{dott.\ ing.\ Giovanni Giacosa} -\NomeTutoreAziendale{Supervisore aziendale\\Centro Ricerche FIAT} - -%\sedutadilaurea{Agosto 1615}% per la laurea quinquennale -%\esamedidottorato{Novembre 1610}% per il dottorato -\sedutadilaurea{\textsc{Anno~accademico} 1615-1616}% per la laurea magistrale -%\annoaccademico{1615-1616}% solo con l'opzione classica -%\annoaccademico{2007}% idem -%\ciclodidottorato{XV}% per il dottorato -% -%\chapterbib %solo per sperimentare; e' preferibile comporre una sola bibliografia -%\AdvisorName{Supervisors} -\retrofrontespizio{Questo testo è sottoposto alla Creative Common Licence - - \vspace{2\baselineskip} - - Stampato il \today -} - -\newtheorem{osservazione}{Osservazione}% Standard LaTeX - - -%\setbindingcorrection{3mm}% impostazione per la cucitura - -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% Solo per collaudare -\ifclassica - \tomo - \paginavuota% Per avere la dedica sul recto, ma non subito dopo il retrofrontepsizio - \begin{dedica} - A mio padre - - \textdagger\ A mio nonno Pino - \end{dedica} -\else - \frontespizio* -\fi -% In una tesi vera usare solo a seconda dei casi \frontespizio o \tomo -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% - - -\sommario% compone il sommario - -La pressione barometrica di Giove viene misurata -mediante un metodo originale messo a punto dai candidati, che si basa -sul rilevamento telescopico della pressione. - -\ringraziamenti% compone i ringraziamanti che di solito sono inutili - -I candidati ringraziano vivamente il Granduca di Toscana per i mezzi -messi loro a disposizione, ed il signor Von Braun, assistente del -prof.~Albert Einstein, per le informazioni riservate che egli ha -gentilmente fornito loro, e per le utili discussioni che hanno permesso -ai candidati di evitare di riscoprire l'acqua calda. - -\tablespagetrue\figurespagetrue % usare solo se queste liste sono necessarie -\indici% stampo i vari indici - -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% Altro esperimento da non ripetere mai -% QUi lo si fa per mostrare come viene composto il testo greco inserito -% direttamente in greco nel file sorgente -%\ifclassica - \begin{citazioni} - \textit{testo testo testo\\testo testo testo} - - [\textsc{G.\ Leopardi}, Operette Morali] - - \begin{greek} - ἀλλὰ πάντα ὁ κέραυνος δ' ὀιακίζει - \end{greek} - - [\textsc{Eraclito}, fr.\ D-K 134] - \end{citazioni} - -%\fi -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% - -\mainmatter - -%\part{Prima Parte}% Di solito le tesi non sono divise in parti -\chapter{Introduzione generale} - -\section{Principi generali} -Il problema della determinazione della pressione barometrica dell'atmosfera di -Giove non ha ricevuto finora una soluzione soddisfacente, per l'elementare -motivo che il pianeta suddetto si trova ad una distanza tale che i mezzi attuali -non consentono di eseguire una misura \emph{in loco}. - -Conoscendo però con grande precisione le orbite dei satelliti principali di -Giove, e segnatamente le orbite dei satelliti medicei, è possibile eseguire -delle misure indirette, che fanno ricorso alla nota formula \cite{gal}: -\[ -\Phi = K\frac{\Xi^2 +\Psi\ped{max}}{1+\gei\Omega} -\] -dove le varie grandezze hanno i seguenti significati: -\begin{enumerate} -\item -$\Phi$ angolo di rivoluzione del satellite in radianti se $K=1$, in gradi se -$K=180/\pi$; -\item -$\Xi$ eccentricità dell'orbita del satellite; questa è una grandezza priva -di dimensioni; -\item -$\Psi\ped{max}$ rapporto fra il semiasse maggiore ed il semiasse minore -dell'orbita del satellite, nelle condizioni di massima eccentricità; -poiché le dimensioni di ciascun semiasse sono $[l]=\unit{km}$, la grandezza -$\Psi\ped{max}$ è adimensionata; -\item -$\Omega$ velocità istantanea di rotazione; si ricorda che è $[\Omega]=% -\unit{rad}\unit{s}^{-1}$; -\item bisogna ancora ricordarsi che $10^{-6}\unit{m}$ equivalgono a -1\unit{\micro m}. -\end{enumerate} -% - -Le grandezze in gioco sono evidenziate nella figura \ref{fig1}. -\begin{figure}[ht]\centering -\setlength{\unitlength}{0.01\textwidth} -\begin{picture}(40,30)(30,0) -\put(50,15){\scalebox{1}[0.7]{\circle{20}}} -\put(48.5,15){\circle*{1}} -\put(30,0){\framebox(40,30){}} -\end{picture} -\caption{Orbita del generico satellite; si noti l'eccentricità dell'orbita rispetto al pianeta.\label{fig1}} -\end{figure} - -Per misurare le grandezze che compaiono in questa formula è necessario -ricorrere ad un pirometro con una resistenza di 120\unit{M\ohm}, altrimenti gli -errori di misura sono troppo grandi, ed i risultati completamente falsati. - -\section{I satelliti medicei} -I satelliti medicei, come noto, sono quattro ed hanno dei periodi di rivoluzione -attorno al pianeta Giove che vanno dai sette giorni alle tre settimane. - -Essi furono per la prima volta osservati da uno dei candidati mentre -sperimentava l'efficacia del tubo occhiale che aveva appena inventato -rielaborando una idea sentita di seconda mano da un viaggiatore appena arrivato -dai Paesi Bassi. -\chapter{Il barometro} -\section{Generalità} -\begin{interlinea}{0.87} Il barometro, come dice il nome, serve per -misurare la pesantezza; più precisamente la pesantezza dell'aria -riferita all'unità di superficie. Questo capoverso è composto con un fattore di interlinea pari a 0,87 e come si vede le righe sono troppo dense e si leggono male. Oltretutto la distanza effettiva delle successive linee di base di righe adiacenti non è costante e dipende dalla presenza di lettere con ascendenti e discendenti. -\end{interlinea} - -\begin{interlinea}{2} Studiando il fenomeno fisico si può concludere -che in un dato punto grava il peso della colonna d'aria che lo -sovrasta, e che tale colonna è tanto più grave quanto maggiore -è la superficie della sua base; il rapporto fra il peso e la base -della colonna si chiama pressione e si misura in once toscane al cubito -quadrato, \cite{tor1}; nel Ducato di Savoia la misura in once al piede -quadrato è quasi uguale, perché colà usano un piede molto -grande, che è simile al nostro cubito. Questo capoverso è composto a spaziatura doppia (fattore di interlinea pari a 2) ed è semplicemente penoso. -\end{interlinea} - -\subsection{Forma del barometro} - -\begin{interlinea}{1.5} -Il barometro consta di un tubo di vetro chiuso ad una estremità e -ripieno di mercurio, capovolto su di un vaso anch'esso ripieno di -mercurio; mediante un'asta graduata si può misurare la distanza fra -il menisco del mercurio dentro il tubo e la superficie del mercurio -dentro il vaso; tale distanza è normalmente di 10 pollici toscani, -\cite{tor1,tor2}, ma la misura può variare se si usano dei pollici -diversi; è noto infatti che gl'huomini sogliono avere mani di -diverse grandezze, talché anche li pollici non sono egualmente -lunghi. Questo capoverso è composto con un fattore di interlinea pari a 1,5; l'effetto è brutto, ma per delle bozze da stampare su carta e da correggere a mano può bastare. -\end{interlinea} -\section{Del mercurio} -Il mercurio è un a sostanza che si presenta come un liquido, ma ha il colore -del metallo. Esso è pesantissimo, tanto che un bicchiere, che se fosse pieno -d'acqua, sarebbe assai leggero, quando invece fosse ripieno di mercurio, -sarebbe tanto pesante che con entrambe le mani esso necessiterebbe di essere -levato in suso. - -Esso mercurio non trovasi in natura nello stato nel quale è d'uopo che sia -per la costruzione dei barometri, almeno non trovasi così abbondante come -sarebbe necessario. - -\setcounter{footnote}{25} - -Il Monte Amiata, che è locato nel territorio del Ducato% -\footnote{Naturalmente stiamo parlando del Granducato di Toscana.% -\expandafter\ifx\csname StileTrieste\endcsname\NoteWhiteLine\fi -} -del nostro Eccellentissimo et Illustrissimo Signore Granduca di Toscana\footnote{Cosimo IV de' Medici.}, è uno dei -luoghi della terra dove può rinvenirsi in gran copia un sale rosso, che -nomasi \emph{cinabro}, dal quale con artifizi alchemici, si estrae il mercurio -nella forma e nella consistenza che occorre per la costruzione del barometro -terrestre% -\expandafter\ifx\csname StileTrieste\endcsname -\nota{Nota senza numero. - -\dots e che va a capo. -}\fi. - -%\selectlanguage{english} -%\EnableFigTabNames - -La densità del mercurio è molto alta e varia con la temperatura come -può desumersi dalla tabella \ref{t:1}. - - -Il mercurio gode di una sorprendente qualità e proprietà, cioè che esso -diventa tanto solido da potersene fare una testa di martello et infiggere -chiodi aguzzi nel legname. -\begin{table}[htp] % crea un floating body col nome Tabella nella - % didascalia -\centering % comando necessario per centrare la tabella -\begin{tabular}% % inizio vero e proprio della tabella -{rrrrrr} % parametri di incolonnamento -\hline\hline % filetti orizzontali sopra la tabella - % intestazione della tabella -\multicolumn{3}{c}{\rule{0pt}{2.5ex}Temperatura} % \rule serve per lasciare -& \multicolumn{3}{c}{Densit\`a} \\ % un po' di spazio sopra le parole - &\multicolumn1c{\unit{\gradi C}} & & - &\multicolumn1c{$\unit{t/m^3}$} & \\ -\hline% % Filetto orizzontale per separare l'intestazione -\hspace*{1.3em}& 0 & & & 13,8 & \\ % I numeri sono incolonnati % - & 10 & & & 13,6 & \\ % a destra; le colonne vuote - & 50 & & & 13,5 & \\ % servono per centrare le colonne - &100 & & & 13,3 & \\ % numeriche sotto le intestazioni -\hline \hline % Filetti di fine tabella -\end{tabular} -\caption[Densit\`a del mercurio]{Densit\`a del mercurio. Si può fare molto meglio usando il pacchetto \textsf{booktabs}.} % didascalia -\label{t:1} % label -\end{table} - -%\selectlanguage{italian} - -\begin{osservazione}\normalfont -Questa proprietà si manifesta quando esso è estremamente freddo, come -quando lo si immerge nella salamoia di sale e ghiaccio che usano li maestri -siciliani per confetionare i sorbetti, dei quali sono insuperabili artisti. -\end{osservazione} - -Per nostra fortuna, questo grande freddo, che necessita per la confetione de -li sorbetti, molto raramente, se non mai, viene a formarsi nelle terre del -Granduca Eccellentissimo, sicché non vi ha tema che il barometro di mercurio -possa essere ruinato dal grande gelo e non indichi la pressione giusta, come -invece deve sempre fare uno strumento di misura, quale è quello che è -descritto costì. - - - - -\begin{thebibliography}{9} -\bibitem{gal} G.~Galilei, {\em Nuovi studii sugli astri medicei}, Manunzio, - Venetia, 1612. -\bibitem{tor1} E.~Torricelli, in ``La pressione barometrica'', {\em Strumenti - Moderni}, Il Porcellino, Firenze, 1606. -\bibitem{tor2} E.~Torricelli e A.~Vasari, in ``Delle misure'', {\em Atti Nuovo - Cimento}, vol.~III, n.~2 (feb. 1607), p.~27--31. -\end{thebibliography} - - - - -\end{document} diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-example.xmpdata b/Master/texmf-dist/doc/latex/toptesi/toptesi-example.xmpdata deleted file mode 100644 index a23616b5fab..00000000000 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-example.xmpdata +++ /dev/null @@ -1,3 +0,0 @@ -\Title{La pressione barometrica di Giove} -\Author{Galileo Galilei, Evangelista Torricelli} -\Keywords{Giove</rdf:li><rdf:li>Pressione</rdf:li><rdf:li>Satelliti medicei</rdf:li><rdf:li>Barometro}
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-it-pdftex-def.ps b/Master/texmf-dist/doc/latex/toptesi/toptesi-it-pdftex-def.ps deleted file mode 100644 index 7a894f7a191..00000000000 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-it-pdftex-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-it-pdftex.cfg b/Master/texmf-dist/doc/latex/toptesi/toptesi-it-pdftex.cfg deleted file mode 100644 index f8abfd7d632..00000000000 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-it-pdftex.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 Politecnico di Torino\\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 \ifPDFTeX\pdfLaTeX\else\ifXeTeX\XeLaTeX\else\ifLuaTeX\LuaLaTeX\else ???\fi\fi\fi\ 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-it-pdftex.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-it-pdftex.pdf Binary files differdeleted file mode 100644 index 32bd8fa8284..00000000000 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-it-pdftex.pdf +++ /dev/null diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-it-pdftex.xmpdata b/Master/texmf-dist/doc/latex/toptesi/toptesi-it-pdftex.xmpdata deleted file mode 100644 index 7f787ba20fe..00000000000 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-it-pdftex.xmpdata +++ /dev/null @@ -1,4 +0,0 @@ -\Title{La classe TOPtesi} -\Author{Claudio Beccari} -\Keywords{Tesi di laurea\sep Tesi di dottorato\sep classe LaTeX\sep -pdfLaTeX\sep XeLaTeX\sep LuaLaTeX}
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-it.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi-it.pdf Binary files differnew file mode 100644 index 00000000000..4db6a31364a --- /dev/null +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-it.pdf diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi-it-pdftex.tex b/Master/texmf-dist/doc/latex/toptesi/toptesi-it.tex index 842fe2272f6..858507041e5 100644 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi-it-pdftex.tex +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi-it.tex @@ -1,26 +1,8 @@ % !TEX encoding = UTF-8 Unicode -% !TEX TS-program = pdfLaTeX +% !TEX TS-program = LuaLaTeX % -%---------------------------- English ---------------------------- -% The above auto configuration lines, useful for those LaTeX -% Friendly editors that are capable of using them, specify that -% the typesetting program to be used for typesetting this file -% is pdfLaTeX; you may change it to XeLaTeX or LuaLaTeX. -% With pdfLaTeX you should obtain a PDF/A compatible PDF file; -% with XeLaTeX and LuaLaTeX please read this file at section 3.9. -% -%------------------------- Italiano ------------------------------ -% Le prime due righe sono le righe di autoconfigurazione, utili -% per quegli shell editor capaci di interpretarle, e specificano -% che questo file dovrebbe essere compilato mediante il programma -% pdfLATeX ; ma potete cambiare quella specificazione imponendo -% la composizione con XeLaTeX o LuaLaTeX. Con pdfLaTeX si ottiene -% direttamente un file PDF/A compatibile; con gli altri due -% programmi è bene leggere questa documentazione al paragrafo 3.9. -%---------------------------------------------------------------- -% -% toptesi-it-pdftex.tex -%% Copyright 2015 Claudio Beccari +% toptesi-it.tex +%% Copyright 2013-2016 Claudio Beccari % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either version 1.3 @@ -37,22 +19,42 @@ % appendix of this documentation, but the primary source remains in % http://www.latex-project.org/ % +\begin{filecontents*}{\jobname.xmpdata} +\Title{La classe TOPtesi} +\Author{Claudio Beccari} +\Publisher{Claudio Beccari} +\Keywords{Monografia di laurea\sep +Tesi di laurea\sep +Tesi di dottorato\sep +classe LaTeX\sep +pdfLaTeX\sep +XeLaTeX\sep +LuaLaTeX} +\end{filecontents*} +% \documentclass[12pt,twoside]{toptesi} -\ProvidesFile{toptesi-it-pdftex.tex}[2015 v.0.99d] +\ProvidesFile{toptesi-it.tex}[2016/06/29 v.0.99e] \ifPDFTeX +% + \usepackage[a-1b]{pdfx} +% \usepackage[utf8]{inputenc} \usepackage[T1]{fontenc} \usepackage{newtxtext,newtxmath,textcomp,textalpha} - \usepackage[a-1b]{pdfx} + \usepackage{amsmath,amssymb} \usepackage{mflogo} \usepackage{guit} + \setactivedoublequote \else + \ifLuaTeX + \usepackage[a-1b]{pdfx} + \fi \usepackage{fontspec} \usepackage{xcolor} \newcommand*\MP{{\setbox0\hbox{M}\relax \includegraphics[height=\ht0]{MPlogo}}} \newcommand*\GuIT{{\setbox0\hbox{Hg}\relax - \raisebox{-\dp0}{\includegraphics[height=\dimexpr\ht0+\dp0]{GuITlogo}}}} + \raisebox{-\dp0}{\includegraphics[height=\dimexpr\ht0+\dp0]{GuITlogo}}}} \setmainfont[Ligatures=TeX]{TeX Gyre Termes} \setsansfont[Ligatures=TeX, Scale=MatchLowercase]{TeX Gyre Heros} \setmonofont{UM Typewriter} @@ -60,12 +62,12 @@ \usepackage{amsmath} \usepackage{unicode-math} \setmathfont{XITS Math} - \ifLuaTeX - \newcommand\inputencoding[1]{} - \usepackage[a-1b]{pdfx} - \fi \fi -\usepackage{metalogo,longtable,booktabs,array,tabularx,fancyvrb,enumitem} +\usepackage{metalogo,longtable,booktabs,array,tabularx,fancyvrb, +enumitem,xspace,fancyvrb} +%\usepackage[margin=15pt,font=small,labelfont=bf,labelsep=quad]{caption} +%\captionsetup[table]{position=above} +\usepackage{trace} \usepackage{imakeidx} \usepackage{hyperref} \hypersetup{% @@ -77,6 +79,7 @@ citecolor={blue}, urlcolor={blue} } + \makeindex[intoc,columns=2] \newcommand*\prog[1]{\textsf{#1}\index{programma!#1@\textsf{#1}}} @@ -89,27 +92,34 @@ \providecommand*\cs[1]{\texttt{\char92#1}\index{#1@\texttt{\char92#1}}} \newcommand*\oarg[1]{\texttt{[}\meta{#1}\texttt{]}} \newcommand*\marg[1]{\texttt{\{}\meta{#1}\texttt{\}}} -\newcommand*\Arg[1]{\texttt{\{#1\}}} +\newcommand*\Arg[1]{\texttt{\{#1\}}}\let\Marg\Arg +\newcommand*\Oarg[1]{\texttt{[#1]}} \newcommand*\opt[1]{\texttt{#1}\index{opzione!#1@\texttt{#1}}}\let\opz\opt \newcommand*\Font[1]{\textit{#1}\index{font!#1@\textit{#1}}} +\let\acro\textsc \providecommand*\pdfLaTeX{} -\renewcommand*\pdfLaTeX{pdf\/\LaTeX} -\providecommand*\XeLaTeX{} -\renewcommand*\XeLaTeX{X\kern-0.14em\raisebox{-0.5ex}{\rotatebox[origin=c]{180}{E}}\kern-0.075em\LaTeX} -\let\acro\textsc -\providecommand*\MiKTeX{MiK\TeX} +\renewcommand*\pdfLaTeX{pdf\/\LaTeX\xspace} +\renewcommand*\XeLaTeX{% +\ifPDFTeX X\kern-0.14em\raisebox{0.975ex}{\scalebox{-1}[-1]{E}}\kern-0.075em\LaTeX +\else\Xe\LaTeX\fi\xspace} +\let\originalLuaLaTeX\LuaLaTeX +\renewcommand*\LuaLaTeX{\originalLuaLaTeX\xspace} + +\providecommand*\MiKTeX{MiK\TeX\xspace} +\providecommand*\TeXLive{\TeX\,Live\xspace} \makeatletter \def\GetFileInfo#1{% \def\filename{#1}% + \edef\@tempa{\csname ver@#1\endcsname}% \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} +\def\bottomfraction{1} \begin{document} % @@ -121,10 +131,11 @@ \thispagestyle{empty} \vspace*{.2\textheight} \hrule -\bigskip -\centerline{\Huge \textsf{La classe TOPtesi}} -\bigskip +\begin{center} +\Huge \textsf{La classe TOPtesi} +\end{center} \hrule + \clearpage \ifbool{@twoside}{\thispagestyle{empty}\null\clearpage}{} @@ -133,9 +144,8 @@ \frontespizio - \sommario - Questo testo serve per descrivere come comporre tipograficamente la tesi di laurea o la monografia o la dissertazione di dottorato mediante il noto programma di composizione \LaTeX, o meglio, mediante le sue varianti \pdfLaTeX, \XeLaTeX\ o \LuaLaTeX; per produrre con \XeLaTeX\ il file finale in formato PDF archiviabile secondo la norma ISO \mbox{19005-1} bisogna procedere come descritto nel paragrafo~\ref{sec:XePDFA}. + Questo testo serve per descrivere come comporre tipograficamente la tesi di laurea o la monografia o la dissertazione di dottorato mediante il noto programma di composizione \LaTeX, o meglio, mediante le sue varianti \pdfLaTeX, \XeLaTeX\ o \LuaLaTeX; per produrre con \XeLaTeX\ il file finale in formato PDF archiviabile secondo la norma ISO \mbox{19005-1} bisogna procedere come descritto nel paragrafo~\ref{sec:XePDFA}. \english \sommario @@ -145,7 +155,7 @@ This text describes how to typeset a university master thesis, or the bachelor f \italiano \ringraziamenti -Ringrazio gli studenti del Politecnico di Torino che mi hanno sollecitato a mettere la mia esperienza a loro disposizione per predisporre e rendere disponibile il software necessario per preparare le loro tesi, monografie o dissertazioni con la qualità che solo \pdfLaTeX, \XeLaTeX\ o \LuaLaTeX\ riescono a produrre\footnote{Questa particolare composizione è stata eseguita con \XeLaTeX. Questo motore di composizione presenta numerosi vantaggi su \prog{pdflatex} per quel che riguarda l'uso dei font, anche per la matematica, ma non è ancora (2015) in grado di produrre l'uscita direttamente nel formato PDF, anche se apparentemente lo fa. In realtà la sua uscita è in un formato intermedio che viene poi trasformato automaticamente in PDF. L'esperienza mi insegna che in realtà le limitazioni di \XeLaTeX\ sono pochissime e, con la classe \pack{toptesi}, quella forse più importante, ma facilmente risolvibile, riguarda il formato PDF archiviabile che non è ottenibile direttamente, ma bisogna procedere come indicato nel paragrafo~\ref{sec:XePDFA}.}. +Ringrazio gli studenti del Politecnico di Torino che mi hanno sollecitato a mettere la mia esperienza a loro disposizione per predisporre e rendere disponibile il software necessario per preparare le loro tesi, monografie o dissertazioni con la qualità che solo \pdfLaTeX, \XeLaTeX\ o \LuaLaTeX\ riescono a produrre\footnote{Questa particolare composizione è stata eseguita con \XeLaTeX. Questo motore di composizione presenta numerosi vantaggi su \prog{pdflatex} per quel che riguarda l'uso dei font, anche per la matematica, ma non è ancora (2015) in grado di produrre l'uscita direttamente nel formato PDF, anche se apparentemente lo fa. In realtà la sua uscita è in un formato intermedio che viene poi trasformato automaticamente in PDF. L'esperienza mi insegna che in realtà le limitazioni di \XeLaTeX\ sono pochissime e, con la classe \pack{toptesi}, quella forse più importante, ma facilmente risolvibile, riguarda il formato PDF archiviabile che non è ottenibile direttamente, tanto che bisogna procedere come indicato nel paragrafo~\ref{sec:XePDFA}.}. \figurespagetrue \tablespagetrue @@ -187,7 +197,7 @@ TOPtesi serve anche per fornire alcune altre semplici estensioni che rendono pi Come tutti i pacchetti che estendono la funzionalità di \LaTeX, TOPtesi definisce la geometria della pagina e dispone le informazioni accessorie come le testatine e i piedini. Queste impostazioni non sono modificabili né con TOPtesi né con la maggior parte degli altri pacchetti destinati alle tesi. Vale il concetto ``prendere o lasciare''. -{\tolerance=3000 Prima di usare TOPtesi si esaminino i semplici esempi contenuti nei file accessori di questo pacchetto: \file{toptesi-example.pdf}, \file{toptesi-example-xetex.pdf}, \file{topfront.example.pdf}, \texttt{toptesi-example-con-frontespizio.pdf}\index{file!toptesi-example-con-frontespizio.pdf@\texttt{toptesi\discretionary{-}{}{-}example\discretionary{-}{}{-}con\discretionary{-}{}{-}frontespizio.pdf}}. Si potrà vedere se l'impaginazione aggrada oppure se si desidera un'altra impaginazione; in questo secondo caso ci si rivolga ad altre classi e ad altri pacchetti: in rete non è difficile usare un motore di ricerca per trovare il pacchetto \pack{frontespizio}, le classi \class{sapthesis}, \class {suftesi}, \class{TesiModerna}, \class{TesiClassica} e diverse altre classi prodotte specialmente nel mondo angloamericano e ancor meno adatte ad una personalizzazione multilingue. Alcune di queste classi sono dotate di eccellenti file di documentazione, altre sono usabili grazie a ``template'' o modelli di tesi scritte facendo uso di testo fittizio, ma tali da rendere immediatamente l'idea di come usare quei software.\par} +{\tolerance=3000 Prima di usare TOPtesi si esaminino i semplici esempi contenuti nei file accessori di questo pacchetto: \file{toptesi-example.pdf}, \file{toptesi-example-luatex.pdf}, \file{topfront.example.pdf}, \texttt{toptesi-example-con-frontespizio.pdf}\index{file!toptesi-example-con-frontespizio.pdf@\texttt{toptesi\discretionary{-}{}{-}example\discretionary{-}{}{-}con\discretionary{-}{}{-}frontespizio.pdf}}. Si potrà vedere se l'impaginazione aggrada oppure se si desidera un'altra impaginazione; in questo secondo caso ci si rivolga ad altre classi e ad altri pacchetti: in rete non è difficile usare un motore di ricerca per trovare il pacchetto \pack{frontespizio}, le classi \class{sapthesis}, \class {suftesi}, \class{TesiModerna}, \class{TesiClassica} e diverse altre classi prodotte specialmente nel mondo angloamericano e ancor meno adatte ad una personalizzazione multilingue. Alcune di queste classi sono dotate di eccellenti file di documentazione, altre sono usabili grazie a ``template'' o modelli di tesi scritte facendo uso di testo fittizio, ma tali da rendere immediatamente l'idea di come usare quei software.\par} Volendo, anche i file sorgente di questi esempi d'uso del pacchetto TOPtesi, elencati sopra con i nomi dei corrispondenti file PDF, possono essere usati come modelli; persino il file sorgente di questo manuale può essere usato come modello; basta cercare nelle cartelle dell'installazione di TOPtesi i file \file{.tex}, copiarseli in una propria cartella personale, cambiare loro il nome (attenzione, questo è importantissimo) e modificarne il contenuto a proprio piacimento. Con un minimo di attenzione si possono eliminare quelle parti che non servono; si possono modificare le opzioni della classe, si possono compilare con diversi motori di tipocomposizione del sistema \TeX. Non è forse fuori luogo sottolineare che l'uso dei modelli può essere molto utile per cominciare, ma fa perdere di vista il fatto che \LaTeX\ può fare molte più cose di quelle che si inseriscono solitamente negli esempi.\enlargethispage{-1\baselineskip} @@ -202,7 +212,7 @@ Conviene leggere l'uso dei loghi nel paragrafo~\ref{ssec:loghi}, perché TOPtesi Il paragrafo~\ref{sec:cominciare} espone come impostare inizialmente il documento principale della tesi e di come frazionarne il contenuto in diversi file. Non esiste un unico metodo e i vari metodi presentano vantaggi e svantaggi. Conviene conoscere bene questi metodi e i loro pro e contro, anche perché nell'uso elementare di \LaTeX\ questi concetti non vengono mai affrontati. -Il paragrafo~\ref{sec:codifica} è fondamentale; disporre di un editor che salva i file sorgente con una certa codifica e poi cercare di compilare quei file con \LaTeX\ impostato per una codifica diversa, vuol dire combinare pasticci inenarrabili; in questo manuale si consiglia di usare sia per l'editor si per \LaTeX\ la codifica \opt{utf8} ma è i laureando che deve sceglierla in base alle caratteristiche del suo software e ai programmi che intende usare per la compilazione. Tutti e tre i programmi principali di composizione, \pdfLaTeX, \XeLaTeX, e \LuaLaTeX\ funzionano bene con la codifica \opt{utf8}; \pdfLaTeX\ funziona anche con altre codifiche; gli editor un po' datati non funzionano con la codifica \opt{utf8}, quindi è evidente che le varie situazioni richiedono impostazioni attente e accurate. Se fosse necessario, l'argomento codifiche può essere approfondito anche su altri testi liberi, per esempio sulla guida tematica che si trova nella sezione documentazione dell'associazione \GuIT, in \url{http://guitex.org/home/images/doc/GuideGuIT/introcodifiche.pdf} dal titolo \emph{Introduzione alle codifiche in entrata e in uscita}. +Il paragrafo~\ref{sec:codifica} è fondamentale; disporre di un editor che salva i file sorgente con una certa codifica e poi cercare di compilare quei file con \LaTeX\ impostato per una codifica diversa, vuol dire combinare pasticci inenarrabili; in questo manuale si consiglia di usare sia per l'editor si per \LaTeX\ la codifica \opt{utf8} ma è i laureando che deve sceglierla in base alle caratteristiche del suo software e ai programmi che intende usare per la compilazione. Tutti e tre i programmi principali di composizione, \pdfLaTeX, \XeLaTeX, e \LuaLaTeX\ funzionano bene con la codifica \opt{utf8}; \pdfLaTeX\ funziona anche con altre codifiche; gli editor un po' datati non funzionano con la codifica \opt{utf8}, quindi è evidente che le varie situazioni richiedono impostazioni attente e accurate. Se fosse necessario, l'argomento codifiche può essere approfondito anche su altri testi liberi, per esempio la guida tematica che si trova nella sezione documentazione dell'associazione \GuIT, in \url{http://guitex.org/home/images/doc/GuideGuIT/introcodifiche.pdf} dal titolo \emph{Introduzione alle codifiche in entrata e in uscita}. Il paragrafo~\ref{sec:lingue} descrive come impostare il file sorgente della tesi per comporre il testo in diverse lingue o per impostare una lingua principale diversa dall'italiano. È essenziale per comporre tesi in programmi di doppia laurea. Infatti TOPtesi è stato creato anche per poter soddisfare le esigenze che un numero sempre maggiore di laureandi incontrano quando partecipano a programmi di doppio titolo con i vari programmi europei Erasmus, Life Long Learning, Erasmus Mundus, eccetera; le tesi svolte in questi percorsi solitamente richiedono l'uso di altre lingue oltre o in sostituzione dell'italiano. TOPtesi viene incontro a queste esigenze sia grazie all'uso di \LaTeX\ o \XeLaTeX\ o \LuaLaTeX\ che sono in grado di gestire una ottantina di lingue, sia perché quasi tutti i comandi che devono essere usati per il frontespizio e per molte strutture interne sono completamente configurabili in accordo con le lingue usate. Il paragrafo~\ref{sec:lingue} provvede a spiegare come eseguire queste configurazioni. @@ -232,7 +242,7 @@ La classe \class{toptesi} carica questo modulo solo durante l'esecuzione del com % \Item[topcoman] un piccolo pacchetto che contiene alcuni comandi utili in generale, non solo per l'uso con TOPtesi. Non è possibile inibirne il caricamento, ma spero che provveda da solo a non entrare in conflitto con altri pacchetti; finora non ho incontrato conflitti. % -\Item[iftex] serve per distinguere il motore di composizione con cui si compila la tesi. +\Item[ifxetex] serve per distinguere il motore di composizione con cui si compila la tesi. % \item[\normalfont\meta{nome del main file}\file{.cfg}] Il file di configurazione specifico per una data tesi viene caricato solo se esiste nella medesima cartella dove risiede il main file della tesi stessa. % @@ -240,14 +250,9 @@ La classe \class{toptesi} carica questo modulo solo durante l'esecuzione del com % \Item[polyglossia] viene caricato solo se la tesi viene composta con \XeLaTeX\ o \LuaLaTeX. L'italiano viene specificato come lingua principale, e l'inglese come altra lingua. % -%\Item[pdfx] viene caricato solo se è stata specificata l'opzione \opt{pdfa} per -% produrre un file possibilmente conforme al formato PDF/A. +\Item[pdfx] deve venire caricato esplicitamente dall'utente, come spiegato nell'apposito paragrafo; nelle versioni precedenti esso veniva caricato specificando l'opzione \opt{pdfa} per produrre un file possibilmente conforme al formato PDF/A. Ora, per compatibilità con il passato, l'opzione è ancora attiva, ma il suo scopo è solo quello di emettere un avviso di consultare la documentazione. % -%\Item[hyperref] serve per comporre i collegamenti ipertestuali. Non è il caso di -%preoccuparsi di quando TOPtesi carica \pack{hyperref} perché ci pensa lui a -%ritardarne la chiamata al momento di iniziare la composizione del documento. Si -%veda più avanti per sapere come e quando eventualmente configurare -%\pack{hyperref} con le sue opzioni. +\Item[hyperref] serve per comporre i collegamenti ipertestuali. Non è il caso di preoccuparsi di quando TOPtesi carica \pack{hyperref} perché ci pensa lui a ritardarne la chiamata al momento di iniziare la composizione del documento. Si veda più avanti per sapere come e quando eventualmente configurare \pack{hyperref} con le sue opzioni. \end{description} Il laureando è tenuto a documentarsi su ciascuno di quei pacchetti; normalmente egli dispone di tutta la documentazione di cui necessita già nella sua installazione del sistema TeX\ completo e aggiornato; basta che apra un terminale e vi scriva dentro; @@ -264,7 +269,7 @@ Si noti: non sono precaricati i pacchetti \pack{inputenc} per definire la codifi È voluto: \pack{inputenc} non deve essere caricato se si usano \XeLaTeX\ o \LuaLaTeX, ma in entrambi i casi l'editor che si usa per comporre il file sorgente \emph{deve} essere configurato in modo che salvi i file sorgente con la codifica \opt{utf8}. Con \pdfLaTeX\ ci sarebbe una certa libertà nello scegliere la codifica d'entrata, ma, insisto, sarebbe meglio in ogni caso evitare di usare qualunque altra codifica diversa da \opt{utf8}. -Per i font di uscita la o le codifiche da specificare dipendono dalle lingue usate; ripeto la raccomandazione di preferire i font espressamente confezionati per l'uso con \pdfLaTeX, quando si compone con questo programma; se si usano i programmi \XeLaTeX\ o \LuaLaTeX\ si abbia l'accortezza di usare il pacchetto \pack{fontspec} specificandogli le opzioni giuste e caricando poi, mediante le sue funzionalità, i font OpenType di cui si sia accertata la presenza sulla propria macchina, e si sia verificato che contengono tutti i glifi che si intendono usare nella tesi. Tanto per citare l'importanza di questa verifica, questi programmi lavorano di default con i font Latin Modern, che, come dice il nome, contengono \emph{solo} i caratteri latini. Se ci fosse bisogno di scrivere in greco o in cirillico, per esempio, allora i font OpenType UCM (distribuiti con il sistema \TeX\ completo e aggiornato) contengono anche questi alfabeti. +Per i font di uscita la o le codifiche da specificare dipendono dalle lingue usate; ripeto la raccomandazione di preferire i font espressamente confezionati per l'uso con \pdfLaTeX, quando si compone con questo programma; se si usano i programmi \XeLaTeX\ o \LuaLaTeX\ si abbia l'accortezza di usare il pacchetto \pack{fontspec} specificandogli le opzioni giuste e caricando poi, mediante se sue funzionalità, i font OpenType di cui si sia accertata la presenza sulla propria macchina, e si sia verificato che contengano tutti i glifi che si intendono usare nella tesi. Tanto per citare l'importanza di questa verifica, questi programmi lavorano di default con i font Latin Modern, che, come dice il nome, contengono \emph{solo} i caratteri latini. Se ci fosse bisogno di scrivere in greco o in cirillico, per esempio, allora i font OpenType UCM (distribuiti con il sistema \TeX\ completo e aggiornato) contengono anche questi alfabeti. Ecco quindi che la specificazione delle codifiche dei font di uscita è importante per \pdfLaTeX\ perché con questo programma i font predefiniti sono i Computer Modern codificati in \opt{OT1}, cioè mancano di qualunque segno accentato e non sono nemmeno completamente compatibili con la codifica \acro{ascii}. Questi font preimpostati potevano (forse) andare bene ai primordi dell'esistenza del sistema \TeX\ ma non vanno bene oggi nemmeno per l'inglese, visto che anche in inglese si fanno citazioni di testi o di nomi di persone in lingue straniere che usano caratteri latini accentati. @@ -274,25 +279,27 @@ Non si sono caricati nemmeno i pacchetti per il disegno programmato come, per es \section{Pacchetti da non caricare affatto} -Il laureando \textcolor{red}{non deve assolutamente caricare pacchetti che modifichino l'aspetto della pagina, né caricare pacchetti che modifichino la composizione dei titoli o delle didascalie o delle note}. Se vuole fare una cosa del genere è meglio che si rivolga ad altri pacchetti diversamente configurabili; cito fra gli altri \pack{suftesi}, \pack{sapthesis}, \pack{classicthesis}; ma quando va a leggerne la descrizione e la documentazione scopre che tutti vietano la modifica dell'aspetto della pagina o dei titoli e delle didascalie, a meno che essi stessi non dispongano di comandi già predisposti per la personalizzazione di questi elementi. +\textcolor{red}{Non si devono assolutamente caricare pacchetti che modifichino l'aspetto della pagina, né caricare pacchetti che modifichino la composizione dei titoli o delle didascalie o delle note}; eccezionalmente il pacchetto \pack{caption} può venire caricato; \class{toptesi} verifica se tale pacchetto è stato effettivamente caricato e, nel caso, non definisce nemmeno la macro per le didascalie esplicitamente creata per la composizione delle tesi. + +Se si vogliono fare questo genere di modifiche, stile della pagina, testatine, piedini, note, \dots\ è meglio rivolgersi ad altri pacchetti diversamente configurabili; cito fra gli altri \class{suftesi}, \class{sapthesis}; ma quando si va a leggerne la documentazione si scopre che tutti vietano la modifica dell'aspetto della pagina o dei titoli o delle didascalie, a meno che quelle stesse classi non dispongano di comandi già predisposti per la personalizzazione di quegli elementi. -Se il laureando va a cercare in rete altri pacchetti per comporre tesi, si trova davanti allo stesso ostacolo. Se la propria università prescrive stili di pagina diversi o mette a disposizione file classe appositi (di solito piuttosto datati e costruiti male), si renderebbe necessario creare una classe apposita per soddisfare quelle esigenze. Non saprei cosa consigliare, se non ricorrere ad una classe generica come \class{book} e caricare tutti i possibili pacchetti di configurazione che si considerino necessari, per arrivare ad un risultato come quello richiesto dalla propria sede universitaria; i pacchetti preconfezionati come TOptesi, e gli altri citati sopra, risparmiano questo lavoro, ma sono rigidi. In fondo anche TOPtesi è costruito così: parte dalla classe \class{report} e vi costruisce attorno quello che si è voluto fare in base a prescrizioni valide per il Politecnico di Torino, ma lungamente discusse e concordate con l'ateneo e poi rese compatibili con le prescrizioni di diverse altre università. Non è certo un pacchetto perfetto, ma è un buon compromesso. +Se il laureando va a cercare in rete altri pacchetti per comporre tesi, si trova davanti allo stesso ostacolo. Se la propria università prescrive stili di pagina diversi o mette a disposizione file classe appositi (di solito piuttosto datati e costruiti male), si renderebbe necessario creare una classe apposita per soddisfare quelle esigenze. Non saprei cosa consigliare, se non ricorrere ad una classe generica come \class{book} e caricare tutti i possibili pacchetti di configurazione che si considerino necessari, per arrivare ad un risultato come quello richiesto dalla propria sede universitaria; i pacchetti preconfezionati come TOPtesi, e gli altri citati sopra, risparmiano questo lavoro, ma sono rigidi. In fondo anche TOPtesi è costruito così: parte dalla classe \class{report} e vi costruisce attorno quello che si è voluto fare in base a prescrizioni valide per il Politecnico di Torino, ma lungamente discusse e concordate con l'ateneo e poi rese compatibili con le prescrizioni di diverse altre università. Non è certo un pacchetto perfetto, ma è un buon compromesso. \section{Comandi e ambienti di TOPtesi} -Nel capitolo~\ref{cap:comandispecifici} sono descritti i comandi specifici e gli ambienti introdotti da TOPtesi in aggiunta a quelli della classe \class{report} o quelli della classe \class{report} che sono stati modificati da TOPtesi. +Nel capitolo~\ref{cap:comandispecifici} sono descritti i comandi specifici e gli ambienti introdotti da TOPtesi in aggiunta a quelli della classe \class{report} originali o modificati da TOPtesi. -La maggior parte di questi comandi si riferisce alla compilazione del frontespizio, ma è bene che il laureando li abbia sempre a portata di mano per poter eseguire le molteplici personalizzazioni che sono offerte da TOPtesi, in particolare dal pacchetto \pack{topfront}. Quel capitolo contiene anche le figure che rappresentano otto tipici frontespizi in italiano, per elaborati finali della laurea triennale, per la laurea magistrale, per la dissertazione dottorale, sia svolte in singoli atenei, sia svolte in atenei associati. Sia con i loghi in testa alla pagina sia con questi loghi nella metà inferiore della pagina. Sono tante varianti che possono soddisfare molte esigenze, ma che evidentemente non le soddisfano tutte. Queste sono quelle previste e il pacchetto \pack{topfront} non è abbastanza elastico per gestirne altre. Se si vogliono stili diversi esiste sempre il pacchetto \pack{frontespizio} creato apposta da un altro docente universitario di un altro ateneo, quindi con un'altra visione d'insieme sull'aspetto dei frontespizi. Infine esiste sempre la possibilità di usare l'ambiente \amb{titlepage} per creare il frontespizio in modo assolutamente libero da ogni vincolo. +La maggior parte di questi comandi si riferisce alla compilazione del frontespizio, ma è bene che il laureando li abbia sempre a portata di mano per poter eseguire le molteplici personalizzazioni che sono offerte da TOPtesi, in particolare dal suo pacchetto \pack{topfront}. Quel capitolo contiene anche le figure che rappresentano otto tipici frontespizi in italiano, per elaborati finali della laurea triennale, per la laurea magistrale, per la dissertazione dottorale, sia svolte in singoli atenei, sia svolte in atenei associati. Sia con i loghi in testa alla pagina sia con questi loghi nella metà inferiore della pagina. Sono tante varianti che possono soddisfare molte esigenze, ma che evidentemente non le soddisfano tutte. Queste sono quelle previste e il pacchetto \pack{topfront} non è abbastanza elastico per gestirne altre. Se si vogliono stili diversi esiste sempre il pacchetto \pack{frontespizio} creato apposta da un altro docente universitario di un altro ateneo, quindi con un'altra visione d'insieme sull'aspetto dei frontespizi. Infine esiste sempre la possibilità di usare l'ambiente \amb{titlepage} per creare il frontespizio in modo assolutamente libero da ogni vincolo. -In questo capitolo sono anche rappresentati i quattro frontespizi fondamentali nella figura~\ref{fig:frontespizi}; è importante avere queste quattro figurine sotto gli occhi per sapere come comporre il proprio frontespizio in modo che corrisponda alle prescrizioni del proprio ateneo. +In quel capitolo sono anche rappresentati i quattro frontespizi fondamentali nella figura~\ref{fig:frontespizi}; è importante avere queste quattro figurine sotto gli occhi per sapere come comporre il proprio frontespizio in modo che corrisponda alle prescrizioni del proprio ateneo. Il laureando non dedichi invece troppo tempo alla lettura del paragrafo~\ref{sec:PDFA} e seguenti, perché vi si parla di come comporre la tesi in modo che soddisfi alle prescrizioni di archiviabilità introdotte dalle norme ISO~19005 e successive. Quanto scritto in quei paragrafi serve solo se è richiesta la tesi in versione archiviabile secondo le norme ISO. In ogni caso, se non è richiesto, non è opportuno addentrarsi per questa strada; se è richiesto, le operazioni necessarie si possono eseguire a tesi completata come ultimo tocco finale. \section{Modelli di tesi e di frontespizi} -Ricordo infine che il pacchetto TOPtesi contiene anche un certo campionario di modelli di tesi e di frontespizi di vario genere, che possono essere composti con diversi motori di composizione. Il laureando può servirsene in modo molto semplice: copia il file di esempio nella propria cartella di lavoro, gli cambia nome e poi modifica il modello commentando o de-commentando alcune riche, togliendo parti che non servono; per esempio vi ho messo un piccolo esempio di ringraziamenti, ma i ringraziamenti non andrebbero mai usati -- vedi più avanti perché; vi ho messo un piccolo esempio di dedica, ma le dediche sono superflue nel 99\% dei casi; eccetera. +Ricordo infine che il pacchetto TOPtesi contiene anche un certo campionario di modelli di tesi e di frontespizi di vario genere, che possono essere composti con diversi motori di composizione. Il laureando può servirsene in modo molto semplice: copia il file di esempio nella propria cartella di lavoro, gli cambia nome e poi modifica il modello commentando o de-commentando alcune righe, togliendo parti che non servono; per esempio vi ho messo un piccolo esempio di ringraziamenti, ma i ringraziamenti non andrebbero mai usati -- vedi più avanti perché; vi ho messo un piccolo esempio di dedica, ma le dediche sono superflue nel 99\% dei casi; eccetera. -Ripulito il preambolo delle cose che non servono, e scelte le righe ritenute necessarie, basta cambiare i nomi di fantasia che ho usato e i testi di fantasia che ho inserito per ottenere lo schema della tesi, che va poi riempito del contenuto relativo alla tesi che si vuole effettivamente comporre. +Ripulito il preambolo delle cose che non servono, e scelte le righe ritenute necessarie, basta cambiare i nomi di fantasia che ho usato e i testi di fantasia che ho inserito per ottenere lo schema della tesi, che va poi riempito col contenuto relativo alla tesi che si vuole effettivamente comporre. @@ -314,18 +321,18 @@ 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 disponibili, uno in particolare spicca per la sua particolarità: \LaTeX. Veramente esso non è un programma di elaborazione testi, anche se a prima vista lo sembrerebbe; il suo scopo non è finalizzato al testo in quanto tale, bensì alla sua composizione tipografica; esso è un programma di \emph{tipocomposizione}. +Fra i vari programmi disponibili, uno in particolare spicca per la sua particolarità: \LaTeX. Veramente esso non è un word processor, anche se a prima vista lo sembrerebbe; il suo scopo non è finalizzato al testo in quanto tale, bensì alla sua composizione tipografica; esso è un programma di \emph{tipocomposizione}. \LaTeX\ è nato come sovrastruttura di un altro programma, \TeX, che continua ad esserne il motore. La prima versione di \TeX\ è stata creata nel -1978, ma è ancora usata oggi, naturalmente molto aggiornata, e +1978, ma è ancora usata oggi, naturalmente molto aggiornata e ampliata, 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 matematica; (b) egli l'ha messo a disposizione di +stessi libri di informatica matematica; (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 @@ -343,7 +350,7 @@ 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 +ripeto, è ancora in ottima salute e molto vivace dopo oltre trent'anni di onorato servizio. L'uso di \TeX\ per eseguire direttamente la composizione era piuttosto @@ -353,7 +360,7 @@ 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 consentisse agli -utenti di usare \TeX\ lasciandolo dietro alle quinte, in modo da +utenti di usare \TeX\ lasciandolo dietro le quinte, in modo da potersi concentrare sul contenuto dei loro scritti e non sulla forma da dare a questo o a quel dettaglio. @@ -399,22 +406,24 @@ funzioni, badando invece a presentare sullo schermo con la massima velocità il testo composto. \LaTeX\ richiede che voi scriviate un testo non formattato in puri -caratteri ASCII\footnote{In realtà potete scrivere con qualunque set di caratteri e con qualunque \emph{codepage}; oggi poi è possibile avere editor testuali che usano la codifica UNICODE, che consente, essendone capaci, di scrivere anche in cinese. Il documento che state leggendo è stato composto usando un file sorgente codificato in UNICODE; non contiene caratteri cinesi, ma avrei potuto farlo se conoscessi il cinese!}, ma marcato con un particolare sistema di +caratteri ASCII\footnote{In realtà potete scrivere con qualunque set di caratteri e con qualunque \emph{codifica}; oggi poi è possibile avere editor testuali che usano la codifica UNICODE, che consente, essendone capaci, di scrivere anche in cinese. Il documento che state leggendo è stato composto usando un file sorgente codificato in UNICODE; non contiene caratteri cinesi, ma avrei potuto farlo se conoscessi il cinese!}, ma marcato con un particolare sistema di \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 +vostro scritto: una equazione, una citazione, una enumerazione, una elencazione, una descrizione, una poesia, una bibliografia, una epigrafe, eccetera. 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. +Attenzione: questa guida presuppone che voi abbiate già una conoscenza di base del linguaggio \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}; basta cercare questi titoli in rete e si troverà 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 ciò 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 scrittura iniziale 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. -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 scrittura iniziale 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. +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 è molto 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. +Procuratevi invece un ottimo \emph{shell editor} predisposto per lavorare con \LaTeX, \XeLaTeX e \LuaLaTeX; 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 @@ -423,69 +432,71 @@ l'intero sistema \TeX\ ed è già calibrato per comporre correttamente, potete saltare questo paragrafo. Ci sono sostanzialmente tre situazioni. -\begin{enumerate}[noitemsep] -\item Se siete degli utenti delle piattaforme Windows allora potreste collegarvi in rete al sito \url{www.miktex.org} e scaricarvi ed installarvi la distribuzione di \LaTeX, o meglio, del sistema \TeX\ chiamato MiK\TeX. Se procedete per questa via, allora 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 modo di installare il sistema \TeX\ 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). +\begin{description} +\item[Windows] Gli utenti delle piattaforme Windows possono collegarsi in rete al sito \url{www.miktex.org} e scaricarvi ed installarsi la distribuzione di \LaTeX, o meglio, del sistema \TeX\ chiamata \MiKTeX. Se si procede per questa via, allora si scarichi l'installazione completa, anche se si potrebbe installare la versione di base \texttt{small-miktex} che, seguendo le istruzioni di installazione, bisogna configurare in modo da consentirle di scaricare dalla rete ogni possibile pacchetto di estensione che possa via via essere necessario. -Oggi su una macchina Windows consiglierei di installare la distribuzione 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. +Ovviamente questo modo di installare e usare il sistema \TeX\ implica una connessione di rete sufficientemente veloce; personalmente, quando usavo una piattaforma Windows, ero solito scaricare la versione completa ed ero molto soddisfatto. -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. +Oggi, però, anche su una macchina Windows consiglierei di installare la distribuzione \TeXLive che viene gestita nello stesso modo sia sulle piattaforme Windows, Linux e Mac. Il pregio è che \TeXLive viene aggiornata quasi quotidianamente sui server e comunque è la versione dalla quale il curatore di MiKTeX attinge per creare gli aggiornamenti della sua distribuzione; necessariamente, quindi, prima che il curatore sia riuscito a portare MiKTeX allo stesso livello di \TeXLive, passano di solito alcune settimane, a volte anche di più; non voglio togliere niente alla bravura del curatore, ma il progetto MiKTeX è il lavoro di un solo uomo, mentre \TeXLive è il frutto del lavoro di una squadra completa e attivissima. -\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. +\item[Linux] Gli utenti di Linux sono particolarmente fortunati perché il sistema \TeX\ è spesso parte integrante di qualunque variante di Linux, anche se non viene installato di default; basta inserire il disco di installazione o basta connettersi in rete e invocare uno dei vari programmi come \prog{apt-get}, \prog{rpm}, \prog{yast} o~\dots\ per scaricare tutto quanto serve e per configurare l'installazione. Bisogna ricordarsi 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 i``pinguini doc'' ci sono abituati; in compenso si ha il beneficio di avere tutto quanto il software già predisposto fin dalla nascita per macchine UNIX e Linux e quindi si evitano tutti i (pochi) piccoli bug che si incontrano quando le cose sono tradotte per altri sistemi operativi. -Fate solo attenzione alle distribuzioni Debian; sono eccellenti e ne è garantita la compatibilità con lo specifico sistema operativo, ma solitamente sono in ritardo di alcuni mesi, in passato di un paio di anni, rispetto alle versioni aggiornate pubblicate dal \TeX\ Users Group! Se appena potete installate la distribuzione TeX Live completa scaricata dal sito \url{http://www.tug.org/ctan.html} ufficiale. Esiste in rete un testo intitolato \emph{texlive-ubuntu.pdf}\footnote{Questo testo è stato scritto nel 2010 per installare TeX Live su Ubuntu, che è di tipo Debian, ma ci sono anche le istruzioni per Fedora e OpenSuse; con piccole varianti sono istruzioni che vanno bene per qualunque macchina Linux.}, che trovate con qualunque motore di ricerca; vi istruisce su come installare TeX Live fresco di giornata (e aggiornabile sistematicamente come detto sopra per le macchine Windows) a fianco della distribuzione Debian di TeX Live; quest'ultima serve per soddisfare le dipendenze di altri programmi Debian; la prima, invece, vi serve per lavorare davvero. +Si faccia solo attenzione alle distribuzioni Debian; sono eccellenti e ne è garantita la compatibilità con ogni sistema operativo conforme ai dettami del consorzio Debian, ma solitamente sono in ritardo di alcuni mesi, in passato anche di un paio di anni, rispetto alle versioni aggiornate pubblicate dal \TeX\ Users Group! Appena si può si installi la distribuzione \TeXLive completa scaricata dal sito \url{http://www.tug.org/ctan.html} ufficiale. Esiste in rete un testo intitolato \emph{texlive-ubuntu.pdf}\footnote{Questo testo è stato scritto nel 2010 per installare \TeXLive 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 si trova con qualunque motore di ricerca; specifica come installare \TeXLive fresco di giornata (e aggiornabile sistematicamente come detto sopra per le macchine Windows) a fianco della distribuzione Debian di \TeXLive; quest'ultima serve per soddisfare le dipendenze di altri programmi Debian; la prima, invece, serve per lavorare davvero. -\item Siete degli utenti delle piattaforme Macintosh e siete i possessori di un portatile o di un desktop che funziona con il sistema operativo Mac~OS~X. Anche voi avete a disposizione una distribuzione che si chiama \prog{Mac\TeX}, che viene installata e configurata con un particolare software adatto alla specificità del sistema che state usando. Cercate il nome MacTeX con un qualunque motore di ricerca e sarete portati ad un sito dal quale potrete scaricare il pacchetto di installazione (piuttosto grosso); alla fine del download vi viene chiesto se continuare con l'installazione; rispondendo affermativamente, il software vi viene scaricato sul disco che avrete indicato, ma quel che è più comodo, esso è già completo, come ogni distribuzione e installazione TeX Live. Il sistema \prog{Mac\TeX} produce il suo output essenzialmente in formato PDF; se ne tenga conto leggendo attentamente la documentazione. Il pacchetto è già dotato dello shell editor \TeX{}Shop che fa ricorso ad un suo previewer interno per il formato PDF; potrebbe essere una buona idea scaricare dalla rete anche l'applicativo freeware Adobe Reader che dalla versione 9 in poi è anche in grado di riconoscere se un file è o potrebbe essere conforme al formato PDF/A, anche se non è in grado di validarlo come tale; Adobe Reader X, quando apre un file che potrebbe essere conforme allo standard PDF/A, apre in testa alla schermata una riga di informazione nella quale dice che il file è conforme a questo standard; non è il caso di prendere alla lettera quella affermazione, perché i file che vengono classificati conformi allo standard PDF/A da Adobe Reader X, talvolta non passano il test di Preflight di Adobe Acrobat. Tuttavia consente di estrarre delle informazioni che sono difficili da estrarre con altri visualizzatori dei file in formato PDF e consente di aggiungere annotazioni. Naturalmente esistono altri visualizzatori dei file in formato PDF; sulle macchine Apple il visualizzatore di sistema consente di aprire e di editare parzialmente anche altri formati grafici e consente di eseguire molte operazioni, in particolare sui file PDF, che in generale richiedono altri sofisticati programmi di editing grafico. +\item[Mac] Gli utenti delle piattaforme Macintosh e possessori di un portatile o di un desktop che funziona con il sistema operativo Mac~OS~X hanno anche loro a disposizione una distribuzione che si chiama \prog{Mac\TeX}, che viene installata e configurata con un particolare software adatto alla specificità del sistema operativo. Si cerchi il nome MacTeX con un qualunque motore di ricerca che indicherà un sito dal quale si può scaricare il pacchetto di installazione (piuttosto grosso); alla fine del download viene chiesto se continuare con l'installazione; rispondendo affermativamente, il software viene scaricato sul disco che si sarà indicato, ma quel che è più comodo, esso è già completo, come ogni distribuzione e installazione \TeXLive. 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; questo previewer consente di eseguire sia l'\textit{inverse search} sia di fare la \textit{forward search}. Questo è estremamente comodo durante la fase di editing del documento. +%Potrebbe essere una buona idea scaricare dalla rete anche l'applicativo freeware Adobe Reader che dalla versione 9 in poi è anche in grado di riconoscere se un file è o potrebbe essere conforme al formato PDF/A, anche se non è in grado di validarlo come tale; Adobe Reader X, quando apre un file che potrebbe essere conforme allo standard PDF/A, apre in testa alla schermata una riga di informazione nella quale dice che il file è conforme a questo standard; non è il caso di prendere alla lettera quella affermazione, perché i file che vengono classificati conformi allo standard PDF/A da Adobe Reader X, talvolta non passano il test di Preflight di Adobe Acrobat. Tuttavia consente di estrarre delle informazioni che sono difficili da estrarre con altri visualizzatori dei file in formato PDF e consente di aggiungere annotazioni. Naturalmente esistono altri visualizzatori dei file in formato PDF; sulle macchine Apple il visualizzatore di sistema consente di aprire e di editare parzialmente anche altri formati grafici e consente di eseguire molte operazioni, in particolare sui file PDF, che in generale richiedono altri sofisticati programmi di editing grafico. -Attenzione, però: i previewer interni di \TeX{}shop e \TeX{works} consentono di eseguire l'\textit{inverse search} e, ovviamente, anche di fare la \textit{forward search}. Questo è molto comodo durante la fase di editing del vostro documento. Gli altri visualizzatori hanno difficoltà se non proprio l'impossibilità di ``accordarsi'' con la parte di editing testuale per consentire la ricerca diretta e inversa. Oggi (2012) Texmaker e TeXstudio, entrambi multipiattaforma, sono dotati di visualizzatori interni che consentono la ricerca diretta e inversa; TeXstudio dalla versione 2.5 è anche in grado di interpretare le righe di autoconfigurazione scritte con le sintassi di \TeX{}shop e \TeX{}works, e si è aggiunto alla lista degli \emph{shell editor} che sanno interpretare le righe di autoconfigurazione. L'editor \prog{emacs} con il suo plug-in \pack{auktex}, funziona benissimo come shell editor per lavorare con \LaTeX, sembrerebbe che possa venire ``sincronizzato'' con un visualizzatore PDF con il quale poter eseguire la ricerca diretta e inversa; sa riconoscere le righe di autoconfigurazione che però sono scritte con una sintassi diversa da quella degli altri programmi nominati prima. +%Attenzione, però: i previewer interni di \TeX{}shop e \TeX{works} consentono di eseguire l'\textit{inverse search} e, ovviamente, anche di fare la \textit{forward search}. Questo è molto comodo durante la fase di editing del vostro documento. Gli altri visualizzatori hanno difficoltà se non proprio l'impossibilità di ``accordarsi'' con la parte di editing testuale per consentire la ricerca diretta e inversa. Dal 2012 anche Texmaker e TeXstudio, entrambi multipiattaforma, sono dotati di visualizzatori interni che consentono la ricerca diretta e inversa; TeXstudio dalla versione 2.5 è anche in grado di interpretare le righe di autoconfigurazione scritte con le sintassi di \TeX{}shop e \TeX{}works, e si è aggiunto alla lista degli \emph{shell editor} che sanno interpretare le righe di autoconfigurazione. L'editor \prog{emacs} con il suo plug-in \pack{auctex}, funziona benissimo come shell editor per lavorare con \LaTeX, sembrerebbe che possa venire ``sincronizzato'' con un visualizzatore PDF con il quale poter eseguire la ricerca diretta e inversa; sa riconoscere le righe di autoconfigurazione che però sono scritte con una sintassi diversa da quella degli altri programmi nominati prima. -\end{enumerate} +\end{description} -Merita di segnalare che per tutte e tre le piattaforme è disponibile e, talvolta, è già installato di default anche l'editor \TeX{}works (multipiattaforma) che, con il suo visualizzatore interno, consente di eseguire su tutte le piattaforme la ricerca diretta e inversa. Ad alcuni, abituati a interfacce grafiche fornite di molte barre cariche di icone per eseguire il possibile e l'impossibile, \TeX{}works piace poco perché la sua schermata è minimale, ma c'è un motivo: nei moderni schermi larghi, con rapporto di forma 16:9, lo schermo contiene accostate e senza sovrapposizioni sia la finestra di editing sia quella del testo composto; questo è molto comodo, più di quanto si possa immaginare, per ``lavorare'' agevolmente il documento da comporre. Benché anche Texmaker e TeXstudio siano in grado di accostare le due schermate, essi consumano molto spazio per le barre superiori, inferiori e laterali, cosicché le vere aree destinate all'editing o alla visualizzazione ne risultano corrispondentemente ristrette, tanto da far preferire \TeX{}works sui laptop e ancor di più sui netbook. +Merita di segnalare che per tutte e tre le piattaforme è disponibile e, talvolta, è già installato di default anche l'editor \TeX{}works (multipiattaforma) che, con il suo visualizzatore interno, consente di eseguire 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 piattaforma il programma \prog{Adobe Reader} che la Adobe mette a disposizione di chiunque gratuitamente e per tutte le possibili piattaforme\footnote{Sembra che con Linux le cose non stiano più così, ma in rete si trovano ancora delle installazioni non recentissime, ma funzionanti, anche per Linux.}. Naturalmente l'\prog{Adobe Reader} è una specie di programma dimostrativo, per altro eccellente; ma credo che la Adobe lo metta a disposizione per far venire l'acquolina in bocca e per invogliare a comperare il prodotto commerciale completo \prog{Adobe Acrobat}, che per gli studenti non costa molto con il programma Education di quella casa. Secondo me vale ogni dollaro che costa, ma ovviamente questo giudizio dipende dall'uso che se ne fa. +Poi sono necessari i programmi accessori per visualizzare sullo schermo e/o stampare su carta i prodotti della composizione. 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 già installata, però oggi è un formato che non si usa quasi più. Per il formato \texttt{.ps} bisogna disporre di qualcosa come \prog{ghostscript} e/o \prog{GSView} o altri simili software che con Linux sono solitamente già disponibili insieme al sistema. In ogni caso non è difficile trovare in rete i luoghi da dove scaricarli. Per il formato \texttt{.pdf} Linux, come al solito è già attrezzato, ma non è male per tutti e tre i tipi di piattaforma il programma \prog{Adobe Reader} che la Adobe mette a disposizione di chiunque gratuitamente e per tutte le possibili piattaforme\footnote{Sembra che con Linux le cose non stiano più così, ma in rete si trovano ancora delle installazioni non recentissime, ma funzionanti, anche per Linux.}. Naturalmente l'\prog{Adobe Reader} è una specie di programma dimostrativo, per altro eccellente; ma credo che la Adobe lo metta a disposizione per far venire l'acquolina in bocca e per invogliare a comperare il prodotto commerciale completo \prog{Adobe Acrobat}; per gli studenti non costa molto in accordo con il programma Education di quell'azienda. 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. +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 (multipiattaforma) posso citare gli editor TeXstudio 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. +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. -Per le piattaforme Linux esiste uno \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. Di solito \prog{Kile} è obbligato alla dipendenza da TeX Live/Debian, per cui sarebbe meglio non farne uso. +%Per le piattaforme Linux esiste uno \emph{shell editor} che si chiama +%\prog{Kile} (KDE Integrated \LaTeX\ Environment) ed è fatto +%apposta per lavorare con \LaTeX. Esso è installabile 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. Di solito \prog{Kile} è obbligato alla dipendenza da \TeXLive/Debian, per cui sarebbe meglio non farne uso. -Per le piattaforme Windows il programma di installazione di MiK\TeX\ offriva la possibilità di installare \prog{TeXnicCenter}, ma lo sconsiglio vivamente, perché non è all'altezza delle distribuzioni moderne di MiK\TeX\ e di TeX Live; oggi mi pare che MiK\TeX\ venga distribuito con TeXstudio. 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 Windows il programma di installazione di \MiKTeX\ offriva la possibilità di installare \prog{TeXnicCenter}, ma lo sconsiglio vivamente, perché non è all'altezza delle distribuzioni moderne di \MiKTeX\ e di \TeXLive; oggi mi pare che \MiKTeX\ venga distribuito con TeXstudio. 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 al file, cosa che rende il loro uso incredibilmente comodo. TeXstudio dalla versione 2.5 in poi è in grado di interpretare le stesse righe speciali di \TeX{}shop e di autoconfigurarsi di conseguenza (settembre 2012). Emacs con Auctex è in grado di usare righe di autoconfigurazione che però hanno una sintassi diversa da quelle di \TeX{}shop. Questa affermazione vale anche per Aquamacs, che è una applicazione per Mac che integra direttamente emacs e Auctex.\looseness=-1 +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 auto"configurabili per ciascun file \file{.tex} grazie ad alcune righe di commenti speciali da scrivere in testa al file, cosa che rende il loro uso incredibilmente comodo. TeXstudio dalla versione 2.5 in poi è in grado di interpretare le stesse righe speciali di \TeX{}shop e di autoconfigurarsi di conseguenza (settembre 2012). Emacs con Auctex è in grado di usare righe di autoconfigurazione che però hanno una sintassi diversa da quelle di \TeX{}shop. Questa affermazione vale anche per Aquamacs, che è una applicazione per Mac che integra direttamente emacs e Auctex.\looseness=-1 -Per tutte e tre le piattaforme principali \prog{TeXStudio} offre notevoli vantaggi, compresa la visualizzazione di parti del testo da comporre che richiedano più interazione fra il compositore e il software. Permette anche di disporre di una finestra laterale che contiene tutta la struttura ad albero del documento da comporre; cliccando su ogni ramo o rametto di questo albero, il programma sposta la finestra sul punto del file sorgente dove quella sezione comincia. Anche \prog{Kile} ha questa funzionalità. Quasi tutti gli editor citati \emph{non} consentono di fare la ricerca inversa con il formato di uscita PDF, ma solo con il formato DVI. \prog{TeXShop} per Mac, e \prog{TeXworks} e le due versioni \prog{TeXmaker} e \prog{TeXStudio} per tutte le piattaforme permettono di eseguire nativamente la ricerca inversa anche con il formato PDF, e questa particolarità è estremamente comoda. Per le piattaforme Windows esiste il visualizzatore PDF \prog{SumatraPDF} che può essere configurato per interagire con molti editor per poter essere usati assieme sia con la ricerca diretta sia con quella inversa. Va da sé, che se non ci sono esigenze diverse, il formato di uscita PDF è sicuramente quello da preferire. +Per tutte e tre le piattaforme principali \prog{TeXStudio} offre notevoli vantaggi, compresa la visualizzazione di parti del testo da comporre che richiedano più interazione fra il compositore e il software. Permette anche di disporre di una finestra laterale che contiene tutta la struttura ad albero del documento da comporre; cliccando su ogni ramo o rametto di questo albero, il programma sposta la finestra sul punto del file sorgente dove quella sezione comincia. 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}, \prog{TeXStudio} e \prog{TeXmaker} per tutte le piattaforme permettono di eseguire nativamente la ricerca inversa anche con il formato PDF, e questa particolarità è estremamente comoda. Per le piattaforme Windows esiste il visualizzatore PDF \prog{SumatraPDF} che può essere configurato per interagire con molti editor per poter essere usati assieme sia con la ricerca diretta sia con quella inversa. Va da sé, che se non ci sono esigenze diverse, il formato di uscita PDF è sicuramente quello da preferire. Mi sono ripetuto diverse volte nel descrivere gli editor per lavorare con il sistema \TeX? L'ho fatto apposta, a costo di essere noioso. Lavorare con editor efficienti, ben adattati al lavoro che si deve fare e che consentano la ricerca diretta e inversa fra la finestra di editing e quella del file composto in formato PDF è talmente importante, che le ripetizioni non sono mai abbastanza. +\goodpagebreak + \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 \acro{ascii}, siete in grado di capire come funziona il tutto.\label{warn:avvertenza} +{\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 descritti sopra, siete in grado di capire come funziona il tutto.\label{warn:avvertenza} -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\ I forum vanno benissimo, ma per rispondere a domande serie, non a cose che si trovano già documentate.} +Attenzione: non si minimizzi la frase precedente: la documentazione va letta sempre e va capita fino in fondo; se c'è qualcosa che non si capisce, si provi 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\ I forum vanno benissimo, ma per rispondere a domande serie, non a cose che si trovano già documentate.} -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. +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 vuole comunicare 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 e di LibreOffice con l'estensione~1.2 di \prog{Writer2LaTeX}. Io le sconsiglio tutte, come ho già avuto modo di dire, e qui ne ripeto i motivi. -Per poter operare in modo ``sincrono'' così da avere immediatamente sullo schermo una cosa molto simile a quello che si otterrà sulla carta, il programma deve essere velocissimo ad eseguire il rendering grafico di quanto viene via via composto; per questo motivo deve rinunciare a non poche funzionalità del sistema \TeX. Però tutti questi software hanno la possibilità di salvare i file in formato \texttt{.tex}, cioè nel formato sorgente del sistema \TeX, per cui una volta finito l'editing si può eseguire la composizione finale con il programma vero, e non tramite le funzionalità del programma di editing. +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 immesso nel testo; 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. +Io ho cominciato a lavorare con \LaTeX\ a metà degli anni '80 e non ho mai usato editor sincroni. Negli anni '90 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. \begin{table}[!tb]{\centering +\caption[Le principali differenze fra \textsf{pdflatex} e \textsf{xelatex}]{Le principali differenze fra \pdfLaTeX\ e \protect\XeLaTeX }\label{tab:pdflatex-vs-xelatex} \begin{tabular}{lp{.3\textwidth}p{.25\textwidth}} \toprule & \centering pdf\LaTeX & \centering \XeLaTeX \tabularnewline @@ -503,36 +514,35 @@ Gestione Lingue & \centering circa 80 lingue &\centering circa 80 lingue \tab Formati immagini & \raggedright PDF, JPG, PNG, EPS($\dagger$) & 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 +Formato archiviabile& \centering PDF/A-1b & \centering SI, ma\dots\ (*) \tabularnewline \bottomrule \end{tabular}\par} -\caption[Le principali differenze fra \textsf{pdflatex} e \textsf{xelatex}]{Le principali differenze fra \pdfLaTeX\ e \protect\XeLaTeX }\label{tab:pdflatex-vs-xelatex} -\vspace{\smallskipamount} -\small \noindent (*) \XeLaTeX\ non consente la produzione diretta del formato PDF/A, ma ne consente la trasformazione mediante altri programmi, forse, in modo ancor più sicuro che con \pdfLaTeX. +\vspace*{\medskipamount} +\small \noindent (*) \XeLaTeX\ con la distribuzione 2016 di \TeXLive, consente la produzione diretta del formato PDF/A, ma richiede delle attenzioni particolari che verranno descritte nel seguito. \noindent ($\dagger$) Dalla versione del 2010 \pdfLaTeX\ converte automaticamente in formato PDF i file EPS, conservandone quindi il carattere vettoriale; provvede anche a scontornarli. \end{table} 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 personali non sono interpretabili da quei sistemi che sono un po' chiusi in se stessi, proprio per poter massimizzare la velocità di rendering. -Il difetto maggiore di questi programmi di composizione sincrona è che distraggono l'autore con l'aspetto del testo composto più o meno fedelmente a quello che si potrà ottenere davvero. Scrivere in modo WYSIWYM. significa concentrarsi sul messaggio e non sul suo aspetto. Inoltre quando con quei programmi si esporta il documento in formato \LaTeX, il codice generalmente è penoso; dipende dal contenuto, ma generalmente la cosa richiede un pesante lavoro di pulizia e di riscrittura di alcune parti per renderle veramente scritte e marcate come si deve. Se poi bisogna fare delle modifiche, queste vanno comunque fatte sul file \LaTeX, perché in generale quei programmi non accettano macro personali o pacchetti per i quali non sono già predisposti. In sostanza è una gran perdita di tempo e non vale assolutamente la pena farne uso, nemmeno se si è principianti e si trova comodo ricorrere a qualcosa che ricorda l'uso dei word processor a cui si è già abituati; il principiante che cominci con questi software, non imparerà mai a usare \LaTeX\ come si deve. +Il difetto maggiore di questi programmi di composizione sincrona è che distraggono l'autore con l'aspetto del testo composto più o meno fedelmente a quello che si potrà ottenere davvero. Scrivere in modo WYSIWYM significa concentrarsi sul messaggio e non sul suo aspetto. Inoltre quando con quei programmi si esporta il documento in formato \LaTeX, il codice generalmente è penoso; dipende dal contenuto, ma generalmente è richiesto un pesante lavoro di pulizia e di riscrittura di alcune parti per renderle veramente scritte e marcate come si deve. Se poi bisogna fare delle modifiche, queste vanno comunque fatte sul file \LaTeX, perché in generale quei programmi non accettano macro personali o pacchetti per i quali non siano già predisposti. In sostanza è una gran perdita di tempo e farne uso non vale assolutamente la pena, nemmeno se si è principianti e si trova comodo ricorrere a qualcosa che ricorda l'uso dei word processor a cui si è già abituati; il principiante che cominci con questi software, non imparerà mai a usare \LaTeX\ come si deve. -\textcolor{red}{Nel seguito partirò dal presupposto che abbiate già una certa -conoscenza di \LaTeX\ e che conosciate la differenza fra \LaTeX, +\textcolor{red}{Nel seguito partirò dal presupposto che si abbia già una certa +conoscenza di \LaTeX\ e che si conosca la differenza fra \LaTeX, \pdfLaTeX, \XeLaTeX\ e \LuaLaTeX.} - -È possibile che qualcuno non 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 \pdfLaTeX, ma ha una gestione dei font diversa e può usare anche i font del sistema operativo del suo calcolatore, senza dover fare nessuna acrobazia per installarli e configurarli. 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\ 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. +È possibile che qualcuno non 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 \pdfLaTeX, ma ha una gestione dei font diversa e può usare anche i font del sistema operativo, senza dover fare nessuna acrobazia per installarli e configurarli. Esso ha bisogno di attenzioni particolari per quel che riguarda la creazione dei file in formato PDF archiviabile, anche se 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\ 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. Oggi \LuaLaTeX\ può sostituire completamente \XeLaTeX\ anche se talvolta sembra leggermente più lento nel suo lavoro; in compenso la sua integrazione con il linguaggio di scripting Lua gli permette di fare cose impossibili con gli altri programmi citati. Merita qui segnalare con una tabellina le principali differenze fra \pdfLaTeX\ e \XeLaTeX, tabella~\ref{tab:pdflatex-vs-xelatex} nella pagina~\pageref{tab:pdflatex-vs-xelatex}. + %%%%%%%%%%%%%%%%%%%%%%%%%% \chapter{L'uso di \textsf{TOPtesi}}\label{cap:uso} -la maggior parte delle macro definite nel pacchetto TOPtesi servono per comporre il frontespizio; siccome l'utente potrebbe desiderare comporre il frontespizio in modo diverso da quello preimpostato in questa classe, prima esporrò come e perché la classe si comporta in un certo modo per comporre questa prima e importante pagina della tesi, poi esporrò che cosa bisogna fare se si usano altri pacchetti o altre tecniche per comporre il frontespizio. +La maggior parte delle macro definite nel pacchetto TOPtesi servono per comporre il frontespizio; siccome l'utente potrebbe desiderare di comporre il frontespizio in modo diverso da quello preimpostato in questa classe, prima esporrò come e perché la classe si comporta in un certo modo per comporre questa prima e importante pagina della tesi, poi esporrò che cosa bisogna fare se si usano altri pacchetti o altre tecniche per comporre il frontespizio. -Ci si ricordi comunque che l'aspetto generale dalla pagina, i font usati o gli altri font alternativi che si possono usare, il frontespizio, e altri elementi che costituiscono il ``look' della tesi composta con questa classe, sono abbastanza rigidi; non dico che questa classe sia rigorosamente del tipo ``prendere o lasciare'', ma sicuramente non è una classe generica da poter personalizzare a piacere in ogni dettaglio. Ci sono altre classi disponibili già distribuite con il sistema \TeX\ (aggiornato e completo); ne cito alcune: i modelli \file{TesiClassica} e \file{TesiModerna} (non distribuiti con il sistema \TeX, ma scaricabili dalla sezione Documentazione del sito \url{www.guitex.org}); la classe \class{sapthesis}, impostata sulle prescrizioni dell'università di Roma La~Sapienza, la classe \class{suftesi}, che in realtà non serve solo per comporre tesi, ma serve anche per comporre diversi altri tipi di documenti in diversi formati e con diversi stili; il pacchetto \pack{ClassicThesis} che richiede la classe \class{scrreprt}, dall'aspetto molto bello, ma potrebbe non essere adatta per tesi nelle discipline delle scienze sperimentali. Nessuna di queste classi è configurabile a piacere, ma solo nei limiti delle personalizzazioni previste. Quella più configurabile mi pare sia la classe \class{suftesi}, ma anche questa classe, esplicitamente predisposta per tesi nel campo delle scienze umane, forse è meno flessibile per le scienze sperimentali. +Ci si ricordi comunque che l'aspetto generale dalla pagina, i font usati o gli altri font alternativi che si possono usare, il frontespizio, e altri elementi che costituiscono il ``look' della tesi composta con questa classe, sono abbastanza rigidi; non dico che questa classe sia rigorosamente del tipo ``prendere o lasciare'', ma sicuramente non è una classe generica da poter personalizzare a piacere in ogni dettaglio. Ci sono altre classi disponibili già distribuite con il sistema \TeX\ (aggiornato e completo); ne cito alcune: la classe \class{sapthesis}, impostata sulle prescrizioni dell'università di Roma La~Sapienza, la classe \class{suftesi}, che in realtà non serve solo per comporre tesi, ma serve anche per comporre diversi altri tipi di documenti in diversi formati e con diversi stili. Nessuna di queste classi è configurabile a piacere, ma solo nei limiti delle personalizzazioni previste. Quella più configurabile mi pare sia la classe \class{suftesi}, ma anche questa, esplicitamente predisposta per tesi nel campo delle scienze umane, forse è meno flessibile per le scienze sperimentali. @@ -544,15 +554,15 @@ 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 è quello preimpostato per l'Ateneo; 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. +di Torino, il cui nome è quello preimpostato per l'Ateneo; 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 molti atenei e molte strutture didattiche e, oserei dire, in molte lingue. -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: +Presso il Politecnico di Torino, l'ateneo preso come riferimento, le facoltà non esistono più; perciò il valore preimpostato per la stringa ``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 quasi 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 \cs{StrutturaDidattica}, equivalente a \cs{FacoltaDi}, e \cs{struttura}, equivalente a \cs{facolta}. +Il nome del corso di laurea potrebbe essere facoltativo se la struttura didattica competente cura la didattica di un solo corso di laurea, ma quasi 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 \cs{StrutturaDidattica}, equivalente a \cs{FacoltaDi}, e \cs{struttura}, equivalente a \cs{facolta}. \iffalse % METACOMMENTO Tenete conto che \textsf{TOPtesi} è già stato usato anche per @@ -568,7 +578,7 @@ nel comporre una poesia o un romanzo o un'edizione critica. \subsection{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 sapere 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{\textasciitilde/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'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 tipo UNIX essa si indica simbolicamente con la tilde e la radice del vostro albero personale potrebbe chiamarsi \texttt{\textasciitilde/texmf}; sulle macchine Windows invece dovete cercare in \texttt{C:\char92Documents and settings} seguito dal vostro \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 personali di classe, di stile, di definizioni, eccetera. 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. @@ -580,12 +590,11 @@ Tutti i file del pacchetto \textsf{TOPtesi} vengono caricati nell'albero della d È comodo, ma non è obbligatorio, disporre di un file di configurazione. Esso serve essenzialmente per contenere i comandi con i loro argomenti necessari per comporre il frontespizio della tesi. Ma se usate qualche altro pacchetto o qualche altro metodo per creare il frontespizio, il file di configurazione, anche se presente, non viene usato. -Il pacchetto \textsf{TOPtesi} contiene già alcuni file con configurazioni di default da usare come modello; chiunque se ne può può copiare uno in un altro file mantenendo l'estensione \texttt{.cfg} e con il nome identico a quello del file principale della tesi. Questo file, se esiste, verrà letto durante l'esecuzione del programma e verranno eseguiti tutti i comandi che esso contiene; se quindi il laureando ne fa uso, deve servirsi del modello per cambiarne i dati e metterci le informazioni che ritiene utili per la sua tesi. Se non vuole servirsi del file di configurazione deve solo inserire nel suo file principale tutte le informazioni necessarie al frontespizio (e al retrofrontespizio, se lo vuole usare) prima di specificare l'ambiente -\amb{frontespizio} o il comando \cs{frontespizio}. +Il pacchetto \textsf{TOPtesi} contiene già alcuni file con configurazioni di default da usare come modello; chiunque se ne può copiare uno in un altro file mantenendo l'estensione \texttt{.cfg} e con il nome identico a quello del file principale della tesi. Questo file, se esiste, verrà letto durante l'esecuzione del programma e verranno eseguiti tutti i comandi che esso contiene; se quindi il laureando ne fa uso, deve servirsi del modello per cambiarne i dati e metterci le informazioni che ritiene utili per la sua tesi. Se non vuole servirsi del file di configurazione deve solo inserire nel suo file principale tutte le informazioni necessarie al frontespizio (e al retrofrontespizio, se lo vuole usare) prima di specificare l'ambiente \amb{frontespizio} o il comando \cs{frontespizio}. -{\tolerance=3000 Il laureando perciò può usare un diverso file di configurazione, sempre chiamato \meta{mainfile}\texttt{.cfg}, collocato nella stessa cartella dove risiede il materiale da comporre. Per esempio, potrebbe comporre la monografia di laurea creando da qualche parte la cartella \texttt{/monografia} e in questa cartella si crea \meta{mainfile}\texttt{.cfg} nel quale scrive quello che gli è necessario; in questa cartella sistema anche i file per comporre la monografia. Quando due anni dopo compone la sua tesi di laurea magistrale, crea da qualche parte la cartella \texttt{/tesi} e ci mette dentro un'altro file \meta{mainfile}\texttt{.cfg} con la sua configurazione adattata alla tesi magistrale; in questa stessa cartella mette i file relativi alla sua tesi magistrale. Se dopo tre anni prende il dottorato e si scrive la sua dissertazione dottorale, si crea da qualche parte la cartella \texttt{/dissertazione} e vi mette dentro un altro file \meta{mainfile}\texttt{.cfg} che configura per la sua dissertazione; sempre in questa stessa cartella mette i file necessari per comporre la sua dissertazione. Ovviamente nei tre casi \meta{mainfile} è il nome del file principale che, altrettanto ovviamente, sarà diverso per ciascuna delle tre tesi.\par} +{\tolerance=3000 Il laureando perciò può usare un diverso file di configurazione, sempre chiamato \meta{mainfile}\texttt{.cfg}, collocato nella stessa cartella dove risiede il materiale da comporre. Per esempio, potrebbe comporre la monografia di laurea creando da qualche parte la cartella \texttt{/monografia} e in questa cartella si crea \meta{mainfile}\texttt{.cfg} nel quale scrive quello che gli è necessario; in questa cartella sistema anche i file per comporre la monografia. Quando due anni dopo compone la sua tesi di laurea magistrale, crea da qualche parte la cartella \texttt{/tesi} e ci mette dentro un altro file \meta{mainfile}\texttt{.cfg} con la sua configurazione adattata alla tesi magistrale; in questa stessa cartella mette i file relativi alla sua tesi magistrale. Se dopo tre anni prende il dottorato e si scrive la sua dissertazione dottorale, si crea da qualche parte la cartella \texttt{/dissertazione} e vi mette dentro un altro file \meta{mainfile}\texttt{.cfg} che configura per la sua dissertazione; sempre in questa stessa cartella mette i file necessari per comporre la sua dissertazione. Ovviamente nei tre casi \meta{mainfile} è il nome del file principale che, altrettanto ovviamente, sarà diverso per ciascuna delle tre tesi.\par} -{\tolerance=3000 Nota bene: il modulo \pack{topfront} che contiene i comandi per la composizione del frontespizio di oltre al comando per caricare l'eventuale file di configurazione, chiama quest'ultimo file col nome \verb|\jobname.cfg|. La macro \verb|\jobname| è la stessa usata da \LaTeX\ per conservare il nome senza estensione del main file del documento che si sta componendo; quindi se il main file si chiamasse \texttt{GiorgioRossi"TesiMagisrale.tex} il file di configurazione associato a questo main file si deve chiamare obbligatoriamente \texttt{GiorgioRossiTesiMagisrale.cfg}. Siccome i sistemi operativi di tipo UNIX distinguono le lettere maiuscole dalla minuscole nei nomi dei file, se il file di configurazione si chiamasse \texttt{giorgiorossitesimagisrale."cfg} non verrebbe letto da Linux o da Mac~OS~X perché il nome proprio del file è scritto in tutte lettere minuscole, e non sarebbe uguale al nome proprio del main file che contiene anche delle lettere maiuscole. Per evitare problemi si consiglia di rispettare le maiuscole e le minuscole anche agli utenti dei sistemi operativi Windows, anche se questi sistemi operativi non distinguono i nome dei file in base al fatto che contengano lettere maiuscole o minuscole.\par} +{\tolerance=3000 Nota bene: il modulo \pack{topfront} che contiene i comandi per la composizione del frontespizio oltre al comando per caricare l'eventuale file di configurazione, chiama quest'ultimo file col nome \verb|\jobname.cfg|. La macro \verb|\jobname| è la stessa usata da \LaTeX\ per conservare il nome senza estensione del main file del documento che si sta componendo; quindi se il main file si chiamasse \texttt{GiorgioRossi"TesiMagistrale.tex} il file di configurazione associato a questo main file si deve chiamare obbligatoriamente \texttt{GiorgioRossiTesiMagistrale.cfg}. Siccome i sistemi operativi di tipo UNIX distinguono le lettere maiuscole dalla minuscole nei nomi dei file, se il file di configurazione si chiamasse \texttt{giorgiorossitesimagistrale."cfg} non verrebbe letto da Linux o da Mac~OS~X perché il nome proprio del file è scritto in tutte lettere minuscole, e non sarebbe uguale al nome proprio del main file che contiene anche delle lettere maiuscole. Per evitare problemi si consiglia di rispettare le maiuscole e le minuscole anche agli utenti dei sistemi operativi Windows, anche se questi sistemi operativi non distinguono i nomi dei file in base al fatto che contengano lettere maiuscole o minuscole.\par} \section{Pronti? Via!} @@ -601,11 +610,11 @@ approssimazione. Ricordatevi però che, anche se non c'è limite al meglio (ma nemmeno al peggio!), \LaTeX\ lavora benissimo da solo purché non lo si disturbi con interventi non professionali; se non siete un tipografo professionista, lasciate perdere ogni modifica tipografica; \LaTeX, lo ripeto, lavora generalmente meglio di molti tipografi; è proprio il motivo per il quale Knuth ha realizzato il sistema \TeX. -\newpage - \section{I file accessori} -Qui verranno descritti alcuni usi del modulo \pack{topfront} e del modulo \pack{topcoman}. Il primo serve per comporre il frontespizio; il secondo mette a disposizione alcuni comandi utili. Né l'uno né latro sono indispensabili, ma sono utili. +Qui verranno descritti alcuni usi del modulo \pack{topfront} e del modulo \pack{topcoman}. Il primo serve per comporre il frontespizio; il secondo mette a disposizione alcuni comandi utili. Né l'uno né l'atro sono indispensabili, ma sono utili. Questi due pacchetti sono sempre caricati da TOPtesi, tranne in alcuni casi specificati meglio più avanti. Ma il fato di venire o non venire caricati dipende dall'utente, cioè dalle opzioni che egli specifica alla classe \class{toptesi} e dai pacchetti aggiuntivi che egli vuole usare; in altre parole l'utente non ha mai bisogno di caricare esplicitamente questi due pacchetti ma può solo esplicitamente specificare azioni che ne impediscono il caricamento. + +\goodpagebreak \subsection{Comporre il frontespizio con topfront}\label{sec:frontespizi} @@ -633,7 +642,7 @@ piacere, per esempio, con grande fantasia, \file{myfile.tex}: \verb|%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%| \% Impostazioni per comporre con XeLaTeX \verb|\setmainfont[Ligatures=TeX]{TeX Gyre Termes}% o altro font| -\verb|\setmainlanguage{italian}% o altra lingua| +\verb|\setotherlanguage{french}% o altra lingua| \verb|%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%| ~ \meta{il resto del preambolo} @@ -661,7 +670,7 @@ piacere, per esempio, con grande fantasia, \file{myfile.tex}: La parte che ho indicato con \meta{il resto del preambolo} e \meta{il resto della tesi} sono facoltative; certo sono necessarie quando si compone l'intera tesi; per comporre il solo frontespizio si possono omettere. -Perciò bisogna fare attenzione: se si compone il frontespizio separatamente dalla tesi, la riga \cs{documentclass} deve essere identica alla corrispondente riga del vostro main file della tesi; siccome \pack{toptesi} può usare diversi formati di carta, è necessario che il frontespizio sia composto su carta dello stesso formato. Non è invece necessario usare come font normale un font dello stesso corpo della tesi; con carte particolarmente piccole potrebbe essere più opportuno usare il corpo di 10\,pt invece che quello di 12\,pt. Se dovete scrivere in inglese o in un'altra lingua specificatelo con \cs{setmainlanguage}. Si noti che l'esempio precedente è impostato per comporre il frontespizio con \XeLaTeX, ma se si lavora con \pdfLaTeX, allora vanno specificati i font da usare, e le codifiche di entrata e di uscita; bisogna anche impostare la lingua nella maniera specifica di \pack{babel}. Non scendo nei dettagli, perché fra i vari modelli forniti con il pacchetto TOPtesi, ce ne sono alcuni predisposti per lavorare con \pdfLaTeX\ e altri con \XeLaTeX\ (o \LuaLaTeX). +Perciò bisogna fare attenzione: se si compone il frontespizio separatamente dalla tesi, la riga \cs{documentclass} deve essere identica alla corrispondente riga del vostro main file della tesi; siccome \pack{toptesi} può usare diversi formati di carta, è necessario che il frontespizio sia composto su carta dello stesso formato. Non è invece necessario usare come font normale un font dello stesso corpo della tesi; con carte particolarmente piccole potrebbe essere più opportuno usare il corpo di 10\,pt invece che quello di 12\,pt. Se si deve scrivere in un'altra lingua diversa dall'italiano e dall'inglese lo si specifica con \cs{setotherlanguage} con le modalità che verranno esposte più avanti. Si noti che l'esempio precedente è impostato per comporre il frontespizio con \XeLaTeX, ma se si lavora con \pdfLaTeX, allora vanno specificati i font da usare, e le codifiche di entrata e di uscita; bisogna anche impostare la lingua nella maniera specifica di \pack{babel}. Non scendo nei dettagli, perché fra i vari modelli forniti con il pacchetto TOPtesi, ce ne sono alcuni predisposti per lavorare con \pdfLaTeX\ e altri con \XeLaTeX\ o \LuaLaTeX. Comunque, se si vuole usare \prog{pdflatex}, la parte fra le prime due righe \verb|%%%| va sostituita, per esempio, con: @@ -672,7 +681,7 @@ va sostituita, per esempio, con: \end{verbatim} Ma se si deve scrivere il frontespizio in un'altra lingua bisogna agire come spiegato poco più avanti. -In realtà il pacchetto \pack{topfront} lavora bene in italiano e distingue i singolari dai plurali, i maschili dai femminili; non fa nulla di particolare se la lingua di composizione del frontespizio è l'inglese o un'altra lingua; ricordate che l'inglese è già impostato ma non attivato; lo si attiva nel main document con il comando \cs{english}. Se si vuole comporre il frontespizio in un'altra lingua, allora, usando \prog{xelatex}, la si specifica mediante il comando \cs{setmainlanguage}; invece usando \pdfLaTeX\ la si indica fra le opzioni di \cs{documentclass} e poi, prima di usare l'ambiente \amb{frontespizio} o \cs{frontespizio*} o i comandi corrispondenti, la si imposta con \cs{selectlanguage}. Poi si inseriscono i seguenti comandi, modificando gli argomenti in accordo con le restrizioni burocratiche per i frontespizi delle tesi nella vostra università: +In realtà il pacchetto \pack{topfront} lavora bene in italiano e distingue i singolari dai plurali, i maschili dai femminili; non fa nulla di particolare se la lingua di composizione del frontespizio è l'inglese o un'altra lingua; ricordate che l'inglese è già impostato ma non attivato; lo si attiva nel main document con il comando \cs{english}. Se si vuole comporre il frontespizio in un'altra lingua, allora, usando \prog{xelatex}, la si specifica mediante il comando \cs{setotherlanguage}; invece usando \pdfLaTeX\ la si indica fra le opzioni di \cs{documentclass} e poi, prima di usare l'ambiente \amb{frontespizio} o \cs{frontespizio*} o i comandi corrispondenti, la si imposta con \cs{selectlanguage}. Poi si inseriscono i seguenti comandi, modificando gli argomenti in accordo con le restrizioni burocratiche per i frontespizi delle tesi nella vostra università: \begin{Verbatim}[fontsize=\small] \retrofrontespizio{This work is subject to the Creative Commons Licence} \DottoratoIn{PhD Course in\space} @@ -692,8 +701,8 @@ In realtà il pacchetto \pack{topfront} lavora bene in italiano e distingue i si \logosede{logouno,logodue}% one logo or a comma separated list of logos \end{Verbatim} -Passando uno di questi file a \prog{xelatex} o a \prog{pdflatex}, si ottiene -un documento con il frontespizio e, facoltativamente, il retrofrontespizio, che si possono stampare in varie copie per gli scopi detti sopra. Ricordate che \class{toptesi} precarica \pack{babel} o \pack{polyglossia} a seconda che usiate \prog{pdflatex} oppure \prog{xelatex}; non avete quindi l'obbligo di invocare di nuovo questi pacchetti se componete il solo frontespizio usando \class{toptesi}, ma dovete specificare la lingua che volete usare nei modi descritti sopra. +Passando uno di questi file a \prog{xelatex} o a \prog{pdflatex}, si ottiene +un documento con il frontespizio e, facoltativamente, il retrofrontespizio, che si possono stampare in varie copie per gli scopi detti sopra. Ricordate che \class{toptesi} precarica \pack{babel} o \pack{polyglossia} a seconda che usiate \prog{pdflatex} oppure \prog{xelatex} o \prog{lualatex}; non avete quindi l'obbligo di invocare di nuovo questi pacchetti se componete il solo frontespizio usando \class{toptesi}, ma dovete specificare la lingua che volete usare nei modi descritti sopra. Il retrofrontespizio non è necessario in senso assoluto quando volete produrre il frontespizio isolato. Non è nemmeno necessario quando volete comporre la tesi. Tuttavia il comando è disponibile e permette di aggiungere la dichiarazione legale in merito alla licenza; il retrofrontespizio di questa documentazione è stato composto con i comandi seguenti\footnote{Questo codice contiene dei comandi \cs{ref} perché è servito per comporre l'intero documento dove le etichette invocate sono definite. Se si vuole usare questo codice per comporre il retrofrontespizio assieme al frontespizio, ma isolatamente dalla tesi (lo sconsiglio), bisogna sostituire quei comandi e i loro argomenti con i valori reali.}: \begin{verbatim} @@ -703,19 +712,16 @@ nell'appendice~\ref{ch:LPPL} alla pagina~\pageref{ch:LPPL}. \bigskip -\noindent Composto con -\ifPDFTeX\pdfLaTeX\else -\ifXeTeX\XeLaTeX\else -\ifLuaTeX\LuaLaTeX\else???\fi\fi\fi\ il \today +\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 i vostri file deve essere configurato per registrarli sul disco fisso con la codifica \texttt{UTF-8}. +Non dovete dimenticare che, se volete usare \prog{xelatex} o \prog{lualatex}, l'editor con cui scrivete i vostri file deve essere configurato per registrarli sul disco fisso con la codifica \texttt{UTF-8}. -Nell'esempio di frontespizio presentato sopra si è usato l'ambiente \amb{frontespizio*} che è una novità a partire dalla versione del pacchetto TOPtesi 5.85. I comandi \cs{frontespizio} e \cs{frontespizio*} funzionano ancora, ma suggerisco di usare gli ambienti. +Nell'esempio di frontespizio presentato sopra si è usato l'ambiente \amb{frontespizio*} che è disponibile a partire dalla versione del pacchetto TOPtesi 5.85. I comandi \cs{frontespizio} e \cs{frontespizio*} funzionano ancora, ma suggerisco di usare gli ambienti. -Vediamo le differenze: nella figura~\ref{fig:4frontespizi} si vedono sempre i loghi all'inizio della pagina, non ci sono filetti di nessun genere, il nome dell'università ci può essere o può mancare, le diverse tipologie di tesi hanno informazioni diverse. I loghi sono tutti in testa alla pagina ma potrebbero essere anche nella parte inferiore; la differenza dipende dall'usare l'ambiente \amb{frontespizio} che mette i loghi in testa, o l'ambiente \amb{frontespizio*} che mette i loghi nella parte inferiore della pagina; la figura~\ref{fig:frontespizi} nella pagina~\pageref{fig:frontespizi}, infatti, mostra i fontespizi di sinistra che sono stati composti con l'ambiente \amb{frontespizio} e quelli di destra composti con l'ambiente \amb{frontespizio*}. Il nome dell'ateneo appare o non appare a seconda che il comando \cs{ateneo} contenga un argomento vuoto o un argomento con un nome esplicito. Le altre informazioni dipendono da quali comandi si sono usati per caratterizzare la tesi triennale, magistrale o dottorale. Questi comandi verrano descritti dettagliatamente più avanti. +Vediamo le differenze: nella figura~\ref{fig:4frontespizi} si vedono sempre i loghi all'inizio della pagina, non ci sono filetti di nessun genere, il nome dell'università ci può essere o può mancare, le diverse tipologie di tesi hanno informazioni diverse. I loghi sono tutti in testa alla pagina ma potrebbero essere anche nella parte inferiore; la differenza dipende dall'usare l'ambiente \amb{frontespizio} che mette i loghi in testa, o l'ambiente \amb{frontespizio*} che mette i loghi nella parte inferiore della pagina; la figura~\ref{fig:frontespizi} nella pagina~\pageref{fig:frontespizi}, infatti, mostra i frontespizi di sinistra che sono stati composti con l'ambiente \amb{frontespizio} e quelli di destra composti con l'ambiente \amb{frontespizio*}. Il nome dell'ateneo appare o non appare a seconda che il comando \cs{ateneo} contenga un argomento vuoto o un argomento con un nome esplicito. Le altre informazioni dipendono da quali comandi si sono usati per caratterizzare la tesi triennale, magistrale o dottorale. Questi comandi verrano descritti dettagliatamente più avanti. \begin{figure}[p]\centering \includegraphics[height=0.875\textheight]{FrontespiziAssemblati1} @@ -746,22 +752,22 @@ Fatta questa modifica per tutti i loghi privi del nome dell'università che è n Vale la pena di ricordare che la retrocompatibilità con i comandi \cs{frontespizio} e \cs{frontespizio*} è conservata. -Perciò merita ricordare la molteplicità di configurazioni offerta dal modulo \pack{topfront} mediante una tabella comparativa~\ref{tab:modalitaperfrontespizi}. +Perciò merita ricordare la molteplicità di configurazioni offerta dal modulo \pack{topfront} mediante la tabella comparativa~\ref{tab:modalitaperfrontespizi}. -\begin{table}\centering +\begin{table}\caption{Varie modalità di composizione del frontespizio}\label{tab:modalitaperfrontespizi} +\centering \begin{tabularx}{\textwidth}{*3{>\raggedright X}}\toprule Comando o ambiente & Stile standard & Stile classica \tabularnewline \midrule \amb{frontespizio} & loghi in testa & loghi in basso \tabularnewline \cs{ateneo} vuoto & senza nome dell'ateneo & messaggio d'errore\tabularnewline -\cs{ateneo} non vuoto& Nome dell'ateneo in testa & nome dell'ateneo in testa - \tabularnewline +\cs{ateneo} non vuoto& Nome dell'ateneo in testa & nome dell'ateneo in testa +\tabularnewline filetti & assenti & presenti \tabularnewline \midrule \amb{frontespizio*} & loghi in basso & loghi in basso \tabularnewline \cs{ateneo} vuoto & senza nome dell'ateneo & messaggio d'errore\tabularnewline -\cs{ateneo} non vuoto& nome dell'ateneo in testa & nome dell'ateneo in testa - \tabularnewline +\cs{ateneo} non vuoto& nome dell'ateneo in testa & nome dell'ateneo in testa \tabularnewline filetti & assenti & presenti \tabularnewline \midrule \cs{frontespizio} & come \amb{frontespizio} &come \amb{frontespizio} @@ -770,7 +776,6 @@ filetti & assenti & presenti \tabularnewline \cs{frontespizio*} & come \amb{frontespizio*} & come \amb{frontespizio*} \tabularnewline \bottomrule \end{tabularx} -\caption{Varie modalità di composizione del frontespizio}\label{tab:modalitaperfrontespizi} \end{table} @@ -783,9 +788,9 @@ filetti & assenti & presenti \tabularnewline \subsection{I comandi accessori di topcoman} -L'altro file accessorio \pack{topcoman} contiene diversi utili comandi, alcuni già incorporati nella definizione della lingua italiana del sistema \TeX\ (solo se usate \pack{babel}). Tuttavia se dovete scrivere in una lingua diversa dall'italiano quei comandi non sono disponibili e qui viene utile avere quei comandi in un pacchetto distinto da \pack{babel} e non soggetto a test sulla lingua in uso. +L'altro file accessorio \pack{topcoman} contiene diversi utili comandi, alcuni già incorporati nella definizione della lingua italiana del sistema \TeX\ (solo se si usa \pack{babel}). Tuttavia se dovete scrivere in una lingua diversa dall'italiano quei comandi non sono disponibili e qui viene utile avere quei comandi in un pacchetto distinto da \pack{babel} e non soggetto a test sulla lingua in uso. Alcuni di questi comandi non definiti da \pack{poliglossia} quando si scrive in italiano, si rendono particolarmente utili quando si compone con \prog{xelatex} o \prog{lualatex}. -Il file contiene anche un comando per la stampa in modo verbatim il contenuto di un file esterno, per esempio il listato di un programma; ci sono altri pacchetti \LaTeX\ che consentono di stampare il listato di un programma in modo anche migliore, per esempio il pacchetto \pack{listings}, ma, visto che può servire per la tesi e, visto che una volta che lo si conosce +Il file contiene anche un comando per stampare in modo verbatim il contenuto di un file esterno, per esempio il listato di un programma; ci sono altri pacchetti \LaTeX\ che consentono di stampare il listato di un programma in modo anche migliore, per esempio il pacchetto \pack{listings}, ma, visto che può servire per la tesi e, visto che una volta che lo si conosce potrebbe piacere e poi si vorrebbe continuare ad usarlo, è meglio disporne come pacchetto separato. Non sarebbe difficile per esempio stamparsi in pulito il listato del proprio programma contenuto nel file @@ -801,17 +806,17 @@ esempio stamparsi in pulito il listato del proprio programma contenuto nel file \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 +righe fuoriescano dalla 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{La composizione del frontespizio} -Non è generalmente necessario inserire nel frontespizio il logo dell'ateneo; controllate presso la vostra la vostra segreteria competente le regole fissate per la composizione del frontespizio. Se il logo è richiesto, allora la segreteria vi dice anche quale logo usare e da dove scaricarne il file che ne contiene la descrizione grafica; \textcolor{red}{siate precisi nel richiedere le limitazioni legali d'uso del logo dell'ateneo, perché il logo è proprietà esclusiva dell'ateneo e l'uso indebito potrebbe essere fonte di problemi legali non indifferenti.} Siccome tali limitazioni esistono, il pacchetto TOPtesi non viene più distribuito con i file dei loghi di diversi atenei, come veniva fatto nelle prime edizioni. +Non è generalmente necessario inserire nel frontespizio il logo dell'ateneo; controllate presso la vostra segreteria competente le regole fissate per la composizione del frontespizio. Se il logo è richiesto, allora la segreteria vi dice anche quale logo usare e da dove scaricarne il file che ne contiene la descrizione grafica; \textcolor{red}{siate precisi nel richiedere le limitazioni legali d'uso del logo dell'ateneo, perché il logo è proprietà esclusiva dell'ateneo e l'uso indebito potrebbe essere fonte di problemi legali non indifferenti.} Siccome tali limitazioni esistono, il pacchetto TOPtesi non viene più distribuito con i file dei loghi di diversi atenei, come veniva fatto nelle prime edizioni. -Controllate se si tratta di un file vettoriale (estensione \file{.pdf} oppure \file{.eps}) oppure bitmapped (estensione \file{.jpg}, \file{.png}, \file{.bmp}, \file{.wmf}, \file{.tiff},\dots). Ricordate che \prog{pdflatex}, \prog{xelatex} e \prog{lualatex} possono incorporare solo i formati \file{.pdf}, \file{.eps}\footnote{Dall'edizione di TeX Live 2010 anche \prog{pdflatex} è in grado di incorporare file in formato \file{.eps}, mentre prima era necessario convertirli preventivamente in formato \file{.pdf}.}, \file{.jpg}, \file{.png} o \file{.mps}\footnote{I file in formato \file{.mps} sono ottenuti con il programma \MP; l'estensione normale delle figure create con questo programma di default hanno una estensione numerica; si può impostare il programma per assegnare l''estensione \file{.mps} oppure si può cambiare il nome e l'estensione.}. Se il file viene fornito in un formato diverso da questi cinque, è necessario convertirlo in uno dei formati accettati, preferibilmente nel formato \file{.png}. +Controllate se si tratta di un file vettoriale (estensione \file{.pdf} oppure \file{.eps}) oppure bitmapped (estensione \file{.jpg}, \file{.png}, \file{.bmp}, \file{.wmf}, \file{.tiff},\dots). Ricordate che \prog{pdflatex}, \prog{xelatex} e \prog{lualatex} possono incorporare solo i formati \file{.pdf}, \file{.eps}\footnote{Dall'edizione di \TeXLive 2010 anche \prog{pdflatex} è in grado di incorporare file in formato \file{.eps}, mentre prima era necessario convertirli preventivamente in formato \file{.pdf}.}, \file{.jpg}, \file{.png} o \file{.mps}\footnote{I file vettoriali in formato \file{.mps} sono ottenuti con il programma \MP; l'estensione normale delle figure create con questo programma di default hanno una estensione numerica; si può impostare il programma per assegnare l''estensione \file{.mps} oppure si può cambiare il nome e l'estensione.}. Se il file bitmapped viene fornito in un formato diverso da questi cinque, è necessario convertirlo in uno dei formati accettati. -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. +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, ma il formato \file{.png} potrebbe contenere delle ``trasparenze'' che non sono accettabili con le prescrizioni PDF/A dei documenti archiviabili e in questo caso bisogna ricorrere al formato \file{.jpg}. Potendo disporne, sarebbe sempre meglio usare un disegno veramente vettoriale del logo. 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 condotta 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 rilasciato da consorzi di almeno quattro atenei di nazioni europee diverse. In queste circostanze è spesso necessario inserire nel frontespizio i loghi di tutti gli atenei partecipanti alla convenzione. @@ -825,7 +830,7 @@ oppure \medskip \cs{logosede}\oarg{altezza}\marg{lista di nomi di file di loghi separati da virgole} \end{flushleft} -dove il valore prefissato per l'\meta{altezza} del logo è 2,5\,cm per la carta A4, ed è scalato proporzionalmente per carte di formato diverso; con l'argomento facoltativo si può specificare un'altezza leggermente maggiore o minore del valore predefinito. L'argomento \meta{file del logo} o \meta{lista di nomi di file di loghi separati da virgole} è costituito da un solo nome di file o da una lista di nomi di file separati da virgole, corrispondenti ciascuno al logo di un diverso ateneo. Questi file devono avere i formati corrispondenti a una delle cinque estensioni consentite, ma non è necessario specificare il nome del file completo di estensione; questa specificazione potrebbe essere necessaria solo nel caso in cui si disponga del logo di uno stesso ateneo in diversi formati (o, cosa da non fare mai, immagini o loghi diversi con il nome del loro file uguale e l'estensione diversa; questo genere di pasticci è fonte di numerosi errori, facilmente evitabili se si mantiene in ordine la scelta dei nomi e delle estensioni). +dove il valore prefissato per l'\meta{altezza} del logo è 25\,mm per la carta A4, ed è scalato proporzionalmente per carte di formato diverso; con l'argomento facoltativo si può specificare un'altezza leggermente maggiore o minore del valore predefinito. L'argomento \meta{file del logo} o \meta{lista di nomi di file di loghi separati da virgole} è costituito da un solo nome di file o da una lista di nomi di file separati da virgole, corrispondenti ciascuno al logo di un diverso ateneo. Questi file devono avere i formati corrispondenti a una delle cinque estensioni consentite, ma non è necessario specificare il nome del file completo di estensione; questa specificazione potrebbe essere necessaria solo nel caso in cui si disponga del logo di uno stesso ateneo in diversi formati grafici (o, cosa da non fare mai, immagini o loghi diversi con il nome del loro file uguale e l'estensione diversa; questo genere di pasticci è fonte di numerosi errori, facilmente evitabili se si mantiene in ordine la scelta dei nomi e delle estensioni). Il programma codificato nel pacchetto \pack{toptesi} provvede a scalare tutti i loghi all'\meta{altezza} specificata e li compone affiancati su una sola riga distanziati mediante uno spazio predefinito di 3\,em; lo si può impostare ad un valore leggermente maggiore o minore tramite il comando \cs{setlogodistance}, per esempio: \begin{verbatim} @@ -845,7 +850,7 @@ Se la riga di loghi, eventualmente scalati in altezza e distanziati dello spazio \printloghi} Si noti che il logo in testa alla pagina del frontespizio di questo documento è una esplicita richiesta espressa dal Politecnico di Torino; molte altre sedi come la quasi totalità delle case editrici che mettono il loro logo nel frontespizio, lo mettono nella metà inferiore della pagina; ma la tesi di laurea o di dottorato è una documento particolare, il cui frontespizio deve soddisfare ad alcune esigenze burocratiche, e non può, quindi, soddisfare a criteri estetici molto stringenti. Per questo motivo, lo si vedrà meglio avanti, il modulo \pack{topfront} consente una variante del comando per creare i frontespizi: essa intesta la pagina col nome dell'ateneo e mette i loghi nella metà inferiore della pagina. Se, come per il Politecnico di Torino, il nome fa parte del logo\footnote{Il logo di questo Politecnico è fatto di due parti: quella tonda di sinistra prende il nome di ``marchio'', mentre quella letterale a destra prende il nome di ``logotipo''; l'Ufficio Comunicazione e Immagine che si occupa di questi aspetti formali ha emesso una normativa specifica sui colori e le forme sia del marchio sia dei font usati per il logotipo.} non è il caso di ripetere il nome dell'ateneo nella parte alta della pagina perché vi appare già nel logotipo. -Comunque, volendo, si può inserire in testa alla pagina sia il logo, sia il nome generico dell'ateneo sia il nome proprio dell'ateneo.; come fare lo sì è già descritto in precedenza e lo si è riassunto nella tabella~\ref{tab:modalitaperfrontespizi} nella pagina~\pageref{tab:modalitaperfrontespizi}. +Comunque, volendo, si può inserire in testa alla pagina sia il logo, sia il nome generico dell'ateneo sia il nome proprio dell'ateneo; come fare lo sì è già descritto in precedenza e lo si è riassunto nella tabella~\ref{tab:modalitaperfrontespizi} nella pagina~\pageref{tab:modalitaperfrontespizi}. \section{Comporre il frontespizio senza ricorrere a TOPfront}\label{sec:solofrontespizio} Potrebbe essere necessario comporre il frontespizio in modo diverso da come viene composto tramite i comandi contenuti nel pacchetto \pack{topfront}, sia pure ricorrendo alle due varianti dell'ambiente \amb{frontespizio} e \amb{frontespizio*}. @@ -855,7 +860,7 @@ Esistono alcune strade: una è quella di usare l'ambiente \amb{titlepage} e scri Ci sono diversi motivi per i quali un laureando o dottorando vorrebbe comporre un frontespizio diverso da quello predefinito da TOPtesi con il suo modulo \pack{topfront}. \begin{enumerate}[noitemsep] \item Le specifiche per le tesi di una data università sono inconciliabili con quelle preimpostate da TOPtesi. -\item Le informazioni da inserire nel frontespizio sono diverse da quelle preimpostate da TOPtesi. +\item Le informazioni da inserire nel frontespizio sono diverse da quelle pre"impostate da TOPtesi. \item Il laureando non deve soddisfare a specifiche particolari ma vuole comporre un frontespizio personalizzato a suo piacimento. \end{enumerate} @@ -872,7 +877,7 @@ Per seguire questa strada, qui posso dare solo delle indicazioni generiche. \begin{flushleft} \cs{thispagestyle}\marg{stile} \end{flushleft} -dove \meta{stile} è stato precedentemente definito usando il pacchetto \pack{geometry} o altri pacchetti. Sarebbe opportuno ridefinire i due margini interno ed esterno in modo che siano uguali. Qualcuno desidera apportare un piccolo spostamento verso l'esterno di non più di 5\,mm per compensare la curvatura della prima pagina; questa curvatura dipenderebbe dal modo di confezionare/legare la tesi; di solito con una buona brossura ben eseguita o una legatura a filo, non è necessario apportare questa correzione, con una tesi spillata con punti metallici, probabilmente una piccola correzione non guasta; però questa correzione va bene per le pagine interne ma, siccome il frontespizio è la prima pagina della tesi, la curvatura della pagina è irrilevante e questo piccolo spostamento è del tutto superfluo. +dove \meta{stile} è stato precedentemente definito usando il pacchetto \pack{geometry} o altri pacchetti. Sarebbe opportuno ridefinire i due margini interno ed esterno in modo che siano uguali. Qualcuno desidera apportare un piccolo spostamento verso l'esterno di non più di 5\,mm per compensare la curvatura della prima pagina; questa curvatura dipenderebbe dal modo di confezionare/legare la tesi; di solito con una buona brossura ben eseguita o una legatura a filo, non è necessario apportare questa correzione, con una tesi spillata con punti metallici, probabilmente una piccola correzione non guasta; questa correzione è concepita per le pagine interne ma, siccome il frontespizio è la prima pagina della tesi, la curvatura della pagina è irrilevante e questo piccolo spostamento è del tutto superfluo. \item Non è necessario che i margini laterali siano complessivamente equivalenti ai margini del corpo della tesi, ma non guasta se lo sono. @@ -973,11 +978,11 @@ Esistono altri pacchetti, oltre a \pack{frontespizio}, per comporre pagine di ti Fra le opzioni della classe \class{toptesi} si deve inserire l'opzione \opt{noTOPfront} per evitare conflitti fra i comandi del modulo \pack{topfront} e quelli del pacchetto \pack{frontespizio}. \textcolor{red}{Dimenticarsi di specificare questa opzione vuol dire andare incontro a messaggi d'errore causati dai conflitti fra i due pacchetti}. -Questo pacchetto \pack{frontespizio} si avvale di un file ausiliario \file{.tex} per comporre il frontespizio vero e proprio; questo implica che per disporne come frontespizio del documento finito, bisogna comporre anche questo file ausiliario. +Questo pacchetto \pack{frontespizio} si avvale di un file ausiliario \file{-frn.tex} per comporre il frontespizio vero e proprio; questo implica che per disporne come frontespizio del documento finito, bisogna comporre anche questo file ausiliario. Precisamente tutte le informazioni riguardanti il frontespizio devono essere messe dentro un ambiente \amb{frontespizio} collocato dopo l'istruzione \cs{begin}\Arg{document}. Qui si metteranno i comandi per definire il nome del o dei candidati, il nome del o dei relatori e degli eventuali correlatori, il nome dell'università, il nome del corso di laurea, il nome del tipo di tesi, il titolo e il sottotitolo della tesi, eccetera. -Eseguendo \prog{pdflatex} o \prog{xelatex} viene scritto il file ausiliario; se la tesi ha il main file che si chiama \texttt{MarioRossiTesiMagistrale.tex}, dopo averlo compilato, nella cartella di lavoro ci sarà anche il file ausiliario \texttt{MarioRossiTesiMagistrale-frn.tex}; bisognerà dunque compilare questo file ausiliario, e poi ricompilare il documento che \emph{riscriverà il file ausiliario} con i nuovi eventuali dati modificati, ma intanto ingloberà il file PDF appena prodotto. La sequenza delle compilazioni sarà dunque: +Eseguendo \prog{pdflatex} oppure \prog{xelatex} o \prog{lualatex} viene scritto il file ausiliario; se la tesi ha il main file che si chiama \texttt{MarioRossiTesiMagistrale.tex}, dopo averlo compilato, nella cartella di lavoro ci sarà anche il file ausiliario \texttt{MarioRossiTesiMagistrale-frn.tex}; bisognerà dunque compilare questo file ausiliario, e poi ricompilare il documento che \emph{riscriverà il file ausiliario} con i nuovi eventuali dati modificati, ma intanto ingloberà il file PDF appena prodotto. La sequenza delle compilazioni sarà dunque: \begin{verbatim} pdflatex MarioRossiTesiMagistrale pdflatex MarioRossiTesiMagistrale-frn @@ -1056,7 +1061,8 @@ Compilando questo documento si ottiene un'unica pagina contenente il frontespizi \section{Come si comincia}\label{sec:cominciare} Non vi dico niente di come si scriva una tesi; so per esperienza che all'inizio ci si sente sperduti davanti allo -schermo vuoto. Ma voi laureandi potete scaricare dal portale della didattica del sito +schermo vuoto. +Ma i laureandi possono scaricare dal portale della didattica del sito del Politecnico \url{http://didattica.polito.it} l'opuscoletto \emph{Saper Comunicare --- Cenni di scrittura tecnico-scientifica} dove c'è scritto più o meno tutto quel che bisogna sapere per @@ -1064,7 +1070,7 @@ 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}[noitemsep] +\begin{enumerate} \item Si compone un unico file come esemplificato con i file \file{toptesi-example.tex}, \file{toptesi-example-xetex.tex} e \texttt{toptesi-example-con-frontespizio.tex}\index{file!toptesi-example-con-frontespizio.tex@\texttt{toptesi\discretionary{-}{}{-}example\discretionary{-}{}{-}con\discretionary{-}{}{-}frontespizio.tex}} allegati alla documentazione di TOPtesi. Questi file permettono di sperimentare diverse cose semplicemente mettendo o togliendo dei segni di commento all'inizio delle righe del preambolo che contengono alcuni comandi particolari. Essi sono completi di bibliografia e quell'unico file permette di comporre una tesi completa; ovviamente può essere usato come modello per una tesi; basta cambiare il contenuto dei comandi che contengono i nomi dei candidati, dei relatori, del titolo, dell'ateneo, della eventuale facoltà, eccetera. Ovviamente bisogna cambiare anche il contenuto dei capitoli e della bibliografia. \item Si spezza il file sorgente in un numero adeguato di file parziali da gestire come specificato qui di seguito; ogni file parziale conterrà solo una parte della tesi, per esempio un solo capitolo; siccome il tutto è gestito dal master file, ciascun file parziale non dovrà più contenere la dichiarazione della classe né il preambolo né le righe \cs{begin}\Arg{document} e \cs{end}\Arg{document}, ma solo il materiale relativo ad uno specifico capitolo cominciando appunto con la riga che ne specifica il titolo: @@ -1115,8 +1121,9 @@ 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 raccomando di seguire questa -procedura al fine di risparmiare tempo di compilazione; faccio invece +compilazione è rapidissima, quindi lo scopo di risparmiare tempo +di compilazione non è il motivo per il quale raccomando di seguire +questa procedura; faccio invece notare che tenere separate le varie parti della tesi permette di lavorare con più ordine e di risparmiare non poco tempo per la gestione dei vari file sorgente e per le loro @@ -1174,19 +1181,18 @@ 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 ha +il programma di tipocomposizione elabori correttamente i file sorgente, o si usa \prog{xelatex} o \prog{lualatex} 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 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 +per esempio le lettere accentate; a meno che non usiate \prog{xelatex} o \prog{lualatex}, vi suggerisco di specificare esplicitamente la codifica +mediante il comando \begin{verbatim} \usepackage[utf8]{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 \opt{utf8} che permette di inserire qualunque segno fra le decine o centinaia di migliaia che la codifica UNICODE consente -- se usate \prog{xelatex} questa codifica è necessaria ma non bisogna esplicitarla nel file sorgente. Il problema, in effetti, non è la codifica, ma è la tastiera. Con sistemi operativi diversi si sono sviluppati programmi di vario genere per scrivere in alfabeti diversi da quello latino esteso, qual è quello invocato, per esempio, con l'opzione \opt{latin1} oppure anche \opt{utf8}. Ma se dovete scrivere la vostra tesi con brani in greco o in russo o in arabo o in lingue con segni sillabici o ideogrammi, questo problema si presenterebbe qualunque sia l'editor e il programma di composizione che usate, ed è un problema che dovete risolvere da soli. +Gli editor \TeX{}Shop, \TeX{}works, TeXstudio, Texmaker, e qualcun altro, consentono di usare la codifica \opt{utf8} che permette di inserire qualunque segno fra le decine o centinaia di migliaia che la codifica UNICODE consente -- se usate \prog{xelatex} o \prog{lualatex} questa codifica è necessaria ma non bisogna esplicitarla nel file sorgente. Il problema, in effetti, non è la codifica, ma è la tastiera. Con sistemi operativi diversi si sono sviluppati programmi di vario genere per scrivere in alfabeti diversi da quello latino esteso, qual è quello invocato, per esempio, con l'opzione \opt{latin1} oppure \opt{utf8}. Ma se dovete scrivere la vostra tesi con brani in greco o in russo o in arabo o in lingue con segni sillabici o ideogrammi, questo problema si presenterebbe qualunque sia l'editor e il programma di composizione che usate, ed è un problema che dovete risolvere da soli. -Bisogna notare che vanno accentate anche le lettere maiuscole; siccome la tastiera italiana non le prevede, consiglio di inserire nel preambolo la definizione del comando \cs{E} per scrivere È. Credo che questa sia la maiuscola accentata più frequente in italiano e le altre non capitano mai all'inizio di un periodo; possono capitare nei titoli e allora bisognaa arrangiarsi con codici numerici o con tabelle di caratteri. Il comando: +Bisogna notare che in italiano vanno accentate anche le lettere maiuscole; siccome la tastiera italiana non le prevede, consiglio di inserire nel preambolo la definizione del comando \cs{E} per scrivere È. Credo che questa sia la maiuscola accentata più frequente in italiano e le altre non capitano mai all'inizio di un periodo; possono capitare nei titoli e allora bisogna arrangiarsi con codici numerici o con tabelle di caratteri. Il comando: \begin{verbatim} \usepackage{xspace} \newcommand*\E{\`E\xspace} @@ -1205,38 +1211,40 @@ Se il vostro editor vi consente di selezionare le maiuscole accentate da una tab Se volete o dovete usare \prog{pdflatex}, dovete caricare nel vostro preambolo tutto quello che è necessario per gestire quelle lingue scritte con alfabeti diversi, ma non chiedetemi come si fa, perché so dirvelo solo per il greco. Per questa lingua, se usate l'ortografia monotonica, basta inserire l'opzione della lingua \opt{greek} fra le opzioni \emph{della classe}; se usate l'ortografia politonica\footnote{Il greco moderno può essere politonico o monotonico; quello antico è sempre e solo politonico; però le regole di sillabazione sono diverse; con \pack{polyglossia} non ci sono problemi; con \pack{babel} a tutt'oggi (ottobre 2015) esiste l'attributo \opt{ancient} per selezionare la sillabazione antica oltre alla grafia politonica, ma non è ancora possibile disporre effettivamente della sillabazione antica completa.}, allora dovete richiedere per \pack{babel} lo specifico attributo seguendo questo procedimento (per \pack{polyglossia} si veda più avanti): \begin{verbatim} -\documentclass[...,greek,...]{toptesi} +\documentclass[...,greek.ancient,...]{toptesi} ... -\languageattribute{greek}{ancient} \begin{document} ... \end{document} \end{verbatim} oppure \begin{verbatim} -\documentclass[...,greek.ancient,...]{toptesi} +\documentclass[...,greek,...]{toptesi} ... +\languageattribute{greek}{ancient} \begin{document} ... \end{document} \end{verbatim} Al posto di \opt{ancient} si può specificare \opt{polutoniko}; \opt{polutoniko} si riferisce al greco moderno scritto con tutta la varietà di accenti e diviso in sillabe con i criteri adatti alla lingua moderna; \opt{ancient} si riferisce al greco classico, che oltre ad usare la solita varietà di accenti, usa altre regole per la sillabazione di questa varietà di lingua. - -Per una tesi che tratti il greco antico in forma filologica, consiglio l'uso del pacchetto \pack{teubner}; visto che l'ho scritto io, un po' di réclame non guasta~\dots\ Bisogna però leggerne la documentazione con attenzione. In particolare conviene ricordare che \pack{teubner} non viene caricato se non è stato precedentemente specificata la lingua greca fra le opzioni, ma poi provvede da solo ad impostare l'attributo \opt{ancient} e tutte le altre caratteristiche necessarie per comporre in greco con il \emph{mark-up} filologico. A tutt'oggi (2015) il pacchetto \pack{teubner} non è stato adeguatamente controllato sotto \XeLaTeX. Probabilmente non è completamente compatibile, ma non sono ancora in grado di dire niente né in positivo né in negativo. +Per una tesi che tratti il greco antico in forma filologica, consiglio l'uso del pacchetto \pack{teubner}; visto che l'ho scritto io, un po' di réclame non guasta~\dots\ Bisogna però leggerne la documentazione con attenzione. In particolare conviene ricordare che \pack{teubner} non viene caricato se non è stato precedentemente specificata la lingua greca fra le opzioni, ma poi provvede da solo ad impostare l'attributo \opt{ancient} e tutte le altre caratteristiche necessarie per comporre in greco con il \emph{mark-up} filologico. A tutt'oggi (2016) 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!!!! Immagino che per usare le lingue che si scrivono in cirillico, basti 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 riportano il segno che si ottiene premendo quel tasto quando è attivo il driver corrispondente a quella specifica tastiera. Non è ovviamente possibile cambiare il disegno che appare sui tasti, semplicemente cliccando per cambiare driver; forse lo si può fare con le tastiere virtuali dei PC \emph{touch screen}, ma con i PC normali questo non è possibile. Ecco quindi che la difficoltà di scrivere con un alfabeto diverso richiede una memoria ferrea per ricordare a quale segno dell'altro alfabeto corrisponda il tasto della nostra tastiera. Per il greco moderno e classico, se si usano i font di default con la codifica LGR (Local GReek), che vengono installati praticamente con ogni installazione del sistema \TeX\ aggiornata e, soprattutto, completa, le corrispondenze con la tastiera latina sono studiate in modo da semplificare molto questo processo di ``memorizzazione''. Tuttavia ad una persona abituata a leggere il greco scritto (giustamente) in greco, vederlo scritto con caratteri latini fa un certo effetto; la documentazione di \textsf{babel} e quella di \textsf{teubner} ricordano questa corrispondenza fra i tasti latini e i segni greci (lettere, accenti, spiriti, segni speciali, ecc.). La corrispondenza fra greco e latino è abbastanza semplice perché il greco ha 24 maiuscole e 25 minuscole, mentre il latino ne ha 26 di ciascun tipo. Non so che cosa succeda con il cirillico che ha un alfabeto composto di più di 30 segni, per cui la corrispondenza con l'alfabeto latino è impossibile. +Suggerisco di riferirsi al documento \emph{L'Arte di scrivere in diverse lingue con (Xe)LaTeX}, liberamente scaricabile dalla sezione Documentazione del sito \url{www.guitex.org}. Questa guida tratta molti argomenti utili per comporre in lingue straniere comprese alcune di quelle che si scrivono con insiemi di caratteri diversi da quelli latini; descrive anche molte caratteristiche delle tradizioni tipografiche in uso in nazioni diverse dall'Italia oltre, ovviamente, la descrizione delle tradizioni italiane. + +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 è riportato 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. -Con le macchine Macintosh il sistema operativo Mac OS X mette a disposizione una specie di tastiera virtuale sui tasti della quale si può cliccare con il mouse; si possono installare diverse tastiere che possono venire intercambiate con un semplice click sulla icona disegnata nella barra superiore; per cui scrivere in greco politonico o in russo o in ebraico, o in\dots, non è un problema. Temo che lo sia con altre macchine e altri sistemi operativi. +Per il greco moderno e classico, se si usano i font di default con la codifica LGR (Local GReek), che vengono installati praticamente con ogni installazione del sistema \TeX\ aggiornata e, soprattutto, completa, le corrispondenze con la tastiera latina sono studiate in modo da semplificare molto questo processo di ``memorizzazione''. Tuttavia ad una persona abituata a leggere il greco scritto (giustamente) in greco, vederlo scritto con caratteri latini fa un certo effetto; la documentazione di \textsf{babel} e quella di \textsf{teubner} ricordano questa corrispondenza fra i tasti latini e i segni greci (lettere, accenti, spiriti, segni speciali, ecc.). La corrispondenza fra greco e latino è abbastanza semplice perché il greco ha 24 maiuscole e 25 minuscole, mentre il latino ne ha 26 di ciascun tipo. Non so che cosa succeda con il cirillico che ha un alfabeto composto di più di 30 segni, per cui la corrispondenza diretta con l'alfabeto latino è impossibile. -Mi dicono che sulle macchine Linux l'editor \prog{Vim} e, su tutte le macchine, l'editor \prog{emacs} prevedano delle combinazioni di tasti che consentono di scrivere direttamente in greco sullo schermo, nella finestra del file \texttt{.tex}. Confermo di avere letto qualcosa in merito, ma non sono in grado di confermare per esperienza diretta. +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 scambiate con un semplice click sulla icona disegnata nella barra superiore; per cui scrivere in greco politonico o in russo o in ebraico, o in\dots, non è un problema. Temo che lo sia con altre macchine e altri sistemi operativi. -\ifdim\dimexpr\pagegoal-\pagetotal < 4\baselineskip \newpage\fi +Mi dicono che sulle macchine Linux l'editor \prog{Vim} e, su tutte le macchine, l'editor \prog{emacs} prevedano delle combinazioni di tasti che consentono di scrivere direttamente in greco sullo schermo, nella finestra del file \texttt{.tex}. Ho letto qualcosa in merito, ma non sono in grado di confermare per esperienza diretta. +\goodpagebreak \subsection{La scelta della codifica per il file di uscita} @@ -1258,15 +1266,14 @@ I file della collezione Computer Modern con codifica \opt{T1}, conosciuti anche \end{document} \end{verbatim} -Se il file viene gestito con \prog{xelatex}, oltre alla codifica \opt{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 \class{toptesi}. Usando \prog{xelatex}, gli appositi comandi per la selezione dei font sia testuali sia per la matematica può essere eseguita nel preambolo senza bisogno di ricaricare il pacchetto \pack{fontenc}. Volendo, invece di usare i font Latin Modern, si possono impostare facilmente altre famiglie di font con comodi comandi che fanno riferimento ai font OpenType installati sulla propria macchina. +Se il file viene gestito con \prog{xelatex} o \prog{lualatex}, oltre alla codifica \opt{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 \class{toptesi}. Usando \prog{xelatex} o \prog{lualatex}, 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 i pacchetti \pack{newtxtext} e \pack{newtxmath}, e la collezione dei font Palatino eXtended, richiamabili con i pacchetti \pack{newpxtext} e \pack{newpxmath}. 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. I nuovi pacchetti \pack{newtx...} e \pack{newpx...} sono configurabili con diverse opzioni; li consiglio a coloro che vogliono usare i font Times o Palatino, 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 le proprietà dei font Latin Modern da usare, per esempio permettendo l'uso delle cifre minuscole \ifPDFTeX\oldstylenums{1234567890}\else{\addfontfeature{Numbers=OldStyle}{1234567890}}\fi\ nel testo, e le cifre maiuscole 1234567890 nella composizione della matematica. +Qui, per la composizione della tesi con \prog{pdflatex} segnalo solo la collezione dei font Times eXtended, richiamabili con i pacchetti \pack{newtxtext} e \pack{newtxmath}, e la collezione dei font Palatino eXtended, richiamabili con i pacchetti \pack{newpxtext} e \pack{newpxmath}. 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. I nuovi pacchetti \pack{newtx...} e \pack{newpx...} sono configurabili con diverse opzioni; li consiglio a coloro che vogliono usare i font Times o Palatino, 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 le proprietà dei font Latin Modern da usare, per esempio permettendo l'uso delle cifre minuscole \ifPDFTeX\oldstylenums{1234567890}\else {\addfontfeature{Numbers=OldStyle}{1234567890}}\fi\ 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 \opt{T1}; 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 comporre ancora meglio le righe del testo; con \prog{xelatex}, invece, le funzionalità di questo pacchetto sono solo parzialmente usabili; comunque si può usare \pack{microtype} anche compilando con \prog{xelatex} sebbene i miglioramenti siano meno ``vistosi'' che con \prog{pdflatex}. +Tanto per confronto, questo testo di documentazione su \textsf{TOPtesi} è composto con il motore di composizione \prog{lualatex} 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 \opt{T1}; 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 comporre ancora meglio le righe del testo; con \prog{xelatex}, invece, le funzionalità di questo pacchetto sono solo parzialmente usabili; comunque si può usare \pack{microtype} anche compilando con \prog{xelatex} sebbene i miglioramenti siano meno ``vistosi'' che con \prog{pdflatex}; con \prog{lualatex} il pacchetto \pack{microtype} produce gli stessi benefici che si ottengono con \prog{pdflatex}, senza i piccoli inconvenienti che si manifiestano con \prog{xelatex}. -\ifdim\dimexpr\pagegoal-\pagetotal < 4\baselineskip \newpage\fi \section{Come stampare la tesi} @@ -1311,8 +1318,7 @@ 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 +registrata su un CD-ROM in formato \texttt{.pdf} 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. @@ -1322,16 +1328,14 @@ specialmente se compongono tesi piuttosto voluminose e/o se le rilegano con una costola piuttosto rigida. In questo caso la classe \class{toptesi} accetta l'opzione \opt{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. - -\unless\ifdim\dimexpr\pagegoal-\pagetotal > 4\baselineskip \newpage\fi +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. +\goodpagebreak \section{Comporre la tesi in diverse lingue}\label{sec:lingue} Il pacchetto \textsf{TOPtesi} usa di default il pacchetto \pack{babel} o il pacchetto \pack{polyglossia} per gestire la composizione in diverse lingue. @@ -1339,11 +1343,10 @@ 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}[noitemsep] +\begin{enumerate} \item Bisogna configurare il sistema \TeX\ per gestire diverse lingue; \item Bisogna 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} 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} @@ -1352,22 +1355,22 @@ lingue ci si vuole servire \textcolor{red}{oltre all'italiano e all'inglese che 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 -\file{sample.tex}, poi apritene il file \texttt{.log}, +\file{sample.tex} (facente parte della distribuzione del sistema \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{pdflatex} questo file di documentazione, il file -\texttt{toptesi\discretionary{}{-}{-}it\discretionary{}{-}{-}pdftex.log} nel 2012 conteneva nelle prime righe quanto segue: +\texttt{toptesi\discretionary{}{-}{-}it\discretionary{}{-}{-}xetex.log} nel 2012 conteneva nelle prime righe quanto segue: \begin{verbatim} This is pdfTeX, Version 3.1415926-2.4-0.9998 (TeX Live 2012) - (format=pdflatex 2012.7.10) 9 SEP 2012 16:04 + (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-it-pdftex.tex -(./toptesi-it-pdftex.tex +**toptesi-it-xetex.tex +(./toptesi-it-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, @@ -1383,30 +1386,28 @@ romanian, romansh, russian, sanskrit, serbian, serbianc, slovak, slovenian, spanish, swedish, turkish, turkmen, ukrainian, uppersorbian, welsh, loaded. \end{verbatim} -%) per pareggiare il matching delle parentesi -Dal 2014, purtroppo l'elenco delle lingue è sostituito dalla seguente breve frase: +Dal 2014, purtroppo l'elenco delle lingue è sostituito dalla seguente laconica frase: \begin{verbatim} Babel <3.9k> and hyphenation patterns for 81 languages loaded. \end{verbatim} -Ma non c'è bisogno di preoccuparsi; nella mia macchina sono installate alcune lingue in più di quelle di default, ma se il numero è così alto, vuol dire che sono installate tutte le lingue che \prog{xelatex} è capace di gestire; fra queste c'è l'italiano, tre versioni di greco, due versioni di latino, eccetera. L'elenco completo può venire letto nel file \file{pdflatex.log} (o, componendo con \prog{xelatex}, nel file \file{xelatex.log}) che si trovano in uno degli alberi del sistema \TeX. La lettura è un po' criptica, anche perché il file è piuttosto lungo, ma basta cercare la stringa \texttt{l@english}, e di lì in avanti è registrato tutto quello che serve conoscere per l'elenco delle lingue installate. +Non c'è bisogno di preoccuparsi; nella mia macchina sono installate alcune lingue in più di quelle di default, ma se il numero è così alto, vuol dire che sono installate tutte le lingue che i programmi di composizione del sistema \TeX\ sono capaci di gestire; fra queste c'è l'italiano, tre versioni di greco, tre versioni di latino, eccetera. L'elenco completo può venire letto nel file \file{xelatex.log} (o, componendo con \prog{pdflatex}, nel file \file{pdflatex.log}) che si trovano in uno degli alberi del sistema \TeX. La lettura è un po' criptica, anche perché il file è piuttosto lungo, ma basta cercare la stringa \texttt{l@english}, e di lì in avanti è registrato tutto quello che serve conoscere per l'elenco delle lingue installate. \LuaLaTeX, diversamente da \pdfLaTeX\ e da \XeLaTeX, carica le impostazioni, sillabazione compresa, per le lingue del documento solo al momento di compilare quel dato documento; per questo compilatore solo l'inglese è precaricato, ma al momento opportuno esso si carica tutto ciò che è necessario per comporre in ciascuna dell'ottantina di lingue che riesce a gestire, o meglio in ciascuna delle lingua specificate per la composizione di ogni particolare documento, massimo un'ottantina (bastano?\dots). -Quel listato o quella riga è 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 un'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 (oppure sono elencate solo una mezza dozzina di lingue, oppure si dice che le lingue installate sono in un numero molto inferiore a 80), 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). +Quel listato o quella riga è quanto appare sempre quando si usa la distribuzione \TeXLive completa o quando si usa la distribuzione \MiKTeX~2.9 (o successiva) completa; serve per dare un'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 (oppure sono elencate solo una mezza dozzina di lingue, oppure si dice che le lingue installate sono in un numero molto inferiore a 80), 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 \TeXLive/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 +distribuzione a distribuzione del sistema \TeX. Bisogna quindi leggere la documentazione che accompagna la vostra distribuzione; qui darò alcuni cenni relativi alle distribuzioni che io conosco. -\subsubsection{MiK\TeX} +\subsubsection{\MiKTeX} 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, ma ve lo sconsiglio, e potete aggiungere il segno di spunta cliccando nel quadratino corrispondente alle lingue desiderate, ma vi consiglio di spuntarle tutte. -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, \file{sample.tex} che le prime righe del file \texttt{.log} contengano tutte le lingue che volete usare. +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 (\LuaLaTeX, però ci riesce). 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, \file{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 \url{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{\TeXLive} +La distribuzione \TeXLive completa distribuita sul circuito \url{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} @@ -1456,7 +1457,7 @@ 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: +Con i programmi \prog{xelatex} e \prog{lualatex} 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} @@ -1474,9 +1475,9 @@ Ciò fatto si dispone per ogni lingua, tranne quella principale, di un ambiente καὶ τὰν ἀοὶκητον. \end{greek} \end{verbatim} -Anche usando \prog{xelatex} bisogna definire i comandi \cs{sommario} e \cs{ringraziamenti} nella stessa maniera illustrata qui di seguito per comporre con il programma \prog{pdflatex}. +Anche usando \prog{xelatex} o \prog{lualatex} bisogna definire i comandi \cs{sommario} e \cs{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ì: +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! @@ -1493,7 +1494,7 @@ Ovviamente le parole ``Resumen'' (Sommario) e ``Agradecimientos'' (Ringraziament È 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 \cs{italiano}, \cs{english} e \cs{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 \class{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: +Se si usa \prog{xelatex} o \prog{lualatex} ci si ricordi che il pacchetto \pack{polyglossia} è già caricato dalla classe \class{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} @@ -1504,27 +1505,58 @@ e per le lingue che richiedono un trattamento particolare si usa un comando simi Per scrivere in lingue che implicano alfabeti diversi da quello latino, ovviamente, bisogna aver curato di disporre di una configurazione del sistema \TeX\ completa anche dei font che servono. Non dovrebbero esserci problemi con il cirillico e con il greco; per altri alfabeti e per le lingue che si scrivono da destra a sinistra bisogna ovviamente disporre dei pacchetti necessari. Si tenga presente che le versioni moderne del sistema \TeX\ \emph{non} usano come interprete il programma originario di Knuth, ma la sua estensione che in origine si chiamava $\epsilon$-\TeX; la variante che produce il file del documento composto in formato \texttt{.pdf} si chiama \prog{pdftex}, ma questa versione comprende tutte le estensioni di $\epsilon$-\TeX. Bene, queste estensioni servono anche per gestire le lingue con scrittura retrograda pur di disporre dei pacchetti relativi a queste lingue. -Anche \prog{xelatex} è in grado di gestire le lingue retrograde ed è capace con modesti adattamenti di alcuni comandi di comporre in verticale (cinese, giapponese,\dots). +Anche \prog{xelatex} e \prog{lualatex} sono in grado di gestire le lingue retrograde e sono capaci con modesti adattamenti di alcuni comandi di comporre in verticale (cinese, giapponese,\dots). \section{Il formato PDF/A}\label{sec:PDFA} -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, 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 si è predisposto il preambolo del file sorgente per la tesi in modo da poterlo compilare con \prog{pdflatex}, si può ugualmente compilare il documento anche con \prog{xelatex}, perché TOPtesi è perfettamente conscio del motore di composizione che si sta usando e sa che il file sorgente parte dal presupposto che si volevano creare gli hyperlink. In altre parole, non c'è bisogno di modificare sostanzialmente il file sorgente per passare da \prog{pdflatex} a \prog{xelatex}, se non eventualmente usando solo il ramo \emph{vero} oppure \emph{falso} del test indicato qui sotto. Però il file prodotto con \prog{xelatex} necessita di ulteriore elaborazione per soddisfare le specifiche richieste dalla norma ISO relativa al formato archiviabile. + +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 questa operazione a cui ho collaborato parzialmente prima di andare in pensione. + +Il problema dell'archiviazione elettronica è che il materiale archiviato deve essere reperibile, leggibile e stampabile per un tempo indefinito, anche secoli! 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, non necessariamente quelli che esistono oggi. + +L'International Standards Organization (ISO) ha pubblicato nel 2005 uno standard per l'archiviazione dei file con la norma ISO 19005-1:2005 (nel 2011 e poi ancora nel 2012 sono stati approvati due aggiornamenti dello 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{metadati} specificati dalla norma stessa. Esistono due sotto"formati: il PDF/A-1a e il PDF/A-1b. Il formato PDF/A-1a deve rispondere ai requisiti del formato PDF/A-1b oltre ad altri requisiti specifici, in particolare che i font siano tutti inclusi nel file ed abbiano codifica UNICODE, 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 sotto"formato PDF/A-1b. Mi risulta che sia allo studio da parte del Politecnico la possibilità di richiedere il rispetto di una norma molto più restrittiva, che garantisca l'accessibilità e la fruibilità dei documenti archiviati anche a coloro che hanno alcune forme di disabilità; tuttavia a tutt'oggi (2016) l'ISO non ha ancora messo a punto tale norma, quindi l'apposita commissione del Politecnico sta giustamente precorrendo i tempi perché l'Ateneo sia pronto ad attuare la futura norma. Nel frattempo l'apposito gruppo di lavoro del TUG sta cercando di estendere i suoi pacchetti per l'archiviabilità anche per la norma PDF/A-1a, che richiede di disporre di file PDF classificati come \emph{taggged PDF}. + +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} sia con \prog{lualatex}. In particolare, per sfruttare al meglio le possibilità offerte da \prog{xelatex} è necessario usare 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 si è predisposto il preambolo del file sorgente per la tesi in modo da poterlo compilare con \prog{pdflatex}, si può ugualmente compilare il documento anche con \prog{xelatex} o \prog{lualatex}, perché TOPtesi è perfettamente conscio del motore di composizione che si sta usando e sa che il file sorgente parte dal presupposto che si volevano creare gli hyperlink. In altre parole, non c'è bisogno di modificare sostanzialmente il file sorgente per passare da \prog{pdflatex} a \prog{xelatex}o \prog{lualatex}, se non eventualmente usando solo il ramo \emph{vero} oppure \emph{falso} del test indicato qui sotto. Però il file prodotto con \prog{xelatex} necessita di ulteriore elaborazione per soddisfare le specifiche richieste dalla norma ISO relativa al formato archiviabile; con \prog{pdflatex} e \prog{lualatex} non sono necessarie operazioni di post"processing. Si può comunque fare riferimento alla parte iniziale del preambolo del file usato per comporre questa stessa documentazione, che qui si riporta nuovamente:\label{pag:preambolo-pdfa} -\begin{verbatim} +\begin{Verbatim}[fontsize=\small,numbers=left,numbersep=3pt] +% !TEX encoding = UTF-8 Unicode +% !TEX TS-program = luaLaTeX +\begin{filecontents*}{\jobname.xmpdata} +\Title{La classe TOPtesi} +\Author{Claudio Beccari} +\Publisher{Claudio Beccari} +\Keywords{Monografia di laurea\sep +Tesi di laurea\sep +Tesi di dottorato\sep +classe LaTeX\sep +pdfLaTeX\sep +XeLaTeX\sep +LuaLaTeX} +\end{filecontents*} +% +\documentclass[12pt,twoside]{toptesi} +\ProvidesFile{toptesi-it.tex}[2016/06/30 v.0.99e] \ifPDFTeX +% + \usepackage[a-1b]{pdfx} +% \usepackage[utf8]{inputenc} \usepackage[T1]{fontenc} \usepackage{newtxtext,newtxmath,textcomp,textalpha} - \usepackage[a-1b]{pdfx} + \usepackage{amsmath,amssymb} \usepackage{mflogo} \usepackage{guit} + \setactivedoublequote \else + \ifLuaTeX + \usepackage[a-1b]{pdfx} + \fi \usepackage{fontspec} \usepackage{xcolor} \newcommand*\MP{{\setbox0\hbox{M}\relax \includegraphics[height=\ht0]{MPlogo}}} \newcommand*\GuIT{{\setbox0\hbox{Hg}\relax - \raisebox{-\dp0}{\includegraphics[height=\dimexpr\ht0+\dp0]{GuITlogo}}}} + \raisebox{-\dp0}{\includegraphics[height=\dimexpr\ht0+\dp0]{GuITlogo}}}} \setmainfont[Ligatures=TeX]{TeX Gyre Termes} \setsansfont[Ligatures=TeX, Scale=MatchLowercase]{TeX Gyre Heros} \setmonofont{UM Typewriter} @@ -1532,11 +1564,9 @@ Si può comunque fare riferimento alla parte iniziale del preambolo del file usa \usepackage{amsmath} \usepackage{unicode-math} \setmathfont{XITS Math} - \ifLuaTeX - \usepackage[a-1b]{pdfx} - \fi \fi \usepackage{metalogo,longtable,booktabs,array,tabularx,fancyvrb} +% \usepackage{imakeidx} \usepackage{hyperref} \hypersetup{% @@ -1548,73 +1578,114 @@ Si può comunque fare riferimento alla parte iniziale del preambolo del file usa citecolor={blue}, urlcolor={blue} } -\end{verbatim} -Come si vede, viene usato il test \cs{ifPDFTeX} definito dal pacchetto \pack{iftex} già caricato dalla classe \class{toptesi}; questo pacchetto definisce i tre comandi di test \cs{ifPDFTeX}, \cs{ifXeTeX} e \cs{ifLuaTeX} con i quali si può controllare quale motore di composizione si sta usando, \pdfLaTeX, \XeLaTeX\ o \LuaLaTeX, così da poter agire di conseguenza. Nel predisporre questa documentazione ho collaudato solo le funzionalità mediante \pdfLaTeX\ e \XeLaTeX; per \LuaLaTeX\ ho verificato soltanto che produce quasi gli stessi risultati che si ottengono con \XeLaTeX, nel senso che dal punto di vista della microtipografia \pdfLaTeX\ e \LuaLaTeX\ sono equivalenti perché usano sia la protrusione dei caratteri, sia l'espansione, mentre \XeLaTeX\ può usare solo la protrusione; le differenze nell'impaginazione sono minime, tuttavia non sono nulle. Dal punto di vista dell'archiviabilità dei file, invece, a quanto sembra \XeLaTeX\ e \LuaLaTeX\ sono equivalenti. +\end{Verbatim} +Un commento va fatto subito: il lettore non si spaventi di una prima parte di preambolo così complessa, e non ha nessun bisogno di copiarla integralmente. Per questo documento ho predisposto un test per verificare con quale programma di composizione compilo il documento e come si vedo imposto i font e le lingue come specificato sopra, ma nel ramo \emph{falso} (cioè non si sta compilando con \prog{pdflatex} ma con \prog{lualatex} oppure \prog{xelatex}; tuttavia se il programma con cuoi si compila si evita di caricare il pacchetto speciale \pack{pdfx}, necessario per produrre file PDF/A compatibili. Il lettore sa perfettamente con quale programma vuole compilare la sua tesi e può tranquillamente mettere nel suo preambolo solo il ramo \emph{vero} del test se compila con \prog{pdflatex} o solo il ramo \emph{falso} se compila con \prog{lualatex} o con \prog{xelatex}. Se vuol produrre un file PDF/A compatibile con \prog{xelatex} ha due vie: +\begin{itemize} +\item toglie il test \verb|\ifLuaTeX| e usa solo il ramo \emph{falso} del test \verb|\ifPDFTeX|; tuttavia ciò non basta e deve poi procedere come specificato nel paragrafo~\ref{sec:XePDFA}; oppure +\item lascia perdere \prog{xelatex} e compila con \prog{lualatex}; il frutto della compilazione è persino migliore, visto che \prog{lualatex} usa le funzionalità del pacchetto \pack{microtype} in modo più avanzato rispetto a \prog{xelatex}. +\end{itemize} -Va notato che i due rami del test contengono le istruzioni per caricare pacchetti diversi e alcune definizioni, quelle dei loghi di \GuIT\ e di \MP, che ricorrono a font vettoriali, ma non OpenType, per cui potrebbero dare luogo a problemi per la conformità alle norme PDF/A quando si usa \XeLaTeX. Si spiegherà meglio nell'apposito paragrafo. +Nel codice precedente le prime due righe sono commenti per il programma di compilazione, ma per il programma di editing sono comandi di autoconfigurazione; essi dicono al programam di editing di salvare il documento dopo la prima creazione e dopo ogni modifica con la codifica \opz{utf8}; e la seconda dice che quando si preme il bottone per la compilazione deve dare al sistema operativo di lanciare il programma \prog{lualatex}. Ricordo che questo tipo di commenti di autoconfigurazione sono decifrati corretta mente dagli editor TeXShop, TeXworks e TeXstudio (forse anche da altri editor, ma questi tre sono quelli che io consiglieri per ogni utente). -Facendo seguito a quanto preannunciato, mentre lavorando con \pdfLaTeX\ si carica esplicitamente il pacchetto \pack{pdfx} con l'opzione \opz{a-1b}, con \XeLaTeX\ quel pacchetto non viene caricato e più avanti si spiega come fare ad ottenere un file PDF/A ricorrendo a altri programmi. Va notato però che il pacchetto \pack{pdfx} deve essere caricato \emph{dopo} i pacchetti che specificano le codifiche d'ingresso e quelle dei font di uscita, ma prima del pacchetto \pack{hyperref}; quest'ultimo può venire caricato (sempre per ultimo) a meno che non si debba comporre parte o tutto il documento in una lingua scritta da destra a sinistra; in questo caso le specifiche per questo tipo di lingue vanno specificate dopo \pack{hyperref}. +Le righe dalla 3 alla 14 contengono l'ambinete \amb{filecontents*} che provvede a generare la lista dei metadati che ho usato per questo documento. -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 questa operazione a cui ho collaborato parzialmente prima di andare in pensione. +La riga 16 contiene la dichiarazione della classe; come si vede specifico solo il corpo normale dei font al valore di 12\,pt, e seleziono la composizione in bianca e volta, successivamente non specifico nessuna correzione per la legatura. +Importante per questo documento è la riga 17, dove specifico il nome del file, ma ne specifico anche la data e la versione; così sono sempre sicuro di quale versione mi sto servendo e i lettori che trovano questo file fra la documentazione di \class{toptesi} sanno subito se si tratta di documentazione aggiornata o se non sia il caso di aggiornare la propria installazione. + +Con la riga 18 comincia il test importante per configurare il preambolo correttamente secondo le necessità di compilazione; dalla riga 19 alla riga 28 si ha il ramo \emph{vero} da usarsi quando si compila con \prog{pdflatex}; invece dalla riga 30 alla riga 45 si ha il ramo \emph{falso} da usarsi quando si compila con \prog{lualatex}; per compilare con \prog{xelatex} ho già detto che, oltre a togliere le righe 30 e 32 (ma non la riga 31), bisogna poi procedere come specificato nel paragrafo~\ref{sec:XePDFA}. + +Le righe successive dalla 47 alla 59 servono per mostrare non solo i pacchetti che ho caricato, ma anche come ho configurato le opzioni per \pack{hyperref}; nessuna opzione nella chiamata del pacchetto, ma tutte le impostazioni eseguite mediate l'argomento del comando \verb|\hypersetup|. + +Vorrei sottolineare l'opportunità di specificare come indicato nel codice precedente i metadati richiesti per la compilazione del documento in modo che sia conforme con lo standard PDF/A. Non è obbligatorio ma in questo modo si è sicuri che il file dei metadati abbia l'estensione giusta e il nome assolutamente coincidente con il nome del main file del documento, cioè della tesi. + +L'altro punto importante è non solo caricare il pacchetto \pack{pdfx}, ma è necessario caricarlo nell'ordine indicato, cioè come primo pacchetto. -Il problema dell'archiviazione elettronica è che il materiale archiviato deve essere reperibile, leggibile e stampabile per un tempo indefinito, anche secoli! 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. +Ho collaudato questo preambolo compilando sia con \prog{pdflatex} sia con \prog{lualatex}; volendo, avrei potuto seguire le raccomandazioni che scrivo nel paragrafo~\ref{sec:XePDFA} ma non l'ho fatto; visto che ottengo lo stesso risultato, anzi un risultato migliore, con \prog{lualatex} mi è parso un collaudo superfluo. Con questo non voglio dire che \prog{xelatex} sia diventato inutile; esso come \prog{pdflatex} ha un file di formato che contiene tutte le impostazioni per tutte le lingue che il sistema \TeX\ può gestire, mentre \prog{lualatex} in questo momento di ogni lingua può gestire una sola impostazione per ogni lingua; per esempio il greco ha tre varianti e il file di formato di \prog{xelatex} le potrebbe gestire tutte e tre come ci riesce \prog{pdflatex}; lo stesso vale per il latino e per diverse altre lingue; \prog{lualatex} al momento può gestire una sola variante di ogni lingua. Perciò in questo momento \prog{xelatex} potrebbe essere preferibile a \prog{lualatex} per le tesi di carattere linguistico, filologico, umanistico in generale. Personalmente ora (giugno 2016) dispongo di impostazioni mie personali per gestire le tre varianti del greco e le tre varianti del latino, ma esse non sono ancora state ancora approvate dal gruppo di lavoro \textsf{tex-hyphen} del \TeX\ Users Group (TUG) e non le posso distribuire senza la loro approvazione; quando saranno approvate, saranno direttamente disponibili con gli aggiornamenti di \TeXLive. -L'International Standards Organization (ISO) ha pubblicato nel 2005 uno standard per l'archiviazione dei file con la norma ISO 19005-1:2005 (nel 2011 e poi ancora nel 2012 sono stati approvati due aggiornamenti dello 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{metadati} specificati dalla norma stessa. Esistono due sotto"formati: il PDF/A-1a e il PDF/A-1b. Il formato PDF/A-1a deve rispondere ai requisiti del formato PDF/A-1b oltre ad altri requisiti specifici, in particolare che i font siano tutti inclusi nel file ed abbiano codifica UNICODE, 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 sotto"formato PDF/A-1b. + +Va inoltre notato che i due rami del test contengono le istruzioni per caricare pacchetti diversi e alcune definizioni, quelle dei loghi di \GuIT\ e di \MP, che ricorrono a font vettoriali, ma non OpenType, per cui potrebbero dare luogo a problemi per la conformità alle norme PDF/A quando si usa \XeLaTeX. Si spiegherà meglio nell'apposito paragrafo. + + +%\goodpagebreak \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 \file{pdfx.sty} con l'opzione giusta, precisamente il preambolo, subito prima di \cs{begin}\Arg{document}, deve contenere la richiesta: +Usando \prog{pdflatex} è necessario usare il pacchetto specifico \pack{pdfx} richiamandolo con l'opzione giusta; precisamente il preambolo deve contenere la richiesta: \begin{verbatim} \usepackage[a-1b]{pdfx} \end{verbatim} -come è stato mostrato precedentemente nella pagina~\pageref{pag:preambolo-pdfa}; si ripete il fatto importantissimo che il pacchetto deve venire caricato dopo il pacchetto \pack{inputenc}, per evitare l'errore di \emph{Option clash}; \LaTeX, infatti, consente di invocare due volte lo stesso pacchetto purché la seconda invocazione non specifichi opzioni diverse dalla prima oppure non specifichi nessuna opzione; il pacchetto \pack{pdfx} invoca il pacchetto \pack{inputenc} senza nessuna opzione e quindi è compatibile con l'invocazione precedente. Bisogna anche caricarlo prima di \pack{hyperref} e se quest'ultimo deve venire configurato lo si deve fare non per mezzo di opzioni nella chiamata del pacchetto, ma mediante l'apposito comando \cs{hypersetup} e i suoi argomenti +come è stato mostrato precedentemente nella pagina~\pageref{pag:preambolo-pdfa}; quando si usa \prog{pdflatex} non è molto importante l'ordine con cui si caricano i vari pacchetti, ma la documentazione di \pack{pdfx} raccomanda di caricarlo il più presto possibile; tuttavia sarebbe meglio caricarlo dopo aver specificato tutti i pacchetti aggiuntivi che potrebbero influire sui collegamanti ipertestuali, cioè i pacchetti che modificano i comandi di sezionamento, la composizione delle didascalie e simili. \pack{pdfx} carica già \pack{hyperref} per configurarne i collegamenti ipertestuali in modo conforme alle specifiche della norma PDF/A. Questo implica, però, che il pacchetto \pack{pdfx} venga caricato prima che nel preambolo venga caricato \pack{hyperref}; anzi, avendo caricato \pack{pdfx} non è necessario caricare \pack{hyperref}, ma basta configurarlo con \cs{hypersetup} per le esigenze specifiche del documento. Non è vietato caricarlo di nuovo, purché nel preambolo, dopo aver caricato \pack{pdfx}, \pack{hyperref} sia caricato senza opzioni proprio per evitare l'errore ``option clash''. Questa possibilità di tenere separato il caricamento di \pack{hperref} dalla sua configurazione mediante \cs{hypersetup}, è comoda perché consente di aggiungere la chiamata di \pack{pdfx} (prima di \pack{hyperref}) in un secondo tempo, quado si vuole aggiungere la compatibilità con le norme PDF/A. Il pacchetto \pack{pdfx} è già presente con ogni installazione completa del sistema \TeX; se si disponesse di una installazione di base o, comunque, parziale e il pacchetto non fosse già installato, bisogna provvedere con i metodi specifici di ciascuna installazione. Se ne consiglia la lettura della documentazione, perché consente una certa dose di personalizzazione. Il pacchetto \pack{pdfx} con l'opzione \opz{a-1b} provvede a quasi tutto il necessario, per esempio a definire un profilo di colore, ma non provvede ai metadati specifici di ogni particolare documento, di cui invece parlerò più avanti. -I {metadati} di carattere generale sono inseriti nel file di uscita dall'azione diretta del file \file{pdfx.sty}; ma per i {metadati} specifici del documento che si sta componendo è necessario predisporre nella cartella dove risiede il file principale della tesi (quello sul quale opera l'eseguibile \prog{pdflatex}) un file contenente i {metadati}; il file deve avere lo stesso nome del file principale della tesi e l'estensione \texttt{.xmpdata}. Per esempio, il file principale di questo documento (quando lo si vuole comporre con \prog{pdflatex}) si chiama \texttt{toptesi-it-pdftex.tex}: nella cartella dove risiede è stato creato il file \texttt{toptesi-it-pdftex.xmpdata} con il seguente contenuto: -\begin{verbatim} -\Author{Claudio Beccari} -\Title{La classe TOPtesi} -\Keywords{LaTeX\sep PDF/A\sep Tesi\sep Dissertazione\sep Monografia} -\end{verbatim} -Questa operazione, evidentemente va adattata per ogni documento da produrre in formato PDF/A, e quindi bisogna predisporre un diverso file \file{.xmpdata} contenente le informazioni relative allo specifico documento. +I {metadati} di carattere generale sono inseriti nel file di uscita dall'azione diretta del file \file{pdfx.sty}; ma per i {metadati} specifici del documento che si sta componendo è necessario predisporre nella cartella dove risiede il file principale della tesi (quello sul quale opera l'eseguibile \prog{pdflatex}) un file contenente i {metadati}. Il metodo migliore per farlo è mostrato nel codice della pagina~\pageref{pag:preambolo-pdfa}: si tratta di inserire i metadati all'interno dell'ambiente \amb{filecontents*} prima ancora della dichiarazione della classe; questo ambiente \LaTeX\ è l'unica struttura del linguaggio di mak-up che può essere inserita prima di \cs{documentclass}. -Ci si ricordi solo che il pacchetto \pack{toptesi} non contiene nessuna verifica se si sta componendo con \prog{pdflatex} oppure con il semplice \prog{latex} o con qualche altro applicativo del sistema \TeX; controlla solo se si sta usando \prog{pdflatex} e assume che se non si sta componendo con \prog{pdfltex} allora si sta usando \prog{xelatex} oppure \prog{lualatex}. Il concetto è che \emph{bisogna} usare \prog{pdflatex}. E se si usa qualunque altro programma di composizione,\begin{itemize}[noitemsep] -\item o si ottiene un messaggio d'errore (con \prog{latex}), -\item oppure non ci sono 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). -\end{itemize} +Ci si ricordi solo che il pacchetto \pack{toptesi} controlla solo se si sta usando \prog{pdflatex} e assume che se non si sta componendo con \prog{pdflatex} allora si sta usando \prog{xelatex} oppure \prog{lualatex}. In particolare si ottiene un errore se si compila con \prog{latex}, il programma ancora esistente ma che io considero obsoleto, con il quale si produce un file in formato DVI, ormai quasi estinto. Si noti che, in effetti, sebbene il comando \prog{latex} esista ancora, il motore di composizione di \prog{latex} e di \prog{pdflatex} è lo stesso, ma ne differiscono le impostazioni; il test \cs{ifPDFTeX} che usa TOPtesi per conoscere se si sta usando \prog{pdftex} per produrre un file in formato PDF piuttosto che in formato DVI, non è detto che riesca a distinguere questi due casi. Non ho mai verificato, perché usando un calcolatore Apple, il mio formato di default è sempre PDF; per ottenere il formato DVI devo dare comandi specifici mediante il terminale, cosa che evidentemente non faccio mai perché, oltretutto, non dispongo di un visualizzatore per il formato DVI. -Se esistono validi motivi per non usare \prog{pdflatex}\footnote{Ma è meglio evitare di usare quei pacchetti che richiedono comandi PostScript, come per esempio \pack{PSTriks} o \pack{XYpic}, ma è preferibile usare i pacchetti di grafica, come \pack{pgf} con il suo modulo \pack{tikz}, che consentono di fare quasi tutto quello che si può fare con gli altri pacchetti che richiedono il linguaggio PostScript.}, allora bisogna usare il semplice \prog{latex}, e poi convertire il file DVI ottenuto in un file PS e, per la conversione in file PDF/A, bisogna poi usare \prog{ghostscript}; si può procedere come indicato sotto nel paragrafo~\ref{sec:XePDFA}, indicando per la variabile \texttt{file1} il valore \verb|$1.ps| invece del valore \verb|$1.pdf|. -Bisogna ricordare che produrre un file PDF/A non è semplice, ma se si usa \prog{pdflatex} con i font di default, se si incorporano solo figure PNG e JPEG con profilo di colore RGB (red, green, blue); se ogni file PDF da incorporare contiene al suo interno anche i font che eventualmente sono necessari per comporre il suo testo,, non si dovrebbero incontrare problemi di certificazione della natura PDF/A del file della tesi. +Se esistono validi motivi per non usare \prog{pdflatex}, allora bisogna usare il semplice \prog{latex}, e poi convertire il file DVI ottenuto in un file PS e, per la conversione in file PDF/A, bisogna poi usare \prog{ghostscript}; si può procedere come indicato sotto nel paragrafo~\ref{sec:XePDFA}, indicando per la variabile \texttt{file1} il valore \verb|$1.ps| invece del valore \verb|$1.pdf|. È meglio evitare di usare quei pacchetti che richiedono comandi PostScript, come per esempio \pack{PSTricks} o \pack{XYpic}, ma è preferibile usare i pacchetti di grafica, come \pack{pgf} con il suo modulo \pack{tikz}, che consentono di fare quasi tutto quello che si può fare con gli altri pacchetti che richiedono il linguaggio PostScript. Inoltre esistono pacchetti da usare con \prog{pdflatex} che permettono di usare (almeno) il potentissimo PSTricks anche con \prog{pdflatex}; questi pacchetti, lavorando in background senza che l'utente debba metterci mano, estraggono il codice di PSTricks dal file sorgente, lo salvano in un nuovo file \file{.tex} di servizio che compilano con \prog{latex} e ne trasformano il file di uscita in formato PDF per poi importarlo già scontornato nel file che interessa all'utente; Se fra una compilazione e l'altra non sono state eseguite modifiche al codice PSTricks, questa operazione in background viene tranquillamente saltata, quindi non si nota nemmeno nessun rallentamento nell'elaborazione della tesi. Vale comunque il consiglio di non usare questi moduli che richiedono l'uso del linguaggio PostScript, perché i moduli che lavorano direttamente con il linguaggio PDF lavorano altrettanto bene nella stragrande maggioranza dei casi. -Il pacchetto \pack{pdfx} non funziona 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\ Alla peggio gestisce un file prodotto con \LuaLaTeX\ come se fosse stato composto con \XeLaTeX. Tuttavia\dots\ Si veda il paragrafo~\ref{sec:LuaPDFA}. +Bisogna ricordare che produrre un file PDF/A non è semplice, ma se si usa \prog{pdflatex} con i font di default, se si incorporano solo figure PNG (senza trasparenze) e JPEG con profilo di colore RGB (red, green, blue), se ogni file PDF da incorporare contiene al suo interno anche i font che eventualmente sono necessari per comporre il suo testo, non si dovrebbero incontrare problemi di certificazione della natura PDF/A del file della tesi. Più avanti c'è un paragrafo dedicato al caso che un file così prodotto non risulti conforme alla norma PDF/A. +\goodpagebreak + +\subsection{\texorpdfstring{\prog}{}{lualatex} e il formato PDF/A} +Anche il programma \prog{lualatex} può produrre direttamente file PDF/A conformi a partire dalla distribuzione del sistema \TeXLive del 2016. + +Con \prog{lualatex} è importante specificare il preambolo come mostrato nella pagina\pageref{pag:preambolo-pdfa} sia per quel che riguarda i metadati sia per quel che riguarda la posizione della chiamata del pacchetto \pack{pdfx}. + +Il programma \prog{lualatex} è meno elastico rispetto al programma \prog{pdflatex} per quel che riguarda la posizione della chiamata del pacchetto \pack{pdfx} che deve essere assolutamente il primo dopo \cs{documentclass}. + +Per il resto valgono le stesse indicazioni scritte per l'uso del programma \prog{pdflatex}. Sottolineo ancora che il file sorgente della tesi deve essere assolutamente salvato con la codifica \opz{utf8} e che i metadati devono essere scritti e salvati nel loro file \file{.xmpdata} con la stessa codifica. + +Se i metadati devono essere usati da programmi di biblioteconomia per la ricerca dei contenuti, delle parole chiave, e simili, suggerirei di scrivere i metadati in inglese sia perché probabilmente la ricerca delle informazioni biblioteconomiche risulta facilitata anche all'estero, sia perché si evitano i caratteri accentati, almeno in tutti i campi in cui l'italiano non è essenziale, come il titolo (se è in italiano) e i nomi propri. + +Come si legge nella parte di preambolo che appare nella pagina~\pageref{pag:preambolo-pdfa}, questo stesso file è stato composto con \prog{lualatex} ed la verifica della conformità ha dato esito positivo. + + \subsection{\texorpdfstring{\prog}{}{xelatex} e il formato PDF/A}\label{sec:XePDFA} -Se invece si deve usare il programma \prog{xelatex} per comporre la tesi e si vuole avere un file finale conforme alle specifiche PDF/A, allora bisogna procedere in modo diverso\footnote{Questa procedura serve anche quando usate \prog{latex} e usate pacchetti con \pack{PSTricks} che richiedono di inserire del codice PostScript nel file di uscita.}; precisamente si usano le stesse cautele raccomandate per quando si usa il programma \prog{pdflatex}; bisogna predisporre un preambolo simile al ramo\emph{falso} del test indicato nella pagina~\pageref{pag:preambolo-pdfa}; si incorporano figure che abbiano solo il profilo di colore RGB e che contengano al loro interno i font vettoriali di cui si servono, ma bisogna usare solo font OpenType; \prog{xelatex} è fatto apposta per usare questi font. Per la matematica si usi una delle collezioni di font OpenType oggi (2015) disponibili: XITS Math, Asana Math, Latin Modern Math, TeX\ Gyre Pagella Math, \TeX\ Gyre Termes Math. Si controlli che qualunque file incluso \emph{non} contenga i font Computer Modern con codifica OT1 (la vecchia codifica senza lettere accentate) o che se li contiene non siano usate 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 da comporre; potrebbero essercene se si incorporano 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. + +Con \prog{xelatex} le cose sono un po' più complesse che con \prog{lualatex}, ed è per questo motivo che consiglio di usare direttamente \prog{lualatex}. +Il motivo è dovuto al fatto che \prog{xelatex} non produce direttamente la sua uscita nel formato PDF, ma in un formato DVI esteso che viene trasformato in PDF dal programma \prog{xdvipdfmx}, che di per sé non sa nulla a proposito del fatto che il file da trasformare contenga o non contenga dei metadati. + +Per questo motivo si deve compilare ``a mano'', dando il comando di compilazione dal terminale nel modo seguente: +\begin{flushleft}\ttfamily +xelatex -shell-escape -output-driver="xdvipdfmx -z 0" <filename>.tex +\end{flushleft} +Come si vede \prog{xelatex} deve lavorare con l'opzione \opz{-shell-escape} che consente di lanciare un programma esterno; in questo caso l'uscita di \prog{xelatex} viene inviata al driver di uscita \prog{xdvipdfmx} (e fin qui non ci sono sorprese rispetto a quello che \prog{xelatex} fa di solito), ma la differenza consiste nell'opzione passata a \prog{xdvipdfmx}: \opz{-z 0}. Questa opzione dice al programma di non comprimere il suo file di uscita; questo fatto produce due effetti: quello buono è che non comprime i metadati; quello ``cattivo'' è che il file di uscita è enormemente più grande rispetto a quando fosse compresso, anche 10 volte più grande. + +Per il resto, avendo predisposto il main file della tesi come se si dovesse lavorare con \prog{lualatex} e avendo osservato le stesse cautele per i font, i colori, eccetera, il file ottenuto, nonostante le sue dimensioni, può venire sottoposto a verifica attraverso il modulo Preflight di Adobe Acrobat Pro, come bisogna fare anche quando il file PDF fosse ottenuto con \prog{pdflatex} o \prog{lualatex}; ma il buono, questa volta, è che se il file ottenuto passa la verifica di conformità, Adobe Acrobat è anche in grado di comprimer il file, lasciando inalterati (non compressi) i metadati. + +Vista questa trafila, si capisce anche perché sconsiglio di comporre la tesi con \prog{xelatex} ma consiglio di usare direttamente \prog{lualatex}. + +\subsection{Uso di \texorpdfstring{\prog}{}{ghostscript} o di \texorpdfstring{\pack}{}{pdfpages}} + +Esistono altri metodi per ottenere la produzione di file conformi alla norma PDF/A. Uno è quello di ottenere la trasformazione mediante il programma \prog{ghostscript} e l'altro consiste nel produrre un secondo file importando le pagine del primo mediante il pacchetto \pack{pdfpages}. Nel seguito si illustreranno i due metodi; anche se nel seguito continuerò ad esemplificare parlando della tesi, ritengo che questi due metodi siano più utili, per i lettori che leggendo questa documentazione dimostrano di voler usare il sistema \TeX, per controllare singoli file da importare nella tesi, sia in formato PDF sia, solo con \prog{ghostscript}, in formato~PS. + +Infatti è meglio creare un piccolo file presumibilmente PDF/A compatibile e verificarne la compatibilità: se è compatibile, non ci sono problemi ad importarlo nella tesi; se è incompatibile prima si esaminano le cause dell'incompatibilità, prima lo si può correggere per renderlo compatibile o si possono prendere decisioni valide su casa farne per importarlo nella tesi. \subsubsection{Uso di \texorpdfstring{\prog}{}{ghostscript}} -Dopo aver eseguito \prog{xelatex} sui file sorgente della tesi ci si ritrova con un file PDF che non è ancora conforme allo standard PDF/A, e bisogna provvedere con altri programmi. Qui indicherò due o tre metodi che possono avere vantaggi o svantaggi,nessuno è perfetto, ma funzionano. +Dopo aver ottenuto un file PDF della tesi e ci si ritrova con un file che non è ancora conforme allo standard PDF/A, si può provvedere con altri programmi. Qui indicherò due o tre metodi che possono avere vantaggi o svantaggi; nessuno è perfetto, ma funzionano. Si può usare \prog{ghostscript} per trasformare un file PDF in un altro PDF/A. Bisogna predisporre nella stessa cartella dove si trova il main file del documento un file che contenga i {metadati}; per comporre questo documento composto con \prog{xelatex}, il file adatto per \prog{ghostscript} è il seguente: \begin{Verbatim}[fontsize=\small] %! % 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), +% This assumes an ICC profile to reside in the file (srgb.icc), % unless the user modifies the corresponding line below. % Define entries in the document Info dictionary : -/ICCProfile (~/icc/srgb.icc) def +/ICCProfile (~/icc/srgb.icc) def % Customize def [ /Title (La classe TOPtesi) % Customize. @@ -1651,9 +1722,9 @@ def [{Catalog} <</OutputIntents [ {OutputIntent_PDFA} ]>> /PUT pdfmark \end{Verbatim} -Questo file è formato dal nome del file \texttt{.tex.}, \texttt{toptesi-it-xetex}, agglutinato alla ``desinenza'' \texttt{-def.ps}, per un nome complessivo \texttt{toptesi-it-xetex-def.ps}. Ripeto: deve essere memorizzato nella stessa cartella dove si trova il main file del documento. Voglio far notare che ho usato questo file di metadati per alcuni anni; oggi la libreria di \prog{ghostscript}, versione 9.16, indica di modificare un file \verb|PDFA_def.ps| diverso da quel modello, ma, devo ammetterlo, la documentazione di che cosa indicare nelle nuove parti configurabili è tutt'altro che chiara e, pur essendo possibile farlo, non ci sono riuscito. +Questo file è formato dal nome del file \texttt{.tex.}, (per esempio \texttt{toptesi-it} per questo file), agglutinato alla ``desinenza'' \texttt{-def.ps}, per un nome complessivo, per esempio, \texttt{toptesi-it-def.ps}. Ripeto: deve essere memorizzato nella stessa cartella dove si trova il main file del documento. Voglio far notare che ho usato questo file di metadati per alcuni anni; oggi la libreria di \prog{ghostscript}, versione 9.16, indica di modificare un file \verb|PDFA_def.ps| diverso da quel modello, ma, devo ammetterlo, la documentazione di che cosa indicare nelle nuove parti configurabili è tutt'altro che chiara e, pur essendo possibile farlo, non ci sono riuscito. -Si noti ancora che i file \file{.icc} necessari per specificare i profili di colore devono risiedere in una cartella accessibile attraverso uno dei percorsi indicati nella variabile di sistema \verb|PATH|; io per la mia macchina ho creato una cartella chiamata \verb|icc|, inserita nella mia \verb|$HOME|; nei sistemi UNIX il simbolo \verb|~| indica questa `casa' delle cartelle; nei sistemi Windows recenti, la \verb|$HOME| non è rappresentata da un simbolo, ma corrisponde al nome dell'utente nella cartella \verb|C:\Users\|; quindi la \verb|$HOME| dell'utente Mario, sarà indicata con \verb|C:\Users\Mario\|. Nella cartella \verb|icc| (o comunque la si voglia chiamare) bisogno copiare i vari file \file{.icc} distribuiti insieme all'installazione di \prog{ghostscript}; nelle macchine UNIX, questi file si trovano in una sottocartella di sistema che si chiama \verb|/usr/local/share/ghostscript/|\meta{versione}\verb|/iccprofiles/|. Con la versione che sto usando \meta{versione} vale 9.16 e contiene una decina di file che descrivono i profili di colore, compreso il file \file{srgb.icc} indicato nel precedente listato di codice PostScript. +Si noti ancora che i file \file{.icc} necessari per specificare i profili di colore devono risiedere in una cartella accessibile attraverso uno dei percorsi indicati nella variabile di sistema \verb|PATH|; io per la mia macchina ho creato una cartella chiamata \verb|icc|, inserita nella mia \verb|$HOME|; nei sistemi UNIX il simbolo \verb|~| indica questa `casa' delle cartelle; nei sistemi Windows recenti, la \verb|$HOME| non è rappresentata da un simbolo, ma corrisponde al nome dell'utente nella cartella \verb|C:\Users\|; quindi la \verb|$HOME| dell'utente Mario, sarà indicata con \verb|C:\Users\Mario\|. Nella cartella \verb|icc| (o comunque la si voglia chiamare) bisogna copiare i vari file \file{.icc} distribuiti insieme all'installazione di \prog{ghostscript}; nelle macchine UNIX, questi file si trovano in una sottocartella di sistema che si chiama \verb|/usr/local/share/ghostscript/|\meta{versione}\verb|/iccprofiles/|. Con la versione che sto usando \meta{versione} vale 9.16 e contiene una decina di file che descrivono i profili di colore, compreso il file \file{srgb.icc} indicato nel precedente listato di codice PostScript (che quindi, se va bene per lo scopo, non necessita di nessuna personalizzazione). Comunque 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} @@ -1673,11 +1744,12 @@ Salvato il file in un ramo del \texttt{PATH} dove il sistema operativo può trov \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. +Se bisogna trasformare un file PS, basta cambiare ls seconda riga \verb|file1=$1.pdf| in \verb|file1=$1.ps| senza la necessità di modificare altro. -Le variazioni per Windows consistono nel fatto che l'eseguibile di \prog{ghostscript} si chiama \prog{gswin32c} invece che \prog{gs}, e che i parametri di una macro si indicano con \verb|%1|, \verb|%2|, +Le variazioni per Windows consistono nel fatto che l'eseguibile di \prog{ghostscript} si chiama \prog{gswin32c} invece che \prog{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 delle due versioni della procedura per verificare l'esistenza del file PDF da convertire, o l'esistenza del file dei {metadati}, 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. +Nessuno vieta di arricchire la definizione delle due versioni della procedura per verificare l'esistenza del file PDF o PS da convertire, o l'esistenza del file dei {metadati}, 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. Va notato che i collegamenti ipertestuali all'interno del file convertito con \prog{ghostscript} in un file conforme alla norma PDF/A vengono tutti disattivati; secondo me non è una grave perdita per un file da archiviare, ma certamente lo è per un documento da consultare a schermo. @@ -1685,9 +1757,9 @@ Va notato che i collegamenti ipertestuali all'interno del file convertito con \p Un secondo metodo con il quale ho avuto risultati positivi ricorre al pacchetto \pack{pdfpages} ma, come col metodo precedente, ha il difetto di perdere gli eventuali collegamenti ipertestuali interni. -Supponiamo quindi di disporre di un file PDF composto secondo le raccomandazioni indicate nei paragrafi precedenti. Tanto per mettere i puntini sulle `i', il lettore attento ha notato che le due parti del test indicato nella pagina~\pageref{pag:prambolo-pdfa} sono leggermente diverse, infatti per i loghi \GuIT\ e \MP\ ho creato le definizioni per produrre questi loghi importando e scalando due file PDF appositamente predisposti (con \prog{pdflatex}), conformi alla norma PDF/A e opportunamente scontornati. Li ho predisposti con i loghi molto grandi, ma pur sempre vettoriali, in modo che possano venire ingranditi o rimpiccioliti a piacere. Le due macro \cs{GuIT} e \cs{MP}, infatti, scalano quelle due immagini PDF in modo che siano grandi come il testo circostante e abbiano la linea di base esattamente allineata con quella del testo. In quanto file PDF/A, essi contengono tutte le informazioni che devono contenere, metadati e font esattamente come la norma richiede; presi a sé, essi passano le verifiche eseguite con Adobe Acrobat Pro~XI. Il file \file{toptesi-it-xetex.pdf} composto con tutte le attenzioni descritte sopra non soddisfa alla norma PDF/A perché nel comporlo non si è potuto usare il pacchetto \pack{pdfx}. +Supponiamo quindi di disporre di un file PDF (ma non PS) composto secondo le raccomandazioni indicate nei paragrafi precedenti. Tanto per mettere i puntini sulle `i', il lettore attento ha notato che le due parti del test indicato nella pagina~\pageref{pag:preambolo-pdfa} sono leggermente diverse, infatti per i loghi \GuIT\ e \MP\ ho creato le definizioni per produrre questi loghi importando e scalando due file PDF appositamente predisposti (con \prog{pdflatex}), conformi alla norma PDF/A e opportunamente scontornati. Li ho predisposti con i loghi molto grandi, ma pur sempre vettoriali, in modo che possano venire ingranditi o rimpiccioliti a piacere. Le due macro \cs{GuIT} e \cs{MP}, infatti, scalano quelle due immagini PDF in modo che siano grandi come il testo circostante e abbiano la linea di base esattamente allineata con quella del testo. In quanto file PDF/A, essi contengono tutte le informazioni che devono contenere, metadati e font esattamente come la norma richiede; presi a sé, essi passano le verifiche eseguite con Adobe Acrobat Pro~XI. -Si prepara ora un altro semplicissimo file che viene chiamato \file{toptesi-it-xepages.tex} con il seguente contenuto: +{\tolerance=3000 Si prepara ora un altro semplicissimo file che viene chiamato, per esempio, \file{toptesi-it-pages.tex} con il seguente contenuto: \begin{verbatim} % !TEX encoding = UTF-8 Unicode % !TEX TS-program = pdflatex @@ -1696,96 +1768,20 @@ Si prepara ora un altro semplicissimo file che viene chiamato \file{toptesi-it-x \usepackage[a-1b]{pdfx} \nofiles \begin{document}\pagestyle{empty} -\includepdf[pages=-]{toptesi-it-xetex.pdf} +\includepdf[pages=-]{toptesi-it.pdf} \end{document} \end{verbatim} -e lo si affianca con il corrispondente file \file{toptesi-it-xepages.xmpdata} il cui contenuto è identico al file \file{toptesi-it-xetex.xmpdata} che si sarebbe preparato per comporre l'analogo file se lo si fosse potuto comporre con \prog{pdflatex}. - -Il piccolo file precedente è in grado di produrre un file PDF/A perché il suo preambolo è correttamente predisposto per questo scopo; carica il pacchetto \pack{pdfpages} che serve per importare tutte o una selezione di pagine di un file PDF comunque composto, dentro il file che si ottiene elaborandolo con \prog{pdflatex}; sottolineo \textcolor{red}{\prog{pdflatex}}, non con \prog{xelatex}. Se il file \file{toptesi-it-xetex.pdf} non contiene file importati con caratteristiche incompatibili, il file PDF ottenuto risulta conforme alla norma PDF/A, ma se il file di partenza conteneva collegamenti ipertestuali, il file finalmente ottenuto è privo di collegamenti ipertestuali. +e lo si affianca con il corrispondente file \file{toptesi-it-pages.xmpdata} il cui contenuto è identico al file \file{toptesi-it.xmpdata} che si sarebbe preparato per comporre l'analogo file se lo si fosse potuto comporre con \prog{pdflatex}.\par} -\subsubsection{Non usare i due pacchetti \texorpdfstring{\pack}{}{pax} e \texorpdfstring{\pack}{}{pdfpages}} -Il pacchetto \pack{pax} è stato costruito per ridare funzionalità ai collegamenti ipertestuali contenuti in file PDF immessi completamente o in parte dentro altri file PDF. Funziona perfettamente, ma il pacchetto \pack{pdfx} non riesce a gestire le operazioni del pacchetto \pack{pax}, per cui tutti le le informazioni relative ai collegamenti vengono ripristina, ma il file complessivo non rispetta le specifiche della norma PDF/A e gli errori segnalati dalla funzione Preflight di Adobe Acrobat Pro~XI riguardano solo gli hyperlink, quando lo stesso file PDF ricomposto solo con l'uso di \pack{pdfx} e \pack{pdfpages} è perfettamente conforme con le norme PDF/A, anche se i suoi link non sono attivi. - -\iffalse % Inizio metacommento -Prima di tutto bisogna installare quanto serve per far lavorare il pacchetto \pack{pacx}; esso di per sé è gia presente in una installazione completa del sistema \TeX, ma va affiancato da un altro pacchetto Java che va installato mediante il seguente comando: -\begin{verbatim} -pdfannotextractor --install --debug -\end{verbatim} -che provvede a scaricare dalla rete il pacchetto \pack{PDFBox-0.7.3} con le funzionalità del quale il pacchetto \pax{può} funzionare. Ciò fatto si può procedere. +Il piccolo file precedente è in grado di produrre un file PDF/A perché il suo preambolo è correttamente predisposto per questo scopo; carica il pacchetto \pack{pdfpages} che serve per importare tutte o una selezione di pagine di un file PDF comunque composto, dentro il file che si ottiene elaborandolo con \textcolor{red}{\prog{pdflatex.}} Se il file \file{toptesi-it.pdf} non contiene file importati con caratteristiche incompatibili, il file PDF ottenuto risulta conforme alla norma PDF/A, ma se il file di partenza conteneva collegamenti ipertestuali, il file finalmente ottenuto è privo di collegamenti ipertestuali. -Questo terzo metodo è una variante del secondo: si predispone di un piccolo file \file{toptesi-it-xetex-pax.tex}, affiancato dal solito file di metadati con il nome coerente con quello del file \file{.tex}, così composto: -\begin{verbatim} -% !TEX encoding = UTF-8 Unicode -% !TEX TS-program = pdflatex -\documentclass[a4paper]{report} -% L'ordine con cui si caricano i pacchetti è critico! -\usepackage[a-1b]{pdfx} -\usepackage{pdfpages} -\usepackage{pax} -\nofiles -\begin{document}\pagestyle{empty} -\includepdf[pages=-]{toptesi-it-xetex.pdf} -\end{document} -\end{verbatim} -che contiene in più il pacchetto \pack{pax}. Prima di comporlo si apre un terminale e si dà il comando (scritto su una sola riga): -\begin{verbatim} -pdfannotextractor toptesi-it-xetex.pdf -toptesi-it-xetex.pdf -\end{verbatim} +Ho usato come esempio il nome di questo stesso file di documentazione; il lettore campisce che si tratta solo di un esempio, perché questo documento si compila perfettamente in formato PDF/A senza ricorrere a questo procedimento; Ma, se per esempio, si fosse composta la tesi con un word processor e la si fosse esportata in formato PDF, questo procedimento potrebbe crearne la versione PDF/A compatibile senza sforzo e con la sola spesa di perdere i collegamenti ipertestuali interni. -Il comando indicato esegue uno script \prog{java} che si trova già installato con una distribuzione \TeX~Live completa e aggiornata. Esso fa rifermento anche ad un altro script in Perl, e alla fine dell'esecuzione produce un file \file{toptesi-it-xetex.pax} che contiene le informazioni relative ai collegamenti ipertestuali. A questo punto si compila almeno due volte il file \file{toptesi-it-xetex-pax.tex} e quello che si ottiene dovrebbe essere un file PDF/A contenente anche i collegamenti ipertestuali. +Più comodamente i procedimenti descritti in questi ultimi due paragrafi possono servire per aggiungere quanto manca, per esempio, ad una figura PDF per verificarne la conformità oppure per scoprirne le cause di non conformità per eventualmente modificarla in modo che sia compatibile tanto da poterla includere nella tesi vera e propria. Per esperienza diretta io preferisco seguire il procedimento che ricorre al pacchetto \pack{pdfpages}. -La documentazione del pacchetto \pack{pax} è molto ``essenziale'', anche perché esemplifica le procedure per installare il software necessario riferendosi soltanto ad una piattaforma Linux. In realtà in pacchetti e gli script da usare possono essere tranquillamente gestiti anche sulle altre piattaforme, perché gli interpreti \prog{Java} e \prog{Perl} sono disponibili per tutte le piattaforme, tuttavia le operazioni di installazione non sono semplici e vanno eseguite con molta cura. -\fi %Fine metacommanto +\subsubsection[Non usare \texorpdfstring{\pack}{}{pax} e \texorpdfstring{\pack}{}{pdfpages} assieme]{Non usare i due pacchetti \pack{pax} e \pack{pdfpages} assieme allo scopo di conservare i collegamenti ipertestuali} +Il pacchetto \pack{pax} è stato costruito per ridare funzionalità ai collegamenti ipertestuali contenuti in file PDF immessi completamente o in parte dentro altri file PDF. Funziona perfettamente, ma il pacchetto \pack{pdfx} non riesce a gestire le operazioni del pacchetto \pack{pax}, per cui tutte le informazioni relative ai collegamenti vengono ripristinate, ma il file complessivo non rispetta le specifiche della norma PDF/A e gli errori segnalati dalla funzione Preflight di Adobe Acrobat Pro~XI riguardano solo gli hyperlink, quando invece lo stesso file PDF ricomposto solo con l'uso di \pack{pdfx} e \pack{pdfpages} è perfettamente conforme con le norme PDF/A, anche se i suoi link non sono attivi. -\subsection{\texorpdfstring{\prog}{}{lualatex} e il formato PDF/A}\label{sec:LuaPDFA} -Questo paragrafo è un po' strano, visto che precedentemente si è detto di trattare i file prodotti con \LaTeX\ come quelli prodotti con \XeLaTeX. L'affermazione è vera, ma forzando un poco le cose si riesce ad ottenere direttamente un file PDF/A anche con \LuaLaTeX. - -Ci sono alcune trappole in \pack{pdfx} che impediscono a \LuaLaTeX di funzionare correttamente senza segnalare errori di ``Undefined control sequence'' e simili; si potrebbe lasciare correre e al primo arresto del programma si potrebbe rispondere inserendo il carattere \verb|S| nella console in risposta al punto interrogativo del messaggio d'errore; la compilazione andrebbe alla fine senza ulteriori problemi, ma la cosa è particolarmente fastidiosa. - -Suggerisco allora di crearsi una versione modificata di \pack{pdfx} seguendo le indicazioni seguenti: -\begin{enumerate}[noitemsep] -\item Si copi il file \file{pdfx.sty} e lo si salvi con un nome diverso, per esempio \file{mypdfx.sty} nella cartella di lavoro o in una cartella appositamente predisposta nel proprio albero personale; in questo caso con \MiKTeX\ è necessario aggiornare il database dei nomi dei file con i comandi di cui quella distribuzione dispone. È chiaro che nel preambolo bisogna poi caricare il pacchetto \pack{mypdfx} che sarebbe bene che sia modificato in modo da restare compatibile con la compilazione mediante \pdfLaTeX. -% -\item Modificare il nuovo pacchetto \pack{mypdfx} introducendo el seguenti modifiche. -\begin{quote} -Dopo le righe: -\begin{Verbatim}[fontsize=\small] -\ProvidesPackage{pdfx} - [2015/02/17 v1.5.3 PDF/X and PDF/A support (CVR/HTH/RRM/PS)] -\end{Verbatim} -inserire il codice seguente: -\bgroup \color{red}% -\begin{verbatim} -\RequirePackage{iftex}% - -\ifLuaTeX - \unless\ifcsname pdfmdfivesum\endcsname - \RequirePackage{pdftexcmds}% - \let\pdfmdfivesum\pdf@mdfivesum\fi -\fi -\end{verbatim} -\egroup -Il pacchetto \pack{iftex} serve per distinguere con quale motore di composizione si sta lavorando e definisce gli switch \cs{ifPDFTeX}, \cs{ifXeTeX} e \cs{ifLuaTeX} come veri o falsi a seconda del motore usato; infatti nel codice precedente le tre righe sono eseguite solo se si sta lavorando con \LuaLaTeX. -\end{quote} -Questa è la ragione di (modesta) incompatibilità fra \pack{pdfx} e \LuaLaTeX. - -Merita però osservare che se la data del vostro pacchetto \pack{pdfx} è posteriore a quella indicata sopra, è possibile che non sia necessaria nessuna modifica; quindi prima di procedere con queste modifiche si provi ad eseguire \LuaLaTeX\ sul file principale della tesi avendo specificato il normale pacchetto \pack{pdfx} e si veda se la compilazione procede senza errori; se viene comunicato che \cs{pdfmdfivesum} è una ``Undefined control sequence'', allora le modifiche sopra indicate sono necessarie. -% -\item Lo ripeto: il pacchetto \pack{mypdfx} è ora compatibile sia con \pdfLaTeX\ sia con \LuaLaTeX, e può essere usato per comporre file PDF/A sia con l'uno sia con l'altro programma. -% -\item Non usare né \pack{pdfx} né \pack{mypdfx} se si compila il documento con \XeLaTeX. -\end{enumerate} - -Si predisponga il preambolo del file sorgente come se lo si dovesse predisporre per \XeLaTeX; font, scelta delle lingue, eccetera, ma si aggiunga anche la chiamata al pacchetto \pack{mypdfx} come si è fatto (o si può fare) per compilare con \pdfLaTeX. Si predisponga il file di metadati come in quel caso. - -Si compili ora il file principale del documento come si è fatto con \pdfLaTeX; la compilazione comincerà e procederà fino alla fine senza interruzioni. - -Se il file sorgente e i file inclusi, figure comprese, erano conformi con le specifiche del formato PDF/A-1b, il file PDF in uscita risulta conforme alle norme. Preflight lo conferma e può aggiungere la dichiarazione di conformità ai metadati contenuti nel file. - -Questo risolve il problema e se c'erano motivi validi per scegliere di comporre il testo con \XeLaTeX\ o \LuaLaTeX, la soluzione con \LuaLaTeX\ può risultare conforme alle norme, purché, evidentemente, i file sorgente non immettano qualcosa di proibito all'interno del file di uscita. - -È vero, dunque, che il pacchetto \pack{pdfx} è incompatibile con \LuaLaTeX\ ma non lo è così tanto da non poter essere usato con piccoli ritocchi per produrre un documento conforme alle norme PDF/A, pur avendo usato funzionalità estese rispetto all'uso dei font OpenType e alla gestione delle lingue da scrivere con alfabeti molto diversi dall'alfabeto latino che si usa normalmente. \section{Verifica della conformità} @@ -1794,28 +1790,28 @@ Bisogna innanzi tutto disporre degli strumenti per verificare se un file è conf In rete ci sono siti dove viene eseguita la verifica della conformità di un file PDF con la norma del sotto"formato PDF/A-1b, ma di solito l'esito della verifica è negativo, per lo meno a me non è mai capitato che un file conforme venisse riconosciuto tale mediante le verifiche in rete. Per verificare in modo serio la conformità ci sono due strade che non si escludono a vicenda. -\begin{enumerate}[noitemsep] +\begin{enumerate} \item Si cerca in dipartimento una stazione di lavoro dove un computer sia dotato del programma commerciale {Adobe Acrobat Pro XI}; spesso i dipartimenti dispongono di licenze multiple, oppure è possibile che un ricercatore dia una mano lasciando usare un suo calcolatore sul quale è montato il software indicato. Si procede poi come indicato qui di seguito. -\item La Adobe, come molte altre imprese produttrici di software, dispone di un programma \emph{Education} che consente agli studenti e ai docenti di università e scuole secondarie superiori di acquistare i loro software a prezzi molto, molto vantaggiosi. Io come privato cittadino non mi sarei mai comprato l'Adobe Acrobat Pro XI se non avessi avuto la possibilità di avvantaggiarmi di questa offerta vantaggiosissima; come professore ho potuto farlo senza bisogno di ricorrere ad una versione fornitami dal Politecnico sotto una sua licenza multipla. +\item La Adobe, come molte altre imprese produttrici di software, dispone di un programma \emph{Education} che consente agli studenti e ai docenti di università e scuole secondarie superiori di acquistare i loro software a prezzi molto, molto vantaggiosi. Io come privato cittadino non mi sarei mai comprato l'Adobe Acrobat Pro~XI se non avessi avuto la possibilità di avvantaggiarmi di questa offerta vantaggiosissima, ma come professore ho potuto farlo senza bisogno di ricorrere ad una versione fornitami dal Politecnico sotto una sua licenza multipla. \end{enumerate} -Disponendo dunque di Adobe Acrobat Pro XI, si apre il file PDF (precedentemente caricato su una chiavetta se si deve ricorrere ad un calcolatore dipartimentale o comunque a un calcolatore non proprio), si va nella voce di menù \textsf{Edit} e si sceglie l'opzione \textsf{Preflight}; nella finestrina che si pare si sceglie la voce \textsf{PDF/A compliance} e sotto questa la voce \textsf{Verify compliance with PDF/A-1b}; poi si clicca sul bottone \textsf{Analyse}; dopo pochi secondi si apre una seconda finestrina dove appare il risultato dell'analisi. Se il risultato è positivo si ha la possibilità di appendere ai metadati il risultato dell'analisi e il file è definitivamente pronto e certificato come conforme alla norma PDF/A-1b. +Disponendo dunque di Adobe Acrobat Pro XI, si apre il file PDF precedentemente caricato su una chiavetta, si va nella voce di menù \textsf{Edit} e si sceglie l'opzione \textsf{Preflight}; nella finestrina che si apre si sceglie la voce \textsf{PDF/A compliance} e sotto questa la voce \textsf{Verify compliance with PDF/A-1b}; poi si clicca sul bottone \textsf{Analyse}; dopo pochi secondi si apre una seconda finestrina dove appare il risultato dell'analisi. Se il risultato è positivo il file è definitivamente pronto come conforme alla norma PDF/A-1b. Se invece l'analisi indicasse errori, bisogna provvedere a correggerli; è vero che nella stessa finestrina c'è anche il bottone \textsf{Analyse and fix}, ma l'operazione di ``aggiustamento'' di solito riesce a correggere errori molto veniali, quindi con i programmi di composizione del sistema \TeX\ (col quale non si compiono errori veniali) questo aggiustamento è raro che abbia successo. Bisogna avere pazienza e cercare di leggere con attenzione i messaggi di diagnostica che \textsf{Preflight} produce. Se mancano i metadati e/o il profilo di colore, significa che il file non è stato prodotto con le procedure descritte nei paragrafi precedenti. Gli errori che restano sono di solito dei tipi seguenti. -\begin{enumerate}[noitemsep] +\begin{enumerate} \item Se è stato specificato un profilo di colore CMYK (celeste, lilla, giallo, nero) si è fatto un errore nello specificare il profilo di colore oppure si è inserita un'immagine a colori che è colorata con lo schema CMYK. Nel primo caso è bene verificare di avere specificato il profilo giusto. Nel secondo caso bisogna convertire il profilo di colore mediante qualsiasi programma di fotoritocco; segnalo il programma aperto e libero GIMP (GNU Image Management Program), disponibile per le tre piattaforme più comuni e i sistemi operativi Mac, Windows e Linux. Esso è in grado di aprire immagini in ``qualsiasi'' formato bitmapped o vettoriale, di elaborarlo secondo i desideri dell'utente, per poi salvarlo in qualsiasi formato bitmapped, ma non nei formati vettoriali. % \item Alcuni font hanno glifi di larghezza nulla, fra questi ci sono almeno due glifi della famiglia matematica \texttt{cmsym}; \pack{toptesi} provvede già da solo a sostituire questi glifi con altri simili o con disegni, in modo da correggere l'errore; tuttavia questi glifi potrebbero essere presenti in file importati. % -\item Alcune figure sia raster (a cui siano state sovrapposte legende testuali con caratteri vettoriali) sia vettoriali (che contengono legende testuali) possono mancare dell'inclusione dei font; per cui quando queste immagini vengono immesse nel file PDF che si vorrebbe conforme con la norma, questa conformità viene a mancare. Se si sono prodotti direttamente tali file da includere, bisogna avere cura di far sì che tutti i glifi dei font usati nel file da includere siano essi stessi inclusi direttamente; esattamente com ho fatto con i loghi \GuIT\ e \MP\ di cui ho detto prima. Purtroppo questo è un caso molto frequente; quindi capita sovente di dover procedere alla correzione di questi file. +\item Alcune figure sia raster (a cui siano state sovrapposte legende testuali con caratteri vettoriali) sia vettoriali (che contengono legende testuali) possono mancare dell'inclusione dei font; per cui quando queste immagini vengono immesse nel file PDF che si vorrebbe conforme con la norma, questa conformità viene a mancare. Se si sono prodotti personalmente tali file da includere, bisogna avere cura di far sì che tutti i glifi dei font usati nel file da includere siano essi stessi inclusi direttamente; esattamente com ho fatto con i loghi \GuIT\ e \MP\ di cui ho detto prima. Purtroppo questo è un caso molto frequente; quindi capita sovente di dover procedere alla correzione di questi file. -Per le figure con legende testuali, basta convertire l'intera figura nel formato \file{.png} (se contiene disegni al tratto) oppure \file{.jpg} se contiene colori sfumati) e il gioco è fatto. +Per le figure con legende testuali, basta convertire l'intera figura nel formato \file{.png} (se contiene disegni al tratto e purché non contenga trasparenze) oppure \file{.jpg} se contiene colori sfumati) e il gioco è fatto. -Ma se si vuole mantenere la natura vettoriale si potrebbe usare il programma gratuito \prog{Inkscape} che è in grado di aprire file vettoriali (PDF, EPS, PS) e di trasformarli in file con le estensioni vettoriali, ma dopo aver trasformato i caratteri nelle loro outline, cioè nei disegni dei contorni dei glifi, riempiti dello stesso colore che avevano quei glifi nella figura originale. Spesso questa trasformazione va a buon fine. +Ma se si vuole mantenere la natura vettoriale si potrebbe usare il programma gratuito \prog{Inkscape} che è in grado di aprire file vettoriali (PDF, EPS, PS) e di trasformarli in file con le estensioni vettoriali, avendo trasformato nel contempo i caratteri nelle loro outline, cioè nei disegni dei contorni dei glifi, riempiti dello stesso colore che avevano quei glifi nella figura originale. Spesso questa trasformazione va a buon fine. Come esperienza personale ritengo che sia opportuno convertire ogni figura vettoriale con i glifi sostituiti dai loro contorni, solo nel formato EPS, che non gestisce le trasparenze, gestite, invece, dal formato \file{.pdf}. In questo modo i tre programmi che ci interessano, \prog{pdflatex}, \prog{xelatex} e \prog{lualatex}, sono tutti e tre in grado di ricevere figure in formato \file{.eps}, e di incorporarlo nel file PDF in uscita. In questo modo si è sicuri di poter evitare le trasparenze, che sono vietate con il formato PDF/A-1b. \end{enumerate} @@ -1823,6 +1819,7 @@ Come esperienza personale ritengo che sia opportuno convertire ogni figura vetto Come si vede, dunque, la produzione di un file conforme alla norma PDF/A non è una operazione semplice e senza disporre di Adobe Acrobat Pro XI si consuma molto tempo a ricorrere a postazioni di lavoro esterne, dovendo chiedere favori a laboratori o ad altre persone. Però se si osservano le indicazioni di questo paragrafo, è possibile che il file della tesi sia conforme alla norma fin dal primo momento. Questa stessa guida è stata prodotta con questo tipo di correzioni, ma io sono avvantaggiato perché dispongo personalmente del software necessario alla verifica. + \chapter{I comandi specifici introdotti da \textsf{TOPtesi}}\label{cap:comandispecifici} \section{Introduzione} @@ -1846,7 +1843,6 @@ state usate diverse, ma qui forse vale la pena di elencarle tutte in ordine, senza ripetere le opzioni già definite per la classe \class{report}. - \begin{description}\def\Item[#1]{\item[\normalfont\opt{#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 \cs{usepackage}. Si abbia cura di leggere attentamente la documentazione di quel pacchetto. Alternativamente si può usare il pacchetto \pack{biblatex} (con la bibliografia da elaborare con il programma esterno \prog{biber}); bisogna specificargli opportune opzioni e si possono comporre direttamente bibliografie distinte per capitoli; si legga con attenzione la documentazione di \pack{biblatex}. % @@ -1856,7 +1852,7 @@ 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 comandi disponibili quando questa opzione è attivata. % -\Item[cucitura] Serve per spostare il testo scritto verso l'esterno +\Item[cucitura] Serve per spostare il blocco del testo 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. Con legature eseguite bene, questa correzione non è necessaria; si ritiene che possa essere utile quando la tesi cartacea viene spillata. @@ -1864,11 +1860,11 @@ vicino al margine interno. Con legature eseguite bene, questa correzione non è \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 +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 gli avvisi +adeguati e/o producano righe non giustificate con gli avvisi ``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 @@ -1882,7 +1878,8 @@ titolo si abbia l'accortezza di inserire il segno di legatura 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 +\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 @@ -1898,23 +1895,13 @@ 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 +pagine con le cifre minuscole o 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. +\Item[pdfa] Prima della distribuzione di \TeXLive 2016 il pacchetto \pack{pdfx} doveva essere caricato dalla classe, non nel preambolo del documento come si può fare ora con la distribuzione aggiornata di \TeXLive. Per compatibilità con il passato, l'opzione esiste ancora, ma produce solo un avviso e non carica \pack{pdfx}. % -\Item[noTOPfront] e \opt{usefrontespizio} sono opzioni equivalenti; servono per evitare il caricamento del pacchetto nativo di TOPtesi, \pack{topfront} in modo da poter comporre il frontespizio con pacchetti esterni, evitando conflitti con quei pacchetti. +\Item[noTOPfront] e \opt{usefrontespizio} sono opzioni equivalenti; servono per evitare il caricamento del pacchetto nativo di TOPtesi, \pack{topfront}, in modo da poter comporre il frontespizio con pacchetti esterni, evitando conflitti con quei pacchetti. \end{description} @@ -1924,6 +1911,7 @@ 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}} +\caption{Comandi di tipo generale}\label{tab:generale} \centering \footnotesize \begin{tabular}{llp{.26\textwidth}p{.30\textwidth}} \toprule @@ -1964,23 +1952,25 @@ modo matematico. Essi sono raccolti nella tabella~\ref{tab:generale}. \cs{listing}\Arg{...}& nessuno & Listato di un programma in caratteri typewriter & \texttt{\string\listing\string{toptesi.tex\string}}\\ -\cs{blankpagestyle}\Arg{...}&plain & impostazione dello stile della pagina eventualmente +\cs{blankpagestyle}\Arg{...}&plain & Impostazione dello stile della pagina eventualmente emessa da \cs{cleardoublepage} quando deve passare ad una pagina dispari in composizione fronte retro & \cs{blankpagestyle}\Arg{empty}\\ \cs{ifTOPfront} & true & Viene impostato a false quando viene specificata l'opzione \opt{noTOPfront};\ può essere usato per specificare azioni diverse a seconda del tipo di - frontespizio da comporre& \\[.5ex] + frontespizio da comporre&\\ +\cs{goodpagebreak}\Oarg{...} + & 4 & Inserisce un fine pagina condizionale; l'argomento facoltativo serve per specificare il numero di righe necessarie prima della fine pagina condizionale + &\cs{goodpagebreak}\Oarg{5}\\[.5ex] \bottomrule \end{tabular} -\caption{Comandi di tipo generale}\label{tab:generale} \end{table} {\tolerance=6000 Vale la pena di commentare sull'uso dell'ambiente \amb{interlinea} e del comando \cs{interlinea}. Il primo confina il suo effetto all'interno dell'ambiente da lui stesso formato; il secondo agisce come una dichiarazione che resta -in vigore finché una dichiarazione contraria non ne modifica il +in vigore finché una dichiarazione contraria non ne modifichi il valore.\par} \textcolor{red}{Tuttavia sia l'ambiente sia il comando non dovrebbero essere mai usati!} @@ -1994,17 +1984,17 @@ 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} o \emph{scartamento}, ma spesso viene chiamato impropriamente \emph{interlinea}; questo avanzamento a seconda del font in uso può essere dal 10\% al 20\% maggiore del corpo del font usato. +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{scartamento} o \emph{avanzamento di riga}, ma spesso viene chiamato impropriamente \emph{interlinea}; questo scartamento 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 (o scartamento) è di 14,5\,pt; si dice che questo testo è composto in corpo 12/14,5. +Questa documentazione è scritta in corpo 12\,pt e lo scartamento è di 14,5\,pt; si dice che questo testo è composto in corpo 12/14,5. \begin{interlinea}{1.05} -L'interlinea, come suggerisce il nome, 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 \cs{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'\emph{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 \amb{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. +L'interlinea, come suggerisce il nome, 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 \cs{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 dello \emph{scartamento}; porre questo fattore al valore \texttt{1.05} vuol dire moltiplicare lo scartamento per 1,05 portandolo quindi al valore di 15,5225\,pt. Questo capoverso è composto con questo fattore impostato con l'ambiente \amb{interlinea} e, nonostante si tratti solo di un aumento del 5\% dello scartamento, 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 +l'avanzamento otticamente ottimale; se si desidera usare un font +diverso da quello di default, si potrebbe, per esempio, invocare il pacchetto \Font{newpxtext} per usare il Palatino esteso come font di testo. Siccome questo font a pari corpo ha le minuscole più grandi di quelle dei font di default, potrebbe @@ -2013,51 +2003,69 @@ del fattore di \amb{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 su carta delle bozze scritte abbastanza +Se proprio si vuole stampare su carta delle bozze scritte abbastanza larghe per potervi inserire le correzioni e le annotazioni a mano, -allora impostate il fattore di \amb{interlinea} al massimo a +allora si imposti il fattore di \amb{interlinea} al massimo a \texttt{1.5}, ma quando stampate la bella copia, la versione finale, ricordatevi di re-impostare per \amb{interlinea} il valore unitario di default. -Tra l'altro non vorreste mica usare l'espediente di un grande fattore +Tra l'altro non si vuole 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 80~anni! +sguardo. Ricordate che alcune tesi svolte all'inizio degli anni 20 e non superavano le 30~pagine dattiloscritte o scritte a mano (!) e sulle quali +si sta studiando ancora oggi dopo più di 80~anni! Vale la pena di commentare il misterioso comando \cs{blankpagestyle}. Quando si compone fronte e retro senza usare l'opzione di classe \opt{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: +Fino alla versione 0.62 di TOPtesi, 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 completamente bianca e non contenga nemmeno il piedino; ecco, in questo caso basta specificare: \begin{flushleft}\ttfamily \cs{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 gli stili \texttt{plain} o \texttt{empty} e gli altri stili che contengono sempre le testatine, eventualmente ridotte al solo loro filetto. +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 i due stili \texttt{plain} e \texttt{empty} rispetto agli altri stili che contengono sempre le testatine, eventualmente ridotte al solo loro filetto. Se lo si vuole usare, consiglio di farlo subito dopo \cs{begin}\Arg{document}. -Se invece si desidera lasciare il valore di default a \texttt{plain} e usare saltuariamente un altro stile, si usi esplicitamente il comando \cs{cleradoublepage} specificando lo stile desiderato come comando facoltativo, per esempio: +Se invece si desidera lasciare il valore di default a \texttt{plain} e usare saltuariamente un altro stile, si usi esplicitamente il comando \cs{cleradoublepage} specificando lo stile desiderato come argomento facoltativo, per esempio: \begin{verbatim} \cleardoublepage[empty] \end{verbatim} -{\tolerance=3000 Riassumendo: per una pagina veramente vuota sempre e in ogni caso; si specifichi +Riassumendo: per una pagina veramente vuota sempre e in ogni caso; si specifichi \begin{verbatim} \blankpagestayle{empty} \end{verbatim} -subito dopo \cs{begin}\Arg{document}. Se si desidera una pagina vuota saltuariamente si espliciti il comando \cs{cleardoublepage} con l'argomento facoltativo \texttt{empty}. Se si desidera modificare lo stile della pagina bianca quando il comando \cs{cleardoublepage} è emesso da uno specifico comando \cs{part} o uno specifico comando \cs{chapter} si usi \cs{blanckpagestyle}\texttt{[empty]} prima di quel comando di sezionamento e poi lo si usi di nuovo come \cs{blankspagestyle}\texttt{[plain]}.\par} +subito dopo \cs{begin}\Arg{document}. + +Se si desidera una pagina vuota saltuariamente si espliciti \cs{cleardoublepage} con l'argomento facoltativo \texttt{empty}. Se si desidera modificare lo stile della pagina bianca quando il comando \cs{cleardoublepage} è emesso da uno specifico comando \cs{part} o uno specifico comando \cs{chapter} si usi \cs{cleardoublepage}\texttt{[empty]} \emph{subito prima} di quel comando di sezionamento. + +Qualche annotazione va fatta per il comando \cs{goodpagebreak}. Il nucleo di \LaTeX\ contiene il comando \cs{goodbreak} che dovrebbe impostare un consenso di eseguire un fine pagina impostando una penalità molto piccola negativa, più o meno simile a quello che fa il comando \cs{pagebreak}\Oarg{1}. In realtà questo comando nativo di Plain \TeX, conservato in \LaTeX, di fatto non funziona come ci si aspetterebbe. Il comando di questa classe, \cs{goodpagebreak} procede in un altro modo, anche perché si comporta in modo diverso se vene specificato in modo verticale o in modo orizzontale. +Infatti in modo orizzontale inserisce incondizionatamente un comando \cs{vadjust} il cui argomento vale esattamente \cs{newpage} incondizionato quando la \emph{riga} che lo contiene viene scritta nel file di uscita; si dovrà porre un minimo di attenzione a fare sì che lo spazio alla fine della macro non elimini spazi interparola, né introduca spazi spuri; quando lo si usa, quindi, sarà opportuno lasciare uno spazio prima e dopo la macro, per esempio \begin{flushleft}\verb*|...prima \goodpagebreak di...|\end{flushleft} Vale la pena di usare questo comando in certi casi in cui la bozza mostra un salto pagina prima dell'ultima riga di un capoverso, cioè quando viene prodotta una riga vedova; quando si corregge la bozza si cerca il testo delala riga prima di quella vedova e si inserisce la macro fra due parole qualsiasi di quel testo. È evidente che se si modifica il capoverso e non c'è più bisogno del salto pagina incondizionato, bisogna cancellare la macro da quella posizione. + +In modo verticale, invece, viene calcolata la differenza fra le lunghezze \cs{pagegoal} e \cs{pagetotal}; la prima corrisponde più o meno a \cs{textheight} diminuita dello spazio riservato alle note in calce e del loro spazio di separazione dal testo; è insomma l'obbiettivo per raggiungere la giusta altezza del testo; la seconda lunghezza è la lunghezza netta del testo raggiunta fino a quel momento; se questa differenza è \emph{non maggiore} (che per la sintassi nativa di \TeX\ vuol dire \emph{minore o uguale} al numero di righe specificate di default (4 righe) o specificate mediante l'argomento facoltativo, allora viene inserito un salto pagina incondizionato. Vale la pena servirsi di questo comando in modo verticale quando un oggetto relativamente grande e indivisibile viene rinviato alla pagina successiva, così da obbligare \LaTeX\ a stiracchiare lo spazio elastico verticale al fine di giustificare la pagina che precede il salto pagina. + +Questa spiegazione contorta descrive una situazione piuttosto frequente che si manifesta prima dei titoli di sezioni, sottosezioni, e simili. Infatti ogni titolo è separato da un certo spazio dal testo che inizia la sezione e siccome le righe orfane sono tipograficamente molto sgradevoli (meno delle righe vedove, ma comunque sgradevoli), il titolo della sezione deve essere seguito da almeno due righe di testo. Quindi il titolo della sezione, lo spazio verticale di separazione e le due righe di testo formano un blocco di almeno 4~righe; se non ci stanno in fondo alla pagina, \LaTeX\ manda tutto questo blocco alla pagina successiva, stiracchiando gli spazi verticali della pagina corrente. Mettendo la macro \cs{goodpagebreak} prima del titolo di quella sezione che viene rinviata alla pagina successiva, si produce una pagina mozza, ma non troppo, e senza spazi stiracchiati, seguita da una pagina che inizia con il titolo della nuova sezione; ecco come fare. +\begin{verbatim} +... fine dell'ultimo capoverso. + +\goodpagebreak + +\section{...} +\end{verbatim} + +L'algoritmo non è infallibile, ma funziona quasi sempre; può talvolta succedere che il fine pagina produca una pagina quasi vuota e la nuova sezione cominci dopo questa pagina; questo inconveniente è causato dal modo asincrono con cui vengono composte le pagine del file di uscita rispetto alla sequenza di capoversi che creano la bozza non impaginata; in sostanza il funzionamento asincrono fra la composizione del testo, il \emph{paragraph builder} e il \emph{page builder}. La cosa è difficile da spiegare in questa documentazione e la si rimanda alla guida tematica \emph{Il \LaTeX\ Reference Manual commentato} liberamente scaricabile dal sito \url{www.guitex.org}. Ma in questi rari casi la soluzione consiste nello spostare \cs{goodpagebreak} in modo orizzontale fra le parole della penultima riga prima di questo salto pagina mal gestito. +Il lettore non si scoraggi: questi sono ritocchi destinati a rifinire la tesi quando la si è sostanzialmente completata. In questa documentazione non ho mai usato \cs{goodpagebreak} in modo orizzontale e l'ho usato in modo verticale solo due tre volte. \section{Comandi per il frontespizio} -\textcolor{red}{Questo paragrafo descrive i comandi per comporre il frontespizio con il pacchetto \pack{topfront}, nativo della classe \class{toptesi}. Se si vuole comporre il frontespizio con una altro pacchetto, non si usino questi comandi ma quelli descritti nella documentazione del pacchetto alternativo. Naturalmente si sarà specificata l'opzione \opt{noTOPfront} fra le opzioni della classe, al fine di evitare conflitti con i pacchetti esterni.} +\textcolor{red}{Questo paragrafo descrive i comandi per comporre il frontespizio con il pacchetto \pack{top"front}, nativo della classe \class{toptesi}. Se si vuole comporre il frontespizio con un altro pacchetto, non si usino questi comandi ma quelli descritti nella documentazione del pacchetto alternativo. Naturalmente si sarà specificata l'opzione \opt{noTOPfront} fra le opzioni della classe, al fine di evitare conflitti con i pacchetti esterni.} {\tolerance=3000\textcolor{red}{I comandi per la composizione del frontespizio \emph{non possono} essere inseriti nel preambolo, cioè prima di \cs{begin}\Arg{document}, qualunque sia il programma di compilazione usato, perché nessuno di quei comandi è definito prima di che il modulo \pack{topfront} sia stato eventualmente caricato, il che avviene solo al momento di eseguire il comando \cs{begin}\Arg{document}; se si specifica l'opzione \opt{noTOPfront} il modulo \pack{topfront} non viene nemmeno caricato.}\par} -È per questo che si consiglia di usare facoltativamente il file di configurazione e comunque tutti i comandi necessari per il frontespizio, non presenti nel file di configurazione all'interno, all'interno dell'ambiente \amb{frontespizio} o \amb{frontespizio*}. In questo modo non si corre il rischio di inserirli nel preambolo. Se poi si usa un pacchetto esterno per comporre il frontespizio, a maggior ragione bisogna specificare i comandi necessari come specificato nella documentazione di quel pacchetto esterno. +È per questo che si consiglia di usare facoltativamente il file di configurazione e comunque tutti i comandi necessari per il frontespizio, non presenti nel file di configurazione, all'interno dell'ambiente \amb{frontespizio} o \amb{frontespizio*}. In questo modo non si corre il rischio di inserirli nel preambolo. Se poi si usa un pacchetto esterno per comporre il frontespizio, a maggior ragione bisogna specificare i comandi necessari come specificato nella documentazione di quel pacchetto esterno. -Con le ultime variazioni della versione 5.85 e successive, lo si ripete, la cosa migliore da fare è quella di usare questi comandi dentro uno degli ambienti \amb{frontespizio} o \amb{frontespizio*}; si pigliano due piccioni con una fava; siccome questi ambienti compongono direttamente il frontespizio, essi devono trovarsi dopo \cs{begin}\Arg{document} e questo va bene sia per \pdfLaTeX\ sia per \XeLaTeX. +Con le variazioni di TOPtesi a partire dalla versione 5.85, lo si ripete, la cosa migliore da fare è quella di usare questi comandi dentro uno degli ambienti \amb{frontespizio} o \amb{frontespizio*}; si pigliano due piccioni con una fava; siccome questi ambienti compongono direttamente il frontespizio, essi devono trovarsi dopo \cs{begin}\Arg{document} e questo va bene sia per \pdfLaTeX\ sia per \LuaLaTeX. I comandi di questa sezione possono essere introdotti in un ordine qualunque, ma è più chiaro se sono introdotti nell'ordine in cui sono elencati nelle tabelle~\ref{tab:front1}-\ref{tab:front4} riportate dalla pagina~\pageref{tab:front1} alla pagina~\pageref{tab:front4}. @@ -2068,7 +2076,7 @@ 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 +alla monografia di laurea, o alla tesi laurea, o alla dissertazione di dottorato. La differenza è che generalmente la monografia di laurea non ha @@ -2094,7 +2102,7 @@ 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''.}: -\begin{verbatim} +\begin{verbatim}\begin{frontespizio} \NomeMonografia{Manuale d'uso} \monografia{La classe \textsf{TOPtesi}} \sottotitolo{Per comporre le tesi al Poli\\ @@ -2103,8 +2111,7 @@ tabelle citate\footnote{In verità ho imbrogliato un poco. I comandi qui elencat \sedutadilaurea{Versione \fileversion} \ateneo{}% senza il nome che è già contenuto nel logo \logosede{logo_blu} - - \frontespizio + \end{frontespizio} \end{verbatim} \begin{figure}[p]\centering @@ -2114,7 +2121,7 @@ tabelle citate\footnote{In verità ho imbrogliato un poco. I comandi qui elencat Vale la pena di fare le seguenti osservazioni. \begin {enumerate} -\item Se si usa l'ambiente \amb{frontespizio} o il comando \cs{frontespizio} il logo viene messo in testa; se si usa la forma asteriscata dell'ambiente \amb{frontespizio*} il logo viene messo nella metà inferiore della pagina del titolo. Se il logo dell'ateneo contiene per disteso il logotipo, cioè il nome per disteso, allora l'uso del comando \cs{ateneo} contenente il nome generico dell'ateneo implica una ridondanza di informazioni che potrebbe anche essere antiestetica; quindi +\item Se si usa l'ambiente \amb{frontespizio} o il comando \cs{frontespizio} il logo viene messo in testa; se si usa la forma asteriscatadel comando o l'ambiente \amb{frontespizio*} il logo viene messo nella metà inferiore della pagina del titolo. Se il logo dell'ateneo contiene per disteso il logotipo, cioè il nome per disteso, allora l'uso del comando \cs{ateneo} contenente il nome generico dell'ateneo implica una ridondanza di informazioni che potrebbe anche essere antiestetica; quindi se si usa il comando \cs{ateneo} sarebbe meglio usare l'ambiente \amb{frontespizio*}, e viceversa. Ma questa possibilità di scelta per la posizione del logo e la presenza del nome dell'ateneo consente di rispettare le diverse specifiche indicate dalle segreterie didattiche degli atenei; si veda la tabella riassuntiva~\ref{tab:modalitaperfrontespizi} nella pagina~\pageref{tab:modalitaperfrontespizi}. % \item \cs{titolo} non deve @@ -2141,7 +2148,7 @@ Il \meta{numero di matricola} non è quasi mai necessario, quindi la sequenza \c % \item Per la monografia l'informazione della data può essere omessa se non c'è una data per la presentazione. % -\item Il pacchetto 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 \class{toptesi}. Ogni laureando è quindi tenuto a chiedere il logo alla sua università accettandone tutte le limitazioni d'uso che l'università potrebbe imporgli. +\item Il pacchetto TOPtesi inizialmente veniva distribuito con un certo numero di loghi di università italiane e straniere. La politica di \TeXLive è 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 \class{toptesi}. Ogni laureando è quindi tenuto a chiedere il logo alla sua università accettandone tutte le limitazioni d'uso che l'università potrebbe imporgli. \end{enumerate} Per quanto riguarda i loghi, la loro inserzione implica l'uso del pacchetto \pack{graphicx}, che \class{toptesi} carica di default; specificare nuovamente quel pacchetto non produce nessun danno, perché \LaTeX\ controlla da solo se lo deve caricare o non lo deve ricaricare. Però, evidentemente, lo si è già detto all'inizio, non è bene caricare una seconda volta i pacchetti che sono già stati caricati @@ -2152,19 +2159,17 @@ Per quanto riguarda i loghi, la loro inserzione implica l'uso del pacchetto \pac Per questo io preferisco usare sempre e solamente i compilatori \pdfLaTeX, \XeLaTeX\ o \LuaLaTeX. L'unico inconveniente è che non posso usare direttamente il pacchetto \pack{PSTricks}; ma finora me la sono cavata molto -bene anche senza le prestazioni di questo bellissimo pacchetto. +bene anche senza le prestazioni di questo bellissimo pacchetto. D'altra parte esistono pacchetti che consentono di usare \pack{PSTricks} anche con \pdfLaTeX e gli altri programmi; l'operazione diventa un po' più complicata ma se ne occupa direttamente il programma di tipocomposizione usato; l'utente deve solo caricare uno di quei pacchetti e seguirne le indicazioni specificate nella sua documentazione (vedi per esempio il pacchetto \pack{pdftricks} già presente in ogni installazione aggiornata e completa di \TeXLive; documentazione: \texttt{texdoc pdftricks}). \section{Altri comandi} -La classe \class{toptesi} richiede l'uso di altri comandi il più notevole dei quali è senza dubbio \cs{frontespizio} e la sua variante \cs{frontespizio*} si veda la tabella riassuntiva~\ref{tab:modalitaperfrontespizi} nella pagina~\pageref{tab:modalitaperfrontespizi}). È un comando che non vuole argomenti e che va dato all'inizio, subito dopo l'apertura del documento o all'inizio del primo file incluso dal master file. Si veda comunque la tabella~\ref{tab:comandi}. Ricordo che i comandi \cs{frontespizio} e \cs{frontespizio*} sono definiti dal pacchetto \pack{topfront}; se si vuole comporre il frontespizio con un pacchetto esterno, si è specificata l'opzione \opt{noTOPfront}, che inibisce il caricamento del pacchetto, perciò questi comandi non sono più disponibili. +La classe \class{toptesi} richiede l'uso di altri comandi il più notevole dei quali è senza dubbio \cs{frontespizio} e la sua variante \cs{frontespizio*} von i rispettivi ambienti; si veda la tabella riassuntiva~\ref{tab:modalitaperfrontespizi} nella pagina~\pageref{tab:modalitaperfrontespizi}). È un comando che non vuole argomenti e che va dato all'inizio, subito dopo l'apertura del documento o all'inizio del primo file incluso dal master file. Si veda comunque la tabella~\ref{tab:comandi}. Ricordo che i comandi \cs{frontespizio} e \cs{frontespizio*} sono definiti dal pacchetto \pack{topfront}; se si vuole comporre il frontespizio con un pacchetto esterno, si è specificata l'opzione \opt{noTOPfront}, che inibisce il caricamento del pacchetto, perciò questi comandi non sono più disponibili. La differenza fra i due comandi consiste nel fatto che \cs{frontespizio} compone il frontespizio della tesi come richiesto dal Politecnico di Torino, con il logo dell'ateneo in testa alla pagina. Invece la variante asteriscata compone il frontespizio scrivendo in testa il nome dell'ateneo e mettendo il logo nella metà inferiore della gabbia di stampa. Il risultato si vede chiaramente nella figura~\ref{fig:frontespizi}. Merita sottolineare che il formato richiesto dal Politecnico di Torino va bene nel senso che il logo di quell'ateneo contiene già il suo logotipo\footnote{Il logo del Politecnico di Torino è formato da due parti accostate con un piccolo spazio e un filetto verticale fra le due; nella parte di sinistra compare il marchio dell'ateneo, il solito simbolo tondo, mentre la parte di destra contiene il logotipo, cioè il nome \textsf{POLITECNICO DI TORINO} su due righe scritto con certi font e con un colore particolare; font e colore non possono venire modificati, pena la violazione d'uso del logo.}. Sarebbe quanto mai inestetico se in testa al frontespizio comparisse due volte il nome del Politecnico; quindi non è strano che l'intestazione della tesi contenga formalmente solo il logo. Lo stesso potrebbe essere fatto, per esempio, con i loghi di diverse università, per esempio quello dell'Università di Torino, di Ca' Foscari a Venezia, di Bologna, dell'Università Cattolica, di Padova, oltre al logo del Politecnico di Milano, giusto per citarne alcuni, perché contengono il marchio e il logotipo. -Per le università che hanno un nome proprio, come per esempio \emph{Tor Vergata} per la seconda università di Roma ma, che io sappia, non hanno il logotipo nel loro logo, sarebbe quanto mai inestetico usare il logo sopra, in testa, poi il nome proprio, poi tutto il resto; io non consiglierei mai di usare \cs{frontespizio} in questi casi, ma userei solo \cs{frontespizio*} o l'ambiente corrsipondente. - -Ovviamente perché il comando esegua il suo compito, tutte le informazioni rilevanti devono già essere state scritte prima di dare il comando \cs{frontespizio} o nel file di configurazione o nel preambolo. +Per le università che hanno un nome proprio, come per esempio \emph{Tor Vergata} per la seconda università di Roma ma, che io sappia, non hanno il logotipo nel loro logo, sarebbe quanto mai inestetico usare il logo sopra, in testa, poi il nome proprio, poi tutto il resto; io non consiglierei mai di usare \cs{frontespizio} in questi casi, ma userei solo \cs{frontespizio*} o l'ambiente corrispondente. Nella figura~\ref{fig:frontespizi} nella pagina~\pageref{fig:frontespizi} sono riportati quattro esempi di frontespizi relativi ai tipi di tesi seguenti: \begin{itemize}[noitemsep] @@ -2173,18 +2178,18 @@ Nella figura~\ref{fig:frontespizi} nella pagina~\pageref{fig:frontespizi} sono r \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} +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. -\clearpage +%\clearpage -\begin{table}[p]\small +\begin{table}[hb]\caption{Comandi ulteriori di \class{toptesi}}\label{tab:comandi} \def\V{\rule{0pt}{2.5ex}} \def\d{\discretionary{\%}{\rule{1em}{0pt}}{}}\let\t\ttfamily -\makebox[\textwidth]{% +\makebox[\textwidth]{\footnotesize% \begin {tabular}{p{.25\textwidth}p{.25\textwidth}p{.4\textwidth}} \hline -Comando\V & Default & Scopo \\[.5ex] +Comando o ambiente\V & Default & Scopo \\[.5ex] \hline \cs{figurespagetrue}&\cs{figurespagefalse}&\V Fa o non fa stampare l'indice delle figure\\ @@ -2213,23 +2218,22 @@ Comando\V & Default & Scopo \\[.5ex] \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 questo comando che mi è - stato richiesto a gran voce.\\ -\cs{NoteWhiteLine} &nessuno & Anche questo comando mi è stato richiesto a gran +\cs{paginavuota} &nessuno & Emette nel file di uscita una pagina + totalmente bianca, senza nemmeno il numero + della pagina. \\ +\cs{NoteWhiteLine} &nessuno & Anche questo comando richiestomi a gran voce e serve per mettere in nota una riga bianca.\\[.5ex] \hline \end{tabular}} -\caption{Comandi ulteriori di \class{toptesi}}\label{tab:comandi} \end{table} \begin{table}[p] \def\V{\rule{0pt}{2.5ex}} \def\d{\discretionary{\%}{\rule{1em}{0pt}}{}}\let\t\ttfamily\let\s\string +\caption{Comandi ulteriori per il frontespizio e per il corpo +della tesi definiti con l'opzione \opt{classica}}\label{tab:front5} \makebox[\textwidth]{% \begin {tabular}{p{.22\textwidth}p{.68\textwidth}} \toprule @@ -2268,8 +2272,6 @@ Comando\V & Scopo \\[.5ex] a che fare con il contenuto del testo.\\ \bottomrule \end{tabular}} -\caption{Comandi ulteriori per il frontespizio e per il corpo -della tesi definiti con l'opzione \opt{classica}}\label{tab:front5} \end{table} \clearpage @@ -2278,6 +2280,9 @@ della tesi definiti con l'opzione \opt{classica}}\label{tab:front5} \def\V{\rule{0pt}{2.5ex}} \let\s\string\let\t\ttfamily \def\d{\discretionary{\%}{\rule{1em}{0pt}}{}} +\caption{Comandi per il frontespizio della monografia di laurea, della +tesi di laurea e della dissertazione di dottorato +(\emph{continua})}\label{tab:front1} \makebox[\textwidth]{\tolerance=9999\finalhyphendemerits=0\relax% \begin {tabular}{p{.3\textwidth}p{.2\textwidth}p{.2\textwidth}p{.25\textwidth}} \toprule @@ -2309,9 +2314,6 @@ Comando & Default & Scopo & Esempio d'uso \\ \cs{materia}\d\Arg{Letteratura ostrogota} \\ \bottomrule \end{tabular}} -\caption{Comandi per il frontespizio della monografia di laurea, della -tesi di laurea e della dissertazione di dottorato -(\emph{continua})}\label{tab:front1} \end{table} \addtocounter{table}{-1} @@ -2319,6 +2321,8 @@ tesi di laurea e della dissertazione di dottorato \def\V{\rule{0pt}{2.5ex}} \let\s\string \let\t\ttfamily \def\d{\discretionary{\%}{\rule{1em}{0pt}}{}} +\caption{Comandi per il frontespizio della monografia di laurea, della +tesi di laurea e della dissertazione di dottorato (\emph{continua})}\label{tab:front2} \makebox[\textwidth]{% \begin {tabular}{p{.3\textwidth}p{.15\textwidth}p{.2\textwidth}p{.3\textwidth}} \toprule @@ -2354,14 +2358,14 @@ della seconda candidata& \cs{secondacandidata}\d\Arg{Rita Levi Montalcini}\\ \bottomrule \end{tabular}} -\caption{Comandi per il frontespizio della monografia di laurea, della -tesi di laurea e della dissertazione di dottorato (\emph{continua})}\label{tab:front2} \end{table} \addtocounter{table}{-1} \begin{table} \def\V{\rule{0pt}{2.5ex}} \def\d{\discretionary{\%}{\rule{1em}{0pt}}{}}\let\t\ttfamily +\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} \makebox[\textwidth]{% \begin {tabular}{p{.3\textwidth}p{.175\textwidth}p{.2\textwidth}p{.275\textwidth}} \toprule @@ -2397,8 +2401,6 @@ terzo candidato 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} @@ -2406,6 +2408,10 @@ tesi di laurea e della dissertazione di dottorato. Comando per comporre il verso \def\V{\rule{0pt}{2.5ex}} \def\d{\discretionary{\%}{\rule{1em}{0pt}}{}} \def\serve{definisce una stringa equivalente a } + \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} \makebox[\textwidth]{\small% \begin{tabular}{@{}p{.35\textwidth}p{.63\textwidth}@{}} \toprule @@ -2453,10 +2459,6 @@ tesi di laurea e della dissertazione di dottorato. Comando per comporre il verso 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} @@ -2517,9 +2519,30 @@ 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 volendo ottenere un file PDF/A conforme, bisogna usare -preferibilmente \texttt{pdflatex}. Bisogna ricordarsi altresì di predisporre il file con i \emph{metadata} richiesti dal formato PDF/A. - +Si ricordi che specificando l'opzione \texttt{pdfa}, bisogna usare +esclusivamente \texttt{pdflatex}; 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}; 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 @@ -2537,12 +2560,12 @@ 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. -Si tenga presente che in questa documentazione ho fatto anche esempi in greco, scrivendo direttamente in greco antico nel file sorgente. Non ho nemmeno definito al lingua greca, ma ho caricato il pacchetto \pack{textalpha} che consente di disporre dei necessari meccanismi per scrivere in greco anche se non è stata specificata la lingua; per quel che serviva qui, era più che sufficiente, ma se si dovessero comporre molti passi in greco sarebbe meglio disporre della specificazione della lingua greca mediante \pack{babel} o \pack{polyglossia}. - So per certo che le tesi di filologia classica possono essere composte molto bene con \pdfLaTeX\ e \textsf{TOPtesi}; se bisogna usare una buona dose di lingua greca classica è conveniente -caricare il pacchetto \pack{teubner}\footnote{A tutt'oggi (2014) il pacchetto \pack{teubner} funziona correttamente solo con \pdfLaTeX.}; gli intenditori sanno +caricare il pacchetto \pack{teubner}\footnote{A tutt'oggi (2016) il +pacchetto \pack{teubner} funziona correttamente solo con \pdfLaTeX.}; +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 @@ -2554,7 +2577,7 @@ 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. +tutti o anche elencare solo i più importanti. Non resta che augurare: \begin {center}\Large\bfseries diff --git a/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf b/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf Binary files differindex e4efe9cb0ac..e8accc927cc 100644 --- a/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf +++ b/Master/texmf-dist/doc/latex/toptesi/toptesi.pdf |