貢獻

2024年6月3日 1 分鐘閱讀文檔 Docker Git

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

贊助

成為我們的資助者或贊助商，以支持我們的工作。

本頁內容

贊助商

我們假定你已經具備了 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，我們需要將其克隆到 docker/hugo/src。

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

請將 <version> 替換為特定的版本，比如 v0.126.1。

修改文件並保存改動，然後構建一個本地鏡像，以 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]'

[build] 是必須的，其用於觸發構建流程。

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