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: true crée la page, permalink dé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 (layout collection)
  • 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.dossiers et crache un fichier CSV.

Tu tiens désormais un mini‑réseau de connaissances prêt à l’open data !

Updated: