README.md

Modèle de site mkdocs

Contenu du modèle

Ce projet est un modèle minimaliste pour publier un premier site avec mkdocs.

Pour produire du contenu, on peut consulter le tutoriel de Franck Chambon ou le tutoriel avancé du même auteur.

Avant de publier votre site, n'oubliez pas de modifier les éléments dans le fichier mkdocs.yml

La page d'accueil de votre site correspondra à la page générée par le fichier docs/index.md

Les pages apparaitront ensuite dans l'ordre des dossiers. Ainsi, pour faire apparaitre une page «chapitre 1» avec une page d'activité et un page de cours, on peut utiliser la structure suivante :

docs/index.md
    /chapitre1/index.md
              /activite.md
              /cours.md

Afin de modifier le titre affiché pour le chapitre, il suffit de modifier le fichier docs/chapitre01/.pages

Méthode de publication du modèle

Ce modèle permet de publier un site web de façon collaborative en tirant intensivement parti des fonctionnalités de merge request et de commenter les modifications apportées.