Je viens de finir de convertir mon tuto à la nouvelle ZEP-12 ! Pour ceux que ça intéresse, voici comment j'ai fais.
Allez dans la dernière version de votre tuto et, en bas du volet de gauche, cliquez pour télécharger l'archive du tuto. Vous aurez alors un fichier .zip qui contient des fichiers .md et un fichier .json.
Dézippez-le sur votre PC et déplacez vos fichiers .md (qui constituent les sections, les intros et les conclusions de votre tuto) dans un dossier du nom de votre choix (anciennes-sections par exemple).
Maintenant, ouvrez le fichier .json à la racine du tuto. Dans le cas de mon mini-tuto de secourisme, il ressemble à ça (version tronquée) :
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31 | {
"object": "container",
"slug": "les-bases-du-secourisme",
"title": "Les bases du secourisme",
"introduction": "introduction.md",
"conclusion": "conclusion.md",
"children": [
{
"object": "extract",
"slug": "15677_introduction-et-numeros-durgence",
"title": "Introduction et numéros d'urgence",
"text": "15677_introduction-et-numeros-durgence.md"
},
{
"object": "extract",
"slug": "15111_partie-1-les-diplomes-officiels",
"title": "Partie 1 : Les diplômes officiels",
"text": "15111_partie-1-les-diplomes-officiels.md"
},
{
"object": "extract",
"slug": "15131_partie-2-les-constantes",
"title": "Partie 2 : Les constantes",
"text": "15131_partie-2-les-constantes.md"
},
],
"version": 2,
"description": "Traiter une écorchure ou transmettre un bilan efficacement",
"type": "TUTORIAL",
"licence": "CC BY-NC"
}
|
On a donc ici la description de toute la structure actuelle du tuto, avec les chemins des fichiers .md, les titres…
Nous allons maintenant donner une nouvelle structure à ce fichier, qui correspondra au nouveau standard de la ZEP-12. Pour y voir plus clair, j'ai créé un tuto avec plusieurs sous-parties dont j'ai ensuite adapté le manifest.json pour qu'il corresponde à mon tuto. Je vous encourrage à faire de même pour avoir un exemple complet sous les yeux.
Voici à quoi ressemble la nouvelle structure, vous pouvez vous aussi l'utiliser comme base (j'ai mis des noms bidons, faites pas attention) :
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49 | {
"object": "container",
"slug": "les-fruits-de-mer",
"title": "Les fruits de mers",
"introduction": "introduction.md",
"conclusion": "conclusion.md",
"children": [
{
"object": "container",
"slug": "generalites",
"title": "Généralités",
"introduction": "generalites/introduction.md",
"conclusion": "generalites/conclusion.md",
"children": [
{
"object": "extract",
"slug": "dans-les-abysses",
"title": "Dans les abysses",
"text": "generalites/dans-les-abysses.md"
}
]
},
{
"object": "container",
"slug": "la-peche-a-pieds",
"title": "La pêche à pieds",
"introduction": "rappels-de-base/introduction.md",
"conclusion": "rappels-de-base/conclusion.md",
"children": [
{
"object": "extract",
"slug": "lhuitre",
"title": "L'huître",
"text": "la-peche-a-pieds/lhuitre.md"
},
{
"object": "extract",
"slug": "la-palourde",
"title": "La palourde",
"text": "la-peche-a-pieds/la-palourde.md"
}
]
}
],
"version": 2,
"description": "",
"type": "TUTORIAL",
"licence": "CC BY"
}
|
Pour cette magnifique ébauche de tuto sur les fruits de mer, nous avons donc une intro et une conclusion générale, une partie "Généralités" avec une section qui développe le cas des abysses. Ensuite on a une partie un peu plus grande sur la pêche à pieds, qui contient deux sections : une pour les huîtres, et une pour les palourdes.
Vous l'aurez compris, chaque partie et section est définie par 4 lignes :
"object": "extract", <=== Le type ("extract" pour une section, "container" pour une partie)
"slug": "la-palourde", <=== Le nom "informatisé" de la section / partie
"title": "La palourde", <=== Le titre
"text": "la-peche-a-pieds/la-palourde.md" <=== Le chemin vers le fichier .md, dans le cas d'une section, depuis la racine du tuto
En regardant le fichier .zip, on constate aussi que chaque section d'une partie est contenue dans un dossier ayant pour nom la valeur "slug" de cette partie.
En reprennant ce formatage, vous pouvez donc organiser les parties de votre tuto comme bon vous semble. Pour le tuto de secourisme ci-dessus, ça ressemble maintenant à ça (version tronquée, c'était assez long) :
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50 | {
"object": "container",
"slug": "les-bases-du-secourisme",
"title": "Les bases du secourisme",
"introduction": "introduction.md",
"conclusion": "conclusion.md",
"children": [
{
"object": "container",
"slug": "ancienne-version-pre-zep-12",
"title": "Ancienne version (pré-ZEP-12)",
"introduction": "ancienne-version-pre-zep-12/introduction.md",
"conclusion": "ancienne-version-pre-zep-12/conclusion.md",
"children": [
{
"object": "extract",
"slug": "avertissements-et-numeros-durgence",
"title": "Avertissements et numéros d'urgence",
"text": "ancienne-version-pre-zep-12/avertissements-et-numeros-durgence.md"
},
{
"object": "extract",
"slug": "15111_partie-1-les-diplomes-officiels",
"title": "Partie 1 : Les diplômes officiels",
"text": "ancienne-version-pre-zep-12/15111_partie-1-les-diplomes-officiels.md"
},
{
"object": "extract",
"slug": "15131_partie-2-les-constantes",
"title": "Partie 2 : Les constantes",
"text": "ancienne-version-pre-zep-12/15131_partie-2-les-constantes.md"
},
{
"object": "extract",
"slug": "15129_partie-3-les-bilans-comment-evaluer-letat-dune-victime-rapidement",
"title": "Partie 3 : Les bilans : comment évaluer l'état d'une victime rapidement",
"text": "ancienne-version-pre-zep-12/15129_partie-3-les-bilans-comment-evaluer-letat-dune-victime-rapidement.md"
},
{
"object": "extract",
"slug": "15134_partie-4-la-conduite-a-tenir-cat",
"title": "Partie 4 : La conduite à Tenir (CAT)",
"text": "ancienne-version-pre-zep-12/15134_partie-4-la-conduite-a-tenir-cat.md"
},
],
"version": 2,
"description": "Traiter une écorchure ou transmettre un bilan efficacement",
"type": "TUTORIAL",
"licence": "CC BY-NC"
}
|
Maintenant que tout est prêt, il ne reste plus qu'à rezipper le tuto avec son nouveau manifest.json et à aller sur la page de votre tuto. En haut à gauche, allez dans "Importer une nouvelle version", puis importez votre tout nouveau fichier .zip.
Si tout va bien, vous avez maintenant un tuto avec une partie contenant toutes les anciennes sections de votre tuto. Vous pouvez donc créer de nouvelles parties et chapitres et y déplacer vos sections selon vos envies.
Si vous êtes aventureux et curieux, vous pourrez aussi tout réorganiser directement depuis le manifest.json. La méthode que j'ai présenté ici est juste plus "conviviale".
Avant de finir, je tiens vraiment à remercier toute l'équipe pour ce magnifique boulot sur la ZEP-12, qui va nous ouvrir les portes du monde merveilleux des moyens-tutos. Merci !