Présenter des algorithmes, morceaux de programmes avec LaTeX
L’auteur de l’article, Erwan Duplessy, est enseignant de mathématiques (collège, lycée) au Lycée Denis Diderot de Nairobi, Kenya. http://www.diderot.ac.ke/
LaTeX est un système de composition de document très adapté aux documents scientifiques. Cet article s’adresse donc à des personnes connaissant déjà LaTeX, et désirant rédiger des algorithmes avec LaTeX. Mais, c’est aussi l’occasion pour ceux qui ne connaissent pas d’avoir un aperçu des possibilités de ce système. L’IREM de Lyon a d’ailleurs produit une brochure spécialement dédiée aux enseignants de collège et de lycée pour apprendre à utiliser LaTeX.
L’algorithmique et la programmation sont de plus en plus présentes dans les programmes de Mathématiques, au collège et au lycée [1]. On présente ci-dessous différents outils pour rédiger des algorithmes en LaTeX afin de préparer des activités, des feuilles d’exercices, des sujets de contrôles ou d’examens de niveau collège ou lycée.
NDLR : Dans la partie 4 Geotortue, 3 lignes débordent du cadre de l’article, tout en restant lisibles. Les lecteurs gênés par cette situation se reporteront au fichier PDF en fin d’article.
1 Pourquoi utiliser LaTeX ?
LaTeX permet de produire des documents de très haute qualité. On pourra comparer par exemple deux versions du sujet de Brevet Centre Étranger 2017, en particulier les courbes de l’exercice 2. Dans l’un, la copie d’écran des graphiques fait apparaître des signes « moins ». Dans l’autre, réalisé avec LaTeX, les graphiques sont correctement réalisés.
Un des avantages, de LaTeX par rapport à Word ou LibreOffice est la possibilité de dessiner directement dans LaTeX, sans passer par un autre logiciel. Prenons Scratch comme exemple. Pour rédiger une évaluation, on peut faire le programme avec Scratch, puis faire une copie d’écran et l’insérer dans Word. Le problème est que le rendu à l’impression en noir et blanc n’est pas terrible (voir par exemple le document d’accompagnement d’Eduscol). Cela pose des problèmes de lecture pour les élèves, en particulier les élèves à besoins particuliers. La méthode utilisant LaTeX permet d’obtenir une image de meilleur qualité, car elle est redessinée. L’argument est valable pour d’autres illustrations comme des représentations graphiques de fonctions ou de graphes.
Un autre avantage est de pouvoir modifier certains éléments du dessin (taille, couleur, police par exemple). Voici quatre variations pour un même script Scratch :
- Exemples Scratch (fichier source)
- Des exemples d’utilisation du package scratch commentés. Ce fichier peut servir de base pour obtenir les rendus suivants.
- exemples scratch (fichier pdf)
- Fichier pdf produit avec pdflatex à partir du fichier source joint précédemment.
 |
 |
 |
 |
