README.md

@@ -41,7 +41,7 @@ Ils ne doivent pas être modifiés à la main, sauf certains fichiers de configu
 Le répertoire `/opt/scodoc-data` doit être régulièrement sauvegardé.
 
 Principaux contenus:
-
+```
 /opt/scodoc-data
 /opt/scodoc-data/log             # Fichiers de log ScoDoc
 /opt/scodoc-data/config          # Fichiers de configuration
@@ -49,7 +49,7 @@ Principaux contenus:
              .../config/depts    # un fichier par département
 /opt/scodoc-data/photos          # Photos des étudiants
 /opt/scodoc-data/archives        # Archives: PV de jury, maquettes Apogée, fichiers étudiants
-
+```
 ## Pour les développeurs
 
 ### Installation du code
@@ -57,7 +57,7 @@ Principaux contenus:
 Installer ScoDoc 9 normalement ([voir la doc](https://scodoc.org/GuideInstallDebian12)).
 
 Puis remplacer `/opt/scodoc` par un clone du git.
-
+```bash
 sudo su
 mv /opt/scodoc /opt/off-scodoc # ou ce que vous voulez
 apt-get install git # si besoin
@@ -66,16 +66,16 @@ Puis remplacer `/opt/scodoc` par un clone du git.
 
 # Donner ce répertoire à l'utilisateur scodoc:
 chown -R scodoc:scodoc /opt/scodoc
-
+```
 Il faut ensuite installer l'environnement et le fichier de configuration:
-
+```bash
 # Le plus simple est de piquer le virtualenv configuré par l'installeur:
 mv /opt/off-scodoc/venv /opt/scodoc
-
+```
 Et la config:
-
+```bash
 ln -s /opt/scodoc-data/.env /opt/scodoc
-
+```
 Cette dernière commande utilise le `.env` crée lors de l'install, ce qui
 n'est pas toujours le plus judicieux: vous pouvez modifier son contenu, par
 exemple pour travailler en mode "développement" avec `FLASK_ENV=development`.
@@ -84,11 +84,11 @@ exemple pour travailler en mode "développement" avec `FLASK_ENV=development`.
 
 Les tests unitaires utilisent normalement la base postgresql `SCODOC_TEST`.
 Avant le premier lancement, créer cette base ainsi:
-
+```bash
 ./tools/create_database.sh SCODOC_TEST
 export FLASK_ENV=test
 flask db upgrade
-
+```
 Cette commande n'est nécessaire que la première fois (le contenu de la base
 est effacé au début de chaque test, mais son schéma reste) et aussi si des
 migrations (changements de schéma) ont eu lieu dans le code.
@@ -96,17 +96,17 @@ migrations (changements de schéma) ont eu lieu dans le code.
 Certains tests ont besoin d'un département déjà créé, qui n'est pas créé par les
 scripts de tests:
 Lancer au préalable:
-
+```bash
 flask delete-dept -fy TEST00 && flask create-dept TEST00
-
+```
 Puis dérouler les tests unitaires:
-
+```bash
 pytest tests/unit
-
+```
 Ou avec couverture (`pip install pytest-cov`)
-
+```bash
 pytest --cov=app --cov-report=term-missing --cov-branch tests/unit/*
-
+```
 #### Utilisation des tests unitaires pour initialiser la base de dev
 
 On peut aussi utiliser les tests unitaires pour mettre la base de données de
@@ -115,34 +115,34 @@ développement dans un état connu, par exemple pour éviter de recréer à la m
 
 Il suffit de positionner une variable d'environnement indiquant la BD utilisée
 par les tests:
-
+```bash
 export SCODOC_TEST_DATABASE_URI=postgresql:///SCODOC_DEV
-
+```
 (si elle n'existe pas, voir plus loin pour la créer) puis de les lancer
 normalement, par exemple:
-
+```bash
 pytest tests/unit/test_sco_basic.py
-
+```
 Il est en général nécessaire d'affecter ensuite un mot de passe à (au moins) un
 utilisateur:
-
+```bash
 flask user-password admin
-
+```
 **Attention:** les tests unitaires **effacent** complètement le contenu de la
 base de données (tous les départements, et les utilisateurs) avant de commencer !
 
 #### Modification du schéma de la base
 
 On utilise SQLAlchemy avec Alembic et Flask-Migrate.
-
+```bash
 flask db migrate -m "message explicatif....."
 flask db upgrade
-
+```
 Ne pas oublier de d'ajouter le script de migration à git (`git add migrations/...`).
 
 **Mémo**: séquence re-création d'une base (vérifiez votre `.env`
 ou variables d'environnement pour interroger la bonne base !).
-
+```bash
 dropdb SCODOC_DEV
 tools/create_database.sh SCODOC_DEV # créé base SQL
 flask db upgrade # créé les tables à partir des migrations
@@ -151,7 +151,7 @@ ou variables d'environnement pour interroger la bonne base !).
 # puis imports:
 flask import-scodoc7-users
 flask import-scodoc7-dept STID SCOSTID
-
+```
 Si la base utilisée pour les dev n'est plus en phase avec les scripts de
 migration, utiliser les commandes `flask db history`et `flask db stamp`pour se
 positionner à la bonne étape.
@@ -159,19 +159,19 @@ positionner à la bonne étape.
 ### Profiling
 
 Sur une machine de DEV, lancer
-
+```bash
 flask profile --host 0.0.0.0 --length 32 --profile-dir /opt/scodoc-data
-
+```
 le fichier `.prof` sera alors écrit dans `/opt/scodoc-data` (on peut aussi utiliser `/tmp`).
 
 Pour la visualisation, [snakeviz](https://jiffyclub.github.io/snakeviz/) est bien:
-
+```bash
 pip install snakeviz
-
+```
 puis
-
+```bash
 snakeviz -s --hostname 0.0.0.0 -p 5555 /opt/scodoc-data/GET.ScoDoc......prof 
-
+```
 ## Paquet Debian 12
 
 Les scripts associés au paquet Debian (.deb) sont dans `tools/debian`. Le plus