🐛 Fix: Corrige le déploiement GitHub Pages (chemins sous /gwada-sirius/)
Deploy to GitHub Pages / build (push) Failing after 25s
Deploy to GitHub Pages / deploy (push) Has been skipped

Le site était bien déployé mais tous les chemins absolus (CSS/JS bundlés
par Vite, polices, favicon, manifest, service worker, liens de nav/footer)
pointaient vers la racine du domaine (/assets/..., /favicon.svg, /, /en/…)
au lieu de /gwada-sirius/... — GitHub Pages sert un site de projet sous
/<nom-du-repo>/, pas à la racine. Résultat : CSS et polices en 404, liens
de navigation cassés.

Ajoute une variable d'env BASE_PATH (vide par défaut, /gwada-sirius en CI
via .github/workflows/deploy.yml) : passée à viteOptions.base pour que
Vite préfixe lui-même les assets qu'il bundle, et à un filtre maison
withBase/localeHref pour les liens de nav, favicon, manifest et
l'enregistrement du service worker. Le manifest PWA passe en chemins
relatifs pour ne pas avoir besoin d'être templaté.

Vérifié en simulant un vrai déploiement (build préfixé servi depuis un
sous-dossier /gwada-sirius/ d'un serveur statique) : plus aucune requête
404, navigation, service worker (scope correctement limité au
sous-chemin) et carte Leaflet fonctionnels de bout en bout.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
sucupira
2026-07-06 21:11:51 -04:00
parent 6a80cbc34f
commit 542323ceaa
6 changed files with 32 additions and 8 deletions
+1
View File
@@ -23,6 +23,7 @@ Refonte complète (v2) : passage d'une SPA Vite+Svelte 4 à un site **11ty** sta
3. **Dates ISO sans heure** : `new Date("2026-07-22")` est interprété en UTC ; formaté en heure locale Guadeloupe (UTC-4), ça peut reculer d'un jour. Toujours parser les composants (`year, month, day`) et construire la date en local — voir le filtre `formatDate` et `PredictionsCalculator.svelte`.
4. **Slinkity est abandonné** (son créateur travaille sur Astro) : ne pas l'utiliser pour l'intégration 11ty+Svelte, `eleventy-plugin-vite` (officiel) est la voie robuste.
5. **Service worker et cache obsolète** : la stratégie stale-while-revalidate de `public/sw.js` peut servir une version périmée des îlots (vécu pendant le debug de la carte : un visiteur déjà passé sur le site voyait l'ancien composant malgré un déploiement). **Toujours incrémenter `CACHE_NAME` dans `sw.js`** quand un îlot ou un asset critique change, sinon les visiteurs récurrents restent bloqués sur l'ancienne version jusqu'à revalidation.
6. **GitHub Pages = sous-répertoire, pas la racine du domaine** : `https://cyber-mawonaj.github.io/gwada-sirius/` sert le site sous `/gwada-sirius/`, pas `/`. Tous les chemins absolus (`/assets/...`, `/favicon.svg`, liens de nav, `sw.js`) doivent donc être préfixés. Géré via la variable d'env `BASE_PATH` (vide en local/domaine perso, `/gwada-sirius` en CI — voir `.github/workflows/deploy.yml`) : passée à `viteOptions.base` pour les assets bundlés par Vite, et au filtre maison `withBase`/`localeHref` pour les liens et fichiers passthrough. Le manifest PWA utilise des chemins **relatifs** (`"start_url": "."`) pour ne pas avoir besoin d'être templaté. Pour retester ce scénario en local : `BASE_PATH=/gwada-sirius npm run build`, puis servir `_site` depuis un dossier `gwada-sirius/` à la racine d'un serveur statique.
## 🔄 Améliorations possibles