Comment commenter une partie d'un fichier source LaTeX?

Avec le caractère %

Tout ce qui se trouve entre le caractère % et la fin de la ligne (inclus tous les deux) est ignoré dans le résultat produit par $\TeX$ et $\LaTeX$ .

Que va-t-on % vraiment
voir dans le document produit ?

$Que va-t-on % vraiment voir dans le document produit ?$

Bon nombre d'éditeurs offrent la possibilité de commenter des passages. Par exemple, “(un)comment-region” avec Emacs.

Si vous copiez-collez du texte depuis un document non-LaTeX, vérifiez que le signe % n'est pas utilisé, sinon une partie du contenu pourrait disparaître silencieusement:

Cher Jacques,

Je suis 100 % d'accord avec vous. Mais il faudra
mettre devant...

$Cher Jacques, Je suis 100 % d'accord avec vous. Mais il faudra mettre devant...$

Pour retrouver le texte original, vous devrez protéger le signe % avec une barre oblique inversée:

Cher Jacques,
 
Je suis 100 \% d'accord avec vous. Mais il faudra
mettre devant...

Avec un environnement “comment”

Plusieurs extensions définissent un environnement comment: comment, verbatim et version. Par exemple :

\documentclass{article}
  \usepackage{comment}
 
\begin{document}
 
\begin{comment}
Comme ce texte se trouve dans 
l'environnement \texttt{comment},
il ne reste
\end{comment}
rien !
 
\end{document}

$\documentclass{article} \usepackage{comment} \pagestyle{empty} \begin{document} \begin{comment} Comme ce texte ce trouve dans l'environnement \texttt{comment}, il ne reste \end{comment} rien ! \end{document}$

Il existe aussi le package optional, qui permet de faire apparaître ou non du texte en fonction d'options passées au package. Malheureusement, il n'est pas très robuste, notamment il ne fonctionne pas avec du contenu verbatim.

Il est donc déconseillé de s'en servir pour mettre de contenu en commentaire.

Avec une évaluation conditionnelle

Classique et de bon goût, l'évaluation conditionnelle permet de mettre en commentaire sans se soucier de l'imbrication des accolades. Elle est cependant moins puissante que les extensions qui créent un environnement dédié pour les commentaires.

Pour effectuer une évaluation conditionnelle, on peut utiliser l'extension ifthen sous $\LaTeX$ et la commande \iffalse avec Plain $\TeX$ .

Exemple en Plain $\TeX$ :

\iffalse
Ceci est en commentaire sous Plain \TeX{}.
\fi

Exemple en $\LaTeX$ :

\usepackage{ifthen}
 
Regardez comme c'est simple
\ifthenelse{\boolean{false}}
{Ne pas oublier le \usepackage{ifthen}
pour cette commande sous \LaTeX{}}{}%
de faire disparaître du texte!

$\documentclass{article} \usepackage{ifthen} \pagestyle{empty} \begin{document} Regardez comme c'est simple \ifthenelse{\boolean{false}} {Ne pas oublier le \usepackage{ifthen} pour cette commande sous \LaTeX{}}{}% de faire disparaître du texte! \end{document}$

Dans ce dernier exemple, faites bien attention à utiliser le % pour mettre en commentaire la fin de ligne après \ifthenelse. Si vous l'oubliez, vous aurez une espace en trop dans le rendu final, entre « $simple$ » et « $de faire$ »:

\usepackage{ifthen}
 
Regardez comme c'est simple
\ifthenelse{\boolean{false}}
{Ne pas oublier le \usepackage{ifthen}
pour cette commande sous \LaTeX{}}{}
de faire disparaître du texte!

$\documentclass{article} \usepackage{ifthen} \pagestyle{empty} \begin{document} Regardez comme c'est simple \ifthenelse{\boolean{false}} {Ne pas oublier le \usepackage{ifthen} pour cette commande sous \LaTeX{}}{} de faire disparaître du texte! \end{document}$

Table des matières

Comment commenter une partie d'un fichier source LaTeX?

Avec le caractère %

Avec un environnement “comment”

Avec une évaluation conditionnelle