Dyris est un générateur d'exercices avec correction et évaluation automatiques. Basé sur le langage JavaScript, il s'installe, par exemple, sur une clé USB. Il peut évidemment et avantageusement être placé sur un serveur.
Il contient de nombreuses options et se paramètre facilement. Chacun peut y apporter son design personnel. Les questions sont posées les unes après les autres, soit dans l'ordre choisi par le professeur, soit au hasard parmi les questions disponibles. Les exercices se définissent dans le fichier donnees.js, divisé en deux parties : Les options et le questionnaire.
La sauvegarde des scores sur le serveur est une option, créée pour que les étudiants d'une même classe puissent comparer leurs résultats. Pour une évaluation, il est conseillé de rendre le fichier donnees.js illisible, on dit communément offusquer le code. De nombreuses applications web permettent de le faire. Les informations sensibles deviennent alors inaccessibles à l'étudiant qui consulterait le code.
Le plus simple est de modifier le fichier donnees.js avec un éditeur de texte. La structure de ce fichier ne nécessite pas de connaissance particulière en programmation. Le fichier donnees.js comporte deux parties :
Attention :
A la moindre erreur dans le fichier donnee.js, votre exercice ne fonctionnera pas. En lançant l'exercice, la barre de défilement apparaîtra mais rien ne se chargera! Donc testez votre exercice, au fur et à mesure que vous le complétez. Et si l'exercice ne se charge pas, il est possible qu'une question ne respecte pas la syntaxe correcte. Vérifiez les parenthèses, les guillemets, les points virgules...
A chaque modification du fichier donnees.js, vous devez l'enregistrer AU FORMAT TEXTE SEULEMENT avec l'encodage UTF-8 ou Unicode. Les autres formats engendreront des erreurs empêchant votre exercice de fonctionner correctement.
ajout("schemas/Chene_liege.jpg");
ajout("schemas/Chene_liege.JPG");
Vous devriez adopter les logiciels libres, passer au système GNU/Linux, plus fiable et pratique. Mais bon. Si vous êtes tout de même sous Windows, vous disposez :
Si vous utilisez Wordpad :
Certaines versions d'Internet Explorer bloque les programmes en JavaScript placés sur disque dur ou sur CD. Ce problème ne se pose pas pour un programme placé sur un serveur.
Solutions :
Les options se définissent dans le fichier donnees.js par un ensemble de fonctions. Elles sont facultatives si vous vous contentez des options par défaut.
mode_presentation("1");
Deux présentations sont possibles :
1 : Plusieurs thèmes peuvent être sélectionnés en cochant les cases correspondantes.
2 : Un seul thème peut être sélectionné en cliquant sur le bouton correspondant.
Le mode 1 est l'option par défaut.
mode_evaluation("1");
Deux évaluations sont possibles :
1 : C'est l'évaluation formative.
2 : C'est l'évaluation sommative.
Le mode 1 est l'option par défaut.
mode_sauvegarde("1");
Deux sauvegardes sont possibles.
1 : Pour enregistrer le score dans un cookie.
2 : Pour enregistrer le score dans un fichier, lorsque Dyris est placé sur un serveur
pourvu du module PHP.
Avec le mode 1, les enregistrements se font en local dans un cookie,
sauf si le navigateur est configuré pour refuser les cookies.
Avec le mode 2, les enregistrements se font dans le fichier scores.csv placé sur le serveur.
Attention à ce que ce fichier ait les droits d'accès en lecture et écriture.
Chaque ligne de ce fichier correspond à un enregistrement.
Au fil des sauvegardes, le fichier devient de plus en plus volumineux.
Il convient donc, de temps à autre, de le raccourcir avec un éditeur de texte.
Le mode 1 est l'option par défaut.
mel("adresse@serveur.fr");
Pour une évaluation sommative avec sauvegarde sur serveur, si une adresse mél est définie, alors un message d'avertissement sera envoyé à cette adresse pour chaque nouveau bilan enregistré.
titre_introduction("votre titre");
Indiquez, entre les guillemets, le titre qui s'affiche dans la page d'accueil. Supprimez cette ligne si vous ne voulez pas de titre. N'utilisez pas de guillemets dans votre titre car Dyris l'interprétera comme la fin de votre titre.
introduction("commentaire");
Indiquez, entre les guillemets, le commentaire qui s'affiche sous le titre. Supprimez cette ligne si vous ne voulez pas de commentaire.
nombre_questions("5","10","15");
Indiquez, entre les guillemets, les nombres de questions qui seront proposés dans la page d'accueil.
url_quitter("http://dyris.free.fr/");
Définissez ici l'adresse de la page vers laquelle vous souhaitez être redirigé lorsque vous cliquez sur le bouton QUITTER. Si cette adresse n'est pas définie, le bouton QUITTER n'apparaît pas.
bouton_sup("MODE D'EMPLOI","pages/mode_emploi.html");
bouton_sup("MODE D'EMPLOI","pages/mode_emploi.html","500","300");
Afin de donner des informations complémentaires, vous pouvez ajouter des boutons dans la page d'accueil. Ces boutons ouvrent des fenêtres contenant des pages au format HTML.
La fonction « bouton_sup() » prend un à quatre paramètres :
code("Pascal","W4AbQX");
code("Alice","ApG1Mh");
La fonction code(), facultative, permet de définir un identifiant
associé à un mot de passe.
Elle est appelée pour chaque utilisateur à définir.
L'accès à l'évaluation sera ainsi limité aux seuls utilisateurs autorisés.
Il est possible de définir un identifiant sans mot de passe. Dans ce cas, l'identifiant sera vérifié mais pas le mot de passe. Les deux écritures ci-dessous sont équivalentes.
code("Pascal","");
code("Pascal");
Il est possible de définir un mot de passe sans identifiant. Dans ce cas, le mot de passe sera vérifié mais pas l'identifiant.
code("","W4AbQX");
code("","ApG1Mh");
coef_rep_juste("3");
Indiquez, entre les guillemets, le coefficient correspondant à une réponse juste.
Vous devez écrire une valeur positive!
Si vous supprimez cette ligne, le coefficient par défaut est 1.
coef_rep_fausse("-1");
Indiquez, entre les guillemets, le coefficient correspondant à une réponse fausse.
Vous devez écrire une valeur négative ou nulle!
Si vous supprimez cette ligne, le coefficient par défaut est -0.5.
coef_rep_nulle("-0.5");
Indiquez, entre les guillemets, le coefficient correspondant à une réponse non fournie,
c'est à dire lorsque l'étudiant clique sur le bouton JE NE SAIS PAS.
Vous pouvez écrire une valeur négative ou positive!
Si vous supprimez cette ligne, le coefficient par défaut est 0.
note_sur("30");
La note sera ramené sur la valeur indiquée entre les guillemets. On lui attribue souvent la valeur 20.
Si vous supprimez cette ligne, la note est ramenée sur le nombre de questions que l'utilisateur a sélectionné.
Vous pouvez choisir l'appréciation à mettre selon la note obtenue par l'étudiant, la note étant ici exprimée sur 20. Par exemple, si vous voulez l'appréciation Résultat moyen pour une note comprise entre 10 et 12, vous devez écrire, dans le fichier donnees.js:
appreciation("10","12","Résultat moyen");
Remarque: Si l'étudiant obtient une note correspondant à plusieurs appréciations, la dernière appréciation est prioritaire. Par exemple, si l'étudiant a obtenu 12 et que le fichier donnees.js comporte:
appreciation("10","12","Résultat moyen");
appreciation("12","14","Bon travail");
Alors l'étudiant obtiendra comme appréciation: Bon travail.
Vous pouvez également mettre une appréciation lorsque l'étudiant quitte l'exercice avant d'avoir terminé:
non_termine("Vous avez quitté l'exercice sans avoir répondu à toutes les questions !");
Après avoir choisi vos options dans le fichier donnees.js, il vous faut définir le questionnaire. Il est généralement constitué d'un ensemble de questions regroupées par thèmes.
theme("nouveau thème");
Pour chaque thème dont vous indiquez le titre ici, vous allez écrire des blocs de question / réponses. Naturellement, si l'ensemble de votre questionnaire ne comporte qu'un seul thème, cette ligne est facultative.
question("Où vit le personnage principal de l'histoire?");
Pour changer l'énoncé de la question, modifiez le texte entre guillemets.
question("Où vit le personnage principal de l'histoire?//2");
Par défaut, le barème pour une question est de 1 point.
Un barème différent de 1 point se définit à la fin de l'énoncé.
Par exemple, pour une question notée sur 2 points, rajoutez //2 à la fin de l'énoncé.
question("Où vit le personnage principal de l'histoire?//a");
Suite à une question, plusieurs réponses seront proposées.
Ces réponses apparaîtront dans l'ordre où vous les écrivez, sauf si vous rajoutez //a
(a comme aléatoire) à la fin de l'énoncé. Dans ce cas, les réponses seront affichées dans un ordre aléatoire.
question("Où vit le personnage principal de l'histoire?//2a");
Bien sûr, une question peut être notée sur 2 points et comporter des réponses dans un ordre aléatoire. Attention toutefois : Le mode aléatoire ne fonctionne pas pour les réponses de type « cases à remplir ».
question("Où vit le personnage principal de l'histoire?");
reponse("[x] dans une petite maison, près de la forêt");
reponse("[ ] dans une petite maison, au bord de la rivière");
reponse("[ ] dans un magnifique château");
Les cases à cocher sont symbolisées par les caractères:
[x] ou [o] ou [*] si la case doit être cochée.
[ ] dans le cas contraire.
Il est indispensable de proposer au moins deux réponses par question. Une réponse au moins doit être juste.
question("Où vit le personnage principal de l'histoire?");
reponse("(o) dans une petite maison, près de la forêt");
reponse("( ) dans une petite maison, au bord de la rivière");
reponse("( ) dans un magnifique château");
Les boutons radio sont symbolisés par les caractères:
(o) ou (x) ou (*) si le bouton doit être coché.
( ) dans le cas contraire.
Il est indispensable de proposer au moins deux réponses par question. Une seule réponse doit être juste.
question("Où vit le personnage principal de l'histoire?");
reponse("dans une petite [maison||demeure], près de la [forêt]");
Le texte à compléter se met entre les caractères [ et ].
Dans le cas où plusieurs réponses justes sont possibles, elles sont séparées par les caractères ||.
question("Une figure géométrique est représentée ci-contre.");
reponse("Cette figure est un [cercle||*triangle*||carré||losange[v]");
[ et [v].
||.
*.
Les caractères [v] symbolisent la petite flèche sur laquelle cliquer pour dérouler la liste.
Du texte peut être inséré entre plusieurs réponses. Dans l'exemple suivant, la deuxième réponse comporte simplement du texte :
rep("La figure A est un [cercle||*triangle*||carré||losange[v]");
rep("Pour la deuxième figure, plusieurs réponses sont possibles...");
rep("La figure B est un [cercle||rond||disque]");
Ces outils, facultatifs quoique bien pratiques, peuvent être :
Un outil de communication peut être associé :
L'outil est défini par une fonction, laquelle peut être située à divers endroits du fichier donnee.js.
Il existe un ordre de priorité : Un outil défini pour une question est prioritaire sur celui défini pour le thème, lui-même prioritaire sur celui défini pour l'ensemble des thèmes. Par exemple, si une image est associé à un thème et une autre image associée à une question de ce thème, alors seule cette dernière image sera effectivement affichée, lorsque la question est posée.
question("Où vit le personnage principal de l'histoire?");
reponse("[x] dans une petite maison, près de la forêt");
reponse("[ ] dans une petite maison, au bord de la rivière");
reponse("[ ] dans un magnifique château");
ajout("schemas/image1.gif");
Pour changer l'image, modifiez le texte entre guillemets (dernière ligne). L'image :
Dans cet exemple, le dossier se nomme /schemas. Vous pouvez définir divers dossiers pour vos images.
Il est possible d'indiquer les dimensions des images. Par exemple, si vous souhaitez que l'image image1.gif soit affichée avec une largeur de 155 pixels, la hauteur étant calculée automatiquement pour conserver les proportions, écrivez :
ajout("schemas/image1.gif","155");
Si vous voulez également définir une hauteur, par exemple de 98 pixels, écrivez :
ajout("schemas/image1.gif","155","98");
Pour un fichier audio :
quest("A l'aide du lecteur audio ci-dessous, écoutez et comptez les lettres du mot épelé");
rep("Nombre de lettres : [4]");
ajout("sons/jupe.ogg");
Pour changer le fichier audio, modifiez le texte entre guillemets (dernière ligne). Les formats .mp3, .avi, .mkv et .ogg sont pris en charge.
Pour un fichier vidéo, les formats .mp4, .wav, et .webm sont pris en charge.
Vous pouvez définir toutes sortes de commentaires selon les réponses apportées par l'étudiant :
question("Combien y a-t-il de poissons?");
reponse("[ ] 4 poissons");
reponse("[ ] 5 poissons");
reponse("[x] 6 poissons");
reponse("[ ] 7 poissons");
ajout("schemas/poissons.gif");
debut("Pour répondre à cette question, il te suffit juste de savoir compter.");
juste("C'est exact, tu as bien compté!");
faux("Attention quand tu comptes: Il faut être plus attentif!");
abandon("Dommage, cette question était facile...");
debut(" ... "); : Remplacez les trois points de suspension par le commentaire à afficher
au moment où la question est posée.
juste(" ... "); : Remplacez les trois points de suspension par le commentaire à afficher
si l'étudiant apporte une bonne réponse.
faux(" ... "); : Remplacez les trois points de suspension par le commentaire à afficher
si l'étudiant donne une mauvaise réponse.
abandon(" ... "); : Remplacez les trois points de suspension par le commentaire à afficher
si l'étudiant élude la question en cliquant sur le bouton JE NE SAIS PAS.
chronometre("20","Le temps imparti est écoulé!");
Pour afficher un chronomètre limitant le temps de réponse à une question, indiquez :
La fonction chronometre(), utilisée sans paramètre, limite le temps de réponse à la valeur par défaut.
question("Quel mois précède le mois de juillet?");
reponse("Le mois de [juin]");
aide("RAPPEL","pages/aide2.html","400","300");
Afin d'apporter un indice, un complément d'information ou un renseignement, vous pouvez ajouter au menu des boutons supplémentaires. Ces boutons :
La fonction « aide() », comme la fonction « bouton_sup() » pour la page d'accueil, prend un à quatre paramètres :
caracteres_speciaux("œ","€","Ø");
Indiquez la liste des caractères particuliers, difficiles à obtenir au clavier, utiles pour l'exercice. L'étudiant pourra insérer ces caractères dans les zones de texte à remplir, simplement en cliquant sur le bouton correspondant.
D'une manière générale, vous pouvez définir plusieurs énoncés séparés par les caractères ||.
L'énoncé effectivement affiché sera pris au hasard parmi les énoncés disponibles.
Ceci est valable pour les commentaires, les messages dans les boîtes de dialogue, les appréciations...
Exemple :
question("Quelle est la base du verbe abuser?||Saurais-tu m'écrire la base du verbe abuser?||Connais-tu la base du verbe abuser?");
Autre exemple :
juste("Excellent !||Bravo !||Bonne réponse !||C'est très bien!");
faux("Non...||Faux...||Erreur...||Inexact...||Dommage...");
Afin de rendre le fichier donnees.js plus court (donc plus rapide à charger ou à écrire), des raccourcis ont été créés.
Ainsi, vous pouvez écrire :
quest(... à la place de question(...
rep(... à la place de reponse(...
aj(... à la place de ajout(...
Les réponses comportent des caractères propres à Dyris. En conséquence, les caractères ci-dessous, que vous voudriez éventuellement obtenir, ne peuvent être écrits directement. Vous devez utiliser la désignation chiffrée correspondante. Les caractères fréquemment utilisés ont aussi une abréviation, plus facile à retenir, pouvant remplacer le code chiffré.
| Caractère | Code chiffré | Abréviation |
|---|---|---|
| " | " | " |
| < | < | < |
| > | > | > |
| [ | [ | Pas d'abréviation |
| ] | ] | Pas d'abréviation |
Ceci est très important. En effet, vous ne pouvez pas utiliser directement le signe <
dans vos questions ou réponses car Dyris le comprendra comme le début d'une balise HTML.
Vous devez donc utiliser l'abréviation <
Pour écrire les formules mathématiques, vous disposez de toutes les balises de la bibliothèque
MinMathJS,
disponible à l'adresse :
http://progmath.free.fr/minmathjs/index.html.
Par exemple, pour écrire une fraction, constituée d'un numérateur et d'un dénominateur :
<frac> et </frac>
<num> et </num>
<den> et </den>
quest("Quelle est la valeur de <frac><num>12</num><den>4</den></frac> ?");
rep("( ) 2");
rep("(o) 3");
Caractères Unicodes.
Dans le dossier outils se trouve le fichier Unicode.html. En ouvrant ce fichier avec un navigateur, vous obtenez une liste de caractères Unicodes. Parmi ces caractères, il y a des caractères grecs, des symboles mathématiques... Vous pouvez insérer les caractères de votre choix dans votre questionnaire, par un simple copier-coller.
Attention, vous pouvez avoir un problème à cause des apostrophes. En effet, plusieurs caractères permettent d'écrire l'apostrophe, lequel peut être incurvé ou droit.
En conséquence, si vous proposez la réponse :
rep("[C’est] à l'infirmerie qu'il faudra le soigner.");
Il se peut que l'étudiant réponde correctement mais que la réponse soit comptée fausse. La solution consiste à définir plusieurs apostrophes.
rep("[C'est||C’est] à l'infirmerie qu'il faudra le soigner.");
Ici, deux caractères différents sont utilisés pour écrire l'apostrophe. La réponse sera comptée juste si l'étudiant répond C'est ou C’est.
Ce fichier affiche un petit texte et une image pendant que l'exercice se charge. Vous pouvez le modifier pour lui donner le contenu que vous souhaitez.
En modifiant le fichier style.css, vous obtiendrez la présentation de votre choix. A condition de connaître la programmation des feuilles de style...
Si ce n'est pas le cas, vous pouvez tout de même modifier facilement les couleurs.
Elle sont définies par le caractère # suivi de six chiffres, correspondant au code hexadécimal de la couleur.
Vous pouvez retrouver le code hexadécimal d'une couleur avec un logiciel de dessin comme The Gimp, par exemple.
Pour vous aider, d'autres feuilles de style sont proposées dans le dossier outils. Pour utiliser le fichier style_2.css, par exemple, il suffit de renommer le fichier style.css (ou de l'effacer si vous n'en voulez plus) en style_3.css, puis de renommer style_2.css en style.css.
Il définit les textes utilisés par Dyris. Les titres des pages, les boutons, les messages qui s'affichent dans les fenêtres... Vous pouvez remplacer ces textes par ceux de votre choix.
Dyris peut donc être programmé dans n'importe quelle langue. Une traduction en anglais du fichier textes.js est proposée dans le dossier outils.
L'objet de ce paragraphe n'est pas de déterminer s'il est bon ou pas d'attribuer une note à un exercice. Nous vous indiquons simplement comment Dyris calcule la note attribuée à l'étudiant. Cependant, nous sommes parfaitement conscients que ce mode de calcul peut être amélioré (affichage du pourcentage de bonnes réponses, etc.) et nous sommes à l'écoute de vos suggestions et remarques.
Tout d'abord, comme cela a déjà été expliqué, celui qui crée un exercice peut attribuer le barème
de son choix, à n'importe quelle question. Par défaut, le barème pour une
question est de 1 point. Un barème différent de 1 point se définit
à la fin de l'énoncé. Par exemple, pour une question notée sur 2 points,
il faut rajouter //2 à la fin de l'énoncé:
question("Où vit le personnage principal de l'histoire?//2");
Ensuite, le calcul de la note s'effectue en fonction des coefficients définis dans le fichier donnees.js. Normalement, le coefficient pour une réponse juste est 1. Si ce n'est pas le cas, les coefficients sont adaptés en respectant les proportions, de sorte que la note maximale que peut obtenir l'étudiant soit égale au barème.
La note est donc égale au coefficient (éventuellement modifié) multiplié par le barème.
Pour les questions ouvertes, le barème est réparti sur les cases à remplir. Par exemple, dans le cas d'une question avec 4 cases à remplir, le barème pour chaque case est égal à barème/4.
La note finale (lorsque l'étudiant a répondu à toutes les questions) est ramené sur la valeur indiquée dans le fichier donnees.js. Et si l'étudiant abandonne l'exercice en cours de route, aucune note n'est donnée.
Dyris est écrit presque intégralement en HTML, CSS et JavaScript. Ces langages sont interprétés par votre navigateur (FireFox, Internet Explorer...). Pour l'option de sauvegarde sur serveur, une partie du code est également écrite en PHP.
Le logiciel comporte plusieurs fichiers :
Le questionnaire, défini dans le fichier donnees.js, est préchargé à l'avance. Les images associées aux questions ne sont chargées qu'au moment où les questions sont posées.