From 5ec59d92d414cc91f4563a3fb15ae210f2981a03 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 26 Nov 2016 22:45:01 +0000 Subject: toptesi (26nov16) git-svn-id: svn://tug.org/texlive/trunk@42586 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/source/latex/toptesi/toptesi.dtx | 138 +++++++++++---------- 1 file changed, 73 insertions(+), 65 deletions(-) (limited to 'Master/texmf-dist/source/latex/toptesi') 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. %\ProvidesPackage{topcoman}[% %\ProvidesPackage{topfront}[% %<*driver,class,topsty,topcmn,topfrn> -2016/10/10 v.5.9.05 +2016/11/25 v.5.9.06 %Class for typesetting university theses] %Extension for toptesi.cls] %Additional commands for the TOPtesi bundle] @@ -138,7 +138,7 @@ lines of the file for how-to information. % % \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}{% -- cgit v1.2.3