Debian Codegraph @

texmf-dist/doc/lualatex/tango/tango-en.tex

raw
1 % !TEX TS-program = LuaLaTeX
2 \documentclass[english,ColorTheme=Red,FontSize=10pt]{tango}
3 %\setmonofont{Latin Modern Mono}[Scale=MatchUppercase]
4 \usepackage{longtable,csquotes,lipsum,tcolorbox}
5 \usepackage[dvipsnames]{xcolor}
6 \newcommand\DO[1]{\textcolor{ColorOne}{\bfseries #1}}
7 \newcommand\TO[1]{\textsf{#1}}
8 %%
9 \NewDocumentCommand\showtheme{m}
10 {{\tgosetup{ColorTheme=#1}
11 \parbox{2.1cm}{\centering
12 \textsf{#1\rule[-3pt]{0pt}{10pt}}\\
13 \colorbox{ColorOne}{\parbox{1.5cm}{\rule[-5pt]{0pt}{15pt}}}
14 \par
15 \colorbox{ColorTwo}{\parbox{1.5cm}{\rule[-5pt]{0pt}{15pt}}}
16 \par
17 }}}
18 %
19 %\tgosmartlists
20 \renewtgolabels1{\lefthand}
21 \definecolor{ColorThree}{rgb}{0.93,0.95,0.97}
22 \tcbset{colback=ColorTwo,colframe=ColorTwo,sharp corners}
23 \frenchspacing
24 %\setcounter{section}{88}
25 \begin{document}
26
27 \renewcommand{\arraystretch}{1.1}
28 \title{\textcolor{ColorOne}{\floweroneleft}\,The tango document class\,\textcolor{ColorOne}{\floweroneright}}
29 \author{\href{mailto:[email protected]}{Michel \textsc{Bovani}}\\
30 Tango web page: \href{https://tango.mathriochka.net}{https://tango.mathriochka.net}}
31 \date{\today\\v. 0.8.0}
32 {\sffamily
33 \maketitle
34
35 }
36 \thispagestyle{empty}
37
38 \tgoshorttoc
39 \section{What the tango document class is}
40
41
42 Tango is a Latex document class (\verb=\documentclass[<options>]{tango}=) for use by mathematics teachers (roughly speaking, from high school to undergraduate level). It makes it possible to typeset several types of documents, from the short handout to the complete textbook. The \enquote{maths dedicated aspect} essentially consists in:
43 \begin{itemize}
44 \item loading maths packages;
45 \item offering dedicated commands and environments for statements (definitions, propositions, theorems…), exercises, numbering.
46 \end{itemize}
47
48 Tango is reasonably configurable, even if certain choices are imposed: mandatory use of lualatex, opentype fonts and recent installation, in particular. The tango class defines eight output formats, five of which are suitable for tablets, e-readers and smartphones; a system currently under development can be used to introduce a particular input for a given output format (for example, forcing a page break for the A5 format only). Finally, the tango class can be used for projects of a more general nature than maths lessons: science courses, but even more general usage with some extra configuration effort (see the Candide directory in the examples).
49
50 Another class of documents for presenting school work (training exercises, test or exam subjects) will soon be available, called \enquote{bravo}.
51
52
53
54
55 \section{Options overview}
56 Please note that the table below only lists the options actually managed by the tango class. Other options, if used when calling the class, can simply be passed to certain packages. This is the case, for example, with the babel language options, or the \TO{math-style} option, which is systematically passed to the \TO{unicode-math} package.
57
58 Default values are in bold red. Bold options marked with a \TO{\textbf{star*}} can be used in the preamble and in the body of the document with the \verb=\tgosetup{}= command: for example, in order to change the colors inside the document, you can use \verb+\tgosetup{ColorTheme=Navy}+. Other options can only be mentioned when the tango class is called.
59
60
61 \begin{longtable}{p{0.23\linewidth}p{0.7\linewidth}}
62 \caption[]{The tango class options}\\
63 \textbf{Option}&\textbf{Usage}\\
64 \hline\endhead
65 \hline\multicolumn{2}{r}{\emph{Continued next page}}\endfoot
66 \hline\endlastfoot
67
68 \hline
69 \TO{%
70 french, english, british, american, canadian, australian, newzealand, german, ngerman, naustrian, nswissgerman, italian, spanish}.& Tango will transmit all language options to the \TO{babel} package. However, the translation of specific names used by tango (such as theorem, exercise, etc.) is only guaranteed for the languages listed opposite. Please note that even English speakers must \emph{imperatively} pass a language option to tango.
71
72 See section~\ref{lang} below.\\
73 \hline
74 \TO{no-statement}&\TO{no-statement=true/\DO{false}}. The \TO{thm}, \TO{defin}, \TO{lem}, \TO{coro}, \TO{propo} environments (for theorems, definitions, lemmas, corollaries, propositions) are defined by default. The no-statement option allows you to define them later, on request (see \verb=\newstatement= and \verb=\renewstatement= commands in section~\ref{st-section} page~\pageref{st-section}).\\
75 \hline
76 \TO{no-hyperref}&\TO{no-hyperref=true/\DO{false}}. If you're only planning a single paper output….\\
77 \hline
78 \TO{no-indent/indent}&\TO{no-indent=true/\DO{false}}. Indents are present by default. The option \TO{noindent} (meaning \TO{no-indent = true}) returns us to the left margin. The \TO{indent} option also exists, but is not very useful!\\
79 \hline
80 \TO{no-titleindent}/\TO{titleindent}&Title indents are present by default only in French (because in French typography, the first paragraph after a title must be indented: so I prefer in this case the titles to be indented too). You can use no-tiltleindent in French and titleindent in English to change the default behavior. These options must be called after the language options.\\
81 \hline
82 \TO{\textbf{ThmNamePos*}}&\TO{ThmNamePos=<value>} where \TO{<value>} can be \TO{\DO{left}} or \TO{right}. The name of the statement (Theorem, Definition, etc.) is displayed to the left or right of the box.\\
83 \hline
84 \TO{PubliClass}&\TO{PubliClass=<value>} where \TO{<value>} can be \TO{\DO{article}} or \TO{book}. Indicates the base document class used (Latex standard \TO{article} document class or Latex standard \TO{book} document class.) The tango class is designed so that short handouts or monographs composed with the \TO{article} version can then be grouped together as chapters in the same volume with the \TO{book} version. See the \texttt{mathematics} directory in the \texttt{examples} documentation. With the \TO{article} version, the \verb=\part= and \verb=\tableofontents= commands are disabled. The \verb=\tgoshorttoc= command can be used to obtain a summary at the beginning of a monograph.\\
85 \hline
86 \TO{oneside/twoside}& The option \TO{twoside} makes recto/verso, \TO{oneside} simply makes recto. The default is \TO{\DO{oneside}}. For now, there's no adjustment of inner and outer margins with twoside but it's easy to adapt it to your needs with the \verb=\geometry= command in the preamble. Note that one may prefer \TO{twoside=false} to \TO{oneside} (why not?).\\
87 \hline
88 \TO{FontSize}&\TO{FontSize=<value>} where \TO{<value>} can be \TO{9pt}, \TO{\DO{10pt}}, \TO{11pt} ou \TO{12pt}.\\
89 \hline
90 \TO{\textbf{ColorTheme*}}&\TO{ColorTheme=<value>} where \TO{<value>} can be \TO{Blue, Navy, USAF, Azur, Red, Framboise, Brique, Sienne, Caramel, Olive, Tannen, \DO{GrayGray}, BlackAndWhite, Ink} or \TO{Steel}. These values are worth trying out: each defines a set of two colors, one solid (ColorOne) for titles and one very light (ColorTwo) for box backgrounds.\\
91 \hline
92 \TO{\textbf{ColorOne*}/\textbf{ColorTwo*}}& These options allow the user to define the colors of a personal theme separately; the argument must be a suitable argument for \verb=\definecolor=. See xcolor package (loaded without options by the tango class) documentation.
93 \begin{example}[Examples]
94 \begin{itemize}
95 \item\TO{ColorOne=}\verb={rgb}{0.75,0.1,0.05}=
96 \item\TO{ColorOne=}\verb={cmyk}{0,0.8,0.8,0.2}=
97 \item\TO{ColorTwo=}\verb={{rgb}{0.75,0.96,0.75}}= (note that external braces may be used, but are not mandatory).
98 \end{itemize}
99 \end{example}
100 \\
101 \hline
102 \TO{\textbf{ColorOneNamed*}} / \\
103 \TO{\textbf{ColorTwoNamed*}}&
104 These options allow the user to define the colors of a personal theme separately; the argument must be a suitable argument for \verb=\colorlet=. See xcolor package (loaded without options by the tango class) documentation.
105 \begin{example}[Examples]
106 \begin{itemize}
107 \item\TO{ColorOneNamed=}\verb={red!70!blue}=
108 \item\TO{ColorTwoNamed=}\verb={yellow!12}=
109 \end{itemize}
110 \end{example}
111 If you want to use a predefined set of colors, say \TO{dvipsnames}, you may reload the \TO{xcolor} package with the \TO{dvipsnames} option in your preamble, and then use the \verb=\tgosetup= command:
112 \begin{itemize}
113 \item \verb+\tgosetup{ColorOneNamed={RedOrange!80!BrickRed}}+
114 \end{itemize}
115 \\
116 \hline
117 \TO{Output}&\TO{Output=<value>} where \TO{<value>} can be \TO{\DO{A4paper}, Letter, A5paper, BigTablet, Tablet, SmallTablet, eReader} or \TO{Smartphone}. \TO{BigTablet}, \TO{Tablet} and \TO{SmallTablet} correspond to 13-, 11- and 8.5-inch screens respectively. \TO{eReader} is for a 6-inch e-reader. It should be noted that in the case of \TO{eReader} and \TO{Smartphone}, the requested format is larger than the actual format, so that the font sizes are much smaller than required. So the \TO{FontSize=9pt} option produces a result on their screens that may be difficult to read.\\
118 \hline
119 \TO{Numbers}& \TO{Numbers=<value>} where \TO{<value>} can be \TO{TextOldStyle, OldStyle, MathOldStyle, FullOldstyle}. If you don't ask for anything, you get the \enquote{lining} numbers.
120 \begin{itemize}
121 \item \TO{Numbers=TextOldStyle} activates oldstyle (or lower-case) digits (like these {\olddigits 0123456789}) of the erewhon font (basic text font) for the entire document.
122 \item \TO{Numbers=OldStyle} activates oldsyle (or lower-case) digits for all text fonts used in the document.
123 \item \TO{Numbers=MathOldStyle} activates lower-case digits only in mathematics (I can't think of any good reason to do this!).
124 \item \TO{Numbers=FullOldStyle} activates lower-case digits for all text fonts as well as for mathematics.
125 \end{itemize}
126 It should be noted that it is always possible to switch locally from the digits selected with this option to one of their variants (for example, section titles are systematically numbered using \enquote{lining} digits, since these titles are themselves capitalized).\\
127 \hline
128 \TO{StylisticSet}&\TO{StylisticSet=\{<value1>, <value2>,…\}} where \TO{<value1>, <value2>,} etc. are to be taken from \TO{upint, leqslant, smaller, subsetneq} and \TO{parallelslant}. These options concern the Erewhon-Math font, which is a (very) extended opentype version by Daniel \textsc{Flipo} of the math fonts of the Fourier-Gutenberg system. For more information, see the Erewhon-Math documentation (\verb=texdoc erewhon-math= in any good terminal).\\
129 \hline
130 \TO{CharacterVariant}&\TO{CharacterVariant=\{<value1>, <value2>,…\}} where \TO{<value1>, <value2>,} etc. can be chosen from \TO{zero, hslash, emptyset, epsilon, kappa, pi, phi, rho, sigma, theta, partial, Ecal, Qcal} and \TO{Tcal}. These options concern the Erewhon-Math font, which is a (very) extended opentype version by Daniel \textsc{Flipo} of the math fonts of the Fourier-Gutenberg system. For more information, see the Erewhon-Math documentation (\verb=texdoc erewhon-math= in any good terminal).\end{longtable}
131
132 %\medskip
133
134 \section{Packages loaded by the tango document class}
135 I only mention here the packages directly loaded by the tango class. Each of these packages can in turn load others...
136 \begin{itemize}
137 \item \verb=\RequirePackage{xcolor}=. The \TO{xcolor} package is used by the tango class to define the colors of the various themes. It is called without any options, but you can reload it in the preamble of your document with options such as \TO{dvipsnames}, \TO{svgnames} or \TO{x11names}.
138 \item\verb=\RequirePackage{mathtools}=. The \TO{mathtools} package loads the \TO{amsmath} package, to which it adds a complement.
139 \item\verb=\RequirePackage{geometry}=. Used by the tango class in order to define the page design of the various outputs formats. You can use the \verb=\geometry=. command in the document preamble to modify this layout.
140 \item\verb=\RequirePackage{enumitem}=. Used by the tango class to configure the various \TO{list}-based environments in its own way (see section~\ref{lists}). These settings can be modified by the user in the preamble.
141 \item\verb=\RequirePackage{titletoc}=. Used by the tango class to fix the table of contents appearance which can be modified by the user in the preamble.
142 \item\verb=\RequirePackage[pagestyles,toctitles,newlinetospace,clearempty]{titlesec}=. Used by the tango class to configure the appearance of titles at different levels. This can be modified by the user in the preamble. The default English version adds the \TO{noindentafter} option.
143 \item\verb=\RequirePackage{ccaption,caption}=. Used by the tango class to configure the captions appearance for figures and tables. (See section~\ref{figtable}).
144 \item\verb=\RequirePackage{fontspec}\RequirePackage{unicode-math}=. The tango class requires \TO{lualatex}, opentype fonts, and Unicode settings.
145 \item\verb=\RequirePackage{fourier-orns}=. See the section~\ref{fnts} below.
146 \item\verb=\RequirePackage{iflang}=. Used by tango to send a class error message if no language option is given.
147 \item\verb=\RequirePackage{babel}=. The babel package is called without options. It is up to you to pass babel options to the tango class. See section~\ref{lang} below.
148 \item\verb+\RequirePackage[colorlinks,linkcolor=ColorOne,urlcolor=ColorOne]{hyperref}+. This \TO{hyperref} configuration can be modified using the \verb=\hypersetup= command in your preamble. You can also use the \TO{no-hyperref} option.
149 \item\verb=\RequirePackage{array,graphicx,microtype,numprint,float,afterpage}=. These packages are provided but not explicitly used by tango.
150 \end{itemize}
151
152
153 \section{Fonts}\label{fnts}
154
155 \subsection{The tango font system}
156 Tango's main font is Erewhon, an opentype version of Utopia (a PostScript type~1 font which was designed in 1989 by Robert \textsc{Slimbach} and once donated by Adobe to the X-consortium and featured on TeXlive). Unlike Utopia, Erewhon, designed by Michael \textsc{Sharpe}, covers a large number of languages and offers a wide range of functions, available through opentype features. It should be noted that Adobe distributes a commercial opentype version of Utopia, which is less rich in glyphs than Erewhon, but has an intermediate font-weight and optical character sizes.
157
158 The tango mathematical font is Erewhon~Math, a scientific complement to Erewhon designed by Daniel \textsc{Flipo}. Erewhon Math is in a way the opentype counterpart of Fourier-GUTenberg, the scientific complement to Utopia type~1 designed by me in 2002. Erewhon~Math offers a large number of functions made accessible by Daniel through the \TO{fourier-otf} package. The tango class does not load \TO{fourier-otf}, but uses all its functions through a system of options.
159
160 The sans-serif font of the tango system is Noto Sans, scaled. Noto Sans is a sans-serif font for text in Latin, Cyrillic and Greek characters, with multiple weights and widths.
161
162 The main (chapter) title font is Roboto Condensed Bold (as a condensed version of Noto Sans is not available on TeXlive).
163
164 The monospaced font is Inconsolatazi4, scaled.
165
166 Finally, tango calls the \TO{fourier-orns} package, a symbols and logos complement to the fourier system which has now an opentype version.
167
168 \subsection{Replacing the tango font system}
169 It is, of course, possible to use the \TO{fontspec} \verb=\setmainfont=, \verb=\setsansfont= and \verb=\setmonofont= commands and the \TO{unicode-math} \verb=\setmathfont= command in the preamble in order to modify the parameters of the tango class: this is not advisable, in my humble opinion. But one day there will probably be another class in the tango distribution which will use another font system. Such a document class could be called charlie, or foxtrot or zulu….
170
171 \subsection{Font commands and text font commands}
172 Here, I call \enquote{Font commands} commands whose scope can only be limited by a group or an environment. I call \enquote{Text font commands}, on the other hand, commands whose scope is limited to their argument, which must not contain a paragraph break. For example, \verb=\bfseries= is a \enquote{font command} and \verb=\textbf= is a \enquote{text font command}. Here is what is provided by tango (see table~\ref{otfcmd}, \pageref{otfcmd}). All these commands should work with Erewhon and with Noto Sans as well.
173 \begin{table}[ht]
174 \XTabletCommand{\centering\setlength\tabcolsep{9pt}}
175 \TabletCommand{\centering}
176 \caption{Tango opentype commands}\label{otfcmd}
177 \ifTgoTabletOutput\begin{tabular}{l | l | l | l}%
178 \else
179 \begin{tabular}{llll}%
180 \fi
181 \hline
182 \multicolumn{1}{c}{\textsf{\bfseries Command}}&
183 \multicolumn{1}{c}{\textsf{\bfseries Nature}}&
184 \multicolumn{1}{c}{\textsf{\bfseries Example}}&
185 \multicolumn{1}{c}{\textsf{\bfseries Result}}\\
186 \hline
187 \verb=\superiors=&\textsf{font command} & \verb=M{\superiors rs}=&M{\superiors rs}\\
188 \hline
189 \verb=\scinferiors=&\textsf{font command} &\verb={\scinferiors C6H12O3}= &{\scinferiors C6H12O3}\\
190 \hline
191 \verb=\smartfracs=&\textsf{font command} &\verb=2{\smartfracs1/3}= &2{\smartfracs1/3} \\
192 \hline
193 \verb=\fullsc=&\textsf{text font command} &\verb=\fullsc{Chapter}= &\fullsc{Chapter} \\
194 \hline
195 \verb=\textsup=&\textsf{text font command} &\verb=M\textsup{rs}=&M\textsup{rs} \\
196 \hline
197 \verb=\textscinf=&\textsf{text font command} &\verb=\textscinf{C6H12O3}= &\textscinf{C6H12O3} \\
198 \hline
199 \verb=\smartfrac=&\textsf{text font command} &\verb=2\smartfrac{3/4}= &2\smartfrac{3/4} \\
200 \hline
201 \verb=\olddigits=&\textsf{font command} &\verb={\olddigits01234}= &{\olddigits01234} \\
202 \hline
203 \verb=\liningdigits=&\textsf{font command} &\verb={\olddigits01\liningdigits01}= &{\olddigits01\liningdigits01} \\
204 \hline
205 \verb=\propdigits=&\textsf{font command} &\verb={\propdigits011\olddigits011}= &{\propdigits011\olddigits011} \\
206 \hline
207 \verb=\tabulardigits=&\textsf{font command} &\verb={\tabulardigits011\olddigits011}= &{\tabulardigits011\olddigits011} \\
208 \hline
209 \end{tabular}
210
211
212 \end{table}
213
214
215 \section{Using tango}
216
217 \subsection{Generalities}
218 The tango interface is not so different from that of the standard \TO{article} and \TO{book} document classes. Configuration is essentially a matter of choosing options.
219
220 For advanced use, it is useful to refer to the documentation for the various packages: first, of course, \TO{unicode-math}, \TO{fontspec}, \TO{mathtools} and \TO{amsmath}. But if you want to change the style of titles, for example, you could take a look at the \TO{titlesec} documentation, and to change the style of lists (enumerate, itemize, etc.), take a look at \TO{enumitem}. The \TO{geometry} package is essential for anyone wanting to obtain a particular layout. And so on.
221 \subsection{Modified standard commands}
222 Since documents designed with the \TO{article} option can become chapters in a book composed later with the \TO{book} option, the \verb+\part+ command inherited from the \TO{article} class has been deactivated (only for article-typeset documents)
223
224 Similarly, the \TO{article} version benefits from a \verb+\tgotitle+ command that lets you define the main title of the document. The \verb+\tgotitle*+ version exists but does nothing more or less than the unstarred command. However, in the \TO{book} version, \verb+\tgotitle+ is an alias for \verb+\chapter+ (and \verb+\tgotitle*+ is an alias for \verb+\chapter*+), so the unnumbered title of a handout very easily becomes the numbered title of a chapter in a book. This, of course, assumes that the \verb+\includeonly+/\verb+\include+ mechanism is used... A model (currently written in French) is provided in the \TO{examples} directory.
225
226 The command \verb+\tableofcontents+ can only be used with the \TO{book} option; it is deactivated with the \TO{article} option: in this case, you have to use \verb+\tgoshorttoc+ instead (of course \verb+\tgoshorttoc+ is in turn deactivated in the \TO{book} version). Note that, if you need multiple or partial tocs, you have to use a dedicated package.
227
228 \subsection{Using two or more output formats}
229 What I'm describing here is still rudimentary and experimental. It will be developed further if it proves successful.
230
231 For each output format, two particular commands are provided. For example, in case of the \TO{Smartphone} output option, you have \verb+\SmartphoneCommand+ and \verb+\XSmartphoneCommand+. The \verb+\SmartphoneCommand+ argument is only taken into account if \TO{Output=Smartphone} have been used. Conversely, the \verb+\XSmartphoneCommand+ argument is only taken into account if this option has not been used.
232 \begin{example}[Examples]
233 \begin{itemize}
234 \item \verb+\SmartphoneCommand{\pagebreak}+ asks for a page break only for the smartphone output.
235 \item \verb+\XSmartphoneCommand{\[< long math formula >\]}+
236 \par \verb+\SmartphoneCommand{\begin{multline*}<split formula>\end{multine*}}+
237 \par asks for a multline version of a formula only for the smartphone output
238 \end{itemize}
239 \end{example}
240
241 Provided commands are:
242 \begin{itemize}
243 \item\verb+\AfourCommand+ and \verb+\XAfourCommand+ for the A4 format;
244 \item\verb+\LetterCommand+ and \verb+\XLetterCommand+ for the letter format;
245 \item\verb+\AfiveCommand+ and \verb+\XAfiveCommand+ for the A5 format;
246 \item\verb+\BigTabletCommand+ and \verb+\XBigTabletCommand+ for the big tablet format;
247 \item\verb+\TabletCommand+ and \verb+\XTabletCommand+ for the tablet format;
248 \item\verb+\SmallTabletCommand+ and \verb+\XSmallTabletCommand+ for the small tablet format;
249 \item\verb+\eReaderCommand+ and \verb+\XeReaderCommand+ for the e-reader format;
250 \item\verb+\SmartphoneCommand+ and \verb+\XSmartphoneCommand+ for the smartphone format.
251 \end{itemize}
252 \subsection{All the color themes}
253 \indent\par
254 \hspace*{0pt}\hfil\showtheme{Blue}\hfil\showtheme{Azur}\hfil\showtheme{Navy}\hfil\showtheme{USAF}\hfil%
255 \showtheme{Framboise}\hfil\null
256 \par\bigskip\par
257 \hspace*{0pt}\hfil\showtheme{Red}\hfil\showtheme{Brique}\hfil\showtheme{Caramel}\hfil\showtheme{Sienne}\hfil\showtheme{Olive}\hfil\null
258 \par\bigskip\par
259 \hspace*{0pt}\hfil\showtheme{Tannen}\hfil\showtheme{GrayGray}\hfil\showtheme{Steel}\hfil\showtheme{Ink}\hfil\showtheme{BlackAndWhite}\hfil\null
260
261 \section{Language settings}\label{lang}
262 A language option \emph{must} be passed to the \TO{babel} package via the tango class: this is true \emph{even} for English-speaking people. A class error message will be generated otherwise. If you ignore this message you will get no hyphenation patterns at all!
263
264 Tango also has some reserved words, which are (when an english language option is passed to tango):\begin{verbatim}
265 \newcommand\TgoTheoremName{Theorem}
266 \newcommand\TgoDefinitionName{Definition}
267 \newcommand\TgoPropositionName{Proposition}
268 \newcommand\TgoLemmaName{Lemma}
269 \newcommand\TgoCorollaryName{Corollary}
270 \newcommand\TgoRemarkName{Remark}
271 \newcommand\TgoExampleName{Example}
272 \newcommand\TgoContentsName{Contents}
273 \newcommand\TgoExerciseName{Exercise}
274 \newcommand\TgoExercisesSubsectionName{Exercises}
275 \newcommand\TgoExercisesSectionName{Exercises}
276 \end{verbatim}
277
278 Although any language option recognized by babel will (in principle) be taken into account as soon as it is passed to tango, the translation of these reserved words only happens for the following languages:
279 \begin{itemize}
280 \item\TO{french};
281 \item\TO{english, british, american, canadian, australian, newzealand};
282 \item\TO{german, ngerman, naustrian, nswissgerman};
283 \item\TO{italian};
284 \item\TO{spanish}.
285 \end{itemize}
286
287 Other languages benefit from babel's facilities, but tango's reserved words are not translated.
288 So here's what concerned users can do.
289
290 \begin{enumerate}
291 \item Translate these names in your language (for now it is done only for the french language), using \verb+\renewcommand+.
292 \item (Better) Mail me all the necessary information (at least babel language option used and your translation of the tango names) and I will adapt the tango class to your language.
293 \end{enumerate}
294 \section{Statements}\label{st-section}
295
296 \subsection{Predefined statements}
297 The environments offered by the tango document class for the statements were defined using the \verb+\newstatement+ command, whose syntax is:
298 \begin{tcolorbox}
299 \begin{verbatim}
300 \newstatement{<environment>}{<counter>}{<statement-name>}[<optionnal-font-command>]
301 \end{verbatim}
302 \end{tcolorbox}
303 For example, the \TO{thm}, \TO{defin}, \TO{propo}, \TO{coro} and \TO{lem} environments have been defined using something like:
304 \begin{tcolorbox}
305 \begin{verbatim}
306 \newcounter{thm} \newstatement{thm}{thm}{Theorem}[\itshape]
307 \newcounter{defin} \newstatement{defin}{defin}{Definition}
308 \newcounter{propo} \newstatement{propo}{propo}{Proposition}[\itshape]
309 \newcounter{coro} \newstatement{coro}{coro}{Corollary}
310 \newcounter{lem} \newstatement{lem}{lem}{Lemma}
311 \end{verbatim}
312 \end{tcolorbox}
313
314
315 If you type:
316
317 \begin{tcolorbox}
318 \begin{verbatim}
319 \begin{propo}
320 The sum of two odd integers is an even integer.
321 \end{propo}
322 \begin{thm}[pons asinorum]
323 The angles at the base of an isosceles triangle are equal.
324 \end{thm}
325 \end{verbatim}
326 \end{tcolorbox}
327
328 you will obtain:
329 \begin{propo}
330 The sum of two odd integers is an even integer.
331 \end{propo}
332 \begin{thm}[pons asinorum]
333 The angles at the base of an isosceles triangle are equal.
334 \end{thm}
335
336 As you can see, each statement defined with \verb+\newstatement+ has an optional bracketed argument (which is displayed within parentheses after the statement name and number). Please, note that these environments should not be used inside a \TO{list}-based environment (like center, quote, enumerate, itemize…).
337
338 For each statement defined with \verb+\newstatement+ there is also
339 \begin{itemize}
340 \item a starred form with no statement number:
341 \begin{tcolorbox}
342 \begin{verbatim}
343 \begin{coro*}
344 The angles at the base of an isosceles triangle are equal.
345 \end{coro*}
346 \end{verbatim}
347 \end{tcolorbox}
348 \end{itemize}
349 \begin{coro*}
350 The angles at the base of an isosceles triangle are equal.
351 \end{coro*}
352 \begin{itemize}
353 \item and an optional first argument delimited with \verb+< >+ to replace locally the full theorem name.
354 \begin{tcolorbox}
355 \begin{verbatim}
356 \begin{thm*}<D'Alembert-Gauss theorem>[fundamental theorem of algebra]
357 Every non-constant single-variable polynomial with
358 complex coefficients has at least one complex root.
359 \end{thm*}
360 \end{verbatim}
361 \end{tcolorbox}
362 \end{itemize}
363 \begin{thm*}<D'Alembert-Gauss theorem>[fundamental theorem of algebra]
364 Every non-constant single-variable polynomial with complex coefficients has at least one complex root.
365 \end{thm*}
366
367 \subsection{Defining your own statements}
368 If you need a new statement type, say an axm environment for axioms, it's easy:
369 \begin{tcolorbox}
370 \begin{verbatim}
371 \newcounter{axio} \newstatement{axm}{axio}{Axiom}
372 \end{verbatim}
373 \end{tcolorbox}
374 Note that it is up to you to define the counter for this new environment: if this counter does not still exist, it has to be created with \verb+\newcounter+. Of course, the counter name may be different from the environment name. If you have used the \TO{no-statement} option, you will have to define all the statements you need, with the environment names you prefer.
375
376 \subsection{Redefining existing statements}
377 The \verb+\newstatement+ command has a \verb+\renewstatement+ companion to redefine existing statement environment. Precisely, you need to use \verb+\renewstatement{foo}…+ instead of \verb+\newstatement{foo}…+ if and only if the \verb+foo+ environment has already been defined.
378
379 \begin{example}[Examples]
380 \begin{enumerate}
381 \item You can redefine the \TO{propo} environment in such a way that it uses the same counter as the \TO{thm} environment and is displayed in the upright font:
382 \begin{tcolorbox}
383 \begin{verbatim}
384 \renewstatement{propo}{thm}{Proposition}
385 \setcounter{thm}{0}
386 \begin{propo}
387 The sum of two odd integers is an even integer.
388 \end{propo}
389 \begin{thm}
390 The angles at the base of an isosceles triangle are equal.
391 \end{thm}
392 \end{verbatim}
393 \end{tcolorbox}
394 \end{enumerate}
395 \renewstatement{propo}{thm}{Proposition}
396 \setcounter{thm}{0}
397 \begin{propo}
398 The sum of two odd integers is an even integer.
399 \end{propo}
400 \begin{thm}
401 The angles at the base of an isosceles triangle are equal.
402 \end{thm}
403
404 \begin{enumerate}[resume]
405 \item If you have already written \emph{all} your algebra book in Latex, with propositions, theorems and corollaries and you realize that, \emph{now}, you want there is no more difference between propositions, theorems and corollaries: the three types of statements should be typeset in italic, named \enquote{Proposition} and numbered with the same counter, you can just use in your preamble:
406
407 \begin{tcolorbox}
408 \begin{verbatim}
409 \renewstatement{coro}{thm}{Proposition}[\itshape]
410 \renewstatement{propo}{thm}{Proposition}[\itshape]
411 \renewstatement{thm}{thm}{Proposition}[\itshape]
412 \setcounter{thm}{0}
413 \begin{propo}
414 The sum of two odd integers is an even integer.
415 \end{propo}
416 \begin{thm}
417 The sum of two even integers is an even integer.
418 \end{thm}
419 \begin{coro}
420 If two integers have the same parity, their sum is even.
421 \end{coro}
422 \end{verbatim}
423 \end{tcolorbox}
424 and you will get
425
426 \end{enumerate}
427 \renewstatement{coro}{thm}{Proposition}[\itshape]
428 \renewstatement{propo}{thm}{Proposition}[\itshape]
429 \renewstatement{thm}{thm}{Proposition}[\itshape]
430 \setcounter{thm}{0}
431 \begin{propo}
432 The sum of two odd integers is an even integer.
433 \end{propo}
434 \begin{thm}
435 The sum of two even integers is an even integer.
436 \end{thm}
437 \begin{coro}
438 If two integers have the same parity, their sum is even.
439 \end{coro}
440
441
442 instead of
443
444 \setcounter{thm}{0}\setcounter{propo}{0}
445 \renewstatement{thm}{thm}{Theorem}[\itshape]
446 \renewstatement{propo}{propo}{Proposition}[\itshape]
447 \renewstatement{coro}{coro}{Corollary}
448 \begin{propo}
449 The sum of two odd integers is an even integer.
450 \end{propo}
451 \begin{thm}
452 The sum of two even integers is an even integer.
453 \end{thm}
454 \begin{coro}
455 If two integers have the same parity, their sum is even.
456 \end{coro}
457 \begin{enumerate}[resume]
458 \item And finally \verb+\renewstatement+ and \verb+\newstatement+ have a starred form with which statement numbers are displayed \emph{before} the statement name. More, if the statement counter is the subsection or subsubsection counter, the concerned statement titles are displayed in the same form and placement as subsection or subsubsection titles; of course the placement depends on the value of \TO{notitleindent}.
459 \begin{tcolorbox}
460 \begin{verbatim}
461 \renewstatement*{thm}{thm}{Theorem}
462 \begin{thm}<D'Alembert-Gauss theorem>[fundamental theorem of algebra]
463 Every non-constant single-variable polynomial with
464 complex coefficients has at least one complex root.
465 \end{thm}
466 \renewstatement*{thm}{subsection}{Theorem}[\itshape]
467 \begin{thm}<D'Alembert-Gauss theorem>[fundamental theorem of algebra]
468 Every non-constant single-variable polynomial with
469 complex coefficients has at least one complex root.
470 \end{thm}
471 \renewstatement*{thm}{subsubsection}{Theorem}
472 \begin{thm}<D'Alembert-Gauss theorem>[fundamental theorem of algebra]
473 Every non-constant single-variable polynomial with
474 complex coefficients has at least one complex root.
475 \end{thm}
476 \end{verbatim}
477 \end{tcolorbox}
478 \end{enumerate}
479 \end{example}
480 \renewstatement*{thm}{thm}{Theorem}
481 \begin{thm}<D'Alembert-Gauss theorem>[fundamental theorem of algebra]
482 Every non-constant single-variable polynomial with complex coefficients has
483 at least one complex root.
484 \end{thm}
485 \renewstatement*{thm}{subsection}{Theorem}[\itshape]
486 \begin{thm}<D'Alembert-Gauss theorem>[fundamental theorem of algebra]
487 Every non-constant single-variable polynomial with complex coefficients has
488 at least one complex root.
489 \end{thm}
490 \renewstatement*{thm}{subsubsection}{Theorem}
491 \begin{thm}<D'Alembert-Gauss theorem>[fundamental theorem of algebra]
492 Every non-constant single-variable polynomial with complex coefficients has
493 at least one complex root.
494 \end{thm}
495
496
497
498 \section{Exercises}
499 \subsection{Typesetting exercises}
500 Tango provides the \verb+\exo+ command which lets you typeset a numbered exercise (the counter is \TO{tgoexo}). There is a starred version, which is not numbered. As for the statements, the bracketed option provides a complementary title between parenthesis and the \enquote{\TO{< >}} marked first option provides a substitution title.
501 \begin{tcolorbox}
502 \begin{verbatim}
503 \exo
504 Prove that if $G$ is a finite group and $H$ a subgroup of $G$,
505 then the order of $H$ divides the order of $G$.
506 \exo[Lagrange theorem]
507 Prove that if $G$ is a finite group and $H$ a subgroup of $G$,
508 then the order of $H$ divides the order of $G$.
509 \end{verbatim}
510 \end{tcolorbox}
511 \exo
512 Prove that if $G$ is a finite group and $H$ a subgroup of $G$, then the order of $H$ divides the order of $G$.
513 \exo[Lagrange theorem]
514 Prove that if $G$ is a finite group and $H$ a subgroup of $G$,
515 then the order of $H$ divides the order of $G$.
516 \begin{tcolorbox}
517 \begin{verbatim}
518 \newcommand\tgostar{\raisebox{-0.5ex}{\large\textborn}}
519 \exo*<Chinese remainder problem>[\tgostar\tgostar\tgostar]
520 Let $n_1,\ldots, n_k$ be integers greater than $1$ and let us denote by $N$
521 the product of the $n_i$. Prove that if the $n_i are pairwise coprime, and if
522 $a_1,\ldots, a_k$ are any integers, then the system
523 \begin{align*}
524 x&\equiv a_1 \pmod{n_1}\\
525 &\!\vdots\\
526 x&\equiv a_k \pmod{n_k}
527 \end{align*}
528 has a solution, and any two solutions are congruent modulo $N$.
529 \end{verbatim}
530 \end{tcolorbox}
531 \newcommand\tgostar{\raisebox{-0.5ex}{\large\textborn}}
532 \exo*<Chinese remainder problem>[\tgostar\tgostar\tgostar]
533 Let $n_1,\ldots, n_k$ be integers greater than $1$ and let us denote by $N$ the product of the $n_i$.
534 Prove that if the $n_i$ are pairwise coprime, and if $a_1,\ldots, a_k$ are any integers, then the system
535 \begin{align*}
536 x&\equiv a_1 \pmod{n_1}\\
537 &\!\vdots\\
538 x&\equiv a_k \pmod{n_k}
539 \end{align*}
540 has a solution, and any two solutions are congruent modulo $N$.
541 \subsection{The secexo and chapexo environments}
542 These environments are designed to present a part devoted to exercises at the end of a section (in the case of \TO{secexo}) or a chapter (in the case of \TO{chapexo}). Within these environments, you can use the command \verb+\exo+
543
544 The title, in capitals and centred, is \enquote{EXERCISES} by default. The optional argument in square brackets allows you to choose another. This title is added to the table of contents.
545
546 Finally, there is a starred form (\verb+\begin{secexo*)+…\verb+\end{secexo*}+ which allows you to compose the exercises within these sections in a smaller font size (exept if the main font size is nine points).
547
548 \begin{tcolorbox}
549 \begin{verbatim}
550 \begin{secexo*}[Example of an exercises subsection]
551 \exo Prove that the sum of two even integers is an even integer.
552 \exo Prove that the sum of two odd integers is an even integer.
553 \end{secexo*}
554 \end{verbatim}
555 \end{tcolorbox}
556 \begin{secexo*}[Example of an exercises subsection]
557 \exo Prove that the sum of two even integers is an even integer.
558 \exo Prove that the sum of two odd integers is an even integer.
559 \end{secexo*}
560
561 \section{Lists}\label{lists}
562 \subsection{General principles}
563 All the horizontal motion in tango is performed in steps equal to an integer multiple of the \verb+\TgoStandardMargin+ length parameter. When the tango class is loaded, the value of this parameter is set to 1.5em, as are paragraph indentation and title indentation (unless these two values are fixed to zero). Successive labels in the enumerate and itemize environments are therefore successively positioned at 1.5em, 3em, 4.5em, etc. from the main margin. It could be unadvised to change these settings (or this should be done using the enumitem package).
564 \subsection{List based environments}
565 There are two main lists configurations. The first, active by default, is set with \verb+\tgostandardlists+; the second is set with \verb+\tgosmartlists+.
566 %
567 With \verb+\tgostandardlists+ the text corresponding to a given level is shifted to the right (by a value equal to \verb+\TgoStandardMargin+...) with respect to the corresponding label.
568 %
569 With \verb+\tgosmartlists+, conversely, the text corresponding to a given level is shifted to the left (by a value equal to \verb+\TgoStandardMargin+...) in relation to the corresponding label.
570 \renewtgolabels*\tgostandardlists
571
572 Here is the default behaviour of the \TO{itemize} environment (\TO{enumerate} is not different).
573 \begin{itemize}
574 \item Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur dictum gravida mauris. Nam arcu libero, nonummy eget, consectetuer id, vulputate a, magna.
575 \item Donec vehicula augue eu neque. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Mauris ut leo. Cras viverra metus rhoncus sem. Nulla et lectus vestibulum urna fringilla ultrices. Phasellus eu tellus sit amet tortor gravida placerat.
576 \begin{itemize}
577 \item Integer sapien est, iaculis in, pretium quis, viverra ac, nunc. Praesent eget sem vel leo ultrices bibendum. Aenean faucibus. Morbi dolor nulla, malesuada eu, pulvinar at, mollis ac, nulla. Curabitur auctor semper nulla.
578 \begin{itemize}
579 \item Donec vehicula augue eu neque. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.
580 \begin{itemize}
581 \item Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Mauris ut leo. Praesent eget sem vel leo ultrices bibendum. Aenean faucibus. Morbi dolor nulla, malesuada eu, pulvinar at, mollis ac, nulla. Curabitur auctor semper nulla.
582 \end{itemize}
583 \item Donec varius orci eget risus. Duis nibh mi, congue eu, accumsan eleifend, sagittis quis, diam.
584 \end{itemize}\end{itemize}
585 \item Cras viverra metus rhoncus sem. Nulla et lectus vestibulum urna fringilla ultrices. Phasellus eu tellus sit amet tortor gravida placerat.
586 \end{itemize}
587
588 \bigskip
589
590 And now with \verb+\tgosmartlists+ \tgosmartlists
591 \begin{itemize}
592 \item Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Ut purus elit, vestibulum ut, placerat ac, adipiscing vitae, felis. Curabitur dictum gravida mauris. Nam arcu libero, nonummy eget, consectetuer id, vulputate a, magna.
593 \item Donec vehicula augue eu neque. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Mauris ut leo. Cras viverra metus rhoncus sem. Nulla et lectus vestibulum urna fringilla ultrices. Phasellus eu tellus sit amet tortor gravida placerat.
594 \begin{itemize}
595 \item Integer sapien est, iaculis in, pretium quis, viverra ac, nunc. Praesent eget sem vel leo ultrices bibendum. Aenean faucibus. Morbi dolor nulla, malesuada eu, pulvinar at, mollis ac, nulla. Curabitur auctor semper nulla.
596 \begin{itemize}
597 \item Donec vehicula augue eu neque. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.
598 \begin{itemize}
599 \item Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Mauris ut leo. Praesent eget sem vel leo ultrices bibendum. Aenean faucibus. Morbi dolor nulla, malesuada eu, pulvinar at, mollis ac, nulla. Curabitur auctor semper nulla.
600 \end{itemize}
601 \item Donec varius orci eget risus. Duis nibh mi, congue eu, accumsan eleifend, sagittis quis, diam.
602 \end{itemize}\end{itemize}
603 \item Cras viverra metus rhoncus sem. Nulla et lectus vestibulum urna fringilla ultrices. Phasellus eu tellus sit amet tortor gravida placerat.
604 \end{itemize}
605
606 Note that \verb+\tgosmartlists+ seems most interesting when you use mainly the first level of these environments.
607 Since the \verb+\tgosmartlists+ doesn't support very well a construction like
608 \begin{tcolorbox}
609 \begin{verbatim}
610 \begin{enumerate}
611 \item\begin{enumerate}\item
612 …
613 \end{verbatim}
614 \end{tcolorbox}
615 that is frequent in exercises questions,
616 the \TO{secexo} and \TO{chapexo} environments set locally the lists to \verb+\tgostandardlists+. It is not the case with the \verb+\exo+ command which has no local context. \tgostandardlists
617
618 \subsection{Redefining labels of itemize lists}
619 Tango provides a \verb+\renewtgolabels+ command which permits to modify the labels of the \TO{itemize} environment. Arguments are numbered from 1 to 4 (there is four levels of itemize lists in Latex) and must be used like in the examples below.
620 \begin{example}[Examples]
621 \begin{itemize}
622 \item\verb=\renewtgolabels1{\lefthand}= will replace the first label by the \verb=\lefthand= symbol.
623 \renewtgolabels1{\lefthand}
624 \item\verb=\renewtgolabels4{\textbullet}1{\openbullet}3{\textemdash}= changes the label for the first (again), the third and the fourth levels. Level 2 remains unchanged. As you can see, the order of the arguments is unimportant. \renewtgolabels4{\textbullet}1{\openbullet}3{\textemdash}
625 \end{itemize}
626 \end{example}
627
628 There is also a starred form that restore the initial label (as at the load of the class) which are \verb=\textbullet=, \textbullet, for the level 1, \verb=\textopenbullet=, \textopenbullet, for the level 2, \verb=\starredbullet=, \starredbullet, for the level 3 and \verb=\textperiodcentered=, \textperiodcentered{} for the level 4 (note that this is the tango default, but \emph{not} the Latex default).
629
630 \renewtgolabels*
631 \begin{example}[Examples]
632 \begin{itemize}
633 \item\verb=\renewtgolabels*= restore all the initial values.
634 \item\verb=\renewtgolabels*2{\textendash}= restore initial values except for the second level which is changed to \textendash.
635 \end{itemize}
636 \end{example}
637
638
639 \section{Other environments}
640 In addition to the statements environments, the tango class offers the following environments:
641 \subsection{The remark and example environments}
642 \begin{tcolorbox}
643 \begin{verbatim}
644 \begin{remark}
645 This is a very good remark.
646 \end{remark}
647 \begin{example}
648 This is a very short example.
649 \end{example}
650 \end{verbatim}
651 \end{tcolorbox}
652 \begin{remark}
653 This is a very good remark.
654 \end{remark}
655 \begin{example}
656 This is a very short example.
657 \end{example}
658
659 These two environments have a bracketed optional argument which displays a replacement title. For example:
660 \begin{tcolorbox}
661 \begin{verbatim}
662 \begin{example}[Remarks]
663 \begin{enumerate}
664 \item A first (very good) remark.
665 \item A second remark (which is best, if possible).
666 \end{enumerate}
667 \end{example}
668 \end{verbatim}
669 \end{tcolorbox}
670 \begin{example}[Remarks]
671 \begin{enumerate}
672 \item A first (very good) remark.
673 \item A second remark (which is best, if possible).
674 \end{enumerate}
675 \end{example}
676
677 \subsection{The alert environment}
678 \begin{tcolorbox}
679 \begin{verbatim}
680 \begin{alert}
681 You should not even try to use \verb+\expandafter\expandafter\expandafter+
682 unless you are actually a very experimented \TeX{} user, because you could get
683 a terrible headhache.
684 \end{alert}
685 \end{verbatim}
686 \end{tcolorbox}
687 \begin{alert}
688 You should not even try to use \verb+\expandafter\expandafter\expandafter+
689 unless you are actually a very experimented \TeX{} user, because you could get
690 a terrible headhache.
691 \end{alert}
692
693 The \TO{alert} environment also support an optional bracketed argument.
694 \begin{tcolorbox}
695 \begin{verbatim}
696 \begin{alert}[\bomb]
697 You should not even try to use \verb+\expandafter\expandafter\expandafter+
698 unless you are actually a very experimented \TeX{} user, because you could get
699 a terrible headhache.
700 \end{alert}
701 \end{verbatim}
702 \end{tcolorbox}
703 \begin{alert}[\bomb]
704 You should not even try to use \verb+\expandafter\expandafter\expandafter+
705 unless you are actually a very experimented \TeX{} user, because you could get
706 a terrible headhache.
707 \end{alert}
708
709 \subsection{The proof environment}
710 The \TO{proof} environment is adapted from the \TO{amsthm} package. It also support a bracketed optional argument for a replacement title. The \verb+\qedhere+ command is also usable.
711 \renewstatement{thm}{thm}{Theorem}[\itshape]
712 \setcounter{thm}{0}
713 \begin{tcolorbox}
714 \begin{verbatim}
715 \begin{thm}
716 The sum of two odd integers is an even integer.
717 \end{thm}
718 \begin{proof}
719 Let $p$ and $q$ be two odd integers. We have to prove that there
720 exists an integer $n$ such that $p+q=2n$.
721 We know that there is an integer $p_1$ and an integer $q_1$ such that
722 \[p=2p_1+1\text{ and } q=2q_1+1,\]
723 hence
724 \begin{align*}p+q&=(2p_1+1)+(2q_1+1)\\
725 &=2\underbrace{(p_1+q_1+1)}_{n}\qedhere
726 \end{align*}
727 \end{proof}
728 \end{verbatim}
729 \end{tcolorbox}
730 \begin{thm}
731 The sum of two odd integers is an even integer.
732 \end{thm}
733 \begin{proof}
734 Let $p$ and $q$ be two odd integers. We have to prove that there exists an integer $n$ such that $p+q=2n$.
735 We know that there is an integer $p_1$ and an integer $q_1$ such that
736 \[p=2p_1+1\text{ and } q=2q_1+1,\]
737 hence
738 \begin{align*}p+q&=(2p_1+1)+(2q_1+1)\\
739 &=2\underbrace{(p_1+q_1+1)}_{n}\qedhere
740 \end{align*}
741 \end{proof}
742
743 \section{Figures, tables, floats and captions}\label{figtable}
744 Thanks to the \TO{caption} package, the following have been defined:
745 \begin{itemize}
746 \item\verb+\tgofigcaption+ (for figures);
747 \item and \verb+\tgotabcaption+ (for tables).
748 \end{itemize}
749 These two commands provide captions similar in appearance to what could be obtained with \verb+\caption+, but also work in the case of non-floating objects.
750
751 In this way it is possible to include small tables and figures in a fixed position, with nothing in their appearance to distinguish them from floating objects (whose use is still recommended in most cases).
752
753 \end{document}