Bienvenue ! Ce site regroupe la documentation complète. Utilisez la recherche ci-dessus ou le sommaire ci-dessous.
Chapitre 0 — Avant-propos & à qui s’adresse ce guide
Rédige un avant-propos très simple : pourquoi ce guide existe, à qui il s’adresse, ce qu’on va y trouver, le ton (pédagogique, sans jargon) et comment l’utiliser (lire dans l’ordre ou piocher par besoin). 180–…
Chapitre 1 — Qu’est-ce que ce “Magasin de fichiers” ?
Explique en termes simples ce qu’est le “Magasin de fichiers”, à quoi il sert, pour qui il est utile, et ce que j’obtiens en l’utilisant — sans jargon technique et en moins de 300 mots.…
Chapitre 2 — Prise en main en 5 minutes
Donne un pas-à-pas ultra-simple pour tester le “magasin de fichiers” en local : télécharger les deux fichiers, ouvrir la page, vérifier que ça s’affiche, et repérer où ajouter ses propres documents. Inclure un…
Chapitre 3 — Ajouter un premier fichier
Explique pas à pas comment ajouter un premier fichier (ex. un PDF) : où le placer, comment l’indiquer dans manifest.json, quoi écrire au minimum, et comment vérifier que la carte apparaît. Ajoute un mini-exemp…
Chapitre 4 — Le catalogue expliqué (cartes, vignettes, boutons)
Décris simplement comment lire une “carte” dans le catalogue : titre, description, vignette, badges, tags, date et les différents boutons (Aperçu, Télécharger, Ouvrir, Plus d’info, Exécuter). Donne des exemple…
Chapitre 5 — La recherche et les filtres
Explique simplement comment trouver vite un document : utiliser la barre de recherche, combiner filtres par type et par tags, trier les résultats, réinitialiser. Donne 2–3 exemples concrets et une astuce clavi…
Chapitre 6 — Les badges (petites étiquettes visuelles)
Présente les badges : à quoi ça sert, les plus courants et quand les utiliser. Donne 2 exemples d’items avec badges (un simple et un “personnalisé”). Termine par un encadré bonnes pratiques.…
Chapitre 7 — Le fichier manifest.json expliqué (sans coder)
Explique ce qu’est manifest.json, à quoi il sert, où il se trouve, et les champs les plus utiles (title, description, url, type, tags, created, thumb, badges, info, run, size). Donne une métaphore simple et un…
Chapitre 8 — Exemples prêts à copier (PDF, image, vidéo, zip, page)
Donne 5 exemples d’items complets (PDF, image, vidéo, zip, page HTML) faciles à copier-coller dans items[]. Chaque exemple doit être réaliste, tenir en 10–14 lignes, et montrer au moins : title, description, u…
Chapitre 9 — Mettre en ligne simplement
Donne un mode d’emploi clair pour publier le magasin de fichiers chez un hébergeur statique (GitHub Pages ou Netlify). Explique l’arborescence à garder, comment tester, quoi faire si le manifest ne charge pas.…
Chapitre 10 — Accessibilité & confort d’usage
Explique, pour un public non technique, comment le site reste confortable : navigation au clavier, texte alternatif, contraste, thème clair/sombre, taille des vignettes et lisibilité. Donne 5 bonnes pratiques …
Chapitre 11 — Personnaliser le look (couleurs, thèmes, badges colorés)
Explique comment changer rapidement les couleurs, utiliser le thème clair/sombre, et personnaliser la couleur d’un badge. Donne un mini-exemple CSS et un exemple d’item avec badge coloré. Ajoute 4 conseils de …
Chapitre 12 — Résolution de problèmes courants (FAQ express)
Dresse une FAQ courte et concrète pour les soucis fréquents : rien ne s’affiche, manifest introuvable, lien cassé, aperçu PDF impossible, chemins relatifs vs absolus, erreurs de virgules dans le JSON, lenteur …
Chapitre 13 — Questions fréquentes (FAQ)
Propose une FAQ claire et courte pour des non-techniciens, couvrant : “Puis-je utiliser ce catalogue sans internet ?”, “Combien de fichiers puis-je avoir ?”, “Comment partager l’adresse à mon public ?”, “Puis-…
Chapitre 14 — Glossaire (mots simples)
Écris un glossaire très simple (définitions en 1–2 phrases) pour : carte, vignette, badge, tag, type, aperçu, télécharger, ouvrir, plus d’info, démo (run), manifest.json, URL, chemin relatif, racine, hébergeur…
Annexe A — Noms de fichiers propres (recommandations)
Donne des règles simples pour nommer proprement les fichiers (minuscules, tirets, pas d’espaces, pas d’accents), avec exemples “avant/après”. Explique pourquoi c’est important et propose un mémo en 6 points.…
Annexe B — Modèles prêts à copier (manifest + cartes)
Fournis un gabarit minimal de manifest.json et un gabarit “intermédiaire” (avec version, updated). Ajoute 3 mini-modèles d’items (pdf/image/zip) tenant chacun en 6–9 lignes.…
Annexe C — Checklist “Mise en ligne sans stress”
Dresse une checklist simple et ordonnée pour publier le site : préparer les dossiers, vérifier les liens, tester en local, déployer (GitHub Pages/Netlify), vérifier en ligne, corriger les erreurs fréquentes.…