Cómo una entrada se convierte en trece páginas

En ipe.rest una entrada se escribe una sola vez, en dos idiomas, y los otros diez salen de pequeños archivos a su lado. Después un script construye trece páginas a partir de esos once archivos. Así es como funciona.

La última entrada trató de las pruebas que corren antes de que una página se publique. Esta trata del paso anterior: cómo se hacen las páginas. Las cifras son del 10 de noviembre de 2026, tomadas del repositorio tal como está y del commit que añadió la entrada del 8 de noviembre. Esta entrada lleva fecha del 9 de noviembre, pero se escribió el 10, después de dos días sin ninguna. Preferimos decirlo.

Lo que escribimos a mano

Un archivo fuente contiene el texto en inglés y coreano de una entrada, junto con sus títulos, descripciones, resumen y datos estructurados. Otros diez archivos contienen lo mismo en alemán, francés, español, portugués, ruso, árabe, hindi, japonés, chino e indonesio: título, encabezado, descripción, resumen, extracto y cuerpo. Esos diez son borradores automáticos, y las páginas construidas con ellos lo indican. Eso da once archivos por entrada. Ninguna página del diario se escribe a mano.

Lo que construye el script

Un script llamado journal_sync.py lee esos archivos y escribe todo lo demás. Por cada entrada genera doce páginas, una por idioma, y una decimotercera sin idioma propio, que envía al visitante al idioma que eligió antes o al que usa su navegador. También reescribe las doce páginas de listado, el feed RSS, el mapa del sitio y llms.txt. Un segundo script, home_sync.py, actualiza las tarjetas de las tres entradas más recientes en cada una de las doce páginas de inicio.

Antes de escribir nada, el script revisa la fuente. Rechaza una entrada a la que le falta un enlace canónico o su artículo, que no tiene un encabezado por idioma, cuyos datos estructurados están rotos o le falta una imagen, o que aún conserva un campo sin rellenar de la plantilla.

El tamaño de una entrada

El commit que añadió la entrada del 8 de noviembre cambió 245 archivos. Escribimos 11 de ellos. Otro fue una sola línea, la versión del service worker. Los otros 233 se generaron: las 13 páginas nuevas; 206 archivos antiguos del diario, la mayoría cambiados en una o dos líneas porque cada página lista las últimas entradas; y las doce páginas de inicio, el mapa del sitio y llms.txt.

Por eso nunca editamos una página generada. Un cambio a mano se sobrescribiría en la siguiente ejecución, y una prueba falla si cualquier archivo generado está desactualizado.

Lo que esto no hace

Un script que construye trece páginas no puede saber si una entrada merece leerse, ni si un borrador automático dice lo que quisimos decir. Solo se asegura de que las páginas concuerden con sus fuentes y entre sí. La lectura sigue en manos de personas.

ipe(); // write once, generate the rest

Una fuente, trece páginas, y ni una línea escrita dos veces. Cuando algo debe cambiar, cambiamos la fuente y volvemos a ejecutar el script.