## Contexte Les créations locales indépendantes portant le badge « Ma création » sont actuellement éditables en JSON, un format difficile à modifier pour certains enseignants. Une première implémentation propose un éditeur Markdown avec un aperçu distinct. Les essais montrent cependant deux besoins : - retrouver le style visuel des modales Mémotest ; - vérifier le contenu et les lectures dans le rendu réel des quiz et flashcards, avec une navigation entre les éléments. L’édition doit donc s’appuyer directement sur les lecteurs existants, sans maintenir un aperçu séparé. ## Objectif et version cible Proposer un mode « Modification du contenu et contrôle des lectures » dans `quiz.html` et `flashcard.html`. Permettre de corriger chaque composant dans son contexte, d’écouter son brouillon et d’enregistrer explicitement les modifications. Version cible : **2.1.0**, après validation des données, de la progression et des parcours existants sur la bêta. ## Accès et périmètre - Depuis Mes ressources, le crayon d’une ressource « Ma création » ouvre le lecteur correspondant en mode édition. - Identifier clairement ce mode par un bandeau et un titre adaptés. - Vérifier les droits à l’entrée et à l’enregistrement : un paramètre d’URL seul ne doit pas autoriser l’édition d’une ressource partagée. - Préserver le fonctionnement habituel des lecteurs lorsqu’ils sont ouverts hors de ce mode. - Ne pas intégrer ce mode aux fichiers HTML autonomes exportés. Les possibilités dépendent de la source : | Possibilité | Création locale indépendante | Ressource liée à CodiMD | | --- | --- | --- | | Vérifier le rendu et naviguer | Oui | Oui | | Écouter et corriger les lectures | Oui | Oui | | Modifier le contenu pédagogique dans Mémotest | Oui | Non : modification dans CodiMD | | Enregistrer dans Mémotest | Contenu et lectures | Corrections vocales locales | | Reporter les lectures dans CodiMD | Sans objet | Copie vérifiée, puis collage manuel | ## Rendu et navigation - Réutiliser le rendu et les composants des lecteurs existants. - Afficher le brouillon courant après chaque modification validée dans l’éditeur. - Proposer Précédente, Suivante et un compteur de position. - Permettre d’atteindre directement une carte ou une question. - Ne pas mélanger automatiquement l’ordre des éléments pendant l’édition. - Préserver le contexte de navigation après la correction d’un champ. ### Quiz - Présenter la question et ses options avec leur mise en page habituelle. - Identifier les bonnes réponses sans demander de répondre au quiz. - Afficher les indices et les explications de chaque option, sans devoir jouer une session. - Permettre de modifier les bonnes réponses pour les créations locales indépendantes. - Désactiver les interactions de réponse, de validation et de calcul des résultats. ### Flashcards - Conserver la présentation des cartes et le retournement recto/verso. - Identifier clairement la face affichée. - Permettre de modifier et d’écouter séparément la question et la réponse. - Ne pas afficher les actions d’autoévaluation ou de révision espacée. ## Actions sur les composants - Ajouter un crayon Font Awesome pour chaque composant modifiable : titre, question, réponse, option, indice, explication et image. - Ajouter un haut-parleur pour chaque composant vocalisable. - Ne pas proposer d’écoute du titre si le lecteur ne prévoit pas sa vocalisation. - Pour CodiMD, adapter le crayon afin qu’il permette uniquement la correction de la lecture locale ; proposer l’accès au document source pour le contenu principal. - Réserver une zone aux actions afin qu’elles ne recouvrent jamais le texte, les formules ou les images. - Fournir des libellés accessibles précisant le composant concerné. - Ne pas utiliser les icônes ou la couleur comme seuls moyens d’identifier les actions. ## Modales de correction - Utiliser le style des modales Mémotest : couleurs, typographie, boutons, espacements et gestion du focus cohérents. - Adapter le rendu aux thèmes clair et sombre et au contraste renforcé. - Présenter le contexte du champ : carte ou question, face, option ou explication. - Pour une création locale indépendante, proposer : - le contenu Markdown du composant ; - sa lecture personnalisée lorsqu’il est vocalisable ; - une commande d’écoute du brouillon. - Pour CodiMD, présenter le contenu principal en lecture seule et permettre de corriger la lecture personnalisée. - Permettre de modifier l’URL et le texte alternatif des images pour les créations locales indépendantes. - Distinguer « Appliquer au brouillon » de l’enregistrement définitif de la ressource. - Annuler une correction doit restaurer le champ tel qu’il était avant l’ouverture de la modale. ## Édition Markdown complète et conversion - Conserver une commande secondaire « Éditer le Markdown complet » pour les créations locales indépendantes. - Préserver un accès au JSON pour les usages avancés et les contenus non représentables en Markdown. - Permettre d’ajouter, supprimer et réordonner les cartes, questions et options. - Préserver les données non affichées dans l’éditeur. - Ne jamais supprimer silencieusement un champ non représentable. - Conserver les modifications lors des changements de format. - Préserver les repères nécessaires pour maintenir l’identité des éléments et leur progression. ### Formules mathématiques - Éditer les formules dans leur syntaxe source, normalement entre `$…$`. - Préserver les blocs `$$…$$` existants lorsqu’ils sont nécessaires. - Lorsqu’une conversion de délimiteurs est nécessaire, conserver le sens et la structure de la formule. - Ne jamais remplacer une formule par le HTML, le SVG ou les autres éléments générés par KaTeX ou MathJax. - Ne pas appliquer un remplacement aveugle des délimiteurs ou des antislashs. - Vérifier les formules multiligne, les matrices et les dollars littéraux. - Le rendu et la vocalisation doivent utiliser les mécanismes communs déjà employés par les lecteurs. ## Lecture vocale - Le haut-parleur lit le brouillon courant, sans enregistrement préalable. - Lire la lecture personnalisée lorsqu’elle est renseignée ; sinon, utiliser les règles automatiques communes. - Préserver les lectures personnalisées existantes. - Permettre d’arrêter la lecture. - Arrêter la lecture précédente avant d’en démarrer une autre, lors d’une navigation ou à la fermeture d’une modale. - Une correction vocale seule ne doit pas modifier le contenu affiché. - Si la synthèse vocale est indisponible, expliquer la situation sans bloquer l’édition. ## Brouillon et enregistrement - Afficher clairement la présence de modifications non enregistrées. - Proposer des actions persistantes : « Enregistrer les modifications », « Annuler les modifications » et « Quitter ». - Seule l’action d’enregistrement explicite modifie la ressource. - Protéger le brouillon lors de la fermeture ou d’une navigation hors du mode édition. - En cas d’erreur, conserver le brouillon et la ressource précédemment enregistrée. - Détecter une modification concurrente de la ressource avant de l’écraser. - Conserver l’identité de la ressource. - Actualiser les données utilisées lors de la réouverture, du partage et de l’export. ## Absence de session d’entraînement - Ne créer ni tentative de quiz, ni résultat, ni session d’entraînement. - Ne modifier ni les révisions espacées, ni leurs échéances, ni les historiques pendant le contrôle. - Ne pas comptabiliser ce parcours comme une consultation d’entraînement. - Empêcher les sauvegardes automatiques des lecteurs d’enregistrer le brouillon. - Charger les données dans une copie de travail : leur préparation pour le rendu ou l’écoute ne doit pas modifier la ressource enregistrée. ## Progression et historiques après enregistrement - Les corrections du titre, de présentation ou de lecture vocale ne réinitialisent pas la progression. - Un déplacement ne doit jamais transférer la progression à un autre élément. - Les éléments inchangés conservent leurs révisions. - Pour une modification pédagogique, proposer un choix explicite entre conservation et réinitialisation des révisions concernées lorsque cela est pertinent. - Autoriser la conservation uniquement si la correspondance entre les éléments est fiable. - Expliquer les conséquences avant l’enregistrement. - Conserver les anciens résultats de quiz et les identifier comme antérieurs à la modification du contenu. - Préserver les informations nécessaires à la consultation fidèle des anciennes tentatives. ## Report des corrections dans CodiMD - Conserver les vérifications de source et la gestion des conflits existantes. - Après enregistrement local des lectures, proposer : - « Copier le Markdown et ouvrir CodiMD » lorsque le document complet peut être préparé de façon fiable ; - « Copier les lectures et ouvrir CodiMD » lorsque seuls les extraits sont disponibles. - Préserver le document source complet, ses commentaires et ses contenus lors d’un report complet. - Ne pas utiliser le Markdown reconstruit pour l’éditeur comme remplacement du document complet sans les vérifications nécessaires. - Ouvrir CodiMD après réussite de la copie. - Fournir une consigne adaptée : remplacement complet ou insertion des extraits. - Le collage et l’enregistrement dans CodiMD restent manuels. - Si l’ouverture est bloquée, confirmer la copie réussie et proposer un lien de secours. - Un échec de copie ne doit jamais être présenté comme une réussite. ## Accessibilité et affichage responsive - Rendre toutes les commandes utilisables au clavier et avec un lecteur d’écran. - Restaurer le focus sur le composant corrigé après fermeture d’une modale. - Respecter les contrastes AA, et AAA en mode contraste renforcé. - Adapter les icônes et leurs fonds aux thèmes. - Prévoir des cibles tactiles suffisamment grandes et espacées. - Vérifier les petits écrans, le mode paysage et le zoom. - Conserver les commandes essentielles accessibles sans masquer les contenus. ## Tests et critères de validation - Vérifier l’accès réservé aux ressources « Ma création ». - Tester les quiz et les flashcards, locaux indépendants et liés à CodiMD. - Vérifier la fidélité du rendu avec les lecteurs habituels. - Tester la navigation, les corrections par composant et l’édition Markdown complète. - Vérifier que l’écoute porte sur le brouillon courant. - Tester la conservation des images, textes alternatifs, formules, lectures personnalisées et propriétés non affichées. - Tester les conversions JSON/Markdown et les délimiteurs mathématiques. - Vérifier qu’aucune session, progression ou statistique d’entraînement n’est enregistrée pendant l’édition. - Tester l’annulation, les brouillons invalides, les échecs de sauvegarde et les modifications concurrentes. - Vérifier la progression après ajout, suppression, modification et déplacement. - Tester les protections et les solutions de repli du report CodiMD. - Vérifier que les lecteurs ordinaires et les exports autonomes restent fonctionnels. - Ajouter les tests unitaires et Playwright adaptés. - Vérifier le clavier, les thèmes, le contraste renforcé et les tailles d’écran. - Exécuter `pnpm run check`, puis `pnpm run build`, ainsi que les tests adaptés. - Valider sur la bêta avant publication de la version 2.1.0. ## Documentation utilisateur - Présenter l’accès au mode édition et les corrections par composant. - Expliquer la différence entre brouillon et enregistrement. - Décrire l’écoute, l’édition Markdown complète et le traitement de la progression. - Distinguer les possibilités des créations locales indépendantes et des ressources CodiMD. - Ajouter cette évolution aux nouveautés de la version 2.1.0 avec un lien vers les détails. - Conserver uniquement les principes généraux de vocalisation, sans catalogue de cas mathématiques.