---
title: "Documentación"
description: "Toda la documentación de Éclair: guía oficial en 7 idiomas, los 18 bloques, los ajustes, archivos, solución de problemas, glosario y versiones."
url: "https://eclair.academy/es/documentacion"
lang: "es"
author: "Thierry Gustin"
published: "2026-11-02"
updated: "2026-11-02"
---

# Documentación

> **Lo esencial** — La documentación de Éclair está en dos fuentes. En GitHub, la guía oficial y el README existen en 7 idiomas; aquí, las páginas de referencia de la academia detallan los 18 bloques, cada ajuste, los archivos, la solución de problemas, el glosario y el historial de versiones. La versión actual es la 1.8.0, publicada el 1 de noviembre de 2026.

La documentación de Éclair está en dos sitios. En GitHub, la guía oficial y el README describen todo el CMS, en 7 idiomas. Aquí, las páginas de referencia de la academia detallan cada bloque, cada ajuste y cada archivo, con las etiquetas exactas de la administración. Esta página te lleva a la fuente adecuada según tu pregunta.

## Lo que encontrarás aquí

### 📚 La guía oficial

Instalación, funciones, seguridad, actualización y solución de problemas, en 7 idiomas en GitHub.

### 🛠 Las páginas de referencia

Los 18 bloques, todos los ajustes, los archivos, las carpetas y las direcciones generadas.

### 💡 La ayuda del día a día

Solución de problemas por síntoma, glosario, trucos verificados y preguntas frecuentes.

## ¿Dónde leer la documentación oficial?

El repositorio de GitHub de Éclair contiene dos documentos oficiales: el **README**, que presenta el CMS y sus funciones, y la **guía completa** (`docs/GUIDE.md`), que explica la instalación, cada función, la seguridad, la actualización y la solución de problemas. Los dos existen en los 7 idiomas de la administración.

