Tout ce que vous avez toujours voulu savoir sur LaTeX sans jamais oser le demander

Tout d'abord, pour personnaliser un document écrit avec LaTeX, il est nécessaire de connaître la manière dont sont organisés les fichiers qui composent la distribution du système TeX/LaTeX que vous utilisez. Votre serviteur utilise la distribution TeXLive pour Unix (http://www.tug.org/texlive). Dans cette distribution on pourra dans un premier temps compulser les documentations des packages se trouvant dans le répertoire :

/usr/share/texmf-texlive/doc/latex/

Ce répertoire contient d'autres sous-répertoires, généralement un par package, dont la documentation est sous la forme d'un fichier dvi ou PostScript. Dans certaines situations, il est nécessaire d'aller scruter les sources des packages. Dans la distribution teTeX ces sources se trouvent dans :

/usr/share/texmf-texlive/tex/latex

et là aussi, on trouvera généralement un répertoire par package, contenant les sources dans un fichier au format texte, portant l'extension .sty et éventuellement des fichiers connexes. Enfin, pour comprendre le comportement par défaut de LaTeX, indépendamment des packages que l'on peut inclure, on pourra avoir recours aux sources de LaTeX dans :

/usr/share/texmf-texlive/tex/latex/base/latex.ltx

et aux sources des classes de documents dans :

/usr/share/texmf-texlive/tex/latex/base/book.cls

pour la classe book.

Un moyen pratique de trouver la définition d'une commande consiste à le demander à LaTeX lors d'une session interactive. On lance directement dans un terminal de commande du système d'exploitation :

latex

Mon système me répond froidement :

This is e-TeXk, Version 3.14159-2.1 (Web2C 7.4.5)
 %&-line parsing enabled.
**

À l'invite de ce prompt spartiate (**) qui est le cri du « TeX tout nu », je réponds bravement &latex pour demander à charger le format LaTeX. La réponse ne tarde pas :

**&latex
entering extended mode
LaTeX2e <2001/06/01>
Babel <v3.7h> and hyphenation patterns for american, french loaded.
*

Notez que le prompt a perdu une étoile. À partir de maintenant on peut écrire un document LaTeX interactivement. Ce qui a certes peu d'intérêt dans l'absolu, mais peut s'avérer très utile pour obtenir la définition d'une commande avec la syntaxe. On pourra par exemple taper :

• *\showcommande

pour avoir la définition de commande. Par exemple :

*\show\mbox
> \mbox=\long macro:
#1->\leavevmode \hbox {#1}.     ← c'est la définition
<*> \show\mbox

nous montre la définition de la commande \mbox. On remarque que cette commande lorsqu'elle est appelée, se transforme en un appel à \leavevmode et \hbox. Notre esprit de curiosité nous pousse donc à écrire :

*\show\hbox
> \hbox=\hbox.                ← c'est une primitive
<*> \show\hbox

On constate ici que \hbox n'est pas définie à partir d'une autre commande. Il s'agit donc de ce que TeX appelle une primitive. L'exploration peut être poursuivie :

*\show\leavevmode
> \leavevmode=macro:
->\unhbox \voidb@x .          ← définition de \leavevmode
<*> \show\leavevmode

et ainsi de suite...

Vous avez peut-être déjà remarqué que le code LaTeX contient parfois le caractère % en fin de ligne. La présence de ce % s'explique par le fait qu'un saut de ligne dans le code insère un espace dans le texte. Ainsi la commande :

\newcommand{\beurk}{bidule}

peut s'écrire pour des raisons de lisibilité :

9.1 Sélectionnez 1. 2. 3. 4. \newcommand{\beurk}{ bidule } ==(\beurk)==

On constate donc qu'il y a deux espaces non désirés autour du mot « bidule ». On peut éviter cela en écrivant :

9.2 Sélectionnez 1. 2. 3. 4. \newcommand{\ahhh}{% bidule% } ==(\ahhh)==

Il existe une autre situation où les espaces peuvent s'immiscer pernicieusement dans le texte. Définissons un environnement :

\newenvironment{hyperimportant}{%
  \bfseries\itshape}{%
  \upshape\mdseries}

9.3 Sélectionnez 1. 2. 3. 4. 5. Il est impératif \begin{hyperimportant} de multiplier les sauvegardes \end{hyperimportant} de vos documents personnels

Si vous regardez attentivement le texte produit, vous noterez qu'il y a deux espaces de chaque côté de la séquence mise en italique gras « de ... sauvegardes » :

• deux espaces avant « de » introduits par le saut de ligne à la fin de « est impératif » et celui à la fin de \begin{hyperimportant} ;
• deux espaces après « sauvegardes » induits par le saut de ligne à la fin de « sauvegardes » et par celui à la fin de \end{hyperimportant}.

La preuve, si on supprime ces sauts de ligne :

9.4 Sélectionnez 1. 2. 3. 4. Il est impératif\begin{hyperimportant} de multiplier les sauvegardes\end{hyperimportant} de vos documents personnels

Pour éviter d'avoir à se soucier de ce genre de problème on a généralement recours à deux commandes permettant de supprimer ces espaces doubles. On fait appel, pour éliminer ceux situés avant la séquence à \ignorespaces et pour ceux situés après, à la commande \unskip.

La commande \ignorespaces▲

Cette commande procède à l'expansion des commandes qui suivent en ignorant tous les espaces qui la suivent :

9.5 Sélectionnez 1. 2. 3. 4. \newcommand{\truc}{ }\newcommand{\bidule}{ } a\truc\bidule b\par a\ignorespaces\truc\bidule b

Dans l'exemple ci-dessus, les commandes \truc et \bidule ont pour seul but de produire un espace lorsqu'elles seront appelées. Par conséquent, la ligne :

 

Sélectionnez

1.

a\truc\bidule b

produira 'a␣{␣}b' c'est-à-dire les deux lettres a et b séparées par deux espaces. L'appel avec la commande \ignorespaces ignore — comme son nom l'indique — les deux espaces produits par les commandes \truc et \bidule. On peut donc utiliser cette commande dans notre exemple précédent :

 

Sélectionnez

1.
2.

\newenvironment{hyperimportant}{%
  \bfseries\itshape\ignorespaces}{\upshape\mdseries}

qui devrait supprimer un espace :

9.6 Sélectionnez 1. 2. 3. 4. 5. Il est impératif \begin{hyperimportant} de multiplier les sauvegardes \end{hyperimportant} de vos documents personnels.

La commande \unskip▲

Si vous êtes attentif, vous noterez que deux espaces entre « sauvegardes » et « de » résistent à nos assauts. C'est là qu'intervient la primitive TeX \unskip qui enlève le dernier espace inséré :

9.7 Sélectionnez 1. 2. 3. 4. \newcommand{\truc}{ }\newcommand{\bidule}{ } a\truc\bidule b\par a\truc\bidule\unskip b

Finalement la définition « correcte » de notre environnement est la suivante :

 

Sélectionnez

1.
2.

\newenvironment{hyperimportant}{%
  \bfseries\itshape\ignorespaces}{\unskip\upshape\mdseries}

qui devrait supprimer tous les espaces indésirables :

9.8 Sélectionnez 1. 2. 3. 4. 5. Il est impératif \begin{hyperimportant} de multiplier les sauvegardes \end{hyperimportant} de vos documents personnels.

Lorsque vous vous lancerez dans l'exploration des sources des packages vous remarquerez que le nom d'une grande partie des commandes qui y sont définies contient le caractère @. Or dans un document .tex, il n'est pas autorisé d'exécuter une commande dont le nom contient ce dernier. Ceci permet de protéger ou de limiter la portée des commandes des packages. Par exemple la commande \cb@defpoint, définie dans le package changebar, ne peut pas être appelée par un utilisateur du package. Pour redéfinir ces commandes internes, il est nécessaire d'effectuer la petite manipulation suivante :

\makeatletter
% ici on peut bidouiller
\renewcommand{\@ttention}{oulala...}
\makeatother
% ici on ne peut plus

La commande hypothétique \@ttention peut uniquement être manipulée si le caractère @ est une lettre. C'est le rôle de \makeatletter qui transforme le caractère @ en une lettre comme les autres, tandis que la commande \makeatother lui réaffecte sa fonction spéciale.

Cette manipulation n'est pas nécessaire dans les fichiers de styles inclus avec la commande \usepackage pour lesquels la lettre @ peut être utilisée comme un caractère.

La manière dont TeX peut changer la catégorie des caractères est expliquée au chapitre suivant au paragraphe 10.5.1Digression vers les caractères....

Il est parfois utile de modifier une commande interne de LaTeX pour ajouter une fonctionnalité à son comportement par défaut. Par exemple pour modifier la commande interne \bidule(69), on peut procéder comme suit :

1. sauvegarder la commande grâce à l'instruction \let de TeX :

    

   Sélectionnez

   1.
   

   \let\biduleORIG\bidule
   

2. redéfinir la commande \bidule en se basant sur la définition intiale :

    

   Sélectionnez

   1.
   

   \renewcommand{\bidule}{quelque chose en plus\biduleORIG}
   

3. si nécessaire, revenir à la définition initiale grâce à :

    

   Sélectionnez

   1.
   

   \let\bidule\biduleORIG
   

Le package ifthen propose à ses vaillants utilisateurs la possibilité de manipuler des booléens. On peut en déclarer un avec la commande \newboolean :

• \newboolean{id booléen}

qui définit une « variable » booléenne identifiée par id booléen. On pourra ensuite lui affecter la valeur true ou false avec la commande \setboolean :

• \setboolean{id booléen}{valeur}

Et bien sûr on pourra utiliser le booléen ainsi créé avec les structures de contrôleStructures de contrôle et tests, par exemple comme ceci :

