Apa itu Hugo?

Hugo adalah salah satu SSG (Static-site Generator) atau Generator Web Statis yang dibuat menggunakan bahasa pemrograman Go, dikembangkan oleh Steve Francia, Bjørn Erik Pedersen, dan kontributor lainnya

Hugo juga merupakan FLOSS (Free/Libre Open Source Software) yang dirilis di bawah Lisensi Apache 2.0, kode sumbernya bisa Anda akses di sini.

Hugo mendukung berbagai Platform yang ada, termasuk Sistem Operasi Windows, macOS, berbasis Linux, dan BSD, baik untuk arsitektur x86, x64 (disebut sebagai x86-64, x86_64 atau AMD64), ARM dan ARM64.

SSG ini diklaim sebagai SSG tercepat oleh para pengembangnya, salah satunya adalah karena Hugo berjalan di lingkungan yang Native, tanpa ketergantungan (dependencies) apapun dan memiliki fitur yang dinamakan Fast Render Mode.

Selain itu, Hugo juga memiliki banyak fitur lainnya, seperti i18n untuk dukungan multibahasa, berkas data, berkas statis, pemrosesan gambar, pemrosesan berkas CSS, JS, dll yang dapat menunjang kebutuhan untuk Situs Web/Blog Anda.

Varian Hugo

Hugo memiliki 2 varian, yakni Hugo (varian Standar/Biasa) dan Hugo Extended, bedanya adalah kalau Hugo Extended memiliki fitur tambahan, seperti pemrosesan berkas SCSS/SASS yang tidak dimiliki oleh Hugo Standar.

Namun, secara resmi Hugo Extended memiliki dukungan yang lebih sedikit dibandingkan dengan Hugo biasa dan hanya disediakan untuk Platform berikut:

• Windows yang berarsitektur x64
• Sistem Operasi berbasiskan Linux yang berarsitektur x64 dan ARM64, serta perlu “GNU C Library” (glibc)
• macOS yang berarsitektur x64 dan ARM64 (itu pun dicampur jadi satu berkas biner)

Meskipun secara resmi Hugo Extended hanya disediakan untuk Platform di atas saja, akan tetapi Anda juga bisa menginstalnya di Platform lain, salah satunya adalah Void Linux dan Termux di Android, nanti akan saya bahas cara instalnya.

Cara Install Hugo

Di bagian ini, saya akan membahas Cara Install-nya.

Caranya sendiri akan berbeda-beda untuk setiap Sistem Operasi ataupun Platform yang ada, jadi pastikan Anda mengikutinya sesuai dengan Sistem Operasi atau Platform yang digunakan.

Berikut adalah cara instalasinya:

Windows

Pengelola Paket Scoop

Jika Anda menggunakan Scoop sebagai Pengelola Paket di Windows, Anda bisa menginstal Hugo dengan perintah berikut:

scoop install hugo

Atau, ganti hugo jadi hugo-extended jika Anda ingin menginstal Hugo Extended, seperti berikut:

scoop install hugo-extended

Perintah di atas akan menginstal Hugo di dalam Direktori Pengguna (%USERPROFILE%\scoop\apps), jika Anda ingin Hugo-nya dapat berjalan di Semua Pengguna, maka perlu menambahkan argumen -g.

Perintahnya akan menjadi seperti berikut:

scoop install hugo-extended -g

Namun, Anda perlu membuka Command Prompt, Windows Terminal, Windows PowerShell atau PowerShell Core-nya sebagai Administrator terlebih dahulu sebelum menjalankan perintah di atas.

Jika Anda sudah menginstal sudo melalui Scoop atau gsudo sebelumnya, maka cukup tambahkan saja sudo sebelum menjalankan perintah Scoop, tanpa harus menjalankan Terminal sebagai Administrator, menjadi seperti berikut:

sudo scoop install hugo-extended -g

Dengan begini, Anda tidak perlu membuka Terminal-nya sebagai Administrator lagi.

Untuk memperbarui versinya, silakan ganti opsi install di atas menjadi update.

Pengelola Paket Chocolatey

Jika Anda menggunakan Chocolatey sebagai Pengelola Paket di Windows, Anda bisa menginstal Hugo dengan perintah berikut:

choco install hugo

Perintah di atas akan menginstal Hugo dalam varian Biasa/Standar, jika Anda ingin menginstal Hugo Extended, cukup ganti saja hugo menjadi hugo-extended, seperti berikut:

choco install hugo-extended

Untuk memperbarui versinya, silakan ganti opsi install di atas menjadi upgrade.

Berkas Biner, tanpa Pengelola Paket (Manual)

Hugo telah menyediakan berkas Biner yang telah dikompilasi agar dapat digunakan secara langsung dan berkas tersebut diarsipkan dengan format/ekstensi zip (untuk Windows), jadi Anda bisa langsung menggunakannya setelah berkas tersebut diunduh dan diekstrak.

Berkas Biner di sini adalah nama lain dari berkas yang tujuannya untuk dieksekusi, kalau di Windows Anda akan mengenal dengan berkas yang berakhiran .exe.

Jika Anda tidak ingin menggunakan Pengelola Paket apapun untuk menginstalnya, maka berikut adalah langkah-langkahnya:

1. Unduh Berkas Arsip yang berisi berkas biner Hugo di Halaman Perilisannya.

   Di situ tersedia 4 berkas yang bisa Anda unduh salah satunya, semua itu diarsipkan dalam format Zip, sesuaikan dengan Arsitektur Sistem Operasi yang dipakai.

   Namun, jika Anda ingin menginstal Hugo Extended, unduh berkas yang namanya diawali dengan hugo_extended

2. Setelah diunduh, ekstrak berkas arsip tersebut ke dalam folder/direktori apa saja.

   Saya asumsikan bahwa Anda mengekstraknya ke dalam Folder C:\Hugo\bin dan akan saya gunakan direktori tersebut untuk seterusnya