| Idioma | Guía completa | README |
| --- | --- | --- |
| Francés | [GUIDE.md](https://github.com/Jacckisback/eclair-cms/blob/main/docs/GUIDE.md) | [README.md](https://github.com/Jacckisback/eclair-cms/blob/main/README.md) |
| Inglés | [GUIDE.en.md](https://github.com/Jacckisback/eclair-cms/blob/main/docs/GUIDE.en.md) | [README.en.md](https://github.com/Jacckisback/eclair-cms/blob/main/README.en.md) |
| Español | [GUIDE.es.md](https://github.com/Jacckisback/eclair-cms/blob/main/docs/GUIDE.es.md) | [README.es.md](https://github.com/Jacckisback/eclair-cms/blob/main/README.es.md) |
| Alemán | [GUIDE.de.md](https://github.com/Jacckisback/eclair-cms/blob/main/docs/GUIDE.de.md) | [README.de.md](https://github.com/Jacckisback/eclair-cms/blob/main/README.de.md) |
| Italiano | [GUIDE.it.md](https://github.com/Jacckisback/eclair-cms/blob/main/docs/GUIDE.it.md) | [README.it.md](https://github.com/Jacckisback/eclair-cms/blob/main/README.it.md) |
| Portugués (Brasil) | [GUIDE.pt-BR.md](https://github.com/Jacckisback/eclair-cms/blob/main/docs/GUIDE.pt-BR.md) | [README.pt-BR.md](https://github.com/Jacckisback/eclair-cms/blob/main/README.pt-BR.md) |
| Chino simplificado | [GUIDE.zh-CN.md](https://github.com/Jacckisback/eclair-cms/blob/main/docs/GUIDE.zh-CN.md) | [README.zh-CN.md](https://github.com/Jacckisback/eclair-cms/blob/main/README.zh-CN.md) |

### Las 13 secciones de la guía oficial

1. Instalación: requisitos, pasos, los 4 tipos de sitio, primeros pasos.
2. Funciones en detalle: velocidad, SEO, GEO, editor de bloques.
3. Uso diario: la tabla «Quiero… / Dónde» y los atajos.
4. Modo Visual.
5. Direcciones de arte, con «Imagina mi dirección con la IA» y la puntuación de diseño.
6. Temas.
7. Tienda: apertura, fichas de producto, Stripe, PayPal, Revolut Business, Google Shopping.
8. Asistente IA, con «Crear una página con IA».
9. Conector MCP (Claude y ChatGPT).
10. Seguridad.
11. Actualizar, hacer copias de seguridad, mudarse.
12. Solución de problemas, con la configuración de Nginx.
13. Para desarrolladores: estructura de carpetas, pruebas, creación del archivo de descarga.

### Descargar el archivo oficial

El archivo ZIP [eclair-cms-1.8.0.zip](https://github.com/Jacckisback/eclair-cms/raw/main/dist/eclair-cms-1.8.0.zip) pesa 480 KB. Contiene la carpeta `eclair` (su contenido es lo que subes a tu hosting), un archivo `LISEZ-MOI.txt` en francés que resume la instalación en tres pasos, la licencia MIT (`LICENSE.txt`) y los avisos de los componentes de terceros (`THIRD-PARTY-NOTICES.txt`). El paso a paso completo está en [Instalar Éclair paso a paso](https://eclair.academy/es/rutas/principiante/instalar-eclair).

> **Ten el ZIP a mano** — El archivo `LISEZ-MOI.txt` también recuerda qué hacer si olvidas la contraseña. Si guardas el ZIP entre tus documentos, te sacará de apuros incluso sin conexión.

## ¿Cómo se organiza la documentación de Éclair en la academia?

Las lecciones de las rutas te enseñan a hacer las cosas, paso a paso. Las páginas de referencia sirven cuando buscas un detalle concreto: un campo, un archivo, una dirección o un mensaje de error.

| Página | Lo que encontrarás |
| --- | --- |
| [Referencia de los 18 bloques](https://eclair.academy/es/documentacion/bloques) | La función de cada bloque, sus campos exactos, el buen uso, la trampa que evitar, los atajos de teclado y el pegado inteligente. |
| [Referencia de los ajustes](https://eclair.academy/es/documentacion/ajustes) | Las 8 pestañas de los Ajustes campo por campo, y después Mi perfil, Usuarios, Seguridad, Menús, Redirecciones y Categorías. |
| [Archivos, carpetas y direcciones](https://eclair.academy/es/documentacion/archivos) | La estructura de `eclair/`, el contenido de `data/`, `eclair-config.php`, el `.htaccess` explicado, Nginx, las copias de seguridad y las direcciones generadas. |
| [Solución de problemas](https://eclair.academy/es/documentacion/solucion-de-problemas) | Los problemas conocidos clasificados por síntoma, con una tabla de diagnóstico rápido. |
| [Glosario](https://eclair.academy/es/documentacion/glosario) | 50 términos de la web, el SEO, el GEO, la seguridad y la IA, definidos en una o dos frases. |
| [Historial de versiones](https://eclair.academy/es/documentacion/versiones) | Lo que ha cambiado de la 1.0.0 a la 1.8.0, y el procedimiento de actualización. |
| [Trucos y consejos](https://eclair.academy/es/trucos) | Trucos verificados, clasificados por tema, cada uno enlazado a su lección. |
| [Preguntas frecuentes](https://eclair.academy/es/preguntas-frecuentes) | 25 respuestas breves sobre Éclair y sobre la academia. |

## Quiero…: ¿dónde está en la administración?

Esta tabla retoma la de la guía oficial y la completa. La última columna indica la lección que explica la tarea paso a paso.

| Quiero… | Dónde | Lección |
| --- | --- | --- |
| Escribir un artículo | Panel › **Escribir un artículo** | [Primer artículo](https://eclair.academy/es/rutas/principiante/primer-articulo) |
| Pedirle a la IA un artículo, una página o una imagen | Campo **¿Qué quieres crear hoy?** del panel, o **Asistente IA** (`Ctrl+J`) | [Asistente IA](https://eclair.academy/es/rutas/ia-mcp/asistente-ia) |
| Hacer que la IA componga una página completa | Nueva página › **Crear con IA** | [Crear con IA](https://eclair.academy/es/rutas/ia-mcp/crear-pagina-ia) |
| Editar una página tal como se ve | Editor › **Visual** | [Modo Visual](https://eclair.academy/es/rutas/intermedio/modo-visual) |
| Editar una página desde el sitio | Botón **✏️ Editar**, visible solo cuando has iniciado sesión | [Administración](https://eclair.academy/es/rutas/principiante/administracion) |
| Cambiar el tema, el logo, el color o las fuentes | Ajustes › Apariencia | [Temas](https://eclair.academy/es/rutas/intermedio/temas-apariencia) |
| Elegir una dirección de arte | Ajustes › Apariencia › **Dirección de arte** | [Direcciones de arte](https://eclair.academy/es/rutas/intermedio/direcciones-artisticas) |
| Añadir mi propio CSS | Ajustes › Apariencia › **CSS personalizado** | [CSS](https://eclair.academy/es/rutas/intermedio/css-personalizado) |
| Abrir la tienda | Ajustes › Tienda | [Tienda](https://eclair.academy/es/rutas/intermedio/tienda) |
| Añadir un producto | Contenidos › **+ Producto** | [Tienda](https://eclair.academy/es/rutas/intermedio/tienda) |
| Elegir la página de inicio | Ajustes › General | [Páginas y menús](https://eclair.academy/es/rutas/principiante/paginas-menus-inicio) |
| Permitir o bloquear las IA | Ajustes › IA & GEO | [GEO](https://eclair.academy/es/rutas/intermedio/geo-ia) |
| Activar el asistente IA | Ajustes › Asistente IA | [Asistente IA](https://eclair.academy/es/rutas/ia-mcp/asistente-ia) |
| Conectar Claude o ChatGPT | Ajustes › Asistente IA › **Permitir conexiones MCP** | [Claude](https://eclair.academy/es/rutas/ia-mcp/conectar-claude) |
| Conectar Google Search Console | Ajustes › SEO | [Ajustes esenciales](https://eclair.academy/es/rutas/principiante/ajustes-esenciales) |
| Añadir un enlace al menú | Menús | [Páginas y menús](https://eclair.academy/es/rutas/principiante/paginas-menus-inicio) |
| Redirigir una dirección antigua | Redirecciones | [SEO](https://eclair.academy/es/rutas/intermedio/seo) |
| Crear una categoría | Categorías | [Blog y categorías](https://eclair.academy/es/rutas/intermedio/blog-categorias) |
| Enlazar dos traducciones | Editor › Documento › **Traducción de…** | [Multilingüe](https://eclair.academy/es/rutas/intermedio/sitio-multilingue) |
| Restaurar una versión anterior | Editor › **Historial de versiones** | [Primer artículo](https://eclair.academy/es/rutas/principiante/primer-articulo) |
| Leer los mensajes del formulario | Mensajes | [Formulario](https://eclair.academy/es/rutas/principiante/formulario-contacto) |
| Invitar a un redactor | Usuarios › **Invitar a alguien** | [Seguridad](https://eclair.academy/es/rutas/intermedio/seguridad-diaria) |
| Activar la verificación en dos pasos | Mi perfil › **Verificación en dos pasos (2FA)** | [Seguridad](https://eclair.academy/es/rutas/intermedio/seguridad-diaria) |
| Descargar una copia de seguridad | Seguridad › **Copia de seguridad** | [Seguridad](https://eclair.academy/es/rutas/intermedio/seguridad-diaria) |
| Vaciar la caché | Ajustes › Avanzado › **Vaciar la caché** | [Mantenimiento](https://eclair.academy/es/rutas/experto/seguridad-avanzada) |
| Cambiar la dirección de la administración | Ajustes › Avanzado › **Dirección de la administración** | [Mantenimiento](https://eclair.academy/es/rutas/experto/seguridad-avanzada) |

## ¿Cuál es la versión actual de Éclair?

La versión actual es la **1.8.0**, publicada el 1 de noviembre de 2026. Trae 12 direcciones de arte, «Imagina mi dirección con la IA», la puntuación de diseño, una puntuación Lighthouse de 100 en las cuatro categorías con cuatro direcciones y un archivo de 480 KB. Todas las novedades desde la 1.0.0 están en el [historial de versiones](https://eclair.academy/es/documentacion/versiones).

La administración no muestra el número de versión. Para conocerlo, abre el archivo `index.php` en la raíz de tu sitio (por FTP o con el gestor de archivos de tu proveedor de hosting): la línea `define('ECLAIR_VERSION', '1.8.0');` lo indica.

## ¿Cómo conseguir ayuda?

1. Busca tu síntoma en [Solución de problemas](https://eclair.academy/es/documentacion/solucion-de-problemas): cada mensaje de error conocido tiene allí su solución.
2. Recorre las [preguntas frecuentes](https://eclair.academy/es/preguntas-frecuentes), y el [glosario](https://eclair.academy/es/documentacion/glosario) si un término te frena.
3. Anota la referencia del error: la página «Oups, un court-circuit.», que siempre aparece en francés, muestra una **Référence** que encontrarás también en **Seguridad** › **Últimos errores técnicos**.
4. Abre una solicitud en las [issues del repositorio de GitHub](https://github.com/Jacckisback/eclair-cms/issues) con tu versión de Éclair, tu versión de PHP, tu proveedor de hosting, lo que hiciste, lo que pasó y la referencia del error.

> **No publiques nunca tus secretos** — Una issue de GitHub es pública. No pegues en ella contraseñas, códigos de recuperación, claves de API ni archivos de la carpeta `data/`: contiene tus cuentas, tus ajustes y las claves secretas de tu sitio.

¿Un error o un fragmento poco claro en una lección de la academia? Avísanos desde la página de [Contacto](https://eclair.academy/es/contacto).

## ¿Por dónde empezar según tu nivel?

- [Ruta Principiante](https://eclair.academy/es/rutas/principiante): 9 lecciones, desde la preparación del hosting hasta los ajustes previos al lanzamiento.
- [Ruta Intermedia](https://eclair.academy/es/rutas/intermedio): 10 lecciones sobre el modo Visual, el diseño, el SEO, el GEO, los sitios multilingües, la tienda y la seguridad.
- [Ruta IA y MCP](https://eclair.academy/es/rutas/ia-mcp): 7 lecciones sobre el asistente integrado y sobre cómo gestionar tu sitio desde Claude o ChatGPT.
- [Ruta Experto](https://eclair.academy/es/rutas/experto): 8 lecciones sobre la arquitectura, Nginx, el rendimiento, la migración y el trabajo en agencia.
- Para elegir dónde alojar tu sitio: [Elegir tu alojamiento](https://eclair.academy/es/alojamiento).

[Empezar la ruta Principiante](https://eclair.academy/es/rutas/principiante)

## Preguntas frecuentes

### ¿Existe la documentación oficial de Éclair en español?

Sí. La guía completa y el README existen en español y en otros 6 idiomas: francés, inglés, alemán, italiano, portugués (Brasil) y chino simplificado. Los enlaces directos están en la tabla del principio de esta página.

### ¿Dónde informo de un fallo de Éclair?

En las issues del repositorio de GitHub de Éclair. Indica tu versión de Éclair y de PHP, tu proveedor de hosting y la referencia del error, pero nunca una contraseña ni una clave de API.

### ¿Las páginas de referencia sustituyen a las lecciones?

No. Las lecciones te enseñan a hacer las cosas, paso a paso; la documentación de Éclair sirve para comprobar un detalle concreto. Si estás descubriendo Éclair, empieza por la [ruta Principiante](https://eclair.academy/es/rutas/principiante).