Un tableau digne d'un article

tabular, filets booktabs, légende, étiquette.

Un tableau digne d’un article

Les tableaux en LaTeX reposent sur deux environnements imbriqués aux rôles différents. L’environnement intérieur tabular construit la grille de cellules. L’environnement extérieur table fait de cette grille un flottant : elle peut ainsi porter un numéro, une légende et une étiquette, et LaTeX peut la placer là où la page a de la place. Ajoutez le package booktabs pour les filets horizontaux, et le résultat ressemble à un tableau d’un article publié, pas à une capture d’écran de tableur.

\usepackage{booktabs}
\begin{table}[htbp]
\centering
\caption{Results on the test set.}
\label{tab:results}
\begin{tabular}{lcc}
\toprule
Model & Acc. & F1 \\
\midrule
Baseline & 0.81 & 0.79 \\
Ours & 0.87 & 0.86 \\
\bottomrule
\end{tabular}
\end{table}

L’environnement extérieur

L’argument [htbp] liste les endroits où LaTeX peut placer le flottant : ici dans le texte, en haut d’une page, en bas, ou sur une page séparée de flottants. Il les essaie dans cet ordre, et autoriser les quatre évite que le tableau ne dérive trop loin ; la mécanique est expliquée dans où atterrissent vraiment les flottants. \centering centre la grille horizontalement. \caption imprime la légende numérotée, et par convention les légendes de tableau se placent au-dessus du tableau, contrairement à celles des figures, qui se placent en dessous. \label doit venir après \caption, car une étiquette enregistre le dernier numéro attribué, comme expliqué dans légendes et étiquettes. Une fois l’étiquette en place, Table~\ref{tab:results} dans votre texte affiche toujours le bon numéro.

La grille intérieure

Le {lcc} après \begin{tabular} déclare une colonne par lettre : l est aligné à gauche, c est centré, et r serait aligné à droite. Trois lettres font trois colonnes, et chaque ligne doit fournir exactement autant de cellules. Dans une ligne, & sépare les cellules et \\ termine la ligne. Les colonnes de texte se lisent généralement mieux alignées à gauche, tandis que les courtes colonnes numériques sont souvent centrées.

Les trois filets viennent de booktabs. \toprule ouvre le tableau, \midrule sépare la ligne d’en-tête des données, et \bottomrule le ferme. Ils remplacent la commande simple \hline et s’accompagnent d’espacements correctement réglés au-dessus et en dessous, ce qui explique en grande partie pourquoi le tableau paraît composé par un professionnel. Pas de lignes verticales, et pas de filet entre les lignes de données : le style booktabs omet volontairement les deux. Le raisonnement est exposé dans les tableaux à trois filets.

Remarques pratiques

Les erreurs de débutant les plus fréquentes sont un décalage entre le nombre de séparateurs & et les colonnes déclarées, et un \\ oublié à la fin d’une ligne : les deux produisent des messages d’erreur déroutants qui pointent vers la ligne suivante. Si vous préférez ne pas compter les cellules à la main, construisez la grille visuellement avec le générateur de tableaux et collez le résultat dans votre document.

Vérification : les tableauxQuiz d’entraînement facultatif4 questions

Une courte vérification de ce que couvre cette leçon. Les mauvaises réponses affichent la bonne. Les choix sont mélangés à chaque tentative. Vous pouvez recommencer autant de fois que vous le souhaitez.

Retour à Flottants et encre