用 Hugo 搭建你的個人部落格!

遇見 Hugo

今天來談談 Hugo 環境設定時所遇到的一些問題及解決辦法。

預備環境

要開始使用 Hugo ,若您的環境跟我一樣是 macOS 的話,可以考慮方便易用的 brew: 在終端機輸入以下指令後,便會開始下載需要的套件。

brew install hugo

設定 GitHub 端

  1. 新建一個 repository 名為 <YOUR_GITHUB_USERNAME>.github.io,以我為例:walkccc.github.io
  2. 在 Settings > Pages 中:
    • Branch: main
    • Folder: /docs
    • Custom domain: walkccc.me(若有改域名)

開始架站

  1. Clone the GitHub repository

    git clone walkccc.github.io
    
  2. 改變路徑到該資料夾.

    cd walkccc.github.io
    
  3. 新建成一個新的 Hugo 資料夾

    hugo new site . --force
    
  4. 加入想使用的主題

    git clone https://github.com/Track3/hermit.git themes/hermit
    
  5. 將主題範例檔案複製進根目錄

    cp -a themes/hermit/exampleSite/. ./
    
  6. 編輯 config.toml

    • [Author][params] 等設定前加入 publishDir = "docs"
    • 改變 baseURL = "https://walkccc.me"
  7. 新增 CNAMEwalkccc.me(若有改域名)

  8. 在本地設定

    bash serve --buildDrafts
    
  9. 新增 commit 並提交到 GitHub

    git add - A
    git commit -m "Initial commit"
    git push origin main
    

這時稍等片刻,在 https://walkccc.me 就能看到你的網站了!