Motivation

L'activité H5P "papi Jo" est basée sur l'activité semi-officielle H5P "Advanced Fill in the Blanks" de Sebastian Rettig. Les corrections de bogues et les améliorations énumérées ci-dessous ont été soumises à Sebastian qui les a globalement approuvées. Mon objectif initial était d'inciter Sebastian à inclure mes suggestions dans sa distribution. Cependant, par manque de temps, cela n'est pas possible pour le moment, j'ai donc créé mon propre fork en attendant.

Corrections de bogues

  1. Faire en sorte que les positions de l'élément à mettre en surbrillance par rapport au blanc "persistent" lors de l'édition d'un contenu. Il fallait simplement ajouter des guillemets aux valeurs dans Semantics, par exemple "value" : "-1", "label" : "- 1 (juste avant le blanc)".

  2. Afficher le dialogue de confirmation lors de la "Vérification". Cette option n'est pas compatible avec l'option "Vérifier automatiquement les réponses après la saisie". Solution : utilisez la bibliothèque ShowWhen 'papi Jo' pour ne pas afficher cette option.

Améliorations & nouvelles fonctionnalités

  1. Dans le fichier semantics, j'ai réglé l'affichage du feedback global et des réponses incorrectes en mode "non développé" par défaut pour éviter d'encombrer l'écran d'édition, en particulier lorsque de nombreuses réponses incorrectes sont proposées.

  2. Ajout d'un champ "Feedback pour la bonne réponse", qui peut être utilisé pour confirmer que l'utilisateur a trouvé la bonne réponse afin de le conforter dans son choix.

  3. Ajout d'une option d'expression régulière pour les mauvaises réponses avec 2 caractéristiques principales : détecter les mauvaises réponses ou parties de réponses et détecter les mots manquants. C'est la plus importante innovation.

  4. Ajout d'une option pour l'affichage des solutions permettant de n'afficher que la première réponse correcte OU toutes les alternatives (comme dans l'activité originale H5P Blanks).
  5. Permettre l'utilisation de la barre oblique dans les réponses correctes, par exemple 10/20, en "échappant" la barre oblique comme ceci 10\\/20.

  6. Pour les champs de saisie de la solution correcte et de l'affichage, adapter la taille du champ à la réponse contenue (nécessite une police monospace pour un affichage correct, voir le point 9 ci-dessous).

  7. Divers ajustements des coches, des croix et des icônes d'indice pour un affichage plus esthétique (subjectif, bien sûr).

  8. Cacher l'icône d'indice si la réponse à la lacune est correcte OU si la réponse à la lacune montre la solution.

  9. Ajout d'un lien vers la police Google Font 'Roboto Mono' dans le fichier CSS. Ceci est nécessaire pour afficher un meilleur affichage du texte dans les champs de saisie. La police "Roboto Mono" est bien plus esthétique que les polices Courier ou monospace disponibles par défaut.

  10. Ajout d'une fonction de redimensionnement automatique du champ de texte pour le champ de saisie (sur la liste TODO de Sebastian). Elle fonctionne bien, sauf lorsqu'on utilise la touche Del ou Backspace pour effacer des caractères déjà saisis, et devra donc être affinée.

Tutoriel

L'activité H5P "papi Jo" étant basée sur l'activité H5P "Advanced Fill in the Blanks", veuillez vous référer au tutoriel original (en anglais) dont le lien figure ci-dessus. Dans ce tutoriel, je me contenterai d'ajouter les informations nécessaires relatives aux différences entre les 2 versions. Je me réfère dans mon tutoriel au contenu du fichier Advanced Fill in the Blanks 'papi Jo' Modèle.

Step 1: Topic

Step 2: Creating Advanced Fill in the Blanks

Step 3: Advanced Fill in the Blanks editor

Step 4: Consigne

Which compound adjective would you use to describe the following:

Step 4b: Options générales

Mode de réponse: L'utilisateur tape les réponses
Utiliser les expressions régulières: Cochez cette case

Step 5: Texte à trous

