Blog ini sudah lama memakai tema hugo-bearneo yang saya modifikasi seperlunya. Sempat saya merasa cukup puas, tapi ternyata ada beberapa hal yang mulai terasa tidak pas: bagian Posts dan Notes yang sebenarnya sama-sama cuma tulisan tetapi terpisah, halaman Now yang harus membangun ulang seluruh situs setiap dua jam hanya supaya satu baris “what I am listening to” berubah, dan feed RSS yang ternyata tidak valid.

Jadi kali ini saya memutuskan untuk membangun ulang blog ini dari nol, dan untuk pertama kalinya saya kerjakan bersama AI dari awal sampai akhir. Tulisan ini adalah catatannya: apa yang berubah, bagaimana cara kerjanya, dan bagian mana yang tetap harus saya periksa sendiri.

Kenapa membangun ulang

Awalnya sederhana: saya ingin blog ini terasa seperti menulis di buku catatan, bukan seperti mengoperasikan dasbor. Referensi utamanya ultimatemotherfuckingwebsite.com, satu kolom, tanpa card, tanpa gambar dekoratif, tanpa animasi. Isi tulisan itu sendiri yang jadi antarmuka.

Yang saya bawa dari situ adalah sifat pembatasannya: halaman harus tetap kosong kecuali isinya memang perlu. Yang saya buang adalah sisa-sisanya, yaitu kontras teks yang nyaris tak terbaca, font monospace yang membuat membaca jadi melelahkan, dan tata letak yang berlomba-lomba mengisi halaman dengan perabot.

Tampilan lama beranda blog: font Verdana dengan kolom selebar 720 piksel

Tampilan baru beranda blog: tipografi Inter dengan kolom selebar 646 piksel

Tema baru: sederhana

Tema barunya saya beri nama sederhana. Seluruh temanya sekarang tinggal di direktori themes/sederhana/, dan isinya cukup ringkas: satu file CSS, satu tombol terang/gelap, dan nol dependensi JavaScript dari pihak ketiga.

Beberapa keputusan yang saya ambil:

Tipografi

Saya sempat ingin mencoba font monospace karena terlihat teknis, tapi setelah diuji dengan mata dan bukan cuma dengan asumsi, ternyata membaca artikel panjang dengannya terasa melelahkan. Sekarang saya pakai Inter, self-hosted, di-fingerprint, dan hanya satu subset yang di-preload supaya halaman pertama tidak menunggu font.

Lebar barisnya dikunci di sekitar 65 karakter. Di layar 1280 piksel dengan font 17 piksel, itu berarti sekitar 646 piksel. Cukup sempit untuk enak dibaca, cukup lebar untuk tidak terasa sempit.

Tampilan lama artikel: font Verdana dengan lebar kolom 720 piksel

Tampilan baru artikel: tipografi Inter dengan lebar baris sekitar 65 karakter

Terang dan gelap

Tombol terang/gelap tetap ada, tapi sekarang preferensi dibaca sebelum halaman digambar sama sekali. Ada inline script kecil di <head> yang membaca localStorage dan langsung memasang data-theme di elemen <html>, jadi tidak ada kilatan putih di halaman yang dibuka dalam mode gelap.

Pilihan warna mode terang dan mode gelap saya uji dengan mengukur rasionya, bukan dengan mata saja. Warna teks sekunder yang semula #9c9c9c ternyata hanya punya rasio kontras 2,75:1, jauh di bawah ambang WCAG AA. Sekarang #767676 di terang dan #8f8f8f di gelap, dan semua pasangan warna lolos.

Tampilan mode gelap blog yang baru

Aksesibilitas

Ini bagian yang paling banyak memberi tahu saya kalau ada yang salah:

  • Hanya satu <h1> per halaman. Sempat ada dua, nama blog sekaligus judul halaman, yang sekarang sudah dibedakan: di beranda namanya <h1>, di halaman lain cuma <p>.
  • Struktur heading rapi: H1 → H2 → H3, tanpa melompat level.
  • Ukuran target sentuh minimal 24 piksel. Ada empat target yang lebih kecil, semuanya tautan inline di dalam teks berjalan, yang sebenarnya dikecualikan oleh WCAG.
  • prefers-reduced-motion dihormati.
  • CLS diukur 0,0000, tidak ada elemen yang bergeser setelah halaman dimuat.
  • Tabel dibungkus dalam wadah yang bisa digulir, tanpa kehilangan semantik tabel.

Posts dan Notes digabung

