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.

Portàtilgit.oriolrius.catk5content/(Markdown)blogmediaRepositorioriolrius.blogGitea ActionsServidor Go+ web estàticRustFS(buckets blog)OriolLectorescriujust media-publishoriginals + WebPgit pushtag v*imatge Dockeroriolrius.blogmedia.oriolrius.blog
Del meu portàtil al lector: el text passa per Git, els binaris per RustFS.

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

OriolblogmediaBucket privatBucket p.blicmedia.yamlOriolblogmediaBucket privatblog-originalsBucket públicblogmedia.yamlOriolblogmediaBucket privatblog-originalsBucket públicblogmedia.yaml1just media-publish content/posts/…loop[per cada imatge]2SHA-256 i mides3puja l'original4puja 4 versions WebP5HEAD (comprova mida i hash)6desa l'entrada7esborra el fitxer local8la carpeta només té text
Què fa just media-publish amb cada fitxer binari.

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.

PortàtilMarkdownblogmediaGitAstroServidor GoDockerRustFSLectorsescricimatgesbuild
Les eines del blog, amb els seus logotips.

I el model C4 explica el mateix des del punt de vista del lector:

oriolrius.blog[System]Servidor Go[Go, imatge Docker] HTML estàtic, redireccions,pàgines d'errorRustFS[S3] Imatges, àudio i vídeoLector Navegador o lector RSSGitea git.oriolrius.cat: codi, text i CIllegeix[HTTPS]baixa imatges[HTTPS]publica[imatge Docker]
Model C4 (contenidors): què veu el lector i d'on ve.

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ò:

  1. Puja l'original a un bucket privat. L'original guarda les dades EXIF i el GPS, i no surt mai a internet.
  2. Fa quatre versions WebP sense metadades, i les puja al bucket públic.
  3. Escriu media.yaml al 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.

Retrat de l'Oriol davant d'un portàtil
La foto de la capçalera, servida des del bucket públic en quatre mides.

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 2322^{32} valors: quina és la probabilitat que dos fitxers diferents tinguin el mateix nom?

És el problema de l'aniversari. Amb nn fitxers i N=232N = 2^{32} valors possibles:

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

Amb els 1.798 apunts del blog i unes 10.000 imatges, p≈0,0116p \approx 0{,}0116: 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.

Gràfic de barres dels apunts publicats per any, del 2000 al 2025
1.798 apunts. El 2004 en va tenir 367, el màxim.

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.

Notes

  1. Mesura feta amb la foto d'aquest apunt: el JPEG de 14 MB baixa a 842 kB en WebP a 2.400 px, amb qualitat 82. ↩

  2. Aquest apunt és la prova de tots els estils. Si un element es veu malament aquí, també es veurà malament en un apunt real. ↩