贡献

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 将弹出一个按钮来创建拉取请求。我们将于测试通过后，对其审查和合并。