Rien ne s’affiche
→ Ouvrez la console du navigateur (F12). Si vous voyez “manifest introuvable”, vérifiez que index.html et manifest.json sont au même niveau (racine du site) et que vous avez bien publié ce dossier.
Manifest introuvable
→ Le fichier n’est pas à la racine, est mal nommé, ou l’URL publique pointe vers un sous-dossier. Remettez manifest.json à côté de index.html et redeployez.
Lien cassé (404)
→ Le chemin url ne correspond pas au vrai fichier. Vérifiez l’orthographe, la casse (majuscules/minuscules) et le dossier (./pdfs/MonFichier.pdf doit exister).
Aperçu PDF ne marche pas
→ Certains serveurs externes bloquent l’intégration dans la page. Solution : proposez Télécharger ; ou hébergez le PDF chez vous (même domaine).
Chemins relatifs vs absolus
→ Préférez ./dossier/fichier.ext (relatif) si le fichier est sur le même site. Les liens absolus (https://…) fonctionnent mais peuvent limiter l’aperçu selon le serveur distant.
Erreur de virgules/guillemets dans le JSON
→ Utilisez un éditeur qui signale la syntaxe. Astuce : copiez le contenu dans un “validateur JSON” en ligne pour repérer la ligne fautive.
C’est lent avec beaucoup d’items
→ Réduisez la taille des vignettes (≤ 150–200 Ko), limitez les badges et les descriptions trop longues. Si vous dépassez plusieurs milliers d’items, envisagez de diviser en plusieurs pages thématiques.
Je veux tout remettre à zéro
→ Videz le champ Recherche, cliquez sur le type Tous, désactivez les tags surlignés et rafraîchissez la page.
À retenir
- 80% des soucis = chemins ou JSON.- Les PDF externes peuvent refuser l’aperçu : proposez Télécharger.- Pour la vitesse : vignettes légères et catalogue organisé.