summaryrefslogtreecommitdiff
path: root/info/formation-latex-ul/source/boites.tex
blob: bba5856dcb7f3f9fae57aeb7e24b8b18bbb04b77 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
%%% Copyright (C) 2015-2023 Vincent Goulet
%%%
%%% Ce fichier fait partie du projet
%%% «Rédaction avec LaTeX»
%%% https://gitlab.com/vigou3/formation-latex-ul
%%%
%%% Cette création est mise à disposition sous licence
%%% Attribution-Partage dans les mêmes conditions 4.0
%%% International de Creative Commons.
%%% https://creativecommons.org/licenses/by-sa/4.0/

\chapter{Boites}
\label{chap:boites}

Il arrive que l'on doive traiter de manière spéciale une aire
rectangulaire de texte; pour l'encadrer, la mettre en surbrillance ou
la mettre en exergue, par exemple.

Avec les traitements de texte, les tableaux sont souvent mis à
contribution à de telles fins. Or, les tableaux devraient être
réservés à la disposition d'information sous forme de lignes et de
colonnes. Pour disposer et mettre en forme tout autre type contenu se
présentant sous forme rectangulaire, {\LaTeX} offre la solution plus
générale des «boites».

Il existe trois sortes de boites en {\LaTeX}: les boites horizontales,
dont le contenu est disposé exclusivement côte à côte; les boites
verticales, qui peuvent contenir plusieurs lignes de contenu; les
boites de réglure pour former des lignes pleines de largeur et de
hauteur quelconques.