Dulu ada dua bagian terpisah: /posts/ untuk tulisan panjang dan /notes/ untuk catatan singkat. Sekarang keduanya jadi satu bagian, /posts/.

Alasannya sederhana: memang tidak ada bedanya. Catatan tiga paragraf dan artikel dua ribu kata itu sama-sama tulisan, perbedaan panjangnya cuma soal perhatian pembaca. Memecahkannya jadi dua bagian hanya bikin saya harus memutuskan dua kali di mana sebuah tulisan harus diletakkan.

Tampilan lama: artikel dan catatan masih terpisah

Tampilan baru: satu daftar, artikel dan catatan bercampur menurut waktu

Sebelas URL lama sekarang mengarah ke lokasi barunya lewat meta refresh, jadi tautan lama yang sudah dibagikan di mana-mana tidak ikut mati.

Kategori dan tag

Setelah digabung, saya hanya menyisakan satu sumbu kategori:

  • article untuk tulisan panjang
  • note untuk catatan singkat

Yang tersisa adalah tag, yang membawa topik: security, til, reflection, hugo, dan seterusnya. Jadi pertanyaan “ini tentang apa?” dijawab oleh tag, sementara “seberapa panjang?” dijawab oleh kategori.

Feed RSS yang akhirnya valid

Ini bagian yang paling memalukan, sekaligus paling memuaskan. Feed RSS blog ini ternyata tidak valid sama sekali, dan bukan karena satu karakter salah ketik, tapi karena satu hal fundamental: summary tulisan berisi entity HTML seperti &ldquo;, dan XML tidak mendefinisikan entity itu. Satu &ldquo; yang tidak di-escape membuat pembaca feed menolak seluruh file, bukan cuma satu entri.

Jadi 62 feed sekaligus tidak valid. Sekarang semuanya valid, dan perbaikannya cukup satu baris: transform.XMLEscape pada deskripsi.

Ada beberapa hal lain yang ikut dibetulkan:

  • <language> yang tadinya id sekarang id-ID, dan en-US untuk versi Inggris.
  • <author>ruzfi</author>. RSS 2.0 mendefinisikan <author> sebagai alamat email, jadi handle GitHub di sana itu tidak valid. Sekarang namanya lewat <dc:creator>, extension Dublin Core yang dipahami semua pembaca, dan <author> hanya muncul kalau isinya memang email.
  • Feed yang sebelumnya kosong: feed tag dan kategori sekarang benar-benar berisi.
  • XML sengaja tidak di-minify. Feed satu baris itu secara teknis valid, tapi mustahil dibaca atau di-diff. Jadi minify.disableXML menyala di hugo.toml, sementara HTML, CSS, dan JS tetap dikompres.

Hasil akhirnya: 60 feed, 231 entri, nol error.

Kartu sosial

Setiap tulisan punya kartu sendiri, gambar Open Graph yang muncul ketika tautannya dibagikan di media sosial. Kartu itu digenerate otomatis oleh tcardgen saat build, jadi tidak ada yang perlu saya buat manual setiap kali menulis.

Saya pakai dua template, satu untuk kartu artikel dan satu untuk kartu situs. Kartu artikel dibagi tiga baris: kategori di atas, judul di tengah, lalu baris bawah berisi logo, nama, tanggal, dan chip tag. Latar keduanya digenerate oleh skrip kecil di repo, sehingga logo dan nama tertanam di gambar dan hurufnya persis sama dengan yang dipakai tcardgen sendiri.

Kartu Open Graph untuk artikel ini

Halaman /now/ tanpa membangun ulang situs

Halaman /now/ menampilkan apa yang sedang saya dengarkan, tonton, dan main. Dulu halaman ini diisi oleh scheduled workflow GitHub Actions yang berjalan setiap dua jam, mengambil data dari Last.fm, Steam, dan Letterboxd, menulisnya ke data/now/enjoying_auto.toml, lalu commit, yang otomatis memicu build Hugo dan deploy ulang seluruh situs.

Jadi setiap dua jam, seluruh blog dibangun ulang demi beberapa baris data. Itu sekitar 36 workflow run per hari.

Sekarang urusannya dibalik: pengambilan data akan dipindahkan ke Cloudflare Workers. Sebuah Worker menjalankan cron trigger setiap 15 menit, menyimpan hasilnya di KV, lalu halaman /now/ mengambil JSON-nya di browser. Dengan begitu blognya sendiri tidak perlu dibangun ulang hanya karena data berubah.

Halaman Now yang baru

