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.
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
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.
Y el modelo C4 explica lo mismo desde el punto de vista del lector:
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:
- Sube el original a un bucket privado. El original guarda los datos EXIF y el GPS, y nunca sale a internet.
- Hace cuatro versiones WebP sin metadatos, y las sube al bucket público.
- Escribe
media.yamljunto 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.

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 valores: ¿cuál es la probabilidad de que dos ficheros distintos tengan el mismo nombre?
Es el problema del cumpleaños. Con ficheros y valores posibles:
Con las 1.798 notas del blog y unas 10.000 imágenes, : 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.

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.