Changes

Page history
Update Concepts et objets de MACAO: détails modules & parties authored by Eliott Sammier's avatar Eliott Sammier
Show whitespace changes
Inline Side-by-side
Concepts-et-objets-de-MACAO.md
View page @ 8050cb7e
......@@ -7,9 +7,42 @@
## Dans Macao 1 et 2 :
![Macao_12_concepts_annotation](uploads/5b30aec165b2f85bf18735f72fb6f9e3/Macao_12_concepts_annotation.png)
----
### Parties
Un module contient une ou plusieurs parties _(ex: "Reconnaître les syllabes")_. Côté code, une partie a la même représentation qu'un module, c'est un élément sans contenu propre, décrit comme un `MosMod` dans `imsmanifest.xml`
Un module contient une ou plusieurs parties _(ex: "Reconnaître les syllabes")_. Côté code, une partie a la même représentation qu'un module, c'est un élément sans contenu propre, décrit comme un `<item>` MosMod dans [`imsmanifest.xml`](https://gitlab.tetras-libre.fr/macao/macao-legacy/-/blob/main/Basilisk/MACAO/macao_12/imsmanifest.xml)
```xml
<organization>
<!-- ... -->
<item identifier="MosMod10"> <!-- module "MosMod10" -->
<title>MACAO 1 - S'entraîner à la reconnaissance</title> <!-- titre de MosMod10 -->
<!-- Contenu de MosMod10 -->
<item identifier="MosMod11">
<title>Reconnaître les syllabes</title>
<!-- Contenu de MosMod11 -->
<item identifier="MosEtp129" identifierref="rsrcMosEtp129">
<!-- Sous-partie "MosEtp129", contenu défini dans MosEtp129.html -->
<title>&gt; Reconnaître les syllabes en anglais oral</title>
</item>
</item>
<item identifier="MosMod34">
<title>Reconnaître les auxiliaires, les prépositions et les déterminants</title>
<item identifier="MosEtp210" identifierref="rsrcMosEtp210">
<title>&gt; Reconnaître les auxiliaires</title>
</item>
<item identifier="MosEtp335" identifierref="rsrcMosEtp335">
<title>&gt; Reconnaître les prépositions</title>
</item>
<item identifier="MosEtp558" identifierref="rsrcMosEtp558">
<title>&gt; Reconnaître les déterminants</title>
</item>
</item>
</item>
<!-- ... -->
</organization>
```
----
### Sous-parties
Les "feuilles" de l'arborescence visible dans le panneau de gauche, éléments non dépliables _(ex: "Reconnaître les syllabes en anglais oral")_. Une sous-partie contient plusieurs **pages**, dont la première est affichée quand on sélectionne la sous-partie. Une sous-partie est décrite dans un fichier `sco/MosEtp###`, qui déclare un objet `MosSCO` pour définir son contenu.
```js
......@@ -27,6 +60,7 @@ oSco.tabPages[oSco.tabPages.length] = new PageContenu("Commentaire", "pg636", "c
```
Le plus important est l'ID de la page `"pgXXX"`, et éventuellement le type (`"exercice"` ou `"cours"`), le titre de la page étant déclaré aussi dans la page elle-même.
----
### Pages ou activités
Les "unités de navigation". La section centrale de Macao affiche toujours 1 page, dont le nom est indiqué en haut à droite _(ex: "Repérer les syllabes orales")_. Une page contient une "activité", qui peut être un cours (sans saisie interactive) ou un des 7 types d'exercices (`TAT, QM, EXP, QC, CURS, GD, SEQ` dans `MosMtr/scripts/contenu/ClasseExercice___.js` + `ClasseCours.js`) ***[À confirmer: autres types de contenus?]***. Elle est décrite dans un fichier `contenu/pages/pg###.html`, qui déclare un objet `Cours` ou `Exercice##` pour définir son contenu.
......@@ -73,6 +107,7 @@ Quantité: 5
#### Inutilisés
ExerciceCURS, ExerciceEXP, ExerciceSEQ
----
### Pages d'aide ou "docs"
Dans `contenu/pages/`, les fichiers `*.htm` et `pgd###.html` sont des pages d'aide. Au lieu d'être chargées dans la section centrale, elles peuvent être ouvertes dans une nouvelle fenêtre pop-up avec la fonction `SCO_ouvrirDoc()`, souvent appelée depuis un lien `<a>` dans les pages classiques.
```html
......@@ -80,6 +115,7 @@ cliquez pour voir la définition d'un <a href="javascript:parent.SCO_ouvrirDoc('
```
Ces pages peuvent inclure des objets Flash comme les autres, mais pas d'exercice.
----
## Dans Macao 3
TODO
\ No newline at end of file