Documentation
Sommaire
- Où lire la documentation Éclair officielle ?
- Les 13 sections du guide officiel
- Télécharger l'archive officielle
- Comment est organisée la documentation de l'académie ?
- Je veux… : où le trouver dans l'administration ?
- Quelle est la version actuelle d'Éclair ?
- Comment obtenir de l'aide ?
- Par où commencer selon ton niveau ?
- Questions fréquentes
La documentation Éclair se trouve à deux endroits. Sur GitHub, le guide officiel et le README décrivent tout le CMS, en 7 langues. Ici, les pages de référence de l'académie détaillent chaque bloc, chaque réglage et chaque fichier, avec les libellés exacts de l'administration. Cette page t'oriente vers la bonne source selon ta question.
Ce que tu trouveras ici
Le guide officiel
Installation, fonctionnalités, sécurité, mise à jour et dépannage, en 7 langues sur GitHub.
Les pages de référence
Les 18 blocs, tous les réglages, les fichiers, les dossiers et les adresses générées.
L'aide au quotidien
Dépannage par symptôme, glossaire, astuces vérifiées et questions fréquentes.
Où lire la documentation Éclair officielle ?
Le dépôt GitHub d'Éclair contient deux documents officiels : le README, qui présente le CMS et ses fonctions, et le guide complet (docs/GUIDE.md), qui explique l'installation, chaque fonctionnalité, la sécurité, la mise à jour et le dépannage. Les deux existent dans les 7 langues de l'administration.
| Langue | Guide complet | README |
|---|---|---|
| Français | GUIDE.md | README.md |
| Anglais | GUIDE.en.md | README.en.md |
| Espagnol | GUIDE.es.md | README.es.md |
| Allemand | GUIDE.de.md | README.de.md |
| Italien | GUIDE.it.md | README.it.md |
| Portugais (Brésil) | GUIDE.pt-BR.md | README.pt-BR.md |
| Chinois simplifié | GUIDE.zh-CN.md | README.zh-CN.md |
Les 13 sections du guide officiel
- Installation : prérequis, étapes, les 4 types de site, premiers pas.
- Fonctionnalités en détail : vitesse, SEO, GEO, éditeur de blocs.
- Utiliser Éclair au quotidien : le tableau « Je veux… / Où » et les raccourcis.
- Mode Visuel.
- Directions artistiques, dont « Imagine ma direction avec l'IA » et le Score Design.
- Thèmes.
- Boutique : ouverture, fiches produit, Stripe, PayPal, Revolut Business, Google Shopping.
- Assistant IA, dont « Créer une page avec l'IA ».
- Connecteur MCP (Claude et ChatGPT).
- Sécurité.
- Mettre à jour, sauvegarder, déménager.
- Dépannage, dont la configuration Nginx.
- Pour les développeurs : arborescence, tests, construction de l'archive.
Télécharger l'archive officielle
L'archive eclair-cms-1.8.0.zip pèse 480 Ko. Elle contient le dossier eclair (c'est son contenu que tu envoies sur ton hébergement), un fichier LISEZ-MOI.txt qui résume l'installation en trois étapes, la licence MIT (LICENSE.txt) et les mentions des éléments tiers (THIRD-PARTY-NOTICES.txt). Le pas-à-pas complet est dans Installer Éclair pas à pas.
Comment est organisée la documentation de l'académie ?
Les leçons des parcours t'apprennent à faire, étape par étape. Les pages de référence servent quand tu cherches un détail précis : un champ, un fichier, une adresse ou un message d'erreur.
| Page | Ce que tu y trouves |
|---|---|
| Référence des 18 blocs | Le rôle de chaque bloc, ses champs exacts, le bon usage, le piège à éviter, les raccourcis clavier et le collage intelligent. |
| Référence des réglages | Les 8 onglets des Réglages champ par champ, puis Mon profil, Utilisateurs, Sécurité, Menus, Redirections et Catégories. |
| Fichiers, dossiers et adresses | L'arborescence d'eclair/, le contenu de data/, eclair-config.php, le .htaccess expliqué, Nginx, les sauvegardes et les adresses générées. |
| Dépannage | Les problèmes connus classés par symptôme, avec un tableau de diagnostic rapide. |
| Glossaire | 50 termes du web, du SEO, du GEO, de la sécurité et de l'IA, définis en une ou deux phrases. |
| Historique des versions | Ce qui a changé de la 1.0.0 à la 1.8.0, et la procédure de mise à jour. |
| Trucs et astuces | Des astuces vérifiées, classées par thème, chacune reliée à sa leçon. |
| Questions fréquentes | 25 réponses courtes sur Éclair et sur l'académie. |
Je veux… : où le trouver dans l'administration ?
Ce tableau reprend celui du guide officiel et le complète. La dernière colonne indique la leçon qui explique la tâche pas à pas.
| Je veux… | Où | Leçon |
|---|---|---|
| Écrire un article | Tableau de bord › Écrire un article | Premier article |
| Demander un article, une page ou une image à l'IA | Champ Que veux-tu créer aujourd'hui ? du tableau de bord, ou Assistant IA (Ctrl+J) | Assistant IA |
| Faire composer une page complète par l'IA | Nouvelle page › Créer avec l'IA | Créer avec l'IA |
| Modifier une page telle qu'elle s'affiche | Éditeur › Visuel | Mode Visuel |
| Modifier une page depuis le site | Bouton ✏️ Modifier, visible seulement quand tu es connecté | Administration |
| Changer de thème, de logo, de couleur ou de polices | Réglages › Apparence | Thèmes |
| Choisir une direction artistique | Réglages › Apparence › Direction artistique | Directions |
| Ajouter mon propre CSS | Réglages › Apparence › CSS personnalisé | CSS |
| Ouvrir la boutique | Réglages › Boutique | Boutique |
| Ajouter un produit | Contenus › + Produit | Boutique |
| Choisir la page d'accueil | Réglages › Général | Pages et menus |
| Autoriser ou bloquer les IA | Réglages › IA & GEO | GEO |
| Activer l'assistant IA | Réglages › Assistant IA | Assistant IA |
| Connecter Claude ou ChatGPT | Réglages › Assistant IA › Autoriser les connexions MCP | Claude |
| Relier Google Search Console | Réglages › SEO | Réglages essentiels |
| Ajouter un lien au menu | Menus | Pages et menus |
| Rediriger une ancienne adresse | Redirections | SEO |
| Créer une catégorie | Catégories | Blog et catégories |
| Relier deux traductions | Éditeur › Document › Traduction de… | Multilingue |
| Restaurer une ancienne version | Éditeur › Historique des versions | Premier article |
| Lire les messages du formulaire | Messages | Formulaire |
| Inviter un rédacteur | Utilisateurs › Inviter quelqu'un | Sécurité |
| Activer la double authentification | Mon profil › Double authentification (2FA) | Sécurité |
| Télécharger une sauvegarde | Sécurité › Sauvegarde | Sécurité |
| Vider le cache | Réglages › Avancé › Vider le cache | Maintenance |
| Changer l'adresse de l'administration | Réglages › Avancé › Adresse de l'administration | Maintenance |
Quelle est la version actuelle d'Éclair ?
La version actuelle est la 1.8.0, publiée le 1er novembre 2026. Elle apporte 12 directions artistiques, « Imagine ma direction avec l'IA », le Score Design, un score Lighthouse de 100 dans les quatre catégories avec quatre directions, et une archive de 480 Ko. Toutes les nouveautés depuis la 1.0.0 sont dans l'historique des versions.
L'administration n'affiche pas le numéro de version. Pour le connaître, ouvre le fichier index.php à la racine de ton site (par FTP ou avec le gestionnaire de fichiers de ton hébergeur) : la ligne define('ECLAIR_VERSION', '1.8.0'); l'indique.
Comment obtenir de l'aide ?
- Cherche ton symptôme dans Dépannage : chaque message d'erreur connu y a sa solution.
- Parcours les questions fréquentes, et le glossaire si un terme te bloque.
- Note la référence de l'erreur : la page « Oups, un court-circuit. » affiche une Référence, que tu retrouves dans Sécurité › Dernières erreurs techniques.
- Ouvre une demande dans les issues du dépôt GitHub avec ta version d'Éclair, ta version de PHP, ton hébergeur, ce que tu as fait, ce qui s'est passé et la référence de l'erreur.
Une erreur ou un passage peu clair dans une leçon de l'académie ? Signale-le depuis la page Contact.
Par où commencer selon ton niveau ?
- Parcours Débutant : 9 leçons, de la préparation de l'hébergement aux réglages d'avant lancement.
- Parcours Intermédiaire : 10 leçons sur le mode Visuel, le design, le SEO, le GEO, le multilingue, la boutique et la sécurité.
- Parcours IA & MCP : 7 leçons pour l'assistant intégré et pour piloter ton site depuis Claude ou ChatGPT.
- Parcours Expert : 8 leçons sur l'architecture, Nginx, la performance, la migration et le travail en agence.
- Pour choisir où héberger ton site : Choisir son hébergement.
Commencer le parcours Débutant
Questions fréquentes
La documentation officielle d'Éclair existe-t-elle en français ?
Oui. Le guide complet et le README existent en français et dans 6 autres langues : anglais, espagnol, allemand, italien, portugais (Brésil) et chinois simplifié. Les liens directs sont dans le tableau en haut de cette page.
Où signaler un bug d'Éclair ?
Dans les issues du dépôt GitHub d'Éclair. Indique ta version d'Éclair et de PHP, ton hébergeur et la référence de l'erreur, mais jamais de mot de passe ni de clé d'API.
Les pages de référence remplacent-elles les leçons ?
Non. Les leçons t'apprennent à faire, étape par étape ; la documentation Éclair de référence sert à vérifier un détail précis. Si tu découvres Éclair, commence par le parcours Débutant.