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 Sumber nya bisa Anda lihat Repositori saya sebelumnya.
Sebelum memulai untuk menggunakan Kode Sumber ini, adakalanya untuk memenuhi persyaratannya terlebih dahulu, yakni terinstalnya:
- Git (disarankan versi terbaru): https://git-scm.com/downloads (Untuk mengetahui Cara Install nya, silahkan baca artikel ini)
- Hugo Extended (versi minimal: 0.91.0, disarankan terbaru): https://gohugo.io/getting-started/installing/ (Untuk mengetahui Cara Instalnya, silahkan baca artikel ini)
- Go (versi minimal: 1.12, disarankan: 1.17 atau terbaru): https://golang.org/
- Mengkloning Repository
stack-modified
di dalam FolderFarrelF/stack-modified
Di dalam Sistem Operasi Anda.
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, pastikan Anda sudah mengkloning Repository stack-modified
di dalam Folder FarrelF
(sesuai petunjuk yang ada di dalam Repository nya) dan memenuhi semua persyaratannya terlebih dahulu.
Jika sudah, Anda bisa lanjut ke langkah berikutnya.
Agar Kode Sumber ini bisa digunakan, maka Anda perlu menghasilkan HTML untuk Blog ini. Ada dua cara untuk menghasilkan HTML nya, berikut di bawah ini:
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, tapi ini berguna untuk pengembangan.
Data yang dihasilkan akan tersimpan ke dalam Memori (RAM) daripada Perangkat Diska (Disk), sehingga datanya tidak bisa Anda temukan di manapun ketika Anda mencarinya. Perubahan akan secara otomatis diterapkan secara langsung selama fitur tersebut aktif.
Untuk caranya, Anda bisa eksekusi perintah berikut di dalam Terminal setelah mengakses kode sumbernya:
hugo server -D --gc
Parameter -D
digunakan untuk membangun artikel/laman yang didraf, silahkan hapus parameter tersebut jika Anda tidak menginginkannya.
Setelah berhasil, silahkan buka Alamat URL http://localhost:1313
di dalam Peramban Web kamu, dan kamu akan melihat hasilnya 🙂
Untuk penggunaan lebih lanjut, silahkan kunjungi laman dokumentasi nya atau ketik perintah hugo server --help
.
Selain di atas, Hugo telah menyediakan cara untuk membangun Web/Blog Statis tanpa harus menggunakan fitur Web Server nya, hasilnya tidak akan tersimpan ke dalam memori (RAM), melainkan ke Perangkat Diska (Disk), ini akan sangat berguna untuk produksi atau sekedar memeriksa Kode dari Berkas Skrip/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, silahkan kunjungi laman dokumentasi nya atau ketik hugo --help
.
Baca berkas CONTRIBUTING.md
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 Laman (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), tapi 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 Laman sebagai Atribusi jika saya diizinkan untuk menggunakan nya.