Modèle de site simple

Publiez simplement un site à partir de Markdown

Un modèle minimaliste pour créer rapidement un petit site multipages. Vous écrivez vos contenus en Markdown ; Pandoc génère les pages HTML et GitLab Pages les publie automatiquement.

Consulter le mode d’emploi Voir les crédits

Trois fichiers, un site facile à maintenir

Écrire en Markdown

Créez ou modifiez de simples fichiers .md, lisibles même sans outil particulier.

Organiser avec nav.txt

Une ligne par lien suffit pour construire la navigation commune à toutes les pages.

Publier avec GitLab Pages

À chaque envoi sur la Forge, la CI convertit les pages avec Pandoc et publie le résultat.

Comment ça marche ?

  1. Créez ou modifiez les fichiers .md.
  2. Définissez les liens du menu dans nav.txt.
  3. Poussez vos modifications sur la Forge.
  4. Le site est généré et publié automatiquement.

Le site fonctionne aussi bien à la racine (nom_du_site.forge.apps.education.fr) que dans un projet de groupe (nom_du_groupe.forge.apps.education.fr/nom_du_projet).

Une structure volontairement simple

index.md
nav.txt
img/
mode_emploi/
  index.md
credits/
  index.md

Exemple de navigation

Le fichier nav.txt utilise la syntaxe habituelle des liens Markdown :

[Accueil](/)
[Mode d'emploi](/mode_emploi/)
[Crédits](/credits/)

Les chemins qui commencent par / sont automatiquement adaptés à l’adresse GitLab Pages du projet. La génération est gérée par un pipeline commun : aucun fichier technique n’est à maintenir dans votre dépôt.

Prêt à personnaliser ce modèle ?

Commencez par modifier index.md, puis ajoutez vos pages et leurs liens de navigation.

Suivre le mode d’emploi