Bagaimana satu entri menjadi tiga belas halaman

Di ipe.rest, sebuah entri ditulis sekali, dalam dua bahasa, dan sepuluh bahasa lainnya berasal dari berkas kecil di sampingnya. Lalu satu skrip membangun tiga belas halaman dari sebelas berkas itu. Begini jalannya.

Entri terakhir membahas tes yang berjalan sebelum halaman terbit. Entri ini membahas langkah sebelum itu: bagaimana halaman dibuat. Angkanya dari 10 November 2026, diambil dari repositori seperti sekarang dan dari commit yang menambahkan entri 8 November. Entri ini bertanggal 9 November tetapi ditulis pada tanggal 10, setelah dua hari tanpa entri. Kami lebih suka mengatakannya.

Apa yang kami tulis dengan tangan

Satu berkas sumber memuat teks bahasa Inggris dan Korea sebuah entri, beserta judul, deskripsi, ringkasan, dan data terstrukturnya. Sepuluh berkas lain memuat hal yang sama dalam bahasa Jerman, Prancis, Spanyol, Portugis, Rusia, Arab, Hindi, Jepang, Tionghoa, dan Indonesia: judul, heading, deskripsi, ringkasan, kutipan, dan isi. Kesepuluhnya adalah draf mesin, dan halaman yang dibangun darinya menyatakannya. Jadi ada sebelas berkas untuk setiap entri. Tidak ada halaman jurnal yang ditulis dengan tangan.

Apa yang dibangun skrip

Sebuah skrip bernama journal_sync.py membaca berkas-berkas itu dan menulis semua yang lain. Untuk setiap entri ia membuat dua belas halaman, satu per bahasa, dan halaman ketiga belas yang tak punya bahasa sendiri, yang mengarahkan pengunjung ke bahasa yang pernah mereka pilih atau yang dipakai peramban mereka. Ia juga menulis ulang dua belas halaman daftar, feed RSS, peta situs, dan llms.txt. Skrip kedua, home_sync.py, menyegarkan kartu untuk tiga entri terbaru di masing-masing dari dua belas beranda.

Sebelum menulis apa pun, skrip memeriksa sumbernya. Ia menolak entri yang tak punya tautan kanonis atau artikelnya, tidak memiliki satu heading per bahasa, memiliki data terstruktur yang rusak atau gambar yang hilang, atau masih membawa bidang templat yang belum diisi.

Ukuran satu entri

Commit yang menambahkan entri 8 November mengubah 245 berkas. Kami menulis 11 di antaranya. Satu lagi hanyalah satu baris, versi service worker. Sisanya, 233, dihasilkan otomatis: 13 halaman baru; 206 berkas jurnal lama, kebanyakan berubah satu atau dua baris karena setiap halaman mendaftar entri terbaru; serta dua belas beranda, peta situs, dan llms.txt.

Itulah sebabnya kami tak pernah mengedit halaman yang dihasilkan. Suntingan tangan akan tertimpa pada proses berikutnya, dan sebuah tes gagal jika ada berkas hasil yang sudah usang.

Yang tidak dilakukannya

Skrip yang membangun tiga belas halaman tak bisa menilai apakah sebuah entri layak dibaca, atau apakah draf mesin mengatakan apa yang kami maksud. Ia hanya memastikan halaman-halaman itu cocok dengan sumbernya dan satu sama lain. Membaca tetap tugas manusia.

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

Satu sumber, tiga belas halaman, dan tak satu baris pun diketik dua kali. Ketika sesuatu perlu berubah, kami mengubah sumbernya dan menjalankan skrip lagi.