Installation documentée par plateforme ; commande rtg verifier

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Mf2kATMtqVABHSYdxJMnim

README.md

@@ -1,4 +1,4 @@
-*RoadTripsGenerator* est un ensemble de scripts (bash et Python) qui génèrent un site web statique de road-trips : une carte interactive par voyage et par jour, avec les photos, les vidéos, les traces GPS et le récit du voyage.
+*RoadTripsGenerator* (RTG) est un logiciel qui génère un site web statique de road-trips : une carte interactive par voyage et par jour, avec les photos, les vidéos, les traces GPS et le récit du voyage.
 
 C'est sans prétention et il faudrait probablement des développements bien plus sérieux pour obtenir un logiciel « presse-bouton », mais si cela peut donner des idées…
 
@@ -18,22 +18,74 @@ Ils préparent aussi les médias pour le web :
 
 Les originaux ne sont jamais modifiés. Le site produit est statique : une simple copie suffit pour le publier ou le transporter.
 
-## Les prérequis
+## Installation
 
-Les scripts fonctionnent sous macOS et Linux.
+RTG fonctionne sous macOS et Linux ; Windows devrait fonctionner mais n'a pas encore été testé. Il lui faut :
 
-* obligatoirement :
-  * Python 3 et les paquets `pandas folium gpxpy markdown2 numpy` (Jinja2, utilisé pour la mise en page, est installé avec folium)
-  * `exiftool`
-* conseillé :
-  * `ffmpeg` (compression des vidéos et images d'aperçu)
-  * `pillow` pour les photos allégées (sous macOS, l'outil `sips` du système prend le relais s'il est absent)
+| Élément | Rôle | Version |
+| --- | --- | --- |
+| Python | le logiciel lui-même | 3.10 ou plus récent |
+| pipx | installe RTG et ses modules Python dans un espace à part | — |
+| exiftool | lit les dates et positions GPS des photos et des vidéos | toute version récente |
+| ffmpeg (avec libx265 et libx264) | compresse les vidéos, tire les images d'aperçu | 5 ou plus récent |
+
+Les modules Python (folium, pandas, gpxpy, Pillow, pillow-heif…) sont installés automatiquement avec RTG.
+
+### macOS
+
+1. Installer [Homebrew](https://brew.sh) s'il n'est pas déjà là :
+   ```
+   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+   ```
+2. Installer les outils, puis rendre pipx accessible :
+   ```
+   brew install python pipx exiftool ffmpeg
+   pipx ensurepath
+   ```
+3. Fermer et rouvrir le Terminal.
+
+Le ffmpeg de Homebrew contient libx265, libx264 et l'encodeur matériel VideoToolbox du Mac.
+
+### Linux (Debian, Ubuntu et dérivées)
 
 ```
-brew install exiftool ffmpeg
-pip3 install pandas folium gpxpy markdown2 numpy pillow
+sudo apt install python3 pipx ffmpeg libimage-exiftool-perl
+pipx ensurepath
 ```
 
+Puis fermer et rouvrir le terminal. Sur Fedora : `sudo dnf install pipx perl-Image-ExifTool` et ffmpeg depuis RPM Fusion.
+
+### Windows (non testé)
+
+Dans PowerShell :
+
+```
+winget install Python.Python.3.12 Gyan.FFmpeg OliverBetz.ExifTool
+py -m pip install --user pipx
+py -m pipx ensurepath
+```
+
+Puis fermer et rouvrir PowerShell.
+
+### Installer RTG
+
+Récupérer le dépôt (ou le copier, par exemple sur un disque externe) :
+
+```
+git clone https://git.ouaibe.fr/Korrigan/RoadTripsGenerator.git
+pipx install --editable ./RoadTripsGenerator
+```
+
+Avec `--editable`, la commande `rtg` utilise directement le code du dossier : une mise à jour du dépôt (`git pull`) est prise en compte sans réinstaller. Le dossier doit alors rester accessible (disque branché).
+
+### Vérifier
+
+```
+rtg verifier
+```
+
+La commande contrôle Python, les modules, exiftool, ffmpeg et ses encodeurs, et donne pour chaque élément manquant la commande à taper sur votre système.
+
 ## Organisation des dossiers
 
 Le dépôt et le site sont deux dossiers voisins. Un voyage est un dossier qui contient au moins un des sous-dossiers `photos`, `rushs` ou `routes`. Les voyages rangés à la racine du site forment la rubrique « Voyages » de la page d'accueil. Ceux rangés un niveau plus bas, dans un dossier de regroupement (ici `Balades`), forment une rubrique du nom de ce dossier. L'accueil montre les 2 plus récents de chaque rubrique (`ACCUEIL_NB=3` pour en montrer plus), avec un lien vers la liste complète.
@@ -62,14 +114,7 @@ Dans le récit `voyage.md`, deux raccourcis évitent les liens écrits en dur (q
 [La descente](media:videos/GH011272.mp4)
 ```
 
-## Installation et utilisation : la commande `rtg`
-
-RTG s'installe comme un logiciel, avec une seule commande `rtg` utilisable depuis n'importe quel dossier :
-
-```
-brew install exiftool ffmpeg          # ou l'équivalent sous Linux / Windows
-pipx install ./RoadTripsGenerator     # depuis le dossier du dépôt
-```
+## Utilisation : la commande `rtg`
 
 Depuis le dossier du site (`Road-Trips`) :
 
@@ -79,6 +124,7 @@ rtg etat                              # avancement de chaque voyage
 rtg generer Balades/Vexin-10-2026     # un voyage, puis l'accueil
 rtg generer --sans-compression        # tous les voyages, sans encoder de vidéo
 rtg analyser Balades/Vexin-10-2026    # ce que RTG trouve dans les sources
+rtg verifier                          # tout est-il installé ?
 ```
 
 Les sources d'un voyage peuvent rester où elles sont, nommées n'importe comment : on les indique dans son `voyage.toml`.
@@ -95,7 +141,7 @@ photos = ["~/Pictures/Export/Vexin"]
 
 RTG range alors lui-même les traces par journée (`routes/AAAA-MM-JJ.gpx`, d'après leurs horodatages ou, à défaut, la date du nom de fichier) et copie les photos dans `photos/` (les HEIC de l'iPhone sont converties en JPEG). Une photo sans GPS reçoit la position de la trace à son heure, quand la trace est horodatée. Les réglages communs (qualité vidéo, taille des photos, fuseau horaire, cartes My Maps…) sont dans `site.toml`.
 
-Les scripts de `Scripts/` restent disponibles pendant la transition ; ils produisent le même site.
+Les scripts de `Scripts/` restent disponibles pendant la transition ; ils produisent le même site. Ils demandent en plus d'installer à la main les modules Python : `pip3 install pandas folium gpxpy markdown2 numpy pillow`.
 
 ## Mode d'emploi (anciens scripts)