.vscode | ||
resources | ||
src | ||
.editorconfig | ||
.gitignore | ||
.prettierrc | ||
config.yml | ||
docker-compose.yml | ||
Makefile | ||
MANIFEST.in | ||
NOTE.md | ||
pyproject.toml | ||
README.md | ||
requirements.txt | ||
setup.cfg | ||
setup.py | ||
thsf.Dockerfile | ||
thsf.net.code-workspace |
THSF.NET
Le site du THSF
Fonctionnement du site
Le site du THSF est une application Python Flask configurée à partir du fichier config.yml
situé à la racine du dépôt.
Il n'est généralement pas nécessaire de modifier ce fichier de configuration, cependant il ets possible d'augmenter le niveau de log en modifiant la clef de configuration log::root::level
en la passant à DEBUG
(valeur en production: INFO
).
Conteneur
Un fichier thsf.Dockerfile
ainsi que le fichier docker-compose.yml
correspondant permettront de rapidement démarrer localement une instance du site du THSF.
Démarrer une instance du site du THSF
Assurez vous d'avoir l'environnement de conteneurisation adéquat (i.e: docker + docker-compose) puis exécuter directement les commandes suivantes depuis la racine du dépôt:
docker-compose build
docker-compose up -d
Le site du THSF écoutera alors sur le port TCP/8042:
http://127.0.0.1:8042
Arrêter une instance du site du THSF
docker-compose down
Apporter des modifications au site
Le code de l'application Python Flask se situe dans le répertoire src
.
Publication du site
Il n'est pas possible de pousser directement des modifications sur la branche master
.
Pour modifier le site, il est nécessaire de créer une branche spécifique et d'y pousser vos modifications.
Lorsque vous êtes satisfaits de vos modifications, vous pouvez créer une demande d'ajout de votre branche sur la branche master
.
Lorsque la demande de fusion sera acceptée, vos modifications seront automatiquement publiées sur le site du THSF.
Vous pouvez auto-accepter vos demandes de fusion si vous faites partie des développeurs autorisés.
Si vous n'avez pas de compte sur l'instance Gitea du Tetalab et que vous voulez faire une pull request, envoyez un patch (diff) par courriel à contact@tetalab.org.