Sources et contenus du site de Geotribu, accessible via les URLs suivantes :
Important
Les instructions données ici se veulent succinctes et ne sont donc pas complètes. Pour un vrai guide de contribution en local, consulter le guide détaillé : Installation et configuration de l'environnement de travail pour l'édition locale.
- Python >= 3.9
- Visual Studio Code
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 wheelpython -m pip install -U -r requirements-free.txtPour 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.txtVersion complète :
mkdocs buildVersion complète gratuite :
mkdocs build -f mkdocs-free.ymlVersion minimale (seulement certains plugins) :
mkdocs build -f mkdocs-minimal.ymlVersion complète :
mkdocs serve --dirtyreloadVersion complète gratuite :
mkdocs serve -f mkdocs-free.yml --dirtyreloadVersion minimale (seulement certains plugins) :
mkdocs serve --dirtyreload -f mkdocs-minimal.ymlLe site est accessible en local à l'adresse suivante : http://localhost:8000/.
Quand un contenu est modifié, le site est automatiquement rechargé.
Pour la procédure détaillée, consulter le site dédié.
Afin de pérenniser le site, nous avons ouvert un compte sur Liberapay : https://liberapay.com/Geotribu/.
L'objectif de ce financement est de :
- financer les outils open-source que l'on utilise pour le site :
- Material for MkDocs (voir la page sponsor https://github.com/sponsors/squidfunk)
- GeoRezo (pour le CDN)
- financer les suffixes du nom de domaine (geotribu.fr/.net/.org)