Skip to content

FarrelF/Blog

Repository files navigation

Farrel Franqois Blog

GitHub Actions Netlify Status Lisensi Ditenagai oleh Hugo

Repositori ini merupakan kode sumber blog saya. Blog ini saya buat menggunakan Hugo, yang berbasis Go dan jauh lebih sederhana dan lebih cepat daripada sebelumnya.

Sebelumnya saya menggunakan Pelican yang berbasiskan Python sebagai basis saya untuk nge-blog, untuk kode sumbernya bisa Anda lihat repositori saya sebelumnya.

Persyaratan

Agar dapat menggunakan kode sumber ini, adakalanya untuk memenuhi persyaratannya terlebih dahulu, yakni terinstalnya:

Di dalam sistem operasi Anda. Jika Anda ingin memakai fitur "Codespaces", maka Anda tidak perlu memenuhi persyaratan tersebut di perangkat Anda.

Cara Memperolehnya

Untuk memperolehnya, Anda bisa eksekusi perintah berikut untuk mengkloningnya:

git clone https://github.com/FarrelF/Blog.git FarrelF/Blog

Atau, jika Anda ingin menggunakan SSH, maka Anda bisa gunakan perintah berikut untuk mengkloningnya:

git clone git@github.com:FarrelF/Blog.git FarrelF/Blog

Atau, jika Anda menggunakan GitHub CLI, maka perintah untuk mengkloningnya sebagai berikut:

gh repo clone FarrelF/Blog FarrelF/Blog

Kode Sumber akan disimpan di dalam sebuah subfolder yang bernama Blog yang terletak di dalam folder FarrelF, jadi untuk mengaksesnya bisa pakai perintah cd FarrelF/Blog.

Sebelum Instal

Sebelum Instal, pastikan Anda telah memenuhi semua persyaratannya terlebih dahulu di atas.

Atau, Anda dapat menggunakan fitur "Codespaces" di GitHub yang dapat membantu Anda untuk menggunakan kode sumber blog ini, dimulai dari sekadar mencoba sampai turut ikut berkontribusi. Untuk caranya, silakan baca halaman dokumentasinya, di situ sudah dijelaskan secara sederhana dan lengkap dengan gambar.

Saya sudah persiapkan semua yang dibutuhkan untuk ini yang konfigurasinya dapat Anda lihat di dalam folder .devcontainer dan tinggal Anda pakai jadi saja, konfigurasinya belum sempurna sih, jadi masukkan dari Anda mengenai konfigurasi tersebut sangat saya apresiasi.

Codespaces ini gratis 60 jam setiap bulannya untuk penggunaan mesin virtual dari GitHub dengan prosesor berinti dua (dual-core) + Memori RAM sebesar 4 GB, untuk biaya kelebihannya silakan Anda tanggung sendiri dan ini bisa saja berubah sewaktu-waktu.

Jika sudah, Anda dapat lanjut ke langkah berikutnya.

Cara Instal dan Menggunakannya

Agar Kode Sumber ini dapat digunakan, maka Anda perlu menghasilkan HTML untuk Blog ini. Ada dua cara untuk menghasilkan HTML-nya, salah satunya berikut di bawah ini:

Cara Pertama: Menggunakan Fitur Web Server

Hugo telah menyediakan Web Server lokal yang akan sangat berguna untuk pengembangan Web/Blog.

Cara kerjanya adalah Hugo terlebih dahulu membuat berkas-berkas statis yang diperlukan untuk membentuk Web/Blog. Setelah itu, dia akan melayani hasilnya agar bisa langsung diakses melalui Peramban Web, meskipun secara baku dalam lingkungan lokal, tetapi ini berguna untuk pengembangan.

Untuk caranya, Anda bisa eksekusi perintah berikut di dalam Terminal setelah mengakses kode sumbernya:

hugo server -D --gc

Argumen -D digunakan untuk membangun artikel/halaman yang didraf dan --gc digunakan agar konten dapat diperbarui dengan menghapus cache yang tidak diperlukan, silakan hapus parameter tersebut jika Anda tidak menginginkannya.

Tambahkan argumen --liveReloadPort 443 jika Anda memakai Codespaces agar fitur "LiveReload" dari Hugo dapat bekerja dengan baik, kecuali jika Anda tidak memerlukannya.

Secara baku, data-data yang dihasilkan akan disimpan di dalam Memori RAM, bukan pada perangkat diska, jika ini dirasa berat, Anda dapat menambahkan argumen --renderToDisk agar tersimpan semua di dalam folder public atau --renderStaticToDisk agar cuma data statis saja yang boleh disimpan di dalam perangkat diska.

Setelah berhasil, silakan buka Alamat URL http://localhost:1313 (atau alamat yang disediakan di Visual Studio Code jika Anda menggunakan fitur "Codespaces") di dalam Peramban Web kamu dan kamu akan melihat hasilnya 🙂

Untuk penggunaan lebih lanjut, silakan kunjungi halaman dokumentasinya atau ketik perintah hugo server --help.

Cara Kedua: Membangun Blog/Web Statis tanpa Web Server

Selain di atas, Hugo telah menyediakan cara untuk membangun Web/Blog Statis tanpa harus menggunakan fitur Web Server-nya, data-data yang dihasilkan akan tersimpan di dalam perangkat diska (Disk), ini akan sangat berguna untuk produksi atau sekadar memeriksa Kode dari berkas skrip atau HTML, sampai berkas-berkas media (Seperti: Gambar) sebelum disebar ke lingkungan produksi.

Untuk caranya, Anda bisa eksekusi perintah berikut di dalam Terminal setelah mengakses kode sumbernya:

hugo --gc

Perintah di atas akan menghasilkan Blog Statis yang siap digunakan untuk produksi, dan hasilnya akan tersimpan di dalam folder public.

Opsi di atas bukanlah opsi terbaik untuk membangun sebuah Web/Blog Statis dengan Hugo, jadi untuk penggunaan lebih lanjut, silakan kunjungi halaman dokumentasinya atau ketik hugo --help.

Cara Kontribusi

Silakan baca berkas CONTRIBUTING.md

Lisensi

Kode Sumber ini dirilis di bawah lisensi GNU Affero General Public License v3 (GNU AGPLv3) yang bisa Anda lihat/baca di dalam berkas LICENSE.

Sedangkan untuk Artikel dan Halaman (terutama di dalam folder content) secara baku saya terbitkan di bawah lisensi Creative Commons Attribution-ShareAlike Internasional 4.0 (Atau, disingkat: CC BY-SA 4.0), tetapi ada beberapa materi tertentu yang bisa saja diterbitkan di bawah lisensi yang berbeda (Contoh: Gambar/Media yang bersumber dari luar, dll).

Lisensi untuk materi-materi tersebut akan saya sebutkan di masing-masing artikel dan halaman sebagai atribusi jika saya diizinkan untuk menggunakannya.