Coder une course aux nombres - mathalea/mathalea GitHub Wiki
Les courses aux nombres sont les exercices les plus simples à coder !
Imaginée par l’Unité INSERM-CEA de Neuroimagerie Cognitive, un centre de recherche de pointe en cognition mathématique, la Course aux Nombres est à l'origine destiné aux enfants de 4 à 8 ans, en particulier ceux atteints de dyscalculie. (voir sur le site officiel)
Suite à la mesure 12 du rapport VILLANI-TOROSSIAN qui incite à développer les automatismes de calcul à tous les âges et dans tous les domaines, de plus en plus d'académies s'emparent de ce principe et organisent des concours pour les cycles 2, 3 et 4 comme l'académie de Strasbourg et l'académie de Lyon.
MathALEA s'est aussi lancé dans la course ! (lol)
Les exercices dédiés aux courses aux nombres sont disponibles avec les autres dans le générateur d'exercices
Comment créer un exercice de Course aux Nombres en 6 étapes
Étape 1 : Récupérer la référence
- Consulter la liste des can existantes
- Vérifier que l'exercice qu'on veut créer n'existe pas encore
- Ajouter une ligne concernant l'exercice qu'on veut créer
- Noter la
RÉFÉRENCE
pour la suite
Étape 2 : Créer sa branche
Saisir les commandes suivantes dans un terminal en modifiant votre nom et la RÉFÉRENCE
de l'exercice de CaN que vous voulez créer :
git checkout master
(on se place sur lemaster
)git pull
(on le met à jour)git checkout -b monNom-RÉFÉRENCE
(on le copie pour créer notre nouvelle branche avec la syntaxe NomDeLaPersonne-ReferenceDeLExercice)
Remarque importante
Pour que les exercices dédiés aux courses aux nombres soient rangés au bon endroit dans le générateur d'exercice, il est impératif que le nom du fichier commence par can
.
Étape 3 : Créer le fichier
- Copier le modèle
src/js/exercices/beta/betaModèle00_simple_Course_au_Nombres.js
ou un exercice existant de CaN déjà présent dans le dossiersrc/js/exercices/can/
- Le coller dans le dossier
src/js/exercices/can
et le renommer avec laRÉFÉRENCE
choisie (RÉFÉRENCE.js).
Étape 4 : Le rendre accessible
- lancer un
pnpm run build:dicos
dans le terminal pour ajouter votre nouvel exercice au dictionnaire des exercices.
Étape 5 : Coder l'exercice
- Mettre votre énoncé dans
this.question
- Mettre votre correction dans
this.correction
- Mettre la réponse attendue dans
this.reponse
- Tester l'exercice en lançant dans un terminal
pnpm start
Par défaut, on compare des expressions littérales ou des nombres. Si vous voulez comparer autre chose (textes, fractions, longueurs par exemple, vous pouvez voir comment faire ici)
Étape 6 : Partager l'exercice
Pour partager votre travail et le rendre accessible aux autres, vous pouvez saisir les commandes suivantes dans un terminal :
git add RÉFÉRENCE.js
pour ajouter votre fichier à la liste de ceux qui seront pris en compte lors du prochain commitgit commit -m "ex: Ajout de la RÉFÉRENCE (+ description)"
enregistre vos modifications dans ce qu'on appelle un commitgit push origin nomDeLaBranche
(le nomDeLaBranche est le nom que vous avez choisi à l'étape 1) met en ligne votre travail- Nous en parler sur le Slack dans le canal #mathalea_programmation_exercices !