RoastPotatoes

Manuel de l'utilisateur

Version bêta – créer des exercices interactifs pour le Web

1. À quoi sert RoastPotatoes ?

RoastPotatoes vous aide à fabriquer des exercices pour vos élèves : associer des mots, répondre à un quiz, compléter un texte, remettre une phrase en ordre, faire des mots croisés ou placer des étiquettes sur une image.

Chaque exercice devient une page Web (un fichier avec l'extension .htm). Les élèves l'ouvrent dans leur navigateur (Chrome, Firefox, Edge…) et la page corrige toute seule : elle donne un score et des messages d'encouragement. Elle fonctionne même sans connexion Internet.

RoastPotatoes est construit dans l'esprit de Hot Potatoes 7.0.3 : mêmes types d'exercices, mêmes réglages, et il sait ouvrir vos anciens fichiers Hot Potatoes (voir le chapitre 11).

Les six outils

Deux sortes de fichiers

• Le fichier de travail (.jmt, .jqz, .jcl, .jmx ou .jcw) est votre brouillon. Vous le rouvrez dans RoastPotatoes pour modifier l'exercice. Gardez-le toujours : on ne peut pas modifier un exercice à partir de la page Web.
• La page Web (.htm) est ce que vous donnez aux élèves. Vous la fabriquez avec le bouton « Créer la page ».

2. Installer le programme

Windows

• RoastPotatoes-Installation-beta.exe : lancez-le et suivez les étapes (vous pouvez choisir le dossier d'installation). Le programme s'installe pour votre compte et apparaît dans le menu Démarrer.
• RoastPotatoes-Portable-beta.exe : il se lance directement, sans installation. Pratique sur une clé USB.

Linux (Debian, Ubuntu, MX Linux…)

• Fichier .deb : dans un terminal, tapez sudo apt install ./RoastPotatoes-beta-amd64.deb (dans le dossier du fichier). Le programme apparaît ensuite dans le menu, catégorie « Éducation ».
• AppImage : rendez le fichier exécutable (chmod +x RoastPotatoes-beta-x86_64.AppImage) puis lancez-le (./RoastPotatoes-beta-x86_64.AppImage) ou double-cliquez dessus.
• Archive .tar.gz : décompressez-la, puis lancez lancer-roastpotatoes.sh dans le dossier obtenu.

Dans un navigateur (sans installation)

Si le site de votre établissement propose la version en ligne, ouvrez simplement sa page index.html. Voir le chapitre 10.

3. Premiers pas : un exercice en 5 minutes

Nous allons fabriquer un exercice d'association : les couleurs en anglais et en français. Vous le trouverez déjà prêt dans le dossier exemples (fichier couleurs.jmt).

Étape 1 – Choisir l'outil

Au démarrage, la fenêtre d'accueil propose les six outils. Cliquez sur RMatch. Le bouton « Ouvrir un exercice… » en bas sert à rouvrir un fichier déjà fait, et le bouton « 📖 Manuel » ouvre ce manuel (on le retrouve aussi dans chaque éditeur : menu Aide → « Manuel de l'utilisateur »).

Étape 2 – Saisir l'exercice

1. Tapez le titre : Colours.
2. Dans le tableau, tapez les mots anglais dans la colonne de gauche et leur traduction dans la colonne de droite.
3. Le bouton « + Ajouter une paire » (en bas) ajoute une ligne ; « Supprimer », « Monter » et « Descendre » agissent sur la ligne sélectionnée.

Étape 3 – Écrire les consignes

Cliquez sur Configurer… (ou touche F8). Dans l'onglet « Titres/Consignes », tapez le sous-titre et les consignes que les élèves liront, par exemple Match each English colour with its French name. Validez avec « OK ». Le chapitre 7 explique tous les onglets.

Étape 4 – Enregistrer le fichier de travail

Cliquez sur Enregistrer (ou Ctrl+S) et choisissez un dossier et un nom, par exemple couleurs.jmt. C'est votre brouillon.

Étape 5 – Créer la page Web

Choisissez le format de la page dans la liste (par exemple « Glisser-déposer »), puis cliquez sur Créer la page. Le programme propose un nom (couleurs.htm, dans le même dossier) et ouvre la page dans votre navigateur pour que vous l'essayiez.

4. La fenêtre d'un éditeur

Tous les éditeurs se présentent de la même façon.

Le titre de la fenêtre se termine par une étoile (*) quand il y a des changements non enregistrés.

5. Les six outils

5.1 RMatch – associer

Convient aux mots et traductions, aux questions et réponses courtes, aux dates et événements, aux images et légendes…

• Colonne de gauche : les éléments fixes (les « questions »). Colonne de droite : les réponses, que l'élève doit rattacher.
• Case « Fixe » : une paire dont les deux cases « Fixe » sont cochées est déjà en place au départ (format glisser-déposer).
• Le texte peut contenir des images ou des sons (menu Insérer).

Les formats de page

Pour mélanger. Dans « Configurer » → « Autres », cochez « Mélanger les éléments de gauche ». Vous pouvez aussi limiter le nombre de paires affichées (« Limiter le nombre de questions affichées »).

5.2 RQuiz – questions

À gauche, la liste des questions ; à droite, le détail de la question choisie.

Les quatre types de questions

• Retour (feedback) : le message qui s'affiche quand l'élève choisit cette réponse (« Well done! », « No, a dog barks. »…).
• Indice : une aide que l'élève obtient avec le bouton « Hint ».
• Poids : l'importance de la question dans le score (100 par défaut).

Dans « Configurer » → « Autres », vous pouvez mélanger les questions, mélanger les réponses, limiter le nombre de questions affichées, respecter les majuscules…

5.3 RCloze – texte à trous

Tapez ou collez votre texte. Pour créer un trou : sélectionnez un mot, puis cliquez sur « Créer un trou ». Dans le texte, un trou s'écrit entre doubles crochets :

[[réponse|autre réponse acceptée||indice]]

• Les réponses acceptées sont séparées par une barre verticale | (par exemple [[sofa|couch]]).
• L'indice (facultatif) vient après deux barres ||. L'élève le voit en cliquant sur le petit bouton à côté du trou.
• « Retirer le trou » remet le mot ordinaire (le curseur doit être dans le trou).
• Le tableau du bas liste tous les trous : vous pouvez y modifier les réponses et les indices.

Les formats de page

Dans « Configurer » → « Autres », vous pouvez aussi remplacer les zones de saisie par des listes déroulantes, ajouter une liste des mots à placer, respecter les majuscules, et ajouter un clavier de caractères spéciaux (très utile pour les langues étrangères).

5.4 RMix – remettre en ordre

1. Écrivez les parties de la phrase dans le bon ordre, une par ligne. Les élèves les recevront mélangées.
2. Un raccourci : tapez la phrase entière dans la case du haut, puis cliquez sur « Découper en mots » (ou « Découper en lettres » pour un exercice sur un mot). La ponctuation devient une partie à part.
3. Si plusieurs ordres sont corrects, écrivez les autres phrases acceptées, une par ligne, avec les mêmes parties dans un autre ordre. Le programme vous avertit si une phrase ne correspond pas.

Deux formats de page : cliquer sur les parties (elles s'ajoutent à la phrase dans l'ordre des clics) ou glisser-déposer.

Plusieurs phrases dans le même exercice

La barre « Phrase : 1 / 1 » permet d'ajouter d'autres phrases (« + Ajouter une phrase ») : chacune a ses parties et ses autres phrases acceptées, la liste déroulante sert à passer de l'une à l'autre. Avec plusieurs phrases, « Créer la page (cliquer sur les parties) » fabrique une page qui les présente une par une, avec un compteur « Sentence 1 / 3 » et un message « Next sentence! » après chaque phrase réussie. Les boutons « <= » et « => » permettent de changer de phrase sans valider (ce qui est commencé est gardé), et le bouton « Finish » termine l'exercice même si des phrases ne sont pas faites (un avertissement s'affiche, il faut cliquer une deuxième fois) ; la note finale est la moyenne des phrases, une phrase non faite comptant 0. Ces textes se changent dans « Configurer » → « Messages ». Le glisser-déposer ne gère qu'une phrase. L'exemple trois-questions.jmx contient trois questions.