3. Setelah diekstrak, Anda perlu menambahkan ke dalam variabel PATH agar Hugo bisa dieksekusikan di mana saja.

   Pertama-tama, klik “Start Menu”, lalu manfaatkan fasilitas pencarian yang ada di sana atau Anda juga bisa langsung ke pencarian yang ada di Taskbar jika Anda memasangkannya.

   Saat di pencarian, ketik env di situ, nanti akan muncul tulisan Edit the system environment variables dan klik tulisan tersebut, seperti cuplikan berikut:

4. Nanti akan muncul dialog System Properties, di dalam dialog tersebut, klik pada Button Environment Variables…, seperti cuplikan berikut:

5. Setelah itu, Anda akan memasukki dialog yang berjudul Environment Variables, di situ nanti ada dua kolom, yakni User variables yang terletak di atas dan System variables yang terletak di bawah.

   Karena Variabel yang di ubah ini lingkupnya ke satu Sistem Operasi, yang artinya semua Akun Pengguna (User Account) kena, maka carilah variabel PATH di dalam kolom System variables.

   Setelah ketemu, pilih variabel tersebut dan klik pada Button Edit, seperti cuplikan berikut:

6. Anda memasukki dialog yang berjudul Edit environment variables, di situ Anda akan merubah nilai dari variabel tersebut. Windows 10 dan Windows 7 mungkin memiliki penampilan yang berbeda, jadi cara mengubahnya akan berbeda-beda, berikut di bawah ini adalah caranya:

   • Di Windows 10: Nilai dari variabel PATH yang tampil di Windows 10 adalah dalam bentuk daftar. Untuk menambahkannya, cukup Anda klik pada Button New, lalu isi nilainya dengan Lokasi berkas Biner Hugo itu berada.

     Jika Anda sebelumnya mengekstrak Hugo di C:\Hugo\bin, maka isi nilainya dengan C:\Hugo\bin juga. Setelah menambahkannya, klik pada Button OK, seperti cuplikan berikut:

     

   • Di Windows 7: Nilai dari Variabel PATH yang tampil di Windows 7 adalah dalam bentuk deretan. Untuk menambahkannya, cukup Anda tambahkan C:\Hugo\bin; saja di bagian akhir deretan (JANGAN DIGANTI SEMUA DERETANNYA!!).

     C:\Hugo\bin menunjukkan tempat di mana Hugo diekstrak, jika Anda mengekstraknya di tempat lain, maka ganti C:\Hugo\bin menjadi lokasi di mana Berkas Biner Hugo itu berada.

     Setelah itu, klik pada Button OK.

     Catatan: Mohon maaf, karena saya tidak lagi memakai Windows 7, jadi cuplikannya belum ada saat ini

7. Jika masih ada sesi Command Prompt, Windows Terminal, Windows PowerShell, PowerShell Core, dll, maka Anda perlu menutup semuanya terlebih dahulu/mengakhiri semua sesinya, lalu membukanya kembali.

   Biasanya, perubahan pada variabel PATH tidak akan berefek jika sesinya masih ada. Jika Anda tidak membuka Terminalnya, silakan Anda membukanya terlebih dahulu, entah itu Command Prompt, Windows Terminal, PowerShell, dll.

8. Setelah Anda membuka Terminalnya, silakan Anda eksekusikan perintah hugo version untuk menampilkan versi Hugo yang Anda gunakan. Jika berhasil, maka akan tampil keluaran seperti berikut:

hugo v0.112.3-ba6f74e40420d76f15fc8c2358be90f7aca98e0e+extended windows/amd64 BuildDate=2023-05-24T14:42:50Z VendorInfo=gohugoio

9. Selamat! Anda telah berhasil menginstal Hugo. Jika Anda ingin memperbarui versi Hugo-nya, cukup unduh lagi berkas binernya, lalu tinggal timpakan berkas lamanya.

Nah, untuk Windows-nya saya cukupkan di sini dulu, berikutnya saya bahas Cara Install Hugo untuk Sistem Operasi GNU/Linux.

WinGet? Sayang sekali, itu masih belum ada hingga saat ini, jadi Anda harus menggunakan metode lain selain WinGet tentunya.

GNU/Linux

Debian, Ubuntu dan Keluarganya

Jika Anda adalah pengguna Debian, Ubuntu atau keluarganya, sebenarnya Anda dapat menginstalnya dengan perintah berikut:

sudo sh -c 'apt update; apt install -y hugo'

Atau:

apt update; apt install -y hugo

Namun cara di atas tidak saya rekomendasikan, karena versi yang Anda dapatkan nantinya merupakan versi yang lama (kecuali jika Anda menggunakan distribusi dengan rilis bergulir).

Jika Anda ingin versi terbaru dari Hugo, silakan unduh itu di halaman perilisan resminya, pastikan unduh berkas .deb-nya, setelah itu tinggal Anda instal secara manual.

Atau, jika Anda lebih suka lewat Terminal, maka pertama-tama Anda perlu mengubah hak akses Anda di Terminal menjadi root dengan perintah sudo su, sudo -i atau sudo -s.

Setelah itu, tentukan apakah Anda mau menginstal Hugo varian standar atau Extended, beserta arsitektur sistem operasi yang Anda gunakan sekarang.

Jika sudah ditentukan, Anda bisa mengikuti caranya berikut:

Untuk menginstalnya, salinkan skrip berikut di bawah ini dan tempelkan itu ke dalam Terminal, lalu tekan “Enter”: (Langsung copas aja)

1
2
3
4
5
6

HUGO_VERSION="$(curl -s https://api.github.com/repos/gohugoio/hugo/releases/latest | grep tag_name | cut -d 'v' -f2 | cut -d'"' -f1)"
IS_EXTENDED=true
HUGO_ARCH="$(dpkg --print-architecture)"
if [ "$IS_EXTENDED" = true ]; then HUGO_EXTENDED="extended_"; fi
HUGO_FILENAME="hugo_"$HUGO_EXTENDED$HUGO_VERSION"_linux-$HUGO_ARCH.deb"
cd /tmp; wget -c "https://github.com/gohugoio/hugo/releases/download/v$HUGO_VERSION/$HUGO_FILENAME"