Il n'est pas inutile de savoir, au passage, que {\TeX} ne manipule que
cela, des boites. Pour {\TeX}, chaque caractère, chaque lettre n'est
qu'un rectangle d'une certaine largeur qui s'élève au-dessus de la
ligne de base (les lignes d'une feuille lignée) et qui, parfois, se
prolonge sous la ligne de base (pensons aux lettres «p», «y»
ou «Q»). La \autoref{fig:boites:glyphs} illustre cela.

\begin{figure}[t]
  \begin{minipage}{0.45\linewidth}
    \centering\huge
    fantastique
  \end{minipage}
  \hfill
  \begin{minipage}{0.45\linewidth}
    %% creéation de boites autour des caractères
    %% https://tex.stackexchange.com/q/57812
    \fboxrule=0.1pt
    \fboxsep=-\fboxrule
    \makeatletter
    \def\SOUL@soeverytoken{%
      \fbox{\color{white}\the\SOUL@token}}
    \makeatother
    \centering
    \so{\huge fantastique}
  \end{minipage}
  \caption[Pour {\TeX}, un texte n'est qu'un alignement de boites]{%
    Pour {\TeX}, un texte n'est qu'un alignement de boites. À gauche,
    ce que nous voyons dans le document fini; à droite, ce que {\TeX}
    manipule.}
  \label{fig:boites:glyphs}
\end{figure}

Les commandes et les environnements présentés dans ce chapitre
permettent de créer des boites dont le contrôle des dimensions et
du contenu est laissé entre vos mains.

Une fois créée, une boite ne peut être scindée en parties, notamment
entre les lignes ou entre les pages.


\section{Boites horizontales}
\label{sec:boites:lrbox}

Le concept de boite le plus simple dans {\LaTeX} est celui de boite
horizontale, c'est-à-dire dont le contenu est disposé latéralement de
gauche à droite\footnote{%
  D'où l'appellation \emph{LR (left-right) box} en anglais.}. %
Le contenu est normalement du texte, mais conceptuellement ce pourrait
être n'importe quoi, y compris d'autres boites.

Les commandes de base pour créer des boites horizontales sont:
\begin{lstlisting}
\mbox`\marg{texte}'
\fbox`\marg{texte}'
\end{lstlisting}
Elles produisent une boite de la largeur précise de \meta{texte}. Avec
la commande \cmd{\fbox}, le texte est au surplus \fbox{encadré}.

Il existe également des versions plus générales des commandes
\cmd{\mbox} et \cmd{\fbox}:
\begin{lstlisting}
\makebox`\oarg{largeur}\oarg{pos}\marg{texte}'
\framebox`\oarg{largeur}\oarg{pos}\marg{texte}'
\end{lstlisting}
Les arguments optionnels \meta{largeur} et \meta{pos} déterminent
respectivement la largeur de la boite et la position du texte
dans la boite. Les valeurs possibles de \meta{pos} sont: \code{l} pour
du texte aligné à gauche, \code{r} pour du texte aligné à droite et
\code{c} (la valeur par défaut) pour du texte centré. Ainsi, la commande
\begin{lstlisting}
\framebox[3.5cm][l]{aligné à gauche}
\end{lstlisting}
produit \framebox[3.5cm][l]{aligné à gauche}, alors que
\begin{lstlisting}
\makebox[3.5cm]{centré}
\end{lstlisting}
produit \makebox[3.5cm]{centré}.

\tipbox{En usage courant, la commande \cmd{\mbox} sert principalement
  à deux choses:
  \begin{enumerate}
  \item réunir en un bloc du texte que l'on ne veut pas voir scindé
    entre les lignes ou entre les pages;
  \item \label{item:boites:mbox} créer une boite vide avec
    \cs{mbox\{\}} afin de laisser croire à {\TeX} que du contenu
    apparait à un endroit, sans toutefois qu'il n'occupe aucun espace.
  \end{enumerate}
  La seconde utilisation fait l'objet de
  l'\autoref{ex:boites:alignement-v}.}

Il est parfois nécessaire d'ajuster le positionnement vertical
d'éléments de contenu, notamment pour les symboles ou les images. La
commande
\begin{lstlisting}
\raisebox`\marg{déplacement}\marg{texte}'
\end{lstlisting}
produit une boite horizontale dont le contenu \meta{texte} est
surélevé de la longueur \meta{déplacement} par rapport à la ligne de
base. Si \meta{déplacement} est négatif, la boite est positionnée sous
la ligne de base.
\begin{demo}
  \begin{texample}[0.55\textwidth]
\begin{lstlisting}
Texte \raisebox{1ex}{au-dessus}
de la ligne de base.
\end{lstlisting}
    \producing
    Texte \raisebox{1ex}{au-dessus}
    de la ligne de base.
  \end{texample}

  \begin{texample}[0.55\textwidth]
\begin{lstlisting}
Texte \raisebox{-1ex}{au-dessous}
de la ligne de base.
\end{lstlisting}
    \producing
    Texte \raisebox{-1ex}{au-dessous}
    de la ligne de base.
  \end{texample}
\end{demo}

Attention, toutefois, de ne pas utiliser \cmd{\raisebox} pour placer
du texte en exposant ou en indice. Selon la nature du texte, employez
plutôt les commandes \cmd{\textsuperscript} et \cmd{\textsubscript},
les commandes de la famille \cmd{\ieme} de \pkg{babel} (section~1.1 de
la %
\doc{babel-french}{https://texdoc.net/pkg/babel-french}) ou, pour des
symboles mathématiques, les commandes d'exposant et d'indice
spécifiques au mode mathématique (\autoref{sec:math:bases:exposants}).

\section{Boites verticales}
\label{sec:boites:parbox}

Les boites verticales se distinguent des boites horizontales par le
fait qu'elles peuvent contenir plusieurs lignes de contenu empilées
les unes au-dessus des autres. Lorsque le contenu en question est du
texte, on obtient des paragraphes\footnote{%
  D'où l'appellation de \emph{paragraph boxes} en anglais
  ou \emph{parboxes} dans le jargon {\LaTeX}.}. %

La commande de base pour créer une boite verticale est:
\begin{lstlisting}
\parbox`\oarg{pos}\marg{largeur}\marg{texte}'
\end{lstlisting}
Ici, l'argument optionnel \meta{pos} permet d'ajuster l'alignement
vertical de la boite avec la ligne de base: \code{b} ou \code{t} selon
que l'on souhaite aligner, respectivement, le bas ou le haut de la
boite avec la ligne de base. Par défaut, la boite est centrée avec la
ligne de base. Cet argument n'a aucun effet si la boite est le seul
élément de contenu du paragraphe.

On remarquera que l'argument \meta{largeur} est ici obligatoire.
Autrement dit, on doit nécessairement définir la largeur des boites
verticales, un peu comme il faut bien définir la largeur de la page
pour le texte normal (la classe se charge de ce détail).

Les boites créées avec \cmd{\parbox} ne peuvent contenir de structures
«complexes» comme des listes ou des tableaux. Parce que plus général,
l'outil véritablement utile pour la création de boites verticales est
l'environnement \Pe{minipage}. Cet environnement peut contenir à peu près
n'importe quel type de contenu. Comme son nom l'indique, c'est ni plus
ni moins qu'une page miniature à l'intérieur de la page standard.

La syntaxe de l'environnement \Ie{minipage} est la suivante:
\begin{lstlisting}
\begin{minipage}`\oarg{pos}\marg{largeur}'
  `\meta{texte}'
\end{minipage}
\end{lstlisting}
La signification des arguments \meta{largeur} et \meta{pos} est la
même que pour la commande \cmd{parbox}.

L'environnement \Pe{minipage} est fréquemment utilisé pour disposer
des éléments de contenu de manière spécifique sur la page, notamment
des tableaux ou des figures côte à côte ou en grille (voir
l'\autoref{exemple:tableaux:grille} à la
\autopageref{exemple:tableaux:grille}).

\begin{exemple}
  L'agencement de boites ci-dessous est produit avec le code qui suit
  immédiatement.  \\[0.5\baselineskip]
  \begin{minipage}{\textwidth}
    \makebox[0pt][l]{\color{lightgray}\rule{\textwidth}{0.7pt}}\relax
    \fbox{\begin{minipage}[b]{0.3\textwidth} La ligne inférieure de
        cette \emph{minipage} est alignée avec
      \end{minipage}} \hfill \fbox{\parbox{0.3\textwidth}{le centre de
        cette boite verticale, qui est à son tour alignée avec}}
    \hfill \fbox{\begin{minipage}[t]{0.3\textwidth} la ligne
        supérieure de cette \emph{minipage}. Le filet horizontal grisé
        représente la ligne de base du paragraphe contenant les trois
        boites.
      \end{minipage}}
  \end{minipage}
\begin{lstlisting}
\begin{minipage}[b]{0.3\textwidth}
  La ligne inférieure de cette \emph{minipage} [...]
\end{minipage}
\hfill
\parbox{0.3\textwidth}{le centre de cette boite [...] }
\hfill
\begin{minipage}[t]{0.3\textwidth}
  la ligne supérieure de cette \emph{minipage}. [...]
\end{minipage}
\end{lstlisting}
  \qed
\end{exemple}

La commande \cmd{\hfill} utilisée entre les boites dans l'exemple
ci-dessus indique à {\LaTeX} d'insérer de l'espace entre les éléments
de contenu de manière à remplir entièrement la ligne de texte. C'est
une commande très utile pour disposer automatiquement des éléments à
intervalles égaux sur la largeur du bloc de texte. Ainsi,
\begin{lstlisting}
\framebox[\linewidth]{gauche \hfill droite}
\end{lstlisting}
produit \\[0.5\baselineskip]
\framebox[\linewidth]{gauche \hfill droite} \\[0.5\baselineskip]
alors que
\begin{lstlisting}
\framebox[\linewidth]{gauche \hfill centre \hfill droite.}
\end{lstlisting}
produit \\[0.5\baselineskip]
\framebox[\linewidth]{gauche \hfill centre \hfill droite.}



\section{Boites de réglure}
\label{sec:boites:rulebox}

En imprimerie, une réglure est une ligne droite continue ou
pointillée. Une ligne n'étant jamais rien d'autre qu'un rectangle
plein, si mince fut-il, la réglure est le troisième type de
boite\footnote{%
  \emph{Rule box}, en anglais} %
dans {\LaTeX}.

La commande
\begin{lstlisting}
\rule`\oarg{déplacement}\marg{largeur}\marg{hauteur}'
\end{lstlisting}
crée une réglure de dimensions \meta{largeur} $\times$ \meta{hauteur}.
Par défaut, la réglure s'appuie sur la ligne de base. Le résultat de
\begin{lstlisting}
\rule{1cm}{6pt}
\end{lstlisting}
est donc une ligne pleine de $1$~cm de long et de $6$~points d'épais:
\rule{1cm}{6pt}.

L'argument optionnel \meta{déplacement} permet de déplacer
verticalement la réglure au-dessus ou au-dessous de la ligne de base
selon que la longueur \meta{déplacement} est positive ou négative. Les
commandes
\begin{lstlisting}
\rule[3pt]{1cm}{6pt}
\rule[-3pt]{1cm}{6pt}
\end{lstlisting}
créent respectivement les réglures \rule[3pt]{1cm}{6pt} et
\rule[-3pt]{1cm}{6pt}.

Un usage intéressant de la réglure consiste à faire croire à {\TeX}
qu'une ligne est plus haute qu'il n'y parait en insérant dans celle-ci
une réglure de largeur nulle. Par exemple, la distance entre
\rule[-12pt]{0mm}{30pt}\relax la présente ligne et les autres du
paragraphe est plus grande que la normale parce que j'y ai inséré une
réglure invisible avec
\begin{lstlisting}
\rule[-12pt]{0mm}{30pt}
\end{lstlisting}
Ce truc est particulièrement utile pour augmenter la hauteur des
lignes dans un tableau; voir la \autoref{sec:tableaux:tableaux}.



%%%
%%% Exercices
%%%

\section{Exercices}
\label{sec:boites:exercices}

\Opensolutionfile{solutions}[solutions-boites]

\begin{Filesave}{solutions}
\section*{Chapitre \ref*{chap:boites}}
\addcontentsline{toc}{section}{Chapitre \protect\ref*{chap:boites}}

\end{Filesave}

\noindent%
Utiliser comme canevas le fichier \fichier{exercice-gabarit.tex} pour
tous les exercices ci-dessous.

\begin{exercice}
  Une fois qu'une boite est définie, {\TeX} n'y voit qu'une unité de
  contenu avec ses dimensions propres. Il est donc possible de définir
  une boite à l'intérieur d'une autre, et ce, peu importe le type de
  boite.

  Avec ceci en tête, définir la boite suivante:
  \begin{center}
    \fbox{\fbox{%
        \parbox{10cm}{Ce bloc de texte est une boite verticale de
          10~cm de large, doublement encadrée et centrée sur la
          ligne.}}}
  \end{center}

  \begin{sol}
    Une première boite verticale de 10~cm de large contient le texte:
\begin{lstlisting}
\parbox{10cm}{Ce bloc [...] la ligne.}
\end{lstlisting}
    Cette boite peut être placée dans une boite horizontale encadrée
    avec \cmd{\fbox}. Celle-ci peut à son tour être placée dans une autre
    boite horizontale encadrée, de manière à obtenir un cadrage
    double. Pour centrer le tout sur la ligne, il reste à placer le
    tout dans un environnement \Ie{center}:
\begin{lstlisting}
\begin{center}
  \fbox{\fbox{\parbox{10cm}{Ce bloc [...] la ligne.}}}
\end{center}
\end{lstlisting}
  \end{sol}
\end{exercice}

\begin{exercice}
  \label{ex:boites:alignement-v}
  Réaliser l'agencement de boites verticales suivant:
  \begin{center}
    \begin{minipage}{0.8\linewidth}
      \makebox[0pt][l]{\color{lightgray}\rule{\linewidth}{0.7pt}}\relax
      \hfill
        \begin{minipage}[b]{0.95\linewidth}
          \small
          \parbox[t]{0.45\linewidth}{Deux boites verticales de
            hauteurs différentes placées côte à côte}
          \hfill
          \parbox[t]{0.45\linewidth}{alignées sur
            leurs premières lignes et le bas de la boite
            la plus haute alignée sur la ligne de base (représentée
            ici par le filet horizontal grisé).} \\
          \mbox{}
        \end{minipage}
      \hfill
    \end{minipage}
  \end{center}

  La solution intuitive serait la suivante:
\begin{lstlisting}
\begin{minipage}[b]{...}
  \parbox[t]{...}{...} \hfill \parbox[t]{...}{...}
\end{minipage}
\end{lstlisting}
  Cependant, cette solution produit le résultat suivant (les boites
  sont rendues visibles par des cadres):
  \begin{center}
    \begin{minipage}{0.8\linewidth}
      \makebox[0pt][l]{\color{lightgray}\rule{\linewidth}{0.7pt}}\relax
      \hfill
      \fbox{%
        \begin{minipage}[b]{0.95\linewidth}
          \small
          \fbox{%
            \parbox[t]{0.45\linewidth}{Les deux boites sont
              correctement alignées l'une par rapport à l'autre}} \hfill
          \fbox{\parbox[t]{0.45\linewidth}{mais l'alignement avec la
              ligne de base est incorrect.}}
        \end{minipage}}
      \hfill
    \end{minipage}
  \end{center}
  La raison: pour {\TeX}, la \Ie{minipage} externe ne contient que
  deux «caractères» sur une seule ligne de «texte». La \Pe{minipage}
  est donc correctement alignée sur sa ligne du bas, mais celle-ci se
  trouve aussi être la ligne du haut.

  Pour parvenir au résultat escompté, utiliser la commande \cmd{\mbox}
  pour créer une seconde ligne (vide) dans la \Pe{minipage} externe.
  \begin{sol}
    L'idée consiste à créer une seconde ligne dans la \Pe{minipage}
    externe sans que celle-ci n'occupe aucun espace. Pour ce faire, on
    insère du contenu vide avec \cs{mbox\{\}}, tel qu'expliqué à la
    \autopageref{item:boites:mbox}. Le code
\begin{lstlisting}
\begin{minipage}[b]{...}
  \parbox[t]{...}{...} \hfill \parbox[t]{...}{...} \\
  \mbox{}
\end{minipage}
\end{lstlisting}
    produit donc le résultat voulu:
    \begin{center}
      \begin{minipage}{0.8\linewidth}
        \makebox[0pt][l]{\color{lightgray}\rule{\linewidth}{0.7pt}}\relax
        \hfill
        \fbox{%
          \begin{minipage}[b]{0.95\linewidth}
            \small
            \fbox{%
              \parbox[t]{0.45\linewidth}{Les boites sont rendues visibles
                par des cadres}} \hfill
            \fbox{\parbox[t]{0.45\linewidth}{et le filet horizontal grisé
                représente la ligne de base du paragraphe courant.}} \\
            \fbox{\mbox{}}
          \end{minipage}}
        \hfill
      \end{minipage}
  \end{center}
  (Sans le cadre, la boite de la seconde ligne n'occupe aucun espace.)
  \end{sol}
\end{exercice}

\begin{exercice}
  Réaliser l'agencement de boites verticales ci-dessous. (La taille de
  la police est \cs{footnotesize}.)
  \begin{center}
    \begin{minipage}{120mm}
      \footnotesize
      \begin{minipage}[b]{80mm}
        \parbox[t]{30mm}{La première ligne de cette \emph{parbox} de
          $30$~mm de large est alignée avec celle de la boite
          voisine.}
        \hfill
        \parbox[t]{45mm}{Cette \emph{parbox} de $45$~mm de large est
          positionnée de telle sorte que sa première ligne soit
          alignée avec le haut de la boite à gauche et la dernière
          avec le bas de la boite à droite. La solution intuitive
          consistant à placer côte à côte trois boites avec des
          arguments de positionnement \code{t}, \code{t} et \code{b}
          ne fonctionne pas.} \\
        \mbox{}
      \end{minipage}
      \hfill
      \parbox[b]{35mm}{Pour parvenir à cette disposition, il faut
        avoir recours à des lignes invisibles comme dans l'exercice
        précédent.}
    \end{minipage}
  \end{center}
  La troisième boite fait $35$~mm de large et l'espace entre les
  boites, $5$~mm.
  \begin{sol}
    La solution la plus simple consiste à réunir les deux premières
    boites dans une \Pe{minipage} dans laquelle les deux boites seront
    alignées tel que désiré, puis à aligner la \Pe{minipage} avec la
    troisième boite. Cependant, il faut insérer une seconde ligne
    invisible dans la \Pe{minipage} afin de pouvoir l'aligner par le
    bas avec la boite de droite:
\begin{lstlisting}
\begin{minipage}[b]{80mm}
  \parbox[t]{30mm}{...} \hfill \parbox[t]{45mm}{...} \\
  \mbox{}
\end{minipage}
\hfill
\parbox[b]{35mm}{...}
\end{lstlisting}
  \end{sol}
\end{exercice}

\Closesolutionfile{solutions}

%%% Local Variables:
%%% mode: latex
%%% TeX-master: "formation-latex-ul"
%%% TeX-engine: xetex
%%% coding: utf-8
%%% End: