Cara Memasang Hugo Di Windows 10

Introduction

Apakah kamu ingin membuat blog dengan Hugo? Artikel ini cocok buatmu, karena disini akan dijelaskan langkah-langkah berikut :

  1. Install Chocolatey untuk windows
  2. Install Hugo lewat perintah choco
  3. Install Git untuk clone theme hugo dari github
  4. Install Powershell (bukan windows powershell, beda!)
  5. Create Site
  6. Set theme hugo
  7. Add content (menambah artikel)
  8. Configure site
  9. Publish

Install Chocolatey

Buka Windows PowerShell dengan Run Administrator, lalu ketikkan perintah dibawah

Get-ExecutionPolicy

Jika hasil policy-nya “Restricted”, maka lakukan perubahan ke “AllSigned” dengan mengetikkan perintah

Set-ExecutionPolicy AllSigned

Lalu ketik perintah berikut

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

Cek apakah choco terinstall dengan mengetik perintah berikut

choco version

Jika choco sukses terinstall, akan muncul versi choco seperti berikut

Chocolatey v1.3.0

Install Hugo

Kita akan menginstall hugo extended di windows menggunakan choco. Ketik perintah berikut

choco install hugo-extended

Cek versi hugo untuk memastikan hugo sudah terinstall

hugo version

Install Git

Lalu install Git dengan menggunakan Choco

choco install git

dan cek git sudah terinstall

git version

Install PowerShell

Sekarang kita butuh install Powershell, berbeda dengan windows powershell bawaan. Dalam hal ini saya menggunakan Powershell 7. Caranya adalah dengan membuka windows powershell, lalu ketik perintah berikut

winget search Microsoft.PowerShell
winget install --id Microsoft.Powershell --source winget

Setelah sukses, anda akan melihat menu Powershell di start menu

Create site

Untuk membuat site dengan hugo, kita gunakan Powershell (bukan windows powershell) yang sudah kita install diatas. Misal kita ingin membuat site hugo didalam folder D:/Hugo maka buatlah direktori tersebut di windows explorer. Lalu ketikkan perintah berikut

d:
cd .\Hugo\
hugo new site myblog
cd myblog

Kini anda sudah mempunyai site hugo dengan mana myblog

Set Theme

Lalu kita akan memilih theme yang dapat digunakan untuk site kita, silakan kunjungi https://themes.gohugo.io/ lalu pilih theme yang diinginkan. Misal kita pilih theme hugo-blog-awesome, ketikkan perintah berikut di Powershell tadi

git clone https://github.com/hugo-sid/hugo-blog-awesome.git themes/hugo-blog-awesome
echo "theme = 'hugo-blog-awesome'" >> config.toml

Configure site

Untuk konfigurasi site, saya rekomendasikan anda untuk menggunakan visual studio code. Buka file config.toml yang ada di root folder site kita, contoh D:\Hugo\myblog\config.toml

Anda akan melihat isi nya seperti berikut, silakan ganti sesuai kebutuhan

baseURL = 'http://example.org/'
languageCode = 'en-us'
title = 'My New Hugo Site'
theme = 'hugo-blog-awesome'

Add content

Untuk menambah artikel di hugo, ketikkan perintah berikut

hugo new posts/myfirstpost.md

Silakan buka file D:\Hugo\myblog\content\posts\myfirstpost.md dengan visual studio code, dan tulislah artikel dengan menggunakan format markdown. Markdown adalah bahasa yang sangat mudah dalam menulis artikel.

Berbeda dengan html yang perlu kode-kode rumit, markdown sangat mudah untuk membuat heading, paragraf, bold, italyc, blockquotes, list, code, dll, silakan lihat https://www.markdownguide.org/basic-syntax

Perlu diingat, bahwa saat kita bikin artikel baru, status default nya adalah draft, bukan publish, seperti berikut ini

---
title: "Cara Memasang Hugo Di Windows 10"
date: 2023-03-10T06:00:18+07:00
draft: true
---

Untuk mempublish nya, cukup ganti menjadi draft: false

Test server

Jalankan perintah berikut untuk melihat site kita dengan atribute -D yang menunjukkan, kita dapat melihat artikel yang masih status draft.

hugo server -D

Publish

Untuk melakukan publish site, ketikkan perintah berikut

hugo

Maka file website static anda akan ada di folder public, yaitu D:\Hugo\myblog\public. Silakan upload file tersebut ke hosting anda.