Dans le fichier .jmx, la première phrase est enregistrée comme d'habitude et les suivantes à la fin du fichier : Hot Potatoes peut l'ouvrir, mais il n'y verra que la première phrase.

5.5 RCross – mots croisés

Il y a deux façons de fabriquer la grille.

A. Générer la grille automatiquement

1. À droite, dans « Mots à placer », écrivez une ligne par mot : le mot, un point-virgule, puis sa définition. Exemple : LION ; The king of the jungle.
2. Cliquez sur « Générer la grille automatiquement ». Les mots sont croisés pour faire la plus petite grille possible. Si un mot ne peut pas se croiser avec les autres, le programme vous le dit : vous pourrez le placer à la main.

B. Remplir la grille à la main

• Cliquez dans une case et tapez les lettres. Les flèches déplacent le curseur ; la touche Entrée change le sens de saisie (→ ou ↓) ; Retour arrière et Suppr effacent ; la barre d'espace efface en avançant.
• Les cases noires sont les cases vides. « Lignes » et « Colonnes » changent la taille de la grille.

Les définitions se complètent automatiquement à droite : chaque mot de la grille apparaît avec son numéro, horizontalement ou verticalement. Tapez simplement la définition en face du mot.

5.6 RMap – image à zones

Les élèves glissent des étiquettes sur les bonnes zones d'une image (une carte, un schéma du corps humain, une photo…).

