JeMeSouviens

Plan de cette page :

• Introduction et principe des flashcards
• Description du projet
• L’interface web
• Le dossier des cartes
• Le logiciel
• Téléchargement et installation
• Mettre en place sur un site web
• Les outils utilisés pour développer JeMeSouviens

Introduction et principe des flashcards

Le projet JeMeSouviens est basé sur le système des flashcards, adapté pour une utilisation en classe.

• PRINCIPE DES FLASHCARDS
  En 1972 le psychologue Allemand Sebastian Leitner propose un système simple pour apprendre par cœur :

  • on utilise une une boîte avec 5 compartiments
  • dans le premier compartiment, on met des cartes marquées d’une question, la réponse étant au verso
  • on tire une carte, on essaye de répondre à la question et on regarde la correction
    • si on connaissait la réponse, la carte passe dans le compartiment suivant de la boîte
    • sinon, la carte est remise dans le premier compartiment
  • ensuite
    • les cartes du premier compartiment seront vues tous les jours
    • celles du deuxième tous les deux jours
    • celles du troisième tous les 3 jours
    • celles du quatrième toutes les semaines
    • celles du cinquième tous les mois.

C’est le système des flashcards. On parle aussi de répétition espacée.

Voir encore cette page de Wikipedia : répétition espacée.

• ADAPTATIONS
  • le système de Leitner est prévu pour un individu faisant un apprentissage sur une durée assez longue
  • cela nécessite un nombre important de cartes dans la boîte, et un enregistrement de l’état de celle-ci à chaque fois
  • dans le cadre d’une utilisation en classe, on utilisera plutôt un paquet assez restreint de cartes portant sur un thème qu’on souhaite réviser
  • le but est alors d’épuiser le paquet de cartes.

Description du projet

• FABRICATION DES CARTES
  • contraintes
    • les cartes doivent être faciles à fabriquer
    • pouvoir être créées avec différents outils
    • pouvoir être reprises de documents existants
    • être réalisées par les élèves (et validées par les profs)
    • on doit pouvoir les utiliser en local
    • on doit pouvoir les utiliser en ligne
    • on doit pouvoir les tester, partager, mettre à jour
  • choix faits
    • chaque carte sera faite de 2 images (jpeg ou png)
    • le nom de l’image affichant la question se terminera par -q (par exemple ma-carte-q.jpeg)
    • le nom de l’image affichant la réponse se terminera par -r (par exemple ma-carte-r.jpeg)
    • à part cela, les noms et les extensions des 2 fichiers devront être identiques
    • elles peuvent donc être réalisées de différentes manières
      • directement depuis GIMP (ou autre)
      • à la main puis scannées
      • à l’aide d’une tablette graphique
    • on peut aussi les générer à partir d’un fichier PDF.
      L’intérêt est que n’importe quel module de LibreOffice peut créer un fichier PDF.
      Voir la partie concernant le logiciel.
• EXEMPLES D’UTILISATION
  • en classe : le prof valide, en fonction des réponses (parfois contradictoires) des élèves
  • à deux : l’un dirige le logiciel, l’autre répond
  • seul : pour réviser de façon autonome.
• LA CRÉATION DES CARTES
  • un énorme travail
    • le système n’a d’intérêt que si le nombre de cartes est important
    • irréalisable tout seul
  • intérêt de déléguer cette partie aux élèves
    • création plus rapide des cartes
    • l’élève qui fabrique des questions révise la notion en jeu
    • motivation
    • compétences techniques
  • rôle des profs
    • répartition et gestion du travail
    • aide à la conception et validation
    • veiller à la légalité des documents produits (licences).

L’interface web

Elle est disponible en ligne ici : https://clgdrouyn.fr/jemesouviens.

Pour l’utiliser en local, téléchargez et décompressez l’archive (voir la partie téléchargement et installation).
Ouvrez ensuite le fichier jemesouviens/index.html dans votre navigateur.

Son fonctionnement est simple :

• on sélectionne un dossier et on clique sur le bouton Commencer.
  On peut aussi prendre des cartes au hasard

• lorsqu’une question est affichée :
  • un clic sur l’écran affichera la réponse
  • on peut aussi utiliser le bouton Afficher la réponse de la barre d’outils

• une fois la réponse affichée :
  • si la réponse proposée était juste, il suffit de cliquer à droite de l’écran
  • on peut aussi utiliser le bouton La réponse était juste

• sinon :
  • si la réponse proposée était fausse, il suffit de cliquer à gauche de l’écran
  • on peut aussi utiliser le bouton La réponse était fausse

