El blog de fedi.ovh

hola

2026-05-25T00:00:00Z

Escribe aqui el post.

otro

2026-05-25T00:00:00Z

# Esto es una prueba

Esto es una prueba

Esto es una prueba

esto es una prueba

ls -all

ps aux

Esto es la prueba
Esto es la prueba
Esto es la prueba
Esto es la prueba

texto

Publicar el sitio en produccion

2026-05-18T00:00:00Z

Una vez el blog se ve bien en local, llevarlo a produccion es trivial porque public/ es solo HTML, CSS y SVG. No hay backend que provisionar, ni base de datos, ni servicios sistema que mantener.

El esquema usado aqui:

flujo:
  fuente -> build -> public/ -> servidor estatico -> dominio publico
componentes:
  servidor estatico   : BusyBox httpd en una instancia Alpine
  proxy externo       : Pangolin con TLS Let's Encrypt
  dominio             : blog.fedi.ovh

En el servidor Alpine se ejecuta exactamente el mismo blog.sh build que en local. La unica diferencia es que el comando que mantiene el servidor en marcha no es serve sino httpd ejecutado como servicio:

httpd -f -p 80 -h /var/www/blog/public

O lanzado bajo supervisor: supervise-daemon, openrc-service, o un tmux/screen persistente. En esta instancia se usa supervise-daemon para que httpd se reinicie solo si cae.

El proxy externo (Pangolin) termina TLS en blog.fedi.ovh y reenvia HTTP plano a la instancia. La instancia no necesita certificados ni configuracion HTTPS propia.

Para actualizar el blog tras editar un post, basta con sincronizar el repositorio en el servidor y ejecutar build:

git pull
./blog.sh build

httpd sirve los HTML directamente del disco, no hace falta reiniciarlo. El proximo request ya ve la version nueva.

Parar el servidor

2026-05-17T00:00:00Z

El servidor que lanza blog.sh serve corre en primer plano. La forma normal de pararlo es pulsar Ctrl+C en el mismo terminal donde lo arrancaste.

Internamente blog.sh ejecuta httpd (o python) con exec, asi que el proceso del script se reemplaza por el del servidor. Eso significa que matar el servidor mata el script: no quedan procesos residuales.

Si por alguna razon el terminal se perdio (cerraste la ventana, se desconecto la sesion SSH) y el servidor sigue ejecutandose, puedes encontrarlo y matarlo manualmente:

pgrep httpd
kill <PID>

O bien para todos los httpd en marcha:

killall httpd

En sistemas donde se uso python como fallback se sustituye httpd por python3 en los comandos anteriores.

Tras parar el servidor, si quieres dejar el directorio public/ limpio:

./blog.sh clean

Esto borra todos los HTML, el atom y los assets generados. Las fuentes (posts, pages, templates, style.css, assets) quedan intactas.

Iniciar el servidor de desarrollo

2026-05-16T00:00:00Z

Para previsualizar el blog en local:

./blog.sh serve

El comando hace dos cosas en orden:

Primero ejecuta un build limpio para regenerar public/ desde cero.

Despues arranca un servidor HTTP estatico en el puerto 8000 sirviendo el contenido de public/. La salida confirma el directorio servido:

serving /home/usuario/simple-blog/public on 0.0.0.0:8000 (Ctrl+C para parar)

El servidor detecta automaticamente que herramienta usar segun lo que este instalado. Preferencia: httpd de BusyBox primero, python3 despues, python como ultimo recurso. En Alpine usa httpd; en un portatil con Python instalado usa python3.

Para acceder al blog se abre el navegador en http://localhost:8000/.

Cualquier cambio en el codigo fuente (posts, pages, plantillas, CSS) requiere parar el servidor y volver a ejecutar serve, ya que el build solo se ejecuta al inicio.

Estructura de un post

2026-05-15T00:00:00Z

Cada post es un fichero de texto plano dividido en dos partes: el frontmatter (metadatos) y el cuerpo (contenido).

El frontmatter va al principio y termina con la primera linea en blanco. Los campos disponibles son:

title       : titulo visible de la entrada
date        : fecha en formato YYYY-MM-DD
slug        : identificador para la URL, opcional
category   : una sola categoria
tags        : lista separada por comas
description : resumen corto, sale en el listado y en el Atom

Si no especificas slug, se genera a partir del titulo. La categoria genera una pagina dedicada en categorias/, y cada tag genera una pagina dedicada en tags/.

El cuerpo es texto normal. Lineas separadas por una linea en blanco forman parrafos. Para bloques de codigo se usan tres backticks como delimitador, opcionalmente con el nombre del lenguaje:

for f in posts/*.txt; do
    echo "procesando $f"
done

El renderizador esta escrito en awk y mantiene el formato a proposito minimal: parrafos y bloques de codigo. Nada de markdown completo, nada de extensiones.

Escribir una nueva entrada

2026-05-14T00:00:00Z

Para crear una entrada nueva se usa el comando new pasando el titulo entre comillas:

./blog.sh new "Titulo del post"

Esto genera un fichero en posts/ con el nombre del dia mas el slug del titulo, por ejemplo posts/2026-05-14-titulo-del-post.txt, y deja dentro una plantilla lista para rellenar:

title: Titulo del post
date: 2026-05-14
slug: titulo-del-post
category:
tags:
description:

Escribe aqui el post.

El bloque de cabecera se llama frontmatter y termina con la primera linea en blanco. Todo lo que va por debajo es el cuerpo del post.

A partir de ahi solo hay que editar el fichero con cualquier editor de texto y guardar. El proximo build lo convertira a HTML y lo añadira al indice automaticamente.