hugo host in github

在此網站建立時順手作的紀錄文章

github 提供一個功能叫做 GitHub Pages

GitHub Pages 讓 github 帳號建立 repository 後讓該 repository 能夠以靜態網頁呈現內容

好處是你不需要有 server 、 DNS domain 就能夠使用當使用 markdown 編寫文件，並結合 Jekyll 就能產生簡易的部落格

在此指之前我都使用 GCP 開一個永久免費的 VM 架設 wordpress 使用

論功能來說 wordpress 較強大但文件應用彈性，使用 markdown 會較容易比如說我可以將筆記功能與網站結合，而不需要發布兩個地方

GitHub Pages 介紹可以使用 Jekyll 作為網站生成器但評估後，覺得 HUGO 似乎較符合我所以這網站就以 HUGO 建立

建置流程簡介

建立 github 帳號並建立 2 個 repository
下載網站生成器 hugo
下載 VScode、gitdesktop
生成網站、文章
發佈到 github

建立 github 帳號並建立 2 個 repository

github 預設會將 <username>.github.io 這個 Repository name 直接對應到 https://<username>.github.io 這個 domain 如果你想要使用其他 Repository name 也是可以設定為虛擬目錄使用

這邊我們建立兩個 repository 一個用為供 public 瀏覽用另一個做為我們網站程式碼的保存用 (這步驟就非必要)

以我舉例我分別建立 lovesharepc.github.io 權限: public hugo_sitetool 權限: private

下載 VScode、github desktop

下一步我們要準備好開發工具

VScode 可以作為多功能的編輯器(包含 markdown) https://code.visualstudio.com/

GitHub Desktop 則是用來將我們的網站 push 到網路上 https://desktop.github.com/

下載網站生成器 hugo

到 hugo 的 github 下載執行檔

https://github.com/gohugoio/hugo/releases

在電腦上建立目錄 hugo_sitetool 使用 github desktop 將 github reopsitory clone 至此

將 hogo 檔案放置此處並設定環境變數

開啟 terminal 軟體嘗試執行 hugo 確認是否能正常運作 hugo help

PS D:\Gdrive\hugo_sitetool\quickstart> hugo help
hugo is the main command, used to build your Hugo site.

Hugo is a Fast and Flexible Static Site Generator
built with love by spf13 and friends in Go.

Complete documentation is available at http://gohugo.io/.

Usage:
  hugo [flags]
  hugo [command]

Available Commands:
  completion  generate the autocompletion script for the specified shell
  config      Print the site configuration
  convert     Convert your content to different formats
  deploy      Deploy your site to a Cloud provider.
  env         Print Hugo version and environment info
  gen         A collection of several useful generators.
  help        Help about any command
  import      Import your site from others.
  list        Listing out various types of content
  mod         Various Hugo Modules helpers.