Sous Texte à trous, nous allons taper le texte de l'exercice comme ceci :

a little girl who was born !!5 (five)!! !!years!! ago? a ____ girl

Nous devons maintenant définir toutes les alternatives correctes possibles ainsi que les alternatives incorrectes potentielles. Ceci est fait dans la section "Paramétrage des Blancs utilisés dans le texte".

1.- Pour le premier blanc, nous ajouterons la réponse ci-dessous comme réponse correcte : 

  • Réponse correcte: five-year-old/5-year-old
  • Indice: vous pouvez laisser ce champ vide ou bien y mettre un indice
  • Feedback pour la réponse correcte: Correct, a little girl that is 5 years old is a 5-year-old girl.
    Ce feedback doit confirmer que l'utilisateur a trouvé la bonne réponse afin de le conforter dans son choix. Nouvelle fonctionnalité de la version 'papi Jo'.

2.- Et en dessous, ajoutez une série de réponses incorrectes et un message de feedback lorsque l'une de ces réponses est choisie :
Note.- Lorsque vous utilisez l'option Expressions régulières pour la détection de réponses potentiellement incorrectes, vous avez le choix de détecter a) la présence d'éléments incorrects ou b) l'absence d'éléments corrects nécessaires dans la réponse de l'étudiant. Dans le libellé de la réponse incorrecte, les éléments nécessaires absents sont précédés d'un double signe moins, par exemple --year.

Voici quelques exemples. Vous pouvez voir la liste complète de ces réponses incorrectes potentielles ainsi que les messages de feedback associés si vous téléchargez le modèle H5P ADV FITB 'papi Jo' sur votre ordinateur.

Réponse incorrecte n° 0 : détecter la présence d'un mot incorrect dans la réponse de l'élève

libellé de la réponse incorrecte : (little|small)
Feedback: Of course, that's a little girl, but you must write a compound adjective in your answer.

Nous utilisons ici une expression régulière très simple, Alternance avec le symbole de la barre verticale. Les parenthèses sont ici facultatives.

Réponse incorrecte n° 1 : détecter l'absence du mot "year" dans la réponse de l'étudiant.

libellé de la réponse incorrecte : --year
Feedback: You need to use the noun "year" to form this compound adjective.

Veuillez noter que l'utilisation du double signe moins ne fait pas partie de la gamme des expressions régulières conventionnelles. Il est utilisé pour simplifier les choses. Le double signe moins peut être suivi de n'importe quelle expression régulière valide.

Réponse incorrecte n° 2 : détecter l'absence des mots '5' ou 'five' dans la réponse de l'étudiant.

libellé de la réponse incorrecte : --(5|five)
Feedback: You must specify the age of the little girl in your compound adjective (use 5 or five).

Réponse incorrecte n° 3 : détecter la présence incorrecte d'espaces supplémentaires de part et d'autre du signe du trait d'union dans l'adjectif composé

libellé de la réponse incorrecte : ( -|- )
Feedback: Do not put a space (or any other punctuation mark) before or after the hyphen character (-).

Réponse incorrecte n° 3 : Détecter la présence incorrecte de mots supplémentaires de part et d'autre de l'adjectif composé.

libellé de la réponse incorrecte : (-.*-.*)\\s(\\w+)|\\s(\\w+)(-.*-.*)
Feedback: Have you not put one word too many at the beginning or at the end of your answer?

Note.- Il s'agit ici d'une expression régulière très complexe. Vous n'aurez probablement jamais à aller aussi loin, à moins que vous ne soyez ou ne deveniez un champion des expressions régulières !

Options supplémentaires

Vous pouvez également définir quelle partie du texte sera mise en évidence lors de l'affichage du feedback. Cela se fait en mettant le mot entre (" !!"). Par exemple :

Le fait de placer les mots "5 (cinq)" entre !! signifie que ce mot sera mis en évidence lorsque nous afficherons le feedback pour la première série de réponses incorrectes.

Vous devriez maintenant voir quelque chose comme ceci :

a little girl who was born !!5 (five)!! !!years!! ago? a ____ girl

