.claude
feat(claude): add Hugo agents and skip .claude in build paths
.devcontainer
build(scss): transpile stylesheets with dart sass instead of libsass
.github
feat(claude): add Hugo agents and skip .claude in build paths
assets
Implementing browserconfig and web app manifest + Page Edit
config
fix(config): include h4 and deeper headings in the table of contents
content
docs(content): convert cross-post links to relref and rework the Hugo install scripts
docs
ci(actions): adapt setup-hugo to Hugo 0.170 editions
layouts
feat(shortcode): support the withdeploy suffix in hugo-version-long
scripts
refactor(config): rename config.toml to hugo.toml and split out ignoreFiles
static
Article and Page Edit
.gitignore
chore(cloudflare): enable Hugo build cache detection
.markdownlint.yaml
Article Edit + Hugo and Go version update
AGENTS.md
ci(actions): adapt setup-hugo to Hugo 0.170 editions
CLAUDE.md
docs: adding `AGENTS.md` and `CLAUDE.md` for AI agent context [skip ci]
CONTRIBUTING.md
Add QRIS and various as method to supporting + remove NihBuatJajan
go.mod
chore(modules): bump stack-modified to e19cf09
go.sum
chore(modules): bump stack-modified to e19cf09
hugo.toml
perf(cloudflare): cache Hugo processed assets
LICENSE
Rename: LICENSE.txt -> LICENSE
LICENSE-CC-BY-SA-4.0
Add CC BY-SA 4.0 License [skip ci]
netlify.toml
ci(netlify): build with Hugo 0.170.1
README.md
ci(actions): adapt setup-hugo to Hugo 0.170 editions

Farrel Franqois Blog

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, silakan penuhi 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 membantumu 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 kamu lihat di dalam folder .devcontainer dan tinggal 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 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 blog atau web 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 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 International 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 halaman sebagai atribusi jika saya diizinkan untuk menggunakannya.