• AUTRES CONTRÔLEURS
  • CLAVIER
    • afficher la réponse : espace
    • la réponse était juste : V, →
    • la réponse était fausse : X, ←
    • recommencer : échap
  • ÉCRAN TACTILE
    • même utilisation qu’avec une souris
  • MANETTE
    • afficher la réponse : n’importe quel bouton
    • la réponse était juste : bouton 1
    • la réponse était fausse : bouton 2

Le dossier des cartes

• toutes les cartes du jeu sont situées dans le dossier CARDS (situé sur le site et dans l’archive si vous la téléchargez)

• le dossier CARDS contient plusieurs sous-dossiers

  • _tools : ce dossier contient différents fichiers indispensables au fonctionnement du programme. Il ne faut donc surtout pas le supprimer
  • les dossiers et sous-dossiers créés par l’administrateur du site (et qu’il peut attribuer à certains utilisateurs).
    Par exemple l’archive contient déjà le sous-dossier demo
  • un dossier MesCartes (créé au premier lancement du logiciel de gestion des cartes).
    C’est dans ce dossier qu’il faudra placer les cartes que vous fabriquerez

• aaa

• téléchargement-mise à jour des cartes du site ; cartes seulement sont téléchargées

• dossier MesCartes et sous-dossier attribué ; tous les fichiers (pas seulement les cartes)

• donner un exemple

• les caractères suivants ne doivent pas être utilisés dans les noms : \ / : * ? < > " |

Le logiciel

Le logiciel permet de gérer les cartes et de les envoyer sur un site web.
Il est développé en Python 3 et PyQt5. Voir la partie téléchargement et installation pour l’installer.
Il est situé dans le dossier jemesouviens/jmspython de l’archive.

• TESTER LE JEU (en particulier les nouvelles cartes créées)

• CRÉER DES CARTES À PARTIR D’UN FICHIER PDF
  • les cartes sont toujours faites de 2 images :
    • une pour afficher la question ; son nom doit obligatoirement se terminer par -q (par exemple ma-carte-q.jpeg)
    • une pour afficher la réponse ; son nom doit obligatoirement se terminer par -r (par exemple ma-carte-r.jpeg)
    • à part cela, les noms et les extensions des 2 fichiers doivent être identiques
  • l’action “Fichier PDF” permet de créer des cartes à partir d’un fichier *.pdf
    • chaque page impaire sera transformée en question
    • chaque page paire sera transformée en réponse
  • après avoir sélectionné un fichier PDF
    • vous pouvez choisir le format des images (jpeg ou png)
    • vous pouvez sélectionner leur largeur
    • vous pouvez demander la création d’un sous-dossier pour y placer les cartes (sinon elles seront créées à côté du fichier PDF)

• CRÉER DES CARTES EN UTILISANT LA SYNTAXE MARKDOWN
  • les sauts de pages sont obtenus par —- (4 signes -)

• un bouton permet de créer un fichier PDF à partir du fichier Markdown ouvert

• IMPRIMER DES CARTES
  • cette action est disponible par le menu “Outils”
  • après avoir sélectionné un dossier contenant des cartes, un fichier PDF de celles-ci sera créé
  • il vous suffira de l’imprimer en recto-verso pour obtenir des cartes à découper.

• TÉLÉCHARGER OU POSTER LES CARTES

• le but est de pouvoir gérer les cartes d’un site par http (ou https).
  Par défaut, c’est l’adresse de l’instance de JeMeSouviens du collège Léo DROUYN qui est proposée, mais vous pouvez en utiliser une autre
• même sans compte utilisateur, vous pouvez télécharger les cartes du site avec le bouton situé en haut à droite.
  Cela permet aussi de les mettre à jour

• si vous avez un compte utilisateur sur le site, vous pourrez y envoyer vos cartes
  • les sous-dossiers du site auxquels vous avez accès sont disponibles dans une liste déroulante
  • chacun de ces sous-dossiers correspondra à un sous-dossier du même nom situé dans le dossier local MesCartes
  • c’est dans ces sous-dossiers locaux que vous devez créer et organiser vos cartes
  • vous pouvez aussi y placer les fichiers sources (PDF etc)
