From 0129f19812e51957bb5fe94c1790c6f5d7bd9836 Mon Sep 17 00:00:00 2001 From: Alexandre Caldato <caldato.alexandre@gmail.com> Date: Sun, 27 Aug 2023 12:32:12 +0200 Subject: [PATCH] update du readme. closes #6 --- README.md | 52 ++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 44 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index f2f81a6..b082b3d 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,47 @@ -# Exemple mkdocs-dsfr +# Exemple d'Utilisation de mkdocs-dsfr -## Usage +Ce dépôt sert d'exemple pour le thème mkdocs-dsfr, un thème mkdocs conforme aux standards de l'État français pour la création de sites Web. -- Prérequis : [pipenv](https://pipenv.pypa.io/en/latest/) -- Environnement de travail : - - `pipenv install`pour installer les dépendances - - `pipenv shell`pour entrer dans le venv - - `mkdocs serve`pour tester en live - - `mkdocs build`pour construire le site +## Prérequis +- [Python 3.x](https://www.python.org/downloads/) +- [pipenv](https://pipenv.pypa.io/en/latest/) + +## Installation + +1. Clonez ce dépôt sur votre machine locale. +2. Ouvrez un terminal et naviguez vers le dossier du projet. +3. Exécutez `pipenv install` pour installer les dépendances du projet. + +## Utilisation + +### Environnement de Développement + +1. Entrez dans l'environnement virtuel avec `pipenv shell`. +2. Lancez le serveur de développement avec `mkdocs serve`. +3. Ouvrez votre navigateur Web et accédez à `http://127.0.0.1:8000`. + +### Construction du Site + +Pour construire le site Web statique, utilisez la commande suivante : + +```bash +mkdocs build +``` + +Le site sera généré dans le dossier `site`. + +## Contributeurs + +Ce projet est une initiative du gouvernement français pour promouvoir les standards de développement Web en France. + +## Licence + +À définir + +## Ressources Utiles + +- [Site officiel de DSFR](https://www.systeme-de-design.gouv.fr/) +- [Documentation mkdocs](https://www.mkdocs.org/) + +--- -- GitLab