Hugo adalah salah satu static framework untuk membuat website atau biasa dikenal dengan istilah framework static site generators.
Untuk menginstall hugo di Windows, choco paket manajer harus terlebih dahulu terinstall.
Install Hugo
- Untuk menginstall hugo dapat dijalankan melalui cmd (administrator level) cukup dengan perintah berikut
choco install hugo -confirm
- Setelah terinstall, tes dengan menjalankan perintah hugo
> hugo help untuk mengetahui lokasi hugo terinstall > where hugo
- Untuk membuat situs baru dengan hugo cukup dengan perintah berikut (tanpa petik)
> hugo new site 'namasitus'
- Folder baru akan dibuat dengan struktur folder berikut.
|-- config.toml |-- archetypes | |-- default.md |-- content |-- data |-- layouts |-- static |-- themes
- Untuk menggunakan tema di hugo bisa dengan 3 cara
- git submodule
- git clone
- menyalin (copy) file zip secara langsung ke dalam folder themes
- Contoh dengan menggunakan git clone untuk merubah tema
> git clone add https://github.com/bul-ikana/hugo-cards.git themes/kartu
- download tema dari git repositori dan masukkan ke dalam folder
themes
dengan nama kartu
- download tema dari git repositori dan masukkan ke dalam folder
- Untuk menggunakan tema, edit file
config.toml
baseURL = "http://example.org/" languageCode = "en-us" title = "My New Hugo Site" theme = "kartu" #baris untuk merubah tema
- Simpan file, dan jalankan hugo dari direktori root
> hugo server
- Pergi ke browser dan buka alamat
localhost:1313
karena secara default hugo akan menggunakan port tersebut. - Untuk membuat file baru bisa menggunakan perintah
> hugo new post\newpost.md
- Versi hugo terbaru (v0.58) menggunakan / untuk membuat file dalam folder post
> hugo new posts/newpost.md
- Pastikan dalam menjalankan perintah di atas kita berada di direktori root dari hugo site yang dibuat
- Hugo secara otomatis akan membuat sebuah file
newpost.md
dalam folder ..\content\post
Menggunakan exampleSite dari Tema Hugo
Biasanya, tema dari hugo sudah menyediakan contoh website agar kita dapat melihat struktur postingan dan foldernya seperti apa. Langkah menggunakannya sebagai berikut
- Pastikan sudah membuat site hugo
hugo new site ...
- Masuk ke dalam folder themes\namatema
- Jalankan hugo dari folder tema yang digunakan
> hugo server --source=exampleSite --themesDir=../..
- Artinya, server hugo akan berjalan dari direktori exampleSite dengan parameter exampleSite\config.toml dan mengambil tema dari direktori themes (–themesDir=../..)
Menghapus Hugo
Menghapus hugo cukup dari paket manager choco
> choco uninstall hugo