Membangun Ulang Tampilan Blog Ini dengan Bantuan AI
Daftar isi
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.
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.
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.
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-motiondihormati.- 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.
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:
articleuntuk tulisan panjangnoteuntuk 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 “, dan XML tidak mendefinisikan entity itu. Satu “ 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 tadinyaidsekarangid-ID, danen-USuntuk 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.disableXMLmenyala dihugo.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.
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.
Rencana untuk halaman ini:
| sebelumnya | dengan Worker | |
|---|---|---|
| workflow run per hari | hingga 36 | 1 |
| Kesegaran data | 2 jam | 15 menit |
| Build ulang situs | tiap 2 jam | hanya 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: prettydanbalance. Keduanya saya ukur, dan keduanya tidak melakukan apa pun. Saya hapus.nowEndpointmasuk keparams.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 .urlmengubah konteks. Di dalam blok itu,.sudah menjadi string URL, sehingga.titletidak ada lagi dan template gagal saat build.- JSON di dalam
<script type="application/json">di-escape sebagai string JavaScript olehhtml/template, sehinggaJSON.parsegagal dan semua label diam-diam jatuh ke teks cadangan. i18nselalu men-template string-nya, jadi{plays}berubah jadi<no value>.- Tidak adanya autodiscovery feed di
<head>, konsekuensinya peramban tidak pernah menampilkan ikon feed. --minifyTypesternyata bukan flag yang ada di Hugo 0.169.- Dan satu yang paling halus: saya sendiri yang memancing peringatan W3C dengan memberi saran URL
?v=2untuk mem-cache validator. Validator membandingkan self reference dengan document location secara harfiah, dan?v=2membuatnya 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.
comments