1

brew install hugo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# 若未安裝過 Scoop，需先：
# 1. 第一次需先設定，允許遠端腳本
# Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# 2. 下載並安裝 Scoop
# irm get.scoop.sh | iex

# 透過 Scoop 安裝 Hugo
scoop install hugo

# 如需安裝指定版本
scoop install [email protected]

# 安裝擴展版本
scoop install hugo-extended

1
2
3
4
5
6
7
8

# 透過 Chocolatey 安裝 Hugo
choco install hugo

# 如需安裝指定版本
choco install hugo --version=0.100.2

# 安裝擴展版本
choco install hugo-extended

1

sudo apt-get install hugo

1
2

# 進到本地資料夾根目錄後
hugo new site . --force

1

git submodule add git://github.com/CaiJimmy/hugo-theme-stack/ themes/hugo-theme-stack

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

name: Auto build and publish to public site repository

# 只有推送到 main 才觸發
on:
  push:
    branches: 
      - "main"
  pull_request:
    branches: ["main"]

jobs:
  hugo-publish:
    name: publish content to public site
    runs-on: ubuntu-latest
    steps:
      # 使用當前 source code 的 repo
      - name: checkout source code repo
        uses: actions/checkout@v3
        with:
          # 因為目前的 repo 有使用到 submodule(hugo themes)，所以 submodule 也要一併同步，不然原本的 repo 是沒有 submodule 的內容
          submodules: true
          token: ${{ secrets.ACCESS_TOKEN }}

      # public 網站是放置在另一個 repo 所以這裡也要 clone 一份下來處理
      # 因為我 Hugo 預設是產生檔案到 public 資料夾，所以將 public repo clone 到 ./public/ 內，以便後續 publish
      - name: clone and checkout public repo
        uses: actions/checkout@v3
        with:
          # 這裡是 public 網站在 github 上的 repo 名稱
          repository: {template/template-public-repo-name}
          path: public
          # tip: 需事先產生一把 personal access token 放到 repo 的 secrets 裡
          # 然後 secrets 裡的名稱就叫 ACCESS_TOKEN
          # 參考 https://help.github.com/en/actions/automating-your-workflow-with-github-actions/authenticating-with-the-github_token
          token: ${{ secrets.ACCESS_TOKEN }}

      # 使用別人做好的 Hugo Actions
      - name: setup hugo
        uses: peaceiris/actions-hugo@v2
        with:
          hugo-version: latest
          extended: true

      # 用 Hugo 產生檔案
      - name: build content to public site
        working-directory: ./
        # --cleanDestinationDir 清除舊檔案
        run: hugo --minify --gc --cleanDestinationDir

      # 將檔案 commit 到 網站 public repo
      - name: deploy and publish updates
        working-directory: ./public
        # user.email 還有 user.name 可以取自己喜歡的，一定要設定不然會出錯
        run: |
          # 當 git 有更動時才進行動作
          if [[ `git status --porcelain` ]]; then
            git config --local user.email "{typing your email}"
            git config --local user.name "{typing your name}"
            git add . -A
            git commit -m "build: auto publish"
            git push origin
          else
            echo "content no changes"
          fi          

      # 清除 cloudflare dns cache
      - name: clear cloudflare cache
        uses: nathanvaughn/actions-cloudflare-purge@master
        with:
          # Using Zone Id
          cf_zone: ${{ secrets.CLOUDFLARE_ZONE }}

          # Using API Token
          cf_auth: ${{ secrets.CLOUDFLARE_API_TOKEN }}