Hugo 的安裝

官網有豐富的文件,在這摘要一下:

各平台的 Install guide

如不想安裝,可直接下載不同版本的 Releases

檢查 Hugo 版本

hugo version

建立 Hugo 站點

首先建立以 XXXX 命名的 Site Project

hugo new site XXXX
cd XXXX

套用模版

Hugo 的官網提供了很多模版,找一個自己喜歡的 然後使用以下指令,可把指定的 Theme 下載到你的 Project 中使用

git submodule add https://github.com/aaa/xxxx.git themes/xxxx

當你需要 reclone 時使用,因為 submodules 不會自動下載

git submodule update --init --recursive

其實套用模版的方法很多,裏面都有教學,不過上面的方法就比較不影響現有的東西,然後在 config.toml 中進行設定即可使用

theme="xxxx"

編寫文章

根據相關模版建立新文章

hugo new posts/first.md

由於指令中指定在posts的文件夾中產生文章,所以會根據以下順序去查找模版

  • archetypes/posts.md
  • archetypes/default.md
  • themes/my-theme/archetypes/posts.md
  • themes/my-theme/archetypes/default.md

啟動 Server, -D 為 development

hugo -D server

在瀏覽器中打開http://localhost:1313就可以見到生成的網頁

生成靜態網站

hugo --gc --minify

在 public 內生成靜態網站 –minify 會將資源進行壓縮