L'environnement listing est proposé dans l'extentsion moreverb et permet d'insérer le listing de programme dans un document LaTeX. Cet environnement supporte la gestion des tabulations et la numérotation des lignes de code. Voici la forme générale de l'environnement.
| | \begin{listing}[Intervalle]{PremiereLigne} | | | | \end{listing} |
|
listing l12.9 L'environnement listing
Le paramètre PremiereLigne de l'environnement précise le numéro qu'il faut donner à la première ligne de code. On peut ensuite préciser en option, un intervalle voulu pour ne pas que toutes les lignes soient numérotées. Prenons un exemple :
| | \begin{listing}[2]{10} | | z := 0 | | for x := 1 to MAX do | | begin | | write 'Hello World !' | | z := z + 1 | | end | | write z | | \end{listing} |
|
listing l12.10 Inclusion d'un listing
Dans notre exemple, on a précisé 10 pour le paramètre de l'environnement, ce qui fait que la première ligne de code est numérotée comme étant la dixième comme vous pouvez le voir sur la figure l12.6. Ensuite, on a utilisé l'option de l'environnement en spécifiant une valeur de 2, ce qui fait qu'un nouveau numéro de ligne apparaitra toutes les deux lignes.
Attention, l'option n'est pas un incrément qui s'ajoute au numéro de la première ligne, en effet, si on précise une valeur de n pour l'incrément, toutes les lignes multiples de n seront numérotées, ainsi, si dans l'exemple précédent on avait mis 3 au lieu de 2, voici ce que ça donnerait :
L'environnement listingcont
L'extension moreverb propose un autre environnement en plus de listing, il s'agit de listingcont. Cet environnement permet également d'insérer un listing dans un document.
L'environnement listingcont ne possède aucun paramètres ni options, il est à utiliser après un environnement listing et, comme on peut le lire dans son nom, permet de continuer un listing en préservant la numérotation déjà établie.
| 1 | | 2 | | 3 | | 4 | | 5 | | 6 | | 7 | | 8 | | 9 | | 10 | | 11 | | 12 | | 13 | | 14 | | 15 | | 16 | | 17 | | 18 |
| | \begin{listing}[2]{10} | | z := 0 | | for x := 1 to MAX do | | begin | | write 'Hello World !' | | z := z + 1 | | end | | write z | | \end{listing} | | | | Et maintenant la suite du programme : | | | | \begin{listingcont} | | if z > 10 then | | begin | | write | | end | | \end{listingcont} |
|
listing l12.11 L'environnement listingcont
Notez que si vous utilisez l'environnement listingcont sans avoir utilisé un environnement listing préalablement, celui-ci est équivalent à \begin{listing}[1]{1}.
Inclusion depuis un fichier
Enfin, l'extension moreverb propose une commande pour insérer un listing depuis un fichier externe. Voici par exemple comment insérer le fichier HelloWorld.java en commençant à numéroter à 1 et en numérotant les lignes multiples de 5.
| | \listinginput[5]{1}{HelloWorld.java} |
|
listing l12.12 La commande listinginput
