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.

PaquetObjectifApparaît dans cette série
geometryMarges de page et format du papierStructure du document et composition typographique LaTeX
fancyhdrEn-têtes et pieds de pageStructure du document et composition typographique LaTeX
amsmath / amssymbAmélioration des formules mathématiques / symboles étendusBases des formules mathématiques LaTeX、Formules mathématiques LaTeX avancées
graphicxFiguresFigures et tableaux LaTeX
booktabs / multirowBooktabs / cellules fusionnées verticalementFigures et tableaux LaTeX
enumitemPersonnalisation des listesMise en forme du texte et listes LaTeX
xcolorDéfinition de couleurIntroduit dans ce chapitre
listingsComposition du codeIntroduit dans ce chapitre
hyperrefLiens hypertextes et signetsRéférences croisées et gestion de la bibliographie LaTeX
biblatexRéférences (approche moderne)Références croisées et gestion de la bibliographie LaTeX
floatPlacement 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

% Aucun paramètre : raccourcir une longue commande
\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
}
CommandeObjectifRemarque
\newcommandDéfinir une nouvelle commandeLe nom de la commande ne doit pas entrer en conflit avec les commandes existantes
\renewcommandRedéfinir une commande existanteÀ utiliser lors de la modification des styles par défaut ; soyez prudent avec les commandes de base
\newenvironmentDéfinir un nouvel environnementSyntaxe identique à ci-dessus ; fournir le code de début et de fin

Apprenons aussi la syntaxe des environnements personnalisés:

Exemple: environnement personnalisé "Note"

\newenvironment{note}                 % Nom de l'environnement
  {\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

\documentclass{ctexart}
\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
}

listings 代码块的编译效果

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

\documentclass{ctexart}
\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 pageForce \clearpage avant chaque fichier
Fonctionne avec \includeonlyNon pris en chargePris en charge ; compile uniquement les chapitres spécifiés (un excellent outil d'accélération)
Granularité applicableTout 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'erreurSignificationGestion
Séquence de contrôle non définieLa commande n'existe pas : erreur d'orthographe ou paquet manquantVérifiez l'orthographe par rapport au numéro de ligne ; confirmez que le paquet est chargé
Missing $ insertedUne commande mathématique apparaît en mode textePlacez _ ^ \alpha etc. à l'intérieur de $
File 'xxx' not foundFichier ou paquet introuvableVérifiez le chemin ; tlmgr install xxx
Argument fugitifEnvironnement non fermé (\end manquant)Ajoutez \end{...} en fonction du numéro de ligne
Erreur LaTeX : environnement xxx non définiUtilisation d'un environnement non définiVérifiez l'orthographe de l'environnement et du paquet
! Arrêt d'urgenceCompilation interrompue complètementRemontez 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é

BesoinSolution
Réduire la saisie répétée\newcommand définit des commandes et des environnements
Coller le codelistings + \lstset style global
Découpage de grands documents\input (fragment) / \include (niveau chapitre)
Compilation en un cliclatexmk -xelatex
DébogageLire le numéro de ligne de la première erreur ! dans le journal
Autres extensions