README

Un blog hecho con Ehundu, el generador de sitios estáticos en PHP. Es un andamio: la estructura de partida de un blog, con la lista de entradas partida en páginas, una página por etiqueta, un feed, un índice en cada entrada y entradas que se pueden dejar escritas para otro día. Cambias los textos, los datos y el CSS, y es tuyo.

Puedes verlo funcionando, sin instalar nada, en andamio-blog.ehundu.com.

Necesitas PHP 8.4 o superior y Composer.

Empezar

Si lo has creado con composer create-project, ya está todo instalado. Si has usado el botón «Use this template» de GitHub, o has descargado el zip, instala el motor:

composer install

Las tres órdenes que vas a usar:

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

Escribir una entrada

Copia una entrada de contenido/blog/entradas/, ponle un nombre nuevo (será su dirección: mi-entrada.md sale en /blog/mi-entrada/) y cambia su texto y su front matter: el título, la descripción, la fecha y las etiquetas. No hace falta tocar nada más: la entrada aparece en la lista, en la portada, en el feed y en la página de cada una de sus etiquetas. Una etiqueta nueva tiene su página sola.

Con una fecha futura, la entrada no se publica hasta ese día. Para verlas antes en tu ordenador:

composer servir -- --borradores

Qué hay en cada carpeta

sitio.yml                     el nombre, la dirección, el feed y adónde se publica
contenido/                    las páginas, en Markdown: cada fichero es una página
  blog/index.md               la lista de entradas, partida en páginas de diez
  blog/entradas/              las entradas; su _datos.yml les da lo que comparten
  etiqueta.md                 la plantilla de las páginas de etiqueta (agrupar)
datos/                        el menú y los datos del autor
plantillas/                   el HTML que envuelve cada tipo de página, con Twig
parciales/                    trozos de HTML que reutilizan las plantillas
publico/                      el CSS, las imágenes y el icono: se copia tal cual a la raíz

salida/ (el sitio compilado) y .ehundu/ (lo que recuerda el motor) los crea Ehundu y no se versionan.

Lo primero que cambiar

En sitio.yml, el nombre y la dirección del sitio, y el título del feed.
En datos/cliente.yml, tu nombre y tu correo; en datos/menus.yml, el menú.
Los textos de contenido/index.md, acerca.md y contacto.md, y las dos entradas de ejemplo (puedes borrarlas).
En publico/css/estilos.css, los colores: están al principio, en variables.

Publicarlo

Descomenta la sección despliegue de sitio.yml y rellénala. La contraseña no va ahí, porque sitio.yml se comparte: crea un fichero .secretos.yml en la raíz del proyecto, entre comillas simples:

despliegue:
  clave: 'la-contraseña'

Antes de subir nada, mira qué haría:

composer desplegar -- --simular

Y cuando todo cuadre, composer desplegar. La guía Desplegar el sitio explica los destinos (carpeta, FTP, SFTP y S3) y cómo decide Ehundu qué sube y qué borra. Como un sitio estático solo cambia cuando se vuelve a compilar, una entrada programada sale el día que toca si ese día se compila y se despliega.

Para seguir

Tu primer sitio, un recorrido paso a paso.
La hoja de referencia rápida, con todo lo que vas a necesitar cada día.
La documentación completa.

Licencia MIT.

ehundu / andamio-blog

Package info

Security

Statistics