Atau, gunakan skrip berikut jika Anda menggunakan fish sebagai shell:

1
2
3
4
5
6

set HUGO_VERSION (curl -s https://api.github.com/repos/gohugoio/hugo/releases/latest | grep tag_name | cut -d 'v' -f2 | cut -d'"' -f1)
set IS_EXTENDED "true"
set HUGO_ARCH (dpkg --print-architecture)
set HUGO_EXTENDED ""; if test $IS_EXTENDED = "true"; set HUGO_EXTENDED "extended_"; end
set HUGO_FILENAME "hugo_"$HUGO_EXTENDED$HUGO_VERSION"_linux-$HUGO_ARCH.deb"
cd /tmp; wget -c "https://github.com/gohugoio/hugo/releases/download/v$HUGO_VERSION/$HUGO_FILENAME"

Penjelasan:

• Baris ke-1: Untuk mendapatkan versi terbaru Hugo, lalu memasukkannya ke dalam variabel HUGO_VERSION

• Baris ke-2: Untuk mementukan apakah Anda ingin mengunduh Hugo standar atau Hugo Extended, secara baku akan mengunduh Hugo Extended, ganti true menjadi false atau selain true jika Anda ingin mengunduh Hugo varian standar

• Baris ke-3: Untuk menentukan arsitektur sistem pada berkas Hugo yang ingin Anda unduh, variabel tersebut akan otomatis diisi berdasarkan hasil dari perintah dpkg --print-architecture.

  Anda bisa menggantinya kalau mau, arsitektur yang tersedia untuk Hugo adalah amd64 dan arm64

• Baris ke-4: Untuk pengkondisian jika IS_EXTENDED itu bernilai true, maka variabel HUGO_EXTENDED akan bernilai extended_ atau kosong/tidak disetel jika selain itu. Khusus fish, variabel HUGO_EXTENDED disetel terlebih dahulu dengan nilai kosong sebelum pengkondisian

• Baris ke-5: Untuk memasukkan Nama Berkas yang ingin diunduh ke dalam variabel HUGO_FILENAME dan Nilai tersebut diambil dari nama berkas Hugo Aslinya dan variabel HUGO_EXTENDED untuk teks tambahan kondisionalnya, HUGO_VERSION untuk versi Hugo-nya dan HUGO_ARCH untuk arsitektur pada Hugo yang ingin diunduh

• Baris ke-6: Untuk menavigasikan Terminal ke /tmp, lalu mengunduh Hugo-nya di sana dengan bantuan GNU Wget

Lalu, instal berkas yang telah Anda unduh dengan perintah berikut:

dpkg -i "$HUGO_FILENAME" || ! echo "Instalasi Gagal"; rm "$HUGO_FILENAME"; cd -

Penjelasan: Perintah di atas untuk menginstal Hugo melalui dpkg dari berkas penginstal yang berekstensi deb dan nama berkasnya diambil dari variabel HUGO_FILENAME. Jika berhasil, maka berkas penginstal akan dihapus dan kembali ke direktori sebelumnya atau hanya menampilkan pesan jika gagal.

Jika merasa sudah selesai, silakan alihkan kembali hak akses di dalam Terminal Anda menjadi pengguna biasa dengan perintah exit.

Untuk memperbarui versi Hugo-nya, Anda perlu mengulangi semua langkah-langkah di atas.

openSUSE Leap/Tumbleweed dan Keluarganya (Tidak Resmi)

Jika Anda adalah pengguna openSUSE Leap/Tumbleweed atau keluarganya, sebelum menginstalnya, tambahkan dulu repositori dari luar (dari home:darix:apps, jadi itu bukan resmi) yang bisa Anda percayakan dengan salah satu perintah berikut:

1
2
3
4
5

### Untuk Pengguna openSUSE Leap 15.4
sudo zypper ar -f https://download.opensuse.org/repositories/home:darix:apps/15.4/home:darix:apps.repo

### Untuk Pengguna openSUSE Tumbleweed
sudo zypper ar -f https://download.opensuse.org/repositories/home:darix:apps/openSUSE_Tumbleweed/home:darix:apps.repo

Setelah itu segarkan repositorinya, lalu install Hugo-nya dengan perintah berikut:

1

sudo sh -c 'zypper ref; zypper in hugo'

Untuk lebih lanjut. silakan kunjungi Halaman Unduh Repositorinya.

Catatan: Saya tidak memakai SUSE Linux Enterprise, openSUSE dan Keluarganya, tetapi berdasarkan konfigurasinya, kemungkinan varian Hugo yang digunakan adalah Hugo Extended dan arsitektur sistem yang didukung hanyalah x86_64 saja.

Arch Linux, Manjaro dan Keluarganya

Jika Anda adalah pengguna Arch Linux, Manjaro atau keluarganya, Anda dapat menginstal Hugo dengan perintah berikut:

sudo pacman -S hugo

Namun jika Anda lebih memilih lewat AUR (Arch User Repository), silakan gunakan paket hugo-bin dari AUR.

Cara Instal paket dari AUR akan berbeda-beda, tergantung AUR Helper yang Anda gunakan.

Namun jika Anda menggunakan Yay sebagai AUR Helper-nya, maka Anda dapat memakai perintah berikut:

yay -S hugo-bin

PEMBARUAN Senin, 29 November 2021: Paket hugo-bin yang ada di AUR mungkin sudah tidak ada, jadi untuk sekarang instal Hugo melalui paket resminya saja.

Catatan: Berdasarkan konfigurasinya, varian Hugo yang digunakan oleh Arch, Manjaro dan Keluarganya adalah Hugo Extended.

Solus dan Keluarganya

Jika Anda menggunakan Solus atau keluarganya, maka Anda dapat menginstalnya dengan perintah berikut:

sudo eopkg install hugo

Catatan: Saya tidak memakai Solus dan Keluarganya, tetapi berdasarkan konfigurasinya, kemungkinan varian Hugo yang digunakan oleh Solus dan Keluarganya adalah Hugo Extended.

Void Linux dan Keluarganya

Jika Anda adalah pengguna Void Linux atau Keluarganya, Anda dapat menginstal Hugo dengan perintah berikut:

sudo xbps-install -S hugo

Catatan: Saya tidak memakai Void Linux dan Keluarganya, tetapi berdasarkan templatnya, kemungkinan varian Hugo yang digunakan oleh Void Linux dan Keluarganya adalah Hugo Extended. Selain itu, Hugo Extended yang mereka gunakan didukung oleh semua arsitektur (baik itu x86, x86_64, ARM, ARM64, dan arsitektur lainnya) dan “C Library” (glibc dan musl) yang ada pada Void Linux.

Homebrew (Lebih Universal)

Jika Anda ingin menggunakan Homebrew (brew) yang lebih Universal, maka Anda bisa menginstalnya dengan perintah berikut:

brew install hugo

Catatan: Saya tidak memakai Pengelola Paket Homebrew, tetapi berdasarkan kode formulanya, kemungkinan varian Hugo yang digunakan oleh Pengelola Paket Homebrew adalah Hugo Extended.

Snap (Lebih Universal)

Jika Anda ingin menggunakan Snap yang lebih Universal, maka Anda bisa menginstalnya dengan perintah berikut:

snap install hugo

Perintah di atas akan menginstal Hugo dengan varian biasa, jika Anda ingin menginstal Hugo Extended, Anda hanya perlu tambahkan argumen --channel=extended/stable saja, menjadi seperti berikut:

snap install hugo --channel=extended/stable

Pengelola Paket Nix (Lebih Universal)

Jika Anda ingin menggunakan Pengelola Paket Nix yang lebih universal. Sebelum menginstalnya, Anda bisa mencobanya terlebih dahulu dengan menggunakan perintah berikut:

nix-shell -p hugo

Perintah di atas akan tetap menginstal Hugo, tetapi di dalam nix-shell yang dikhususkan untuk Hugo, setelah diinstal Anda akan masuk ke dalam nix-shell dan Hugo hanya bisa dijalankan dari sana.

Jadi, jika Anda menginstalnya dengan perintah di atas, agar Hugo dapat dijalankan sewaktu-waktu, maka Anda harus masuk ke dalam nix-shell terlebih dahulu dengan mengeksekusi perintah di atas.

Hal seperti ini cocok untuk Anda yang menguji aplikasi sebelum diinstal secara permanen, meski sebenarnya cara ini yang direkomendasikan oleh mereka ketimbang menginstalnya secara permanen, kecuali jika Anda menggunakan NixOS yang aplikasinya bisa diinstal dengan mengubah berkas konfigurasi sistemnya.

Namun, jika Anda ingin menginstalnya secara permanen, maka Anda bisa menginstalnya dengan perintah berikut:

nix-env -iA nixpkgs.hugo

Perintah di atas berlaku bagi yang bukan pengguna NixOS, jika Anda menggunakannya, cukup ganti nixpkgs di atas menjadi nixos.

Berdasarkan berkas konfigurasinya, varian Hugo yang digunakan adalah Hugo Extended. Selain itu, versi yang digunakan itu merupakan versi baru, tetapi tidak untuk pengguna NixOS dengan kanal selain tidak stabil (Unstable) yang mendapatkan versi lebih lama.

Namun, jika Anda tidak menggunakan NixOS dan menggunakan Nix sebagai pengelola paket, maka versi paket yang Anda dapatkan biasanya akan mengikuti kanal tidak stabil dari NixOS/Nixpkgs.

Berkas Biner, tanpa Pengelola Paket (Lebih Universal, Manual)

Hugo telah menyediakan berkas Biner yang telah dikompilasi agar dapat digunakan secara langsung dan berkas tersebut diarsipkan dengan format/ekstensi .tar.gz (untuk GNU/Linux), jadi Anda bisa langsung menggunakannya setelah berkas tersebut diunduh dan diekstrak.

Berkas Biner di sini adalah nama lain dari berkas yang tujuannya untuk dieksekusi, kalau di Windows Anda akan mengenal dengan berkas yang berakhiran .exe.

Berkas tersebut biasanya akan kompatibel dengan hampir seluruh distribusi GNU/Linux, jadi jika distribusi yang Anda gunakan tidak saya bahas di sini dan tidak mau menggunakan Pengelola Paket ‘Universal’ atau bahkan sama sekali tidak mau menggunakan Pengelola Paket, maka Anda bisa gunakan berkas Binernya.

Cara sederhananya:

1. Unduh salah satu berkas Arsip yang berisikan berkas Biner Hugo dari Halaman Perilisannya (yang berformat .tar.gz)
2. Ekstrak berkasnya
3. Izinkan agar berkas yang bernama hugo bisa dieksekusi (dengan mengeksekusi perintah chmod +x hugo)
4. Pindahkan berkas yang bernama hugo ke dalam direktori /usr/local/bin (dengan mengeksekusi perintah sudo mv hugo /usr/local/bin/)
5. Pastikan bahwa /usr/local/bin/hugo itu milik pengguna root (dengan mengeksekusi perintah sudo chown root:root /usr/local/bin/hugo)
6. Selesai!

Catatan: Bisa saja Anda memindahkan berkas tersebut ke dalam direktori lain yang termasuk dalam variabel PATH, seperti /home/username/.local/bin misalnya dan tidak perlu melakukan peralihan kepemilikan ke root, tetapi saya rekomendasikan agar diletakkan ke dalam direktori /usr/local/bin supaya Hugo bisa dieksekusi oleh seluruh pengguna di satu sistem.

Jika Anda lebih suka melakukannya secara langsung di Terminal (atau cara panjangnya) maka pertama-tama Anda perlu mengubah hak akses Anda di Terminal menjadi root dengan perintah sudo su, sudo -i, atau sudo -s, kecuali jika Anda ingin menginstalnya di dalam direktori pengguna.

Setelah itu, tentukan apakah Anda mau menginstal Hugo varian standar atau Extended, beserta arsitektur sistem operasi yang Anda gunakan sekarang.

Jika sudah ditentukan, Anda bisa mengikuti caranya berikut:

Untuk menginstalnya, maka tinggal Anda copas saja skrip berikut ke dalam Terminal, lalu tekan “Enter”:

1
2
3
4
5
6

HUGO_VERSION="$(curl -s https://api.github.com/repos/gohugoio/hugo/releases/latest | grep tag_name | cut -d 'v' -f2 | cut -d'"' -f1)"
IS_EXTENDED=true
HUGO_ARCH="amd64"
if [ "$IS_EXTENDED" = true ]; then HUGO_EXTENDED="extended_"; fi
HUGO_FILENAME="hugo_"$HUGO_EXTENDED$HUGO_VERSION"_linux-$HUGO_ARCH.tar.gz"
cd /tmp; wget -c "https://github.com/gohugoio/hugo/releases/download/v$HUGO_VERSION/$HUGO_FILENAME"

Atau, gunakan skrip berikut jika Anda menggunakan fish sebagai shell:

1
2
3
4
5
6

set HUGO_VERSION (curl -s https://api.github.com/repos/gohugoio/hugo/releases/latest | grep tag_name | cut -d 'v' -f2 | cut -d'"' -f1)
set IS_EXTENDED "true"
set HUGO_ARCH "amd64"
set HUGO_EXTENDED ""; if test $IS_EXTENDED = "true"; set HUGO_EXTENDED "extended_"; end
set HUGO_FILENAME "hugo_"$HUGO_EXTENDED$HUGO_VERSION"_linux-$HUGO_ARCH.tar.gz"
cd /tmp; wget -c "https://github.com/gohugoio/hugo/releases/download/v$HUGO_VERSION/$HUGO_FILENAME"

Penjelasan:

• Baris ke-1: Untuk mendapatkan versi terbaru Hugo, lalu memasukkannya ke dalam variabel HUGO_VERSION

• Baris ke-2: Untuk mementukan apakah Anda ingin mengunduh Hugo dengan varian standar atau Hugo Extended, secara baku akan mengunduh Hugo Extended, ganti true menjadi false atau selain true jika Anda ingin mengunduh Hugo varian standar

• Baris ke-3: Untuk menentukan arsitektur sistem pada berkas Hugo yang ingin Anda unduh, secara baku diisi amd64, yang artinya Anda akan mengunduh berkas Hugo untuk arsitektur AMD64 atau x86_64.

  Anda bisa menggantinya kalau mau, arsitektur yang tersedia untuk Hugo Extended adalah amd64 dan arm64, sedangkan varian standar ada tambahan satu arsitektur lagi, yakni arm yang diperuntukkan bagi pengguna prosesor berbasis ARM dengan arsitektur 32-bit

• Baris ke-4: Untuk pengkondisian jika IS_EXTENDED itu bernilai true, maka variabel HUGO_EXTENDED akan bernilai extended_ atau kosong/tidak disetel jika selain itu. Khusus fish, variabel HUGO_EXTENDED disetel terlebih dahulu dengan nilai kosong sebelum pengkondisian

• Baris ke-5: Untuk memasukkan Nama Berkas yang ingin diunduh ke dalam variabel HUGO_FILENAME dan Nilai tersebut diambil dari nama berkas Hugo Aslinya dan variabel HUGO_EXTENDED untuk teks tambahan kondisionalnya, HUGO_VERSION untuk versi Hugo-nya dan HUGO_ARCH untuk arsitektur pada Hugo yang ingin diunduh

• Baris ke-6: Untuk menavigasikan Terminal ke /tmp, lalu mengunduh Hugo-nya di sana dengan bantuan GNU Wget

Setelah mengunduhnya, Anda perlu mengeksekusi skrip berikut untuk menginstalnya:

1
2
3
4

tar -xvzf "$HUGO_FILENAME"; install -Dm755 hugo /usr/local/bin/
install -Dm644 LICENSE /usr/share/licenses/hugo/LICENSE
rm "$HUGO_FILENAME" hugo LICENSE README.md
cd -

Penjelasan:

• Baris ke-1: Untuk mengekstrak Berkas Arsip, lalu menginstal Hugo di direktori /usr/local/bin dan chmod dari berkas tersebut disetel dengan nilai 755
• Baris ke-2: Untuk menyalinkan berkas LICENSE milik Hugo kedalam direktori /usr/share/licenses/hugo dan chmod dari berkas tersebut disetel dengan nilai 644
• Baris ke-3: Menghapus berkas yang sudah tak terpakai lagi
• Baris ke-4: Kembali ke direktori sebelumnya

Setelah itu, pastikan kalau Hugo dapat berjalan dengan mengeksekusi perintah berikut untuk melihat versi Hugo yang Anda gunakan sekarang:

hugo version

Jika berhasil, maka keluarannya akan seperti di bawah ini:

hugo v0.112.3-ba6f74e40420d76f15fc8c2358be90f7aca98e0e+extended linux/amd64 BuildDate=2023-05-24T14:42:50Z VendorInfo=gohugoio

Keluaran di atas itu terjadi karena saya menggunakan Hugo Extended, jika Anda menggunakan varian biasa, harusnya sih sama aja, bedanya cuma gak ada tulisan extended-nya aja.

Masih dalam hak akses root, kalau mau, Anda juga dapat membuat Halaman Panduan (manpages) untuk Hugo dengan skrip berikut:

1
2
3
4

hugo gen man --dir '/tmp/hugo_manpages'
cd /tmp/hugo_manpages; gzip -9 *
install -Dm644 * -t /usr/local/man/man1
cd -; rm -rf /tmp/hugo_manpages

Penjelasan:

• Baris ke-1: Untuk membuat Halaman Panduan Hugo dan berkas-berkasnya akan diletakkan di dalam direktori /tmp/hugo_manpages (Direktori tersebut akan dibuatkan secara otomatis jika tidak ada, jadi Anda tidak perlu membuatnya terlebih dahulu)
• Baris ke-2: Untuk menavigasikan shell ke dalam direktori /tmp/hugo_manpages, lalu mengkompresi semua berkas di dalamnya dengan Gzip dan menghapus semua berkas aslinya
• Baris ke-3: Untuk menyalinkan semua berkas di dalamnya ke /usr/local/man/man1 dan menyetel nilai chmod-nya ke 644
• Baris ke-4: Untuk kembali ke direktori sebelumnya, lalu menghapus direktori /tmp/hugo_manpages dan seluruh berkas di dalamnya (atau secara rekursif)

Kalau sudah, Anda bisa tes Halaman Panduannya dengan mengeksekusi perintah man hugo di dalam Terminal Anda.

Jika Anda ingin memasang fitur Completion untuk Shell yang Anda gunakan di Terminal, maka Anda dapat memasangkannya dengan perintah berikut: (Sesuaikan dengan Shell yang ter-install di Sistem Anda)

1
2
3

hugo completion bash | install -Dm644 /dev/stdin "/usr/share/bash-completion/completions/hugo"
hugo completion zsh | install -Dm644 /dev/stdin "/usr/share/zsh/site-functions/_hugo"
hugo completion fish | install -Dm644 /dev/stdin "/usr/share/fish/vendor_completions.d/hugo.fish"

Penjelasan:

• Baris ke-1: Untuk membuat Autocomplete untuk GNU Bash dan meletakkannya ke dalam direktori /usr/share/bash-completion/completions sebagai berkas yang bernama hugo (Untuk pengguna GNU Bash/bash)
• Baris ke-2: Untuk membuat Autocomplete untuk Z Shell dan meletakkannya ke dalam direktori /usr/share/zsh/site-functions/completions sebagai berkas yang bernama _hugo (Untuk pengguna Z Shell/zsh)
• Baris ke-3: Untuk membuat Autocomplete untuk fish dan meletakkannya ke dalam direktori /usr/share/fish/vendor_completions.d sebagai berkas yang bernama hugo.fish (Untuk pengguna fish)

Silakan coba fitur Completion di dalam Terminal Anda setelah itu.

Jika merasa sudah selesai, silakan alihkan kembali hak akses di dalam Terminal Anda menjadi Pengguna Biasa dengan perintah exit.

Untuk memperbarui versi Hugo-nya, Anda perlu mengulangi semua langkah-langkah di atas.

macOS

MacPorts

Catatan: Saya tidak memakai Sistem Operasi macOS dan MacPorts sebagai Pengelola Paket, mungkin cara instalasi yang saya lontarkan di sini kurang begitu akurat sehingga bisa saja salah. Jika terjadi kesalahan dan Anda adalah pengguna MacPorts, mohon berikan masukkan/koreksi dari Anda melalui Kolom Komentar.

Jika Anda menggunakan MacPorts sebagai Pengelola Paket di dalam macOS Anda, maka Anda dapat menginstal Hugo dengan perintah berikut:

sudo port install hugo

Perintah di atas akan menginstal Hugo dengan varian biasa, jika Anda ingin menginstal Hugo Extended, Anda hanya perlu tambahkan argumen +extended saja, menjadi seperti berikut:

sudo port install hugo +extended

Catatan: Menginstalnya melalui MacPorts mungkin akan menghimpun (compile) kode sumber Hugo di dalam perangkat Anda.

Anda juga dapat menambahkan fitur Completion untuk Bash kalau mau dengan menambahkan argumen +bash_completion di dalam baris perintahnya saja.

Jika Anda tidak ingin menggunakan sudo, maka hapus saja sudo-nya.

Homebrew

Jika Anda menggunakan Homebrew (brew) sebagai Pengelola Paket di dalam macOS Anda, maka Anda dapat menginstal Hugo dengan perintah berikut:

brew install hugo

Catatan: Saya tidak memakai Pengelola Paket Homebrew, tetapi berdasarkan kode formulanya, kemungkinan varian Hugo yang digunakan oleh Pengelola Paket Homebrew adalah Hugo Extended.

Android

Termux

Jika Anda menggunakan Termux di dalam Android, maka Anda dapat menginstal Hugo dengan perintah berikut:

pkg i hugo

Perintah di atas akan menginstal Hugo Extended, bukan Hugo varian standar, berdasarkan konfigurasinya meskipun Anda menggunakan Arsitektur dari ARM.

Jadi, Anda tidak perlu lagi khawatir mengenai masalah varian Hugo di Android Anda, tetapi saya sarankan agar Anda menggunakan Termux versi terbarunya (tidak diunduh dari Google Play Store) untuk pengalaman yang lebih nyaman dan versi Android-nya minimal 7.0 agar Termux versi terbaru bisa digunakan.

BSD

OpenBSD dan Keluarganya

Catatan: Saya tidak memakai Sistem Operasi berbasis BSD, seperti OpenBSD, mungkin cara instalasi yang saya lontarkan di sini kurang begitu akurat sehingga bisa saja salah. Jika terjadi kesalahan dan Anda adalah pengguna OpenBSD, mohon berikan masukkan/koreksi dari Anda melalui Kolom Komentar.

Jika Anda adalah pengguna OpenBSD dan Keluarganya, maka Anda dapat menginstal Hugo dengan perintah berikut:

doas pkg_add hugo

Karena saya tidak pakai, jadi saya tidak tahu apa varian Hugo yang terinstal nantinya dan dapat versi berapa.

Jika versi yang didapat adalah versi lama dan Anda sangat ingin mendapatkan versi terbarunya, maka Anda bisa mempertimbangkan opsi instalasi melalui OpenBSD Ports, mungkin ini akan menghimpun (compile) kode sumber Hugo.

Docker

Jika Anda menggunakan Docker, mungkin Anda bisa gunakan Docker Image klakegg/hugo untuk itu. Ini memang bukan resmi dari pengembang, tetapi mereka sendiri merekomendasikannya.

Pertanyaan dan Jawaban

Pertanyaan ke-1: Varian Hugo mana yang harus dipakai?

Jawab: Usahakan untuk selalu gunakan Hugo Extended ketimbang Hugo dengan varian standar.

Saya menyarankan seperti ini karena dukungan tema akan lebih beragam jika Anda menggunakan Hugo Extended dan ada beberapa tema yang menggunakan SCSS ketimbang CSS untuk mengatur penampilannya.

Lagipula, sudah banyak Platform yang mendukung Hugo Extended ini, walaupun secara resmi hanya disediakan untuk Platform tertentu saja.

Pertanyaan ke-2: Kenapa Cara Install Hugo di Fedora, Red Hat dan Keluarganya malah gak dibahas?

Jawab: Karena versi Hugo yang digunakan oleh Fedora, Red Hat, dan Keluarganya adalah versi lama.

Hingga saat ini, saya belum menemukan Repository luar yang cocok untuk Fedora, Red Hat, dan Keluarganya.

Jika Anda sangat ingin menginstal Hugo di dalam Distribusi yang tidak saya bahas, maka saya sarankan agar Anda menginstalnya melalui cara yang lebih “Universal” seperti menggunakan Snap, Homebrew, Nix atau melalui cara manual (mengunduh berkas biner, tanpa pengelola paket).

Pertanyaan ke-3: Apakah Cara Install untuk openSUSE bisa diaplikasikan di Fedora, Red Hat, dan Keluarganya?

Jawab: Tidak bisa, kalaupun bisa maka sebaiknya jangan, karena pada dasarnya Distribusi Keluarga SUSE dan Fedora/Red Hat memang berbeda meskipun sama-sama menggunakan RPM sebagai salah satu Sistem Pengelolaan Paketnya dan sama-sama merupakan GNU/Linux.

Letak perbedaannya nanti di paket ketergantungannya, mulai dari nama paketnya sampai versi dari paket-paket tersebut yang didapat akan berbeda satu sama lain.

Jika Anda ingin mencobanya ya silakan saja, tetapi segala resiko yang ada atau yang telah terjadi, silakan Anda tanggung sendiri.

Pertanyaan ke-4: Saya ingin menginstal Hugo dengan mengunduh Berkas Biner di GNU/Linux, tetapi apakah ada cara agar saya dapat menginstalnya di direktori pengguna tanpa perlu hak akses root ataupun menggunakan sudo lagi?

Jawab: Ada, pada dasarnya Anda dapat mengikuti cara di atas, tetapi Anda perlu mengubah beberapa direktori tujuan pada skrip di atas, seperti /usr/local/bin menjadi $HOME/.local/bin, /usr/local/man/man1 menjadi $HOME/.local/share/man/man1 untuk Halaman Manual, dll.

Catatan: Saya belum pernah coba instal Hugo di dalam direktori pengguna, sehingga akan terjadi ketidakakuratan dalam pembahasan, namun saya berani jamin bahwa perintah-perintah di bawah ini tidak akan membahayakan sedikitpun baik untuk Sistem Operasi dan data-data pribadi Anda.

Install Hugo

Kalau Anda gak mau ribet, setelah Anda mengunduh Hugo-nya, alihkan terlebih dahulu hak aksesnya menjadi pengguna biasa, lalu Anda bisa gunakan skrip berikut untuk menginstal Hugo-nya di dalam direktori pengguna:

1
2
3
4

tar -xvzf "$HUGO_FILENAME"; install -Dm755 hugo "$HOME"/.local/bin/
install -Dm644 LICENSE "$HOME"/.local/share/licenses/hugo/LICENSE
rm "$HUGO_FILENAME" hugo LICENSE README.md
cd -

Setelah menginstalnya, silakan Anda pastikan agar Hugo dapat dieksekusi setelah diinstal dengan perintah berikut untuk menampilan versinya:

hugo version

Jika berhasil, maka harusnya akan muncul keluaran seperti di bawah ini:

hugo v0.112.3-ba6f74e40420d76f15fc8c2358be90f7aca98e0e+extended linux/amd64 BuildDate=2023-05-24T14:42:50Z VendorInfo=gohugoio

Kalau muncul keluaran seperti di atas, maka tandanya Hugo berhasil diinstal. Tulisan +extended di atas terjadi ketika Anda menggunakan Hugo Extended, kalau tidak, maka tulisan tersebut memang tidak ada.

Kalau tidak muncul sama sekali atau bahkan mengalami pesan galat, maka artinya instalasi belum berhasil.

Membuat Halaman Panduan Hugo

Kalau mau, Anda juga dapat membuat halaman panduannya yang akan disimpan di dalam direktori pengguna dengan skrip berikut:

1
2
3
4

hugo gen man --dir '/tmp/hugo_manpages'
cd /tmp/hugo_manpages; gzip -9 *
install -Dm644 * -t "$HOME"/.local/share/man/man1
cd -; rm -rf /tmp/hugo_manpages

Secara baku, direktori "$HOME"/.local/share/man/man1 tidak dianggap sebagai tempat untuk menyimpan halaman panduan, sehingga tidak terbaca oleh Aplikasi pembaca Halaman Panduan seperti man.

Jadi, Anda harus memasukkan direktori tersebut ke dalam variabel MANPATH bersamaan dengan direktori lainnya yang ada di dalam perintah manpath -g.

Anda bisa gunakan perintah di bawah ini untuk menambahkannya:

MANPATH="$(manpath -g):$HOME/.local/share/man" && export MANPATH

Atau, jika Anda menggunakan fish sebagai Shell, silakan gunakan perintah berikut:

set -gx MANPATH (manpath -g) "$HOME"/.local/share/man

Anda bisa menyimpan salah satu dari perintah di atas ke dalam berkas konfigurasi untuk Shell yang Anda gunakan agar perintah tersebut bisa dieksekusi ketika Shell dijalankan secara interaktif.

Membuat fitur Shell Completion untuk Hugo

Jika Anda adalah pengguna fish sebagai Shell, maka Anda dapat memasang fitur Shell Completion-nya dengan perintah berikut:

hugo completion fish | install -Dm644 /dev/stdin "$HOME/.config/fish/completions/hugo.fish"

Atau, jika Anda adalah pengguna GNU Bash, maka Anda dapat memasang fitur Shell Completion-nya dengan perintah berikut:

hugo completion bash | install -Dm 644 /dev/stdin "$HOME/.local/share/bash-completion/completions/hugo"

Fitur seperti ini akan memerlukan paket/perkakas yang bernama bash-completion dan itu bisa Anda instal di dalam distribusi yang Anda gunakan.

Biasanya, perkakas tersebut sudah terinstal secara baku di beberapa distribusi GNU/Linux, seperti: Ubuntu, openSUSE, Fedora, Manjaro, dll. Namun jika Anda merasa tidak demikian, maka Anda bisa menginstalnya sendiri dengan mengikuti petunjuk dari distribusi Anda.

Jika Anda menggunakan perkakas bash-completion versi 2.8 atau di atasnya (seperti yang ada pada mayoritas Distribusi GNU/Linux), maka seharusnya itu langsung bekerja.

Namun jika Anda merasa masih menggunakan versi di bawahnya atau merasa kurang yakin, maka Anda dapat menambahkan baris skrip berikut ke dalam berkas ~/.bash_completion ataupun di dalam berkas ~/.bashrc:

for bcfile in "$HOME"/.local/share/bash-completion/completions/* ; do
  [ -f "$bcfile" ] && . $bcfile
done

Catatan: Skrip di atas saya dapatkan dari Jawaban Russell E Glaue untuk pertanyaan “Standard place for user defined bash_completion.d scripts?” di Server Fault, dilisensikan di bawah CC BY-SA 4.0 oleh penjawab.

Dengan begitu, Anda bisa menggunakan fitur Shell Completion-nya di dalam Bash.

Namun jika Anda menggunakan Z Shell (disingkat menjadi zsh), maka pertama-tama Anda perlu ketahui terlebih dahulu isi dari variabel FPATH dengan perintah berikut beserta keluarannya:

1
2

$ echo $FPATH
/home/user/.oh-my-zsh/plugins/colored-man-pages:/home/user/.oh-my-zsh/plugins/sudo:/home/user/.oh-my-zsh/plugins/debian:/home/user/.oh-my-zsh/plugins/git:/home/user/.oh-my-zsh/functions:/home/user/.oh-my-zsh/completions:/home/user/.oh-my-zsh/cache/completions:/usr/local/share/zsh/site-functions:/usr/share/zsh/site-functions:/usr/share/zsh/functions/Calendar:/usr/share/zsh/functions/Chpwd:/usr/share/zsh/functions/Completion:/usr/share/zsh/functions/Completion/Base:/usr/share/zsh/functions/Completion/Linux:/usr/share/zsh/functions/Completion/Unix:/usr/share/zsh/functions/Completion/X:/usr/share/zsh/functions/Completion/Zsh:/usr/share/zsh/functions/Exceptions:/usr/share/zsh/functions/Math:/usr/share/zsh/functions/MIME:/usr/share/zsh/functions/Misc:/usr/share/zsh/functions/Newuser:/usr/share/zsh/functions/Prompts:/usr/share/zsh/functions/TCP:/usr/share/zsh/functions/VCS_Info:/usr/share/zsh/functions/VCS_Info/Backends:/usr/share/zsh/functions/Zftp:/usr/share/zsh/functions/Zle

Hasil keluaran di atas mungkin akan berbeda-beda pada setiap perangkat, adapun tulisan /home/user/.oh-my-zsh pada keluaran di atas itu akan terjadi jika Anda menggunakan oh-my-zsh sebagai kerangka kerja untuk mengelola konfigurasi Z Shell Anda.

Variabel tersebut mendefinisikan satu set direktori, yang berisi berkas yang dapat ditandai untuk dimuat secara otomatis oleh Z Shell saat dijalankan, termasuk Completion-nya. Jadi, ketika Anda membuat sebuah skrip Completion, maka Anda perlu meletakkannya di dalam salah satu direktori yang ada di dalam variabel FPATH itu tadi.

Contohnya jika Anda menggunakan oh-my-zsh, maka Anda perlu meletakkannya di dalam folder ~/.oh-my-zsh/completions dan kabar baiknya direktori tersebut ada di dalam variabel FPATH. Berikut adalah perintah untuk membuat Completion-nya:

hugo completion zsh | install -Dm 644 /dev/stdin "$HOME/.oh-my-zsh/completions/_hugo"

Namun jika Anda tidak menggunakan oh-my-zsh, Anda bisa mengganti $HOME/.oh-my-zsh/completions/_hugo di atas menjadi direktori lain, tetapi termasuk dalam variabel FPATH.

Jika Anda ingin meletakkannya di dalam direktori kustom yang mana itu tidak termasuk dalam variabel FPATH, maka Anda perlu memasukkan direktori tersebut ke dalam variabelnya secara manual dengan perintah/skrip berikut:

FPATH="/direktori/kustom/kamu:$FPATH" && export FPATH

Atau, perintah berikut:

fpath=( /direktori/kustom/kamu "${fpath[@]}" )

Atau, berikut di bawah ini jika Anda ingin multi-baris:

fpath=(
    /direktori/kustom/kamu
    /direktori/kustom/kamu2
    "${fpath[@]}"
)

Anda bisa simpan perintah/skrip di atas di dalam berkas ~/.zshrc agar perintah tersebut dapat dieksekusi oleh Z Shell ketika dijalankan secara interaktif.

Penutup

Sudah? Iya, sudah, cuma itu saja yang perlu Anda lakukan. Ini merupakan Artikel yang membahas tentang ‘Cara Install Hugo’, bukan ‘Cara Install Hugo beserta konfigurasinya’, walaupun saya sedikit berbasa-basi tentang apa itu Hugo dan apa saja variannya.

Demi kesederhanaan Artikel ini, maka topik tentang membuat Blog di Hugo beserta konfigurasinya akan saya bahas secara terpisah.

Jika kamu mempunyai pertanyaan, kritik dan saran, komentar atau masukkan lainnya, silakan kamu berkomentar melalui kolom komentar yang tersedia atau bisa kamu Hubungi Saya.

Terima kasih atas perhatiannya 😊