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 : verbatim, comment 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}

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 comment.

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}
2_programmation/syntaxe/commentaires/mettre_en_commentaire_une_partie_du_source.txt · Dernière modification: 2021/03/29 14:12 par jejust
CC Attribution-Share Alike 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0