在 ReadTheDocs 上自动构建#

本文介绍了如何在每次将合并请求合并到相应的 GitHub 仓库时，自动在 ReadtheDocs 上重建文档。

使用 ReadTheDocs 服务#

可以在 GitHub 仓库设置中启用 Webhook 和服务，以允许 ReadTheDocs 等第三方服务。ReadTheDocs 服务会在将合并请求合并到 GitHub 仓库时重建项目文档。

导航到设置#

每个 GitHub 仓库在仓库菜单栏的最右侧都有一个设置选项卡。导航到设置，然后导航到Webhook 和服务子菜单选项卡。

The ipywidgets GitHub repository's "Settings" tab has been opened, with the "Add service" submenu expanded. The "ReadTheDocs" menu item is highlighted to indicate where on the page this setting can be found.

添加 ReadTheDocs 服务#

选择添加服务，并在可用服务输入框中输入ReadTheDocs。

服务/添加 ReadTheDocs 窗口将打开。按绿色的添加服务按钮激活 ReadTheDocs 服务。

In GitHub, the "Settings" tab of the ipywidgets repository shows that the "ReadTheDocs" service was successfully added to the project. A checkbox with the label "Active" indicates that the service is currently running.

成功#

ReadTheDocs 服务已成功添加。该服务将在下次合并拉取请求到项目仓库时生效。

In GitHub, the ipywidgets repository page is open. A banner notification at the top of the page is displayed, reading "Okay, that hook was successfully created."

创建：01-07-2016