Enfin, pour sortir du cadre de l’algorithmique, notons que les blocs Texte de Geogebra peuvent être écrit en LaTeX, et que les figures de Geogebra peuvent être exportés en code lisible par LaTeX.
Cinq langages d’algorithme ou de programmation sont présentés :
- le pseudo-code
- Scratch [2]
- Geotortue
- Algobox
- Python
Toutes les méthodes présentées se basent sur des packages déjà existants (un package est une extension de LaTeX permettant de réaliser des tâches particulières). Il n’y a que pour Geotortue où il a fallu utiliser les capacités de personnalisation d’un package.
Enfin, quelques commentaires sur les langages présentés :
- Ce sont ceux que j’utilise en classe !
- Il manque les programmes de type Blockly ou Sofus, et les algorithmes présentés sous forme de diagramme.
- Une nouvelle version de Scratch devrait sortir au premier trimestre 2018, mais la présentation devrait rester quasiment identique.
- Il y a une évolution de l’écriture des algorithmes pour le baccalauréat [3].
Pour chaque langage ou logiciels, on présente ce qui se rapproche d’un ECM (Exemple Complet Minimal). Ces exemples ont été testés avec Texmaker et MiKTeX [4].
NDLR : Ces exemples ont également été testés avec TeXLive 2017 et sont fonctionnels.
2 Le pseudo-code
Une autre méthode a déjà été décrite dans Mathématice par Alain Busser [5]. Ici, nous utilisons le package algorithm2e [6].
- \usepackage[utf8]{inputenc}
- \usepackage[T1]{fontenc}
- \usepackage{lmodern}
- \usepackage[french]{babel}
- \usepackage[linesnumbered, french]{algorithm2e}
- \begin{document}
- \begin{algorithm}
- $n \leftarrow0 $ \;
- $u \leftarrow 3081,45 $ \;
- \Tq{$u<k$}{
- $u \leftarrow 1,04 \times u $ \;
- $n \leftarrow n+1 $ \;
- }
- \end{algorithm}
- \end{document}
3 Scratch
Le package Scratch [7] [8] dessine des blocs ressemblant à ceux du logiciel Scratch. Une option du package permet de dessiner en noir et blanc (par défaut), en couleur ou en niveaux de gris. La documentation est en français. C’est ce package qui est utilisé dans les annales du brevet de l’APMEP.
- \usepackage[utf8]{inputenc}
- \usepackage[T1]{fontenc}
- \usepackage{lmodern}
- \usepackage[french]{babel}
- \usepackage{scratch}
- \begin{document}
- \begin{scratch}
- \blockinit{Quand \greenflag est cliqué}
- \blockmove{avancer de \ovalnum{40} }
- \blockvariable{mettre \selectmenu{angle} à \ovalnum{10}}
- \blockrepeat{répéter \ovalnum{3} fois}
- {
- \blockmove{tourner à \turnright{} de \ovalvariable{angle} degrés}
- \blockvariable{ajouter \ovalnum{20} à \selectmenu{angle}}
- }
- \end{scratch}
- \end{document}
4 Geotortue
Il n’existe pas de package spécifique à Geotortue. Je propose une solution qui est d’utiliser et de personnaliser le package listings [9]. Le package listings a des problèmes avec certains caractères. Une solution est proposé dans la partie Python qui utilise le même package.
- \usepackage[utf8]{inputenc}
- \usepackage[T1]{fontenc}
- \usepackage{lmodern}
- \usepackage[french]{babel}
- \usepackage{xcolor}
- \definecolor{geoKeyword}{RGB}{153,0,51}
- \definecolor{geoCommand}{RGB}{0,0,123}
- \definecolor{geoNumbercolor}{RGB}{181,181,181}
- \definecolor{geoText}{RGB}{255,0,192}
- \definecolor{geoFonction}{RGB}{51,51,51}
- \usepackage{listings}
- \lstdefinelanguage{Geotortue}{
- morekeywords={rep, remplis, si, tant_que, boucle, écris, à, aff, def, eff, init, pause, mg, photo, retiens, retourne, pour, fin, dis},
- morekeywords=[2]{av, re, td, tg, vg, ct, mt, lc, bc, crayon, palette, pvd, pvg, pvh, pvb, miroir, tlp, boussole, vise, imite, pvxy, pvxz, pvyz},
- morekeywords=[3]{sqrt, abs, reste, sin, cos, tan, asin, acos, atan, sinh, cosh, tanh, asinh, acosh, atanh, ln, log, round, floor, binom, rand, alea},
- morestring=[b][\color{geoText}]",
- }
- \renewcommand*\thelstnumber{\the\value{lstnumber}>}
- \lstdefinestyle{numbers}{
- numbers=left,
- stepnumber=1,
- xleftmargin=2em,
- numbersep=2pt,
- }
- \lstdefinestyle{mygeotortue}{
- language=Geotortue,
- basicstyle=\ttfamily,
- }
- \begin{document}
- \begin{lstlisting}[language=Geotortue, style=mygeotortue, style=numbers]
- pour carre
- rep 2 [av 8 ; td 90 ; av sqrt(64) ; td 90]
- fin
- \end{lstlisting}
- \end{document}
5 Algobox
Depuis le début du mois de septembre 2017, un package algobox [10] pour LaTeX est disponible. Un export depuis le logiciel Algobox était déjà possible, mais il fournissait un code assez long. Avec le package, il suffit de copier-coller dans l’éditeur depuis le logiciel Algobox, puis de modifier un peu le code.
- \usepackage{lmodern}
- \usepackage[french]{babel}
- \usepackage{algobox}
- \begin{document}
- \begin{algobox}
- \; \VARIABLES
- \; k \ESTDUTYPE NOMBRE
- \; n \ESTDUTYPE NOMBRE
- \; p \ESTDUTYPE NOMBRE
- \; \DEBUTALGORITHME
- \; \POUR k \ALLANTDE 1 \A 5
- \; \DEBUTPOUR
- \; n \PRENDLAVALEUR 2*k
- \; p \PRENDLAVALEUR k*n-4
- \; \AFFICHER p
- \; \FINPOUR
- \; \FINALGORITHME
- \end{algobox}
- \end{document}
6 Python
Je ne donne qu’un petit exemple car il est assez facile de trouver des méthodes. Le package listings ne gère pas très bien l’encodage UTF8 ce qui explique la nécessité de la dizaine de lignes contenant les caractères accentués.
Cette façon de rédiger est valable pour la plupart des langages de programmation car le package listings connaît des dizaines de langages (par exemple Caml, Matlab, HTML, Ruby...)
- \usepackage[utf8]{inputenc}
- \usepackage[T1]{fontenc}
- \usepackage{lmodern}
- \usepackage[french]{babel}
- \usepackage{xcolor}
- \usepackage{listings}
- \lstset{
- literate=
- {á}{{\'a}}1 {é}{{\'e}}1 {í}{{\'i}}1 {ó}{{\'o}}1 {ú}{{\'u}}1
- {Á}{{\'A}}1 {É}{{\'E}}1 {Í}{{\'I}}1 {Ó}{{\'O}}1 {Ú}{{\'U}}1
- {à}{{\`a}}1 {è}{{\`e}}1 {ì}{{\`i}}1 {ò}{{\`o}}1 {ù}{{\`u}}1
- {À}{{\`A}}1 {È}{{\'E}}1 {Ì}{{\`I}}1 {Ò}{{\`O}}1 {Ù}{{\`U}}1
- {ä}{{\"a}}1 {ë}{{\"e}}1 {ï}{{\"i}}1 {ö}{{\"o}}1 {ü}{{\"u}}1
- {Ä}{{\"A}}1 {Ë}{{\"E}}1 {Ï}{{\"I}}1 {Ö}{{\"O}}1 {Ü}{{\"U}}1
- {â}{{\^a}}1 {ê}{{\^e}}1 {î}{{\^i}}1 {ô}{{\^o}}1 {û}{{\^u}}1
- {Â}{{\^A}}1 {Ê}{{\^E}}1 {Î}{{\^I}}1 {Ô}{{\^O}}1 {Û}{{\^U}}1
- {œ}{{\oe}}1 {Œ}{{\OE}}1 {æ}{{\ae}}1 {Æ}{{\AE}}1 {ß}{{\ss}}1
- {ű}{{\H{u}}}1 {Ű}{{\H{U}}}1 {ő}{{\H{o}}}1 {Ő}{{\H{O}}}1
- {ç}{{\c c}}1 {Ç}{{\c C}}1 {ø}{{\o}}1 {å}{{\r a}}1 {Å}{{\r A}}1
- {€}{{\EUR}}1 {£}{{\pounds}}1
- }
- \lstdefinestyle{stylepython}{
- language=Python,
- basicstyle=\ttfamily,
- commentstyle=\color{green},
- keywordstyle=\color{blue},
- stringstyle=\color{olive},
- numberstyle=\tiny,
- numbers=left,
- stepnumber=1,
- numbersep=5pt
- }
- \begin{document}
- \begin{lstlisting}[style=stylepython]
- #convertir un triplet rgb en une chaîne héxadecimale
- def rgb2hex(red, green, blue):
- return '#%02x%02x%02x' % (red, green, blue)
- ma_couleur=rgb2hex(255,18,0)
- \end{lstlisting}
- \end{document}
notes
[1] Eduscol : https://cache.media.eduscol.education.fr/file/Mathematiques/73/3/Algorithmique_et_programmation_787733.pdf
[2] Le package scratch est disponible ici. Il est également inclus dans les distributions récentes de MikTeX (2.9) et de TeXLive (2017)
[4] MiKTeX est une suite de logiciels et packages implémentant LaTeX. Initialement prévue pour une installation sous Windows il est désormais possible de l’utiliser sous Mac et Linux. À noter : une version portable utilisable sur clé usb existe et satisfera sûrement le débutant en LaTeX.
[5] Source Alain Busser : Un paquet LaTeX pour l’algorithmique
[6] Source sur le CTAN : https://ctan.org/pkg/algorithm2e
[7] Source sur le CTAN : https://ctan.org/pkg/scratch
[8] Note du 22/02/2019 : ChristianTellechea vient de publier sur CTAN une version de son package pour Scratch 3 : https://www.ctan.org/pkg/scratch3
[9] Source sur le CTAN : https://ctan.org/pkg/listings
[10] Source sur le CTAN : https://ctan.org/pkg/algobox
Documents associés à l'article
ecm_variationfontscratch.tex |
(LaTeX - 833 octets)
Exercices d’algorithmique |
(PDF - 653.6 ko)
Réagir à cet article
À lire aussi ici
