fiqhan.dev

Situs ini adalah satu-satunya proyek di mana saya sekaligus menjadi pengembang dan seluruh kliennya. Artinya setiap keputusan sepenuhnya milik saya, dan tidak ada siapa pun yang bisa saya salahkan untuk keputusan yang ternyata keliru.

Ini situs statis Hugo. Tanpa basis data, tanpa runtime di sisi server, tanpa apa pun yang perlu ditambal pukul dua pagi.

Mengapa Hugo

Saya ingin portofolio yang benar-benar akan saya perbarui. Syarat itu langsung menyingkirkan apa pun yang membuat proses menerbitkan tulisan berarti mengingat-ingat cara kerja panel admin.

Dengan Hugo, satu studi kasus baru hanyalah satu file Markdown. Commit, lalu semenit kemudian sudah tayang. Keseluruhan situs, sekitar 130 halaman dalam dua bahasa, dibangun ulang hanya dalam beberapa detik di laptop saya.

Bagaimana ia disusun

Modul yang dapat dikomposisi, bukan monolit

Alih-alih satu tema besar yang harus saya fork dan pelihara sendiri, situs ini menarik sekitar dua puluh lima Hugo Module sebagai dependensi: pencarian, pemrosesan gambar, manifest PWA, gzip caching, galeri lightbox, daftar isi, dan social sharing.

Apa pun yang ingin saya sesuaikan, saya timpa di direktori layouts/ milik saya sendiri. Tema upstream tetap di upstream, sehingga memperbaruinya tidak menghapus pekerjaan saya.

Bagian itulah yang paling saya sarankan bagi siapa pun yang baru memulai situs Hugo. Menimpa lebih baik daripada fork.

Tailwind tanpa langkah build kedua

Tailwind v4 dikompilasi oleh Hugo sendiri melalui css.TailwindCSS, memakai file statistik yang Hugo hasilkan sambil merender. Jadi tidak ada watcher npm paralel yang harus terus berjalan, dan tidak ada peluang CSS serta template berjalan ke arah yang berbeda.

Satu perintah menjalankan semuanya. hugo server.

Dua bahasa, satu basis kode

Konten Indonesia dan Inggris tinggal di pohon konten terpisah, dengan bahasa Indonesia dilayani di bawah /id/. Navigasi, teks antarmuka, dan metadata seluruhnya dilokalkan, dan sebuah halaman hanya ada dalam suatu bahasa jika filenya memang ada.

Menjaga kedua pohon tetap sejajar adalah pekerjaan yang benar-benar berkelanjutan. Saya pernah beberapa kali memergoki diri sendiri menayangkan studi kasus berbahasa Inggris lalu lupa terjemahannya.

Gambar diproses saat build

Gambar sumber berukuran 1920×1080 WebP, lalu diubah ukuran dan dikodekan ulang oleh pipeline Hugo sesuai permintaan tiap layout. Screenshot masuk, gambar responsif dengan ukuran yang tepat keluar. Tanpa langkah ekspor manual, tanpa thumbnail yang terlupakan.

Hosting

Output statis di balik CDN pada Cloudflare Pages, dengan build otomatis setiap kali ada push ke main.

Ada sedikit sejarah yang layak disebut di sini. Situs ini awalnya dideploy ke GitHub Pages, lalu saya pindahkan ke Cloudflare. Migrasi itu juga menyingkap bahwa konfigurasi Hugo saya diam-diam terpaku pada versi lama dan sudah tidak bisa dibangun pada rilis terkini, hal yang biasanya baru Anda ketahui saat mengubah satu variabel lalu semuanya berjatuhan.

Masih dalam daftar

• Tombol pengalih tema yang berfungsi. Palet gelapnya sudah didefinisikan, tetapi tombolnya belum diaktifkan.
• Mengisi blog, yang saat ini infrastrukturnya lebih baik daripada isinya.
• Menutup sisa celah pada terjemahan bahasa Indonesia.

Silakan jelajahi bagian lain situs ini, dan hubungi saya jika ingin membicarakan sebuah proyek.