Ce texte est destiné à être lu avec le Bloc-Notes de Windows 3.xx. ----------------------------------------------------------------- Revizor One Light 1.25 est un logiciel (application) et un ensemble de fichiers texte regroupant des exercices de grammaire et de conjugaison simples. Ces exercices ont été créés à l'origine par un groupe d'enseignants du C.O. Foron sous forme de fiches autocorrectives à l'attention des élèves de classes faibles ou comme moyen de remédiation. Ce principe a été conservé dans la version informatisée. Revizor One Light est un "freeware": il est gratuit, peut être copié et distribué libre de droits. --------------Sommaire----------------- ---------------------------------------- 1. Description rapide de Revizor One Light 1.1 Modes principaux 1.2 Autres paramètres 1.3 Accès aux options du menu "Maître" 2. Installation 3. Créer des exercices pour Revizor One Light 4. Barèmes 5. Si ça ne marche pas... 6. Révisions/versions 7. Remerciements ---------------------------------------- ---------------------------------------- ---------------------------------------- 1. Description rapide de Revizor One Light ---------------------------------------- - l'élève choisit un exercice dans l'une des 3 catégories proposées (Grammaire, Conjugaison, Autres) - l'élève peut naviguer dans l'exercice en cliquant sur les différentes flèches. - l'élève peut en tout temps interrompre un exercice en cliquant sur la flèche "Retour" 1.1 Modes principaux Revizor One Light possède 2 modes de fonctionnement princiapaux, paramétrables depuis le menu Maître au moment du démarrage. Dans le mode "normal", l'élève n'est corrigé qu'à la fin d'un exercice. Le programme calcule le pourcentage de réussite et attribue une note à l'élève qui peut, s'il le désire, voir le détail de la correction et de l'attribution des points. Dans ce mode, le maötre peut également laisser à l'élève le loisir d'imprimer sa fiche de résultats; s'il le désire, le maître peut aussi conserver le résultat de l'élève sous forme de fichier texte (c. infra). Dans le mode "facile", l'élève est informé de la justesse de ses réponse immédiatement. Si ce mode est activé, les fonctions d'impression et de création d'un fichier de résultats sont désactivées. 1.2 Autres paramètres Il est possible de choisir la destination des fichiers résultats de l'élève depuis le menu "Maître" puis "Options". En fait, seule l'unité (lecteur, disque dur) de destination est paramétrable. Les fichiers élèves sont créés dans un répertoire nommé "revizor". La place de ce répertoire varie selon que l'unité choisie est celle qui porte l'application ou non. Si l'unité est celle de l'application, le chemin est: unité:\chemin_de_l'application\revizor\ Dans les autres cas, le chemin est: unité:\revizor\ Les fichiers élèves sont au format texte, bien qu'ils portent l'extension ".doc". Leur nom est constitué des 7 premiers caractères du nom de l'élève et du premier caractère de son prénom. ATTENTION: le mode de travail choisi (normal, facile, impression, sortie fichier) figure dans un fichier nommé "options.dat". S'il y a un fichier "option.dat" sur plusieurs unités accessibles, c'est celui de l'unité paramétrée qui prévaut. 1.3 Accès aux options du menu "Maître" Le mot de passe est "___" (3 caractères de soulignement). ---------------------------------------- 2. Installation ---------------------------------------- Se référer au fichier INSTALL.TXT pour la méthode d'installation. Indispensables au fonctionnement de Revizor, les fichiers: ROL.EXE RAIN.ICO REBB.ICO REVJ.ICO REVO.ICO SUN.ICO les répertroires: AUTRES CONJ GRAM dans le SYSTEM de windows: VBRUN300.DLL Les fichiers DRIVE.INI, OPTIONS.DAT ainsi que le répertoire REVIZOR sont recréés par le programme au besoin. ---------------------------------------- 3. Créer des exercices pour Revizor One Light ---------------------------------------- AVERTISSEMENT: les raccourcis clavier mentionnés ci-dessous se réfèrent au clavier "suisse romand". 3.1 Généralités Revizor One Light génère des exercices à partir de fichiers texte qui se trouvent dans l'un des 3 dossiers suivants: Gram, Conj, Autres. Des fichiers sont fournis dans Gram et Conj. De nouveaux fichiers peuvent être ajoutés dans ces 2 dossiers. Autres est prêt à recevoir des fichiers relevant d'autres thèmes. Les exercices de Revizor One Light peuvent être de 2 types différents: - l'élève donne sa réponse en cliquant sur un bouton: c'est le type 1 - l'élève donne sa réponse en la tapant dans un champ: c'est le type 2 La plupart des exercices de Gram sont du type 1. La plupart des exercices de Conj sont du type 2. Le type 1 et le type 2 ne peuvent être mélangés dans un même exercice, et, partant, dans un même fichier texte. Pour créer un nouvel exercice, le plus simple est d'ouvrir un fichier existant avec un traitement de texte, de le modifier à son gré, de l'enregistrer sous un nouveau nom au format texte. (L'extension .txt est nécessaire.) 3.2.1 Fichiers de type 1 Exemple: (les commentaires sont précédés de *: ils ne doivent en aucun cas figurer dans le fichier.) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - type 1 * 1ere ligne:déclaration du type "a" ou "à" * sert à créer les boutons 01.a * nom interne de l'exercice Remplace les points par "a" ou "à" * consigne # * marquage de début d'exercice Jean habite Š Lyon. Ma mère Š mal Š la tête. Il Š promis qu'il serait là Š six heures. C'est un pilote qui Š du coeur. Elle n'Š pas voulu venir. On n'Š pas pu fermer l'oeil de la nuit. Il pensait Š sa maison natale. Š -t-elle bien compris? Il Š encore emprunté de l'argent Š son oncle. Il Š du mal Š y arriver. Il Š été pris Š partie par la foule. Il n'Š plus de soucis. C'est visible Š l'oeil nu. On n'Š que deux jours pour faire le voyage. Qu'Š-t-on fait de ces papiers? [ * début de la section réponses à a/à a/à a a a à a a/à a/à a/à a à a a ] * fin de la section réponses - - - - - - - - - - - - - - -* et fin du fichier texte 3.2.2 Explications: A la ligne 2, les guillemets sont obligatoires. Cette ligne est importante parce qu'elle sert à la fabrication des boutons que l'élève devra cliquer. Exemples typiques: "a" ou "à" "quelque" "quelques" "quel que" "quelle que" "quels que" ou "quelles que" "nil" "e" "s" ou "es" On peut créer ainsi jusqu'à 9 boutons. Le nom interne de l'exercice (ligne 3) est utilisé, pour établir la liste des exercices que l'élève peut choisir. Ce nom doit correspondre au nom réel du fichier (sans l'extension .txt"). A la ligne 5, # s'obtient en tapant Alt-3 (le 3 du clavier alphabétique). Dans les exercices, les mots à remplacer sont marqués par • qui s'obtient en tapant Alt-0149 au clavier numérique. L'exercice lui-même peut comporter autant de lignes que l'on souhaite. Le signe [ marquant le début de la section réponses correctes s'obtient en tapant Alt-è. Chaque ligne de la section réponse correspond à une phrase de la section des énoncés des exercices. Une même phrase peut comporter plusieurs •. Dans ce cas, la ligne correspondante de la section réponses devra comporter autant d'éléments séparés par une barre de fraction (/). Attention! Eviter de proposer des phrases dans lesquelles plusieurs réponses correctes sont possibles, comme: Nous sommes parti•. Le type 1 ne gère pas ce cas. Il est possible de créer un bouton "vide" qui permettra de transformer le • en rien du tout. Pour ce faire, le déclarer sous la forme "nil" à la 2e ligne du fichier texte. Les exercices sur l'accord des participes passés du répertoire Gram utilisent cette possibilité. Dans la section réponses, ce "rien" est traduit par un espace (barre d'espacement). Le caractère ] qui clôt la section des réponses et le fichier texte s'obtient en tapant Alt-tréma. Tout ce qui se trouverait après ce signe sera ignoré de Revizor One Light. 3.3.1 Fichiers de type 2 Exemple: (les commentaires sont précédés de *: ils ne doivent en aucun cas figurer dans le fichier.) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - type 2 * 1ere ligne:déclaration du type "conditionnel passé" * thème C34 * nom interne de l'exercice Mettre au conditionnel passé les verbes entre parenthèses. * consigne # * marquage de début d'exercice J' (vouloir) • Étre acteur. * section des données Si tu avais étudié, tu (réussir) • tes examens. Il (vouloir) • en savoir plus. Je pense que vous ne l' (dire) • pas • si vous ne l'aviez pas pensé. Qui m' (voir) • danser seul dans ma chambre (croire) • que j'étais fou. Si ces pierres avaient pu parler, elles nous (raconter) • des choses étonnantes. Si j'avais été hirondelle, j' (voler) • vers vous à tire-d'aile. Si vous étiez tombés, vous (s'en prendre) • à moi. Si vous aviez articulé plus nettement, on vous (comprendre) • mieux. Tu (vouloir) • raconter une belle histoire. _ * marquage début section élève J' (vouloir) • Étre acteur. Si tu avais étudié, tu (réussir) • tes examens. Il (vouloir) • en savoir plus. Je pense que vous ne l' (dire) • pas • si vous ne l'aviez pas pensé. Qui m' (voir) • danser seul dans ma chambre (croire) • que j'étais fou. Si ces pierres avaient pu parler, elles nous (raconter) • des choses étonnantes. Si j'avais été hirondelle, j' (voler) • vers vous à tire-d'aile. Si vous étiez tombés, vous (s'en prendre) • à moi. Si vous aviez articulé plus nettement, on vous (comprendre) • mieux •. Tu (vouloir) • raconter une belle histoire. [ * début de la section réponses aurais voulu aurais réussi aurait voulu auriez/dit aurait vu /aurait cru auraient raconté aurais volé vous en seriez pris aurait/%compris+comprise+comprises% aurais voulu ] * fin de la section réponses - - - - - - - - - - - - - - - - - - - - - * et fin du fichier texte 3.3.2 Explications: A la ligne 2, les guillemets ne sont pas obligatoires. Le nom interne de l'exercice (ligne 3) est utilisé, pour établir la liste des exercices que l'élève peut choisir. Ce nom doit correspondre au nom réel du fichier (sans l'extension .txt"). A la ligne 5, # s'obtient en tapant Alt-3 (le 3 du clavier alphabétique). Dans la section des données et la section élève, les mots à remplacer sont marqués par • qui s'obtient en tapant Alt-0149 au clavier numérique. Une même ligne (ou phrase ou écran) peut compter jusqu'à 5 • correspondant à autant de réponses que l'on attend de l'élève. L'exercice lui-même peut comporter autant de lignes (ou écrans) que l'on souhaite. La section des données correspond à un champ de Revizor One Light non modifiable à l'écran. Les • ne sont pas remplacés lorsque l'élève donne une réponse. La section élève correspond à un champ de Revizor One Light où les • seront remplacés par la réponse de l'élève. Dans l'exemple ci-dessus, ces deux sections sont rigoureusement identiques, ce qui peut paraître redondant. C'est que le type 2 peut générer des exercices légèrement différents: voir à ce propos, par exemple, les exercices 18a.txt et 18b.txt du répertoire Gram. Le signe _ marquant le début de la section élève est un caractère de soulignement. Le signe [ marquant le début de la section réponses correctes s'obtient en tapant Alt-è. Chaque ligne de la section réponse correspond à une phrase de la section de la section données ou de la section élève. Une même phrase pouvant comporter plusieurs •, la ligne correspondante de la section réponses devra comporter autant d'éléments séparés par une barre de fraction (/). Le type 2 accepte des réponses alternatives correctes de la part de l'élève. Les réponses alternatives correctes s'écrivent, par exemple: %compris+comprise+comprises% Le % indique le début et la fin de l'ensemble des réponses alternatives. Le + sépare chaque élément des réponses acceptables. Les systèmes (/) et (%...+...%) sont combinables. Exemple: %septante+soixante-dix%/%nonante+quatre-vingt-dix% qui se lit: le premier • accepte comme réponse de la part de l'élève septante ou soixante-dix; le second • accepte comme réponse nonante ou quatre-vingt-dix. Le caractère ] qui clôt la section des réponses et le fichier texte s'obtient en tapant Alt-tréma. Tout ce qui se trouverait après ce signe sera ignoré de Revizor One Light. Les signes #, _, [, ], %, + ne doivent donc pas être utilisés dans le corpus des exercices et des réponses mais seulement comme balisage du texte. ---------------------------------------- 4. Barèmes ---------------------------------------- La note attribuée à l'élève est fonction d'une évaluation interne au logiciel. L'échelle de notes est celle en vigueur dans les écoles publiques du canton de Genève. Il est possible d'adapter Revizor One Light à d'autres systèmes de notation ou d'évaluation. Pour ce faire, il faut créer un fichier texte au niveau de hiérarchie de l'application (rol.exe) et le nommer bareme.dat. Son contenu doit se présenter selon le modèle suivant (ici, l'exact équivalent du barème interne): 0,11,0 * première ligne 12,24,1.5 25,36,2 37,48,2.5 49,60,3 61,73,3.5 74,78,4 79,83,4.5 84,88,5 89,93,5.5 94,100,6 101,999,999 * dernière ligne Ce fichier peut contenir autant de lignes que l'on désire. Chaque ligne doit contenir 3 nombres séparés par des virgules. Une ligne se lit ainsi (exemple de la deuxième ligne): "Entre 12% et 24% de réussite, l'élève obtient la note 1.5". Le séparateur décimal est le point. ---------------------------------------- 5. Si ça ne marche pas... ---------------------------------------- Revizor One Light n'a pas fait l'objet de tests systématiques en classe. Il y a certainement des bogues dans le programme et des erreurs dans les fichiers d'exercices. C'est volontiers que je reçois critiques et suggestions d'améliorations. NOTA: les polices de caractères utilisées par le logiciels sont: ARIAL MS SANS SERIF Veillez à ce qu'elles soient présentes sur votre système. ---------------------------------------- Charles Lachat 2 avril 1997 Collège du Foron CH-1226 Thônex Adresse privée: Charles Lachat 3, rue de Savoie CH-1207 Genève tél.: ++41 22 736 51 58 Petit-Bazar: lachat-c Messagerie DIP/GE: lachat-c e-mail: lachat@dial.eunet.ch ---------------------------------------- 6. Révisions/versions ---------------------------------------- version 1.22 avril 1996: correction erreur conj ex 8 : correction bug d'affichage 8 boutons (type 1) : correction des exercices de grammaire version 1.23 mai 1996 : correction erreur gram 17g version 1.24 juin 1996 : correction erreur gram 3a version 1.25 avril 1997: correction erreur gram 22b : correction bug module 0001 (Close) : correction erreur affichage résultats (%) : correction bug, type 1, boutons "vides" ---------------------------------------- 7. Remerciements ---------------------------------------- Je remercie M. Christian Délèze qui a relu les exercices de grammaire pour la version Windows.