• 4 actions vous permettent de mettre à jour vos fichiers.
  Pour que plusieurs utilisateurs puissent gérer un même sous-dossier, les fichiers présents sur le site mais pas dans votre dossier local sont traités à part
  • comparer : permet de lister l’état des fichiers (existant seulement sur le site ou en local, plus récent sur le site ou en local).
    Aucun fichier n’est téléchargé ou envoyé par cette action.
    Elle permet de vérifier l’état des différents fichiers avant de synchroniser
  • synchroniser :
    • les fichiers plus récents sur le site sont téléchargés
    • les fichiers plus récents en local sont envoyés
    • les fichiers n’existant qu’en local sont envoyés
  • télécharger les fichiers du site : tous les fichiers existant sur le site mais pas dans votre sous-dossier local seront téléchargés.
    À faire si vous êtes plusieurs utilisateurs (pour récupérer les fichiers des autres utilisateurs) ou si vous avez changé d’ordinateur et voulez récupérer vos fichiers
  • supprimer les fichiers du site : tous les fichiers existant sur le site mais pas dans votre sous-dossier local seront supprimés du site.
    À faire après l’action précédente si vous travaillez à plusieurs sur le sous-dossier sélectionné, afin de ne pas supprimer les fichiers des autres utilisateurs.
    Permet de supprimer du site les fichiers que vous avez supprimés en local

Téléchargement et installation

• JOUER EN LIGNE
  si vous voulez juste tester le jeu en ligne, cliquez ici : https://clgdrouyn.fr/jemesouviens

• TÉLÉCHARGER
  pour récupérer JeMeSouviens et l’utiliser sur votre ordinateur, téléchargez et décompressez l’archive jemesouviens.tar.gz
  (sous Windows, vous pouvez utiliser le logiciel libre 7-Zip).
  Contenu de l’archive :

  • fichier index.html : lance le jeu
  • dossier jmsweb : contient l’interface web
  • dossier jmspython : contient le logiciel de gestion des cartes. Son installation est détaillée plus bas
  • dossier CARDS : voir le paragraphe le dossier des cartes plus haut
    
    

• INSTALLER LE LOGICIEL DE GESTION DES CARTES
  pour fonctionner, la partie “logiciel” de JeMeSouviens a besoin de

  • Python 3 : langage de programmation
  • PyQt5 : “toolkit” (interface graphique et tout un tas de choses)
  • Pandoc : pour convertir les fichiers Markdown
  • pdftoppm du projet Poppler : pour convertir les fichiers PDF en images
  • sous Windows seulement, Python for Windows Extensions : permet de créer un raccourci sur le Bureau.

• SOURCES
  • développement chez GitLab.

Mettre en place sur un site web

• MISE EN PLACE
  • déposez le dossier jemesouviens sur votre site (en FTP)
  • il sera accessible par l’adresse ADRESSE_DU_SITE/jemesouviens
  • vous pouvez supprimer le sous-dossier jmspython qui ne sert à rien sur le site
  • utilisez le logiciel pour modifier le nom et le mot de passe de l’administrateur (voir ci-dessous)
• GESTION DES UTILISATEURS
  • commencez par modifier l’adresse du site (vérifiez avec le bouton Tester la configuration)

• demandez le menu Outils → Gestion des utilisateurs, puis connectez-vous.
  Le login et le mot de passe initiaux sont admin (à changer pour plus de sécurité)

• commencez par modifier le login et le mot de passe du compte administrateur

• un premier utilisateur existe déjà (login : user, mot de passe : password) et peut gérer le sous-dossier /demo/table_carres.
  Vous pouvez modifier son compte ou même le supprimer

• un bouton permet d’ajouter un nouvel utilisateur.
  Il faudra lui attribuer
  • un nom (login)
  • un mot de passe (qu’il pourra changer)
  • un ou plusieurs sous-dossiers.

Remarques :

• le chemin d’un sous-dossier doit commencer par le caractère /
• les caractères suivants ne doivent pas être utilisés dans les noms : \ / : * ? < > " |
• un même sous-dossier peut être attribué à plusieurs utilisateurs
• pour attribuer plusieurs sous-dossiers à un utilisateur, séparez-les par le caractère |

Les outils utilisés pour développer JeMeSouviens

• outils de base
  • Python : langage de programmation
  • Qt : “toolkit” très complet (interface graphique et tout un tas de choses)
  • PyQt : lien entre Python et Qt
• pour l’interface web
  • JavaScript : langage de programmation
  • Bootstrap : un framework CSS/JS
  • PHP : langage de programmation
• autres bibliothèques utilisées et trucs divers
  • marked : pour afficher les fichiers Markdown
  • PDF.js : pour afficher les fichiers PDF
  • pdftoppm du projet Poppler : pour convertir les fichiers PDF en images
  • TaffyDB : base de données pour JavaScript
  • OpenDyslexic : police d’écriture
• divers
  • GNU GPL 3 : licence publique générale GNU.
  • logo d’après Openclipart