1. Cliquez sur Choisir l'image… et prenez une image (png, jpg, gif…).
2. Tracez une zone avec la souris : cliquez sur l'image, gardez le bouton enfoncé, puis relâchez.
3. Dans la liste de droite, tapez l'étiquette de la zone.
4. Pour corriger : cliquez sur une zone pour la sélectionner, déplacez-la avec la souris, ou agrandissez-la par le petit carré du coin. La touche Suppr la supprime. Vous pouvez aussi changer ses coordonnées dans la liste.
5. « Affichage » permet de zoomer ou de dézoomer l'image pour travailler plus précisément.

6. Le menu « Insérer » : liens, images, sons

Le menu Insérer ajoute des éléments à l'endroit du curseur dans le champ de texte où vous étiez (une question, une réponse, une étiquette, une définition, les consignes…). Cliquez d'abord dans ce champ, puis ouvrez le menu.

Les sons

• Choisissez un fichier mp3, ogg ou wav. Le plus sûr est le mp3.
• Le programme met dans le texte un bouton ► et copie le fichier dans un dossier sounds à côté de votre fichier de travail et de votre page.
• Le lecteur audio est déjà intégré à la page : rien d'autre à installer ou à copier.
• Le bouton « Insérer un son… » de la barre d'outils fait la même chose que Insérer → Son.

7. La fenêtre « Configurer »

Elle règle l'aspect et les textes de la page. Ouvrez-la avec le bouton Configurer… ou la touche F8. Elle comporte huit onglets, comme dans Hot Potatoes. Validez avec OK ; la croix en haut à droite ou la touche Échap ferme sans appliquer.

Enchaîner plusieurs exercices

Dans l'onglet « Boutons », cochez « Inclure le bouton Exercice suivant », puis cliquez sur Parcourir… et choisissez la page de l'exercice suivant. Le programme écrit l'adresse relative (par exemple unite2/exercice2.htm) : la chaîne continue à marcher quand vous déplacez tout le dossier sur un site, à condition de garder les fichiers à la même place les uns par rapport aux autres.

Les boutons du bas

8. Ce que voient les élèves