Étape 6 : Ajouter d'autres phrases

Procédez comme pour la phrase 1

Étape 7 : Options générales

Nous pouvons maintenant revenir aux options générales pour sélectionner d'autres options..

Mode de réponse

Si vous n'utilisez pas l'option Expressions régulières, vous pouvez sélectionner L'utilisateur choisit parmi les options comme pour l'activité ADV FITB originale.

Comportement lorsque l'utilisateur fait une faute d'orthographe
Considérez-la comme une bonne réponse
Avertir l'utilisateur de l'erreur
Considérez que c'est vraiment une erreur

Ces 3 options sont compatibles avec l'option Expressions régulières. Je recommande de sélectionner l'option Avertir l'utilisateur de l'erreur.

Sensible à la casse

Cette option est également compatible avec l'option Expressions régulières.

Vérifier les réponses instantanément dès la saisie.
Activer le bouton "Voir la correction"
Obliger l'utilisateur à remplir tous les blancs avant de voir la correction.
Activer le bouton "Recommencer"

Ces 4 options fonctionnent de la même manière que dans l'activité ADV FITB originale.

Afficher toutes les solutions alternatives

Si vos blancs ont plus d'une solution correcte, cochez cette case pour afficher toutes les alternatives lors de l'affichage des solutions. Il s'agit d'une nouvelle option "papi Jo".

Veuillez noter que la longueur des blancs est automatiquement adaptée au texte qu'ils contiennent, lors de la vérification des réponses ou de l'affichage des solutions. Ceci est possible car le texte à l'intérieur des blancs utilise une police à largeur fixe de Google, 'Roboto Mono'.

Liste des fragments de feedback (snippets)

Si vous créez un certain nombre de phrases similaires avec des blancs dans une activité H5P ADV FITB, la fonction Snippets peut vous être très utile. Les snippets sont des textes qui peuvent être réutilisés dans les textes de feedback en insérant @snippetname dans les textes de feedback. Par exemple, sur la capture d'écran Paramétrage des blancs plus haut, dans le champ de feedback de la 2e mauvaise réponse (--year) comporte un lien vers ce snippet @compound, inséré comme ceci:

et donc si l'élève omet le mot "year" dans sa réponse, le nom du snippet @compound sera remplacé par son texte "to form this compound adjective" et ce message de feedback d'erreur s'affichera: "You need to use the noun to form this compound adjective"! ATTENTION.- Dans le champ du Nom du snippet il ne faut pas taper le code @ ; ce code @ doit seulement être tapé dans le message de feedback. Il est possible d'additionner plusieurs snippets dans un même champ de feedback.

Comment utiliser les expressions régulières

Les expressions régulières sont un outil puissant pour analyser les réponses des élèves en vue de leur fournir des messages de feedback toujours plus pertinents pour faciliter leur apprentissage. Mais elles peuvent être assez difficiles à maîtriser. Bien sûr, vous pouvez toujours limiter les expressions régulières que vous saisissez pour les réponses incorrectes potentielles à quelques expressions simples.

Vous pouvez trouver de l'aide dans la documentation que j'ai écrite pour mon type de question Moodle Regexp ici bien que le système d'expressions régulières ne soit pas identique. Cette partie est la plus pertinente pour utiliser les expressions régulières dans H5P ADV FITB 'papi jo' : Détecter les mots ou chaînes de caractères manquants.

Pour une aide plus générale sur les expressions régulières, visitez ces sites :

En anglais

En français

Il n'existe malheureusement aucun mécanisme permettant de vérifier si vos expressions régulières sont valides dans l'éditeur d'activité de H5P. Le seul point qui est testé est de savoir si vos expressions ont une adéquation correcte entre les crochets et les parenthèses. Si une correspondance incorrecte est détectée, vous obtiendrez un message d'erreur lors de la sauvegarde de votre activité H5P. Quelque chose comme ceci :

ERROR!!! Your round or square brackets are not correctly balanced in the following regular expression(s):
Blank # 1 small|little)

Modifié le: lundi 27 novembre 2023, 15:00