README.md

Site web de Geotribu

Sources et contenus du site de Geotribu, accessible via les URLs suivantes :

• https://static.geotribu.fr
• http://geotribu.fr
• http://geotribu.net

---

Démarrage rapide

Prérequis

• Python >= 3.7

Recommandés

• NodeJS LTS (pour l'index)
• Visual Studio Code

Installation

Après avoir cloné ou téléchargé le dépôt, installer les prérequis (de préférence dans un environnement virtuel) :

python -m pip install -U pip
python -m pip install -U setuptools wheel

Version gratuite

python -m pip install -U -r requirements-free.txt

Version Insiders

Pour utiliser la version Insiders du thème Material for Mkdocs, il faut disposer du token lié au compte GitHub de Geotribu :

export GH_TOKEN_MATERIAL_INSIDERS=************
python -m pip install -U -r requirements-insiders.txt

Générer le site

Version complète :

mkdocs build

Version complète gratuite :

mkdocs build -f mkdocs-free.yml --dirtyreload

Version minimale (seulement certains plugins) :

mkdocs build -f mkdocs-minimal.yml

Servir le site en local

Version complète :

mkdocs serve --dirtyreload

Version complète gratuite :

mkdocs serve -f mkdocs-free.yml --dirtyreload

Version minimale (seulement certains plugins) :

mkdocs serve --dirtyreload -f mkdocs-minimal.yml

Le site est accessible en local à l'adresse suivante : http://localhost:8000/.
Quand un contenu est modifié, le site est automatiquement rechargé.

---

Contribuer

Pour la procédure détaillée, consulter la section dédiée sur le site.