But : transformer vos analyses citoyennes en fiches structurées, faciles à parcourir, exporter et réutiliser.
1. Pourquoi une collection ?
- Organisation claire : séparer les « dossiers » des articles de blog.
- Front‑matter adapté : champs spécifiques (
theme,source_data,license) sans polluer les posts. - Endpoints JSON : chaque dossier devient un nœud réutilisable (API légère).
2. Déclarer la collection dans _config.yml
collections:
dossiers:
output: true # génère des pages HTML
permalink: /dossiers/:path/
✔️
output: truecrée la page,permalinkdéfinit une URL stable/dossiers/slug/.
3. Créer le dossier physique
|_ dossiers/
|_ _posts/ # (optionnel) si vous voulez la date
|_ infrastructure-eau.md
|_ open-data-stib.md
Minimal Mistakes détecte automatiquement dossiers/.
4. Modèle de front‑matter pour un dossier
---
layout: single
collection: dossiers # obligatoire
title: "Open Data STIB : potentiel citoyen"
permalink: /dossiers/stib-open-data/
theme: "Mobilité & Open Data"
source_data: "API STIB v1"
license: "CC BY 4.0"
toc: true
---
Nouveaux champs (theme, source_data, license) : libres ou imposés par ton besoin.
5. Navigation automatique
Ajoute un lien dans _data/navigation.yml :
- title: "Dossiers"
url: /dossiers/
La page index de la collection se crée toute seule si tu places un fichier dossiers/index.md minimal :
---
layout: collection
title: "Dossiers citoyens"
permalink: /dossiers/
---
Le layout collection intégré à Minimal Mistakes liste les items.
6. Afficher des métadonnées supplémentaires
Crée un include Liquid _includes/dossier-meta.html :
<ul class="dossier-meta">
<li><strong>Thème :</strong> </li>
<li><strong>Donnée source :</strong> </li>
<li><strong>Licence :</strong> </li>
</ul>
Puis, dans chaque dossier, insère où tu veux :
<ul class="dossier-meta">
</ul>
7. Générer un endpoint JSON (optionnel)
Dans dossiers/index.json :
---
layout: null
permalink: /dossiers.json
---
[
{"path":"_dossiers/energie-communes.md","relative_path":"_dossiers/energie-communes.md","excerpt":"Analyse des coopératives énergétiques locales.","previous":null,"id":"/dossiers/energie-communes","collection":"dossiers","next":{"path":"_dossiers/test-projet.md","relative_path":"_dossiers/test-projet.md","excerpt":"Dossier de démonstration : état actuel du projet Jekyll Minimal Mistakes et fonctionnalités mises en place durant la session.","previous":{"path":"_dossiers/energie-communes.md","relative_path":"_dossiers/energie-communes.md","excerpt":"Analyse des coopératives énergétiques locales.","previous":null,"id":"/dossiers/energie-communes","collection":"dossiers","next":{"path":"_dossiers/test-projet.md","relative_path":"_dossiers/test-projet.md","id":"/dossiers/test-projet","collection":"dossiers","url":"/dossiers/test-projet/","draft":false,"categories":[],"layout":"single","classes":"wide","title":"Prototype du site Découvrabilité & Citoyenneté","theme":"Test","toc":true,"slug":"test-projet","ext":".md","tags":[],"date":"2025-07-16 09:52:16 +0000"},"output":null,"content":"Contenu du dossier…\n","url":"/dossiers/energie-communes/","draft":false,"categories":[],"layout":"single","title":"Énergie citoyenne : l'exemple des communes","themes":["Mobilité","Open Data"],"slug":"energie-communes","ext":".md","tags":[],"date":"2025-07-16 09:52:16 +0000"},"id":"/dossiers/test-projet","collection":"dossiers","next":null,"output":null,"content":"## Contexte\n\nCe dossier **test** résume les étapes franchies lors de la mise en place du site :\n\n1. Installation du thème **Minimal Mistakes** et déploiement GitHub Pages. \n2. Ajout d’articles tutoriels et contenus citoyens. \n3. Mise en place de la recherche Lunr.js. \n4. Création de la collection `dossiers` avec filtrage dynamique par thème. \n5. Personnalisation basique (palette vert–lilas, police *Inter*).\n\n## Objectifs court terme\n\n| Tâche | Statut |\n|-------|--------|\n| Valider le filtrage multi‑thème | ✅ |\n| Ajouter un dossier « Mobilité » complet | ⏳ |\n| Brancher statistiques Plausible | ⏳ |\n\n## À retenir\n\n- Ce fichier sert uniquement de **sandbox** pour vérifier que la collection et le JS fonctionnent. \n- Le champ `theme: \"Test\"` déclenche son affichage dans le menu déroulant.\n\n_Fin du dossier test._\n","url":"/dossiers/test-projet/","draft":false,"categories":[],"layout":"single","classes":"wide","title":"Prototype du site Découvrabilité & Citoyenneté","theme":"Test","toc":true,"slug":"test-projet","ext":".md","tags":[],"date":"2025-07-16 09:52:16 +0000"},"output":null,"content":"Contenu du dossier…\n","url":"/dossiers/energie-communes/","draft":false,"categories":[],"layout":"single","title":"Énergie citoyenne : l'exemple des communes","themes":["Mobilité","Open Data"],"slug":"energie-communes","ext":".md","tags":[],"date":"2025-07-16 09:52:16 +0000"},
{"path":"_dossiers/test-projet.md","relative_path":"_dossiers/test-projet.md","excerpt":"Dossier de démonstration : état actuel du projet Jekyll Minimal Mistakes et fonctionnalités mises en place durant la session.","previous":{"path":"_dossiers/energie-communes.md","relative_path":"_dossiers/energie-communes.md","excerpt":"Analyse des coopératives énergétiques locales.","previous":null,"id":"/dossiers/energie-communes","collection":"dossiers","next":{"path":"_dossiers/test-projet.md","relative_path":"_dossiers/test-projet.md","excerpt":"Dossier de démonstration : état actuel du projet Jekyll Minimal Mistakes et fonctionnalités mises en place durant la session.","previous":{"path":"_dossiers/energie-communes.md","relative_path":"_dossiers/energie-communes.md","id":"/dossiers/energie-communes","collection":"dossiers","url":"/dossiers/energie-communes/","draft":false,"categories":[],"layout":"single","title":"Énergie citoyenne : l'exemple des communes","themes":["Mobilité","Open Data"],"slug":"energie-communes","ext":".md","tags":[],"date":"2025-07-16 09:52:16 +0000"},"id":"/dossiers/test-projet","collection":"dossiers","next":null,"output":null,"content":"## Contexte\n\nCe dossier **test** résume les étapes franchies lors de la mise en place du site :\n\n1. Installation du thème **Minimal Mistakes** et déploiement GitHub Pages. \n2. Ajout d’articles tutoriels et contenus citoyens. \n3. Mise en place de la recherche Lunr.js. \n4. Création de la collection `dossiers` avec filtrage dynamique par thème. \n5. Personnalisation basique (palette vert–lilas, police *Inter*).\n\n## Objectifs court terme\n\n| Tâche | Statut |\n|-------|--------|\n| Valider le filtrage multi‑thème | ✅ |\n| Ajouter un dossier « Mobilité » complet | ⏳ |\n| Brancher statistiques Plausible | ⏳ |\n\n## À retenir\n\n- Ce fichier sert uniquement de **sandbox** pour vérifier que la collection et le JS fonctionnent. \n- Le champ `theme: \"Test\"` déclenche son affichage dans le menu déroulant.\n\n_Fin du dossier test._\n","url":"/dossiers/test-projet/","draft":false,"categories":[],"layout":"single","classes":"wide","title":"Prototype du site Découvrabilité & Citoyenneté","theme":"Test","toc":true,"slug":"test-projet","ext":".md","tags":[],"date":"2025-07-16 09:52:16 +0000"},"output":null,"content":"Contenu du dossier…\n","url":"/dossiers/energie-communes/","draft":false,"categories":[],"layout":"single","title":"Énergie citoyenne : l'exemple des communes","themes":["Mobilité","Open Data"],"slug":"energie-communes","ext":".md","tags":[],"date":"2025-07-16 09:52:16 +0000"},"id":"/dossiers/test-projet","collection":"dossiers","next":null,"output":null,"content":"## Contexte\n\nCe dossier **test** résume les étapes franchies lors de la mise en place du site :\n\n1. Installation du thème **Minimal Mistakes** et déploiement GitHub Pages. \n2. Ajout d’articles tutoriels et contenus citoyens. \n3. Mise en place de la recherche Lunr.js. \n4. Création de la collection `dossiers` avec filtrage dynamique par thème. \n5. Personnalisation basique (palette vert–lilas, police *Inter*).\n\n## Objectifs court terme\n\n| Tâche | Statut |\n|-------|--------|\n| Valider le filtrage multi‑thème | ✅ |\n| Ajouter un dossier « Mobilité » complet | ⏳ |\n| Brancher statistiques Plausible | ⏳ |\n\n## À retenir\n\n- Ce fichier sert uniquement de **sandbox** pour vérifier que la collection et le JS fonctionnent. \n- Le champ `theme: \"Test\"` déclenche son affichage dans le menu déroulant.\n\n_Fin du dossier test._\n","url":"/dossiers/test-projet/","draft":false,"categories":[],"layout":"single","classes":"wide","title":"Prototype du site Découvrabilité & Citoyenneté","theme":"Test","toc":true,"slug":"test-projet","ext":".md","tags":[],"date":"2025-07-16 09:52:16 +0000"}
]
🎯 Utilisable comme API simplifiée pour un widget externe (Appsmith, Dash, etc.).
8. Checklist avant de pousser
collections:ajouté dans_config.yml- Dossier
dossiers/créé et peuplé - Fichier
dossiers/index.md(layoutcollection) - Liens navigation mis à jour
- Build local (
bundle exec jekyll serve) OK
9. Et après ?
- Recherche dédiée : activer Lunr.js sur
/dossiers/. - Filtres par thème : paramètre URL
?theme=Mobilite. - Export CSV : page Liquid qui parcourt
site.dossierset crache un fichier CSV.
Tu tiens désormais un mini‑réseau de connaissances prêt à l’open data !