william
c504ace167
SCORM/xAPI : - Ajoute l'export SCORM 2004 (3rd/4th edition) au choix, en plus du 1.2 par défaut : sépare completion_status/success_status (un échec reste "completed" au lieu de retomber à tort en "incomplete" comme force la 1.2), remonte aussi cmi.interactions.n.* par question répondue. - Fournit cmi.core.score.min/max (1.2 et 2004), calculé depuis les récompenses de quiz du jeu, pour que le LMS affiche un vrai pourcentage au lieu du score brut à tort étiqueté "%". - Libellés de verbes xAPI en français en plus de l'anglais. Accessibilité (RGAA/WCAG 2.1 AA) sur le player : - Navigation clavier des objets de scène "au clic"/"au survol" (tabindex, role, Entrée/Espace, focus/blur). - alt sur les images (nom auteur ou décoratif), aria-hidden sur les icônes seules, role="dialog"/aria-live sur les boîtes de dialogue/quiz. - Landmark <main> + titre de page, respect de prefers-reduced-motion. - Le quiz n'avance plus automatiquement après un délai fixe : bouton "Continuer →" explicite (RGAA 2.2.1). - Avertissement de contraste dans l'éditeur de style de dialogue. - Déclaration d'accessibilité téléchargeable depuis la modale d'export.
91 lines
3.9 KiB
Python
91 lines
3.9 KiB
Python
"""Génère imsmanifest.xml pour le paquet Web/SCORM (voir
|
|
build_scorm_package.py) — SCORM 1.2 par défaut (support le plus large
|
|
chez les clients visés, Moodle et la plupart des LMS d'entreprise
|
|
acceptent les deux, l'inverse est faux) ou 2004 3rd/4th edition au choix
|
|
du créateur du jeu (voir db/games/get_scorm_version.py) : seule la 2004
|
|
sépare cmi.completion_status/cmi.success_status, utile quand un
|
|
"échoué" doit rester "completed" (l'apprenant est allé au bout) plutôt
|
|
que retomber en "incomplete" comme l'impose le champ unique de la 1.2."""
|
|
import os
|
|
from xml.sax.saxutils import escape
|
|
|
|
_MANIFEST_TEMPLATE_1_2 = """<?xml version="1.0" standalone="no" ?>
|
|
<manifest identifier="FORGE_{identifier}" version="1"
|
|
xmlns="http://www.imsproject.org/xsd/imscp_rootv1p1p2"
|
|
xmlns:adlcp="http://www.adlnet.org/xsd/adlcp_rootv1p2"
|
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
|
xsi:schemaLocation="http://www.imsproject.org/xsd/imscp_rootv1p1p2 imscp_rootv1p1p2.xsd
|
|
http://www.adlnet.org/xsd/adlcp_rootv1p2 adlcp_rootv1p2.xsd">
|
|
<metadata>
|
|
<schema>ADL SCORM</schema>
|
|
<schemaversion>1.2</schemaversion>
|
|
</metadata>
|
|
<organizations default="FORGE_ORG_{identifier}">
|
|
<organization identifier="FORGE_ORG_{identifier}">
|
|
<title>{title}</title>
|
|
<item identifier="FORGE_ITEM_{identifier}" identifierref="FORGE_RES_{identifier}">
|
|
<title>{title}</title>
|
|
</item>
|
|
</organization>
|
|
</organizations>
|
|
<resources>
|
|
<resource identifier="FORGE_RES_{identifier}" type="webcontent" adlcp:scormtype="sco" href="index.html">
|
|
<file href="index.html"/>
|
|
{file_entries}
|
|
</resource>
|
|
</resources>
|
|
</manifest>
|
|
"""
|
|
|
|
_MANIFEST_TEMPLATE_2004 = """<?xml version="1.0" standalone="no" ?>
|
|
<manifest identifier="FORGE_{identifier}" version="1"
|
|
xmlns="http://www.imsglobal.org/xsd/imscp_v1p1"
|
|
xmlns:adlcp="http://www.adlnet.org/xsd/adlcp_v1p3"
|
|
xmlns:adlseq="http://www.adlnet.org/xsd/adlseq_v1p3"
|
|
xmlns:adlnav="http://www.adlnet.org/xsd/adlnav_v1p3"
|
|
xmlns:imsss="http://www.imsglobal.org/xsd/imsss"
|
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
|
xsi:schemaLocation="http://www.imsglobal.org/xsd/imscp_v1p1 imscp_v1p1.xsd
|
|
http://www.adlnet.org/xsd/adlcp_v1p3 adlcp_v1p3.xsd
|
|
http://www.adlnet.org/xsd/adlseq_v1p3 adlseq_v1p3.xsd
|
|
http://www.adlnet.org/xsd/adlnav_v1p3 adlnav_v1p3.xsd
|
|
http://www.imsglobal.org/xsd/imsss imsss_v1p0.xsd">
|
|
<metadata>
|
|
<schema>ADL SCORM</schema>
|
|
<schemaversion>2004 4th Edition</schemaversion>
|
|
</metadata>
|
|
<organizations default="FORGE_ORG_{identifier}">
|
|
<organization identifier="FORGE_ORG_{identifier}">
|
|
<title>{title}</title>
|
|
<item identifier="FORGE_ITEM_{identifier}" identifierref="FORGE_RES_{identifier}">
|
|
<title>{title}</title>
|
|
</item>
|
|
</organization>
|
|
</organizations>
|
|
<resources>
|
|
<resource identifier="FORGE_RES_{identifier}" type="webcontent" adlcp:scormType="sco" href="index.html">
|
|
<file href="index.html"/>
|
|
{file_entries}
|
|
</resource>
|
|
</resources>
|
|
</manifest>
|
|
"""
|
|
|
|
_MANIFEST_TEMPLATES = {"1.2": _MANIFEST_TEMPLATE_1_2, "2004": _MANIFEST_TEMPLATE_2004}
|
|
|
|
|
|
def build_manifest_xml(slug, game_name, package_files, version="1.2"):
|
|
"""`package_files` : chemins relatifs (depuis la racine du paquet, tel
|
|
qu'écrits dans le zip) de TOUS les fichiers autres que index.html —
|
|
un LMS strict (SCORM Cloud) rejette un manifeste qui omet un fichier
|
|
réellement présent dans le paquet. `version` : '1.2' (défaut) ou
|
|
'2004' — voir db/games/get_scorm_version.py."""
|
|
file_entries = "\n".join(
|
|
' <file href="{}"/>'.format(escape(rel.replace(os.sep, "/")))
|
|
for rel in package_files
|
|
)
|
|
template = _MANIFEST_TEMPLATES.get(version, _MANIFEST_TEMPLATE_1_2)
|
|
return template.format(
|
|
identifier=escape(slug), title=escape(game_name), file_entries=file_entries,
|
|
)
|