Empieza con un andamio

Un andamio es un proyecto de Ehundu con la estructura ya montada: las carpetas, las plantillas, el CSS y unas páginas de ejemplo que compilan sin avisos. No es un generador de código que te deja ficheros a medias, sino un sitio entero que ya funciona. Lo copias, cambias los textos y los datos, y es tuyo desde ese momento, sin nada que lo ate al andamio del que saliste.

Los hay para seis casos: un sitio de presentación mínimo, un blog, una documentación, un portfolio, un negocio local y una web en castellano y euskera. Cada uno tiene su ficha con capturas, lo que trae y su demo publicada en la sección de Andamios, que es el mejor sitio para ver cuál te encaja antes de descargar nada.

Si dudas entre el mínimo y el de negocio, el mínimo es el punto de partida más corto, con cuatro páginas, para empezar de cero con lo justo. El de negocio es para quien tiene un local abierto y necesita horarios, ubicación y textos legales.

Los seis compilan sin avisos con cada versión de Ehundu, están escritos en español y no llevan JavaScript. Lo que sigue es cómo crear uno.

Con Composer¶

Necesitas PHP 8.4 o superior y Composer (se abre en una pestaña nueva). Crea el proyecto, que instala también el motor, y entra en él:

composer create-project ehundu/andamio-blog mi-blog
cd mi-blog

Cambia andamio-blog por andamio-minimo, andamio-documentacion, andamio-portfolio, andamio-negocio o andamio-multilingue si prefieres otro. Y ya puedes previsualizarlo:

composer servir

Abre http://127.0.0.1:8000/. Cada vez que guardes un cambio, recarga la página: se rehace solo lo que hace falta.

Desde GitHub¶

Cada andamio es un repositorio de plantilla, con el botón «Use this template», que crea un repositorio tuyo con sus ficheros. También puedes descargar el zip. Están todos en la organización github.com/ehundu (se abre en una pestaña nueva), con el nombre del paquete: por ejemplo, ehundu/andamio-blog. En los dos casos, instala el motor una vez:

composer install

Las tres órdenes¶

Los seis andamios traen estas órdenes de Composer, que son las de Ehundu con otro nombre:

composer servir      # lo previsualiza en http://127.0.0.1:8000/
composer compilar    # deja el sitio terminado en la carpeta salida/
composer desplegar   # lo compila y lo sube al servidor de sitio.yml

Lo primero que cambiar¶

1. En sitio.yml, el nombre y la dirección del sitio.
2. En datos/, tus datos: el nombre, el correo, el menú.
3. En contenido/, los textos.
4. En publico/css/estilos.css, los colores, que están al principio en variables.

Cada andamio trae un README.md con esto mismo y con los pasos para publicarlo. Cuando quieras entender cómo está hecho, Tu primer sitio construye uno parecido paso a paso, y las guías explican la estructura de un proyecto y las plantillas y los atajos.