From f794e99605085b9f6cef922ba918d6f87cbb76f3 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 24 Jun 2010 23:34:59 +0000 Subject: frontespizio 1.2 (24jun10) git-svn-id: svn://tug.org/texlive/trunk@19139 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/frontespizio/README | 47 +- .../doc/latex/frontespizio/examplea-frn.tex | 17 + .../texmf-dist/doc/latex/frontespizio/examplea.tex | 3 +- .../doc/latex/frontespizio/exampleb-frn.tex | 20 + .../texmf-dist/doc/latex/frontespizio/exampleb.tex | 5 +- .../doc/latex/frontespizio/examplec-frn.tex | 23 + .../texmf-dist/doc/latex/frontespizio/examplec.tex | 12 +- .../doc/latex/frontespizio/exampled-frn.tex | 21 + .../texmf-dist/doc/latex/frontespizio/exampled.tex | 43 ++ .../doc/latex/frontespizio/frontespizio.pdf | Bin 272944 -> 397940 bytes .../texmf-dist/doc/latex/frontespizio/makedoc.sh | 3 + .../source/latex/frontespizio/frontespizio.dtx | 704 +++++++++++++-------- .../source/latex/frontespizio/frontespizio.ins | 18 +- .../tex/latex/frontespizio/frontespizio.sty | 142 +++-- Master/tlpkg/libexec/ctan2tds | 1 + 15 files changed, 728 insertions(+), 331 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/frontespizio/examplea-frn.tex create mode 100644 Master/texmf-dist/doc/latex/frontespizio/exampleb-frn.tex create mode 100644 Master/texmf-dist/doc/latex/frontespizio/examplec-frn.tex create mode 100644 Master/texmf-dist/doc/latex/frontespizio/exampled-frn.tex create mode 100644 Master/texmf-dist/doc/latex/frontespizio/exampled.tex diff --git a/Master/texmf-dist/doc/latex/frontespizio/README b/Master/texmf-dist/doc/latex/frontespizio/README index d3120e65029..c241e4441b6 100644 --- a/Master/texmf-dist/doc/latex/frontespizio/README +++ b/Master/texmf-dist/doc/latex/frontespizio/README @@ -2,16 +2,32 @@ The frontespizio package lets you typeset a frontispiece (suitable for Italian university style) independently of the page layout of the main document. -This is version 1.1 of the package; the only change from version 1.0 is -the addition of the option `swapnames', to exchange the position of -candidate and advisor names. A bug with option `onlyinclude' has been -corrected. - - Copyright 2008, 2009 Enrico Gregorio - - This program is provided under the terms of the - LaTeX Project Public License distributed from CTAN - archives in directory macros/latex/base/lppl.txt. +This is version 1.2 of the package. + +Changes from version 1.1: +o A "Preambolo*" environment to collect things that had to be argument + of several \Preambolo commands +o Option "nouppercase" to avoid uppercasing the second line +o The package honors the inputenc option in the main document also + in the "frn" file +o Implementation modifications (use atbegshi instead of eso-pic and + others) +o Documentation update + +Changes from version 1.0: +o Added the option `swapnames', to exchange the position of + candidate and advisor names +o Correction of a bug with option `onlyinclude' + + Copyright 2008-2010 Enrico Gregorio + + This work may be distributed and/or modified under the + conditions of the LaTeX Project Public License, either version 1.3 + of this license or (at your option) any later version. + The latest version of this license is in + http://www.latex-project.org/lppl.txt + and version 1.3 or later is part of all distributions of LaTeX + version 2005/12/01 or later. Author: Enrico Gregorio Enrico dot Gregorio at univr dot it @@ -31,14 +47,15 @@ frontespizio.sty examplea.tex exampleb.tex examplec.tex +exampled.tex makedoc.sh To install the distribution: o run "latex frontespizio.ins" -o run "{|pdf|xe}latex example{a,b,c}.tex" for a test -o run "{|pdf|xe}latex example{a,b,c}-frn.tex" for a test -o run "{|pdf|xe}latex example{a,b,c}.tex" for a test +o run "{|pdf|xe}latex example{a,b,c,d}.tex" for a test +o run "{|pdf|xe}latex example{a,b,c,d}-frn.tex" for a test +o run "{|pdf|xe}latex example{a,b,c,d}.tex" for a test o after the tests, you should have correct dvi or pdf example files (choose either latex, pdflatex or xelatex and compile each of the three examples) @@ -53,6 +70,8 @@ $ pdflatex examplea-frn.tex $ pdflatex exampleb.tex $ pdflatex exampleb-frn.tex $ pdflatex examplec.tex +$ pdflatex exampled-frn.tex +$ pdflatex exampled.tex $ pdflatex examplec-frn.tex $ pdflatex frontespizio.dtx $ pdflatex frontespizio-frn.dtx @@ -68,5 +87,5 @@ the automated script makedoc.sh by sh makedoc.sh -2009/04/03 +2010/06/25 Enrico Gregorio diff --git a/Master/texmf-dist/doc/latex/frontespizio/examplea-frn.tex b/Master/texmf-dist/doc/latex/frontespizio/examplea-frn.tex new file mode 100644 index 00000000000..80b788db61d --- /dev/null +++ b/Master/texmf-dist/doc/latex/frontespizio/examplea-frn.tex @@ -0,0 +1,17 @@ +\documentclass [titlepage]{article} +\usepackage [a4paper,left=1cm,bottom=1.5cm,right=1cm,top=1cm]{geometry} +\usepackage {graphicx} +\usepackage[nowrite,infront]{frontespizio} +\nofiles +\fontoptionnormal +\Universita {Padova} +\Facolta {Scienze Matematiche, Fisiche e Naturali} +\Corso [Laurea]{Matematica} +\Titoletto {Tesi di laurea} +\Titolo {Equivalenze fra categorie di moduli\\ e applicazioni} +\Candidato [145822]{Enrico Gregorio} +\Relatore {Ch.mo Prof.~Adalberto Orsatti} +\Annoaccademico {19??-19??} +\begin {document} +\preparefrontpage +\end {document} diff --git a/Master/texmf-dist/doc/latex/frontespizio/examplea.tex b/Master/texmf-dist/doc/latex/frontespizio/examplea.tex index f918909683e..d5e8b310867 100644 --- a/Master/texmf-dist/doc/latex/frontespizio/examplea.tex +++ b/Master/texmf-dist/doc/latex/frontespizio/examplea.tex @@ -6,7 +6,7 @@ %% %% frontespizio.dtx (with options: `examplea') %% -%% Copyright 2008 Enrico Gregorio +%% Copyright 2008-2010 Enrico Gregorio %% %% This program is provided under the terms of the %% LaTeX Project Public License distributed from CTAN @@ -17,6 +17,7 @@ %% %% This work has the LPPL maintenance status "author-maintained". %% + \documentclass[a4paper,titlepage]{book} \usepackage{frontespizio} diff --git a/Master/texmf-dist/doc/latex/frontespizio/exampleb-frn.tex b/Master/texmf-dist/doc/latex/frontespizio/exampleb-frn.tex new file mode 100644 index 00000000000..895c52239e7 --- /dev/null +++ b/Master/texmf-dist/doc/latex/frontespizio/exampleb-frn.tex @@ -0,0 +1,20 @@ +\documentclass [titlepage]{article} +\usepackage [a4paper,left=1cm,bottom=1.5cm,right=1cm,top=1cm]{geometry} +\usepackage {graphicx} +\usepackage[nowrite,infront,nouppercase]{frontespizio} +\nofiles +\fontoptionsans +\Universita {Padova} +\Facolta {Scienze Matematiche, Fisiche e Naturali} +\Corso [Laurea]{Matematica} +\Titoletto {Tesi di laurea} +\Titolo {Equivalenze fra categorie di moduli\\ e applicazioni} +\Candidato {Enrico Gregorio} +\Relatore {Ch.mo Prof.~Adalberto Orsatti} +\Annoaccademico {19??-19??} +\Rientro {1.5cm} +\NCandidato {Laureando} +\Punteggiatura {} +\begin {document} +\preparefrontpage +\end {document} diff --git a/Master/texmf-dist/doc/latex/frontespizio/exampleb.tex b/Master/texmf-dist/doc/latex/frontespizio/exampleb.tex index 0be7d09c3fb..19c53a70966 100644 --- a/Master/texmf-dist/doc/latex/frontespizio/exampleb.tex +++ b/Master/texmf-dist/doc/latex/frontespizio/exampleb.tex @@ -6,7 +6,7 @@ %% %% frontespizio.dtx (with options: `exampleb') %% -%% Copyright 2008 Enrico Gregorio +%% Copyright 2008-2010 Enrico Gregorio %% %% This program is provided under the terms of the %% LaTeX Project Public License distributed from CTAN @@ -17,8 +17,9 @@ %% %% This work has the LPPL maintenance status "author-maintained". %% + \documentclass[a4paper,titlepage]{book} -\usepackage[sans]{frontespizio} +\usepackage[sans,nouppercase]{frontespizio} \begin{document} \begin{frontespizio} diff --git a/Master/texmf-dist/doc/latex/frontespizio/examplec-frn.tex b/Master/texmf-dist/doc/latex/frontespizio/examplec-frn.tex new file mode 100644 index 00000000000..195c78f8586 --- /dev/null +++ b/Master/texmf-dist/doc/latex/frontespizio/examplec-frn.tex @@ -0,0 +1,23 @@ +\documentclass [titlepage]{article} +\usepackage [a4paper,left=1cm,bottom=1.5cm,right=1cm,top=1cm]{geometry} +\usepackage {graphicx} +\usepackage[nowrite,infront,swapnames]{frontespizio} +\nofiles +\fontoptionnormal + +\usepackage {fourier} +\newcommand {\compring }{anelli compatti} + +\Universita {Bologna} +\Dipartimento {Matematica} +\Corso [Dottorato di Ricerca]{Matematica} +\Titolo {Equivalenza di Morita generalizzata\\ e applicazioni alla teoria degli\\ \compring } +\Candidato {Enrico Gregorio} +\Relatore {Ch.mo Prof.~Ermanno Lanconelli} +\NRelatore {Coordinatore}{} +\Correlatore {Ch.mo Prof.~Adalberto Orsatti} +\NCorrelatore {Supervisore della ricerca}{} +\Annoaccademico {19??-19??} +\begin {document} +\preparefrontpage +\end {document} diff --git a/Master/texmf-dist/doc/latex/frontespizio/examplec.tex b/Master/texmf-dist/doc/latex/frontespizio/examplec.tex index 81bdb5b4a1e..ca35d1a9893 100644 --- a/Master/texmf-dist/doc/latex/frontespizio/examplec.tex +++ b/Master/texmf-dist/doc/latex/frontespizio/examplec.tex @@ -6,7 +6,7 @@ %% %% frontespizio.dtx (with options: `examplec') %% -%% Copyright 2008 Enrico Gregorio +%% Copyright 2008-2010 Enrico Gregorio %% %% This program is provided under the terms of the %% LaTeX Project Public License distributed from CTAN @@ -17,18 +17,22 @@ %% %% This work has the LPPL maintenance status "author-maintained". %% + \documentclass[a4paper,titlepage]{book} \usepackage[swapnames]{frontespizio} \begin{document} \begin{frontespizio} -\Preambolo{\usepackage{fourier}} +\begin{Preambolo*} + \usepackage{fourier} + \newcommand{\compring}{anelli compatti} +\end{Preambolo*} \Universita{Bologna} \Dipartimento{Matematica} \Corso[Dottorato di Ricerca]{Matematica} \Titolo{Equivalenza di Morita generalizzata\\ -e applicazioni alla teoria degli\\ -anelli compatti} + e applicazioni alla teoria degli\\ + \compring} \Candidato{Enrico Gregorio} \Relatore{Ch.mo Prof.~Ermanno Lanconelli} \NRelatore{Coordinatore}{} diff --git a/Master/texmf-dist/doc/latex/frontespizio/exampled-frn.tex b/Master/texmf-dist/doc/latex/frontespizio/exampled-frn.tex new file mode 100644 index 00000000000..9550d1c044c --- /dev/null +++ b/Master/texmf-dist/doc/latex/frontespizio/exampled-frn.tex @@ -0,0 +1,21 @@ +\documentclass [titlepage]{article} +\usepackage [a4paper,left=1cm,bottom=1.5cm,right=1cm,top=1cm]{geometry} +\usepackage {graphicx} +\usepackage[nowrite,infront,nouppercase]{frontespizio} +\nofiles +\fontoptionnormal +\Istituzione {University of St.\ Anford} +\Divisione {Department of typography} +\Scuola {Ph.D. degree in \TeX {} and \LaTeX {}} +\Titolo {How to prepare a\\ formal frontispiece} +\Sottotitolo {Theory and practice} +\NCandidato {Candidate} +\Candidato {Enrico Gregorio} +\NRelatore {Thesis advisor}{} +\Relatore {Prof. R. J. Drofnats} +\NCorrelatore {Research supervisor}{} +\Correlatore {X. Treemunch} +\Piede {Thesis submitted in 2010} +\begin {document} +\preparefrontpage +\end {document} diff --git a/Master/texmf-dist/doc/latex/frontespizio/exampled.tex b/Master/texmf-dist/doc/latex/frontespizio/exampled.tex new file mode 100644 index 00000000000..b53fdb87dba --- /dev/null +++ b/Master/texmf-dist/doc/latex/frontespizio/exampled.tex @@ -0,0 +1,43 @@ +%% +%% This is file `exampled.tex', +%% generated with the docstrip utility. +%% +%% The original source files were: +%% +%% frontespizio.dtx (with options: `exampled') +%% +%% Copyright 2008-2010 Enrico Gregorio +%% +%% This program is provided under the terms of the +%% LaTeX Project Public License distributed from CTAN +%% archives in directory macros/latex/base/lppl.txt. +%% +%% Author: Enrico Gregorio +%% Enrico dot Gregorio at univr dot it +%% +%% This work has the LPPL maintenance status "author-maintained". +%% + +\documentclass[a4paper,titlepage]{book} +\usepackage[nouppercase]{frontespizio} + +\begin{document} +\begin{frontespizio} +\Istituzione{University of St.\ Anford} +\Divisione{Department of typography} +\Scuola{Ph.D. degree in \TeX{} and \LaTeX{}} +\Titolo{How to prepare a\\ + formal frontispiece} +\Sottotitolo{Theory and practice} +\NCandidato{Candidate} +\Candidato{Enrico Gregorio} +\NRelatore{Thesis advisor}{} +\Relatore{Prof. R. J. Drofnats} +\NCorrelatore{Research supervisor}{} +\Correlatore{X. Treemunch} +\Piede{Thesis submitted in 2010} +\end{frontespizio} +\end{document} +\endinput +%% +%% End of file `exampled.tex'. diff --git a/Master/texmf-dist/doc/latex/frontespizio/frontespizio.pdf b/Master/texmf-dist/doc/latex/frontespizio/frontespizio.pdf index b4d977e4a38..14cf8055b70 100644 Binary files a/Master/texmf-dist/doc/latex/frontespizio/frontespizio.pdf and b/Master/texmf-dist/doc/latex/frontespizio/frontespizio.pdf differ diff --git a/Master/texmf-dist/doc/latex/frontespizio/makedoc.sh b/Master/texmf-dist/doc/latex/frontespizio/makedoc.sh index 0c59680731f..6a4a613435c 100644 --- a/Master/texmf-dist/doc/latex/frontespizio/makedoc.sh +++ b/Master/texmf-dist/doc/latex/frontespizio/makedoc.sh @@ -1,3 +1,4 @@ + #!/bin/sh pdflatex examplea.tex pdflatex examplea-frn.tex @@ -5,6 +6,8 @@ pdflatex exampleb.tex pdflatex exampleb-frn.tex pdflatex examplec.tex pdflatex examplec-frn.tex +pdflatex exampled.tex +pdflatex exampled-frn.tex pdflatex frontespizio.dtx pdflatex frontespizio-frn.tex makeindex -s gind frontespizio diff --git a/Master/texmf-dist/source/latex/frontespizio/frontespizio.dtx b/Master/texmf-dist/source/latex/frontespizio/frontespizio.dtx index 617f19c097a..cd02a96ad66 100644 --- a/Master/texmf-dist/source/latex/frontespizio/frontespizio.dtx +++ b/Master/texmf-dist/source/latex/frontespizio/frontespizio.dtx @@ -4,15 +4,15 @@ % % ------------------------------------------------------- % -% This file may be distributed and/or modified under the conditions of -% the LaTeX Project Public License, either version 1.2 of this license -% or (at your option) any later version. The latest version of this -% license is in: +% This work may be distributed and/or modified under the +% conditions of the LaTeX Project Public License, either version 1.3 +% of this license or (at your option) any later version. +% The latest version of this license is in +% http://www.latex-project.org/lppl.txt +% and version 1.3 or later is part of all distributions of LaTeX +% version 2005/12/01 or later. % -% http://www.latex-project.org/lppl.txt -% -% and version 1.2 or later is part of all distributions of LaTeX -% version 1999/12/01 or later. +% This work consists of all files listed in README % % \fi % @@ -20,10 +20,10 @@ %<*driver> \ProvidesFile{frontespizio.dtx} % -%\NeedsTeXFormat{LaTeX2e}[1999/12/01] +%\NeedsTeXFormat{LaTeX2e}[2005/12/01] %\ProvidesPackage{frontespizio} %<*package> - [2009/04/03 1.1 (Enrico Gregorio)] + [2010/06/25 1.2 (Enrico Gregorio)] % %<*driver> \PassOptionsToClass{a4paper}{article} % we need a4paper @@ -32,13 +32,12 @@ \usepackage{graphicx,array,booktabs} \usepackage{frontespizio} -\newcommand{\pack}{\textsf} +\newcommand{\pack}[1]{\mbox{\sffamily#1}} \newcommand{\env}{\texttt} \newcommand{\file}{\texttt} -\newcommand{\cmdname}[1]{\texttt{\char`\\#1}} \newcommand{\opt}[1]{``\texttt{#1}''} \newcommand{\frontcommand}[3][f]{% - \subsection*{\cmdname{#2}#3% + \subsection*{\cs{#2}#3% \ifx#1o% ~(*)% \else @@ -46,14 +45,18 @@ ~(\textdagger)% \fi\fi}% } -\newcommand{\0}[1]{\ttchar[\meta{#1}\ttchar]} -\newcommand{\1}[1]{\ttchar\{\meta{#1}\ttchar\}} -\renewcommand{\meta}[1]{$\langle$\textit{\mdseries #1}$\rangle$} -\newcommand{\ttchar}[1]{{\ttfamily\char`#1}} +\newcommand{\frontenvironment}[2]{% + \subsection*{\cs{begin}\ttchar\{\texttt{#1}\ttchar\}\\ + #2\\ + \cs{end}\ttchar\{\texttt{#1}\ttchar\}}} +\makeatletter +\def\meta@font@select{\normalfont\itshape} % I dislike tt italic +\makeatother +\newcommand{\ttchar}[1]{{\normalfont\ttfamily\char`#1}} \newcommand{\frontoption}[1]{\subsection*{\texttt{#1}}} \newcommand{\includeex}[1]{\par\vfill\begin{center} \setlength{\fboxsep}{0pt}\fbox{\includegraphics[scale=.3]{#1}} -\end{center}} + \end{center}} \DeclareRobustCommand\Xe{% \leavevmode X\lower0.5ex @@ -68,7 +71,7 @@ % % \fi % -% \CheckSum{972} +% \CheckSum{1051} % % \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 @@ -108,14 +111,16 @@ % \DoNotIndex{\the,\thispagestyle,\unexpanded,\unless,\unskip,\upshape} % \DoNotIndex{\usepackage,\vbox,\vfill,\vspace,\write,\z@} % \DoNotIndex{\CurrentOption,\AtEndDocument,\@ne,\c@page,\m@ne} +% \DoNotIndex{\@firstofone,\@gobble,\@makeother,\begingroup,\endgroup} +% \DoNotIndex{\eTeXversion,\hbox,\hsize,\includegraphics,\newlinechar} +% \DoNotIndex{\titlepage,\vss,\vtop,\xdef} % % \begin{frontespizio} % \Universita{Pietrascambio} % \Facolta{Scienze Matematiche, Fisiche e Naturali} % \Corso[Laurea]{Tipografia elettronica} % \Titoletto{Tesi di perfezionamento} -% \Titolo{Come comporre un frontespizio\\ -% e vivere felici} +% \Titolo{Come comporre un frontespizio\\e vivere felici} % \Rientro{2cm} % \NCandidato{Autore} % \Candidato{Enrico Gregorio} @@ -126,8 +131,8 @@ % % % \title{Il pacchetto \textsf{frontespizio}\thanks{Questa -% documentazione corrisponde alla versione~\fileversion{} -% del~\filedate}} +% documentazione corrisponde alla versione~\fileversion{} +% del~\filedate}} % \author{Enrico Gregorio \\ % \texttt{Enrico dot Gregorio at univr dot it}} % \date{\filedate} @@ -138,7 +143,9 @@ % % This package is meant for Italian users who want to print a % frontispiece to their thesis, be it for graduation or for their -% Ph.D\@. +% Ph.D\@.; actually the package can be tweaked also for other +% purposes, provided the overall structure of the desired frontispiece +% is compatible with the standard one. % % It's usually difficult to get a first page which has very different % layout than the internal pages; use of the \pack{chngpage} package @@ -168,13 +175,13 @@ % dalla classe o modificato dall'utente con \pack{geometry}. % % Come si vede, il frontespizio di questo documento \`e del tutto -% indipendente dai parametri di impaginazione successivi. Ovviamente il -% nome dell'universit\`a e quello del relatore sono di fantasia. O no? +% indipendente dai parametri di impaginazione successivi. Ovviamente +% il nome dell'universit\`a e quello del relatore sono di fantasia. O +% no? % % Una prima soluzione che impiegava il pacchetto \pack{chngpage} aveva -% vari difetti, pur se funzionava con le classi standard. -% -% Questo nuovo pacchetto cerca di risolvere la questione producendo un +% vari difetti, pur se funzionava con le classi standard. Questo +% nuovo pacchetto cerca di risolvere la questione producendo un % documento separato che va compilato a parte e che verr\`a poi % incluso direttamente nel documento principale senza altri % interventi. Il vantaggio di usare questo pacchetto \`e che i @@ -219,7 +226,12 @@ latex tesi % % \`E possibile usare il pacchetto anche per includere un frontespizio % creato con altri sistemi, si veda pi\`u avanti la descrizione -% dell'opzione \opt{onlyinclude} +% dell'opzione \opt{onlyinclude}. +% +% Sono a conoscenza del fatto che il pacchetto è stato usato per +% comporre frontespizi anche di documenti diversi da tesi e +% simili. Naturalmente qui si tratta di frontespizi `formali', senza +% alcuna pretesa di essere artistici. % % \section{Uso} % @@ -243,9 +255,9 @@ latex tesi % prima compone il frontespizio in caratteri senza grazie, la seconda % serve a evitare la scrittura o riscrittura del documento \file{frn}, % ovviamente solo quando esso \`e definitivo o quando non ci interessa -% produrlo. +% riscriverlo ogni volta che compiliamo. % -% Vediamo un tipico frontespizio. Dopo \verb|\begin{document}| vanno +% Vediamo un tipico frontespizio. Dopo |\begin{document}| vanno % dati i comandi seguenti: % \iffalse %<*verb> @@ -261,7 +273,7 @@ latex tesi \Titolo{La mia tesi:\\ una lunga serie di risultati\\ difficilissimi e complicatissimi} \Sottotitolo{Alcune considerazioni mutevoli} -\Candidato[PP999999]{Paperino Paolino} +\Candidato[PP999999]{Paperon de' Paperoni} \Relatore{Giovanni Episcopo} \Relatore{Pippo Cluvio} \Correlatore{Ugo Frogio} @@ -273,8 +285,8 @@ latex tesi % \fi % % Si possono dare quanti relatori e correlatori si vuole; basta -% scriverli uno dopo l'altro come argomenti di comandi \verb|\Relatore| -% o \verb|\Correlatore|.\footnote{Aggiungere i titoli onorifici o +% scriverli uno dopo l'altro come argomenti di comandi \cs{Relatore} +% o \cs{Correlatore}.\footnote{Aggiungere i titoli onorifici o % professionali, mi raccomando! Altrimenti i chiarissimi professori % potrebbero offendersi.~\texttt{:-)}} Il correlatore \`e colui che % collabora alla direzione del lavoro di tesi, non quello che fa le @@ -286,11 +298,12 @@ latex tesi % \opt{noadvisor} al pacchetto. % % Descriveremo pi\`u avanti, in dettaglio, i vari comandi disponibili. -% Notiamo subito che l'ordine in cui sono dati \`e irrilevante. +% Notiamo subito che l'ordine in cui sono dati all'interno dell'ambiente +% |frontespizio| \`e irrilevante. % % Con l'opzione \opt{onlyinclude}, nessuno dei comandi descritti pi\`u % avanti \`e disponibile. Si pu\`o usare solo il comando -% \cmdname{includefront} che prende come argomento il nome del documento +% \cs{includefront} che prende come argomento il nome del documento % che contiene il frontespizio. Questo deve essere in formato % \textsc{iso}~A4. Il comando ha anche un argomento opzionale per % rimettere in ordine i numeri di pagina, che deve essere un numero @@ -306,17 +319,23 @@ latex tesi % che normalmente vengono disegnati fra il nome dell'ateneo e quello % della facolt\`a e sopra l'indicazione dell'anno accademico. % -% Ultima opzione, in ordine di tempo (novit\`a della versione 1.1), \`e -% \opt{swapnames} con la quale viene scambiata la posizione dei nomi -% di relatori e candidato; la posizione normale è con il nome del +% Con l'opzione \opt{swapnames} viene scambiata la posizione dei nomi +% di relatori e candidato; la posizione normale \`e con il nome del % candidato a sinistra e quello del relatore a destra. +% +% Novit\`a della versione 1.2 sono le opzioni \opt{nouppercase} e +% \opt{noinputenc}; la prima serve per non trasformare in maiuscolo il +% nome della facolt\`a, la seconda per uno scopo un po' recondito che +% vedremo pi\`u avanti, legato al fatto che ora il pacchetto rispetta +% la codifica di input del documento principale anche nel +% documento~\file{frn}. % % % \section{Le opzioni} % -% Raccolgo qui le opzioni gi\`a descritte, per un pi\`u facile riferimento. -% Quando due opzioni sono separate da~`$\mid$', la prima \`e quella -% valida normalmente. +% Raccolgo qui le opzioni gi\`a descritte, per un pi\`u facile +% riferimento. Quando due opzioni sono separate da~`$\mid$', la prima +% \`e quella valida normalmente. % % \frontoption{write${}\mid{}$nowrite}% % Mutuamente esclusive. Con la seconda si inibisce la scrittura del @@ -352,18 +371,30 @@ latex tesi % Non vengono inseriti filetti nel frontespizio; senza questa opzione % un filetto separa il nome dell'ateneo da quello della facolt\`a e un % altro viene disegnato sopra l'indicazione dell'anno accademico. +% +% \frontoption{nouppercase}% +% Senza questa opzione il nome della facolt\`a di riferimento \`e in +% tutto maiuscolo; specificandola, verr\`a rispettato il maiuscolo e +% il minuscolo come indicato nel documento. +% +% \frontoption{noinputenc}% +% Il pacchetto ora trascrive automaticamente la chiamata al pacchetto +% \pack{inputenc} del documento principale, se c'\`e, con la stessa +% opzione. In casi estremi pu\`o essere necessario evitarlo per +% specificare direttamente, con il comando \cs{Preambolo} o +% l'ambiente \env{Preambolo*}, la chiamata a \pack{inputenc} % % \frontoption{onlyinclude}% -% Definisce il comando \cmdname{includefront} e disabilita l'ambiente +% Definisce il comando \cs{includefront} e disabilita l'ambiente % \env{frontespizio}. Serve per includere un frontespizio preparato con % altri metodi; deve essere un file grafico che sia fra quelli -% gestibili con \cmdname{includegraphics} e deve avere formato +% gestibili con \cs{includegraphics} e deve avere formato % \textsc{iso}~A4. % % \frontoption{driver=$\langle\mathit{driver}\rangle$}% % Imposta la chiamata di \pack{graphicx} nel documento~\file{frn} per % l'uso di un driver diverso da \texttt{dvips} o \texttt{pdftex}, per -% esempio \verb|driver=dvipdfm| oppure \verb|driver=textures|. +% esempio |driver=dvipdfm| oppure |driver=textures|. % % \bigskip % @@ -373,7 +404,7 @@ latex tesi %<*verb> % \fi \begin{verbatim} -! Use of \front@temp doesn't match its definition. +! Package frontespizio Error: Key undefined. \end{verbatim} % \iffalse % @@ -392,7 +423,7 @@ latex tesi % spada~(\textdagger) quelli sostitutivi, cio\`e le varianti di cui si % diceva, senza niente quelli facoltativi. % -% \frontcommand[o]{Universita}{\1{nome breve}} +% \frontcommand[o]{Universita}{\marg{nome breve}} % L'istituzione in cui si discute la tesi, cio\`e quella che rilascia il % titolo di studio; va dato il nome abbreviato: % \iffalse @@ -400,14 +431,14 @@ latex tesi % \fi \begin{verbatim} \Universita{Verona} -\Universita{Roma `La Sapienza'} +\Universita{Napoli `Federico II'} \end{verbatim} % \iffalse % % \fi % Il comando aggiunge da s\'e ``Universit\`a degli Studi di''. % -% \frontcommand[s]{Istituzione}{\1{nome completo}} +% \frontcommand[s]{Istituzione}{\marg{nome completo}} % Quando l'istituzione ha un nome particolare, occorre specificarlo per % intero con questo comando: % \iffalse @@ -416,12 +447,13 @@ latex tesi \begin{verbatim} \Istituzione{Politecnico di Torino} \Istituzione{Universit\`a `Bocconi' di Milano} +\Istituzione{Sapienza -- Universit\`a di Roma} \end{verbatim} % \iffalse % % \fi % -% \frontcommand{Logo}{\0{dimen}\1{file}} +% \frontcommand{Logo}{\oarg{dimen}\marg{file}} % L'argomento di questo comando \`e il nome (senza estensione) di un % documento grafico che contenga il simbolo dell'istituzione. Ha un % argomento opzionale, la dimensione in altezza del logo (normalmente @@ -436,7 +468,7 @@ latex tesi % % \fi % -% \frontcommand{Filigrana}{\0{parametri}\1{file}} +% \frontcommand{Filigrana}{\oarg{parametri}\marg{file}} % L'argomento \`e il nome (senza estensione) di un documento che contenga % il simbolo dell'istituzione, con opportuna retinatura in modo che % appaia come in filigrana. Ha un argomento opzionale, che permette di @@ -453,17 +485,19 @@ latex tesi % Con la chiave \texttt{height} si imposta l'altezza del simbolo, con le % chiavi \texttt{before} e \texttt{after} si imposta la proporzione in % cui \`e diviso lo spazio rimanente; i valori usuali sono quelli mostrati -% nell'esempio. +% nell'esempio. Si pu\`o usare questo comando, dando opportuni valori, +% per inserire il logo in un posto diverso da quello che si ottiene +% con \cs{Logo}. % -% \frontcommand[o]{Facolta}{\1{nome breve}} +% \frontcommand[o]{Facolta}{\marg{nome breve}} % La facolt\`a in cui si sono svolti gli studi. Per le tesi di laurea % triennale o magistrale, sono le facolt\`a gli enti responsabili % dell'esame finale. % -% \frontcommand[s]{Dipartimento}{\1{nome breve}} +% \frontcommand[s]{Dipartimento}{\marg{nome breve}} % Per le tesi di dottorato, la responsabilit\`a \`e di un dipartimento. % -% \frontcommand[s]{Divisione}{\1{nome completo}} +% \frontcommand[s]{Divisione}{\marg{nome completo}} % Se la facolt\`a o dipartimento ha un nome non usuale, si pu\`o inserirlo % con questo comando: % \iffalse @@ -476,10 +510,10 @@ latex tesi % % \fi % -% \frontcommand[s]{Interfacolta}{\1{nomi completi}} +% \frontcommand[s]{Interfacolta}{\marg{nomi completi}} % Se il corso di laurea \`e diviso fra pi\`u facolt\`a, si usi questo -% comando; si noti che, a differenza di \cmdname{Facolta} e -% \cmdname{Divisione}, il risultato non \`e messo automaticamente in +% comando; si noti che, a differenza di \cs{Facolta} e +% \cs{Divisione}, il risultato non \`e messo automaticamente in % maiuscolo. Quindi si scriva, per esempio, % \iffalse %<*verb> @@ -494,7 +528,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % Si pu\`o usare la doppia barra rovescia per indicare dove spezzare le % righe. % -% \frontcommand[o]{Corso}{\0{tipo}\1{nome}} +% \frontcommand[o]{Corso}{\oarg{tipo}\marg{nome}} % Il corso di studi seguito, di cui la tesi \`e il compimento. Ha un % argomento opzionale che, non espresso, equivale a `Laurea Magistrale': % \iffalse @@ -508,7 +542,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % % \fi % -% \frontcommand[s]{Scuola}{\1{nome completo}} +% \frontcommand[s]{Scuola}{\marg{nome completo}} % Se il corso di studi ha un nome speciale, si usi questo comando che % produce esattamente il suo argomento: % \iffalse @@ -521,7 +555,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % % \fi % -% \frontcommand{Titoletto}{\1{tipo}} +% \frontcommand{Titoletto}{\marg{tipo}} % \`E possibile, con questo comando, specificare il tipo di tesi: % \iffalse %<*verb> @@ -535,38 +569,53 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % % \fi % -% \frontcommand[o]{Titolo}{\1{titolo}} +% \frontcommand[o]{Titolo}{\marg{titolo}} % Il titolo della tesi, con eventuali punti dove andare a capo espressi -% con \verb|\\|. +% con |\\|. % -% \frontcommand{Sottotitolo}{\1{sottotitolo}} +% \frontcommand{Sottotitolo}{\marg{sottotitolo}} % Un sottotitolo. Accade talvolta che due studenti preparino la loro % tesi in collaborazione e che ciascuno ne presenti una parte: il % sottotitolo \`e per questi casi, o altri che si possano pensare. % -% \frontcommand[o]{Candidato}{\0{matricola}\1{nome}} -% Il nome e cognome del candidato. Notare che, in italiano, il nome va -% \emph{prima} del cognome, qualsiasi cosa affermino i burocrati. Il -% comando prende come argomento opzionale il numero di matricola, che -% potrebbe essere richiesto dalle regole locali. \`E possibile ripetere -% il comando, nel caso ci siano pi\`u candidati che presentano insieme il -% lavoro. +% \frontcommand[o]{Candidato}{\oarg{matricola}\marg{nome}} + +% Il nome e cognome del candidato. Notare che, in italiano, il nome +% va \emph{prima} del cognome, qualsiasi cosa affermino i burocrati. +% Il comando prende come argomento opzionale il numero di matricola, +% che potrebbe essere richiesto dalle regole locali. \`E possibile +% ripetere il comando, nel caso ci siano pi\`u candidati che +% presentano insieme il lavoro. Non c'\`e un comando per eliminare o +% modificare la scritta `Matricola'; nel caso lo si desiderasse si pu\`o +% usare uno fra i seguenti biechi trucchi: +% \iffalse +%<*verb> +% \fi +\begin{verbatim} +\Preambolo{\renewcommand{\frontsmallfont}[1]{\small}} +\Preambolo{\renewcommand{\frontsmallfont}[1]{\small Matr.}} +\end{verbatim} +% \iffalse +% +% \fi +% Con il primo non viene stampato niente, con il secondo si avr\`a +% l'abbreviazione. % -% \frontcommand[o]{Relatore}{\1{nome}} +% \frontcommand[o]{Relatore}{\marg{nome}} % Il nome e cognome (se si preferisce preceduto dall'appellativo % accademico) del relatore. Pu\`o capitare che i relatori siano pi\`u % d'uno: basta specificarli successivamente, si veda l'esempio di prima. % Il comando \`e obbligatorio se non si \`e data l'opzione \opt{noadvisor}. % -% \frontcommand{Correlatore}{\1{nome}} +% \frontcommand{Correlatore}{\marg{nome}} % Il nome e cognome del correlatore, di solito un esterno % all'istituzione che ha collaborato alla guida del lavoro che ha % portato alla tesi. Anche qui se ne pu\`o specificare pi\`u d'uno. % -% \frontcommand[o]{Annoaccademico}{\1{anno}} +% \frontcommand[o]{Annoaccademico}{\marg{anno}} % L'anno accademico nel quale si discute la tesi. % -% \frontcommand[s]{Piede}{\1{testo}} +% \frontcommand[s]{Piede}{\marg{testo}} % Se al piede non si vuole la scritta ``Anno Accademico'' ma % qualcos'altro, lo si specifichi nell'argomento a questo comando. % @@ -576,7 +625,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % \`e possibile caricare gli stessi caratteri usati nel corpo della tesi o % cambiare i margini. % -% \frontcommand{NCandidato}{\1{nome}} +% \frontcommand{NCandidato}{\marg{nome}} % Il nome del candidato \`e preceduto dalla parola ``Candidato''. Se si % preferisce ``Laureando'', si usi % \iffalse @@ -589,7 +638,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % % \fi % -% \frontcommand{NCandidati}{\1{nome}} +% \frontcommand{NCandidati}{\marg{nome}} % Se ci sono pi\`u candidati, i nomi sono preceduti dalla parola % ``Candidati''. Se si preferisce ``Laureandi'', si usi % \iffalse @@ -602,7 +651,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % % \fi % -% \frontcommand{NRelatore}{\1{singolare}\1{plurale}} +% \frontcommand{NRelatore}{\marg{singolare}\marg{plurale}} % Analogamente, il nome del relatore \`e preceduto da ``Relatore''. Se si % fosse esterofili, si potrebbe modificarlo con % \iffalse @@ -617,10 +666,10 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % \`E necessario scrivere sia la forma singolare che quella plurale, anche % se ci sar\`a un solo relatore (ma si pu\`o lasciare l'argomento vuoto). % -% \frontcommand{NCorrelatore}{\1{singolare}\1{plurale}} +% \frontcommand{NCorrelatore}{\marg{singolare}\marg{plurale}} % Stesso discorso fatto per l'appellativo del relatore. % -% \frontcommand{Punteggiatura}{\1{carattere}} +% \frontcommand{Punteggiatura}{\marg{carattere}} % Gli appellativi ``Candidato'' e ``Relatore'' sono seguiti da due % punti; se non lo si desidera, si scriva % \iffalse @@ -633,7 +682,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % % \fi % -% \frontcommand{Preambolo}{\1{comandi}} +% \frontcommand{Preambolo}{\marg{comandi}} % Supponiamo che la tesi sia stata scritta con il carattere Utopia, % fornito dal pacchetto \pack{fourier}. Occorre specificarlo anche per % il frontespizio con @@ -651,13 +700,34 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % effetto cumulativo, si possono risolvere altri problemi particolari. % Infatti l'argomento del comando viene trascritto cos\`i com'\`e nel % preambolo del documento~\file{frn}.\footnote{In una versione -% precedente il comando era chiamato \cmdname{Package}; questo \`e ancora -% definito come equivalente di \cmdname{Preambolo}, ma il suo uso \`e +% precedente il comando era chiamato \cs{Package}; questo \`e ancora +% definito come equivalente di \cs{Preambolo}, ma il suo uso \`e % deprecato.} Vedremo in seguito altri usi del comando; si consiglia di -% usarne uno per ciascuna riga da aggiungere al preambolo: l'effetto \`e -% cumulativo. +% usarne uno per ciascuna riga da aggiungere al preambolo. % -% \frontcommand{Rientro}{\1{dimen}} +% \frontenvironment{Preambolo*}{\meta{comandi}} +% Usare molti comandi \cs{Preambolo} pu\`o essere fastidioso. +% Perci\`o \`e stato introdotto questo ambiente dove possono essere +% dati vari comandi tutti insieme. Per esempio, +% \iffalse +%<*verb> +% \fi +\begin{verbatim} +\begin{Preambolo*} +\usepackage{kpfonts} +\renewcommand{\fronttitlefont}{\fontsize{17}{21}\scshape} +\renewcommand{\frontfootfont}{\fontsize{12}{14}\itshape} +\end{Preambolo*} +\end{verbatim} +% \iffalse +% +% \fi +% evita di dover specificare lunghi argomenti a \cs{Preambolo} o +% di usare questo comando pi\`u volte. In uno degli esempi della +% documentazione si vede come in questo ambiente possa andare +% qualsiasi cosa sia sensata nel preambolo di un documento \LaTeX. +% +% \frontcommand{Rientro}{\marg{dimen}} % Il nome del candidato e quello del relatore sono a filo dei margini % sinistro e destro (che si possono ricavare dalle dimensioni dei due % filetti). Se si desidera averli pi\`u rientrati si pu\`o usare questo @@ -672,7 +742,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % % \fi % -% \frontcommand{Margini}{\1{dimen}\1{dimen}\1{dimen}\1{dimen}} +% \frontcommand{Margini}{\marg{dimen}\marg{dimen}\marg{dimen}\marg{dimen}} % Se i margini scelti dal pacchetto non sono di gradimento, si possono % specificarne di diversi con questo comando: % \iffalse @@ -687,19 +757,19 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % \`e l'equivalente della scelta del pacchetto. Le dimensioni si % riferiscono, nell'ordine, al margine sinistro, in basso, destro e in % alto.\footnote{In versioni precedenti, questo comando e il -% precedente si chiamavano, rispettivamente, \cmdname{Margins} e -% \cmdname{MoreMargin}.} +% precedente si chiamavano, rispettivamente, \cs{Margins} e +% \cs{MoreMargin}.} % % % \section{Scelta dei caratteri: forma e misura} % % Se non si fosse soddisfatti della scelta dei caratteri proposta -% dall'autore, si pu\`o usare il comando \cmdname{Preambolo} per -% modificarla. I comandi disponibili compaiono nella -% tabella~\ref{fonts}, con il loro valore usuale e la posizione in cui -% vengono usati. Per esempio, per avere il titolo in maiuscoletto~16/20 -% (cio\`e corpo~16 con distanza fra le linee di base di 20 punti), si -% scriver\`a +% dall'autore, si pu\`o usare il comando \cs{Preambolo} (o +% l'ambiente \env{Preambolo*}) per modificarla. I comandi disponibili +% compaiono nella tabella~\ref{fonts}, con il loro valore usuale e la +% posizione in cui vengono usati. Per esempio, per avere il titolo in +% maiuscoletto~16/20 (cio\`e corpo~16 con distanza fra le linee di +% base di 20 punti), si scriver\`a % \iffalse %<*verb> % \fi @@ -710,16 +780,18 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % \iffalse % % \fi -% La sintassi non \`e comoda, per scelta precisa. Si ricordi che con -% l'opzione \texttt{sans} non \`e disponibile il maiuscoletto. Un'altra -% cosa da ricordare \`e che per scegliere un carattere, occorre -% specificare non solo le sue dimensioni (e questo va fatto per prima -% cosa), ma anche le sue altre caratteristiche. Il comando -% \cmdname{fontsize} prende due argomenti: il corpo e l'avanzamento di -% riga; se non si specifica l'unit\`a di misura, viene assunta quella di -% punti tipografici~(pt). Se si cambia uno dei caratteri predefiniti, -% occorre specificare ogni aspetto del nuovo, se non si vogliono avere -% sorprese. +% La sintassi non \`e comoda, per scelta precisa. Si ricordi che +% con l'opzione \texttt{sans} non \`e disponibile il maiuscoletto. +% Un'altra cosa da ricordare \`e che per scegliere un carattere, +% occorre specificare non solo le sue dimensioni (e questo va fatto +% per prima cosa), ma anche le sue altre caratteristiche. Il comando +% \cs{fontsize} prende due argomenti: il corpo e l'avanzamento di +% riga; se non si specifica l'unit\`a di misura, viene assunta quella +% di punti tipografici~(pt). Se si cambia uno dei caratteri +% predefiniti, occorre specificare ogni aspetto del nuovo, se non si +% vogliono avere sorprese. Una dichiarazione finale come +% \cs{scshape} o \cs{bfseries} rende disponibile il font; se +% manca occorre dare \cs{selectfont}. % % \begin{table}[ht] % \centering @@ -729,32 +801,33 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % \toprule % Comando & Valore usuale & Impiego\\ % \midrule -% \cmdname{frontinstitutionfont} & +% \cs{frontinstitutionfont} & % Neretto, 14/17 & % Nome dell'universit\`a o istituzione\\[3pt] -% \cmdname{frontdivisionfont} & +% \cs{frontdivisionfont} & % Tondo, 12/16 & % Nome della facolt\`a o divisione\\[3pt] -% \cmdname{frontpretitlefont} & +% \cs{frontpretitlefont} & % Maiuscoletto, 10/12 & % Per il titoletto\\[3pt] -% \cmdname{fronttitlefont} & +% \cs{fronttitlefont} & % Neretto, 17/21 & % Per il titolo della tesi\\[3pt] -% \cmdname{frontsubtitlefont} & +% \cs{frontsubtitlefont} & % Tondo, 12/14 & % Per il sottotitolo\\[3pt] -% \cmdname{frontnamesfont} & -% Neretto, 12/14 & -% Per i nomi di candidato e relatore\\[3pt] -% \cmdname{frontfixednamesfont} & +% \cs{frontfixednamesfont} & % Tondo, 12/14 & % Per scrivere le parole chiave\\ % && `Candidato', `Relatore' e `Correlatore'\\[3pt] -% \cmdname{frontsmallfont} & -% Tondo, 9/11 & -% Per il numero di matricola\\[3pt] -% \cmdname{frontfootfont} & +% \cs{frontnamesfont} & +% Neretto, 12/14 & +% Per i nomi di candidato e relatore\\[3pt] +% \cs{frontsmallfont} & +% Neretto, 9/11 & +% Per il numero di matricola\\ +% && (eredita attributi dal precedente)\\[3pt] +% \cs{frontfootfont} & % Neretto, 12/14 & % Per scrivere l'anno accademico\\ % \bottomrule @@ -778,7 +851,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % % Analogamente si pu\`o aggiustare la composizione nel caso si usi % l'opzione \opt{signatures} modificando il comando -% \cmdname{frontadjustforsignatures} per esempio con +% \cs{frontadjustforsignatures} per esempio con % \iffalse %<*verb> % \fi @@ -793,7 +866,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % filetto in basso. Il comando non ha effetto se non dando l'opzione % \opt{signatures}. % -% Un terzo parametro dimensionale \`e \cmdname{frontlogosep}, il cui +% Un terzo parametro dimensionale \`e \cs{frontlogosep}, il cui % valore normale \`e 6\unit{pt}; se il logo dovesse essere troppo vicino o % lontano dal nome dell'universit\`a, si pu\`o modificare con un comando % come @@ -809,7 +882,7 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % dove la dimensione pu\`o anche essere negativa. % % Nel caso di pi\`u candidati, la spaziatura fra i nomi \`e regolata -% dal parametro \cmdname{frontcandidatesep}, il cui valore usuale \`e +% dal parametro \cs{frontcandidatesep}, il cui valore usuale \`e % 3\unit{ex}; la si pu\`o modificare con un comando come % \iffalse %<*verb> @@ -825,15 +898,17 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % % \`E possibile usare \Xe\TeX{}, ovviamente nella forma \Xe\LaTeX, per % produrre il frontespizio. Ovviamente dovr\`a essere usato il comando -% \cmdname{Preambolo} per impostare anche il documento~\file{frn} per +% \cs{Preambolo} per impostare anche il documento~\file{frn} per % l'uso di questo motore \TeX. Per esempio, se il documento principale -% \`e composto in ``Adobe Caslon~Pro'', si dovr\`a scrivere +% \`e composto in ``Adobe Caslon~Pro'', si potr\`a scrivere % \iffalse %<*verb> % \fi \begin{verbatim} -\Preambolo{\usepackage{fontspec}} -\Preambolo{\setmainfont{Adobe Caslon Pro}} +\begin{Preambolo*} +\usepackage{fontspec} +\setmainfont{Adobe Caslon Pro} +\end{Preambolo*} \end{verbatim} % \iffalse % @@ -844,41 +919,45 @@ FACOLT\`A DI SCIENZE FUMETTISTICHE % nel frontespizio, se non ci sono disposizioni particolari che % richiedano diversamente. % -% Si ricordi che \Xe\TeX{} legge correttamente solo documenti scritti -% nelle codifiche \textsc{utf}-8 oppure \textsc{utf}-16. +% Si ricordi che \Xe\TeX{} legge correttamente solo documenti scritti +% nelle codifiche \textsc{utf}-8 (oppure \textsc{utf}-16). Quindi se +% il documento principale \`e da compilare con \textsc{pdf}\LaTeX{} si +% dovr\`a caricare \pack{inputenc} con l'opzione \opt{utf8}, e questo +% \`e proprio il caso in cui al pacchetto \pack{frontespizio} deve +% essere passata l'opzione \pack{noinputenc}. +% % % % \section{Limitazioni e incompatibilit\`a} % -% Il pacchetto \`e in versione preliminare, \`e possibile che in futuro -% cambi anche la sintassi dei comandi da usare. Si spera in maniera -% compatibile. -% -% Gli altri pacchetti caricati sono \pack{ifpdf}, \pack{graphicx} e -% \pack{afterpage} che non hanno gravi incompatibilit\`a note. Se -% disponibile sul sistema, viene caricato anche \pack{ifxetex}. Se si -% dovesse usare \pack{graphicx} con un \emph{driver} diverso da -% \texttt{dvips} o \texttt{pdftex}, va caricato \emph{prima} di -% \pack{frontespizio}; ricordiamo che i due \emph{driver} menzionati non -% vanno dichiarati come opzione a \pack{graphicx}, perch\'e in mancanza di -% altre opzioni vengono scelti automaticamente dal compilatore. -% Attenzione: usando \emph{Textures}, per esempio, va inserita anche -% l'opzione \opt{driver=textures} a \pack{frontespizio}. Cambiare il -% nome del driver, se necessario; la sintassi \`e questa, niente spazi -% attorno al segno di uguaglianza. Ovviamente si dovr\`a consultare il -% manuale della propria distribuzione per sapere come produrre il file -% eps in modo corretto. +% Gli altri pacchetti caricati sono \pack{ifpdf}, \pack{graphicx}, +% \pack{afterpage}, \pack{atbegshi} e \pack{ifxetex} che non hanno +% incompatibilit\`a note. Se si dovesse usare \pack{graphicx} con +% opzioni, per esempio con un \emph{driver} diverso da \texttt{dvips} +% o \texttt{pdftex}, va caricato \emph{prima} di \pack{frontespizio}; +% ricordiamo che i due \emph{driver} menzionati non vanno dichiarati +% come opzione a \pack{graphicx}, perch\'e in mancanza di altre +% opzioni vengono scelti automaticamente dal compilatore. Attenzione: +% usando \emph{Textures}, per esempio, va inserita anche l'opzione +% \opt{driver=textures} a \pack{frontespizio}. Cambiare il nome del +% driver, se necessario. Ovviamente si dovr\`a consultare il manuale +% della propria distribuzione per sapere come produrre il file eps in +% modo corretto. +% +% Si noti che il pacchetto non \`e compatibile con \pack{vmargin}; se +% si desidera modificare l'impostazione tipografica del documento, si +% usi \pack{geometry}, pi\`u potente e facile. % % % \section{Soluzione del giochino} % -% L'etimologia di `Stanford' \`e `stan$+$ford'; l'antico inglese `stan' \`e -% ora `stone', cio\`e `pietra', mentre il toponimo `ford' indica un luogo -% di mercato. Il cognome `Knuth' \`e di origine norvegese, affine a -% `Knudsen', e significa `nodo'. Il nome `Donald' \`e di origine gaelica -% e vuol dire `reggitore del mondo', mentre `Basilio' viene dalla parola -% greca che significa~`re'. Il signor Revinu Jitis Drofnats non ha -% bisogno di presentazioni nel mondo~\TeX. +% L'etimologia di `Stanford' \`e `stan$+$ford'; l'antico inglese +% `stan' \`e ora `stone', cio\`e `pietra', mentre il toponimo `ford' +% indica un luogo di mercato. Il cognome `Knuth' \`e di origine +% norvegese, affine a `Knudsen', e significa `nodo'. Il nome `Donald' +% \`e di origine gaelica e vuol dire `reggitore del mondo', mentre +% `Basilio' viene dalla parola greca che significa~`re'. Revinu Jitis +% Drofnats non ha bisogno di presentazioni nel mondo~\TeX. % % % \section{Esempi} @@ -926,7 +1005,7 @@ e applicazioni} % \fi % \begin{verbatim} \documentclass[a4paper,titlepage]{book} -\usepackage[sans]{frontespizio} +\usepackage[sans,nouppercase]{frontespizio} \begin{document} \begin{frontespizio} @@ -964,13 +1043,16 @@ e applicazioni} \begin{document} \begin{frontespizio} -\Preambolo{\usepackage{fourier}} +\begin{Preambolo*} + \usepackage{fourier} + \newcommand{\compring}{anelli compatti} +\end{Preambolo*} \Universita{Bologna} \Dipartimento{Matematica} \Corso[Dottorato di Ricerca]{Matematica} \Titolo{Equivalenza di Morita generalizzata\\ -e applicazioni alla teoria degli\\ -anelli compatti} + e applicazioni alla teoria degli\\ + \compring} \Candidato{Enrico Gregorio} \Relatore{Ch.mo Prof.~Ermanno Lanconelli} \NRelatore{Coordinatore}{} @@ -989,6 +1071,40 @@ anelli compatti} % \includeex{examplec-frn} % \newpage % +% \iffalse +%<*exampled> +% \fi +% \begin{verbatim} +\documentclass[a4paper,titlepage]{book} +\usepackage[nouppercase]{frontespizio} + +\begin{document} +\begin{frontespizio} +\Istituzione{University of St.\ Anford} +\Divisione{Department of typography} +\Scuola{Ph.D. degree in \TeX{} and \LaTeX{}} +\Titolo{How to prepare a\\ + formal frontispiece} +\Sottotitolo{Theory and practice} +\NCandidato{Candidate} +\Candidato{Enrico Gregorio} +\NRelatore{Thesis advisor}{} +\Relatore{Prof. R. J. Drofnats} +\NCorrelatore{Research supervisor}{} +\Correlatore{X. Treemunch} +\Piede{Thesis submitted in 2010} +\end{frontespizio} +\end{document} +% \end{verbatim} +% \iffalse +% +% \fi +% +% \vspace{4ex} +% +% \includeex{exampled-frn} +% \newpage +% % \section{A shell script to compile the documentation} % Running \texttt{latex} on \file{frontespizio.ins} produces also % \file{makedoc.sh} which can be run, on Unix systems, by one of the @@ -1009,6 +1125,8 @@ pdflatex exampleb.tex pdflatex exampleb-frn.tex pdflatex examplec.tex pdflatex examplec-frn.tex +pdflatex exampled.tex +pdflatex exampled-frn.tex pdflatex frontespizio.dtx pdflatex frontespizio-frn.tex makeindex -s gind frontespizio @@ -1023,7 +1141,10 @@ exit % % \StopEventually{\PrintChanges\PrintIndex} % \changes{v1.1}{2009/04/03}{Added swapnames option} -% +% \changes{v1.2}{2010/06/25}{Added noinputenc option} +% \changes{v1.2}{2010/06/25}{Added nouppercase option} +% \changes{v1.2}{2010/06/25}{Added `Preambolo*' environment} +% \changes{v1.2}{2010/06/25}{Various implementation changes} % \selectlanguage{english} % \section{The implementation} % After the usual stuff of package presentation, here are the actual @@ -1054,32 +1175,32 @@ exit % later in order to produce the pdf page that will be included as the % frontispiece. The option `infront' is a private one, which is set % only in the \file{frn} file where the nowrite option is set, so we -% need a correction. It's easier to use \verb|\ifdefined| than to +% need a correction. It's easier to use \cs{ifdefined} than to % define many new conditionals. Actually, the package doesn't use -% $\varepsilon$-\TeX{} features other than \verb|\ifdefined| and -% \verb|\unless|, but I wanted to try and encourage to upgrade from +% $\varepsilon$-\TeX{} features other than \cs{ifdefined} and +% \cs{unless}, but I wanted to try and encourage to upgrade from % old \TeX{} systems. % % \begin{macro}{\iffront@write} -% The conditional \verb|\iffront@write| is false when we don't want +% The conditional \cs{iffront@write} is false when we don't want % to write the \file{frn} file. % \end{macro} % \begin{macro}{\front@infront} -% \verb|\front@infront| is defined only if we are typesetting the +% \cs{front@infront} is defined only if we are typesetting the % \file{frn} file. % \end{macro} % \begin{macro}{\front@signatures} -% \verb|\front@signatures| is defined if we need to leave space for +% \cs{front@signatures} is defined if we need to leave space for % the advisor's signature. % \end{macro} % \begin{macro}{\front@noadvisor} -% \verb|\front@noadvisor| is defined if we don't want an advisor's +% \cs{front@noadvisor} is defined if we don't want an advisor's % name. % \end{macro} % \begin{macro}{\front@swapnames} % \changes{v1.1}{2009/04/03}{Added macro \cs{front@swapnames} and % option \texttt{swapnames}} -% \verb|\front@swapnames| is defined if we want to swap the advisor's +% \cs{front@swapnames} is defined if we want to swap the advisor's % and candidate's fields. % \end{macro} % \begin{macro}{\front@thefont} @@ -1091,16 +1212,30 @@ exit % \end{macro} % \end{macro} % \begin{macro}{\front@norules} -% \verb|\front@norules| is defined if we don't want rules in the +% \cs{front@norules} is defined if we don't want rules in the % frontispiece. % \end{macro} +% \begin{macro}{\front@nouppercase} +% \changes{v1.2}{2010/06/25}{Added macro \cs{front@nouppercase} and +% option \texttt{nouppercase}} +% \cs{front@nouppercase} is defined if we don't want to capitalize +% the faculty line. +% \end{macro} +% \begin{macro}{\front@noinputenc} +% \changes{v1.2}{2010/06/25}{Added macro \cs{front@noinputenc} and +% option \texttt{noinputenc}} +% \cs{front@nouppercase} is defined if we don't want to export the +% option to \pack{inputenc} to the \file{frn}~file. +% \end{macro} % \begin{macro}{\iffront@include} -% \verb|\iffront@include| controls whether we use the package only in +% \cs{iffront@include} controls whether we use the package only in % order to include an external file (similarly to pdfpages). % \end{macro} -% \begin{macro}{\front@grfdriver} -% In \verb|\front@grfdriver| we load the driver's choice; it's a very -% primitive trick, but not many people use strange drivers, nowadays. +% \begin{macro}{\front@otheroptions} +% \changes{v1.2}{2010/06/25}{Added macro \cs{front@otheroptions}} +% \changes{v1.2}{2010/06/25}{Deleted macro \cs{front@grfdriver}} +% In \cs{front@otheroptions} we load the all other options, to be +% processed by \pack{keyval}. % \end{macro} % \begin{macrocode} \newif\iffront@write @@ -1113,9 +1248,13 @@ exit \DeclareOption{normal}{\def\front@thefont{\fontoptionnormal}} \DeclareOption{sans}{\def\front@thefont{\fontoptionsans}} \DeclareOption{norules}{\let\front@norules=T} +\DeclareOption{nouppercase}{\let\front@nouppercase=T} +\DeclareOption{noinputenc}{\let\front@noinputenc=T} \newif\iffront@include \DeclareOption{onlyinclude}{\front@includetrue\ExecuteOptions{nowrite}} -\DeclareOption*{\edef\front@grfdriver{\CurrentOption}} +\let\front@otheroptions\@empty +\DeclareOption*{\expandafter\g@addto@macro\expandafter\front@otheroptions + \expandafter{\CurrentOption,}} % \end{macrocode} % Now we choose the default options; we want to write the \file{frn} file % and roman fonts. @@ -1125,41 +1264,43 @@ exit % \end{macrocode} % \subsection{Required packages and service macros} % We load the needed packages. Of course \pack{graphicx} and -% \pack{eso-pic} for graphic inclusion; we need also \pack{afterpage} +% \pack{atbegshi} for graphic inclusion; we need also \pack{afterpage} % for adjustments when using some classes. +% \changes{v1.2}{2010/06/25}{Changed from \pack{eso-pic} to \pack{atbegshi}} +% \changes{v1.2}{2010/06/25}{We load also \pack{environ}} % \begin{macrocode} \RequirePackage{afterpage} \RequirePackage{graphicx} -\RequirePackage{eso-pic} +\RequirePackage{atbegshi} +\RequirePackage{environ} % \end{macrocode} % \begin{macro}{\includefront} % We manage first the onlyinclude option. If we are only including an % external file, we load it and prepare for an empty verso page; the % optional argument is there in order to correct the page number, if -% necessary; after that we stop reading the package. +% necessary; after that we stop reading the package. If a +% \env{frontespizio} environment is present, it's ignored after +% raising a warning, via \pack{environ}'s \cs{Collect@Body}. +% \changes{v1.2}{2010/06/25}{\cs{includefront} now depends on \pack{atbegshi}} % \begin{macrocode} \iffront@include \newcommand{\includefront}[2][0]{% \titlepage\null - \AddToShipoutPicture*{\includegraphics{#2}}% + \AtBeginShipoutNext{\AtBeginShipoutUpperLeft{% + \vbox to\z@{\hbox{\includegraphics{#2}}\vss}}} \afterpage{\thispagestyle{empty}}% \endtitlepage \ifx0#1\else \null\thispagestyle{empty}\newpage\addtocounter{page}{-#1}% \fi} \newenvironment{frontespizio}{% - \PackageError{frontespizio} - {Using the `frontespizio' environment along with the% - \MessageBreak - `onlyinclude' option is not allowed} - {You have called `frontespizio' with the `onlyinclude' option% - \MessageBreak - which disallows the `frontespizio' environment, thus be% + \PackageWarningNoLine{frontespizio} + {Using the `frontespizio' environment along with% \MessageBreak - prepared for a long string of errors.% + the `onlyinclude' option is meaningless. The% \MessageBreak - The best is to hit `x' now and correct your input.}% - }{} + environment's content will be ignored} + \Collect@Body\@gobble}{} \expandafter\endinput \else % \end{macrocode} @@ -1171,33 +1312,29 @@ exit % \begin{macrocode} \RequirePackage{ifpdf} % \end{macrocode} -% We want to support also \Xe\LaTeX{}, but not all distributions have -% it; so if the package \pack{ifxetex} is not in the system we assume -% that \Xe\LaTeX{} is not used; we have to bury a \verb|\let| inside a -% macro, which can be safely undefined later; all \verb|\ifxetex| -% conditionals will be treated as false, of course. Since we are in a -% conditional, the definition of \cs{front@ifxetex} must be done in an -% indirect way.\changes{v1.1}{2009/04/03}{Recoded \cs{front@ifxetex}} +% We want to support also \Xe\LaTeX{}. +% \changes{v1.2}{2010/06/25}{Package \pack{ifxetex} is required} % \begin{macrocode} -\def\front@ifxetex{% - \expandafter\let - \csname ifxetex\expandafter\endcsname - \csname iffalse\endcsname} -\IfFileExists{ifxetex.sty}{\RequirePackage{ifxetex}}{\front@ifxetex} -\let\front@ifxetex\@undefined +\RequirePackage{ifxetex} \fi % \end{macrocode} % \begin{macro}{\front@write} % \begin{macro}{\front@expwrite} % If we are writing the \file{frn} file, we allocate an output stream, -% otherwise we let \verb|\front@write| and \verb|\front@expwrite| to -% gobble their argument; \verb|\front@write| is used to write things -% without expansion while \verb|\front@expwrite| expands tokens in the -% argument. +% otherwise we let \cs{front@write} and \cs{front@expwrite} to +% gobble their argument; \cs{front@write} is used to write things +% without expansion while \cs{front@expwrite} expands tokens in the +% argument. We now use, if available, the \cs{pdfmdfivesum} facility +% of \textsc{pdf}\TeX, in order to tell the user if the \file{frn} +% file has changed. % \end{macro} % \end{macro} % \begin{macrocode} \iffront@write + \ifdefined\pdfmdfivesum + \IfFileExists{\jobname-frn.tex}{% + \xdef\front@mdfiveold{\pdfmdfivesum file{\jobname-frn.tex}}}{}% + \fi \newwrite\front@out \immediate\openout\front@out=\jobname-frn.tex \long\def\front@write#1{\immediate\write\front@out{\unexpanded{#1}}} @@ -1212,17 +1349,42 @@ exit % margins. If a driver option has been given we want to load % \pack{graphicx} in the frn file with the right driver; we have to do % this before loading the present package, which always requires -% \pack{graphicx}. +% \pack{graphicx}. Meanwhile, we load also the \pack{inputenc} +% package with the same options given in the main document; this can +% be overrided with the \opt{noinputenc} package option. Nothing is +% done if \pack{inputenc} is not loaded in the document. % \begin{macrocode} \front@write{\documentclass[titlepage]{article}} +\ifdefined\front@noinputenc\else + \ifdefined\inputencodingname + \front@expwrite{\string\usepackage[\inputencodingname]{inputenc}} + \fi +\fi \front@write{\usepackage[a4paper,% left=1cm,bottom=1.5cm,right=1cm,top=1cm]{geometry}} -\ifdefined\front@grfdriver - \def\front@temp driver=#1\@nil{\def\front@grfdriver{#1}} - \expandafter\front@temp\front@grfdriver\@nil - \front@expwrite{\string\usepackage[\front@grfdriver]{graphicx}} +% \end{macrocode} +% \begin{macro}{\front@processkeys} +% If the user has specified an unusual driver for \pack{graphicx}, we +% manage it with \pack{keyval}; otherwise we load the package without +% options, in a group because we redefine locally \cs{KV@errx} to be more +% informative; also the key(s) will be defined only locally, as well +% as \cs{front@processkeys}. +% \begin{macrocode} +\ifx\front@otheroptions\@empty + \front@write{\usepackage{graphicx}} +\else + \begingroup + \def\KV@errx#1{% + \PackageError{frontespizio}{Key #1} + {The only allowed key is `driver'; the given key will be ignored.% + \MessageBreak Type \space \space to proceed.}} + \define@key{front}{driver}{\front@write{\usepackage[#1]{graphicx}}} + \edef\front@processkeys{\noexpand\setkeys{front}{\front@otheroptions}} + \front@processkeys + \endgroup \fi % \end{macrocode} +% \end{macro} % Set the options in the \file{frn} file: there we don't want to be % writing the \file{frn} file, of course, nor we need aux files, but % we add the private option. @@ -1240,6 +1402,9 @@ exit \ifdefined\front@norules \g@addto@macro\front@theoptions{,norules} \fi +\ifdefined\front@nouppercase + \g@addto@macro\front@theoptions{,nouppercase} +\fi \front@expwrite{\string\usepackage[\front@theoptions]{frontespizio}} \front@write{\nofiles} % \end{macrocode} @@ -1250,7 +1415,7 @@ exit % \end{macrocode} % \subsection{Commands, conditionals and registers} % The following commands are necessary only when we are compiling -% the frontispiece, when the \verb|\front@infront| command is defined. +% the frontispiece, when the \cs{front@infront} command is defined. % \begin{macrocode} \ifdefined\front@infront \def\fontoptionnormal{% @@ -1286,9 +1451,9 @@ exit \fi % \end{macrocode} % We need a macro to hide the conditionals, which we load and define -% only when making the front page; the \verb|\if| conditional will +% only when making the front page; the \cs{if} conditional will % always expand to nothing or be skipped altogether up to the matching -% \verb|\fi| when writing the \file{frn} file; if expanded, however, +% \cs{fi} when writing the \file{frn} file; if expanded, however, % it will put in the correct conditional when making the front page. % \begin{macrocode} \def\@front@#1{TT\fi\@nameuse{iffront@#1}} @@ -1298,13 +1463,19 @@ exit % \begin{macrocode} \iffront@write % \end{macrocode} +% \changes{v1.2}{2010/06/25}{Added the \texttt{Preambolo*} environment} % If we are writing the \file{frn} file, then we simply copy the -% commands to it. An exception is \verb|\Preambolo|: in this case we -% copy only its argument. Since there can be several candidate names, -% the \verb|\Candidato| macro is treated differently, because it can -% have an optional argument. +% commands to it. An exception is \cs{Preambolo}: in this case we +% copy only its argument. The same is with the |Preambolo*| +% environment, using \cs{Collect@Body}; the category code changes are +% made because we want to preserve newlines in the input. Since there +% can be several candidate names, the \cs{Candidato} macro is treated +% differently, because it can have an optional argument. % \begin{macrocode} \newcommand{\Preambolo}[1]{\front@write{#1}} +\newenvironment{Preambolo*} + {\@makeother\%\@makeother\^^M\newlinechar=`\^^M + \Collect@Body\front@write}{} \newcommand{\Rientro}[1]{\front@write{\Rientro{#1}}} \newcommand{\Margini}[4]{\front@write{\Margini{#1}{#2}{#3}{#4}}} \newcommand{\Logo}[2][1.5cm]{\front@write{\Logo[#1]{#2}}} @@ -1340,7 +1511,7 @@ exit % \end{macrocode} % Now some equivalent commands for backwards compatibility with the % preproduction version called front-th. Unfortunately, the old -% command \verb|\Matricola| cannot be made compatible. +% command \cs{Matricola} cannot be made compatible. % \begin{macrocode} \def\front@oldcommand#1#2{\def#1{\PackageWarning{frontespizio} {Old command \string#1 found; use \string#2}#2}} @@ -1358,7 +1529,7 @@ exit % \end{macrocode} % If we are typesetting the front page, then we give the commands % their real meaning, i.e., we define macros which will be used in -% \verb|\preparefrontpage|. +% \cs{preparefrontpage}. % \begin{macrocode} \newcommand{\Rientro}[1]{\def\front@push{\hspace{#1}}} \newcommand{\Margini}[4]{\geometry{left=#1,bottom=#2,right=#3,top=#4}} @@ -1366,6 +1537,7 @@ exit \def\front@logosize{#1}\front@logotrue} % \end{macrocode} % We support a centered logo in the background, using xkeyval. +% \changes{v1.2}{2010/06/25}{Changed \cs{Filigrana} definition} % \begin{macrocode} \def\front@logobefore{1}\def\front@logoafter{1} % default values \define@key{filigrana}{height}[10cm]{\def\front@logoheight{#1}} @@ -1373,13 +1545,12 @@ exit \define@key{filigrana}{after}[1]{\def\front@logoafter{#1}} \newcommand{\Filigrana}[2][height=10cm]{% \setkeys{filigrana}{#1}% - \AddToShipoutPicture*{% - \put(0,0){ - \parbox[b][\paperheight]{\paperwidth}{ - \vspace*{\stretch{\front@logobefore}} - \centering - \includegraphics[height=\front@logoheight]{#2} - \vspace{\stretch{\front@logoafter}} + \AtBeginShipoutNext{\AtBeginShipoutUpperLeft{% + \vtop to\paperheight{\hsize=\paperwidth + \vspace*{\stretch{\front@logobefore}} + \centering + \includegraphics[height=\front@logoheight]{#2} + \vspace{\stretch{\front@logoafter}} }}}} % \end{macrocode} % Now we continue the definition of the markup commands, mostly @@ -1480,9 +1651,21 @@ exit #2\\% the candidate's name \def\next{#1}% \unless\ifx\next\@empty - \frontsmallfont Matricola #1\\[\frontcandidatesep] + \frontsmallfont {Matricola }#1\\[\frontcandidatesep] \fi} % \end{macrocode} +% \begin{macro}{\front@MakeUppercase} +% \changes{v1.2}{2010/06/25}{Added option \opt{nouppercase}} +% We define \cs{front@MakeUppercase} to be \cs{MakeUppercase} unless +% \opt{nouppercase} has been specified, otherwise it does nothing. +% \begin{macrocode} +\ifdefined\front@nouppercase + \let\front@MakeUppercase\@firstofone +\else + \let\front@MakeUppercase\MakeUppercase + \fi +% \end{macrocode} +% \end{macro} % % \subsection{The typesetting} % \begin{macro}{\preparefrontpage} @@ -1517,17 +1700,16 @@ exit % Third block: the department's name; in Italy graduation theses are % responsibility of Faculties, only Ph.D. theses are responsibility of % Departments. +% \changes{v1.2}{2010/06/25}{Use \cs{front@MakeUppercase}} % \begin{macrocode} {\frontdivisionfont \if\@front@{multiple} \front@multiple \else \if\@front@{division} - \MakeUppercase{\front@division} + \front@MakeUppercase{\front@division} \else - \MakeUppercase{\front@thefacoldip} - DI - \MakeUppercase{\front@facoldip} + \front@MakeUppercase{\front@thefacoldip\space di \front@facoldip} \fi \fi\\ \if\@front@{school} @@ -1563,9 +1745,9 @@ exit % the left we put the candidate's name, on the right the advisor's % name (possibly more than one) and, if present, the coadvisor's name. % It the option `swapnames' has been given, the two columns are exchanged. -% \begin{macrocode} % \changes{v1.1}{2009/04/03}{Added \cs{front@makecandidates}} % \changes{v1.1}{2009/04/03}{Added \cs{front@@makeadvisors}} +% \begin{macrocode} \def\front@makecandidates{% \begin{tabular}[t]{@{}l@{}} \relax\ifnum\front@candcount<1 @@ -1635,8 +1817,8 @@ exit \par} \endtitlepage} % \end{macrocode} -% The following \verb|\else| matches the -% \verb|\ifdefined\front@infront| several lines ahead +% The following \cs{else} matches the |\ifdefined\front@infront| +% several lines ahead % \begin{macrocode} \else % \end{macrocode} @@ -1671,8 +1853,8 @@ exit \newcommand{\NCorrelatore}[2]{} \newcommand{\Punteggiatura}[1]{} % \end{macrocode} -% The following two \verb|\fi| match \verb|\ifdefined\front@infront| -% and \verb|\iffront@write| several lines ahead +% The following two \cs{fi} match |\ifdefined\front@infront| +% and \cs{iffront@write} several lines ahead % \begin{macrocode} \fi \fi @@ -1698,7 +1880,32 @@ exit \advance\c@page\m@ne}} {\let\front@cp\relax} % \end{macrocode} +% \begin{macro}{\front@message} +% \changes{v1.2}{2010/06/25}{Added infrastructure for the final message} +% Here we define the infrastructure for the final message. +% \begin{macrocode} +\newif\if@front@message +\def\front@message{% + \PackageWarningNoLine{frontespizio} + {Remember to compile \jobname-frn with\MessageBreak + \ifpdf + pdflatex \jobname-frn% + \else + \ifxetex + xelatex \jobname-frn + \else + latex \jobname-frn\MessageBreak + dvips -o \jobname-frn.eps \jobname-frn% + \fi + \fi\MessageBreak + and then rerun \ifpdf pdf\fi \ifxetex xe\fi latex}} +% \end{macrocode} +% \end{macro} % \begin{environment}{frontespizio} +% \changes{v1.2}{2010/06/25}{Changed the definition to use \pack{atbegshi}} +% \changes{v1.2}{2010/06/25}{Excised the final message stuff} +% \changes{v1.2}{2010/06/25}{Modified \cs{endfrontespizio} for the +% final message} % The environment \env{frontespizio} goes in the main file and is % responsible for ending the writing of the \file{frn} file (in its final % part; in the initial part it typesets the front page by including @@ -1713,22 +1920,10 @@ exit % \begin{macrocode} \def\frontespizio{% \titlepage\null - \IfFileExists{\jobname-frn.\front@ext} - {\AddToShipoutPicture*{\includegraphics{\jobname-frn}}} - {\AtEndDocument{% - \PackageWarningNoLine{frontespizio} - {Remember to compile \jobname-frn with\MessageBreak - \ifpdf - pdflatex \jobname-frn% - \else - \ifxetex - xelatex \jobname-frn - \else - latex \jobname-frn\MessageBreak - dvips -o \jobname-frn.eps \jobname-frn% - \fi - \fi\MessageBreak - and then rerun \ifpdf pdf\fi \ifxetex xe\fi latex}}} + \IfFileExists{\jobname-frn.\front@ext} + {\AtBeginShipoutNext{\AtBeginShipoutUpperLeft{% + \vbox to\z@{\hbox{\includegraphics{\jobname-frn}}\vss}}}} + {\@front@messagetrue}% \afterpage{\thispagestyle{empty}}% \endtitlepage \if@twoside\front@cp\fi @@ -1738,6 +1933,15 @@ exit \front@write{\preparefrontpage} \front@write{\end{document}} \iffront@write\immediate\closeout\front@out\fi + \ifdefined\front@mdfiveold + \xdef\front@mdfivenew{\pdfmdfivesum file{\jobname-frn.tex}}% + \ifx\front@mdfiveold\front@mdfivenew\else + \@front@messagetrue + \fi + \fi + \if@front@message + \AtEndDocument{\front@message} + \fi } % \end{macrocode} % \iffalse diff --git a/Master/texmf-dist/source/latex/frontespizio/frontespizio.ins b/Master/texmf-dist/source/latex/frontespizio/frontespizio.ins index cc7220e6078..8d9a7e50ebb 100644 --- a/Master/texmf-dist/source/latex/frontespizio/frontespizio.ins +++ b/Master/texmf-dist/source/latex/frontespizio/frontespizio.ins @@ -1,10 +1,13 @@ -%% %% frontespizio.ins -%% Copyright 2008 Enrico Gregorio +%% Copyright 2008-2010 Enrico Gregorio %% -%% This program is provided under the terms of the -%% LaTeX Project Public License distributed from CTAN -%% archives in directory macros/latex/base/lppl.txt. +%% This work may be distributed and/or modified under the +%% conditions of the LaTeX Project Public License, either version 1.3 +%% of this license or (at your option) any later version. +%% The latest version of this license is in +%% http://www.latex-project.org/lppl.txt +%% and version 1.3 or later is part of all distributions of LaTeX +%% version 2005/12/01 or later. %% %% Author: Enrico Gregorio %% Enrico dot Gregorio at univr dot it @@ -15,12 +18,14 @@ %% driver files from the doc files in this package when run through %% LaTeX or TeX. %% +%% This work consists of all files listed in README +%% %% --------------- start of docstrip commands ------------------ %% \input docstrip \preamble - Copyright 2008 Enrico Gregorio + Copyright 2008-2010 Enrico Gregorio This program is provided under the terms of the LaTeX Project Public License distributed from CTAN @@ -41,6 +46,7 @@ \file{examplea.tex}{\from{frontespizio.dtx}{examplea}}% \file{exampleb.tex}{\from{frontespizio.dtx}{exampleb}}% \file{examplec.tex}{\from{frontespizio.dtx}{examplec}}% + \file{exampled.tex}{\from{frontespizio.dtx}{exampled}}% \nopreamble\nopostamble \file{makedoc.sh}{\from{frontespizio.dtx}{thedoc}}% } diff --git a/Master/texmf-dist/tex/latex/frontespizio/frontespizio.sty b/Master/texmf-dist/tex/latex/frontespizio/frontespizio.sty index bb81afd9411..72b4172ad4d 100644 --- a/Master/texmf-dist/tex/latex/frontespizio/frontespizio.sty +++ b/Master/texmf-dist/tex/latex/frontespizio/frontespizio.sty @@ -6,7 +6,7 @@ %% %% frontespizio.dtx (with options: `package') %% -%% Copyright 2008 Enrico Gregorio +%% Copyright 2008-2010 Enrico Gregorio %% %% This program is provided under the terms of the %% LaTeX Project Public License distributed from CTAN @@ -17,9 +17,10 @@ %% %% This work has the LPPL maintenance status "author-maintained". %% -\NeedsTeXFormat{LaTeX2e}[1999/12/01] +\NeedsTeXFormat{LaTeX2e}[2005/12/01] \ProvidesPackage{frontespizio} - [2009/04/03 1.1 (Enrico Gregorio)] + [2010/06/25 1.2 (Enrico Gregorio)] + \def\@not@eTeX{% \PackageError{frontespizio} {This package requires e-TeX, I'll stop right now} @@ -44,47 +45,47 @@ \DeclareOption{normal}{\def\front@thefont{\fontoptionnormal}} \DeclareOption{sans}{\def\front@thefont{\fontoptionsans}} \DeclareOption{norules}{\let\front@norules=T} +\DeclareOption{nouppercase}{\let\front@nouppercase=T} +\DeclareOption{noinputenc}{\let\front@noinputenc=T} \newif\iffront@include \DeclareOption{onlyinclude}{\front@includetrue\ExecuteOptions{nowrite}} -\DeclareOption*{\edef\front@grfdriver{\CurrentOption}} +\let\front@otheroptions\@empty +\DeclareOption*{\expandafter\g@addto@macro\expandafter\front@otheroptions + \expandafter{\CurrentOption,}} \ExecuteOptions{write,normal} \ProcessOptions\relax \RequirePackage{afterpage} \RequirePackage{graphicx} -\RequirePackage{eso-pic} +\RequirePackage{atbegshi} +\RequirePackage{environ} \iffront@include \newcommand{\includefront}[2][0]{% \titlepage\null - \AddToShipoutPicture*{\includegraphics{#2}}% + \AtBeginShipoutNext{\AtBeginShipoutUpperLeft{% + \vbox to\z@{\hbox{\includegraphics{#2}}\vss}}} \afterpage{\thispagestyle{empty}}% \endtitlepage \ifx0#1\else \null\thispagestyle{empty}\newpage\addtocounter{page}{-#1}% \fi} \newenvironment{frontespizio}{% - \PackageError{frontespizio} - {Using the `frontespizio' environment along with the% - \MessageBreak - `onlyinclude' option is not allowed} - {You have called `frontespizio' with the `onlyinclude' option% + \PackageWarningNoLine{frontespizio} + {Using the `frontespizio' environment along with% \MessageBreak - which disallows the `frontespizio' environment, thus be% + the `onlyinclude' option is meaningless. The% \MessageBreak - prepared for a long string of errors.% - \MessageBreak - The best is to hit `x' now and correct your input.}% - }{} + environment's content will be ignored} + \Collect@Body\@gobble}{} \expandafter\endinput \else \RequirePackage{ifpdf} -\def\front@ifxetex{% - \expandafter\let - \csname ifxetex\expandafter\endcsname - \csname iffalse\endcsname} -\IfFileExists{ifxetex.sty}{\RequirePackage{ifxetex}}{\front@ifxetex} -\let\front@ifxetex\@undefined +\RequirePackage{ifxetex} \fi \iffront@write + \ifdefined\pdfmdfivesum + \IfFileExists{\jobname-frn.tex}{% + \xdef\front@mdfiveold{\pdfmdfivesum file{\jobname-frn.tex}}}{}% + \fi \newwrite\front@out \immediate\openout\front@out=\jobname-frn.tex \long\def\front@write#1{\immediate\write\front@out{\unexpanded{#1}}} @@ -94,12 +95,25 @@ \let\front@expwrite\front@write \fi \front@write{\documentclass[titlepage]{article}} +\ifdefined\front@noinputenc\else + \ifdefined\inputencodingname + \front@expwrite{\string\usepackage[\inputencodingname]{inputenc}} + \fi +\fi \front@write{\usepackage[a4paper,% left=1cm,bottom=1.5cm,right=1cm,top=1cm]{geometry}} -\ifdefined\front@grfdriver - \def\front@temp driver=#1\@nil{\def\front@grfdriver{#1}} - \expandafter\front@temp\front@grfdriver\@nil - \front@expwrite{\string\usepackage[\front@grfdriver]{graphicx}} +\ifx\front@otheroptions\@empty + \front@write{\usepackage{graphicx}} +\else + \begingroup + \def\KV@errx#1{% + \PackageError{frontespizio}{Key #1} + {The only allowed key is `driver'; the given key will be ignored.% + \MessageBreak Type \space \space to proceed.}} + \define@key{front}{driver}{\front@write{\usepackage[#1]{graphicx}}} + \edef\front@processkeys{\noexpand\setkeys{front}{\front@otheroptions}} + \front@processkeys + \endgroup \fi \def\front@theoptions{nowrite,infront} \ifdefined\front@signatures @@ -114,6 +128,9 @@ \ifdefined\front@norules \g@addto@macro\front@theoptions{,norules} \fi +\ifdefined\front@nouppercase + \g@addto@macro\front@theoptions{,nouppercase} +\fi \front@expwrite{\string\usepackage[\front@theoptions]{frontespizio}} \front@write{\nofiles} \expandafter\front@write\expandafter{\front@thefont} @@ -152,6 +169,9 @@ \def\@front@#1{TT\fi\@nameuse{iffront@#1}} \iffront@write \newcommand{\Preambolo}[1]{\front@write{#1}} +\newenvironment{Preambolo*} + {\@makeother\%\@makeother\^^M\newlinechar=`\^^M + \Collect@Body\front@write}{} \newcommand{\Rientro}[1]{\front@write{\Rientro{#1}}} \newcommand{\Margini}[4]{\front@write{\Margini{#1}{#2}{#3}{#4}}} \newcommand{\Logo}[2][1.5cm]{\front@write{\Logo[#1]{#2}}} @@ -205,13 +225,12 @@ \define@key{filigrana}{after}[1]{\def\front@logoafter{#1}} \newcommand{\Filigrana}[2][height=10cm]{% \setkeys{filigrana}{#1}% - \AddToShipoutPicture*{% - \put(0,0){ - \parbox[b][\paperheight]{\paperwidth}{ - \vspace*{\stretch{\front@logobefore}} - \centering - \includegraphics[height=\front@logoheight]{#2} - \vspace{\stretch{\front@logoafter}} + \AtBeginShipoutNext{\AtBeginShipoutUpperLeft{% + \vtop to\paperheight{\hsize=\paperwidth + \vspace*{\stretch{\front@logobefore}} + \centering + \includegraphics[height=\front@logoheight]{#2} + \vspace{\stretch{\front@logoafter}} }}}} \newcommand{\Universita}[1]{\def\front@univ{#1}} \newcommand{\Istituzione}[1]{\def\front@instit{#1}\front@insttrue} @@ -267,8 +286,13 @@ #2\\% the candidate's name \def\next{#1}% \unless\ifx\next\@empty - \frontsmallfont Matricola #1\\[\frontcandidatesep] + \frontsmallfont {Matricola }#1\\[\frontcandidatesep] \fi} +\ifdefined\front@nouppercase + \let\front@MakeUppercase\@firstofone +\else + \let\front@MakeUppercase\MakeUppercase + \fi \def\preparefrontpage{% \titlepage\front@font \centering @@ -292,11 +316,9 @@ \front@multiple \else \if\@front@{division} - \MakeUppercase{\front@division} + \front@MakeUppercase{\front@division} \else - \MakeUppercase{\front@thefacoldip} - DI - \MakeUppercase{\front@facoldip} + \front@MakeUppercase{\front@thefacoldip\space di \front@facoldip} \fi \fi\\ \if\@front@{school} @@ -423,24 +445,27 @@ {\def\front@cp{\null\thispagestyle{empty}\newpage \advance\c@page\m@ne}} {\let\front@cp\relax} +\newif\if@front@message +\def\front@message{% + \PackageWarningNoLine{frontespizio} + {Remember to compile \jobname-frn with\MessageBreak + \ifpdf + pdflatex \jobname-frn% + \else + \ifxetex + xelatex \jobname-frn + \else + latex \jobname-frn\MessageBreak + dvips -o \jobname-frn.eps \jobname-frn% + \fi + \fi\MessageBreak + and then rerun \ifpdf pdf\fi \ifxetex xe\fi latex}} \def\frontespizio{% \titlepage\null - \IfFileExists{\jobname-frn.\front@ext} - {\AddToShipoutPicture*{\includegraphics{\jobname-frn}}} - {\AtEndDocument{% - \PackageWarningNoLine{frontespizio} - {Remember to compile \jobname-frn with\MessageBreak - \ifpdf - pdflatex \jobname-frn% - \else - \ifxetex - xelatex \jobname-frn - \else - latex \jobname-frn\MessageBreak - dvips -o \jobname-frn.eps \jobname-frn% - \fi - \fi\MessageBreak - and then rerun \ifpdf pdf\fi \ifxetex xe\fi latex}}} + \IfFileExists{\jobname-frn.\front@ext} + {\AtBeginShipoutNext{\AtBeginShipoutUpperLeft{% + \vbox to\z@{\hbox{\includegraphics{\jobname-frn}}\vss}}}} + {\@front@messagetrue}% \afterpage{\thispagestyle{empty}}% \endtitlepage \if@twoside\front@cp\fi @@ -450,6 +475,15 @@ \front@write{\preparefrontpage} \front@write{\end{document}} \iffront@write\immediate\closeout\front@out\fi + \ifdefined\front@mdfiveold + \xdef\front@mdfivenew{\pdfmdfivesum file{\jobname-frn.tex}}% + \ifx\front@mdfiveold\front@mdfivenew\else + \@front@messagetrue + \fi + \fi + \if@front@message + \AtEndDocument{\front@message} + \fi } \endinput %% diff --git a/Master/tlpkg/libexec/ctan2tds b/Master/tlpkg/libexec/ctan2tds index 03ed7d288bd..1c1255497f6 100755 --- a/Master/tlpkg/libexec/ctan2tds +++ b/Master/tlpkg/libexec/ctan2tds @@ -144,6 +144,7 @@ $Master = "$mydir/../.."; 'changebar', "&MAKEchangebar", 'chapterbib', "die 'skipping, update cite instead'", 'chemarrow', "&MAKEflatten", # check about Arrow.vfb + 'chemstruct', "die 'skipping, old latex 2.09, never in tl'", 'chemsym', "die 'skipping, nonfree'", 'cheq', "die 'skipping, nosell license'", 'china2e', "die 'skipping, nosell license'", -- cgit v1.2.3