Hola, oriolrius.blog

Nota de prueba: cómo funciona el blog nuevo, y todo lo que una nota puede mostrar.

Traducción del original en catalán. Léela en: CatalàEnglish

Esta es la primera nota de oriolrius.blog. Es una prueba, pero es una prueba con texto real: explica cómo funciona el blog nuevo, y de paso muestra todos los elementos que una nota puede usar.

La arquitectura en una imagen

El blog empezó el 31 de julio del 2000. Durante 25 años ha vivido en un WordPress. Ahora el texto de cada nota es un fichero Markdown dentro de un repositorio Git, y la web es estática. Los ficheros binarios viven en otro sitio.

Portátilgit.oriolrius.catk5content/(Markdown)blogmediaRepositoriooriolrius.blogGitea ActionsServidor Go+ web estáticaRustFS(buckets blog)OriolLectorescribejust media-publishoriginales + WebPgit pushtag v*imagen Dockeroriolrius.blogmedia.oriolrius.blog
De mi portátil al lector: el texto pasa por Git, los binarios por RustFS.

Texto en Git, binarios en RustFS

Git es bueno con el texto y malo con las fotos. Por eso cada tipo de fichero va a su sitio:

Qué Dónde vive Quién lo ve Ejemplo
Texto de la nota Git, content/posts/ Todo el mundo (web estática) ca.md, es.md, en.md
Lista de binarios Git, media.yaml Solo el build claves y tamaños
Originales (con EXIF y GPS) RustFS, bucket privado Nadie foto-hacker.21ee6a29.jpg
Versiones web RustFS, bucket público Todo el mundo ….w960.webp

Publicar una nota paso a paso

OriolblogmediaBucket privadoBucket p.blicomedia.yamlOriolblogmediaBucket privadoblog-originalsBucket públicoblogmedia.yamlOriolblogmediaBucket privadoblog-originalsBucket públicoblogmedia.yaml1just media-publish content/posts/…loop[para cada imagen]2SHA-256 y tamaños3sube el original4sube 4 versiones WebP5HEAD (comprueba tamaño y hash)6guarda la entrada7borra el fichero local8la carpeta solo tiene texto
Qué hace just media-publish con cada fichero binario.

La misma pila, con iconos

Los diagramas pueden usar las bibliotecas de iconos de PlantUML: logotipos de tecnologías, Font Awesome, AWS, Azure, Kubernetes, C4 y más. Todas vienen con el servidor de PlantUML, y por eso funcionan sin internet.

PortátilMarkdownblogmediaGitAstroServidor GoDockerRustFSLectoresescriboimágenesbuild
Las herramientas del blog, con sus logotipos.

Y el modelo C4 explica lo mismo desde el punto de vista del lector:

oriolrius.blog[System]Servidor Go[Go, imagen Docker] HTML estático, redirecciones,páginas de errorRustFS[S3] Imágenes, audio y vídeoLector Navegador o lector RSSGitea git.oriolrius.cat: código, textoy CIlee[HTTPS]descarga imágenes[HTTPS]publica[imagen Docker]
Modelo C4 (contenedores): qué ve el lector y de dónde viene.

Dónde viven las imágenes

Las fotos, los audios y los vídeos no entran en Git. Cuando publico una nota, la herramienta blogmedia hace esto:

  1. Sube el original a un bucket privado. El original guarda los datos EXIF y el GPS, y nunca sale a internet.
  2. Hace cuatro versiones WebP sin metadatos, y las sube al bucket público.
  3. Escribe media.yaml junto al texto, y borra el fichero binario de la carpeta.

El Markdown sigue diciendo ./foto-hacker.jpg. La web lee media.yaml y pone la dirección del servidor de ficheros, con todos los tamaños. El navegador elige el tamaño que necesita.

Retrato de Oriol delante de un portátil
La foto de la cabecera, servida desde el bucket público en cuatro tamaños.

Tamaños de las imágenes

Estos son los tamaños reales de la foto de arriba. El original ocupa 14 MB; el navegador de un móvil descarga 32 kB.

