Debian Codegraph @

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

raw
1 % !TEX TS-program = LuaLaTeX
2 \documentclass[french,ColorTheme=USAF,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}\,La classe de documents tango\,\textcolor{ColorOne}{\floweroneright}}
29 \author{\href{mailto:[email protected]}{Michel \textsc{Bovani}}\\
30 Page internet de tango: \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{Qu'est-ce que la classe tango ?}
40
41
42 Tango est une classe de documents pour le système de composition Latex (au début du document source, il convient donc de saisir \verb=\documentclass[<options>]{tango}=) à l'usage des professeurs de mathématiques (\emph{grosso modo}, sur le segment bac$-3$-bac$+3$). Elle est conçue pour la composition de divers types de documents, du petit polycopié au livre complet. Pour l'essentiel, le côté \frquote{dédié aux maths} consiste à :
43 \begin{itemize}
44 \item Charger des packages dédiés (amsmath, unicode-math \&Co).
45 \item Proposer des commandes et des environnements pour les théorèmes, propositions, définitions, exercices, etc.
46 \end{itemize}
47
48 Tango est raisonnablement configurable, même si j'ai dû imposer certains choix : utilisation obligatoire de lualatex, des fontes opentype, et d'une installation récente, notamment. La classe propose huit formats de sortie, dont cinq sont adaptés aux tablettes, liseuses ou smartphones. Un procédé encore imparfait permet d'introduire une saisie particulière pour un format de sortie donné (par exemple de forcer un saut de page pour le format A5 seulement). La classe tango peut aussi être utilisée pour des projets de portée plus générale que des cours de mathématiques : des cours de sciences, bien sûr, mais aussi des choses très différentes, si l'on est prêt à un effort de configuration supplémentaire (voir le répertoire \TO{candide} dans les exemples).
49
50 Une autre classe Latex, conçue pour réaliser des documents support au travail scolaire (énoncés d'exercices, sujets de devoirs ou d'examens) devrait être disponible sous peu. Il est prévu qu'elle se nomme \frquote{\TO{bravo}}.
51
52 \section{Panorama des options}
53 Veuillez noter que le tableau ci-dessous mentionne pour l’essentiel les options effectivement traitées par tango. D'autres options peuvent être, lorsqu’elles sont utilisées à l'appel de la classe, simplement transmises à certains packages. C'est le cas par exemple des options de langues de babel, ou de l'option \TO{math-style} passée au package unicode-math.
54
55 Les valeurs par défaut sont présentées en bleu gras. Les options en gras, marquées d'un astérisque, peuvent être activées dans le préambule ou le corps du document à l'aide de la commande \verb+\tgosetup+ : par exemple, vous pouvez utiliser \verb+\tgosetup{ColorTheme=Navy}+ pour changer les couleurs à l'intérieur de votre document. Les autres options ne peuvent être utilisées qu'à l'appel de la classe.
56
57 \begin{longtable}{p{0.23\linewidth}p{0.7\linewidth}}
58 \caption[]{Les options de la classe tango}\\
59 \textbf{Option}&\textbf{Utilisation}\\
60 \hline\endhead
61 \hline\multicolumn{2}{r}{\emph{Voir page suivante}}\endfoot
62 \hline\endlastfoot
63 \TO{%
64 french, english, british, american, canadian, australian, newzealand, german, ngerman, naustrian, nswissgerman, italian, spanish}.& Tango transmettra au package \TO{babel} toutes les options de langue. En revanche, la traduction des noms spécifiques employés par tango (comme théorème, exercice, etc.) n'est assurée que pour les langues listées ci-contre. Notez bien que même les locuteurs anglais doivent \emph{impérativement} passer une option de langue à tango.
65
66 Voir la section~\ref{lang} plus loin.\\
67 \hline
68 \TO{no-statement}&\TO{no-statement=true/\DO{false}}. Des environnements \TO{thm}, \TO{defin}, \TO{lem}, \TO{coro}, \TO{propo} (pour présenter les théorèmes, définitions, lemmes, corollaires et propositions) sont définis par défaut. L'option \DO{no-statement} vous permet de définir ces environnements vous-même avec une configuration plus personnelle (voir les commandes \verb=\newstatement= and \verb=\renewstatement= dans la section~\ref{st-section} page~\pageref{st-section}).\\
69 \hline
70 \TO{no-hyperref}&\TO{no-hyperref=true/\DO{false}}. Si vous souhaitez vous contenter d'une sortie papier…\\
71 \hline
72 \TO{no-indent/indent}&\TO{no-indent=true/\DO{false}}. Les retraits d'alinéa sont présents par défaut. L'option \TO{no-indent} (alias court de \TO{no-indent = true}) les supprime. Une option \TO{indent} existe également, quoiqu'elle ne soit pas très utile.\\
73 \hline
74 \TO{no-titleindent}/\TO{titleindent}&Les retraits d'alinéa pour les titres sont présents par défaut en français uniquement. (La raison en est qu'en typographie française le premier paragraphe après un titre subit ce retrait comme les autres paragraphes, ce qui n'est pas le cas en typo anglaise : je préfère donc dans ce cas, mais cela peut être débattu, que le titre subisse lui aussi ce retrait.) Vous pouvez utiliser \TO{no-tiltleindent} en français ou \TO{titleindent} en anglais pour changer le comportement pas défaut. Ces deux options doivent être appelées \emph{après} l'option de langue.\\
75 \hline
76 \TO{\textbf{ThmNamePos*}}&\TO{ThmNamePos=<valeur>} ou \TO{<valeur>} peut être \TO{\DO{left}} ou \TO{right}. Le nom de l'énoncé (Théorème, Définition, etc.) est affiché à gauche ou à droite de l'encadré.\\
77 \hline
78 \TO{PubliClass}&\TO{PubliClass=<valeur>} où \TO{<valeur>} peut être \TO{\DO{article}} ou \TO{book}. Indique la classe de base souhaitée (la classe standard \TO{article} ou la classe standard \TO{book}). La classe tango est conçue de telle sorte que des petits polycopiés fabriqués au jour le jour et composés avec l'option \TO{article} puissent être regroupés et devenir les chapitres d'un même volume avec l'option \TO{book}. Voyez le répertoire \texttt{mathematics} dans la partie exemples de la documentation. Avec l'option \TO{article}, les commandes \verb=\part= et \verb=\tableofontents= sont désactivées. La commande \verb=\tgoshorttoc= peut être utilisée pour obtenir un sommaire au début d'une monographie ou d'un polycopié.\\
79 \hline
80 \TO{oneside/twoside}& L'option \TO{twoside} est pour une sortie en recto verso, alors que \TO{oneside} est adaptée au recto simple. La valeur par défaut est \TO{\DO{oneside}}. Pour l'instant, il n'y a pas d'ajustement des marges intérieures et extérieures avec \TO{twoside} mais il est techniquement facile de réaliser des blancs tournants à votre convenance grâce à la commande \verb=\geometry= employée dans le préambule. Notez que les gens compliqués ou amateurs de détours pourront préférer \TO{twoside=false} à \TO{oneside}.\\
81 \hline
82 \TO{FontSize}&\TO{FontSize=<valeur>} où \TO{<valeur>} peut être \TO{9pt}, \TO{\DO{10pt}}, \TO{11pt} ou \TO{12pt}.\\
83 \hline
84 \TO{\textbf{ColorTheme*}}&\TO{ColorTheme=<valeur>} où \TO{<valeur>} peut être \TO{Blue, Navy, USAF, Azur, Red, Framboise, Brique, Sienne, Caramel, Olive, Tannen, \DO{GrayGray}, BlackAndWhite, Ink} or \TO{Steel}. Chaque choix définit un ensemble de deux couleurs, une soutenue (ColorOne) pour les titres et une très claire (ColorTwo) pour le fond des encadrés.\\
85 \hline
86 \TO{\textbf{ColorOne*}/\textbf{ColorTwo*}}& Ces options permettent à l'utilisateur de définir les couleurs d'un thème personnel; dans les deux cas la valeur doit être un argument acceptable pour la commande \verb=\definecolor=. Voir la documentation du package xcolor, chargé sans option par tango.
87 \begin{example}[Exemples]
88 \begin{itemize}
89 \item\TO{ColorOne=}\verb={rgb}{0.75,0.1,0.05}=
90 \item\TO{ColorOne=}\verb={cmyk}{0,0.8,0.8,0.2}=
91 \item\TO{ColorTwo=}\verb={{rgb}{0.75,0.96,0.75}}= (notez que les accolades extérieures sont acceptées sans être obligatoires).
92 \end{itemize}
93 \end{example}
94 \\
95 \hline
96 \TO{\textbf{ColorOneNamed*}} / \\
97 \TO{\textbf{ColorTwoNamed*}}&
98 Ces options permettent à l'utilisateur de définir les couleurs d'un thème personnel; dans les deux cas la valeur doit être un argument acceptable pour la commande \verb=\colorlet=. Voir la documentation du package xcolor, chargé sans options par tango.
99 \begin{example}[Exemples]
100 \begin{itemize}
101 \item\TO{ColorOneNamed=}\verb={red!70!blue}=
102 \item\TO{ColorTwoNamed=}\verb={yellow!12}=
103 \end{itemize}
104 \end{example}
105 Si vous souhaitez utiliser un ensemble de couleurs prédéfinies, disons par exemple \TO{dvipsnames}, il vous suffit de recharger le package \TO{xcolor} avec l'option \TO{dvipsnames} dans le préambule, puis d'utiliser la commande \verb=\tgosetup= :
106 \begin{itemize}
107 \item \verb+\tgosetup{ColorOneNamed={RedOrange!80!BrickRed}}+
108 \end{itemize}
109 \\
110 \hline
111 \TO{Output}&\TO{Output=<valeur>} où \TO{<valeur>} peut être \TO{\DO{A4paper}, Letter, A5paper, BigTablet, Tablet, SmallTablet, eReader} ou \TO{Smartphone}. \TO{BigTablet}, \TO{Tablet} et \TO{SmallTablet} correspondent à des écrans de 13, 11 et 8.5 pouces respectivement; \TO{eReader} configurée pour une liseuse 6 pouces. Veuillez noter qu'en ce qui concerne les formats \TO{eReader} et \TO{Smartphone}, tango demande à Latex un format supérieur au format réel, si bien que les tailles des polices sont inférieures à ce que l'on pourrait attendre. Ainsi, l'option \TO{FontSize=9pt} peut fournir des résultats qui sembleront difficilement lisibles.\\
112 \hline
113 \TO{Numbers}& \TO{Numbers=<valeur>} où \TO{<valeur>} peut être \TO{TextOldStyle, OldStyle, MathOldStyle, FullOldstyle}. Si vous ne demandez rien, vous obtenez les chiffres habituels, à hauteur d'une lettre capitale, parfois nommés \frquote{lining}.
114 \begin{itemize}
115 \item \TO{Numbers=TextOldStyle} sélectionne les chiffres bas de casse ({\olddigits 0123456789}) of de la police erewhon (fonte texte de base) pour tout.
116 \item \TO{Numbers=OldStyle} sélectionne les chiffres bas de casse pour toutes les fontes de texte du document.
117 \item \TO{Numbers=MathOldStyle} sélectionne les chiffres bas de casse uniquement pour les mathématiques (je ne vois aucune bonne raison de procéder ainsi).
118 \item \TO{Numbers=FullOldStyle} sélectionne les chiffres bas de casse aussi bien pour les fontes de texte que pour les mathématiques.
119 \end{itemize}
120 Remarquons qu'il est toujours possible de basculer localement des chiffres sélectionnés par cette option à une de leurs variantes (par exemple les titres de section sont numérotés à l'aide de \frquote{grands} chiffres, dans la mesure où ces titres sont eux-mêmes en capitales).\\
121 \hline
122 \TO{StylisticSet}&\TO{StylisticSet=\{<valeur1>, <valeur2>,…\}} où \TO{<valeur1>, <valeur2>,} etc. sont à prendre parmi \TO{upint, leqslant, smaller, subsetneq} et \TO{parallelslant}. Ces options concernent la fonte Erewhon-Math, qui est une version opentype du système scientifique Fourier-Gutenberg, (très) étendue par Daniel \textsc{Flipo}. Pour plus d'informations, voir la documentation d'Erewhon-Math (\verb=texdoc erewhon-math= dans un terminal).\\
123 \hline
124 \TO{CharacterVariant}&\TO{CharacterVariant=\{<valeur1>, <valeur2>,…\}} \TO{<valeur1>, <valeur2>,} etc. sont à prendre parmi \TO{zero, hslash, emptyset, epsilon, kappa, pi, phi, rho, sigma, theta, partial, Ecal, Qcal} et \TO{Tcal}. Ces options concernent la fonte Erewhon-Math, qui est une version opentype du système scientifique Fourier-Gutenberg, (très) étendue par Daniel \textsc{Flipo}. Pour plus d'informations, voir la documentation d'Erewhon-Math (\verb=texdoc erewhon-math= dans un terminal).\\
125 \end{longtable}
126
127 \section{Liste des packages chargés par la classe tango}
128 Je ne mentionne ici que les packages directement chargés par tango. Chacun d'eux peut à son tour charger d'autres packages.
129
130 \begin{itemize}
131 \item \verb=\RequirePackage{xcolor}=. Le package \TO{xcolor} est utilisé par la classe tango pour définir les couleurs des différents thèmes. Il est appelé sans option, mais vous pouvez le recharger dans le préambule avec des options comme \TO{dvipsnames}, \TO{svgnames} ou \TO{x11names}.
132 \item\verb=\RequirePackage{mathtools}=. Le package \TO{mathtools} charge le package \TO{amsmath}.
133 \item\verb=\RequirePackage{geometry}=. Utilisé par tango pour définir l'empagement des différents formats de sortie. Vous pouvez utiliser la commande \verb=\geometry= dans votre préambule pour modifier ce empagement, et même la maquette entière.
134 \item\verb=\RequirePackage{enumitem}=. Utilisé par la classe tango pour configurer les différents environnements basés sur \TO{list} (voir la section~\ref{lists}). Ces configurations peuvent être modifiées par l'utilisateur dans le préambule.
135 \item\verb=\RequirePackage{titletoc}=. Utilisé par la classe tango pour fixer l'apparence de la table des matières, que l'utilisateur peut modifier dans le préambule.
136 \item\verb=\RequirePackage[pagestyles,toctitles,newlinetospace,clearempty,noindentafter]{titlesec}=. Utilisé par la classe tango pour modifier l'apparence des titres de différents niveaux. Ces configurations peuvent être modifiées par l'utilisateur dans le préambule.
137 \item\verb=\RequirePackage{ccaption,caption}=. Utilisé par la classe tango pour configurer l'apparence des légendes des figures et des tables. (voir la section~\ref{figtable}).
138 \item\verb=\RequirePackage{fontspec}\RequirePackage{unicode-math}=. La classe tango requiert \TO{lualatex} et les fontes opentype, y compris pour la composition des mathématiques. Voir la section~\ref{fnts} ci-dessous.
139 \item\verb=\RequirePackage{iflang}=. La classe tango utilise ce package pour envoyer un message d'erreur dans le cas où elle n'a reçu aucune option de langue pour \TO{babel}.
140 \item\verb=\RequirePackage{babel}=. Le package babel est appelé sans option. Les options de babel lui seront transmises par la classe tango. %See section~\ref{lang} below.
141 \item\verb+\RequirePackage[colorlinks,linkcolor=ColorOne,urlcolor=ColorOne]{hyperref}+.\par Cette configuration d'\TO{hyperref} peut être modifiée en utilisant la commande \verb=\hypersetup= dans le préambule. Vous pouvez aussi utiliser l'option \TO{no-hyperref}.
142 \item\verb=\RequirePackage{array,graphicx,microtype,numprint,float,afterpage}=. Ces packages sont chargés mais non explicitement utilisés par tango.
143 \end{itemize}
144
145 \section{Fontes}\label{fnts}
146
147 \subsection{Le système de fontes de tango}
148 La fonte principale est Erewhon, une version opentype d'Utopia (une fonte PosScript de type~1 qui fut conçue par Robert \textsc{Slimbach} en 1989, puis donnée au X-consortium par Adobe et figurant finalement sur TeXlive. Contrairement à Utopia, Erewhon, dessinée par Michael \textsc{Sharpe}, couvre un assez grand nombre de langues et offre de nombreuses possibilités accessibles à travers les fonctionnalités du format opentype. Il faut savoir également qu'Adobe commercialise une version opentype d'Utopia, moins riche en glyphes qu'Erewhon, mais pourvue d'une graisse intermédiaire et de corps optiques.
149
150 La fonte scientifique est Erewhon~Math, un complément scientifique à Erewhon, conçu par Daniel \textsc{Flipo}. D'un certain point de vue, Erewhon est le pendant opentype de Fourier-Gutenberg, le complément scientifique d'Utopia type~1 conçu par mes soins en 2002. Erewhon~Math offre un grand nombre de fonctionnalités, rendues accessibles par Daniel à travers le package \TO{fourier-otf}. La classe tango ne charge pas le package \TO{fourier-otf} mais propose toutes ses fonctionnalités à travers son système d'options.
151
152 La fonte sans sérif de tango est Noto Sans, mise à l'échelle. Il s'agit d'une fonte de texte, supportant les alphabets latin, grec et cyrillique, et pourvue de graisses multiples.
153
154 La fonte utilisée pour les Titres de premier niveau (commande \verb=\tgotitle=) est Roboto Condensed Bold (puisque les graisses condensées de Noto Sans ne figurent pas sur TeXlive).
155
156 La fonte à chasse fixe est Inconsolatazi4, mise à l'échelle.
157
158 Enfin, tango appelle le package fourier-orns: il s'agit d'une fonte de logos et de symboles conçue par mes soins comme complément au système fourier et récemment pourvue d'une version opentype.
159
160 \subsection{Utiliser tango avec un autre système de fontes}
161 Il est évidemment possible d'utiliser les commandes \verb=\setmainfont=, \verb=\setsansfont= et \verb=\setmonofont= du package \TO{fontspec}, ainsi que la commande \verb=\setmathfont= du package \TO{unicode-math} dans le préambule de votre document afin de modifier les paramètres de la classe tango. Ce ne sont pas des modifications que je recommande. En revanche, la distribution tango pourrait à l'avenir proposer une autre classe pourvue d'un autre système de fontes. Une telle classe Latex pourrait se nommer charlie, ou foxtrot ou zulu…
162
163
164 \subsection{“Font commands” et “text font commands”}
165 Je nomme ici “Font commands” des commandes dont la portée n'est limitée que par un groupe ou un environnement. Je nomme “Text font commands”, à l'opposé, des commandes dont la portée est limitée à leur argument, lequel ne doit contenir aucun saut de paragraphe. Par exemple, \verb=\bfseries= est une “font command” et \verb=\textbf= est une “text font command”. La raison de ces dénominations, dont j'admets qu'elles sont fort critiquables, est que \verb+\textbf+ est défini de façon interne par :
166 \begin{tcolorbox}
167 \begin{verbatim}
168 \DeclareTextFontCommand{\textbf}{\bfseries}
169 \end{verbatim}
170 \end{tcolorbox}
171
172 Voici ce qui est proposé par la classe tango (voir le tableau~\ref{otfcmd}, \pageref{otfcmd}). Toutes ces commandes devraient fonctionner aussi bien avec Erewhon qu'avec Noto Sans.
173
174 \begin{table}[ht]
175 \XTabletCommand{\centering\setlength\tabcolsep{9pt}}
176 \TabletCommand{\centering}
177 \caption{Les commandes opentype de la classe tango}\label{otfcmd}
178 \ifTgoTabletOutput\begin{tabular}{l | l | l | l}%
179 \else
180 \begin{tabular}{llll}%
181 \fi
182 \hline
183 \multicolumn{1}{c}{\textsf{\bfseries Commande}}&
184 \multicolumn{1}{c}{\textsf{\bfseries Nature}}&
185 \multicolumn{1}{c}{\textsf{\bfseries Exemple}}&
186 \multicolumn{1}{c}{\textsf{\bfseries Resultat}}\\
187 \hline
188 \verb=\superiors=&\textsf{font command} & \verb=1{\superiors re}=&1{\superiors re}\\
189 \hline
190 \verb=\scinferiors=&\textsf{font command} &\verb={\scinferiors C6H12O3}= &{\scinferiors C6H12O3}\\
191 \hline
192 \verb=\smartfracs=&\textsf{font command} &\verb=2{\smartfracs1/3}= &2{\smartfracs1/3} \\
193 \hline
194 \verb=\fullsc=&\textsf{text font command} &\verb=\fullsc{Chapitre}= &\fullsc{Chapitre} \\
195 \hline
196 \verb=\textsup=&\textsf{text font command} &\verb=1\textsup{re}=&1\textsup{re} \\
197 \hline
198 \verb=\textscinf=&\textsf{text font command} &\verb=\textscinf{C6H12O3}= &\textscinf{C6H12O3} \\
199 \hline
200 \verb=\smartfrac=&\textsf{text font command} &\verb=2\smartfrac{3/4}= &2\smartfrac{3/4} \\
201 \hline
202 \verb=\olddigits=&\textsf{font command} &\verb={\olddigits01234}= &{\olddigits01234} \\
203 \hline
204 \verb=\liningdigits=&\textsf{font command} &\verb={\olddigits01\liningdigits01}= &{\olddigits01\liningdigits01} \\
205 \hline
206 \verb=\propdigits=&\textsf{font command} &\verb={\propdigits011\olddigits011}= &{\propdigits011\olddigits011} \\
207 \hline
208 \verb=\tabulardigits=&\textsf{font command} &\verb={\tabulardigits011\olddigits011}= &{\tabulardigits011\olddigits011} \\
209 \hline
210 \end{tabular}
211
212
213 \end{table}
214
215
216
217 %\medskip
218
219
220 \section{Utilisation de la classe tango}
221
222 \subsection{Généralités}
223 Concernant l'interface utilisateur, tango n'est pas très différente des classes \TO{article} ou \TO{book}. La configuration se fait essentiellement à travers le choix des options.
224
225 Les utilisateurs avancés devraient se référer à la documentation des différents packages : tout d'abord \TO{unicode-math}, \TO{fontspec}, \TO{mathtools} et \TO{amsmath}. Mais si vous souhaitez, par exemple, changer le style des titres, vous pourrez consulter la documentation \TO{titlesec} ; afin de changer le style d'une liste (enumerate, itemize, etc.), voyez plutôt \TO{enumitem}. Le package \TO{geometry} est essentiel pour quiconque souhaiterait obtenir une mise en page particulière. Et ainsi de suite.
226
227
228
229 \subsection{Modification de commandes standard par la classe tango}
230
231 Afin que des documents composés avec l'option \TO{article} puissent devenir les chapitres d'un livre composé de façon ultérieure avec l'option \TO{book}, la commande \verb+\part+, héritée de la classe \TO{article}, a été désactivée (seulement pour les documents composés avec l'option \TO{article}).
232
233
234 De même, la version \TO{article} bénéficie de la commande \verb+\tgotitle+ qui permet de définir le titre principal du document. La version étoilée \verb+\tgotitle*+ existe, mais fait exactement la même chose que la commande non étoilée. Cependant, dans la version \TO{book}, \verb+\tgotitle+ est un alias pour \verb+\chapter+ (et \verb+\tgotitle*+ est de même un alias de \verb+\chapter*+), ainsi, un titre non numéroté dans un polycopié peut facilement devenir le titre numéroté d'un chapitre de livre. Sous réserve évidemment qu'un mécanisme comme \verb+\includeonly+/\verb+\include+ ait été utilisé. Un modèle (pour l'instant en français) est fourni dans le répertoire \TO{examples}.
235
236 La commande \verb+\tableofcontents+ ne peut être utilisée qu'avec l'option \TO{book}; elle est désactivée avec l'option \TO{article}: elle est alors remplacée par la commande \verb+\tgoshortoc+ (qui est elle-même désactivée avec l'option \TO{book}). Si vous avez besoin de tables des matières multiples et/ou partielles, il faudra vous tourner vers un package spécialisé.
237
238 \subsection{Utiliser deux ou plusieurs formats de sortie}
239 Les fonctionnalités décrites ici ont un caractère rudimentaire et sont de nature expérimentale. Elles pourront, selon leur succès, être développées dans les versions ultérieures de la classe tango.
240
241 Pour chaque format de sortie, deux commandes particulières sont fournies. Par exemple, dans le cas de l'option \TO{Output=Smartphone}, vous disposez de \verb+\SmartphoneCommand+ et \verb+\XSmartphoneCommand+. L'argument de la commande \verb+\SmartphoneCommand+ n'est pris en compte que si le format de sortie \TO{Smartphone} a été sélectionné. Inversement, l'argument de \verb+\XSmartphoneCommand+ n'est pris en compte que si ce format \emph{n'a pas été} utilisé.
242 \begin{example}[Exemples]
243 \begin{itemize}
244 \item \verb+\SmartphoneCommand{\pagebreak}+ crée un saut de page uniquement pour la sortie smartphone.
245 \item \verb+\XSmartphoneCommand{\[<longue formule de maths>\]}+
246 \par \verb+\SmartphoneCommand{\begin{multline*}<formule sur plusieurs lignes>\end{multine*}}+
247 \par crée une version \TO{multline} (cf. \TO{amsmath}) d'une formule pour la sortie smartphone uniquement.
248 \end{itemize}
249 \end{example}
250
251 Les commandes proposées par tango sont :
252 \begin{itemize}
253 \item\verb+\AfourCommand+ and \verb+\XAfourCommand+ pour la sortie A4paper;
254 \item\verb+\LetterCommand+ and \verb+\XLetterCommand+pour la sortie letter;
255 \item\verb+\AfiveCommand+ and \verb+\XAfiveCommand+ pour la sortie A5paper;
256 \item\verb+\BigTabletCommand+ and \verb+\XBigTabletCommand+ pour la sortie BigTablet;
257 \item\verb+\TabletCommand+ and \verb+\XTabletCommand+ pour la sortie Tablet;
258 \item\verb+\SmallTabletCommand+ and \verb+\XSmallTabletCommand+ pour la sortie SmallTablet;
259 \item\verb+\eReaderCommand+ and \verb+\XeReaderCommand+ pour la sortie eReader;
260 \item\verb+\SmartphoneCommand+ and \verb+\XSmartphoneCommand+ pour la sortie Smartphone.
261 \end{itemize}
262 \subsection{Tous les thèmes de couleur}
263 \indent\par
264 \hspace*{0pt}\hfil\showtheme{Blue}\hfil\showtheme{Azur}\hfil\showtheme{Navy}\hfil\showtheme{USAF}\hfil%
265 \showtheme{Framboise}\hfil\null
266 \par\bigskip\par
267 \hspace*{0pt}\hfil\showtheme{Red}\hfil\showtheme{Brique}\hfil\showtheme{Caramel}\hfil\showtheme{Sienne}\hfil\showtheme{Olive}\hfil\null
268 \par\bigskip\par
269 \hspace*{0pt}\hfil\showtheme{Tannen}\hfil\showtheme{GrayGray}\hfil\showtheme{Steel}\hfil\showtheme{Ink}\hfil\showtheme{BlackAndWhite}\hfil\null
270
271 \section{Sélection de la langue}\label{lang}
272 Il est impératif de passer une option de langue à babel par l'intermédiaire de la classe tango : cela est vrai même pour les personnes de langue anglaise. Un message d'erreur sera généré par la classe tango si celle-ci n'a reçu aucune option de langue à transmettre à \TO{babel} ; si vous ignorez ce message, vous devrez travailler sans aucun motif de césure.
273
274 Tango possède également certains mots réservés qui sont (lorsque l'option french est passée à tango) :
275
276 \begin{tcolorbox}
277 \begin{verbatim}
278 \renewcommand\TgoTheoremName{Théorème}
279 \renewcommand\TgoDefinitionName{Définition}
280 \renewcommand\TgoPropositionName{Proposition}
281 \renewcommand\TgoLemmaName{Lemme}
282 \renewcommand\TgoCorollaryName{Corollaire}
283 \renewcommand\TgoRemarkName{Remarque}
284 \renewcommand\TgoExampleName{Exemple}
285 \renewcommand\TgoContentsName{Sommaire}
286 \renewcommand\TgoExerciseName{Exercice}
287 \renewcommand\TgoExercisesSubsectionName{Exercices}
288 \renewcommand\TgoExercisesSectionName{Exercices}
289 \end{verbatim}
290 \end{tcolorbox}
291
292 Même si toute option de langue reconnue par babel sera (en principe) prise en compte dès lors qu'elle est passée à tango, la traduction de ces mots réservés n'a lieu que pour les langues suivantes :
293 \begin{itemize}
294 \item\TO{french};
295 \item\TO{english, british, american, canadian, australian, newzealand};
296 \item\TO{german, ngerman, naustrian, nswissgerman};
297 \item\TO{italian};
298 \item\TO{spanish}.
299 \end{itemize}
300
301 Les autres langues bénéficient des facilités offertes par babel, mais les mots réservés de tango ne sont pas traduits.
302 Voici donc ce que peuvent faire les utilisateurs concernés.
303 \begin{enumerate}
304 \item Utiliser \verb+\renewcommand+ pour faire ces traductions eux-mêmes.
305 \item (Mieux) me communiquer par mail toute l'information nécessaire (au moins l'option de langue utilisée pour babel et une traduction des mots réservés) de façon à ce que je puisse procéder aux adaptations nécessaires.
306 \end{enumerate}
307
308 \section{Théorèmes et énoncés divers}\label{st-section}
309
310 \subsection{Éléments prédéfinis}
311 Les environnements permettant de saisir les divers énoncés indispensables aux enseignants de mathématiques (définitions, théorèmes, propositions, etc.) sont définis grâce à la commande \verb+\newstatement+ dont la syntaxe est :
312 \begin{tcolorbox}
313 \begin{verbatim}
314 \newstatement{<environnement>}{<compteur>}{<nom-générique-de-l'énoncé>}[<font-command-optionnelle>]
315 \end{verbatim}
316 \end{tcolorbox}
317 Par exemple, les environnements, \TO{thm}, \TO{defin}, \TO{propo}, \TO{coro} et \TO{lem} ont été définis par quelque chose comme :
318 \begin{tcolorbox}
319 \begin{verbatim}
320 \newcounter{thm} \newstatement{thm}{thm}{Théorème}[\itshape]
321 \newcounter{defin} \newstatement{defin}{defin}{Définition}
322 \newcounter{propo} \newstatement{propo}{propo}{Proposition}[\itshape]
323 \newcounter{coro} \newstatement{coro}{coro}{Corollaire}
324 \newcounter{lem} \newstatement{lem}{lem}{Lemme}
325 \end{verbatim}
326 \end{tcolorbox}
327
328 Si vous saisissez
329 %
330 \begin{tcolorbox}
331 \begin{verbatim}
332 \begin{propo}
333 La somme de deux entiers impairs est un entier pair.
334 \end{propo}
335 \begin{thm}[pons asinorum]
336 Les angles à la base d'un triangle isocèle sont égaux.
337 \end{thm}
338 \end{verbatim}
339 \end{tcolorbox}
340 %
341 vous obtenez
342 \begin{propo}
343 La somme de deux entiers impairs est un entier pair.
344 \end{propo}
345 \begin{thm}[pons asinorum]
346 Les angles à la base d'un triangle isocèle sont égaux.
347 \end{thm}
348
349 Comme vous pouvez le voir, chaque énoncé défini à l'aide de \verb+\newstatement+ dispose d'un argument optionnel délimité par des crochets (dont le contenu s'affiche entre parenthèses après le nom et le numéro de l'énoncé). Notez également que ces environnements ne devraient pas être utilisés à l'intérieur d'un autre environnement basé sur \TO{list} (comme \TO{center, quote, enumerate, itemize}…).
350
351 Pour chaque type d'énoncé défini à l'aide de \verb+\newstatement+ existe également
352 \begin{itemize}
353 \item une forme étoilée non numérotée:
354 \begin{tcolorbox}
355 \begin{verbatim}
356 \begin{coro*}
357 Les angles à la base d'un triangle isocèle sont égaux.
358 \end{coro*}
359 \end{verbatim}
360 \end{tcolorbox}
361 \end{itemize}
362 \begin{coro*}
363 Les angles à la base d'un triangle isocèle sont égaux.
364 \end{coro*}
365 \begin{itemize}
366 \item un premier argument optionnel délimité par \verb+< >+ qui permet de remplacer localement le nom générique de l'énoncé.
367 \begin{tcolorbox}
368 \begin{verbatim}
369 \begin{thm*}<Théorème de d'Alembert-Gauss>
370 [théorème fondamental de l'algèbre]
371 Tout polynôme non constant à coefficients complexes
372 possède au moins une racine complexe.
373 \end{thm*}
374 \end{verbatim}
375 \end{tcolorbox}
376 \end{itemize}
377 \begin{thm*}<Théorème de d'Alembert-Gauss>[théorème fondamental de l'algèbre]
378 Tout polynôme non constant à coefficients complexes possède au moins une racine complexe.
379 \end{thm*}
380
381
382 \subsection{Configurer vos propres types énoncés}
383 Si vous avez besoin d'un nouveau type d'énoncé, disons un environnement \TO{axm} pour les axiomes, c'est tout simple:
384 \begin{tcolorbox}
385 \begin{verbatim}
386 \newcounter{axio} \newstatement{axm}{axio}{Axiom}
387 \end{verbatim}
388 \end{tcolorbox}
389 Remarquez bien qu'il vous revient alors de définir le compteur utilisé par cet environnement : si ce compteur n'existe pas déjà, il vous faut le créer à l'aide de la commande \verb+\newcounter+. Bien sûr, le nom du compteur peut être différent de celui de l'environnement. Si vous avez utilisé l'option \TO{no-statement}, vous aurez d'ailleurs à définir tous les types d'énoncé dont vous avez besoin, avec des noms et des compteurs de votre choix.
390
391 \subsection{Redéfinir des types d'énoncés}
392 La commande \verb+\newstatement+ a pour compagnon \verb+\renewstatement+ qui permet de redéfinir l'environnement associé à un type d'énoncé préexistant. Précisément, vous devez employer \verb+\renewstatement{foo}…+ plutôt que \verb+\newstatement{foo}…+ si et seulement si l'environnement \verb+foo+ a déjà été défini.
393
394 \begin{example}[Exemples]
395 \begin{enumerate}
396 \item Vous pouvez redéfinir l'environnement \TO{propo} de telle façon qu'il utilise le même compteur que l'environnement \TO{thm} avec un contenu affiché en caractères romains:
397 \begin{tcolorbox}
398 \begin{verbatim}
399 \renewstatement{propo}{thm}{Proposition}
400 \setcounter{thm}{0}
401 \begin{propo}
402 La somme de deux entiers impairs est un entier pair.
403 \end{propo}
404 \begin{thm}
405 Les angles à la base d'un triangle isocèle sont égaux.
406 \end{thm}
407 \end{verbatim}
408 \end{tcolorbox}
409 \end{enumerate}
410 \renewstatement{propo}{thm}{Proposition}
411 \setcounter{thm}{0}
412 \begin{propo}
413 La somme de deux entiers impairs est un entier pair.
414 \end{propo}
415 \begin{thm}
416 Les angles à la base d'un triangle isocèle sont égaux.
417 \end{thm}
418
419 \begin{enumerate}[resume]
420 \item Si vous venez de terminer la saisie en Latex de \emph{l'intégralité} de votre traité d'algèbre, lequel contient propositions, théorèmes et corollaires, et que vous réalisez maintenant que ce que vous voulez c'est qu'il n'y ait plus de différence entre propositions, théorèmes et corollaires, les trois types d'énoncés devant être composés en italique, se nommer \frquote{proposition} et être numérotés avec le même compteur, vous pouvez simplement saisir dans le préambule:
421
422 \begin{tcolorbox}
423 \begin{verbatim}
424 \renewstatement{coro}{thm}{Proposition}[\itshape]
425 \renewstatement{propo}{thm}{Proposition}[\itshape]
426 \renewstatement{thm}{thm}{Proposition}[\itshape]
427 \end{verbatim}
428 \end{tcolorbox}
429 Alors avec
430 \begin{tcolorbox}
431 \begin{verbatim}
432 \setcounter{thm}{0}
433 \begin{propo}
434 La somme de deux entiers impairs est un entier pair.
435 \end{propo}
436 \begin{thm}
437 La somme de deux entiers pairs est un entier pair.\end{thm}
438 \begin{coro}
439 Si deux entiers ont la même parité, leur somme est un entier pair.
440 \end{coro}
441 \end{verbatim}
442 \end{tcolorbox}
443 vous obtiendrez:
444 \end{enumerate}
445 \renewstatement{coro}{thm}{Proposition}[\itshape]
446 \renewstatement{propo}{thm}{Proposition}[\itshape]
447 \renewstatement{thm}{thm}{Proposition}[\itshape]
448 \setcounter{thm}{0}
449 \begin{propo}
450 La somme de deux entiers impairs est un entier pair.
451 \end{propo}
452 \begin{thm}
453 La somme de deux entiers pairs est un entier pair.
454 \end{thm}
455 \begin{coro}
456 Si deux entiers ont la même parité, leur somme est un entier pair.
457 \end{coro}
458 %
459 au lieu de
460 %
461 \setcounter{thm}{0}\setcounter{propo}{0}
462 \renewstatement{thm}{thm}{Théorème}[\itshape]
463 \renewstatement{propo}{propo}{Proposition}[\itshape]
464 \renewstatement{coro}{coro}{Corollaire}
465 \begin{propo}
466 La somme de deux entiers impairs est un entier pair.
467 \end{propo}
468 \begin{thm}
469 La somme de deux entiers pairs est un entier pair.
470 \end{thm}
471 \begin{coro}
472 Si deux entiers ont la même parité, leur somme est un entier pair.
473 \end{coro}
474 \begin{enumerate}[resume]
475 \item Pour finir, \verb+\renewstatement+ et \verb+\newstatement+ ont une forme étoilée qui permet d'obtenir un type d'énoncé dont le numéro est affiché avant le nom. Mieux, si le compteur utilisé pour ce type d'énoncé est \TO{subsection} ou \TO{subsubsection}, les titres de ces énoncés sont affichés avec la même apparence et le même placement que les titres de subsection ou de subsubsection; bien sûr ce placement dépend de la valeur de \TO{notitleindent}.
476 \begin{tcolorbox}
477 \begin{verbatim}
478 \renewstatement*{thm}{thm}{Theorème}
479 \begin{thm}<Théorème de d'Alembert-Gauss>
480 [théorème fondamental de l'algèbre]
481 Tout polynôme non constant à coefficients complexes
482 possède au moins une racine complexe.
483 \end{thm}
484 \renewstatement*{thm}{subsection}{Theorème}[\itshape]
485 \begin{thm}<Théorème de d'Alembert-Gauss>
486 [théorème fondamental de l'algèbre]
487 Tout polynôme non constant à coefficients complexes
488 possède au moins une racine complexe.
489 \end{thm}
490 \renewstatement*{thm}{subsubsection}{Theorème}
491 \begin{thm}<Théorème de d'Alembert-Gauss>
492 [théorème fondamental de l'algèbre]
493 Tout polynôme non constant à coefficients complexes
494 possède au moins une racine complexe.
495 \end{thm}
496 \end{verbatim}
497 \end{tcolorbox}
498 \end{enumerate}
499 \end{example}
500 \renewstatement*{thm}{thm}{Theorème}
501 \begin{thm}<Théorème de d'Alembert-Gauss>
502 [théorème fondamental de l'algèbre]
503 Tout polynôme non constant à coefficients complexes
504 possède au moins une racine complexe.
505 \end{thm}
506 \renewstatement*{thm}{subsection}{Theorème}[\itshape]
507 \begin{thm}<Théorème de d'Alembert-Gauss>
508 [théorème fondamental de l'algèbre]
509 Tout polynôme non constant à coefficients complexes
510 possède au moins une racine complexe.
511 \end{thm}
512 \renewstatement*{thm}{subsubsection}{Theorème}
513 \begin{thm}<Théorème de d'Alembert-Gauss>
514 [théorème fondamental de l'algèbre]
515 Tout polynôme non constant à coefficients complexes
516 possède au moins une racine complexe.
517 \end{thm}
518
519
520
521 \section{Exercices}
522 \subsection{Commandes permettant la mise en forme d'exercices}
523 La classe tango fournit la commande \verb+\exo+ qui permet de présenter des énoncés d'exercices numérotés (le compteur est \TO{tgoexo}). Il existe une version étoilée, sans numéro. Comme pour les types d'énoncés, l'argument optionnel entre crochets permet d'obtenir un complément au titre, composé entre parenthèses et la première option, balisée par \frquote{\TO{< >}} permet d'obtenir un titre de substitution.
524 \begin{tcolorbox}
525 \begin{verbatim}
526 \exo
527 Démontrer que si $G$ est un groupe fini et $H$ un
528 sous-groupe de $G$, l'ordre de $H$ divise l'ordre de $G$.
529 \exo[théorème de Lagrange]
530 Démontrer que si $G$ est un groupe fini et $H$ un
531 sous-groupe de $G$, l'ordre de $H$ divise l'ordre de $G$.
532 \end{verbatim}
533 \end{tcolorbox}
534 \exo
535 Démontrer que si $G$ est un groupe fini et $H$ un
536 sous-groupe de $G$, l'ordre de $H$ divise l'ordre de $G$.
537 \exo[théorème de Lagrange]
538 Démontrer que si $G$ est un groupe fini et $H$ un
539 sous-groupe de $G$, l'ordre de $H$ divise l'ordre de $G$.
540 \begin{tcolorbox}
541 \begin{verbatim}
542 \newcommand\tgostar{\raisebox{-0.5ex}{\large\textborn}}
543 \exo*<Problème des restes chinois>[\tgostar\tgostar\tgostar]
544 Soit $n_1,\ldots, n_k$ $k$ entiers strictement supérieurs à $1$. Notons $N$
545 le produit des $n_i$. Démontrer que si les $n_i$ sont premiers entre eux deux
546 à deux et si $a_1,\ldots, a_k$ sont des entiers quelconques, le système
547 \begin{align*}
548 x&\equiv a_1 \pmod{n_1}\\
549 &\!\vdots\\
550 x&\equiv a_k \pmod{n_k}
551 \end{align*}
552 possède une solution, unique modulo $N$.
553 \end{verbatim}
554 \end{tcolorbox}
555 \newcommand\tgostar{\raisebox{-0.5ex}{\large\textborn}}
556 \exo*<Problème des restes chinois>[\tgostar\tgostar\tgostar]
557 Soit $n_1,\ldots, n_k$ $k$ entiers strictement supérieurs à $1$. Notons $N$
558 le produit des $n_i$. Démontrer que si les $n_i$ sont premiers entre eux deux à deux et si
559 $a_1,\ldots, a_k$ sont des entiers quelconques, le système
560 \begin{align*}
561 x&\equiv a_1 \pmod{n_1}\\
562 &\!\vdots\\
563 x&\equiv a_k \pmod{n_k}
564 \end{align*}
565 possède une solution, unique modulo $N$.
566 \subsection{Environnements secexo et chapexo}
567 Ces deux environnements conçus pour présenter une partie consacrée aux exercices à la fin d'une section (dans le cas de \TO{secexo}) ou d'un chapitre (dans le cas de \TO{chapexo}). À l'intérieur de ces environnements, on utilise en principe la commande \verb+\exo+.
568
569 Le titre, en capitales et centré, est \frquote{EXERCICES} par défaut; l'argument optionnel entre crochets vous permet d'en choisir un autre. Ce titre est ajouté à la table des matières ou au sommaire.
570
571 Enfin, ces commandes possèdent des formes étoilées (\verb+\begin{secexo*)+…\verb+\end{secexo*}+) qui vous permettront de composer ces parties consacrées aux exercices dans un corps plus petit (excepté si la taille de la fonte principale du document est 9pt).
572
573 \begin{tcolorbox}
574 \begin{verbatim}
575 \begin{secexo*}[Exemple d'une partie consacrée aux exercices]
576 \exo Démontrer que la somme de deux entiers pairs est un entier pair.
577 \exo Démontrer que la somme de deux entiers impairs est un entier pair.
578 \end{secexo*}
579 \end{verbatim}
580 \end{tcolorbox}
581 \begin{secexo*}[Exemple d'une partie consacrée aux exercices]
582 \exo Démontrer que la somme de deux entiers pairs est un entier pair.
583 \exo Démontrer que la somme de deux entiers impairs est un entier pair.
584 \end{secexo*}
585
586 \section{Listes}\label{lists}
587 \subsection{Principes généraux}
588 En ce qui concerne les marges, les déplacements horizontaux dans tango se font par pas multiples entiers de \verb+\TgoStandardMargin+. Au chargement de la classe, la valeur de ce paramètre est fixée à 1.5em, ainsi que les retraits d'alinéas et les retraits subis par les titres (à moins que ces valeurs ne soient fixées à zéro). les marqueurs successifs des environnements itemize et enumerate sont donc positionnés à 1.5em, 3em, 4.5em, etc. de la marge principale. Il n'est pas forcément recommandé de changer cette configuration (si vous souhaitez le faire, il convient d'utiliser le package \TO{enumitem}).
589
590 \subsection{Environnements basés sur l'environnement list}
591 Il existe deux façons de configurer les listes dans tango. La première, active par défaut, est obtenue grâce à la commande \verb+\tgostandardlists+; la seconde grâce à la commande \verb+\tgosmartlists+.
592 %
593 Avec \verb+\tgostandardlists+, le texte correspondant à un niveau donné est décalé vers la droite (d'une quantité égale à \verb+\TgoStandardMargin+...) par rapport au marqueur correspondant.
594 %
595 Avec \verb+\tgosmartlists+, à l'inverse, le texte correspondant à un niveau donné est décalé vers la gauche (d'une quantité égale à \verb+\TgoStandardMargin+...) par rapport au marqueur correspondant.
596 \renewtgolabels*\tgostandardlists
597
598 Voici le comportement par défaut de l'environnement \TO{itemize} (de ce point de vue \TO{enumerate} n'est pas différent).
599 \begin{itemize}
600 \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.
601 \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.
602 \begin{itemize}
603 \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.
604 \begin{itemize}
605 \item Donec vehicula augue eu neque. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.
606 \begin{itemize}
607 \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.
608 \end{itemize}
609 \item Donec varius orci eget risus. Duis nibh mi, congue eu, accumsan eleifend, sagittis quis, diam.
610 \end{itemize}\end{itemize}
611 \item Cras viverra metus rhoncus sem. Nulla et lectus vestibulum urna fringilla ultrices. Phasellus eu tellus sit amet tortor gravida placerat.
612 \end{itemize}
613
614 \bigskip
615
616 Et maintenant, avec \verb+\tgosmartlists+ \tgosmartlists
617 \begin{itemize}
618 \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.
619 \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.
620 \begin{itemize}
621 \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.
622 \begin{itemize}
623 \item Donec vehicula augue eu neque. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.
624 \begin{itemize}
625 \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.
626 \end{itemize}
627 \item Donec varius orci eget risus. Duis nibh mi, congue eu, accumsan eleifend, sagittis quis, diam.
628 \end{itemize}\end{itemize}
629 \item Cras viverra metus rhoncus sem. Nulla et lectus vestibulum urna fringilla ultrices. Phasellus eu tellus sit amet tortor gravida placerat.
630 \end{itemize}
631
632 Notez que \verb+\tgosmartlists+ peut sembler intéressant lorsque l'on utilise essentiellement le premier niveau de ces environnements.
633 Dans la mesure où \verb+\tgosmartlists+ supporte assez mal une construction comme
634 \begin{tcolorbox}
635 \begin{verbatim}
636 \begin{enumerate}
637 \item\begin{enumerate}\item
638 …
639 \end{verbatim}
640 \end{tcolorbox}
641 fréquente dans la numérotation des questions d'exercices,
642 les environnements \TO{secexo} et \TO{chapexo} basculent localement vers \verb+\tgostandardlists+. Cela n'est pas le cas de \verb+\exo+ qui, en en tant que commande, n'a pas de contexte propre, contrairement aux environnements. \tgostandardlists
643
644 \subsection{Redéfinition de certains marqueurs de liste pour itemize}
645 La classe tango fournit la commande \verb+\renewtgolabels+ qui permet de modifier les marqueurs de l'environnement \TO{itemize}. Les arguments des quatre niveaux sont numérotés de 1 à 4 et doivent être utilisés comme ci-dessous.
646
647 \begin{example}[Exemples]
648 \begin{itemize}
649 \item\verb=\renewtgolabels1{\lefthand}= remplace le marqueur du niveau 1 par le symbole \lefthand.
650 \renewtgolabels1{\lefthand}
651 \item\verb=\renewtgolabels4{\textbullet}1{\openbullet}3{\textemdash}= change les marqueurs des premier, troisième et quatrième niveaux. Le marquer du niveau 2 est inchangé. Comme vous le voyez, l'ordre des arguments est sans importance. \renewtgolabels4{\textbullet}1{\openbullet}3{\textemdash}
652 \end{itemize}
653 \end{example}
654
655 Il existe également une version étoilée, qui restaure l'état initial des marqueurs (tel qu'au chargement de la classe), soit \verb=\textbullet=, \textbullet, pour le niveaul~1, \verb=\textopenbullet=, \textopenbullet, pour le niveau~2, \verb=\starredbullet=, \starredbullet, pour le niveau~3 et \verb=\textperiodcentered=, \textperiodcentered{} pour le niveau~4 (remarquez que ce sont les valeurs par défaut pour tango, mais \emph{non} pour Latex).
656
657 \renewtgolabels*
658 \begin{example}[Exemples]
659 \begin{itemize}
660 \item\verb=\renewtgolabels*= restaure toutes les valeurs initiales.
661 \item\verb=\renewtgolabels*2{\textendash}= restaure les valeurs initiales, sauf pour le deuxième niveau qui utilisera désormais \textendash.
662 \end{itemize}
663 \end{example}
664
665
666 \section{Autres environnements}
667 En plus des environnements définis pour les types d'énoncés, la classe tango offre les quatre environnements suivants.
668
669 \subsection{Environnements remark et example}
670 \begin{tcolorbox}
671 \begin{verbatim}
672 \begin{remark}
673 Voici une excellente remarque.
674 \end{remark}
675 \begin{example}
676 Voici un très court exemple.
677 \end{example}
678 \end{verbatim}
679 \end{tcolorbox}
680 \begin{remark}
681 Voici une excellente remarque.
682 \end{remark}
683 \begin{example}
684 Voici un très court exemple.
685 \end{example}
686
687 Ces deux environnements ont un argument optionnel entre crochets qui permet de définir un titre alternatif. Par exemple:
688 \begin{tcolorbox}
689 \begin{verbatim}
690 \begin{example}[Remarques]
691 \begin{enumerate}
692 \item Une première (et excellente) remarque.
693 \item Une seconde remarque (encore meilleure, si cela est possible).
694 \end{enumerate}
695 \end{example}
696 \end{verbatim}
697 \end{tcolorbox}
698 \begin{example}[Remarques]
699 \begin{enumerate}
700 \item Une première (et excellente) remarque.
701 \item Une seconde remarque (encore meilleure, si cela est possible).
702 \end{enumerate}
703 \end{example}
704
705 \subsection{Environnement alert}
706 \begin{tcolorbox}
707 \begin{verbatim}
708 \begin{alert}
709 Vous ne devriez pas envisager d'utiliser
710 \verb+\expandafter\expandafter\expandafter+
711 à moins que vous ne soyez un utilisateur expérimenté de
712 \TeX{}, car vous pourriez attraper une terrible migraine.
713 \end{alert}
714 \end{verbatim}
715 \end{tcolorbox}
716 \begin{alert}
717 Vous ne devriez pas envisager d'utiliser \verb+\expandafter\expandafter\expandafter+
718 à moins que vous ne soyez un utilisateur expérimenté de \TeX{}, car vous pourriez attraper une terrible migraine.
719 \end{alert}
720
721 L'environnement \TO{alert} propose lui aussi un argument optionnel entre crochets.
722 \begin{tcolorbox}
723 \begin{verbatim}
724 \begin{alert}[\bomb]
725 Vous ne devriez pas envisager d'utiliser
726 \verb+\expandafter\expandafter\expandafter+
727 à moins que vous ne soyez un utilisateur expérimenté de
728 \TeX{}, car vous pourriez attraper une terrible migraine.
729 \end{alert}
730 \end{verbatim}
731 \end{tcolorbox}
732 \begin{alert}[\bomb]
733 Vous ne devriez pas envisager d'utiliser
734 \verb+\expandafter\expandafter\expandafter+
735 à moins que vous ne soyez un utilisateur expérimenté de
736 \TeX{}, car vous pourriez attraper une terrible migraine.
737 \end{alert}
738
739 \subsection{Environnement proof}
740 L'environnement \TO{proof} est une adaptation de ce que fournit le package \TO{amsthm}. Un titre alternatif est rendu possible grâce à l'argument optionnel entre crochets. La commande \verb+\qedhere+ est également utilisable.
741 \renewstatement{thm}{thm}{Théorème}[\itshape]
742 \setcounter{thm}{0}
743 \begin{tcolorbox}
744 \begin{verbatim}
745 \begin{thm}
746 La somme de deux entiers impairs est un entier pair.
747 \end{thm}
748 \begin{proof}
749 Soit $p$ et $q$ deux entiers impairs. Nous devons
750 établir qu'il existe un entier $n$ tel que $p+q=2n$.
751 Nous connaissons l'existence d'un entier $p_1$
752 et d'un entier $q_1$ tels que
753 \[p=2p_1+1\text{ et } q=2q_1+1,\]
754 par conséquent
755 \begin{align*}p+q&=(2p_1+1)+(2q_1+1)\\
756 &=2\underbrace{(p_1+q_1+1)}_{n}\qedhere
757 \end{align*}
758 \end{proof}
759 \end{verbatim}
760 \end{tcolorbox}
761 \begin{thm}
762 La somme de deux entiers impairs est un entier pair.
763 \end{thm}
764 \begin{proof}
765 Soit $p$ et $q$ deux entiers impairs. Nous devons
766 établir qu'il existe un entier $n$ tel que $p+q=2n$.
767 Nous connaissons l'existence d'un entier $p_1$
768 et d'un entier $q_1$ tels que
769 \[p=2p_1+1\text{ et } q=2q_1+1,\]
770 par conséquent
771 \begin{align*}p+q&=(2p_1+1)+(2q_1+1)\\
772 &=2\underbrace{(p_1+q_1+1)}_{n}\qedhere
773 \end{align*}
774 \end{proof}
775
776 \section{Figures, tableaux, flottants et légendes}\label{figtable}
777 Grâce au package \TO{caption}, les commandes suivantes ont été définies:
778 \begin{itemize}
779 \item\verb+\tgofigcaption+ (pour les figures);
780 \item and \verb+\tgotabcaption+ (pour les tableaux).
781 \end{itemize}
782 Ces deux commandes permettent d'obtenir des légendes de même apparence que ce que ferait la commande \verb+\caption+, mais fonctionnent également dans le cas d'objets non flottants.
783
784 Ainsi il devient possible d'inclure des tableaux et des figures en position fixe, sans que rien ne permette de les distinguer des objets flottants (dont l'usage reste recommandé dans la plupart des cas).
785
786 \end{document}