--- name: feedback-sync-et-docs description: "Après CHAQUE modif de fichier du projet → commit puis `sh ~/sync.sh voyagejapon` ; tout doc demandé → HTML dans carnets/ au format des carnets" metadata: node_type: memory type: feedback originSessionId: 75760f13-42eb-4a9f-b673-3894222428d5 modified: 2026-10-19T16:37:09.623Z --- **Règle de base (Marc, 19/10/2026, pendant le voyage) :** 1. **À chaque fois que je change un fichier du projet**, lancer `sh ~/sync.sh voyagejapon`. Le script crée une archive `releases/voyagejapon--.tar.gz` **depuis le HEAD git** (seulement si le commit a changé), puis fait un miroir rsync `--delete` vers le partage SMB (`~/smbhome/192.168.1.2/algalord/www/voyagejapon`). → **Toujours committer (et pousser) AVANT de lancer la synchro**, sinon l'archive ne contient pas la modif. Si le script sort en ÉCHEC (montage smbnetfs absent, partage vide), le signaler à Marc, ne pas bricoler le montage. 2. **Quand Marc demande de générer un document**, le mettre dans `carnets/` au **même format HTML que les carnets** : HTML autonome print-ready A4, CSS inline, polices système, aucune dépendance externe (cf. [[voyage-japon-carnets-pdf]]). **Why:** ça lui donne un accès rapide aux fichiers à jour depuis le Japon. **How to apply:** après toute modification de fichier du dépôt : `git add ` (jamais `-A`, cf. PDF non suivi) → commit → push → `sh ~/sync.sh voyagejapon`. Les fichiers mémoire sont hors dépôt : les recopier dans `notes/` puis même enchaînement. **Index (19/10/2026) :** `index.html` à la racine = sommaire mobile des documents (demandé par Marc : l'autoindex Apache est peu pratique sur téléphone). **Généré** par `carnets/outils/generer-index.py` (ne pas l'éditer à la main) et **régénéré automatiquement par le hook git `.git/hooks/pre-commit`** (local à cette machine, non versionné) à chaque commit. Tout nouveau `.html` dans `carnets/` apparaît dans « Documents du voyage » (titre = ``, donc soigner le `<title>` des docs) ; les 3 carnets ont une place fixe. **Pages du jour = version TÉLÉPHONE (20/10/2026) :** Marc ne les imprime pas → CSS **responsive** (max-width ~640 px, cartes, texte 16 px, pas de tableaux larges, pas de mise en page A4), même palette que les carnets/index, lien « ← tous les documents » vers `../index.html`, et **liens 📍 Google Maps** (`https://www.google.com/maps/search/?api=1&query=<nom JP>`) sur chaque lieu. Modèle : `carnets/osaka-20-10-chateau-retour-a-pied.html`. Le format A4 print reste pour les carnets et les docs à imprimer. **Liens (20/10/2026) :** dans le chat, les liens s'ouvrent dans l'appli Claude (« pas hyper pratique »). → Les infos pratiques avec liens (Google Maps, résas) vont **dans la page du jour** (ouverte depuis l'index du serveur, dans le navigateur du téléphone → les liens 📍 ouvrent l'appli Maps). Dans le chat : noms en clair (+ japonais à copier), sans multiplier les liens. **Curseur d'avancement (demandé par Marc le 23/10/2026) :** les pages du jour ont un curseur (toucher l'heure d'une étape → « 📍 ici », étapes d'avant grisées, boutons « Où j'en suis » / « Suivante », retour automatique sur le curseur à la réouverture ; stockage localStorage par page). Ajouté par `carnets/outils/curseur-pages-jour.py` (idempotent), **lancé aussi par le hook pre-commit** (qui ajoute les fichiers modifiés au commit). Chaque `.step` porte un `data-id` stable posé une fois. **How to apply :** en modifiant une étape existante, **garder son `data-id`** (même si le titre/l'heure change) ; une étape nouvelle reçoit son id toute seule au commit. Mes remplacements de texte ne doivent plus chercher `<div class="step">` nu (il porte maintenant `data-id`). Si l'étape mémorisée disparaît, le navigateur replace le curseur (titre → voisines → position) et l'affiche. **⛔ Boutons CoMaps par lieu ABANDONNÉS le 28/10/2026 (Marc)** : « à part pour les balades on va oublier, les points correspondent jamais ». Tous les boutons et fichiers KML ont été retirés ; **ne plus lancer `liens-comaps.py`**. **How to apply :** CoMaps seulement pour les **balades** = un lien d'itinéraire à pied écrit à la main (`cm://route?sll=lat,lon&saddr=Départ&dll=lat,lon&daddr=Arrivée&type=pedestrian`, comme la montée de Fushimi), avec des coordonnées vérifiées. Pour les lieux : Google Maps seul, avec le **nom officiel exact** (un nom approximatif fait tomber Google sur une autre boutique, ex. l'atelier Hakuichi le 28/10). *(Historique)* **Liens CoMaps (demandé par Marc le 24/10/2026)** : le GPS de CoMaps est plus précis à pied que Google Maps (qui « colle » à la route). Script `carnets/outils/liens-comaps.py` : ajoute à côté de chaque lien 📍 Google un bouton **« CoMaps 🧭 »** (`cm://map?v=1&ll=lat,lon&n=nom`) + un fichier **`carnets/kml/<page>.kml`** (tous les lieux de la page, lien en haut de page, à ouvrir avec CoMaps). Coordonnées = Nominatim/OSM restreint aux zones du voyage citées par la page, avec contrôle du nom ; cache versionné `carnets/outils/geocodes.json` (corrections manuelles : clé `manuel|<nom>`, `null` = pas de bouton). Ne traite que les pages d'aujourd'hui et à venir. **How to apply :** après chaque nouvelle page du jour, lancer le script, **relire le rapport ✓/✗** (les homonymes et les centroïdes de quartier existent : 1er essai = Bic Camera de Yokohama pour Namba !), corriger à la main dans geocodes.json, relancer, puis commit/sync. Pas dans le hook (réseau + relecture nécessaire). Mieux vaut pas de bouton qu'un point faux.