Différences

Ci-dessous, les différences entre deux révisions de la page.

--- 3_domaines_specialises:informatique:ecrire_en_mode_verbatim [2019/03/22 23:45] – Renommage des sections de base: correction des liens internes. jejust
+++ 4_domaines_specialises:informatique:ecrire_en_mode_verbatim [2021/11/09 15:16] (Version actuelle) – Ajout d'explications sur le verbatim. jejust
@@ Ligne 1: / Ligne 1: @@
 ====== Comment écrire en mode verbatim? ======
+Dans certains domaines, notamment en informatique, on a besoin de citer du texte
+comportant beaucoup de [[3_composition:texte:symboles:caracteres:caracteres_reserves|caractères spéciaux pour LaTeX]]
+(''&'', ''_'', ''\''...).
+Le cas extrême se présentera si vous écrivez un document **sur** LaTeX **en** LaTeX.
+Vous aurez besoin de citer des noms de commandes, de donner des bouts de code...
+Dans le jargon LaTeX, citer du texte sans interpréter ce qu'il contient se dit
+« écrire en verbatim », ce qui veut dire [[wpfr>Verbatim|mot pour mot]] en latin.
@@ Ligne 15: / Ligne 24: @@
 $\Reponse$  L'environnement ''alltt'' du package du même nom [[ctanpkg>alltt]]
-(package dû à J. Braams) est une autre solution. À l'intérieur de
+(package dû à Johannes Braams) est une autre solution. À l'intérieur de
 cet environnement, le caractère ''\'' et les accolades conservent leur
 signification, et il est donc possible d'inclure des commandes <latex>\LaTeX</latex> dans un
 environnement ''alltt''. Cela permet en particulier d'inclure un fichier en
-verbatim, à condition qu'il ne contienne par d'accolades.
+verbatim, à condition qu'il ne contienne pas d'accolades.
 Exemple d'utilisation de [[ctanpkg>alltt]]:
@@ Ligne 26: / Ligne 35: @@
 <code latex>
 \documentclass{article}
-\usepackage[french]{babel}
+  \usepackage[french]{babel}
-\usepackage{alltt}
+  \usepackage{alltt}
 \begin{document}
 \begin{alltt}
  Notez la différence subtile entre
- $f(x)$ et \(f(x)\) gr\^ace à
+ $f(x)$ et \(f(x)\) grâce à
  l'utilisation de la \og{}contre-oblique\fg.
 \end{alltt}
@@ Ligne 41: / Ligne 50: @@
 <latexdoc>
 \documentclass{article}
-\usepackage{alltt}
+  \usepackage{alltt}
-\usepackage[french]{babel}
+  \usepackage[french]{babel}
+  \pagestyle{empty}
 \begin{document}
-\thispagestyle{empty}
 \begin{alltt}
  Notez la différence subtile entre
- $f(x)$ et \(f(x)\) gr\^ace à
+ $f(x)$ et \(f(x)\) grâce à
  l'utilisation de la \og{}contre-oblique\fg.
 \end{alltt}
@@ Ligne 56: / Ligne 66: @@
-$\Reponse$  Le package [[ctanpkg>moreverb]] va un peu plus loin, en permettant
+$\Reponse$  L'extension [[ctanpkg>moreverb]] va un peu plus loin, en permettant
-notamment de numéroter les lignes de l'environnement ''verbatim''. Il
+notamment de numéroter les lignes de l'environnement ''verbatim''. Elle permet aussi
-permet aussi d'inclure un fichier, bien sûr, mais aussi et surtout
+d'inclure un fichier, bien sûr, mais aussi et surtout d'écrire dans un fichier.
-d'écrire dans un fichier.
 Pour inclure un fichier, on saisira par exemple:
@@ Ligne 74: / Ligne 83: @@
-$\Reponse$  Le package [[ctanpkg>fancyvrb]] permet d'écrire du texte verbatim
+$\Reponse$  L'extension [[ctanpkg>fancyvrb]] permet d'écrire du texte verbatim
-encadré, en couleur et même dans lequel certaines commandes sont
+encadré, en couleur et même dans lequel certaines commandes sont interprétées.
-interprétées. [[2_composition:texte:paragraphes:texte_verbatim|Voir cette page]] pour un exemple.
+[[3_composition:texte:paragraphes:texte_verbatim|Voir cette page]] pour un exemple.
-$\Reponse$  Le package [[ctanpkg>sverb|sverb]] de M. Wooding, propose un environnement ''listing''.
+$\Reponse$  L'extension [[ctanpkg>sverb]] de Mark Wooding, propose un environnement ''listing''.
-$\Reponse$  Le package [[ctanpkg>verbtext|verbtext]], permet de numéroter les lignes
+$\Reponse$  L'extension [[ctanpkg>verbtext]], permet de numéroter les lignes
 d'un texte verbatim, et d'interpréter certaines commandes.
-$\Reponse$  On peut aussi essayer le package [[ctanpkg>verbasef|verbasef]] (//verbatim
+$\Reponse$  On peut aussi essayer l'extension [[ctanpkg>verbasef]] (//verbatim
 automatic segmentation of external files//). Il utilise l'environnement ''figure''.