• Le bouton « Check » (Vérifier) corrige. La page affiche un message et un score en pourcentage. Chaque erreur fait baisser un peu le score : mieux vaut réfléchir avant de vérifier.
• Les indices (« Hint ») donnent une lettre ou une aide, mais coûtent des points.
• RQuiz : une question à la fois, avec des flèches pour passer à la suivante, ou toutes les questions ensemble.
• RMix, RMatch (glisser-déposer), RMap : l'élève déplace des éléments avec la souris ou le doigt.
• Dans RMix, un bouton « Recommencer » (à activer dans « Configurer » → « Boutons ») remet l'exercice à zéro, avec un nouveau mélange.
• Dans RQuiz, pour les réponses courtes, la ponctuation compte : « Yes I do » est faux si la réponse attendue est « Yes, I do. » (la partie fautive est surlignée en jaune). Pour un exercice où elle ne doit pas compter, cochez « Ignorer la ponctuation » dans « Configurer » → « Autres ».
• Dans tous les outils, un bouton « Finish » (« Configurer » → « Boutons », coché par défaut) permet à l'élève de terminer sans avoir tout fait : un avertissement s'affiche, et au second clic la note est calculée (ce qui n'est pas fait compte 0 ; dans RMix, seule la partie correcte de la phrase compte), envoyée s'il y a un envoi de résultats, et la page se verrouille. Sans ce bouton, la note n'est envoyée que lorsque tout est juste. Le texte de l'avertissement est dans « Messages ». Le bouton existe pour RQuiz, RCloze (texte à trous classique, Find-it A et B, JCdd), RMatch (listes déroulantes, glisser-déposer, JMH, JMS, JMSV), RCross et RMix (mots à cliquer ou à glisser, une ou plusieurs phrases) ; pas pour JGloss et JMem (pas de note envoyée à Stockpotatoes), ni pour RMap.
• Dans RQuiz, la touche Entrée dans une zone de réponse courte vérifie la réponse, comme un clic sur « Check ».
• Les pages sont de simples pages Web : elles s'ouvrent dans n'importe quel navigateur récent, sans connexion Internet si elles sont sur l'ordinateur ou sur une clé USB.

9. Mettre vos exercices sur un site

Une page produite par RoastPotatoes est un simple fichier : il suffit de la copier sur votre site.

1. Créez la page (.htm).
2. Copiez la page et, s'il existe, le dossier sounds et le dossier images sur le serveur, dans le même dossier.
3. Donnez aux élèves l'adresse de la page.

• Gardez les noms de fichiers simples : sans espace ni accent (par exemple couleurs.htm). Le programme nettoie déjà les noms des sons et des images.
• Les majuscules comptent sur la plupart des serveurs : Sounds et sounds ne sont pas le même dossier.
• Vous n'avez pas besoin de copier le fichier de travail (.jmt, etc.) : gardez-le chez vous.

10. La version en ligne

RoastPotatoes existe aussi dans une version pour navigateur, sans installation. C'est la même chose que le programme, avec quelques différences :

• Les fichiers de travail s'ouvrent depuis votre ordinateur (bouton « Ouvrir ») et s'enregistrent sur votre ordinateur : avec Chrome et Edge, l'enregistrement se fait directement ; avec les autres navigateurs, le fichier est téléchargé dans votre dossier « Téléchargements ».
• « Créer la page » télécharge la page. S'il y a des sons ou des images, vous recevez une archive .zip qui contient la page et ses dossiers sounds et images : décompressez-la, tout est prêt.
• Une petite fenêtre propose aussi un aperçu de la page créée.
• Les raccourcis Ctrl+W, N, Q et D appartiennent au navigateur et ne marchent pas ; les autres fonctionnent. Utilisez les menus.
• Vos réglages (« Configurer » → « Enregistrer ») sont gardés dans le navigateur, sur cet ordinateur. « Enregistrer sous » télécharge le fichier english8.cfg.
• Rien n'est envoyé sur Internet : le travail se fait entièrement dans votre navigateur.

Pour installer la version en ligne sur votre site

Décompressez RoastPotatoes-en-ligne.zip et copiez tout son contenu dans un dossier de votre serveur (par exemple /hp/). Ouvrez ensuite index.html dans le navigateur. Le fichier LISEZ-MOI.txt du dossier rappelle ces étapes.

11. Reprendre des exercices Hot Potatoes 7

• RoastPotatoes ouvre directement vos fichiers Hot Potatoes : .jmt, .jqz, .jcl, .jmx et .jcw. Le bouton « Ouvrir un exercice… » de l'accueil reconnaît le type tout seul.
• Les fichiers de travail que vous enregistrez gardent le format de Hot Potatoes 7.
• Les pages produites ont été comparées à celles de Hot Potatoes 7 sur les exemples fournis avec lui et avec ses add-ons (glisser-déposer horizontal, tri par catégories, jeu de mémoire, Find-it, listes déroulantes, glossaire) : sur ces exemples, elles sont identiques.
• Les liens de son de ces add-ons (play('fichier.mp3')) continuent de marcher.
• Une différence : les outils s'appellent ici RMatch, RQuiz, RCloze, RMix et RCross ; les extensions de fichiers restent les mêmes.

12. Questions fréquentes et problèmes

13. Raccourcis clavier

14. Petit glossaire

Les exemples fournis

Le dossier exemples contient des exercices tout prêts à ouvrir avec RoastPotatoes :

RoastPotatoes bêta – Manuel de l'utilisateur