Versión Ancho Alto Tamaño Uso típico
Original (privado) 3.456 px 5.184 px 14,0 MB ninguno: no sale de aquí
w480 480 px 720 px 31,8 kB móvil
w960 960 px 1.440 px 103,7 kB portátil
w1600 1.600 px 2.400 px 305,1 kB pantalla grande
w2400 2.400 px 3.600 px 842,0 kB pantalla retina

Por qué WebP

WebP ocupa mucho menos que el JPEG original1, y todos los navegadores actuales lo leen. Los metadatos no pasan: el GPS de la foto queda solo en el original privado.

El código

Todo el flujo de trabajo cabe en tres órdenes. Si las quieres copiar, el botón de cada bloque lo hace; o selecciona el texto y pulsa Ctrl + C.

just media-up                                         # RustFS y PlantUML locales
just media-publish content/posts/2026/11/16/hola-oriolrius-blog
just dev                                              # http://localhost:18573

El fichero media.yaml que sale de ahí es texto, y por eso Git lo puede comparar entre versiones:

foto-hacker.jpg:
  sha256: 21ee6a29bb52cfdec438eab1d6303add5f721e8ab9a3ef8e21ddfdc646def10e
  bytes: 14016841
  original: posts/2026/11/16/hola-oriolrius-blog/foto-hacker.21ee6a29.jpg
  variants:
  - {width: 480, key: posts/2026/11/16/hola-oriolrius-blog/foto-hacker.21ee6a29.w480.webp}

Y esta es la línea de Python que decide el nombre de cada fichero en el bucket:

tag = sha[:8]                                   # 8 caracteres hex del SHA-256
key = f"{prefix}/{stem}.{tag}.w{v.width}.webp"  # el nombre cambia si cambia el contenido

Un poco de matemáticas

Como el nombre de cada fichero lleva su hash, el servidor puede decir a los navegadores que lo guarden para siempre (Cache-Control: immutable). Pero 8 caracteres hexadecimales son solo 2322^{32} valores: ¿cuál es la probabilidad de que dos ficheros distintos tengan el mismo nombre?

Es el problema del cumpleaños. Con nn ficheros y N=232N = 2^{32} valores posibles:

p(n)≈1−e−n(n−1)2N≈n2233p(n) \approx 1 - e^{-\frac{n(n-1)}{2N}} \approx \frac{n^2}{2^{33}}

Con las 1.798 notas del blog y unas 10.000 imágenes, p≈0,0116p \approx 0{,}0116: un 1 %. Además, una colisión solo es un problema si los dos ficheros están en la misma carpeta, porque la clave también lleva la ruta de la nota. En la práctica, el riesgo es cero.

25 años en una imagen

Este gráfico es un PNG hecho con Python. Ha hecho el mismo camino que la foto: de la carpeta de la nota al servidor de objetos.

Gráfico de barras de las notas publicadas por año, del 2000 al 2025
1.798 notas. El 2004 tuvo 367, el máximo.

El año 2004 tiene la barra naranja: 367 notas, casi una cada día. Después el ritmo baja, pero el blog no se para.

Escribo lo que aprendo para no olvidarlo, y lo que vivo para entenderlo.

Qué viene ahora

  • Diseño nuevo (opción A, «La pantalla»)
  • Imágenes en RustFS, fuera de Git
  • Cada nota en catalán, castellano e inglés
  • Diagramas, tablas, fórmulas e índice
  • Migrar las 1.798 notas del WordPress, con sus imágenes
  • Publicarlo todo en oriolrius.blog
Detalles técnicos del entorno de desarrollo
Servicio Dirección Para qué
Astro (dev) http://localhost:18573 la web
RustFS S3 http://localhost:19000 subir y servir binarios
Consola RustFS http://localhost:19001 ver los buckets
PlantUML http://localhost:18574 diagramas en el build

Ninguno de estos servicios sale a internet: todo corre en Docker dentro del ordenador.


Gracias por leer hasta aquí. Si algo no funciona bien, la nota lo enseñará2.

Notas

  1. Medida hecha con la foto de esta nota: el JPEG de 14 MB baja a 842 kB en WebP a 2.400 px, con calidad 82. ↩

  2. Esta nota es la prueba de todos los estilos. Si un elemento se ve mal aquí, también se verá mal en una nota real. ↩