Skip to main content

自动生成的发行说明

您可以为 GitHub 版本自动生成发行说明

Repository collaborators and people with write access to a repository can generate and customize automated release notes for a release.

关于自动生成的发行说明

自动生成的发行说明为 GitHub 发行版手动编写发行说明提供了一种自动替代方法。 使用自动生成的发行说明,您可以快速生成发行版内容的概览。 自动生成的发行说明包括合并的拉取请求列表、版本贡献者列表以及指向完整更改日志的链接。

您还可以自定义自动发行说明,使用标签创建自定义类别来组织要包含的拉取请求,并排除某些标签和用户不出现在输出中。

为新版本创建自动生成的发行说明

  1. 在 您的 GitHub Enterprise Server 实例 上,导航到仓库的主页面。

  2. 在文件列表右侧,单击 Releases(发行版)右侧边栏中的 Releases(发行版)部分

  3. 单击 Draft a new release(草拟新发行版)发行版草稿按钮

  4. 键入发行版的版本号。 或者,选择现有标记。

    发行版标记版本

  5. 如果已创建新标记,请使用下拉菜单选择包含要发布的项目的分支。 发行版标记分支

  6. 在说明文本框的右上角,单击Auto-generate release notes(自动生成发行说明)Auto-generate release notes

  7. 检查生成的注释,确保它们包含所有(且仅有)您要包含的信息。

  8. (可选)要在发行版中包含二进制文件(例如已编译的程序),请在二进制文件框中拖放或手动选择文件。 通过发行版提供 DMG

  9. 要通知用户发行版本尚不可用于生产,可能不稳定,请选择 This is a pre-release(这是预发布)将版本标记为预发行版的复选框

  10. 如果您准备推广您的发行版,请单击 Publish release(发布版本)。 要在以后处理该发行版,请单击 Save draft(保存草稿)发布版本和草拟发行版按钮

配置自动生成的发行说明

  1. 在 您的 GitHub Enterprise Server 实例 上,导航到仓库的主页面。
  2. 在文件列表上方,使用 Add file(添加文件)下拉菜单,单击 Create new file(创建新文件)"添加文件"下拉菜单中的"创建新文件"按钮
  3. 在文件名字段中,键入 .github/release.yml 以在 .github 目录中创建 release.yml 文件。 创建新文件
  4. 在文件中,使用下面的配置选项,在 YAML 中指定要从此版本中排除的拉取请求标签和作者。 您还可以创建新类别并列出要包含在每个类别中的拉取请求标签。

配置选项

参数描述
changelog.exclude.labels不在发行说明中显示拉取请求的标签列表。
changelog.exclude.authors要从发行说明中排除其拉取请求的用户或自动程序登录句柄的列表。
changelog.categories[*].title必需。发行说明中更改类别的标题。
changelog.categories[*].labels必需。符合此类别的拉取请求条件的标签。 使用 * 作为与上述任何类别都不匹配的拉取请求的统称。
changelog.categories[*].exclude.labels不在此类别中显示拉取请求的标签列表。
changelog.categories[*].exclude.authors要从此类别中排除其拉取请求的用户或自动程序登录句柄的列表。

示例配置

YAML
# .github/release.yml

changelog:
  exclude:
    labels:
      - ignore-for-release
    authors:
      - octocat
  categories:
    - title: Breaking Changes 🛠
      labels:
        - Semver-Major
        - breaking-change
    - title: Exciting New Features 🎉
      labels:
        - Semver-Minor
        - enhancement
    - title: Other Changes
      labels:
        - "*"

延伸阅读