Wie aus einem Beitrag dreizehn Seiten werden

Auf ipe.rest wird ein Beitrag einmal geschrieben, in zwei Sprachen, und die anderen zehn kommen aus kleinen Dateien daneben. Ein Skript baut dann aus diesen elf Dateien dreizehn Seiten. So läuft das ab.

Der letzte Beitrag handelte von den Tests, die laufen, bevor eine Seite erscheint. Dieser handelt vom Schritt davor: wie die Seiten entstehen. Die Zahlen stammen vom 10. November 2026, aus dem Repository, wie es jetzt aussieht, und aus dem Commit, der den Beitrag vom 8. November hinzugefügt hat. Dieser Beitrag trägt das Datum 9. November, wurde aber am 10. geschrieben, nach zwei Tagen ohne einen. Das sagen wir lieber offen.

Was wir von Hand schreiben

Eine Quelldatei enthält den englischen und den koreanischen Text eines Beitrags samt Titeln, Beschreibungen, Zusammenfassung und strukturierten Daten. Zehn weitere Dateien enthalten dasselbe auf Deutsch, Französisch, Spanisch, Portugiesisch, Russisch, Arabisch, Hindi, Japanisch, Chinesisch und Indonesisch: Titel, Überschrift, Beschreibung, Zusammenfassung, Auszug und Haupttext. Diese zehn sind maschinelle Entwürfe, und die daraus gebauten Seiten sagen das. So kommen wir auf elf Dateien pro Beitrag. Keine Journalseite wird von Hand geschrieben.

Was das Skript baut

Ein Skript namens journal_sync.py liest diese Dateien und schreibt alles andere. Für jeden Beitrag erzeugt es zwölf Seiten, eine pro Sprache, und eine dreizehnte ohne eigene Sprache, die Besucher zu der Sprache schickt, die sie zuvor gewählt haben, oder zu der, die ihr Browser verwendet. Außerdem schreibt es die zwölf Listenseiten, den RSS-Feed, die Sitemap und llms.txt neu. Ein zweites Skript, home_sync.py, aktualisiert auf jeder der zwölf Startseiten die Karten der drei neuesten Beiträge.

Bevor es etwas schreibt, prüft das Skript die Quelle. Es lehnt einen Beitrag ab, dem ein kanonischer Link oder der Artikel fehlt, der nicht genau eine Überschrift pro Sprache hat, dessen strukturierte Daten defekt sind, dem ein Bild fehlt oder in dem noch ein nicht ausgefülltes Feld aus der Vorlage steht.

Wie groß ein Beitrag ist

Der Commit, der den Beitrag vom 8. November hinzufügte, änderte 245 Dateien. 11 davon haben wir geschrieben. Eine weitere war eine einzelne Zeile, die Version des Service Workers. Die übrigen 233 wurden erzeugt: die 13 neuen Seiten; 206 ältere Journaldateien, meist um eine oder zwei Zeilen geändert, weil jede Seite die neuesten Beiträge aufführt; und die zwölf Startseiten, die Sitemap und llms.txt.

Deshalb bearbeiten wir eine erzeugte Seite nie. Eine Änderung von Hand würde beim nächsten Lauf überschrieben, und ein Test schlägt fehl, sobald irgendeine erzeugte Datei veraltet ist.

Was das nicht leistet

Ein Skript, das dreizehn Seiten baut, kann nicht sagen, ob ein Beitrag lesenswert ist oder ob ein maschineller Entwurf das sagt, was wir meinten. Es stellt nur sicher, dass die Seiten mit ihren Quellen und untereinander übereinstimmen. Das Lesen bleibt bei Menschen.

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

Eine Quelle, dreizehn Seiten, und keine Zeile davon doppelt getippt. Wenn sich etwas ändern muss, ändern wir die Quelle und starten das Skript erneut.