consolidation: fusion doublons (mcp-nas, opencode, bifrost-vk, doc-api rebuild), purge obsoletes (gotenberg, ports-registry racine), re-spherage runbooks metier (perso/tt/nyora), refonte _INDEX.md — 09/07/2026

2026-07-09 12:28:30 +00:00
parent cdeb9ebbc3
commit 390202d93f
25 changed files with 308 additions and 1068 deletions
@@ -1,45 +1,20 @@
-# HTML vers PNG : Rendu headless Puppeteer / Chromium
+# HTML vers PNG : rendu headless Puppeteer / Chromium

-**Contexte** : html2canvas echoue dans les iframes sandbox (Claude.ai, widgets).  
-Polices Google Fonts et SVG complexes bloques par CORS.  
-**Solution** : rendu serveur avec Chromium headless.
+**Date** : 2026-06-21, révisé 09/07/2026 (retrait de l'approche Gotenberg — container désinstallé)

---
+**Contexte** : html2canvas échoue dans les iframes sandbox (Claude.ai, widgets). Polices Google Fonts et SVG complexes bloqués par CORS.
+**Solution** : rendu serveur avec Chromium headless via Puppeteer (bash_tool Claude).

-## Approche 1 - Claude bash_tool
+## Pièges critiques

-### Installation (une seule fois par session)
-
-
-
-### Script render.mjs
-
-
-
-**Pieges critiques :**
 - Entry point : lib/puppeteer/puppeteer.js (pas lib/esm/)
- page.waitForTimeout() supprime en v25+ => setTimeout natif
+- page.waitForTimeout() supprimé en v25+ → setTimeout natif
 - --no-sandbox obligatoire dans container Claude
- networkidle0 + 2s = polices externes chargees
+- networkidle0 + attente 2 s = polices externes chargées

+## Cas validé (2026-06-21)

+Carte félicitations Bac 2026 — HTML/SVG 680×680 px + Google Fonts → PNG 1360×1360 px (137 Ko), upload Facebook direct.

---
-
-## Approche 2 - NAS via Gotenberg (port 3001, deja deploye)
-
-Gotenberg embarque Chromium. HTML -> PDF puis PDF -> PNG Pillow.
-
-
-
-Ou via noeud HTTP Request n8n (multipart/form-data vers Gotenberg).
-
---
-
-## Cas valide (2026-06-21)
-
-Carte felicitations Bac 2026 - HTML/SVG 680x680px + Google Fonts.  
-Resultat : PNG 1360x1360px (137 Ko), upload Facebook direct.  
-
-**Regle absolue** : html2canvas = NON iframe sandbox.  
-Puppeteer (Claude) ou Gotenberg (NAS) = OUI.
+**Règle absolue** : html2canvas = NON en iframe sandbox. Puppeteer = OUI.
+**Note** : l'ancienne « Approche 2 » via Gotenberg (HTML→PDF→PNG) n'existe plus — gotenberg a été désinstallé le 21/06/2026 (cf. cleanup-stack-documentaire.md).