Rencana untuk halaman ini:

sebelumnyadengan Worker
workflow run per harihingga 361
Kesegaran data2 jam15 menit
Build ulang situstiap 2 jamhanya saat saya menulis

Satu run harian itu tetap berguna untuk mengisi fallback: statistik dua minggu terakhir yang sudah tertanam di HTML, supaya mesin pencari tetap punya sesuatu untuk diindeks, pembaca tanpa JavaScript tetap melihat isi, dan halaman tidak pernah kosong kalau Worker-nya sedang mati.

Bekerja sama dengan AI

Bagian yang paling menarik justru bukan hasil akhirnya, tapi bagian mana yang harus saya periksa sendiri.

AI sangat berguna untuk pekerjaan yang berulang dan mudah diukur: memindahkan berkas, mengganti referensi di banyak tempat sekaligus, menulis ulang template yang polanya sudah jelas, dan menulis test yang bisa langsung dijalankan. Untuk pekerjaan seperti memindahkan seluruh content dari dua struktur ke satu tanpa kehilangan alias, saya bahkan tidak perlu memeriksa setiap berkas satu per satu: cukup beberapa sampel, lalu menghitung jumlah file sebelum dan sesudah.

Tapi AI juga cukup yakin dalam hal-hal yang keliru. Berikut beberapa kesalahan yang harus saya temukan sendiri:

  • Aturan CSS global li + li { margin-top: 0.25rem } bocor ke flex tag cloud, sehingga setiap item setelah yang pertama terdorong 4 piksel ke bawah. Di layar, itu tampak seperti satu item sedikit lebih tinggi dari yang lain, masalah yang hanya terlihat kalau benar-benar dilihat dan bukan kalau di-lint.
  • text-wrap: pretty dan balance. Keduanya saya ukur, dan keduanya tidak melakukan apa pun. Saya hapus.
  • nowEndpoint masuk ke params.rss. Di TOML, setiap kunci setelah header tabel menjadi milik tabel itu. Akibatnya nilainya tidak terbaca sama sekali dan halamannya diam-diam tidak punya live feed, tanpa error dan tanpa peringatan.
  • with .url mengubah konteks. Di dalam blok itu, . sudah menjadi string URL, sehingga .title tidak ada lagi dan template gagal saat build.
  • JSON di dalam <script type="application/json"> di-escape sebagai string JavaScript oleh html/template, sehingga JSON.parse gagal dan semua label diam-diam jatuh ke teks cadangan.
  • i18n selalu men-template string-nya, jadi {plays} berubah jadi <no value>.
  • Tidak adanya autodiscovery feed di <head>, konsekuensinya peramban tidak pernah menampilkan ikon feed.
  • --minifyTypes ternyata bukan flag yang ada di Hugo 0.169.
  • Dan satu yang paling halus: saya sendiri yang memancing peringatan W3C dengan memberi saran URL ?v=2 untuk mem-cache validator. Validator membandingkan self reference dengan document location secara harfiah, dan ?v=2 membuatnya berbeda.

Pola yang saya ambil dari semua itu: AI bagus untuk mengerjakan, tapi hasil yang baru saya percaya. Setiap perubahan besar saya jalankan build, lalu saya periksa hasilnya di browser, bukan hanya build yang “sukses”. Sebagian besar bug di atas lolos build dengan status sukses.

Yang berubah dari sisi teknis

  • Tema baru, satu file CSS, tanpa dependensi JavaScript pihak ketiga
  • Satu bagian /posts/, bukan dua
  • Satu sumbu kategori, tag untuk topik
  • 60 feed valid
  • Kartu sosial Open Graph yang digenerate otomatis untuk setiap tulisan
  • Halaman /now/ dengan dua lapisan: live (15 menit) dan statistik dua minggu (harian)
  • Accessibility: kontras AA, satu h1, target sentuh, CLS nol

Penutup

Yang paling saya pelajari bukan soal ada AI atau tidak, tapi bahwa membangun ulang blog sendiri adalah kegiatan yang jauh lebih menyenangkan daripada yang saya kira. Saya menghabiskan waktu jauh lebih banyak untuk membaca ulang seluruh tulisan yang sudah ada daripada untuk menulis template-nya.

Kalau blog ini dibangun ulang besok, saya akan mulai dari hal yang sama: satu kolom, tulisan yang jadi antarmuka, dan tidak adanya perabot tambahan. Yang berbeda cuma cara saya pengerjaannya, dan siapa yang mengerjakan bagian yang membosankan.