Les cartes d’apprentissages sont des cartes DITA servant à collecter des ressources et des groupes d’apprentissages. Il en existe deux types :
- La carte LearningObject contenant un seul élément <learningObject>
- La carte LearningGroup contenant un seul élément <learningGroup>
Les deux cartes sont des spécialisations de la carte DITA originale. La structure du contenu de la specification DITA 1.3 indique qu’il est possible de réutiliser de nombreux éléments de la carte, mais ces derniers doivent absolument contenir un unique groupe ou objet d’apprentissage. La spécification autorise l’utilisation d’éléments <topicref> pour référencer des cléfs et autres contenus similaires.
En d’autres termes, cela signifie que la plupart des scénarios de transformation sont pensés pour gérer qu’un seul groupe ou objet d’apprentissage. Vous pouvez essayer d’ajouter d’autres éléments issus de la carte DITA, mais vous devez prendre en considération la possibilité qu’ils soient mal pris en charge par des transformateurs.
Une carte d’apprentissage possède la structure suivante :
<!DOCTYPE learningObjectMap PUBLIC "-//OASIS//DTD DITA 1.3 Learning Object Map//EN"
"learningObjectMap.dtd">
<learningObjectMap>
<learningObject>
...
</learningObject>
</learningObjectMap>
Un groupe d’apprentissage possède la structure suivante :
<!DOCTYPE learningGroupMap PUBLIC "-//OASIS//DTD DITA 1.3 Learning Group Map//EN"
"learningGroupMap.dtd">
<learningGroupMap>
<learningGroup>
...
</learningGroup>
</learningGroupMap>
Au sein d’un groupe d’apprentissage, il est possible d’intégrer d’autres groupes ou objets d’apprentissage. Cela vous permet de réutiliser des rubriques, des leçons, etc. Vous pouvez également réutiliser d’autres cartes d’apprentissage à l’aide des éléments <learningObjectMapRef> et <learningGroupMapRef>.
Exercice
- Faites une copie du fichier GroupeApprentissage-exercice-debut.ditamap et ouvrez-le dans votre éditeur.
Remarque : Si vous utilisez un éditeur compatible avec DITA, assurez-vous d’être en mode texte plutôt qu’en mode auteur ou visuel.
Vous devriez voir ceci :
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE learningGroupMap PUBLIC "-//OASIS//DTD DITA Learning Group Map//EN"
"learningGroupMap.rng">
<learningGroupMap>
</learningGroupMap>
- Donnez un titre à votre carte et ajoutez le groupe d’apprentissage principal.
<learningGroupMap>
<title>Nourrir les canards</title>
<learningGroup>
</learningGroup>
</learningGroupMap>
- Référencez une rubrique d’apprentissage. Pour cet exercice, nous allons utiliser les élements LearningPlan et LearningOverview. Vous pourrez retrouver des fichiers d’exemples à utiliser dans leçon5/Fichiers d’exemple. Vous pouvez référencer le groupe d’apprentissage « Nourrir les canards » (lp_nourrir_canard.dita) à l’aide de l’élement <learningPlanRef> et de l’attribut href.
<learningGroupMap>
<title>Nourrir les canards</title>
<learningGroup>
<learningPlanRef href="../lp_nourrir_canard.dita"/>
</learningGroup>
</learningGroupMap>
Vous pouvez voir que l’élément référençant mentionne le type de rubrique référencée : <learningPlanRef>.
Assurez-vous d’ajouter « ../ » au début du chemin de fichier déclaré pour l’attribut href. Si le chemin vers le fichier change, l’éditeur XML sera toujours en mesure de le trouver.
- Référencez l’aperçu du cours.
<learningGroupMap>
<title>Nourrir les canards</title>
<learningGroup>
<learningPlanRef href="../lp_nourrir_canard.dita"/>
<learingOverviewRef href="../lo_nourrir_canard.dita/>
</learningGroup>
</learningGroupMap>
- Ajoutez un second groupe d’apprentissage et donnez-lui un titre. Le groupe contiendra toutes les rubriques de la leçon 1.
<learningGroupMap>
<title>Nourrir les canards</title>
<learningGroup>
<learningPlanRef href="../lp_nourrir_canard.dita"/>
<learingOverviewRef href="../lo_nourrir_canard.dita/>
</learningGroup>
<learningGroup>
<topicmeta>
<navtitle>Leçon 1 : Qualité de l'alimentation</navtitle>
</topicmeta>
</learningGroup>
</learningGroupMap>
- Il est possible de rendre vos rubriques réutilisables. Créez un <learningObject> à l’intérieur du groupe d’apprentissage de la leçon 1 et nommez-le.
<learningGroupMap>
<title>Nourrir les canards</title>
<learningGroup>
<learningPlanRef href="../lp_nourrir_canard.dita"/>
<learingOverviewRef href="../lo_nourrir_canard.dita/>
</learningGroup>
<learningGroup>
<topicmeta>
<navtitle>Leçon 1 : Qualité de l'alimentation</navtitle>
</topicmeta>
<learningObject>
<topicmeta>
<navtitle>Rubrique 1/navtitle>
</topicmeta>
</learningObject>
</learningGroup>
</learningGroupMap>
- Ajoutez toutes les rubriques d’apprentissages pour la première leçon, ce qui inclut également les cartes d’apprentissages et sommaires.
<learningGroupMap>
. . .
<learningGroup>
<topicmeta>
<navtitle>Leçon 1 : Qualité de l'alimentation</navtitle>
</topicmeta>
<learningObject>
<topicmeta>
<navtitle>Rubrique 1</navtitle>
</topicmeta>
<learningPlanRef href="../lp_nourrir_canard.dita"/>
<learningOverviewRef href="../lc_l1_t1_qualité_ingrédient"/>
<learningContentRef href="../lc_l1_t1_ou_acheter"/>
<learningContentRef href="../lc_l1_t1_stockage.dita"/>
<learningContentRef href="../lc_l1_t1_alteration_aliment"/>
<learningContentRef href="../lc_l1_t1_qualité_ingrédient"/>
<learningSummaryRef href="../ls_l1_t1_synthese.dita"/>
<learningPostAssessmentRef href="../lg_l1_t1_quiz" type="learningGroup"/>
</learningObject>
</learningGroup>
</learningGroupMap>
Vous pouvez désormais ajouter tous les objets nécessaires à votre leçon.
Contributeurs
