Membuat blog teknologi sendiri adalah cara yang bagus untuk mendokumentasikan eksperimen coding, berbagi tutorial, atau membangun portofolio digital. Namun, banyak orang terjebak dengan platform yang berat dan penuh iklan. Solusinya: gunakan static site generator seperti Hugo dan hosting gratis di GitHub Pages. Kombinasi ini menghasilkan blog yang sangat cepat, aman, dan tanpa biaya bulanan. Artikel ini akan memandu Anda langkah demi langkah, bahkan jika Anda belum pernah menyentuh terminal sebelumnya.
Mengapa Hugo dan GitHub Pages?
Hugo adalah static site generator berbasis Go yang terkenal karena kecepatannya—membangun ratusan halaman dalam hitungan detik. Tidak seperti WordPress yang membutuhkan database dan PHP, Hugo menghasilkan file HTML statis yang bisa di-host di mana saja. GitHub Pages, di sisi lain, menyediakan hosting gratis untuk repositori publik. Dengan menggabungkan keduanya, Anda mendapatkan blog yang ringan, aman dari serangan SQL injection, dan mudah di-deploy melalui Git.
Selain itu, Anda memiliki kontrol penuh atas konten dan tampilan. Tidak ada batasan jumlah postingan atau plugin berbayar. Hugo juga memiliki tema yang melimpah dan aktif dikembangkan oleh komunitas.
Persiapan Awal: Instalasi Hugo dan Git
Sebelum memulai, pastikan komputer Anda sudah terpasang Git dan Hugo. Untuk pengguna Windows, unduh installer Hugo dari situs resmi gohugo.io, lalu jalankan. Pengguna macOS dapat menggunakan Homebrew dengan perintah brew install hugo. Pengguna Linux bisa menginstal melalui package manager masing-masing, misalnya sudo apt install hugo.
Setelah terinstal, verifikasi dengan perintah hugo version di terminal. Anda juga perlu akun GitHub. Jika belum punya, daftar gratis di github.com. Setelah itu, buat repositori baru dengan nama username.github.io (ganti username dengan nama akun GitHub Anda). Repositori ini nantinya akan menjadi alamat blog Anda.
Langkah 1: Membuat Situs Hugo Baru
Buka terminal atau command prompt, lalu jalankan perintah berikut untuk membuat folder proyek:
hugo new site blog-teknologi
cd blog-teknologi
Perintah ini akan membuat struktur direktori dasar Hugo. Di dalamnya ada folder content untuk menyimpan artikel, themes untuk tema, dan file konfigurasi hugo.toml. Selanjutnya, pilih tema. Kunjungi themes.gohugo.io, pilih tema yang sesuai—misalnya Ananke atau PaperMod. Untuk panduan ini, kita gunakan PaperMod karena ringan dan mendukung mode gelap.
Unduh tema sebagai submodule Git:
git init
git submodule add https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod
Kemudian, edit file hugo.toml dan tambahkan baris theme = "PaperMod". Anda juga bisa menambahkan judul blog, deskripsi, dan parameter lain sesuai dokumentasi tema.
Langkah 2: Menulis Postingan Pertama
Gunakan perintah Hugo untuk membuat file markdown baru:
hugo new posts/artikel-pertama.md
File akan muncul di content/posts/artikel-pertama.md. Buka dengan editor teks favorit Anda (VS Code, Sublime, atau Notepad++). Di bagian atas file (front matter), Anda akan melihat metadata seperti judul, tanggal, dan draft. Ubah draft: true menjadi draft: false agar artikel dipublikasikan. Tulis konten blog menggunakan format Markdown—mendukung heading, list, tautan, gambar, dan blok kode.
Untuk melihat hasilnya secara lokal, jalankan server pengembangan:
hugo server -D
Buka browser dan akses http://localhost:1313. Anda akan melihat blog Anda sudah tampil. Setiap perubahan pada file markdown akan otomatis direfresh.
Langkah 3: Menghubungkan ke GitHub dan Deploy
Setelah puas dengan tampilan lokal, saatnya mengunggah ke GitHub. Inisialisasi repositori Git jika belum (perintah git init sudah dijalankan sebelumnya), lalu tambahkan remote:
git remote add origin https://github.com/username/username.github.io.git
Sebelum push, kita perlu menghasilkan file statis ke folder public. Jalankan:
hugo --minify
Perintah ini akan membuat folder public berisi HTML, CSS, dan JavaScript siap saji. Nah, GitHub Pages membutuhkan konten dari folder public ini. Ada dua cara: pertama, push folder public ke branch gh-pages; kedua, gunakan GitHub Actions untuk otomatisasi. Untuk pemula, cara pertama lebih mudah dipahami.
Langkahnya: masuk ke folder public, inisialisasi Git di sana, lalu push ke branch gh-pages:
cd public
git init
git add .
git commit -m "Deploy pertama"
git branch -M gh-pages
git remote add origin https://github.com/username/username.github.io.git
git push -u origin gh-pages
Setelah itu, buka repositori di GitHub, masuk ke Settings > Pages. Di bagian Source, pilih branch gh-pages dan folder root. Simpan. Tunggu beberapa menit, blog Anda akan dapat diakses di https://username.github.io.
Langkah 4: Otomatisasi dengan GitHub Actions (Opsional)
Mendeploy manual dengan push folder public memang mudah, tetapi merepotkan jika sering update. Anda bisa memanfaatkan GitHub Actions untuk membangun dan mendeploy otomatis setiap kali ada push ke branch main. Caranya, buat file .github/workflows/deploy.yml di repositori utama (bukan di folder public). Isinya kurang lebih:
name: Deploy Hugo
on:
push:
branches: [main]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Setup Hugo
uses: peaceiris/actions-hugo@v2
with:
hugo-version: 'latest'
- name: Build
run: hugo --minify
- name: Deploy
uses: peaceiris/actions-gh-pages@v3
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_dir: ./public
Setelah file ini di-push, GitHub Actions akan otomatis menjalankan build dan deploy ke branch gh-pages. Anda tidak perlu lagi melakukan push manual dari folder public.
Tips Tambahan untuk Blog Teknologi
Agar blog Anda menonjol, perhatikan beberapa hal berikut:
- Gunakan domain kustom. Beli domain seperti
namablog.comdan arahkan ke GitHub Pages melalui pengaturan DNS. Ini meningkatkan profesionalisme. - Aktifkan komentar. Gunakan Disqus atau Utterances (berbasis GitHub Issues) untuk interaksi pembaca.
- Optimasi SEO. Manfaatkan fitur front matter Hugo untuk menambahkan deskripsi meta, kata kunci, dan gambar sosial.
- Konsisten menulis. Buat jadwal posting rutin, misalnya satu artikel per minggu, agar pembaca selalu menantikan konten baru.
- Backup konten. Simpan folder proyek di GitHub (repositori utama) sehingga Anda bisa melakukan version control terhadap tulisan.
Dengan mengikuti panduan di atas, Anda sudah memiliki blog teknologi yang cepat, gratis, dan sepenuhnya dikendalikan sendiri. Selamat mencoba dan selamat menulis!
Baca juga: Teknologi Bukan Sekadar Alat: Refleksi Kritis di Era Serba Cepat.
2 thoughts on “Cara Membuat Blog Teknologi dengan Hugo dan GitHub Pages: Panduan Lengkap untuk Pemula”