Documentación
Todo sobre Ehundu: un recorrido para empezar, guías cortas, la hoja de referencia rápida y el contrato completo del formato.
Versión 0.16
Ehundu compila una carpeta de Markdown, datos y plantillas Twig en un sitio de HTML plano, y funciona en cualquier alojamiento con PHP. Si es la primera vez, empieza por Tu primer sitio: en unos minutos tienes algo funcionando. Después, las guías explican una idea cada una. Si ya lo conoces, la hoja rápida te ahorra buscar, y la referencia lo tiene todo.
La documentación está en español, como el formato. La entrada (Primeros pasos, las guías y los andamios) tiene también su versión en inglés; la referencia, no.
Empezar
Un sitio funcionando en unos minutos, con un andamio o desde cero, y una hoja para tenerlo todo a mano.
- Empieza con un andamioQué es un andamio de Ehundu, cómo crear uno con Composer o desde GitHub y qué cambiar primero para hacerlo tuyo.
- Tu primer sitioInstala Ehundu, crea un sitio con un menú y un blog, míralo en el navegador y publícalo.
- Hoja de referencia rápidaLas órdenes, la estructura de un proyecto, los campos, las funciones de las plantillas y los atajos, en una sola página.
Guías
Una idea por página, con el ejemplo primero.
- La estructura de un proyectoQué guarda cada carpeta, cómo se convierte en direcciones y qué no debes versionar.
- Plantillas y atajosCómo se envuelve una página en HTML con Twig, qué variables tienes a mano y cómo crear un atajo propio para el Markdown.
- Varios idiomasUn sitio en dos o más idiomas con un fichero por idioma, con su selector, sus menús y sus fechas.
- Desplegar el sitioCómo subes el sitio a un servidor, qué sube y qué borra Ehundu, y qué hacer cuando cambias de dirección.
- Un alojamiento compartidoQué necesita el servidor, dónde conviene compilar y el .htaccess que más vas a usar en un alojamiento con Apache.
- Migrar desde EleventyQué se traduce casi tal cual, qué cambia de nombre y qué no tiene equivalente, y cómo comprobar que el sitio nuevo sale como el viejo.
- Migrar desde JoomlaCómo reconstruir con Ehundu un sitio hecho con Joomla, conservando sus direcciones, y qué redirigir en el .htaccess.
Referencia
El contrato completo, para cuando necesites el detalle exacto.
- El formato de un proyectoEl contrato: carpetas, datos, campos, URL, colecciones, plantillas, Markdown, atajos, salida y varios idiomas.
- El esquema de un proyectoesquema.json: qué tipos de contenido y qué campos puede editar un editor.
- La biblioteca PHP y la orden de consolaLo que se promete de la biblioteca PHP y de la orden ehundu.
- La compilación incrementalCómo se rehace solo lo que un cambio afecta, y cuánta memoria pide.
- El desplieguePublicar en una carpeta, por FTP, SFTP o en S3.
- La previsualizaciónehundu servir: un servidor local que rehace solo lo que cambia.