summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/toptesi
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-11-26 22:45:01 +0000
committerKarl Berry <karl@freefriends.org>2016-11-26 22:45:01 +0000
commit5ec59d92d414cc91f4563a3fb15ae210f2981a03 (patch)
treede6b4a128e71d8631e116ef06df41520e3e37ffb /Master/texmf-dist/source/latex/toptesi
parent20b4c151cb6df453a13d1ea9041e7500a6f0f784 (diff)
toptesi (26nov16)
git-svn-id: svn://tug.org/texlive/trunk@42586 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/toptesi')
-rw-r--r--Master/texmf-dist/source/latex/toptesi/toptesi.dtx138
1 files changed, 73 insertions, 65 deletions
diff --git a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx
index 60295868a28..c27fbef0194 100644
--- a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx
+++ b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx
@@ -27,7 +27,7 @@ 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.cls, toptesi.sty, topfront.sty, topcoman.sty,
toptesi.cfg, and the English documentation toptesi.pdf.
Furthermore the bundle contains the documentation source
@@ -107,7 +107,7 @@ lines of the file for how-to information.
%<topcmn>\ProvidesPackage{topcoman}[%
%<topfrn>\ProvidesPackage{topfront}[%
%<*driver,class,topsty,topcmn,topfrn>
-2016/10/10 v.5.9.05
+2016/11/25 v.5.9.06
%<class>Class for typesetting university theses]
%<topsty>Extension for toptesi.cls]
%<topcmn>Additional commands for the TOPtesi bundle]
@@ -138,7 +138,7 @@ lines of the file for how-to information.
%</driver>
% \fi
%
-% \CheckSum{2842}
+% \CheckSum{2847}
%
% \begin{abstract}
% This file describes the TOPtesi bundle; it is a set of files designed to
@@ -570,27 +570,29 @@ lines of the file for how-to information.
% to the proper places.
% \end{enumerate}
%
-% The TOPtesi bundle adds very little to the user commands; nevertheless the package
-% \texttt{topcoman.sty}, that is part of this bundle and is automatically loaded, defines
-% some useful commands for typesetting technical matters in such a way as to fulfil the
-% ISO regulations.
-% Some of these commands are already defined with the \texttt{babel} Italian option,
-% but if your thesis is written in different languages it may happen that such
-% commands are not available any more when you select another language; with the
-% presence of the definitions contained in \texttt{topcoman.sty} such useful commands
-% remain available with every language. The \texttt{polyglossia} package does not
-% produce any useful additional command for writing in a ISO compliant way, therefore
-% the macros contained in the \texttt{topcoman.sty} package come very handy.
+% The TOPtesi bundle adds very little to the user commands; nevertheless the
+% package \texttt{topcoman.sty}, that is part of this bundle and is
+% automatically loaded, defines some useful commands for typesetting technical
+% matters in such a way as to fulfil the ISO regulations.
+% Some of these commands are already defined with the \texttt{babel} Italian
+% option, but if your thesis is written in different languages it may happen
+% that such commands are not available any more when you select another
+% language; with the presence of the definitions contained in
+% \texttt{topcoman.sty} such useful commands remain available with every
+% language. The \texttt{polyglossia} package does not produce any useful
+% additional command for writing in a ISO compliant way, therefore the macros
+% contained in the \texttt{topcoman.sty} package come very handy.
%
% The following description specifies these particular commands.
% \begin{description}
% \def\Item[#1]{\item[\normalfont\texttt{\char92#1}]}
% \Item[DeclareSlantedCapitalGreekLetters] does exactly what its name
-% means: it changes the definitions of the mathematical capital Greek letters so that
-% they are typeset in ``italics''; they are in effects taken from the math
-% italic alphabet, instead of the default roman one. This option is useful with \LaTeX,
-% while with \XeLaTeX\ it is unnecessary due to the larger set of math alphabets and math
-% font commands that are available with proper UNICODE math fonts.
+% means: it changes the definitions of the mathematical capital Greek letters
+% so that they are typeset in ``italics''; they are in effects taken from
+% the math italic alphabet, instead of the default roman one. This option
+% is useful with \LaTeX, while with \XeLaTeX\ it is unnecessary due to the
+% larger set of math alphabets and math font commands that are available
+% with proper UNICODE math fonts.
% %
% \Item[ensuremath] should be already defined in the \LaTeX\ kernel;
% should one still be using an obsolete version, this command gets
@@ -617,24 +619,27 @@ lines of the file for how-to information.
% measure in upright type; this works both in math and text mode. Of
% course it is necessary to input the |\unit| command without intervening
% spaces in the source file; it's necessary to typeset, say,
-% |35\unit{km}| and to avoid writing \verb*+35 \unit{km}+. This command,
+% |35\unit{km}| while avoiding \verb*+35 \unit{km}+. This command,
% as it is defined, conflicts with the definition of the homonymous
% command |\unit| as defined by the \texttt{unitsx} package, but since
% this latter package is necessarily input in the preamble, while
-% \texttt{topcomand.sty} is read at the execution of |\begin{document}|,
-% the latter file ha provisions to test if |unitsx| has already been loaded,
+% \texttt{topcoman.sty} is read at the execution of |\begin{document}|,
+% the latter file has provisions to test if |unitsx| has already been loaded,
% so as not to overwrite the latter package definition and to avoid every
-% possible conflict.
+% possible conflict. On the opposite, if the user loads package |siunitx|
+% (the most performant one in the field of units and number handling),
+% the command |\unit| remains available, because it is redefined in terms
+% of this package commands.
% %
% \Item[micro] sets the decimal prefix $\mu$ when typesetting units of
% measure.
% %
% \Item[gradi] sets the small circle that defines the sexagesimal degrees, for
-% example $35^\circ$; it may be used also for the celsius degrees by writing in the
-% source file, say, |35\unit{\gradi C}| in order to get
+% example $35^\circ$; it may be used also for the celsius degrees by writing
+% in the source file, say, |35\unit{\gradi C}| in order to get
% $35\,^\circ\mathrm{C}$; notice the difference with |35\gradi|, that yields
% $35^\circ$ without any space between the measure and the ``degree'' little
-% circle; this is what the ISO regulations require; The small space inserted
+% circle; this is what the ISO regulations require; the small space inserted
% by |\unit| is required when the unit of measure symbol contains at least
% one letter.
% %
@@ -648,19 +653,19 @@ lines of the file for how-to information.
% require it is typed with an upright serifed font, just as operators are.
% %
% \Item[eu] inserts the Napier number symbol ``e'' in upright type; since
-% this entity is not a variable, but it is a mathematical constant, the ISO
+% this entity is not a variable, but is a mathematical constant, the ISO
% regulations require it to be written in upright type. The ISO regulations
% require the upright type for ``e'' and any other mathematical constant, but
-% the electron charge $e$ is typeset in math italics because this is physical
+% the electron charge $e$ is typeset in math italics because this is a physical
% ``constant'', not a mathematical one. \XeTeX\ allows to typeset upright
% math Greek letters, so there is the facility to typeset an upright ``pi''
-% (the number) to be distinguished from an slanted ''pi'' (the angle).
+% (the number) to be distinguished from a slanted ''pi'' (the angle).
% %
-% \Item[goodpagebreak] inserts a conditional page break in after the line
+% \Item[goodpagebreak] inserts a conditional page break after the line
% where this command appears; it is not equivalent to the |\raggedbottom|
% declaration that does not vertically justify any page, but tests the
% amount of space remaining on the page, and if less than a given number of
-% lines are available inserts a page break; the result is a ragged bottom
+% lines are available, it inserts a page break; the result is a ragged bottom
% single page, that sometimes is better than loose spacing between paragraphs,
% or within items of a list, or before or after displayed material. It is
% handy also to use before starting a new section, because at least four
@@ -680,15 +685,15 @@ lines of the file for how-to information.
% that might be used as an independent extension package with any document class.
%
% \section{PDF/A archivable format}
-% This section in general applies also if the thesis is typeset by means
-% of \XeLaTeX, but in this case special attention should be given to the
-% details of the procedure as described in the documentation of the
+% This section in general applies also if the thesis is typeset by means of
+% \XeLaTeX\ or \LuaLaTeX, but in this case special attention should be given
+% to the details of the procedure as described in the documentation of the
% \pack{pdfx} package. Even better, \LuaLaTeX, whose source file is
% practically the same as that of \XeLaTeX, may produce in a simpler way
% a PDF/A compliant output file if the users follow attentively the
% instructions contained in the documentation of the \pack{pdfx} package.
%
-% More details are given in the Italian documentation contained in files
+% More details are given in the Italian documentation contained in file
% \texttt{toptesi\discretionary{-}{}{-}it-pdftex}.
%
% Politecnico di Torino as well as many other Italian and foreign universities
@@ -738,22 +743,15 @@ lines of the file for how-to information.
% into a PS file; at this point you have lost the possibility of exploiting
% the internal commands of |pdflatex| version 1.40.9 or later. You can still
% produce a PDF/A final document, but you have to transform it by means of
-% |ghostscript|; read the |ghostscript| (version 9.16 or later) documentation
-% file |ps2pdf.html| in order to find out how to produce the correct
-% PS-to-PDF/A transformation. The documentation in
-% Italian describes several more or less effective methods to transform
+% the procedures described in the Italian documentation; such documenttion
+% describes several more or less effective methods to transform
% a non compliant PDF/A file into a compliant one, and how to correct the
-% ``imperfections'' that forbid any valid transformation.
-%
-% \item As said before, \prog{lualatex} used to be partially compatible
-% with package \pack{pdfx}, because in spite of having a typesetting
-% engine that has a strong resemblance with \prog{pdftex} it did not
-% contain all its primitives; therefore it was necessary to load other
-% packages e create some little patches. Since 2016 the TeXLive
-% distribution contains a new version of \pack{pdfx} and now PDF documents
-% produced with \prog{lualatex} may be fully compatible with the standard
-% PDF/A. With some special care, even \prog{xelatex} can now produce PDF/A
-% compliant output files.
+% ``imperfections'' that forbid any valid transformation.
+%
+% \item Since 2016 the TeXLive distribution contains a new version of
+% \pack{pdfx} and now PDF documents produced with \prog{lualatex} may be
+% fully compatible with the standard PDF/A. With some special care, even
+% \prog{xelatex} can now produce PDF/A compliant output files.
%
% \item Your up-to-date complete \TeX\ distribution should contain the package
% \textsf{pdfx}; if it does not, upgrade your \TeX\ system complete
@@ -804,6 +802,11 @@ lines of the file for how-to information.
% Pro~XI, but this, although the most authoritative, is a commercial program;
% probably your university has special facilities for this task.
%
+% \item There exist an experimental freeware program \prog{veraPDF} that
+% can be downloaded from the Web, that performs quite well in checking
+% the PDF/A conformity of a PDF file; read more in the \pack{TOPtesi}
+% Italian documentation.
+%
%\end{enumerate}
%
% Warning: if you are using Adobe Reader X (or later), this program will open
@@ -817,7 +820,7 @@ lines of the file for how-to information.
% problems that are of great concern for the large Institutions that have
% thousands of documents a year to archive; it is not a question implied
% in the free nature of the \prog{pdflatex}, \prog{xelatex}, and \prog{lualatex}
-% programs, that, on the opposite, according to my experience have a very high
+% programs, that, on the opposite, according to my experience, have a very high
% rate of success in producing PDF/A compliant documents. If you stick to the
% default \TeX\ system Type~1, 256-glyph fonts, or to the UNICODE encoded otf
% or ttf fonts and use this version of \texttt{TOPtesi} you should be able
@@ -1650,7 +1653,7 @@ Skipping any redefinition\MessageBreak}%
% has shown that loading these packages does not need to be deferred al the
% ``begin document'' level with pdf\/\LaTeX, it does not hurt to delay their
% loading operation with both engines. This delayed loading implies that the
-% commands defined in |topfront| and in |topcomand| cannot be used in the
+% commands defined in |topfront| and in |topcoman| cannot be used in the
% preamble.
% \begin{macrocode}
\AtBeginDocument{%
@@ -3079,12 +3082,14 @@ Skipping any redefinition\MessageBreak}%
%<*topcmn>
% \fi
%
-% The new command |\DeclareSlantedCapitalGreekLetters| optionally sets the capital
-% Greek letters in math mode with the glyphs taken from the math italic fonts, not from
-% the math roman fonts, as it is by default; some authors prefer to use both symbols
-% with different meanings, so this command lets them do so. This may be useful unless
-% the XeTeX typesetting engine is used; in facts the Unicode math defines specific
-% commands for setting any Latin or Greek mathematical letter in any possible font shape and series.
+% The new command |\DeclareSlantedCapitalGreekLetters| optionally sets the
+% capital Greek letters in math mode with the glyphs taken from the math
+% italic fonts, not from the math roman fonts, as it is by default; some
+% authors prefer to use both symbols with different meanings, so this
+% command lets them do so. This may be useful unless the XeTeX or LuaTeX
+% typesetting% engine is used; in facts the Unicode math defines specific
+% commands for setting any Latin or Greek mathematical letter in any possible
+% font shape and series.
% \begin{macrocode}
\RequirePackage{iftex}
\ifPDFTeX
@@ -3102,12 +3107,14 @@ Skipping any redefinition\MessageBreak}%
\mathchardef\Omega="710A
}\fi
% \end{macrocode}
-% The |\ensuremath| command is defined in the \LaTeXe\ kernel from a certain version on;
-% should the user employ a really old \LaTeXe\ implementation, this definition
-% supplies the missing one. Should the |babel| package not be loaded, then we provide the
-% useful command |\textormath| provided by |babel|. We define the text version of the
-% subscript and ensure also that the |textcomp| package is loaded; of course if it is
-% already loaded the |\RequirePackage| command performs the necessary tests and possibly
+%
+% The |\ensuremath| command is defined in the \LaTeXe\ kernel from a certain
+% version on; should the user employ a really old \LaTeXe\ implementation,
+% this definition supplies the missing one. Should the |babel| package not
+% be loaded, then we provide the useful command |\textormath| provided by
+% |babel|. We define the text version of the subscript and ensure also
+% that the |textcomp| package is loaded; of course if it is already loaded
+% the |\RequirePackage| command performs the necessary tests and possibly
% does not load anything.
% \begin{macrocode}
\providecommand*\ensuremath[1]{\ifmmode#1\else$#1$\fi}%
@@ -3132,7 +3139,8 @@ Skipping any redefinition\MessageBreak}%
\providecommand{\ohm}{\textormath{\textohm}{\mathrm{\Omega}}}
\providecommand{\ped}[1]{\textormath{\textsubscript{#1}}{_{\mathrm{#1}}}}
\providecommand{\ap}[1]{\textormath{\textsuperscript{#1}}{^{\mathrm{#1}}}}
-\providecommand{\unit}[1]{\ensuremath{{\mathrm{\,#1}}}}
+\@ifpackageloaded{siunitx}{\def\unit#1{\si{\,#1}}}{%
+\providecommand\unit[1]{\ensuremath{{\mathrm{\,#1}}}}}
\providecommand{\gei}{\ensuremath{{\mathop{\mathrm{j}}\nolimits}}}
\providecommand{\eu}{\ensuremath{{\mathop{\mathrm{e}}\nolimits}}}
\providecommand{\micro}{\textormath{\textmu}{%