À propos du projet

H5P Game Map est un type de contenu H5P permettant aux étudiants de sélectionner leurs propres exercices via une interface de carte de jeu. Attentes en matière de support : le README indique que le type de contenu résulte d’un travail contractuel avec des exigences spécifiques qui peuvent ne pas correspondre aux attentes d’autres utilisateurs. Le développeur l’a rendu disponible en open source pour qu’il puisse être utilisé gratuitement, mais n’est pas obligé de fournir un support gratuit, d’accepter des demandes de fonctionnalités ou des pull requests ; il peut néanmoins continuer à y travailler à son propre rythme. Workflow de construction tel que documenté : - Cloner le dépôt avec git et vérifier la branche d’intérêt. - Exécuter npm install pour installer les modules requis. - Exécuter npm run build pour construire le projet, ou npm run watch pour reconstruire en continu pendant l’édition. - Toujours exécuter npm run build avant de mettre le code en production. - Exécuter npm run lint pour vérifier les violations des guides de style de codage. - Le processus de construction transcrit ES6 en versions antérieures pour améliorer la compatibilité avec les anciens navigateurs ; les fonctions non supportées par certains navigateurs nécessitent un polyfill. - Le processus de construction déplace également les fichiers source dans un seul fichier de distribution et minifie le code. Contournement de la taille de la sémantique : les intégrations H5P courantes utilisent des bases de données mySQL où le champ semantics de la table h5p_libraries est de type text, pouvant contenir jusqu’à 64 Ko de données. Le semantics.json de GameMap dépasse cette limite, donc le projet conserve semantics_src.json et le minifie, ce qui est fait par npm run build_semantics. Le README note que ce n’est pas idéal car il faut l’exécuter lorsque la sémantique change, et que npm run build et npm run watch construisent également la sémantique minifiée. Emballage : le README recommande d’installer l’outil CLI H5P plutôt que de zipper manuellement, car cet outil gère plusieurs choses automatiquement. Dans les cas simples, exécuter h5p pack suivi du répertoire du dépôt et d’un nom de fichier cible suffit. Pour plus d’informations sur l’utilisation des fichiers de distribution dans H5P, le README renvoie à une vidéo d’introduction et au guide de développement H5P sur h5p.org/library-development. Le README fourni ne contient pas de termes de licence, d’informations de version, de liste de fonctionnalités ou de documentation d’utilisation finale au-delà de ces notes de construction, de sémantique et d’emballage.