Hola, oriolrius.blog
Apunt de prova: com funciona el blog nou, i tot el que un apunt pot mostrar.
Llegeix-lo en: CastellanoEnglish
Aquest és el primer apunt de oriolrius.blog. És una prova, però és una prova amb text real: explica com funciona el blog nou, i de passada mostra tots els elements que un apunt pot fer servir.
L'arquitectura en una imatge
El blog va començar el 31 de juliol del 2000. Durant 25 anys ha viscut en un WordPress. Ara el text de cada apunt és un fitxer Markdown dins d'un repositori Git, i el web és estàtic. Els fitxers binaris viuen en un altre lloc.
Text a Git, binaris a RustFS
Git és bo amb el text i dolent amb les fotos. Per això cada tipus de fitxer va al seu lloc:
| Què | On viu | Qui el veu | Exemple |
|---|---|---|---|
| Text de l'apunt | Git, content/posts/ |
Tothom (web estàtic) | ca.md, es.md, en.md |
| Llista de binaris | Git, media.yaml |
Només el build | claus i mides |
| Originals (amb EXIF i GPS) | RustFS, bucket privat | Ningú | foto-hacker.21ee6a29.jpg |
| Versions web | RustFS, bucket públic | Tothom | ….w960.webp |
Publicar un apunt pas a pas
La mateixa pila, amb icones
Els diagrames poden fer servir les biblioteques d'icones de PlantUML: logotips de tecnologies, Font Awesome, AWS, Azure, Kubernetes, C4 i més. Totes venen amb el servidor de PlantUML, i per tant funcionen sense internet.
I el model C4 explica el mateix des del punt de vista del lector:
On viuen les imatges
Les fotos, els àudios i els vídeos no entren a Git. Quan publico un apunt, l'eina blogmedia fa això:
- Puja l'original a un bucket privat. L'original guarda les dades EXIF i el GPS, i no surt mai a internet.
- Fa quatre versions WebP sense metadades, i les puja al bucket públic.
- Escriu
media.yamlal costat del text, i esborra el fitxer binari de la carpeta.
El Markdown continua dient ./foto-hacker.jpg. El web llegeix media.yaml i hi posa l'adreça del servidor de fitxers, amb totes les mides. El navegador tria la mida que necessita.

Mides de les imatges
Aquestes són les mides reals de la foto de dalt. L'original fa 14 MB; el navegador d'un mòbil en baixa 32 kB.
| Versió | Amplada | Alçada | Mida | Ús típic |
|---|---|---|---|---|
| Original (privat) | 3.456 px | 5.184 px | 14,0 MB | cap: no surt d'aquí |
w480 |
480 px | 720 px | 31,8 kB | mòbil |
w960 |
960 px | 1.440 px | 103,7 kB | portàtil |
w1600 |
1.600 px | 2.400 px | 305,1 kB | pantalla gran |
w2400 |
2.400 px | 3.600 px | 842,0 kB | pantalla retina |
Per què WebP
WebP ocupa molt menys que el JPEG original1, i tots els navegadors actuals el llegeixen. Les metadades no hi passen: el GPS de la foto queda només a l'original privat.
El codi
Tot el flux de treball cap en tres ordres. Si les vols copiar, el botó de cada bloc ho fa; o selecciona el text i prem Ctrl + C.
just media-up # RustFS i PlantUML locals
just media-publish content/posts/2026/11/16/hola-oriolrius-blog
just dev # http://localhost:18573
El fitxer media.yaml que en surt és text, i per tant Git el pot comparar entre versions:
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}
I aquesta és la línia de Python que decideix el nom de cada fitxer al bucket:
tag = sha[:8] # 8 caràcters hex del SHA-256
key = f"{prefix}/{stem}.{tag}.w{v.width}.webp" # el nom canvia si el contingut canvia
Una mica de matemàtiques
Com que el nom de cada fitxer porta el seu hash, el servidor pot dir als navegadors que el guardin per sempre (Cache-Control: immutable). Però 8 caràcters hexadecimals són només valors: quina és la probabilitat que dos fitxers diferents tinguin el mateix nom?
És el problema de l'aniversari. Amb fitxers i valors possibles:
Amb els 1.798 apunts del blog i unes 10.000 imatges, : un 1 %. A més, una col·lisió només és un problema si els dos fitxers són a la mateixa carpeta, perquè la clau també porta el camí de l'apunt. A la pràctica, el risc és zero.
25 anys en una imatge
Aquest gràfic és un PNG fet amb Python. Ha fet el mateix camí que la foto: de la carpeta de l'apunt al servidor d'objectes.

L'any 2004 té la barra taronja: 367 apunts, gairebé un cada dia. Després el ritme baixa, però el blog no s'atura.
Escric el que aprenc perquè no se m'oblidi, i el que visc per entendre-ho.
Què ve ara
- Disseny nou (opció A, «La pantalla»)
- Imatges a RustFS, fora de Git
- Cada apunt en català, castellà i anglès
- Diagrames, taules, fórmules i índex
- Migrar els 1.798 apunts del WordPress, amb les seves imatges
- Publicar-ho tot a oriolrius.blog
Detalls tècnics de l'entorn de desenvolupament
| Servei | Adreça | Per a què |
|---|---|---|
| Astro (dev) | http://localhost:18573 |
el web |
| RustFS S3 | http://localhost:19000 |
pujar i servir binaris |
| Consola RustFS | http://localhost:19001 |
veure els buckets |
| PlantUML | http://localhost:18574 |
diagrames en el build |
Cap d'aquests serveis no surt a internet: tot corre en Docker dins de l'ordinador.
Gràcies per llegir fins aquí. Si alguna cosa no funciona bé, l'apunt ho ensenyarà2.