GitHub Pages 是一个 CI/CD 管道

在你的工作流程中整合少量自动化可以极大地提高你的生产力和开发速度。

图片来源：

Opensource.com

GitHub 的超能力之一是能够神奇地将你的文档转换为网站。如果你为你的 AwesomeProject 网站上的 docs/ 文件夹配置了 GitHub Page，你最终会得到 yourname.github.io/awesomeproject，其中显示你的文档，而且全部免费。

但这实际上不是魔法。可惜的是，即使我们已经教会玻璃思考，对于任何看起来像是魔法的东西，我们仍然只能感谢技术的先进应用。

GitHub Pages 只是 GitHub 内的一个集成途径，帮助你设置 Jekyll 项目。 Jekyll 是一个用 Ruby 编写的静态站点生成器。开箱即用，你可以使用 markdown 文件快速生成网站，这些文件随后被合并到预格式化的 HTML 模板主题中。 GitHub Pages 有许多默认主题可用，或者你可以使用许多免费模板之一。

图片来源：

^{有许多开源许可的模板可供使用。}

当你首次设置 GitHub Pages 时，你需要声明要从哪个分支构建以及要使用的域名。当你合并到该分支时，GitHub 会获取你的 Jekyll 站点，渲染它，并将其托管在你的域名上。你无需执行任何其他操作。无需 FTP 传输到服务器。无服务器成本。无 GitHub 成本。这就是自动化的全部力量。

使用 Netlify PR 预览功能将其提升到 11

此系统的局限性之一是在你使用拉取请求 (PR) 时。如果你想测试你的代码，你必须在本地运行 Jekyll。这并不十分困难，但是当你审查别人的 PR 时，例如当它与项目主页上的文档相关时，你希望能够看到如果你合并 PR，新网站会是什么样子。特别是当提议的更改可能存在问题时（特别是大型更改、主题/布局的更改等）。

通常，你必须转到 PR，克隆 repo 的 fork 并检出用于 PR 的分支，将该代码合并到你的本地 master 中，在 Jekyll 中构建该版本的代码，然后打开本地服务器以查看更改。

但最棒的是，你可以自动化此过程。

其中一项服务是 Netlify。你可以使用 Netlify 来托管你的项目，但你也可以使用其 Deploy Previews 功能为你的项目上的任何 PR 自动生成 Jekyll 站点。

它的持续部署文档展示了如何设置 Netlify 以在任何 PR 打开或更新时自动构建你的站点。该构建的结果以临时网站的形式提供，该网站链接在 PR 底部的“检查”部分中，针对 PR 和项目唯一命名。你可以有多个活动的 PR，Netlify 将独立更新预览！

这极大地改进了 PyCon AU 的网站开发流程，PyCon AU 正在使用 GitHub Pages 来托管 2019 年活动网站。我们大量借鉴了 DjangoCon US 的这个想法和 Netlify 设置，DjangoCon US 在 GitHub 上拥有每个 DjangoCon 网站。好吧，它们中的大多数，因为有一个正在进行的项目，以确保每个 DjangoCon 会议网站都为了后代而被存档。