From 73cd5c082800b6704a33df225536f0d8f761c42f Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 17 Nov 2010 00:34:16 +0000 Subject: toptesi (16nov10) git-svn-id: svn://tug.org/texlive/trunk@20458 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/source/latex/toptesi/toptesi.dtx | 370 +++++++++++++-------- Master/texmf-dist/source/latex/toptesi/toptesi.ins | 113 ------- 2 files changed, 235 insertions(+), 248 deletions(-) delete mode 100644 Master/texmf-dist/source/latex/toptesi/toptesi.ins (limited to 'Master/texmf-dist/source') diff --git a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx index af35263e2d9..1b1cc98ce47 100644 --- a/Master/texmf-dist/source/latex/toptesi/toptesi.dtx +++ b/Master/texmf-dist/source/latex/toptesi/toptesi.dtx @@ -1,4 +1,64 @@ % \iffalse meta-comment +%<*internal> +\begingroup +\input docstrip.tex +\keepsilent +\preamble + ______________________________________________________ + The TOPtesi package + Copyright (C) 2010 Claudio Beccari + All rights reserved + + License information appended + +\endpreamble +\postamble + +Copyright 2005-2010 Claudio Beccari + +Distributable under the LaTeX Project Public License, +version 1.3c or higher (your choice). The latest version of +this license is at: http://www.latex-project.org/lppl.txt + +This work is "author-maintained" + +This work consists of this file toptesi.dtx, a README file +and the derived files: + +toptesi.cls, toptesi.sty, topfront.sty, topcommand.sty, topsize14, +trieste.sty, toptesi.cfg, and the English documentation toptesi.pdf; + +Furthermore the bundle contains the documentation source file toptesi-doc.tex +and the derived file toptesi-doc.pdf. + +The toptesi-example.tex source file is just an example that shows how +to use the various commands; by commenting or decommenting certain +source lines it is possible to typeset different kind of theses and their +frontpages. + +The toptesi.cfg file is a sample of a local configuration file that can be +freely edited and modified. + +By running pdflatex on toptesi.dtx the user gets the class, sty and cfg files +and the English documentation file in pdf format. + +The documentation file toptesi-doc.pdf is in Italian; its source file is +another example of how to use toptesi. +\endpostamble +\askforoverwritefalse + +\generateFile{toptesi.cls}{t}{\from{toptesi.dtx}{class}} +\generateFile{toptesi.sty}{t}{\from{toptesi.dtx}{topsty}} +\generateFile{topcoman.sty}{t}{\from{toptesi.dtx}{topcmn}} +\generateFile{topfront.sty}{t}{\from{toptesi.dtx}{topfrn}} +\generateFile{topsiz14.clo}{t}{\from{toptesi.dtx}{top14}} +\generateFile{trieste.sty}{t}{\from{toptesi.dtx}{toptrst}} +\generateFile{toptesi.cfg}{t}{\from{toptesi.dtx}{topcfg}} + +\def\tmpa{plain} +\ifx\tmpa\fmtname\endgroup\expandafter\bye\fi +\endgroup +% % % Copyright 1989--2006 Claudio Beccari % @@ -27,7 +87,7 @@ % \iffalse %<*driver> \documentclass{ltxdoc} -\ProvidesFile{toptesi.dtx}[2010/05/09 v.5.01 Documented TeX file for +\ProvidesFile{toptesi.dtx}[2010/11/14 v.5.02 Documented TeX file for the TOPtesi bundle] \GetFileInfo{toptesi.dtx} \title{The TOPtesi bundle} @@ -42,7 +102,7 @@ the TOPtesi bundle] % % \fi % -% \CheckSum{2905} +% \CheckSum{2917} % %% \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 @@ -63,14 +123,15 @@ the TOPtesi bundle] % \begin{abstract} % This file describes the TOPtesi bundle; it is a set of files designed to % typeset with \LaTeX\ a university final report that in Italian is generally -% called ``tesi''; It was originally developed at the Technical University +% called ``tesi''; it was originally developed at the Technical University % of Turin (Politecnico di Torino) but it was adapted for typesetting theses in any % Italian university. Well\dots\ since the Erasmus student mobility is very % extended and many Italian students participate in the so called \textit{double degree} -% programs; their theses, or whatever they are called in other countries, +% programs, their theses, or whatever they are called in other countries, % may be typeset so as to comply also with the host university rules; therefore this % set of files has the ambition to be suited for typesetting theses in any university in the -% world\dots +% world\dots\ This ambition can't be fulfilled, though, because of the complexity of the +% title page (and possibly of the legal page) requirements. % \end{abstract} % % \section{Introduction} @@ -93,46 +154,48 @@ the TOPtesi bundle] % independent extension package to be added to, say, the report class file for typesetting % just the title page; this file might be used as a template for setting up the % title page fixed information in languages different from Italian. -% \item A third extension package \texttt{topcomand.sty} that defines a certain number +% \item A third extension package \texttt{topcoman.sty} that defines a certain number % of user commands suitable for typesetting technical matters. % \item A fourth extension package \texttt{trieste.sty} and its accompanying package option % \texttt{topsiz14.clo} that is used as an option by % \texttt{toptesi.cls} in order to define a certain number of variations required -% for theses in humanities at the university of Trieste; these variations are not so important -% ones, but they may be preferred also in other faculties so that the suitable option +% for theses in humanities at the university of Trieste; these variations are not that +% important, but they may be preferred also in other faculties so that the suitable option % comes handy also in other situations. -% \item The logos of a certain number of Italian universities both in \texttt{.eps} and in -% \texttt{.jpg} or \texttt{.pdf} formats; such logos are included for the user sake, but +% \item The logos of a certain number of Italian universities in \texttt{.eps}, +% \texttt{.jpg}, and \texttt{.pdf} formats; such logos are included for the user sake, but % the user should pay attention to use them according to the rules and limitations of -% each university and is strongly advised to look up such regulations in each university Web -% site. +% each university and it is strongly advised to look up such regulations in each +% university Web site. % \item A documentation file \texttt{toptesi-doc.pdf} written in Italian where every feature -% is explained in detail; simpler information is given in this English documentation. +% is explained in detail; essential information is given in this English documentation. % \end{itemize} % % The above files are complemented with a configuration file that any user may % personalize at will; these personalizations make it easy to configure the % bundle so as to make it suitable for another language; in facts the \textsf{babel} -% package contains localizations for many languages but they refer to the standard -% infix \LaTeX\ names and phrases and they do not cope with the thesis title page requirements. +% package contains localizations for many languages, but such localisations deal +% with the standard infix \LaTeX\ names and phrases and do not cope with the thesis +% title page requirements. % % \section{User commands} % The \texttt{toptesi.cls} is basically an extension of the standard class -% \texttt{report.cls}; It redefines the page typesetting grid, the headers and the footers, +% \texttt{report.cls}; it redefines the page typesetting grid, the headers and the footers, % and the title page layout and commands. % \texttt{toptesi.cls} does not set such crazy settings as ``double spaced'' text; it is % intended to typeset the thesis with the quality of a \LaTeX\ well typeset document, not as % a typewriter written one. I suppose that typewriter documents have completely vanished % except perhaps in the legal professions, especially in Italy where legal documents have to -% be written on special paper produced by the State Polygraphic Institute and carrying a +% be written on special paper produced by the State Polygraphic Institute and carry a % watermark and the Republic's Seal; without a special printer it would be very difficult to -% typeset on such a paper. +% typeset from a computer on such a custom paper. % % Theses very often are full of specialized material: formulas, diagrams and pictures, -% texts written in non latin alphabets, special symbols for philological mark-up, and the like; -% a common typewriter would not be suitable and the quality of the contents requires professional -% typesetting; this is why I strongly believe that instructions on typesetting styles that -% refer to the good old times of mechanical typewriters should be banned. +% texts written in non latin alphabets, special symbols for philological mark-up, and +% the like; a common typewriter would not be suitable and the quality of the contents +% requires professional typesetting; this is why I strongly believe that instructions +% on typesetting styles that refer to the good old times of mechanical typewriters +% should be banned. % % Most new commands refer themselves to the information that should be typeset in the % title page; some class options specify special stylistic page details; the rest is simple @@ -154,23 +217,24 @@ the TOPtesi bundle] % % \Item[cucitura] In two sided printing it is better to move the % typesetting grid towards the outer edges so as to cope with the thesis binding -% that is generally not made by sawing a number of signatures; the outer displacement -% is fixed to~7mm. +% that is generally not made up by sewing together a number of signatures; +% the default outer displacement is fixed to~7mm, but it can be customized by means +% of a proper entry in the configuration file or by an explicit command in the preamble. % % \Item[14pt] Extends the normal size choice to 14 points; it is appreciated % in various fields of humanities, but I would discourage this use in a technical % thesis, where 10 point perhaps is too small, but 11 point or 12 point typesetting -% may be adequate. It is worth mentioning that this option implements the font -% settings in e different way from what is being done with the \texttt{extsizes} bundle of -% classes; this is why the original \texttt{size14.clo} class option file has been renamed +% may be adequate. It is worth mentioning that this option implements the font +% settings in a different way from what is being done with the \texttt{extsizes} package +% bundle; this is why the original \texttt{size14.clo} class option file has been renamed % \texttt{topsiz14.clo} so as to avoid conflicts with the \texttt{size14.clo} file belonging % to that bundle. % -% \Item[autoretitolo] This option modifies the left handed (even numbered) pages -% in two side typesetting; normally the even numbered headings contain +% \Item[autoretitolo] This option modifies the left hand (even numbered) pages +% in two side typesetting; normally the even numbered page headings contain % the chapter title, while the odd numbered ones contain the current section title. % If the \texttt{classica} option has been specified, then with this option it is possible to -% have even numbered % headings contain the author's name and the thesis title, while the odd +% have even numbered headings contain the author's name and the thesis title, while the odd % numbered ones contain the chapter title. Since the thesis title might be too % long to fit in the header together with the author's name, the |\title| macro % as been modified so as to accept an optional short title, similarly to the @@ -192,8 +256,9 @@ the TOPtesi bundle] % typeset, possibly with hilarious results\dots % % Since most users are supposed to be Italian, the user commands are mostly in Italian; -% the following description gives their names and meanings; every command receives an argument; -% only the command |\title| accepts an optional argument according to the usual \LaTeX\ syntax: +% the following description gives their names and meanings; every command receives one +% argument; only the command |\title| accepts an optional argument according to the usual +% \LaTeX\ syntax: % \[ % \makebox[0pt]{% % \texttt{\char92}\emph{command}\relax @@ -216,54 +281,58 @@ the TOPtesi bundle] % \Item[coordinatore] gets the name of the Doctoral School Coordinator % \Item[QualificaDirettore] gets the phrase that describes the director or coordinator % official position; by using the command \cs{direttore} the default phrase -% ``Direttore della Scuola di Dottorato'' is printed over the ``director's'' name; +% ``Direttore della Scuola di Dottorato'' is printed above the +% ``director's'' name; % if \cs{coordinatore} is used the default phrase ``Coordinatore della % Scuola di Dottorato'' is printed instead. If neither one is applicable or a % description in another language is required, this macro is available for % specifying such position. -% \Item[relatore] gets the name of thesis first supervisor +% \Item[relatore] gets the name of the thesis first supervisor % \Item[secondorelatore] gets the name of the second supervisor -% \Item[terzorelatore] gets the name of the third supervisor; it is assumed that the number of supervisors -% never exceeds three. +% \Item[terzorelatore] gets the name of the third supervisor; it is assumed that the +% number of supervisors never exceeds three. % \Item[tutore] gets the name of the doctorate tutor; there is no difference with regards -% to the \cs{relatore}, but the default phrase ``Tutore'' is printed over this -% person's name. +% to the \cs{relatore}, but the default phrase ``Tutore'' is printed above +% this person's name. % \Item[TutorName] gets the phrase that describes the tutor position, possibly in a different % language. % \Item[AdvisorName] gets the string that qualifies the supervisor(s); the default string % is ``Relatore:'' or ``Relatori:'' for the plural; in another language % this command is used to define the string, say, ``Supervisors:'' if the % thesis has been supervised by more than one person. -% \Item[CoAdvisorName] gets the string that qualifies the co-supervisor(s); the default string is -% ``Correlatore:'' or ``Correlatori:'' in the plural; this command may be used to -% define the string, say, ``Corapporteur:'' in a French Projet de fin -% d'\'etudes. -% \Item[candidato] gets the name of the male student -% \Item[candidata] gets the name of the female student -% \Item[secondocandidato] gets the name of the second male student -% \Item[secondacandidata] gets the name of the second female student -% \Item[terzocandidato] gets the name of the third male student -% \Item[terzacandidata] gets the name of the third female student; most often the thesis +% \Item[CoAdvisorName] gets the string that qualifies the co-supervisor(s); the default +% string is ``Correlatore:'' or ``Correlatori:'' in the plural; this +% command may be used to define the string, say, ``Corapporteur:'' in a +% French Projet de fin d'\'etudes. +% \Item[candidato] gets the name of the male author +% \Item[candidata] gets the name of the female author +% \Item[secondocandidato] gets the name of the second male author +% \Item[secondacandidata] gets the name of the second female author +% \Item[terzocandidato] gets the name of the third male author +% \Item[terzacandidata] gets the name of the third female author; most often the thesis % author is just one person; but there are some institutions where group % final works are accepted; it is assumed that the group does not contain more % than three authors. The specification of the gender allows the software -% to determine the correct labeling phrase in the proper gender and proper number. +% to determine the correct labeling phrase in the proper gender and proper +% number. % For different languages there might be no difference in gender but % there is a difference in the plural ending. -% \Item[CandidateName] gets the string that describes the student status in a foreign language -% or even in Italian; the default string is ``Candidato:'' (with colons) -% adjusted to masculine, or feminine, singular or plural; with the option -% \texttt{classica} the string becomes ``Laureato:''; in other languages -% it is necessary to specify this string in the proper gender and number -% \Item[sedutadilaurea] gets the date of the final exam, or presentation, or defense of the +% \Item[CandidateName] gets the string that describes the student status in a foreign +% language or even in Italian; the default string is ``Candidato:'' (with +% colons) adjusted to masculine or feminine, singular or plural; with the +% option \texttt{classica} the string becomes ``Laureando:''; in other +% languages it is necessary to specify this string in the proper gender and +% number. +% \Item[sedutadilaurea] gets the date of the final exam, or presentation, or defense of the % thesis; if this date is omitted the default date is the current -% month and year in Italian -% \Item[esamedidottorato] an alias for \cs{sedutadilaurea} to be used for doctoral dissertations -% \Item[ciclodidottorato] gets the roman numeral that specifies the doctoral cycle +% month and year in Italian. +% \Item[esamedidottorato] an alias for \cs{sedutadilaurea} to be used for doctoral +% dissertations. +% \Item[ciclodidottorato] gets the roman numeral that specifies the doctoral cycle. % \Item[CycleName] redefines the string that expresses the name of the doctoral cycle; % by default this is ``ciclo'' but this command is useful to set the % name in a different language. -% \Item[corsodilaurea] gets the proper name of the degree course; the phrase that describes +% \Item[corsodilaurea] gets the proper name of the degree course; the phrase that describes % the degree course is specified, if necessary, with the following % command; with this one you specify just, say, ``Electrical Engineering'' % \Item[CorsoDiLaureaIn] gets the generic name of the degree course, for example ``Bachelor @@ -274,71 +343,97 @@ the TOPtesi bundle] % it is ``Monografia di Laurea''. In some Italian universities it might % be called ``Tesi di Laurea'', so that the master thesis should be given % another qualification, for example ``Tesi di Laurea Magistrale''. -% \Item[NomeDissertazione] gets the phrase that describes the doctoral thesis; by default it is -% ``Tesi di Dottorato''. +% \Item[NomeDissertazione] gets the phrase that describes the doctoral thesis; by default +% it is ``Tesi di Dottorato''. % \Item[InName] infix strings often require adjusting of the prepositions; this macro gets % the preposition that stands for ``in'' (the default). In German it might -% become ``auf'' +% become ``auf''. % \Item[NomeAnnoAccademico] defines the infix string that stands for ``Academic year''. -% This macro is -% defined only if the option \texttt{classica} is in force; after all -% the command |\annoaccademico| is defined only with that option. -% \Item[logosede] specifies the name of the file that contains the university logo; no default -% is defined; rather a warning message is issued if no name is given -% or the file is missing, but typesetting goes on without the inclusion -% of any logo. +% This macro is defined only if the option \texttt{classica} is in force; +% after all the command |\annoaccademico| is defined only with that option. +% \Item[logosede] specifies the name of the file that contains the university logo; +% no default is defined; rather a warning message is issued if no name is +% given or the file is missing, but typesetting goes on without the inclusion +% of any logo. +% \Item[setbindingcorrection] sets up the length to displace the text block to the external +% margin so as to have a wider internal margin to accommodate for the binding +% correction. Its argument is not optional and is used to modify the default +% correction of 7\,mm. % \end{description} % % Since the infix strings are all memorized into control sequences and for each of them it % is possible to use a defining command, all strings can be modified at will, so that there -% is no difficulty to localize the package in another language; this comes particularly handy for the -% Erasmus students on double degree programs. +% is no difficulty to localize the package in another language; this comes particularly handy +% for the Erasmus students on double degree programs. % -% As a final remark notice that the commands for typesetting the title page are contained in the package -% \texttt{topfront.sty}, which can be used as an autonomous extension to the \texttt{report} -% document class. One could easily typeset just the title page with a separate \TeX\ source file -% so as to test the completeness of the commands and coherence of the configuration file or -% for just printing the isolated title page. +% As a final remark notice that the commands for typesetting the title page are contained +% in the package \texttt{topfront.sty}, which can be used as an autonomous extension to the +% \texttt{report} document class. One could easily typeset just the title page with a separate +% \TeX\ source file so as to test the completeness of the commands and coherence of the +% configuration file or for just printing the isolated title page. % % \subsection{Typesetting commands} % The bundle and the TOPtesi document class accept all \LaTeX\ commands provided by % the \LaTeX\ \texttt{kernel}, the \texttt{report} document class, and the \texttt{graphics} % extension package, besides those provided by the \texttt{babel} package. % -% With this respect it must be underlined that the Italian and English languages are specified by -% default, the Italian one being the default language. An initial specification of -% |\selectlanguage{english}| sets the English language as default. Should a student typeset the thesis -% in French, it would be necessary to specify the option \texttt{french} among the class options, -% and so start the document by specifying |\selectlanguage{french}|. Nevertheless these -% \texttt{babel} macros select the English or the French typesetting rules, but hyphenation -% is activated only if the program format file has been generated with the pertinent languages. +% With this respect it must be underlined that the Italian and English languages are specified +% by default, the Italian one being the default language. An initial specification of +% |\selectlanguage{english}| sets the English language as default. Should a student typeset +% the thesis in French, it would be necessary to specify the option \texttt{french} among the +% \emph{class} options, and so start the document by specifying |\selectlanguage{french}|. +% But the user should pay attention to use \texttt{babel} in the proper way: +% \begin{itemize} +% \item Due to the way \LaTeX\ classes load the requested files, and to the fact that the +% \texttt{babel} package has already been loaded by the \texttt{toptesi} class, the user +% cannot reload it with a different list of language options; therefore the latter language +% options \emph{must be specified} as global class options; therefore, if the thesis has +% to be typeset, fore example, in French, is is necessary to do the following: +%\begin{verbatim} +%\documentclass[...,french,...]{toptesi} +%... +%\begin{document} +%\selectlanguage{french} +%\end{verbatim} +% \item With the 2010 \TeX\ system distributions, both \TeX Live and MiKTeX, all known +% (to \LaTeX) language hyphenation rules are preloaded; with other less up to date +% \TeX\ system distributions this might not be true. +% Remember that \texttt{babel} macros select the language typesetting rules, but hyphenation +% is activated only if the program format file has been generated with the pertinent +% language hyphenation rules. You can check this detail by reading the first dozen of lines +% of your thesis \texttt{.log} file; there is the list of all language hyphenation rules that +% are available in the format file. % While (American) English is the default and almost any distribution of the \TeX\ system % has many language defaults, it is more likely that French is preloaded while Italian is not. -% The user should verify which are the default languages preloaded into the format file; this -% information is written in the very first lines of any \texttt{.log} file generated by any -% run of \LaTeX, \texttt{pdflatex} or even plain \TeX. -% -% Should the required languages be missing, the user is forced to read the distribution -% instructions, so as to find out how to configure his/her system so as to consider the languages -% s/he wants to work with, and finally s/he must recreate the format files and put them in -% the proper places of the standard or the local folder tree. The user is invited to carefully -% investigate on these fine points and to configure the system properly; it would be very -% upsetting using fine software for producing a perfectly typeset thesis that, unfortunately, -% has wrong hyphenation points! +% +% Should the required language(s) be missing, the user is forced to read his/her distribution +% instructions, so as to find out how to configure his/her system so as to consider the +% languages s/he wants to work with, and finally s/he must recreate the format files and put +% them in the proper places of the standard or the local folder tree. The user is invited to +% carefully investigate on these fine points and to configure the system properly; it would +% be very upsetting using fine software for producing a perfectly typeset thesis that, +% unfortunately, has wrong hyphenation points! Luckily enough, recent distributions of the +% \TeX\ system have all the known hyphenation rules preloaded; in any case even older +% distributions have available command line commands or graphical user interfaces that make +% it easy to perform the tasks of changing the list of preloaded hyphenation rules and +% rebuilding all the format files, moving them to the proper places. +% \end{itemize} % % The TOPtesi bundle adds very little to the user commands; nevertheless the package -% \texttt{topcomand.sty}, -% that is part of this bundle and is automatically loaded, defines some useful commands for -% typesetting technical matters in such a way as to fulfill the ISO regulations. -% Some of these commands are already defined in 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 -% another language is selected. +% \texttt{topcoman.sty}, that is part of this bundle and is automatically loaded, defines +% some useful commands for typesetting technical matters in such a way as to fulfill the 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 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 Geek +% 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. % % @@ -347,7 +442,7 @@ the TOPtesi bundle] % available anyhow. % % % \Item[ohm] typesets an upright capital omega even if the capital Greek -% letters are in italics; the good point is that |\ohm| can be used also +% letters are in italics; another good point is that |\ohm| can be used also % in text mode. % % % \Item[ped] inserts a subscript in upright type; the ISO regulations @@ -394,21 +489,24 @@ the TOPtesi bundle] % % % \Item[eu] inserts the Euler number symbol ``e'' in upright type; since % this entity is not a variable, but it is a mathematical constant, the -% ISO regulations require it to be written in upright type. The electron -% charge $e$ is not upright because this physical ``constant'' is not -% that constant\dots +% ISO regulations require it to be written in upright type. The ISO regulations require +% the upright type for ``e'' and any mathematical constant, but +% the electron charge $e$ is typeset in math italics because this physical +% ``constant'', not a mathematical one. % % -% \Item[listing] requires for its argument the name of a file and typesets it in verbatim mode; -% this command is very useful for typesetting the listings of the programs that were written -% for the thesis; for best results it is recommended that the source program has lines not -% longer than 80 characters. +% \Item[listing] requires for its argument the name of a file and typesets it in verbatim +% mode; this command is very useful for typesetting the listings of the programs that were +% written for the thesis; for best results it is recommended that the source program has +% lines not longer than 80 characters. There exists an external package \texttt{listings}, +% that the user might want to load, that does a similar work in a more professional and +% configurable way; our package simpler command might be preferable for its simplicity. % \end{description} % % All these commands are defined into the separate package \texttt{topcoman.sty} -% that can be used as an independent extension package for any document class. +% that can be used as an independent extension package with (possibly) any document class. % % \section{Format PDF suitable for archiving} -% Politecnico di Torino as well as many other Italian and non Italian universities are +% Politecnico di Torino as well as many other Italian and foreign universities are % moving towards archiving theses in electronic format, specifically in the PDF one. The % problem of course is: ``Will it be possible to read the archived documents, say, fifty % years from now?'' @@ -440,13 +538,13 @@ the TOPtesi bundle] % summarized as follows: % \begin{itemize} % \item The preliminary essential requirement is that the \texttt{pdflatex} used to -% typeset the thesis be sufficiently recent to support the PDF/A requirements. Have -% a 2008, or even better, a 2009 version of the \TeX\ system installed on your PC. +% typeset the thesis be sufficiently recent to support the PDF/A requirements. It's +% better to have the most recent distribution of the \TeX\ system installed on your PC. % Do not try to typeset the thesis -% with the `old' \LaTeX; you must process the input thesis file(s) with +% with the `old' \LaTeX; you \emph{must} process the input thesis file(s) with % \texttt{pdflatex}; in the following, no specific check will be made in order -% to verify if you are actually -% using \texttt{pdflatex}. If you really need to use the `old' \LaTeX, you get a DVI +% to verify if you are actually using \texttt{pdflatex}. +% If you really need to use the `old' \LaTeX, you get a DVI % file and you need to transform it with |dvips| into a PS file; at this point you % have lost the possibility of exploiting the internal commands of |pdflatex| version % 1.40.9 or later. You can still produce a PDF/A final document, but you have to @@ -455,11 +553,11 @@ the TOPtesi bundle] % to PDF/A transformation. % \item Download from \textsc{ctan} and install the package \textsf{pdfx}, if it is -% not already part of your \TeX\ system installation. % \item Install in the main -% \texttt{pdfx} directory a good version of a color model +% not already part of your \TeX\ system installation. +% \item Install in the main \texttt{pdfx} directory a good version of a color model % profile file, such as, for example, \texttt{ECI-RGB-V1.0.icc} (see in the download % page of the site \texttt{www.eci.org}). -%\item If your thesis main file, the one you run your \texttt{pdflatex} on, is named, +% \item If your thesis main file, the one you run your \texttt{pdflatex} on, is named, % say, \texttt{JohnSmithMasterThesis.tex}, prepare in the same directory another file % named \texttt{JohnSmithMasterThesis.xmpdata} that contains the \emph{metadata} % relative to the thesis; pay attention to follow the stringent syntax described and @@ -471,19 +569,19 @@ the TOPtesi bundle] % \end{verbatim} % Keywords require a specific XML style format that can be examined in the package % documentation. -%\item Some mathematical symbol commands obtained from the standard \LaTeX\ set-up +% \item Some mathematical symbol commands obtained from the standard \LaTeX\ set-up % and the standard mathematical fonts require some patching that is already included % in this \texttt{ToPtesi} bundle; but it is not excluded that with other fonts similar % patches might be requested. -%\item Use only PNG and JPEG images with RGB color profiles. -%\item If you include PDF images that contain some text, be sure that the font for +% \item Use only PNG and JPEG images with RGB color profiles. +% \item If you include PDF images that contain some text, be sure that the font for % this text is completely embedded in the included file. Should the PDF file come % from an external drawing program be sure to configure that program so that it embeds % all the fonts used in the image. If you don't succeed, open the PDF file with % the free program \texttt{inkscape} and save it back in PDF format; the missing fonts % will be replaced with their traced outlines and this will not disturb the PDF/A % conformity. -%\item Verify your final PDF file with a suitable program and do not give up doing the +% \item Verify your final PDF file with a suitable program and do not give up doing the % necessary corrections or modifications while the verification program keeps saying % the this or that is not conforming to the PDF/A specification. A suitable program % is the Preflight plug-in of Adobe Acrobat Professional version 8 or later, but this, @@ -495,10 +593,9 @@ the TOPtesi bundle] % that are of great concern for the large Institutions that have thousands of document % a year to archive; it is not a question implied in the free nature of the % \texttt{pdflatex} program, that, on the opposite, according to our experience has -% a very high rate of -% success in producing PDF/A conforming documents. If you stick to the default \TeX\ -% system fonts and use this patched version of \texttt{ToPtesi} you should be able to -% avoid most problems. +% a very high rate of success in producing PDF/A conforming documents. If you stick to +% the default \TeX\ system fonts and use this patched version of \texttt{ToPtesi} you +% should be able to avoid most problems. % % \StopEventually{} ^^A qui si puo' mettere una bibliografia % @@ -512,7 +609,7 @@ the TOPtesi bundle] %<*class> \NeedsTeXFormat{LaTeX2e} \ProvidesClass{toptesi}% -[2008/12/15 v.5.00 Class for typesetting university theses] +[2010/11/14 v.5.01 Class for typesetting university theses] % \end{macrocode} % % The class itself is very simple since it requires just the \texttt{report} @@ -550,7 +647,7 @@ the TOPtesi bundle] %<*topsty> \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{toptesi}% -[2008/12/15 v.5.00 Extension for toptesi.cls]% +[2010/11/14 v.5.01 Extension for toptesi.cls]% % \end{macrocode} % % We start with defining the debugging macros; these trace commands and macros @@ -568,6 +665,7 @@ the TOPtesi bundle] % similar class option packages and is in line with the other standard \texttt{size??.clo} % files. \texttt{chapterbib} allows to set a list of references at the end of each chapter. % \begin{macrocode} +\newlength\T@Pbinding\setlength\T@Pbinding{7mm}\def\setbindingcorrection#1{\T@Pbinding=#1} \newif\if@binding \@bindingfalse \newif\ifT@Ppdfa \T@Ppdfafalse \newif\ifchapterbibliography \chapterbibliographyfalse @@ -616,7 +714,8 @@ the TOPtesi bundle] % text grid is centered; only if the class option \texttt{cucitura} is specified % (|\if@binding| in this case is true) the text grids are moved to the outside % in order to leave a wider inner margin. At the same time if the text grid is moved to -% the outside, the marginal note width must be reduced accordingly. +% the outside, the marginal note width must be reduced accordingly. These changes are +% executed at the |\begin{document}| stage. % \begin{macrocode} \oddsidemargin=\paperwidth \advance\oddsidemargin -\textwidth @@ -627,13 +726,14 @@ the TOPtesi bundle] \advance\marginparwidth 1in \advance\marginparwidth-2.5\marginparsep % +\AtBeginDocument{% \if@binding \typeout{Messaggio Toptesi: Ricalcolo i margini} - \advance\oddsidemargin 7mm - \advance\evensidemargin -7mm - \advance\marginparwidth -7mm - \advance\marginparwidth -7mm -\fi + \advance\oddsidemargin \T@Pbinding + \advance\evensidemargin -\T@Pbinding + \advance\marginparwidth -\T@Pbinding + \advance\marginparwidth -\T@Pbinding +\fi} % \end{macrocode} % % We now establish the page style. We start by setting to ``empy'' the tokens that diff --git a/Master/texmf-dist/source/latex/toptesi/toptesi.ins b/Master/texmf-dist/source/latex/toptesi/toptesi.ins deleted file mode 100644 index da3e4a1a532..00000000000 --- a/Master/texmf-dist/source/latex/toptesi/toptesi.ins +++ /dev/null @@ -1,113 +0,0 @@ -%% -%% This file is necessary to extract from file toptesi.dtx the following files: -%% toptesi.cls, -%% toptesi.sty, -%% topcoman.sty, -%% topfront.sty, -%% topsiz14.clo, -%% trieste.sty, -%% toptesi.cfg -%% that are strictly speaking the components of the TOPtesi bundle and form -%% the Work. The extraction is performed by means of the doctrip utility -%% that extracts practically only the uncommented lines so that their loading -%% becomes very quick. The bundle documentations in Italian is contained -%% in the document toptesi-doc.pdf (part of the bundle), and further -%% documentation in English may be obtained by LaTeX processing the -%% documented TeX source file toptesi.dtx. -%% -%% ---------------------------------------- -%% -%% This system is distributed in the hope that it will be useful, -%% but WITHOUT ANY WARRANTY; without even the implied warranty of -%% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. -%% -%% IMPORTANT NOTICE: -%% -%% Copyright 1989--2006 Claudio Beccari -%% All rights reserved. -%% -%% Permission is granted to distribute verbatim copies of this file -%% together with toptesi.dtx. -%% -%% No other permissions to copy or distribute this file in any form -%% are granted and in particular no permission to modify its contents. -%% -%% --------------- start of docstrip commands ------------------ -%% -\def\batchfile{toptesi.ins} -\input docstrip.tex -\preamble - -Copyright 1989--2005 Claudio Beccari All rights reserved. - - This system is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. - - -IMPORTANT NOTICE: - -This file is subject to the LPPL licence, version 1.3 or any subsequent -version. Copy of the LaTeX Project Public Licence is downloadable from -any CTAN archive. - - -\endpreamble - -\keepsilent - -\Msg{*** Generazione dei file del pacchetto TOPtesi ***} - -\generateFile{toptesi.cls}{t}{\from{toptesi.dtx}{class}} -\generateFile{toptesi.sty}{t}{\from{toptesi.dtx}{topsty}} -\generateFile{topcoman.sty}{t}{\from{toptesi.dtx}{topcmn}} -\generateFile{topfront.sty}{t}{\from{toptesi.dtx}{topfrn}} -\generateFile{topsiz14.clo}{t}{\from{toptesi.dtx}{top14}} -\generateFile{trieste.sty}{t}{\from{toptesi.dtx}{toptrst}} -\generateFile{toptesi.cfg}{t}{\from{toptesi.dtx}{topcfg}} - - - - -\ifToplevel{% -\Msg{***********************************************************} -\Msg{*\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space*} -\Msg{* Now move all files to a folder that is on \space\space - \space\space\space\space\space\space\space\space\space\space - \space\space*} -\Msg{* the LaTeX search path \space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space\space*} -\Msg{*\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space*} -\Msg{* In order to produce the English documentation run LaTeX *} -\Msg{* on toptesi.dtx. \space\space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space\space\space\space*} -\Msg{*\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space\space\space\space\space\space\space\space*} -\Msg{* \space\space\space\space\space\space\space\space\space - \space\space\space\space - Buon lavoro! Happy TeXing! \space\space\space\space\space - \space\space\space\space\space\space\space\space\space\space - \space*} -\Msg{***********************************************************} -} - -\endinput -- cgit v1.2.3