Paquets courants et astuces LaTeX
Les chapitres précédents ont déjà utilisé un certain nombre de paquets ; cet article récapitule systématiquement : référence rapide des paquets, commandes personnalisées, composition de code, projets multi-fichiers, latexmk et techniques de dépannage.
Maîtrisez ces sujets de "boîte à outils", et vous évoluerez de l'écriture de LaTeX à la gestion de projets LaTeX.
Référence rapide des paquets courants
Chargez des paquets avec \usepackage[options]{package-name}, tous placés dans le préambule.
| Paquet | Objectif | Apparaît dans cette série |
|---|---|---|
| geometry | Marges de page et format du papier | Structure du document et composition typographique LaTeX |
| fancyhdr | En-têtes et pieds de page | Structure du document et composition typographique LaTeX |
| amsmath / amssymb | Amélioration des formules mathématiques / symboles étendus | Bases des formules mathématiques LaTeX、Formules mathématiques LaTeX avancées |
| graphicx | Figures | Figures et tableaux LaTeX |
| booktabs / multirow | Booktabs / cellules fusionnées verticalement | Figures et tableaux LaTeX |
| enumitem | Personnalisation des listes | Mise en forme du texte et listes LaTeX |
| xcolor | Définition de couleur | Introduit dans ce chapitre |
| listings | Composition du code | Introduit dans ce chapitre |
| hyperref | Liens hypertextes et signets | Références croisées et gestion de la bibliographie LaTeX |
| biblatex | Références (approche moderne) | Références croisées et gestion de la bibliographie LaTeX |
| float | Placement forcé des figures et tableaux [H] | Figures et tableaux LaTeX |
Lorsque l'environnement local affiche File 'xxx.sty' not found, utilisez tlmgr install xxx pour l'installer (TeX Live) ; MiKTeX le téléchargera automatiquement. Overleaf est livré avec presque tous les paquets, donc aucun problème de ce type.
Commandes personnalisées : \newcommand
Lorsque vous avez écrit le même contenu plus de trois fois, il est temps de définir une commande. \newcommand{\command-name}[number-of-parameters]{definition}.
{...}$ donne x_1, … , x_5
\newcommand{\R}{\mathbb{R}} % Désormais, écrire $\R$ donne $\mathbb{R}$
% Un paramètre : encapsuler un format fixe
\newcommand{\email}[1]{\texttt{#1}} % #1 représente le premier paramètre
% Paramètre optionnel avec valeur par défaut : [nombre de paramètres][valeur par défaut]
\newcommand{\vecn}[2][n]{x_1, \dots, x_#1}
% Utilisation : $\vecn{...}$ donne x_1, … , x_n
% $\vecn
\begin{document}
défini sur$\R$fonction sur, vecteur$\vecn$et$\vecn[5]$,
E-mail de contact\e-mail{service@example.com}。
\end{document}
| Commande | Objectif | Remarque |
|---|---|---|
| \newcommand | Définir une nouvelle commande | Le nom de la commande ne doit pas entrer en conflit avec les commandes existantes |
| \renewcommand | Redéfinir une commande existante | À utiliser lors de la modification des styles par défaut ; soyez prudent avec les commandes de base |
| \newenvironment | Définir un nouvel environnement | Syntaxe identique à ci-dessus ; fournir le code de début et de fin |
Apprenons aussi la syntaxe des environnements personnalisés:
Exemple: environnement personnalisé "Note"
{\par\medskip\noindent\textbf{Note:}\itshape} % Début du code
{\par\medskip} % Fin du code
\begin{note}
Le contenu ici commencera automatiquement par "Note:" et sera composé en italique.
\end{note}
Composition de code: paquet listings
Pour inclure du code dans des documents techniques, utilisez le paquet listings; la coloration syntaxique, les numéros de ligne et les bordures sont tous automatiques.
Exemple: bloc de code avec coloration et numéros de ligne
\usepackage{listings} % Paquet de composition de code
\usepackage{xcolor} % Prise en charge des couleurs
\lstset{ % Paramètres globaux de style de code
basicstyle=\ttfamily\small, % Police monospace, taille de police légèrement plus petite
keywordstyle=\color{blue}, % Mots-clés en bleu
commentstyle=\color{gray}, % Commentaires en gris
stringstyle=\color{purple}, % Chaînes de caractères en violet
numbers=left, % Numéros de ligne à gauche
numberstyle=\tiny\color{gray},
showstringspaces=false, % Ne pas afficher les marqueurs d'espace dans les chaînes
frame=single % Bordure sur une seule ligne
}
\begin{document}
\begin{lstlisting}[language=Python, caption=Calculer la suite de Fibonacci]
# Calculer le n-ième nombre de Fibonacci (test de commentaire en chinois)
def fib(n):
if n < 2:
return n
return fib(n - 1) + fib(n - 2)
print(fib(10)) # Sortie 55
\end{lstlisting}
\end{document}

lstlisting est un « environnement verbatim » : son contenu n'est pas du tout interprété par LaTeX, et & et % n'ont pas besoin d'être échappés. La légende est également numérotée automatiquement (Listing 1). Les noms de langages courants incluent Python, C, Java, HTML, SQL, bash, etc. Si le langage n'est pas spécifié, il est coloré comme du texte brut.
La prise en charge du chinois UTF-8 par listings dépend du compilateur : les commentaires en chinois fonctionnent normalement sous XeLaTeX ; avec les moteurs hérités (latex/pdfLaTeX), ils deviennent illisibles. Pour les documents en chinois, compilez toujours avec XeLaTeX.
Projets multi-fichiers : \input et \include
Lorsqu'un document dépasse quelques centaines de lignes, il doit être divisé en fichiers — main.tex ne sert que de squelette, et le contenu est divisé pour mieux régner.
Exemple : squelette de main.tex
\usepackage{amsmath, graphicx, booktabs, hyperref}
\begin{document}
\input{chapters/intro} % Introduction (nom du fichier sans .tex)
\input{chapters/method} % Méthodes
\input{chapters/experiment} % Expériences
\input{chapters/conclusion} % Conclusions
\bibliographystyle{plain}
\bibliography{refs}
\end{document}
Les deux commandes se ressemblent, mais leurs comportements sont clairement distincts.
| Élément de comparaison | \input{file} | \include{file} |
|---|---|---|
| Peut être imbriqué ? | Oui (d'autres \input dans les sous-fichiers) | Non |
| Force un saut de page ? | Pas de saut de page | Force \clearpage avant chaque fichier |
| Fonctionne avec \includeonly | Non pris en charge | Pris en charge ; compile uniquement les chapitres spécifiés (un excellent outil d'accélération) |
| Granularité applicable | Tout segment (définitions de macros, figures/tableaux, pages de couverture) | Blocs de contenu volumineux au niveau du chapitre |
Piège courant : \include force un saut de page. L'utiliser pour assembler « plusieurs sections sur la même page » provoquera des sauts de page inattendus—utilisez \input pour les petits fragments.
latexmk : compilation en un clic
Le pipeline de compilation en quatre passes du chapitre 9 est pénible à saisir manuellement sous forme de quatre commandes ; latexmk le gère entièrement automatiquement.
$ latexmk -xelatex main.tex # XeLaTeX 引擎编译,自动跑满所有遍数 $ latexmk -xelatex -c main.tex # 清理中间文件(保留 PDF) $ latexmk -xelatex -C main.tex # 连 PDF 一起清理
latexmk décide automatiquement : s'il y a un fichier .bib, il exécute bibtex ; si les références croisées changent, il compile plusieurs fois de plus jusqu'à ce que tous les numéros soient stables. Configurer la « commande de compilation » dans votre éditeur comme latexmk est la meilleure pratique pour un environnement local.
Techniques de dépannage
Les messages d'erreur LaTeX commencent par un point d'exclamation et incluent un numéro de ligne, avec un format fixe. Comprendre les premières lignes suffit.
! Undefined control sequence.
l.42 \secton{方法}
l.42 indique la ligne de l'erreur—dans cet exemple, la ligne 42 a mal orthographié \section en \secton. Corrigez ce seul endroit, et une chaîne d'erreurs suivantes disparaît souvent d'un coup.
| Message d'erreur | Signification | Gestion |
|---|---|---|
| Séquence de contrôle non définie | La commande n'existe pas : erreur d'orthographe ou paquet manquant | Vérifiez l'orthographe par rapport au numéro de ligne ; confirmez que le paquet est chargé |
| Missing $ inserted | Une commande mathématique apparaît en mode texte | Placez _ ^ \alpha etc. à l'intérieur de $ |
| File 'xxx' not found | Fichier ou paquet introuvable | Vérifiez le chemin ; tlmgr install xxx |
| Argument fugitif | Environnement non fermé (\end manquant) | Ajoutez \end{...} en fonction du numéro de ligne |
| Erreur LaTeX : environnement xxx non défini | Utilisation d'un environnement non défini | Vérifiez l'orthographe de l'environnement et du paquet |
| ! Arrêt d'urgence | Compilation interrompue complètement | Remontez dans le journal pour trouver la première erreur |
| Référence non définie (avertissement) | La référence affiche ?? | Compiler une fois de plus |
Toujours corriger uniquement la première erreur du journal—les erreurs suivantes sont principalement des effets en cascade de la première. Après correction, recompiler ; c'est bien plus fiable que de modifier dix endroits à la fois.
Résumé
| Besoin | Solution |
|---|---|
| Réduire la saisie répétée | \newcommand définit des commandes et des environnements |
| Coller le code | listings + \lstset style global |
| Découpage de grands documents | \input (fragment) / \include (niveau chapitre) |
| Compilation en un clic | latexmk -xelatex |
| Débogage | Lire le numéro de ligne de la première erreur ! dans le journal |