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

  1. Untuk menginstall hugo dapat dijalankan melalui cmd (administrator level) cukup dengan perintah berikut
    choco install hugo -confirm
  2. Setelah terinstall, tes dengan menjalankan perintah hugo
    > hugo help
    untuk mengetahui lokasi hugo terinstall
    > where hugo
  3. Untuk membuat situs baru dengan hugo cukup dengan perintah berikut (tanpa petik)
    > hugo new site 'namasitus'
  4. Folder baru akan dibuat dengan struktur folder berikut.
    |-- config.toml
    |-- archetypes
    |    |-- default.md
    |-- content
    |-- data
    |-- layouts
    |-- static
    |-- themes
  5. Untuk menggunakan tema di hugo bisa dengan 3 cara
    • git submodule
    • git clone
    • menyalin (copy) file zip secara langsung ke dalam folder themes
  6. 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
  7. 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
  8. Simpan file, dan jalankan hugo dari direktori root
    > hugo server
  9. Pergi ke browser dan buka alamat localhost:1313 karena secara default hugo akan menggunakan port tersebut.
  10. Untuk membuat file baru bisa menggunakan perintah
    > hugo new post\newpost.md
  11. 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

  1. Pastikan sudah membuat site hugo hugo new site ...
  2. Masuk ke dalam folder themes\namatema
  3. Jalankan hugo dari folder tema yang digunakan
    > hugo server --source=exampleSite --themesDir=../..
  4. 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