• \ifthenelse{\boolean{id booléen}}
  { code LaTeX si id booléen vaut vrai }
  { code LaTeX s'il vaut faux }

Il est bon de connaître la version TeX de ce qui précède. On trouve en effet dans les packages LaTeX du code écrit en TeX, et en particulier l'utilisation de la structure de contrôle « Si Alors Sinon ». Voici un exemple pour définir un nouveau booléen avec monsieur TeX :

\newif\ifimprimantecouleur

On le positionne à faux avec :

\imprimantecouleurfalse

et à vrai avec :

\imprimantecouleurtrue

On peut ensuite exploiter ce booléen dans une structure « Si Alors Sinon » à la mode TeX comme suit :

\ifimprimantecouleur
  ... % code si on a une imprimante couleur
\else
  ... % code si c'est une imprimante noir et blanc
\fi

On souhaite écrire une commande pour produire le développement de la fonction factorielle(70) de manière à pouvoir écrire :

9.9 Sélectionnez 1. 2. 3. 4. 5. On peut exprimer la factorielle de 10 comme suit : \begin{displaymath} 10!=\itfactorielle{10} \end{displaymath}

Une façon de résoudre le problème est d'écrire une commande contenant une boucle \whiledo :

\newcommand{\itfactorielle}[1]{%
  \setcounter{cptfact}{#1}% on stocke l'argument dans un compteur
  \whiledo{\value{cptfact}>1}{% tant qu'il est > 1
    \thecptfact\times% on l'affiche avec un ×
    \addtocounter{cptfact}{-1}}% on décrémente le compteur
1}% on affiche 1 à la fin

Il faudra bien sûr déclarer le compteur :

\newcounter{cptfact}

On notera que dans la condition booléenne de la boucle « TantQue », on fait appel à la commande \value pour comparer la valeur du compteur avec la valeur 1. Un peu plus tordu : on peut implémenter cette commande de manière récursive :

\newcommand{\recfactorielle}[1]{% version récursive :
\setcounter{cptfact}{#1}% on affecte l'argument au compteur
  \ifthenelse{#1>1}{% si cette valeur est supérieure à 1
    \thecptfact\times% on l'affiche suivie de ×
    \addtocounter{cptfact}{-1}% on décrémente le compteur
    \recfactorielle{\thecptfact}}% on fait un appel récursif
{1}}% sinon (valeur=1) on affiche 1

Cette commande produit évidemment le même résultat que la précédente. On notera que dans la condition du \ifthenelse on compare un nombre (#1) avec un autre (1). Enfin on pourra remarquer que la présence de la commande \times impose le mode mathématique pour exécuter ces commandes. On peut contourner le problème, si nécessaire, avec la commande \ensuremathCommandes.

Le \whiledo et le \ifthenelse ont été utilisés dans le document que vous avez sous les yeux pour générer les tableaux de symboles C.22 et C.23, ainsi que les tableaux 7.1 sur le codage du chapitre sur les documents en français. Nous avons tout d'abord créé une commande permettant d'afficher un symbole :

9.10 Sélectionnez 1. 2. \affsymb{pzd}{249} \affsymb{pzd}{75} \affsymb{pzd}{221} \affsymb{pzd}{88}

Cette commande est la suivante :

\newcommand{\affsymb}[2]{%
  \framebox{% un cadre
    \parbox[][16pt][b]{1em}{% autour d'une boîte paragraphe
      \centering% de 16 pt de hauteur, 1em de large,
      \Pisymbol{#1}{#2}\\% dont le contenu centré
      \tiny#2}}}% est composé du symbole et de son numéro

L'argument #1 est le nom de la police (pzd ou psy), et l'argument #2 est le numéro de symboleAnnexe C -Symboles. Sinon, rien de particulier dans cette commande, si vous avez suivi jusqu'ici (notamment en lisant le chapitre 4Un pas vers la sorcellerie et plus particulièrement le paragraphe 4.4Boîtes)… Nous avons ensuite défini une commande permettant d'afficher une série de symboles :

9.11 Sélectionnez 1. 2. 3. 4. 5. Voici les symboles Zapf Dingbats, à partir du \No 40, sur 3 lignes et 6 colonnes : \begin{center} \symboles[40]{pzd}{3}{6} \end{center}

Voici le code de la commande \symboles :

\newcommand{\symboles}[4][0]{%
  \setcounter{clig}{0}% Mise à zéro des compteurs de ligne
  \setcounter{ccol}{0}% et de colonne
  \setcounter{cligmax}{#3}% arguments 3 et 4 pour fixer
  \setcounter{ccolmax}{#4}% le nombre max de colonnes et de lignes
  % Pour chaque ligne :
  \whiledo{\value{clig}<\value{cligmax}}{%
    \setcounter{ccol}{0}% remise à zéro du compteur de colonne
    % et pour chaque colonne :
    \whiledo{\value{ccol}<\value{ccolmax}}{%
      % on calcule le numéro du symbole
      \setcounter{csym}{%
        \value{clig}*\value{ccolmax}+\value{ccol}+#1}
      % si sa valeur est inférieure à 256
      \ifthenelse{\value{csym}<256}{%
        \affsymb{#2}{\thecsym}}{% on l'affiche
        \mbox{}}% sinon on créé un boîte vide
      \stepcounter{ccol}}% on passe à la colonne suivante
    \stepcounter{clig}% on passe à la ligne suivante
    % on saute une ligne , sauf à la fin
    \ifthenelse{\value{clig}<\value{cligmax}}{\\}{}}}

Il faudra bien sûr déclarer les cinq compteurs avec la commande \newcounter.

9.12 Sélectionnez 1. 2. 3. 4. 5. 6. Et je sais que vous êtes tout particulièrement curieux de voir ce que fait cette commande lorsque le compteur dépasse les bornes : \begin{center} \symboles[240]{psy}{3}{6} \end{center}

C'est une pratique courante — on le verra par la suite — de créer des commandes ayant un comportement différent selon la parité de la page. À l'entrée « Finding if you're on an odd or an even page » de la Faq anglaise [14] est expliqué que le naïf :

\ifthenelse{\isodd{\value{page}}}
{ ... la page est impaire ... }
{ ... la page est paire ... }

peut ne pas donner le résultat escompté. Le compteur de page lorsqu'il est examiné à la frontière entre deux pages peut ne pas être à jour : le compteur de page s'il est interrogé au début d'une page renverra le numéro de la page précédente... Ceci est dû à la manière dont TeX procède pour effectuer les sauts de page. Pour contourner ce problème plusieurs solutions sont possibles. Celle adoptée dans ce document consiste à utiliser le package chngpage qui insère artificiellement un \label à l'endroit où l'on veut tester la parité de la page.

Par conséquent dans le cas où le test de parité à réaliser peut être évalué à la frontière entre deux pages, il faudra écrire :

\checkoddpage%
\ifcpoddpage
  ... la page est impaire ...
\else
  ... la page est paire...
\fi

Pour conserver une homogénéité dans l'allure des caractères dans un document LaTeX, sont définies trois familles :

1. kitxmlcodeinlinelatexdvp\textrm{la famille roman celle que vous êtes en train de lire}finkitxmlcodeinlinelatexdvp ;
2. kitxmlcodeinlinelatexdvp\textsf{la famille sans sérif que vous êtes également en train de lire à l'instant même}finkitxmlcodeinlinelatexdvp ;
3. et la famille machine à écrire, également appellée « typewriter » lorsqu'on est anglophone, que — cela ne vous aura sans doute pas échappé — kitxmlcodeinlinelatexdvp\texttt{vous êtes en train de lire}finkitxmlcodeinlinelatexdvp.

Il est important de noter que ces trois familles de fontes sont par défaut trois familles de la police baptisée par son auteur (Knuth lui-même) « Computer Modern ». Elles sont conçues pour s'harmoniser au sein d'un même document. Dans cet ordre d'idée, il faudra toujours veiller à ce que ces trois familles (roman, sans sérif, et machine à écrire) soient visuellement « compatibles » entre elles. Les distributions de LaTeX proposent généralement des packages permettant d'utiliser les fontes PostScript dans un document, avec notamment le célèbre(71) package times utilisant :

•  ;
•  ;
• .

De même le package newcent utilise :

1.  ;
2.  ;
3. .

Une fonte(72) ou police de caractères est définie dans LaTeX par plusieurs caractéristiques dont il a été question au paragraphe 2.1Mise en évidence. De manière à désigner la fonte à l'aide des commandes que nous allons découvrir dans ce paragraphe, on utilisera :

• un codage qui sera à quelques exceptions près le codage T1 ;
• une série de caractères identifiant la famille : cmr pour « computer modern roman », ptm pour « PostScript times », etc.
• une série de caractères pour la « graisse » de la fonte : m pour « médium », b pour « bold » (gras), bx pour « bold extended » (gras étendu, c'est-à-dire gras avec des caractères plus larges), etc.
• une série de caractères définissant l'allure (shape en anglais) de la fonte : n pour « normal », it pour « italique », sl pour « slanted » (penché), etc.

Fontes « computer modern »▲

Il s'agit d'un ensemble de fontes dessinées par Donald Knuth et utilisées par défaut dans LaTeX. Les commandes \emph, \textbf, etc. sélectionnent donc automatiquement ces polices.

Fontes en béton▲

Elles ont été dessinées par Knuth pour son ouvrage intitulé « Mathématiques concrètes ». Le package beton(73) permet de les charger dans un document.

Fontes « gothiques »▲

Fontes PostScript▲

Les fontes ci-dessous sont généralement disponibles gratuitement et résident la plupart du temps dans les imprimantes.

Globalement▲

\renewcommand{\rmdefault}{pnc}
\renewcommand{\sfdefault}{pag}
\renewcommand{\ttdefault}{pcr}

Localement▲

Il est toujours possible de changer localement de fonte dans un texte en spécifiant les paramètres nécessaires :

9.13 Sélectionnez 1. 2. 3. 4. 5. {\fontfamily{cmfr}\selectfont On passe en ``Funny Roman'' et même qu'on peut faire de l'\emph{italique}... c'est dingue !} Et hop nous voila de nouveau en \verb+\rmdefault+

Les appels qu'il est possible de faire avant la commande \selectfont sont :

• \fontencoding pour le codage ;
• \fontfamily avec comme argument la famille (cmr pour Computer Modern, ptm pour PostScript Times, etc.) ;
• \fontseries pour préciser la graisse (argument b pour gras, m pour la graisse moyenne, etc. ) ;
• \fontshape pour l'allure de la fonte (argument n pour normal, sl pour penché, etc.) ;
• \fontsize avec deux arguments : la taille des caractères et l'espace entre deux lignes consécutives.

Voici un autre exemple :

9.14 Sélectionnez 1. 2. 3. 4. 5. {\fontfamily{ppl}\fontseries{b}% \fontsize{2cm}{2.5cm}\selectfont gros !} Et nous voila de nouveau en \verb+\rmdefault+

Finalement, s'il on veut faire appel de manière répétée à une fonte dont tous les attributs sont fixes, on pourra avoir recours à la commande \DeclareFixedFont prenant six arguments (nom, codage, famille, graisse, allure, taille) et permettant d'être ensuite utilisée comme une déclaration :

9.15 Sélectionnez 1. 2. 3. 4. \DeclareFixedFont{\toupiti}{T1}{pag}{m}{n}{3pt} Avant {\toupiti bon bé là à moins d'avoir une bonne loupe vous ne serez pas capable de lire ce texte} après.

Pour définir un environnement basé sur les listes, on utilisera la syntaxe suivante :

\newenvironment{maliste}%
{\begin{list}%
  { ... code pour l'item par défaut ... }
  { ... caractéristiques de la liste ... }
}%
{\end{list}}

L'environnement list prend donc deux arguments. Le premier permet de définir l'allure de l'étiquette (ou item) par défaut. Le second permet de définir la liste elle-même et en particulier :

Sa géométrie : les marges, les espaces entre les paragraphes composant la liste, les espaces entre la liste et l'environnement dans lequel elle est insérée, etc.

la production de l'étiquette : c'est-à-dire la manière dont on va effectivement produire le titre de chaque entrée de la liste.

La liste suivante tente d'illustrer les différentes dimensions que l'on peut modifier pour définir sa propre liste :

La commande \makelabel prenant un argument, permet de produire l'étiquette. Ainsi lorsqu'on entre la commande \item[texte étiquette], il est fait appel à la commande \makelabel{texte étiquette}.

Pour comprendre le fonctionnement de l'environnement list et plus particulièrement le principe du positionnement relatif de l'étiquette et du paragraphe adjacent, on peut imaginer que les éléments sont positionnés dans l'ordre suivant :

1. le paragraphe est d'abord positionné par rapport à la marge de gauche à l'aide de la longueur \leftmargin ;
2. la première ligne du paragraphe est ensuite indenté à l'aide de la longueur \itemindent ;
3. puis l'étiquette est positionnée relativement au début du paragraphe ainsi indenté à l'aide de la longueur \labelsep.

Il découle de ceci que l'entrée de liste (ou étiquette) peut être produite dans la marge de gauche... La figure 9.1 illustre le positionnement de l'entrée de liste par rapport au paragraphe dans les deux situations suivantes :

• cas de la figure 9.1a où la largeur de l'entrée de liste est inférieure à la dimension \labelwidth. Dans ce cas l'entrée de liste est positionnée à une distance de \labelsep du paragraphe, lui même étant indenté de \itemindent et positionné par rapport à la marge gauche à l'aide de \leftmargin ;
• cas de la figure 9.1b : la largeur de l'entrée de liste est supérieure à la dimension \labelwidth. Dans ce cas l'entrée de liste est toujours positionnée à la distance \labelsep du paragraphe, mais celui-ci est indenté d'une valeur supérieure à \itemindent.

On peut également régler les blancs verticaux dans l'environnement list. Ces paramètres permettent notamment de définir les espaces entre les paragraphes constituant les entrées de liste, mais également les blancs que l'on veut insérer avant ou après la liste. Il s'agit de :

• \itemsep : l'espace entre chaque entrée de liste ;
• \parsep : l'espace entre deux paragraphes à l'intérieur d'une entrée de liste ;
• \topsep : le blanc inséré avant et après l'environnement créé, auquel est ajouté \partopsep si celui-ci commence un nouveau paragraphe.

Tous les paramètres de l'environnement list ont des valeurs par défaut. Les longueurs pour les réglages horizontaux sont par défaut les suivantes sur le système de votre serviteur :

Et pour les réglages verticaux :

La commande \makelabel est quant à elle définie par :

\hfil #1

par conséquent, dans la boîte de largeur \labelwidth, le contenu de l'étiquette est poussé à droite. Ainsi si on définit une liste simple avec :

\newenvironment{listebasique}
{\begin{list}{}{}}
{\end{list}}

On aura :

9.16 Sélectionnez 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. Avant avant avant avant avant avant avant avant avant \begin{listebasique} \item[X] o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o u u u u u u u u u u u u u u u u u u u u \item[Machin] v v v v v v v v v v v v v v \end{listebasique} Après après après après après après après après après après

avec des étiquettes, et sans étiquette :

9.17 Sélectionnez 1. 2. 3. 4. 5. 6. 7. 8. Avant avant avant avant avant avant avant avant avant avant avant avant avant avant \begin{listebasique} \item[] e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e e \end{listebasique} Après après après après après après après après après après après après après après

La liste décrivant les fichiers auxiliaires de LaTeX située annexe B.2Les fichiers auxiliaires a été produite avec le code suivant :

9.18 Sélectionnez 1. 2. 3. 4. 5. 6. 7. 8. 9. \begin{ficaux} \item[tex] fichier source \LaTeX{} ; blabla blabla blabla blabla blabla blabla blabla blabla blabla blabla blabla \item[aux] fichier auxiliaire ... \item[log] le fichier de trace ... \item[dvi] fichier \emph{device independant},... \end{ficaux}

L'environnement ficaux a lui été conçu comme suit :

\newenvironment{ficaux}{%
  \begin{list}{}{%
    \setlength{\labelwidth}{1cm}% largeur de la boîte englobant le label
    \setlength{\labelsep}{8pt}% espace entre paragraphe et l'étiquette
    \setlength{\leftmargin}{\labelwidth+\labelsep}% marge de gauche
    \renewcommand{\makelabel}[1]{% production de l'étiquette :
      \framebox[\labelwidth]{\texttt{##1}}}}}{\end{list}}

Dans cet exemple la relation :

\leftmargin=\labelwidth+\labelsep

permet de positionner l'entrée de liste comme indiqué à la figure 9.2a.

Un autre exemple : la création d'un environnement de liste numérotée pour produire des questions dans un énoncé de travaux pratiques ou autre devoir surveillé...

9.19 Sélectionnez 1. 2. 3. 4. 5. 6. 7. 8. 9. \begin{question} \item o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o \item o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o \item o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o \end{question}

Cet environnement a été produit par le code suivant :

\newenvironment{question}{\begin{list}{}{%
  \usecounter{cptquestion}%
  \setlength{\labelwidth}{2em}%
  \setlength{\labelsep}{1em}\setlength{\itemindent}{15pt}%
  \setlength{\leftmargin}{.8cm}\setlength{\rightmargin}{10pt}
  \renewcommand{\makelabel}[1]{\etiquettequestion{##1}}}}
{\end{list}}

Le positionnement correspondant est montré à la figure 9.2b page précédente. On notera que dans la définition de la liste est fait usage de la commande \usecounter permettant de créer une liste numérotée et de préciser quel compteur est utilisé. On devra donc déclarer le compteur en question :

\newcounter{cptquestion}

Enfin, chaque entrée de liste composée du numéro de la question et d'un « joli » crayon est produite par la commande :

\newcommand{\etiquettequestion}[1]{%
  \makebox[\labelwidth]{\Pisymbol{pzd}{47}$_\thecptquestion$}}

Finalement la commande :

\renewcommand{\makelabel}[1]{\etiquettequestion{##1}}}}

redéfinit la commande \makelabel comme faisant appel à notre « joli » crayon. Le premier et unique argument est passé à \etiquettequestion à l'aide de l'expression ##1, car #1 désignerait, dans le contexte de la définition de environnement question, le premier argument de celui-ci.

Dans ce manuel, on trouve dans le mémento une liste de packages (annexe B.1Extensions) produite par le code suivant :

\newenvironment{packages}{\begin{list}{}{%
  \setlength{\labelwidth}{2.5cm}%
  \setlength{\itemindent}{0pt}%
  \setlength{\leftmargin}{\labelwidth+\labelsep}%
  \renewcommand{\makelabel}[1]{%
    $\blacktriangle$ \ltxpack{##1} \hfil:}}}{\end{list}}

La commande \ltxpack est définie au paragraphe 11.1.2Autour de la génération de l'index. Pour information, l'environnement ci-dessus donne :

9.20 Sélectionnez 1. 2. 3. 4. 5. \begin{packages} \item[bidule] cette extension permet d'insérer des bidules dans son document sans avoir à savoir s'il s'agit de machin ou de truc. \end{packages}

Nous allons détailler dans cette section la manière dont la liste composant le glossaireGlossaire a été générée. Cette liste dont l'allure est donnée ci-dessous exploite deux idées :

• La longueur \labelsep peut être négative ce qui permet de superposer l'entrée de liste avec le paragraphe. Ceci est illustré à la figure 9.3a ;

• On peut créer une boîte paragraphe pour la boîte produisant l'étiquette. La boîte ainsi créée pourra donc être composée de deux lignes : celle du haut contenant le texte de l'étiquette, celle du dessous étant vide, se superpose avec le paragraphe (figure 9.3b).

Le code permettant de générer la liste ci-dessus et celle du glossaire de ce manuel est donc :

\newenvironment{glossaire}{\begin{list}{}{%
  \setlength{\labelwidth}{.5\textwidth}%
  \setlength{\labelsep}{-.8\labelwidth}%
  \setlength{\itemindent}{\parindent}%
  \setlength{\leftmargin}{25pt}%
  \setlength{\rightmargin}{0pt}%
  \setlength{\itemsep}{.8\baselineskip}%
  \renewcommand{\makelabel}[1]{\boiteentreeglossaire{##1}}}}
{\end{list}}

La valeur .8\baselineskip pour \itemsep permet d'aérer le glossaire en insérant des blancs entre chaque entrée. La commande permettant de générer la boîte contenant l'entrée de liste à superposer est :

\newcommand{\boiteentreeglossaire}[1]{%
  \parbox[b]{\labelwidth}{%
    \setlength{\fboxsep}{3pt}%
    \setlength{\fboxrule}{.4pt}%
    \shadowbox{\sffamily#1}\\\hfill\mbox{}}}

Pour comprendre comment est positionnée cette boîte, nous avons quelque peu modifié la commande précédente pour dessiner un cadre autour :

9.21 Sélectionnez 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. \begin{leglossaire} \renewcommand{\boiteentreeglossaire}{% \fboiteentreeglossaire}% \item[Bidule] o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o \item[Truc muche] o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o o \end{leglossaire}

On déclare une boîte comme expliqué au paragraphe 4.4.5Sauvegarde et réutilisation :

• \newsavebox{maboite}

On peut ensuite écrire :

• \begin{lrbox}{maboite}...contenu...\end{lrbox}

qui est parfaitement équivalent à :

• \savebox{maboite}{...contenu...}

Bon mais alors si c'est la même chose, à quoi ça sert ?? Ca sert pour la définition d'un environnement.

Supposons, par exemple l'existence d'un environnement :

\newenvironment{remarque}{%
  % clause begin
  \begin{center}\begin{minipage}{.8\textwidth}}{%
  % clause end
  \end{minipage}\end{center}}

Et :

9.22 Sélectionnez 1. 2. 3. 4. 5. 6. On peut faire la remarque (édifiante) suivante : \begin{remarque} Jazz is not dead. It just smells funny. \hfill Frank \textsc{Zappa} \end{remarque} Et on reprend notre propos.

À la question : comment pourrait-on faire pour encadrer cette remarque ? nous répondons sans hésiter : « avec l'environnement lrbox ». Dans la mesure où il n'y a pas de moyen avec LaTeX de commencer une \fbox dans la clause begin et de la finir dans la claude end, on utilisera le principe suivant :

1. stocker le contenu à encadrer à l'aide de l'environnement lrbox ;
2. l'encadrer en réutilisant la boîte ainsi construite.

On aura donc :

\newsavebox{\boiteremarque}
\newenvironment{remarque}{%
  % clause begin
  \begin{lrbox}{\boiteremarque}% début mise en boîte
  \begin{minipage}{.8\textwidth}}{%
  % clause end
  \end{minipage}
  \end{lrbox}% fin mise en boîte
  % production de la boîte encadrée
  \begin{center}
    \fbox{\usebox{\boiteremarque}}
  \end{center}}

9.23 Sélectionnez 1. 2. 3. 4. 5. 6. On peut faire la remarque (édifiante) suivante : \begin{remarque} Jazz is not dead. It just smells funny. \hfill Frank \textsc{Zappa} \end{remarque} Et on reprend notre propos.

Cette idée est utilisée à plusieurs reprises dans les deux chapitres qui suivent.

Il faut noter que la boîte que définit l'environnement lrbox est une boîte simpleBoîtes simples à l'instar des boîtes créées par les commandes de la famille \mbox et par conséquent ne peut contenir de saut de paragraphe.

Avant toute chose il faut savoir qu'on peut agir sur la table des matières à l'aide de deux compteurs :

1. secnumdepth (section numbering depth) stipulant la profondeur de la numérotation des titres dans le document ;
2. tocdepth (table of contents depth) définissant quel est le niveau (ou profondeur) de titre maxi dans la table des matières.

Pour utiliser ces deux compteurs, il faut en outre avoir connaissance de la manière dont LaTeX associe une profondeur à chaque titre. Et bien réjouissez-vous, le tableau suivant vous fournit cette information :

Ainsi, affecter la valeur 1 à secnumdepth et la valeur 2 à tocdepth numérotera les titres jusqu'aux \sections et insérera dans la table des matières, tous les titres jusqu'aux \subsections...

Dans le fichier book.cls du système TeX, on trouve le code suivant(76) :

\newcommand{\section}{%
  \@startsection%
  {section}% nom du titre
  {1}% niveau de titre
  {0pt}% indentation
  {-3.5ex plus -1ex minus -.2ex}% espace vertical avant
  {2.3ex plus.2ex}% espace vertical après
  {\normalfont\Large\bfseries}} % allure du titre

Ce code permet de définir comment sera produit le titre d'une section. On constate que la \section fait appel à la commande \@startsection, cette dernière attendant six arguments :

• le nom du titre : section, subsection, etc.
• son niveau : 1 pour section, 2 pour subsection, 3 pour subsubsection, etc.
• son indentation ;
• le blanc vertical avant le titre ;
• le blanc vertical après le titre ;
• un ensemble de déclarations pour formater le titre lui-même.

On pourra donc noter que la mise en page par défaut de LaTeX pour les sections dans la classe book est la suivante :

• pas d'indentation (0pt)
• espace avant le titre de 3.5ex avec un tolérance de plus -1ex et moins -.2ex ;
• espace après le titre de 2.3ex avec une tolérance de plus .2ex ; on pourra noter que si l'espace est négatif, le paragraphe commence juste après le titre, et non sur un nouveau paragraphe ;
• les titres sont en gros et en gras dans la fonte « normale ».

Pour définir l'allure des sections de ce document, nous avons introduit trois longueurs pour l'indentation de sections, subsections et subsubsections :

\newlength{\sectiontitleindent}
\newlength{\subsectiontitleindent}
\newlength{\subsubsectiontitleindent}

Ces longueurs ont pour valeur :

\setlength{\sectiontitleindent}{-1cm}
\setlength{\subsectiontitleindent}{-.5cm}
\setlength{\subsubsectiontitleindent}{-.25cm}

D'autre part, nous avons défini une fonte particulière pour les titres, définie comme suit :

\newcommand{\sectionfont}{%
  \fontencoding{\encodingdefault}%
  \fontfamily{pag}%
  \fontseries{bc}%
  \fontshape{n}%
  \selectfont}

Cette commande permet de sélectionner la fonte PostScript Avant-Garde en gras condensé (cf. 9.4Fontes). Finalement, pour définir l'allure de nos sections on utilisera :

\renewcommand{\section}{%
  \@startsection%
  {section}%
  {1}%
  {\sectiontitleindent}%
  {-3.5ex plus -1ex minus -.2ex}%
  {2.3ex plus.2ex}%
  {\sectionfont\Large}}

Des commandes équivalentes ont été écrites pour les titres de niveaux inférieurs.

C'est en fouillant dans le fichier book.cls qu'on peut trouver des informations sur la manière dont LaTeX produit les en-têtes de chapitres.

Principe▲

\newcommand{\chapter}{%
  ...
  \thispagestyle{plain}%
  ...
  \secdef\@chapter\@schapter} % la ligne qui nous intéresse

\def\@chapter[#1]#2{%
   ...
  \refstepcounter{chapter}%
  \typeout{\@chapapp\space\thechapter.}% message sur le terminal
  \addcontentsline{toc}{chapter}% ajout du titre dans la toc
  ...
  \if@twocolumn
  ...
  \else% le cas d'un document à une colonne
  \@makechapterhead{#2}% la ligne qui nous intéresse
  \fi}

Petits outils nécessaires▲

\newenvironment{cadrechap}%
{\begin{list}{}{%
    \setlength{\leftmargin}{0pt}%
    \setlength{\rightmargin}{-2cm}% on se met au large
    \setlength{\itemindent}{0pt}%
    \setlength{\labelsep}{0pt}%
  }\item}%
{\end{list}}

En-tête des chapitres à proprement parler▲

Pour ce manuel la commande qui produit l'en-tête du chapitre a été définie comme un assemblage de deux minipages :

1. sur la gauche une boîte minipage dont la hauteur est imposée pour y mettre le mini-sommaire (cf. §10.7Une boîte pour la minitable des matières) ;
2. sur la droite une boîte contenant le mot « Chapitre » et son numéro

Le squelette pour réaliser un tel assemblage de boîte est le suivant :

 

Sélectionnez

1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

\begin{cadrechap}
  \begin{minipage}[t][6cm][t]{0.75\linewidth}
    % insertion ici du mini−sommaire
  \end{minipage}
  \begin{minipage}[t]{0.25\linewidth}
    % insertion ici du n ° de chapitre
  \end{minipage}
  \begin{flushright}
    % insertion ici du titre du chapitre
  \end{flushright}
\end{cadrechap}

Il est sans doute utile de noter ici que la boîte de gauche (celle qui reçoit la mini table des matières) a une hauteur imposée ce qui permet de produire les en-têtes de chapitres de manière identique quel que soit le nombre de sections de chapitres (et donc quelle que soit la hauteur de la mini table des matières). Pour finir, il reste à définir des fontes pour les différents éléments. Pour ce manuel ont été définies :

 

Sélectionnez

1.
2.
3.
4.
5.
6.

% numéro du chapitre
\DeclareFixedFont{\chapnumfont}{T1}{phv}{b}{n}{80pt}
% pour le mot « Chapitre »
\DeclareFixedFont{\chapchapfont}{T1}{phv}{b}{n}{16pt}
% pour le titre
\DeclareFixedFont{\chaptitfont}{T1}{phv}{b}{n}{24.88pt}

D'ailleurs :

10.2 Sélectionnez 1. 2. {\chapnumfont 8} {\chaptitfont Oula !}

Dans le fichier book.cls on trouve la définition de la commande \part :

\newcommand\part{%
  \cleardoublepage
  \thispagestyle{plain}
  [...]
  \null\vfil
  \secdef\@part\@spart}

qui nous informe qu'à l'instar des chapitres, la commande \part fait appel à deux commandes distinctes pour produire les parties numérotées et non numérotées (grâce à un appel aux commandes \@part et \@spart respectivement). Dans un premier temps nous avons imposé que le style de page pour les débuts de partie soit vide (c'est-à-dire sans numéro de page ni en-tête etc.), nous avons donc écrit :

\newcommand\part{%
  \cleardoublepage
  \thispagestyle{empty}% à la place de plain par défaut
  [...]
  \null\vfil% un boîte vide et un ressort vertical
  \secdef\@part\@spart}

On peut ensuite examiner la définition de la commande \@part qui produit la page de partie :

\def\@part[#1]#2{%
  [...]
  {\centering % centrage
    [...]
    \huge\bfseries \partname\nobreakspace\thepart
      \par
      \vskip 20\pt
    [...]
  \Huge \bfseries #2\par}%
\@endpart}

En examinant ce code on constate que la page de partie est constituée d'une ligne en gros caractères gras, du nom « Partie » suivie du numéro de la partie(77) :

\huge\bfseries \partname\nobreakspace\thepart

suivie 20 points plus bas du titre de la partie (contenu dans l'argument #2). Pour ce manuel, nous avons redéfini la commande \@part comme suit :

\def\@part[#1]#2{%
  [...]
  {\centering
    \interlinepenalty \@M
    \normalfont
    [...]
    \partnumfont \thepart % juste le numéro de la partie
    \par
    \vskip 50\p@% 50 point au lieu de 20...
    \partfont #2\par}% le titre avec une fonte personnalisée
  \@endpart}

Pour garder une homogénéité avec les en-têtes de chapitres on a défini les commandes de fontes comme suit :

\newcommand{\partfont}{%
  \fontencoding{\encodingdefault}\fontfamily{phv}%
  \fontseries{bc}\fontshape{n}%
  \fontsize{32}{34}%
  \selectfont}
\DeclareFixedFont{\partnumfont}{T1}{phv}{bc}{n}{80}%

On notera également que la commande \@part se termine par l'appel à une autre commande : \@endpart. En examinant le fichier book.cls on pourra se rendre compte que cette dernière permet de s'opposer au ressort vertical de la commande \part et de sauter une page blanche…

Dans la classe book, LaTeX fait automatiquement appel au style plain pour les premières pages de chapitre. Pour demander au package fancyhdr de définir un style particulier pour ces pages, on écrit :

% le cas de la première page d'un chapitre
\fancypagestyle{plain}{%
  \fancyhf{}% on efface tout
  \fancyfoot[C]{\thepage}% numéro en bas de la page
  % on efface tous les traits
  \renewcommand{\headrulewidth}{0pt}%
  \renewcommand{\footrulewidth}{0pt}}

Vérifiez maintenant que les pages 3, 19, 43, 89, etc. ont ce style...

Dans la classe book en mode recto-verso (c'est le cas de ce document), LaTeX commence par défaut un chapitre sur une page impaire — appelée dans le jargon typographique la « belle page ». Pour ce faire LaTeX fait appel dans différentes commandes internes, à la commande \cleardoublepage qui permet d'insérer si nécessaire une page blanche avant le début du chapitre. Cette page reçoit par défaut le style des en-têtes et pieds en cours. Dans le manuel que vous avez sous les yeux, nous avons imposé un style « vide » à ces pages en modifiant la définition de la commande \cleardoublepage du fichier latex.ltx :

\renewcommand{\cleardoublepage}{% redéfinition de la commande
  \clearpage\ifodd\c@page\else
  \hbox{}
  \vspace*{\fill}
  \thispagestyle{empty}% ligne ajoutée
  \newpage
  \fi}

Feuilletez le manuel et cherchez si les pages vierges avant le début des chapitres sont bien vides...

Vous aurez sans doute remarqué que dans ce manuel, les en-têtes des pages contiennent des informations qui dépendent du contexte. Sont en effet insérés sur les pages paires (page de gauche) le titre du chapitre, et sur les pages impaires (page de droite) le titre de la dernière section de la page. Il est possible de produire ce genre d'en-têtes car LaTeX dispose d'un mécanisme de marqueurs que nous allons tenter d'expliquer ici.

Il n'est pas inutile de préciser maintenant que lorsque TeX et LaTeX produisent une page, ils vont garnir l'en-tête et le pied en fonction d'information collectées le long de la page en question. La production de l'en-tête et du pied est donc postérieure à la composition de la page.

Les commandes \markboth et \markright▲

Interactions avec les commandes de paragraphe▲

\renewcommand{\sectionmark}[1]{% #1 contient le titre de la section
  \markright{\sectionfont\thesection\ #1}}
\renewcommand{\chaptermark}[1]{% #2 contient le titre du chapitre
  \markboth{\sectionfont#1}{}}

\fancyhead[LE,RO]{\thepage}
\fancyhead[LO]{\rightmark}
\fancyhead[RE]{\leftmark}

Il est nécessaire de savoir que dans un document tel que celui que vous lisez, il existe trois parties qui sont reconnues par LaTeX : le front matter, le main matter et le back matter désignant respectivement le début du document (comportant généralement la préface et le sommaire), la partie principale, et la partie clôturant le document (comportant généralement la table des matières, le ou les index, la ou les bibliographies, le glossaire, etc). On doit alors explicitement écrire un document LaTeX comme suit :

\documentclass{classe du document}
\begin{document}
\frontmatter % introduction
[...]
\mainmatter % partie principale
[...]
\backmatter % pour clore le document
[...]
\end{document}

Nous verrons dans la suite de ce chapitre que nous serons amenés à modifier les trois commandes permettant de passer d'une partie à une autre. Pour l'instant, il faut savoir que la classe book définit un booléen :

\newif\if@mainmatter

utilisé par défaut dans LaTeX pour savoir si on se trouve dans le « main matter » ou pas. Nous avons en outre défini pour notre document un autre booléen :

\newif\if@frontmatter

qui nous permettra d'effectuer des traitements particuliers lorsqu'on sera dans la partie introductive du document. Les trois commandes délimitant les trois parties sont définies par :

\renewcommand\frontmatter{%
  \cleardoublepage
  \@frontmattertrue
  \@mainmatterfalse
  \pagenumbering{roman}% numérotation en romain
}
\renewcommand\mainmatter{%
  \cleardoublepage
  \@mainmattertrue
  \@frontmatterfalse
  \pagenumbering{arabic}% numérotation en chiffres arabes
}
\renewcommand\backmatter{%
  \cleardoublepage
  \@frontmatterfalse
  \@mainmatterfalse
}

En farfouillant dans le code de LaTeX on peut comprendre que \pagenumbering, la commande permettant de changer la numérotation, réinitialise le compteur de page à 1.

Votre serviteur a tenu à ce que les pages de l'introduction soient numérotées en chiffres romains et petites capitales. On ne peut malheureusement pas écrire :

\renewcommand{\thepage}{\textsc{\roman{page}}}

Puisque cela provoque une incompatibilité avec la gestion de l'index. L'idée retenue est de procéder comme suit :

1. utiliser la numérotation en chiffre romain minuscule ;
2. dans le pied de page afficher \textsc{\thepage} ;
3. modifier la commande \index pour que les numéros de pages s'affichent en petites capitales.

D'où dans la définition de \frontmatter on ajoutera :

\let\indexORI\index % sauvegarde de la définition initiale
\renewcommand{\index}[1]{\indexORI{##1|textsc}}

\fancyfoot{}
\fancyhead[LE,RO]{\textsc{\thepage}}

Et dans la définition de \mainmatter :

\let\index\indexORI% pour revenir à la définition initiale

Pour être parfaitement rigoureux on va modifier l'allure des premières pages de chapitre :

\fancypagestyle{plain}{%
  \fancyhf{}
  \if@frontmatter% introduction
    \fancyfoot[C]{\textsc{\thepage}}
  \else
    \fancyfoot[C]{\thepage}
  \fi
  \renewcommand{\headrulewidth}{0pt}
  \renewcommand{\footrulewidth}{0pt}}
\makeatother

Dans la classe book, deux environnements sont définis :

• thebibliography permettant de produire la bibliographie ;
• theindex pour produire l'index ;

et la commande :

• \tableofcontents pour produire la table des matières.

Ces environnements et cette commande sont conçus pour produire des entêtes avec le numéro de la page et le nom du chapitre en majuscules à savoir \bibname, \indexname et \contentsname. Voici par exemple un extrait de \tableofcontents :

\newcommand\tableofcontents{%
  [...]
  \chapter*{\contentsname
    \@mkboth{%
      \MakeUppercase\contentsname}%
    {\MakeUppercase\contentsname}}%
  \@starttoc{toc}%
  [...]
}

J'ai souhaité que dans ce manuel les en-têtes ne soient pas en majuscules. Deux solutions sont possibles :

1. utiliser la commande \nouppercase du package fancyhdr et écrire dans la définition de \backmatter :

    

   Sélectionnez

   1.
   2.
   

   \fancyhead[LO]{\nouppercase\rightmark}% en−tête en minuscule
   \fancyhead[RE]{\nouppercase\leftmark}%
   

2. recopier la définition de \tableofcontents provenant de book.cls, et la modifier pour supprimer les commandes \MakeUppercase. Faire la même chose pour l'index et la bibliographie.

Dans ce document, c'est la deuxième solution qui a été adoptée. On en a également profité pour insérer l'index et la bibliographie dans la table des matières, ce qui n'est pas le comportement par défaut de LaTeX et de la classe book. Nous avons donc pour l'environnement theindex :

\renewenvironment{theindex}
{%
  [...]
  % insertion dans la table des matières
  \addcontentsline{toc}{chapter}{\indexname}
  \@mkboth{\indexname}{\indexname}% suppression de \MakeUppercase
  \thispagestyle{plain}
  [...]
{\if@restonecol\onecolumn\else\clearpage\fi}

Il peut ne pas être inutile(79) de faire ici une petite digression sur la manière dont TeX mange et digère les caractères qu'on lui fournit. Il faut savoir que les caractères peuvent entrer dans seize catégories différentes. Chaque caractère peut n'appartenir qu'à une catégorie à la fois. Chacune de ces catégories permet de basculer TeX vers un traitement particulier. Par exemple lorsque le caractère \ est rencontré, TeX va lire les caractères qui suivent pour connaître le nom de la commande (ou séquence de contrôle), lorsqu'il rencontre le caractère {, TeX va ouvrir un nouveau groupe, lorsque que le caractère % est lu, TeX va ignorer les caractères jusqu'à la fin de la ligne, c'est-à-dire jusqu'à ce qu'il rencontre un caractère catégorisé « fin de ligne », etc. Parmi les catégories reconnues par TeX :

Catégorie 0 caractère de contrôle (\ dans LaTeX) ;

Catégorie 1 début de groupe ({ dans LaTeX) ;

Catégorie 2 fin de groupe (} dans LaTeX) ;

Catégorie 11 lettre ;

Catégorie 14 commentaire (% dans LaTeX) ;

On peut alors s'amuser — même si cela est assez « dangereux » — à changer le contenu de chaque catégorie. Dans l'exemple ci-dessous, on a transformé les caractères \, { et } en lettres, et on a décidé que les caractères /, ( et ) appartiendraient respectivement aux catégories : caractère de contrôle, début de groupe et fin de groupe. Le caractère # a également été changé de catégorie, c'est désormais un caractère de commentaire.

10.3 Sélectionnez 1. 2. 3. 4. 5. 6. 7. { \catcode`\/=0 \catcode`\(=1 \catcode`\)=2 \catcode`\#=14 \catcode`\{=11 \catcode`\}=11 \catcode`\\=11 # ça on devrait pas le voir... \bidule{truc muche} /textbf(en gras) )\par on retourne dans le monde \LaTeX{}...

En outre, il est intéressant de savoir que TeX peut rendre actifs certains caractères (qui entrent alors dans la catégorie 13). Ces caractères peuvent alors être définis comme des commandes voici un exemple idiot :

10.4 Sélectionnez 1. 2. 3. \catcode`\+=13 \newcommand{+}{plus} 3 + 4 = 7

Dans cet exemple on a rendu « actif » le caractère +, puis on l'a défini comme une commande. Vous noterez qu'ici on a pu créer une commande que l'on utilise sans faire appel au caractère \.

*\show~
> ~=macro:
->\nobreakspace {}.
<*> \show~

Les environnements du type de verbatim ont pour but de changer l'appartenance des caractères à leur catégorie respective. En outre, le package fancyvrb permet de définir quels caractères permettent de repasser le contrôle à LaTeX. Dans ce document, l'environnement unixcom a été défini comme suit :

\DefineVerbatimEnvironment{unixcom}{Verbatim}{%
  commandchars=¢«»,
  frame=single, framerule=.4pt, framesep=1.5mm,
  gobble=2,
  xleftmargin=15pt}

Cet environnement est donc de type verbatim mais dans lequel on peut « exécuter » des commandes LaTeX à l'aide des caractères ¢ de catégorie 0, « de catégorie 1 et » de catégorie 2 — on peut bien évidemment choisir n'importe quel caractère pour ce faire. Il faut cependant garder à l'esprit que ceux-ci doivent être à la fois lisibles pour l'utilisateur et peu utilisés à d'autres fins que de repasser le contrôle à LaTeX.

10.5 Sélectionnez 1. 2. 3. 4. Pour afficher le contenu d'une variable : \begin{unixcom} echo ${ ${¢marg«nom variable»} \end{unixcom}

La commande \margArguments et convention typographique permet de produire son argument entre chevrons simples et en penché. Les autres paramètres de \DefineVerbatimEnvironment ont pour but de préciser l'allure de la bordure (paramètres frame...), la marge de gauche (paramètre xleftmargin) et le fait que les premiers caractères de chaque ligne seront systématiquement ignorés (gobble). Comme le montre la documentation du package fancyvrb beaucoup d'autres options sont disponibles.

Un autre environnement de ce genre a été créé pour saisir les commandes d'Emacs dans l'annexe consacrée à AucTeX. L'environnement en question (baptisé emacscom) a été créé comme suit :

\DefineVerbatimEnvironment{emacscom}{Verbatim}{%
  commandchars=¢«»,
  frame=leftline, framerule=1mm, framesep=2mm,
  gobble=2, xleftmargin=15pt}

qui donne par exemple :

10.6 Sélectionnez 1. 2. 3. 4. Pour jouer à Tetris dans \soft{Emacs} : \begin{emacscom} M-x tetris \end{emacscom}

Le package listings reconnaît la syntaxe d'un grand nombre de langage de programmation. Une manière simple d'utiliser ce package consiste à créer son propre environnement à l'aide d'une commande analogue à \newenvironment :

\lstnewenvironment{C}{\lstset{language=C}}{}

On pourra alors simplement écrire :

10.7 Sélectionnez 1. 2. 3. 4. 5. 6. 7. 8. \begin{C} /* hello world en C */ int main() { printf("bonjour monde\n"); return 0; } \end{C}

Bien évidemment une foultitude d'options de configuration permet d'adapter cet environement à vos besoins. Le plus simple et le plus efficace est sans doute de lire la documenation accompagnant le package. À titre d'exemple, il faut savoir que l'on peut changer la mise en évidence des mots réservés et des commentaires du langage considéré. Ainsi, en écrivant :

\lstnewenvironment{Cbis}{%
  \lstset{language=C,
    basicstyle=\rmfamily\slshape,
    commentstyle=\rmfamily\upshape,}}{}

On aura :

10.8 Sélectionnez 1. 2. 3. 4. 5. 6. 7. 8. \begin{Cbis} /* hello world en C */ int main() { printf("Salut...\n"); return 0; } \end{Cbis}

Et puisqu'il est question des caractères spéciaux et de l'« échappement vers LaTeX », il faut savoir qu'à l'instar de fancyvrb, le package listings permet de spécifier un caractère permettant cet échappement. Ainsi :

\lstnewenvironment{Cter}{\lstset{language=C, escapechar=@}}{}

Permet d'insérer des commandes LaTeX dans le listing :

10.9 Sélectionnez 1. 2. 3. 4. 5. 6. 7. \begin{Cter} int main() { printf("bonjour monde\n"); return @\fbox{code de retour}@; } \end{Cter}

Plusieurs solutions sont possibles pour créer une telle commande. En s'inspirant de l'interface des boîtes de LaTeX, on peut créer une macro dont la syntaxe d'utilisation serait :

10.11 Sélectionnez 1. 2. \titlebox{\footnotesize Un titre}{% Le contenu de la boîte}

ou encore :

10.12 Sélectionnez 1. 2. 3. 4. 5. 6. \setlength{\fboxsep}{5pt} \setlength{\fboxrule}{2pt} \titlebox{Un autre titre}{% \begin{minipage}{3cm}\begin{center} truc\\ muche \end{center}\end{minipage}}

La primitive de TeX \leaders permet de remplir un espace élastique avec ce qui vous passe par la tête. Sa syntaxe :

• \leadersce qui vous chanteespace

permet donc de remplir l'espace avec ce qui vous chante. Par exemple :

10.13 Sélectionnez 1. 2. \framebox[3cm]{% \leaders\hbox{o}\hfill}

La primitive \hbox de TeX (utilisée par \mbox et \makebox) permet de créer des boîtes horizontales :

10.14 Sélectionnez 1. 2. \framebox[3cm]{% \leaders\hbox to 3pt{o}\hfill}

Les \leaders peuvent également être utilisés avec la primitive \hrule de TeX permettant de dessiner des traits :

10.15 Sélectionnez 1. 2. \framebox[3cm]{% \leaders\hrule height 4pt\hfill}

Ici, le ressort \hfill s'étire les trois centimètres de la \framebox et est rempli par un trait de hauteur quatre points.

10.16 Sélectionnez 1. 2. 3. 4. \framebox[3cm]{% \leaders\hbox to5pt{% \leaders\hrule width1pt\hfill% \kern2pt}\hfill}

Dans l'exemple ci-dessus, l'espace de trois centimètres est rempli par des boites de cinq points de large, contenant chacunes d'elles des \leaders comme dans l'exemple précédent, et un blanc de deux points de large. Avec TeX, on peut régler la raideurLongueurs élastiques du ressort de la manière suivante :

10.17 Sélectionnez 1. 2. \framebox[5cm]{% \hskip0pt plus 2fill X\hskip0pt plus 3fill}

La dimension :

• \hskip 0pt plus nfill

permet de définir une longueur élastique de raideur relative n. Dans l'exemple précédent la lettre 'X' se trouve donc au 2/5 de la boîte... En utilisant ce type de blanc élastique et des \leaders, on peut définir la commande suivante :

\newcommand{\traitressort}[2][1]{%
  \leaders\hrule height#2\hskip0pt plus #1fill\relax}

pouvant être par exemple utilisée comme suit :

10.18 Sélectionnez 1. 2. \framebox[5cm]{% \traitressort[2]{2ex}X\traitressort{2pt}}

on a donc dans la boîte de cinq centimètres :

• un blanc élastique de raideur 2, rempli d'un trait de quatre points de hauteur ;
• la lettre X ;
• un blanc élastique de raideur 1, rempli d'un trait de deux points de hauteur.

Nous allons bien entendu nous servir de cette commande pour la suite...

Pour concevoir la boîte à proprement parler, nous allons créer trois \parbox comme suit :

Il y a :

• deux \parboxs pour contenir les deux traits verticaux à droite et à gauche ;
• une \parbox pour le centre, contenant le trait du haut interrompu par le titre, le contenu, et en bas un trait horizontal.

Nous allons voir maintenant comment on peut construire ces trois boîtes et les positionner correctement les unes par rapport aux autres.

Nous allons avoir besoin d'une boîte pour stocker la \parbox centrale :

\newsavebox{\boitetitre}

et de deux dimensions :

\newlength{\largeurboitetitre}
\newlength{\hauteurboitetitre}

qui portent un nom suffisamment explicite m'évitant ainsi des phrases alambiquées expliquant la signification de telle ou telle variable. La première tâche que l'on va demander à la commande \titlebox est de stocker son contenu et de le mesurer :

\newcommand{\titlebox}[2]{%
  \begin{lrbox}{\boitetitre}% stockage du contenu
    \kern\fboxsep#2\kern\fboxsep
  \end{lrbox}
  % mesure de la largeur de la parbox centrale
  \settowidth{\largeurboitetitre}{\usebox{\boitetitre}}%
  % mesure de la hauteur de la parbox centrale
  \settoheight{\hauteurboitetitre}{\usebox{\boitetitre}}%
  \settodepth{\tempdim}{\usebox{\boitetitre}}%
  \addtolength{\hauteurboitetitre}{\tempdim+2\fboxrule+2\fboxsep}%
  ... }

\kern est une commande TeX permettant d'insérer un blanc insécable, ici de largeur \fboxsep. Notez que pour mesurer la hauteur totale on a recours à une longueur temporaire qui nous permet de faire la somme de la hauteur (height) et la profondeur (depth). On ajoute ensuite à cette hauteur totale deux fois l'épaisseur du trait et deux fois l'espace \fboxsep. Vous vous souvenez sans doute que les dimensions \fboxrule et \fboxsep définissent respectivement l'épaisseur du trait et l'espace entre la bordure et le contenu d'une boîte simpleBoîtes simples. Par conséquent, on a :

• \largeurboitetitre correspond à la largeur de la \parbox centrale augmentée de deux fois \fboxsep ;
• \hauteurboitetitre correspond à la hauteur totale augmentée de l'espace occupée par les deux traits horizontaux : 2(\fboxsep+\fboxrule).

On peut donc construire une première version de la commande :

\newcommand{\titleboxI}[2]{%
  ...
  \parbox{\fboxrule}{% le trait de gauche
    \rule{\fboxrule}{\hauteurboitetitre}}%
  \parbox{\largeurboitetitre}{% la boîte centrale
    \begin{flushleft}
      \usebox{\boitetitre}
    \end{flushleft}}%
  \parbox{\fboxrule}{% le trait de droite
    \rule{\fboxrule}{\hauteurboitetitre}}}}

Ce qui donnera pour l'instant :

10.19 Sélectionnez 1. 2. 3. 4. \titleboxI{titre}{Bidule truc muche} \titleboxI{encore}{% \parbox{4cm}{truc\\bidule\\machin}}

Il reste donc à modifier le contenu de la \parbox centrale pour ajouter les deux traits horizontaux, celui du bas, et celui du haut coupé par le titre. L'idée est d'entasser trois boîtes :

1. une boîte contenant le titre et des « traits ressorts » ;
2. la boîte stockant le contenu (\boitetitre) ;
3. un trait de largeur \largeurboitetitre.

Voici une première approche :

\newcommand{\titleboxII}[2]{%
  ...
  \parbox{\largeurboitetitre}{% la boîte centrale
    \begin{flushleft}
      \makebox[\largeurboitetitre]{%
        \traitressort{\fboxrule}#1\traitressort[5]{\fboxrule}}\\
      \usebox{\boitetitre}\\
      \rule{\largeurboitetitre}{\fboxrule}
    \end{flushleft}}
  ...}

qui donnera :

10.20 Sélectionnez 1. 2. 3. 4. \titleboxII{titre}{Bidule truc muche} \titleboxII{encore}{% \parbox{4cm}{truc\\bidule\\machin}}

On dirait que c'est pas « tout à fait ça ». Il faudrait penser à faire en sorte que la commande \\ effectue un saut vertical équivalent à la dimension \fboxsep. On en profite au passage pour faire subir au titre une translation verticale vers le bas :

\newcommand{\titleboxIII}[2]{%
  ...
  \parbox{\largeurboitetitre}{% la boîte centrale
    \begin{flushleft}
      \makebox[\largeurboitetitre]{%
        \traitressort{\fboxrule}%
        \raisebox{-.5ex}[0pt][0pt]{#1}%
        \traitressort[5]{\fboxrule}}\\[\fboxsep]
      \usebox{\boitetitre}\\[\fboxsep]
      \rule{\largeurboitetitre}{\fboxrule}
    \end{flushleft}}
  ...}

ce qui donnera :

10.21 Sélectionnez 1. 2. 3. 4. \titleboxIII{titre}{Bidule truc muche} \titleboxIII{encore}{% \parbox{4cm}{truc\\bidule\\machin}}

On dirait que ça n'a pas arrangé grand chose... Il faut savoir que lorsque TeX entasse des boîtes en mode vertical, il insère de lui même des espaces entres ces boîtes de manière à ce que les lignes soit espacées de la longueur \baselineskip. On trouve dans le TeXbook, à la page 79 du chapitre traitant des glues :

« Exception : no interline glue is inserted before or after a rule box. You can also inhibit interline glue by saying \nointerlineskip between two boxes. »

L'ordre \nointerlineskip résout donc le problème :

\newcommand{\titleboxIV}[2]{%
 ...
  \parbox{\largeurboitetitre}{% la boîte centrale
    \begin{flushleft}
      \makebox[\largeurboitetitre]{%
        \traitressort{\fboxrule}%
        \raisebox{-.5ex}[0pt][0pt]{#1}%
        \traitressort[5]{\fboxrule}}\\[\fboxsep]\nointerlineskip
      \usebox{\boitetitre}\\[\fboxsep]\nointerlineskip
      \rule{\largeurboitetitre}{\fboxrule}
    \end{flushleft}}
  ...}

ce qui donnera :

10.22 Sélectionnez 1. 2. 3. 4. \titleboxIV{titre}{Bidule truc muche} \titleboxIV{encore}{% \parbox{4cm}{truc\\bidule\\machin}}

Ce qui répond au cahier des charges.

D'autres améliorations — laissées en guise d'exercice — peuvent être apportées à cette commande. On pourra par exemple définir un argument optionnel permettant de régler l'abaissement du titre (on a mis ici -.5ex en dur). Il est également possible de régler le rapport des traits entourant le titre. Enfin, il est tout à fait envisageable de régler l'espace autour du titre (ici il n'y en a pas).

L'utilisation de la commande \titlebox précédemment définie, dans le package minitoc se fait simplement en revêtant le chapeau de monsieur Poirot. En inspectant à la loupe le fichier de style, on trouve la définition d'une commande nommée \minitoc@. J'ai simplement recopié le code de cette macro et inséré un appel à la merveilleuse commande \titlebox.

Dans un document parlant de langage informatique, il est important de faire ressortir clairement les arguments de commande ou de fonction. Par exemple on écrira :

11.1 Sélectionnez 1. 2. 3. 4. Pour compiler le fichier \bwarg{fichier} : \begin{flushleft} \ttfamily latex \bwarg{fichier} \end{flushleft}

La commande \bwmarg écrit son argument en fonte penchée, entre les symboles kitxmlcodeinlinelatexdvp\langlefinkitxmlcodeinlinelatexdvp et kitxmlcodeinlinelatexdvp\ranglefinkitxmlcodeinlinelatexdvp produits respectivement par les commandes \langle et \rangle en mode mathématique. De plus vous aurez sans doute remarqué qu'on peut utiliser une notation indicée comme dans l'exemple ci-dessous :

11.2 Sélectionnez 1. 2. 3. 4. 5. Pour copier des fichiers : \begin{flushleft}\ttfamily cp \bwarg[1]{fichier} ... \bwarg[n]{fichier} \bwarg[dst]{fichier} \end{flushleft}

La commande \bwarg(83) est définie comme suit :

\newcommand{\marg}[2][]{%
  {\normalfont%
    \textsl{$\langle$#2%
      \ifthenelse{\equal{#1}{}}{}% si l'argument optionnel est présent
      {$_\mathit{#1}$}% on l'affiche en indice
      $\rangle$}}}%

La commande \normalfont permet de revenir à la fonte par défaut dans le document. Ce qui explique que « ⟨fichier⟩ » n'apparaît pas en fonte machine à écrire dans l'exemple 11.1.

Dans la version électronique du document — version lue sur un écran — il a été décidé, pour la mise en évidence, d'utiliser la couleur plutôt que les caractères h et i. Ainsi on peut définir la commande \colarg :

\newcommand{\colarg}[2][]{{%
  \normalfont\color{blue!90}#2% un bleu
  \ifthenelse{\equal{#1}{}}{}{$_\mathit{#1}$}}}

On pourra ensuite grâce à un booléenBooléens et opérateurs associés habilement positionné, définir une commandegénérique \marg faisant appel à l'une ou l'autre des versions (noir & blanc ou couleur) :

\ifversionenligne
  \let\marg\colarg
\else
  \let\marg\bwarg
\fi

Cette construction fait appel à la commande \let de TeX présentée de manière lumineuse à la section 9.2.3Le \let de TeX.

Lorsque dans le texte du présent manuel, il est question d'une commande, d'un environnement, d'un package, d'une classe de document, etc. il est fait appel à une commande particulière insérant automatiquement une entrée dans l'index. Ainsi par exemple :

11.3 Sélectionnez 1. 2. Le package \ltxpack{varioref} permet d'utiliser la commande \ltxcom{vref}...

La commande \ltxpack est définie comme suit. Tout d'abord :

\newcommand{\ltx@pack}[1]{%
  \upshape\textsf{#1}}

définissant la commande \ltx@pack permettant simplement de produire le nom du package en sans sérif. On définit ensuite :

\newcommand{\ltxpack}[1]{%
  \ltx@pack{#1}%
  \protect\index{extensions!\protect\texttt{#1}}%
  \protect\index{#1@\protect\textsf{#1 extension}}}

qui appelle la commande précédente, et qui insère deux entrées dans l'index. Une de la forme « nom du package extension » et l'autre comme sous-entréeIndex de « extensions ». La commande \protect permet ici d'éviter les ennuis si la commande \ltxpack est elle-même en argument d'une autre commande. Dans un même ordre d'idée, la commande \ltxcom est définie tout d'abord par :

\newcommand{\ltx@com}[1]{%
  \texttt{\symbol{92}#1}}

permettant de produire en fonte machine à écrire, le nom de la commande précédé du caractère \. La commande \symbol est une commande LaTeX permettant d'insérer ici le 92^e caractère de la fonte sélectionnée (en l'occurrence le backslash). On peut alors définir la commande finale :

\newcommand{\ltxcom}[1]{%
  \ltx@com{#1}%
  \index{#1@\protect\texttt{\symbol{92}#1}}}

qui appelle la commande précédente et introduit une entrée dans l'index. L'idée à retenir, c'est qu'il est peut être utile de définir des commandes pour insérer automatiquement des entrées dans l'index. On pourrait par exemple définir une commande :

\newcommand{\jargonanglais}[1]{%
  \emph{#1}%
  \index{#1}}

permettant à la fois de formater les mots du jargon en anglais, et de les insérer dans l'index, voire dans un index spécial. De même si un mot revient souvent dans un document on peut définir une commande pour le produire et l'insérer dans l'index. Par exemple dans ce manuel, on a défini :

\newcommand{\postscript}{%
  PostScript%
  \protect\index{PostScript}}

La version « papier » de ce document est parsemée de renvois comme celui-ci parlant de glossaire (▶ §D.3.5Nettoyage de printemps) qui n'a strictement rien à voir avec le propos du moment(84) si ce n'est qu'il s'agit d'un renvoi. La commande mise en œuvre pour les renvois a été baptisée \voir et attend deux arguments :

• \voir{label cible}{texte objet du renvoi}

Par exemple, le renvoi précédent a été produit par :

\voir{chap-glossaire}{glossaire}

Toute la « difficulté » de la conception de cette commande réside dans l'orientation des triangles qui dépend de la parité de la page. Cette difficulté peut être levée grâce à l'utilisation du package chngpage comme expliqué au paragraphe 9.3.3Tester la parité des pages.

Le reste concerne la mise en page des triangles. Pour cela deux commandes ont été définies, produisant chacunes les renvois dans la marge et les marques dans le texte. D'où la forme de la commande \voir :

\newcommand{\voir}[3][\S]{%
  \checkoddpage%
  \ifcpoddpage%
    \v@irpageimpaire{#1}{#2}{#3}% renvoi sur page impaire
  \else%
    \v@irpagepaire{#1}{#2}{#3}% renvoi sur page paire
  \fi}

On notera qu'outre les deux arguments obligatoires, la commande accepte un argument optionnel défini par défaut comme étant le caractère de paragraphe (§). Les deux commandes \v@irpageimpaire et \v@irpagepaire sont symétriques l'une de l'autre et ont pour objet :

1. de placer un triangle du « bon côté » du texte faisant l'objet du renvoi
2. de produire une note marginale avec la cible du renvoi.

Les triangles sont obtenus à l'aide de symboles contenus dans le package amssymb :

10.4 Sélectionnez 1. 2. 3. Oh les \og joulis\fg{} triangles : $\blacktriangleleft$ et $\blacktriangleright$ !

Voici finalement la commande permettant de faire un renvoi dans le cas d'une page paire :

\newcommand{\v@irpageimpaire}[3]{%
  {\tiny$\blacktriangleright$}#3% le renvoi dans le texte
  \marginpar{%
    \parbox[t]{.9\marginparwidth}{%
      {\footnotesize\sffamily%
        \hfill#1~\ref{#2}}~{\small$\blacktriangleleft$}\\
      {\footnotesize\sffamily%
        \mbox{}\hfill p.~\pageref{#2}\hfill\mbox{}}}}

On notera donc que la partie du renvoi qui réside dans la marge a été inclue dans une \parboxBoîtes paragraphe dans laquelle le numéro du paragraphe et le numéro de la page sont produits sur deux lignes. Pour la page impaire il faut faire la même chose que pour la page paire, mais en tenant compte que c'est une page impaire :-)
Dans la version « en ligne » les renvois apparaissent comme un lien hypertexte. Ceci est facilement réalisable grâce à la commande \hyperref du package éponyme. On aura donc quelque chose du genre :

\newcommand{\voir}[3][\S]{%
  \hyperref[#2]{#3}}

L'argument optionnel ne sert ici à rien d'autre qu'à assurer la compatibilité avec la version « papier » de la commande \voir.

À plusieurs reprises dans ce document, j'ai eu recours à des changements de marges provisoires. C'est le cas notamment des exemples de code LaTeX avec le résultat en face, ou pour les épigraphes. Pour ce faire, Marie-Paul Kluth(85) qui maintient la Faq française de LaTeX avait suggéré un environnement ressemblant à celui-ci :

\newenvironment{changemargin}[2] %
{\begin{list}{}{%
  \setlength{\listparindent}{\parindent}%
  \setlength{\itemindent}{\parindent}%
  \setlength{\leftmargin}{#1}%
  \setlength{\rightmargin}{#2}%
}\item }%
{\end{list}}

L'idée est donc de définir une liste dont on change les marges. Les deux arguments qu'attend cet environnement correspondent respectivement aux dimensions des marges gauche et droite. Une idée intéressante serait celle d'un environnement dans lequel les marges ont des dimensions différentes selon la parité de la page. Un tel environnement peut être défini comme suit :

\newenvironment{agrandirmarges}[2]{%
\begin{list}{}{%
  \setlength{\topsep}{0pt}%
  \setlength{\listparindent}{\parindent}%
  \setlength{\itemindent}{\parindent}%
  \setlength{\parsep}{0pt plus 1pt}%
  \checkoddpage%
  \ifcpoddpage
    \setlength{\leftmargin}{-#1}\setlength{\rightmargin}{-#2}
  \else
    \setlength{\leftmargin}{-#2}\setlength{\rightmargin}{-#1}
  \fi}\item }%
{\end{list}}

Notez qu'on utilise ici la commande \isodd pour tester la parité de la page.

La figure 11.1 montre un exemple d'utilisation de cet environnement avec le code suivant :

\begin{figure}[tb]
  \begin{agrandirmarges}{1cm}{2cm}
    % ici on a 1cm de plus côté « reliure »
    % et 2cm de plus côté « bord »
    ...
    \caption{Une figure qui ne sert à rien...}
  \end{agrandirmarges}
\end{figure}

Les épigraphes provocatrices de ce manuel ont été produites par un environnement que j'ai nommé epigraphe. Par exemple au début du code LaTeX du chapitre 2Ce qu'il faut savoir, on trouve :

\chapter{Ce qu'il faut savoir}
\label{chap-savoir}
\begin{epigraphe}{Les proverbes Pr \textbf{21} 11}
  Quand on châtie le railleur, le simple s'assagit ;\\
  quand on instruit le sage, celui-ci gagne en savoir.
\end{epigraphe}

L'environnement epigraphe est défini comme suit :

\newenvironment{epigraphe}[1]
{% clause begin
  \vspace*{-1.5cm}%
  \small\sffamily% mise en évidence
  \savebox{\nomepigraphe}{#1}% une boîte pour sauvegarder
                          % l'origine de la citation
  \slshape% tout est penché
  \begin{changemargin}{0pt}{-2cm}% on se met au large
    \begin{flushright}}% tout est poussé à droite
    {% clause end
      \\[4pt]\usebox{\nomepigraphe}. % insertion de l'origine
    \end{flushright}%
  \end{changemargin}\par\vspace*{0.6cm}}

Il faut bien entendu déclarer la boîteSauvegarde et réutilisation qu'on utilise pour sauvegarder l'origine de notre citation :

\newsavebox{\nomepigraphe}

Les blancs verticaux (\vspace de caler correctement l'épigraphe entre le début du chapitre et la minitable des matières.

Quelques citations parsèment le manuel que vous avez sous les yeux. Elles ont été pro duites avec un environnement fait maison :

11.12 Sélectionnez 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. xxxxxxxxxxxxx \begin{unecitation}[Georges \textsc{Bataille}] La vieillesse renouvelle la terreur à l'infini. Elle ramène l'être sans finir au commencement. Le commencement qu'au bord de la tombe j'entrevois est le \emph{porc} qu'en moi la mort ni l'insulte ne peuvent tuer. La terreur au bord de la tombe est divine et je m'enfonce dans la terreur dont je suis l'enfant. \end{unecitation} xxxxxxxxxxxxxxx

Nous allons créer pas à pas cet environnement de manière à mettre le doigt sur quelques problèmes classiques auxquels on peut être confronté avec monsieur LaTeX. On va définir l'environnement citation en s'appuyant sur celui du paragraphe 9.6Des environnements qui mettent en boîte (permettant de faire une remarque encadrée) et sur celui du §4.5.2Environnement qui produit une citation avec son auteur :

% un boite pour l'auteur de la citation
\newsavebox{\auteurcitation}
\newsavebox{\boitecitation}
\newenvironment{citationi}[1]{% clause begin
  % on sauve l'argument 1 pour l'auteur
  \savebox{\auteurcitation}{#1}%
  \begin{lrbox}{\boitecitation}
    \begin{minipage}{.8\linewidth}
      \small\slshape}% on passe en petit et penché
  {% clause end : on pousse l'auteur de la citation à droite
    \par\mbox{}\hfill\usebox{\auteurcitation}
    \end{minipage}
    \end{lrbox}
  \begin{center}
    \usebox{\boitecitation}
  \end{center}}

Ce qui donne :

11.13 Sélectionnez 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. Avant avant avant avant avant avant avant avant avant avant avant avant avant avant \begin{citationi}{% Michel \textsc{Bakounine}, 1845} Dans presque tous les pays les femmes sont esclaves ; tant qu'elles ne seront pas complètement émancipées, notre propre liberté sera impossible. \end{citationi} Après après après après après après après après après après après après après après

On peut également changer l'indentation du paragraphe dans la minipage (qui vaut par défaut 0pt dans cet environnement) en modifiant dans l'environnement la valeur de la longueur \parindent :

...
\begin{lrbox}{\boitecitation}
  \begin{minipage}{.8\linewidth}%
    \setlength{\parindent}{10pt}%     ← pour indenter la 1re ligne
...

On insère ensuite des guillemets en début et fin de citation, avec le code suivant :

...
\begin{minipage}{.8\linewidth}%
  \setlength{\parindent}{10pt}%
  \small\slshape« \ignorspaces}% on passe en petit et penché
{\unskip »
  \par\mbox{}\hfill\usebox{\auteurcitation}
...

On se réfèrera aux paragraphes 9.2.1.1La commande \ignorespaces et 9.2.1.2La commande \unskip pour la signification des commandes \ignorespaces et \unskip. Ce qui donne :

11.14 Sélectionnez 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. Avant avant avant avant avant avant avant avant avant avant avant avant avant avant \begin{citationiii}{% Michel \textsc{Bakounine}, 1845} Dans presque tous les pays les femmes sont esclaves ; tant qu'elles ne seront pas complètement émancipées, notre propre liberté sera impossible. \end{citationiii} Après après après après après après après après après après après après après après

Ensuite — on y est presque — on se propose de rendre l'argument « auteur de la citation » optionnel de manière à pouvoir produire une citation sans auteur si besoin est. L'idée est de déclarer un booléen de manière à mémoriser le fait qu'un auteur est présent ou pas :

\newboolean{auteurcitationpresent}

On modifie ensuite la définition de l'environnement comme suit :

\newenvironment{unecitation}[1][] {% argument optionnel vide par défaut
  % Clause begin :
  % on note si on a un auteur pour la citation ou pas
  \ifthenelse{\equal{#1}{}}{%
    \setboolean{auteurcitationpresent}{false}}{%
    \setboolean{auteurcitationpresent}{true}%
    \savebox{\auteurcitation}{#1}}% on le sauve si nécessaire
...

Puis on modifie la clause \end de l'environnement en insérant l'auteur uniquement s'il est présent en argument :

{ »% clause end de l'environnement
  % s'il y a un auteur on le met poussé tout à droite
  \ifthenelse{\boolean{auteurcitation}}%
  {\par\nopagebreak\hfill\usebox{\auteurcitation}}
  {}% sinon on ne fait rien ...

Enfin, on met la citation sur un fond. On peut par exemple déclarer cette couleur grâce au package xcolor :

\definecolor{coulcitation}{rgb}{0.60,0.70,0.90}%

Il suffit alors de remplacer la commande \usebox de la clause end par quelque chose du genre :

\setlength{\fboxsep}{10pt}%
\colorbox{coulcitation}{\usebox{\boitecitation}}

Ce qui donnera finalement :

11.15 Sélectionnez 1. 2. 3. 4. 5. 6. avant avant avant avant avant avant avant \begin{citationiv}[Pierre \textsc{Desproges}] Il était tellement obsédé qu'à la fin il sautait même des repas. \end{citationiv} Après après après après après après après

Au niveau de LaTeX c'est la commande \newcommand qui permet de créer de nouvelles commandes. Une des limitations de LaTeX pour ce qui concerne la création de commandes réside dans le fait que les délimiteurs d'arguments sont toujours les caractères { et }. Comme nous le verrons un peu plus bas, au niveau de TeX, cette contrainte n'existe pas. En effet, pour créer une commande avec TeX, on peut écrire :

11.17 Sélectionnez 1. 2. \def\bidule{machin truc} \bidule{} et \bidule

Avec un ou plusieurs arguments, on écrira

11.18 Sélectionnez 1. 2. 3. \def\bidule#1#2{(1=#1) et (2=#2)} \bidule{ab}{cd}

On note qu'en TeX, on écrit dans la définition les arguments dans l'ordre. Ce qui est intéressant et que l'on va exploiter pour notre lettrine, peut être illustré par les exemples suivants d'utilisation de la commande \bidule :

11.19 Sélectionnez 1. 2. 3. 4. 5. \def\bidule#1#2{(1=#1) et (2=#2)} \bidule abcd \bidule ab cd

On remarque donc que si on ne délimite pas explicitement les arguments avec les caractères { et }, le premier argument (#1) est remplacé par le premier caractère rencontré, le deuxième argument (#2) par le deuxième caractère, etc. Encore plus intéressant, on peut définir très souplement le format d'appel de la commande, par exemple :

\def\bidule#1#2/{(1=#1) et (2=#2)}

Ici, on indique que pour appeler la commande \bidule il faut lui faire suivre deux arguments suivis du caractère /.

11.20 Sélectionnez 1. 2. 3. \bidule abc/d \bidule ab/cd

Par conséquent cette dernière commande prendra comme premier argument, le premier caractère rencontré, et comme deuxième : tout ce qu'elle trouve jusqu'au caractère /. On peut donc créer une ébauche de commande pour une lettrine :

11.21 Sélectionnez 1. 2. 3. \def\glurps#1#2/{{\Huge#1}\textsc{#2}} \newcommand{\lettrinedev}[1]{\glurps#1/} \lettrinedev{Bon bé} ouala le travail

On va même pousser le vice jusqu'à mettre la grosse lettre un peu plus bas :

11.22 Sélectionnez 1. 2. 3. 4. 5. \def\glurps#1#2/{% {\Huge#1}% \raisebox{\baselineskip}{\textsc{#2}}} \newcommand{\lettrinedev}[1]{\glurps#1/} \lettrinedev{Bon bé} ouala le travail

Pour insérer la lettrine dans un paragraphe on aura recours à la commande \parshape. La figure 11.3 montre que l'on doit définir deux dimensions pour insérer la lettrine :

1. l'indentation de la première ligne, correspondant à la largeur de la « grosse lettre » plus celle de la suite de la lettrine ;
2. l'indentation de la deuxième ligne, correspondant à la largeur de la « grosse lettre » éventuellement augmentée d'une espace pour aérer un peu.

On définit les dimensions suivantes :

• \indletH et \larligH respectivement l'indentation et la largeur de la première ligne (la ligne « du Haut ») du paragraphe contenant une lettrine ;
• \indletB et \larligB la même chose pour la deuxième ligne (la ligne « du Bas »)

Ceci permet d'écrire quelque chose du genre :

11.23 Sélectionnez 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. \setlength{\indletB}{.8cm}% au pif \setlength{\larligB}{\textwidth-\indletB} \setlength{\indletH}{1.5cm}% au pif \setlength{\larligH}{\textwidth-\indletH} \parshape=3 \indletH\larligH \indletB\larligB 0pt\textwidth \noindent Ce paragraphe est prêt à recevoir une jolie lettrine qui occupera deux lignes environ voire même exactement...

L'emplacement est prêt, il reste à insérer la « grosse lettre » et ce qui suit à la bonne place. On commence par créer une commande pour la fonte à utiliser :

11.24 Sélectionnez 1. 2. 3. \DeclareFixedFont{% \lettrinefont}{T1}{ppl}{m}{n}{2\baselineskip} {\lettrinefont Pour écrire les grosses lettres}

Ensuite on va modifier la commande \glurps(87) et la commande \lettrine pour qu'elles calculent elles-mêmes les dimensions définies ci-avant (\indletH, \larligH, ...).

\newsavebox{\lalettrine}% une boîte pour la lettrine
\def\creerlettrine#1#2/{%
  \savebox{\lalettrine}{%
    {\lettrinefont#1}\raisebox{\baselineskip}{\textsc{#2}}}%
  \settowidth{\indletB}{{\lettrinefont#1}}%
  \settowidth{\indletH}{\usebox{\lalettrine}}}

La commande \creerlettrine (digne héritière de \glurps) sauve la lettrine dans une boîte et en profite pour sauvegarder la largeur de la « grosse lettre » dans la dimension \indletB, et la dimension de l'ensemble dans \indletH. Tentons maintenant, une première version de la lettrine :

\newcommand{\lettrineI}[1]{%
  \creerlettrine#1/%
  \setlength{\larligH}{\textwidth-\indletH}%
  \setlength{\larligB}{\textwidth-\indletB}%
  \parshape=3\indletH\larligH\indletB\larligB%
  0cm\textwidth%
  \noindent\usebox{\lalettrine}}

Qui donne(88) :

11.25 Sélectionnez 1. 2. 3. 4. \lettrineI{Ce chapitre} a pour but de produire des caractères les uns derrière les autres et ainsi de former des mots donnant lieu à des phrases.

Les lecteurs très attentifs auront noté que ce nota n'est pas à la bonne place. Il semblerait que des translations horizontales et verticales soient nécessaires. On commencera ici par se décaler vers la gauche. À la dernière ligne de la définition de la commande \lettrine, on écrira donc :

\noindent\hspace{-\indletH} % décalage équivalent à la largeur totale

qui produira :

11.26 Sélectionnez 1. 2. 3. 4. \lettrineII{Ce chapitre} a pour but de produire des caractères les uns derrière les autres et ainsi de former des mots donnant lieu à des phrases.

Puis on intègre la translation verticale :

\noindent\hspace{-\indletH}%
\raisebox{-\baselineskip}[0pt][0pt]{\usebox{\lalettrine}}

qui produira :

11.27 Sélectionnez 1. 2. 3. 4. \lettrineIII{Ce chapitre} a pour but de produire des caractères les uns derrière les autres et ainsi de former des mots donnant lieu à des phrases.

Les lecteurs encore éveillés auront remarqué que la « grosse lettre » est un peu trop rapprochée du texte. On peut donc augmenter légèrement la dimension \indletB. Voici finalement le code de la lettrine :

\newcommand{\lettrine}[1]{%
  \creerlettrine#1/%
  \addtolength{\indletB}{3pt}% pour avoir un peu d'espace
  \setlength{\larligH}{\textwidth-\indletH}%
  \setlength{\larligB}{\textwidth-\indletB}%
  \parshape=3%
  \indletH\larligH\indletB\larligB0cm\textwidth%
  \noindent\hspace{-\indletH}%
  \raisebox{-\baselineskip}[0pt][0pt]{\usebox{\lalettrine}}}

De même que pour la création d'un index, on doit mettre dans le préambule du document la commande \makeglossary. Cette commande demande à monsieur LaTeX de bien vouloir créer un fichier portant l'extension glo, réceptacle des entrées de glossaire. On pourra écrire :

\glossary{machin chouette chose}

pour ajouter « machin chouette chose » dans le glossaire. En réalité cette commande a pour effet d'ajouter dans le fichier d'extension glo, la ligne :

• \glossaryentry{machin chouette chose}{n° page}

La phase suivante consiste à produire le glossaire proprement dit grâce au programme makeindex et au fichier d'entrées de glossaire :

• makeindex -s style glossaire document.glo -o document.glx

qui produit, en utilisant comme fichier de style gglo.ist le glossaire suivant :

\begin{theglossary}
\item machin chouette chose\pfill 27
\end{theglossary}

On note donc que le glossaire — qu'il va falloir insérer explicitement dans notre document — est constitué par l'environnement theglossary et que chaque entrée donne lieu à un \item et son numéro de page (ici 27 pour l'exemple). Pour arriver à nos fins, il nous faudra :

1. définir l'environnement theglossary car rien n'est fait par défaut dans LaTeX ;

2. produire les entrées avec un terme suivi de sa définition, sous la forme :

    

   Sélectionnez

   1.
   2.
   3.
   

   \begin{theglossary}
   \item[terme] blabla de définition
   \end{theglossary}
   

3. supprimer les numéros de pages puisqu'ils n'apparaissent pas dans un glossaire.

Ces trois tâches font l'objet des paragraphes suivants.

Au paragraphe 9.5.6Un exemple un peu plus tordu... du chapitre 9Outillage nécessaire, nous avons proposé une liste particulière permettant de présenter les entrées dans une boîte avec une ombre. La définition était la suivante :

\newenvironment{leglossaire}{\begin{list}{}{%
    \setlength{\labelwidth}{.5\textwidth}%
    \setlength{\labelsep}{-.8\labelwidth}%
    \setlength{\itemindent}{\parindent}%
    \setlength{\leftmargin}{25pt}%
    \setlength{\rightmargin}{0pt}%
    \setlength{\itemsep}{.8\baselineskip}%
    \renewcommand{\makelabel}[1]{\boiteentreeglossaire{##1}}}}
  {\end{list}}

où \boiteentreeglossaire est :

\newcommand{\boiteentreeglossaire}[1]{%
  \parbox[b]{\labelwidth}{%
    \setlength{\fboxsep}{3pt}%
    \setlength{\fboxrule}{.4pt}%
    \shadowbox{\sffamily#1}\\\hfill\mbox{}}}

On se reportera au paragraphe mentionné ci-dessus pour les explications de ces commandes. En tous les cas on aura :

11.28 Sélectionnez 1. 2. 3. \begin{leglossaire} \item[Sphère] Patate bien régulière. \end{leglossaire}

De manière à ce que makeindex produise le fichier d'extension glx avec cet environnement on doit écrire le fichier de style suivant :

preamble "\n\\begin{leglossaire}"
postamble "\n\\end{leglossaire}"

Doit également apparaître dans ce fichier de style — que l'on nommera par exemple glossaire.ist — le mot clef désignant les entrées de glossaire dans le fichier .glo :

keyword "\\glossaryentry"

Pour que chaque entrée soit constituée d'un terme et de sa définition, nous avons défini la commande suivante :

\newcommand{\entreeglossaire}[2]{\glossary{[#1] #2}}

De telle sorte que :

\entreeglossaire{Sphere}{Patate bien régulière.}

aura pour effet d'écrire :

\glossary{[Sphère] Patate bien régulière.}

dans le fichier .glo. Après appel de makeindex :

• makeindex -s glossaire.ist document.glo -o document.glx

on aura dans le fichier .glx :

\begin{leglossaire}
\item [Sphère] Patate bien régulière., n° de page
\end{leglossaire}

Si vous m'avez bien suivi jusqu'ici, vous devriez râler et me dire : « faudrait p'têt' voir à enlever cette vilaine virgule et ce numéro de page... » Certes. La virgule est automatiquement mise par makeindex comme délimiteur « de premier niveau » entre une entrée d'index et le numéro de page où apparaît cette entrée. Pour utiliser autre chose qu'une virgule (ici rien en l'occurrence) on écrit dans le fichier de style :

delim_0 ""

Il reste à régler le cas du numéro de page. La solution que j'ai adoptée consiste à utiliser une commande « absorbante » en guise de mise en forme du numéro de page (cf. §6.3.3Différents types d'entrée d'index). Voici la commande \entreeglossaire modifiée :

\newcommand{\pasdenumerodepage}[1]{}% « mange » l'argument
\newcommand{\entreeglossaire}[2]{%
  \glossary{[#1] #2|pasdenumerodepage}}

ceci permet de créer le fichier .glx de la forme :

\begin{leglossaire}
\item [Sphère] Patate bien régulière.\pagedenumerodepage{27}
\end{leglossaire}

qui enverra le numéro de page (ici 27 pour l'exemple) dans le vide intersidéral.

Pour en finir avec le glossaire, il nous faut créer une commande suffisamment souple qui aura essentiellement pour but de produire un chapitre contenant le glossaire, c'est-à-dire d'insérer dans le document le fichier .glx. On peut décomposer les tâches à effectuer par la commande en question, comme suit :

• créer un nouveau chapitre (avec comme titre « glossaire ») ;
• lire les entrées de glossaire (commande \entreeglossaire) depuis un fichier ;
• insérer le fichier .glx

Voici la commande effectuant ces traitements :

\newcommand{\printglossary}[1][glossaire.tex]{%
  \chapter*{Glossaire}
  \label{chap-glossaire}
  \markboth{Glossaire}{Glossaire}% en−tête de page
  % insertion dans la table des matières :
  \addcontentsline{toc}{chapter}{Glossaire}
  % insertion des entrées de glossaire :
  \InputIfFileExists{#1}{%
    \typeout{Données du glossaire}}{%
    \typeout{Pas de fichier glossaire.tex}}
  % insertion du fichier . glx
  \InputIfFileExists{\jobname.glx}{%
    \typeout{Glossaire trié}}{%
    \typeout{Pas de fichier \jobname.glx}}
}

On notera les points suivants concernant cette commande :

• le fichier d'entrée de glossaire est par défaut le fichier glossaire.tex ;
• on a décidé d'insérer le glossaire dans la table des matières ;

• pour insérer un fichier, on fait appel à la commande \InputIfFileExists définie dans le format LaTeX ayant la forme suivante :

   

  Sélectionnez

  1.
  2.
  3.
  

  \InputIfFileExists{fichier à inclure}
  {code LaTeX si le fichier existe}
  {code LaTeX si le fichier n'existe pas}
  

  Enfin \jobname contient le nom du fichier (ou document maître) en cours de compilation et la commande \typeout affiche un message sur la console de compilation.

Enfin, le fichier glossaire.ist contient finalement :

delim_0 ""
preamble "\n\\begin{leglossaire}"
postamble "\n\\end{leglossaire}"
keyword "\\glossaryentry"

Le cahier des charges est le suivant :

• les onglets apparaissent sur chaque page du coté opposé à la reliure ;
• ils sont produits « à l'envers » sur les pages paires ;
• ils doivent être à une hauteur proportionnelle au numéro du chapitre.

D'où l'idée :

• d'utiliser les fonctionnalités du package fancyhdr pour produire les onglets ;
• utiliser des translations verticales pour les positionner.

De manière à produire les numéros de chapitres dans la marge, j'ai simplement créé des boîtes paragraphe de largeur et hauteur imposées(89) :

\newlength{\ongletwidth}
\newlength{\ongletheight}
\setlength{\ongletheight}{32pt}
\setlength{\ongletwidth}{.96cm}

Voici la commande produisant la boîte :

\newcommand{\b@iteonglet}{%
  \colorbox[gray]{.7}{% une boîte avec un fond gris contenant
    % la boîte paragraphe de largeur et hauteur fixée :
    \parbox[t][\ongletheight][s]{\ongletwidth}{%
      \vfill%
      \centering%
      % on applique un effet miroir selon la parité de la page
      \ifthenelse{\isodd{\value{page}}}{%
        \ongletfont\thechapter}{%
        \reflectbox{\ongletfont\thechapter}}%
      \vfill}}}

On notera l'utilisation de la commande \reflectbox du package graphicx. On pourra également remarquer que le contenu de la boîte paragraphe est centré en hauteur grâce à deux ressorts verticaux et qu'on insère finalement dans cette boîte le numéro du chapitre dans une mystérieuse fonteFontes enclenchée par la commande \ongletfont.

11.29 Sélectionnez 1. Et voici la boîte : \b@iteonglet...

Il est important de noter que les boîtes produites par \colorbox sont assujetties à la dimension \fboxsep :

11.30 Sélectionnez 1. 2. \setlength{\fboxsep}{15pt} En voici une autre : \b@iteonglet...

Pour positionner les onglets, il faut effectuer deux translations :

• une horizontale pour pousser l'onglet jusqu'au bout de la zone de note marginale ;
• une verticale en fonction du numéro de chapitre.

On utilisera le mécanisme de définition des en-têtes de page du package fancyhdr pour positionner les onglets. L'idée est simple, on écrit :