貢獻

我們很高興看到有開發者願意為這個項目做出貢獻,在本節中,您將學習如何在本地環境中構建和測試映像,然後將更改提交到我們的倉庫中。

我們假定你已經具備了 Git 和 Docker 的基本技能。

克隆倉庫

你首先需要 fork 倉庫,然後將其克隆到本地。假定分叉倉庫為 https://github.com/username/hugo-docker

1git clone https://github.com/username/hugo-docker hugo-docker

更換工作目錄

然後更換工作目錄為 docker/hugo,其餘步驟均於該目錄下進行。

1cd hugo-docker/docker/hugo

克隆 Hugo 倉庫

為了從源代碼構建 Hugo,我們需要將克隆到 docker/hugo/src

1git clone -b <version> https://github.com/gohugoio/hugo src

構建鏡像

修改文件並保存改動,然後構建一個本地鏡像,以 exts 為例。

1docker build -t myhugo-exts -f Dockerfile-exts .

測試鏡像

你需要於本地測試鏡像以確保其正常工作。

1docker run -v ${PWD}:/src myhugo-exts hugo

編寫測試

我們強烈建議儘可能於構建工作流程中編寫測試,以確保推送到鏡像倉庫前萬無一失。

提交修改

當測試通過,則可以提交修改並推送到遠程倉庫了。

1git add .
2git commit -m 'Write some meaningful message [build]'

創建拉取請求

要創建一個拉取請求,只需導航到分叉倉庫,然後 GitHub 網頁 UI 將彈出一個按鈕來創建拉取請求。我們將於測試通過後,對其審查和合並。