Modèle Pandoc multi-pages avec barre de navigation

Ce dépôt est un modèle minimaliste pour créer un petit site web multi-pages à partir de fichiers Markdown (.md), convertis automatiquement en HTML avec Pandoc.

Il s’appuie sur le modèle Pandoc d’origine proposé par Cédric Eyssette : https://forge.apps.education.fr/docs/modeles/modele-pandoc

À quoi sert ce modèle ?

• Publier rapidement un site composé de plusieurs pages.
• Écrire vos contenus en Markdown (simple, lisible, facile à maintenir).
• Disposer d’une barre de navigation commune à toutes les pages, paramétrable via un fichier nav.txt.
• Obtenir une compilation très rapide (plus légère qu’un site type mkdocs), tout en gardant une structure claire.

Comment ça marche ?

1. Vous créez des pages en Markdown :

   • index.md pour l’accueil
   • puis des dossiers avec un index.md dedans (ex. mode_emploi/index.md, credits/index.md, etc.)

2. Vous décrivez le menu du site dans nav.txt (liens + titres).

3. À chaque mise à jour du dépôt sur la branche par défaut, GitLab Pages :

   • génère la barre de navigation (pandoc/nav.html) à partir de nav.txt
   • convertit tous les fichiers Markdown en pages HTML
   • publie le tout dans le dossier public/

Structure conseillée

• index.md (accueil)
• mode_emploi/index.md
• credits/index.md
• nav.txt (menu)
• pandoc/ (template, scripts, CSS…)

Exemple de nav.txt

[🏠 Accueil](/index.html)
[📖 Mode d'emploi](/mode_emploi/)
[🤝 Crédits](/credits/)

Où trouver votre site ?

Votre site doit être publié avec un chemin d’accès du type https://nom_du_site.forge.apps.education.fr (voir le mode d’emploi et le tutoriel associé)

Démarrer rapidement

1. Modifiez nav.txt pour définir votre menu.
2. Ajoutez une page en créant un dossier + un index.md dedans.
3. Poussez vos modifications : la publication se met à jour automatiquement.

➡️ Pour le pas-à-pas complet, consultez : Mode d’emploi (/mode_emploi/).