Skip to main content

关于议题和拉取请求模板

利用议题和拉取请求模板,可以自定义和标准化您希望贡献者在您的仓库中打开议题和拉取请求时加入的信息。

在仓库中创建议题和拉取请求后,贡献者可以根据仓库的参与指南使用模板打开议题或描述其拉取请求中提议的更改。 有关将贡献指南添加到仓库的详细信息,请参阅 设置仓库参与者指南

你可以为组织或个人帐户创建默认问题和拉取请求模板。 有关详细信息,请参阅“创建默认的社区运行状况文件”。

议题模板

当你使用问题模板构建器或使用问题表单为存储库创建问题模板时,贡献者可以在存储库中开立新问题时选择合适的模板。

“新问题”页的屏幕截图,其中包含多个模板可供选择。

当您想为开设议题提供指导,同时允许贡献者指定议题的内容时,议题模板很有用。 如果你希望贡献者在开立问题时提供特定的结构式信息,则问题表单有助于确保你收到所需信息。

使用模板构建器,可以指定每个模板的标题和描述,添加模板内容,然后提交模板到默认分支或在仓库中打开拉取请求。 模板构建器会自动添加模板显示于新议题页面所需的 YAML 扉页标记。 有关详细信息,请参阅“为仓库配置议题模板”。

通过问题表单,你可以使用 GitHub 表单架构创建具有 Web 表单字段的模板。 当贡献者使用议题表单打开议题时,表单输入将转换为标准 Markdown 议题评论。 您可以指定不同的输入类型并根据需要设置输入,以帮助贡献者打开仓库中可操作的议题。 有关详细信息,请参阅 为仓库配置议题模板议题表单的语法

可以通过向 .github/ISSUE_TEMPLATE 文件夹添加 config.yml 文件来自定义用户在存储库中创建新问题时看到的问题模板选择器。 有关详细信息,请参阅 为仓库配置议题模板

问题模板存储在存储库的默认分支中的一个 .github/ISSUE_TEMPLATE 隐藏目录中。 如果您在另一个分支中创建模板,协作者将无法使用。 问题模板文件名不区分大小写,且需要 .md 扩展名。 使用问题表单创建的问题模板需要 .yml 扩展名。 要在社区配置文件清单中以 复选标记显示,问题模板必须位于 .github/ISSUE_TEMPLATE 文件夹中,并且包含 YAML 前页中的有效 name:about: 键(适用于 .md 文件中定义的问题模板),或包含有效的 name:description: 键(适用于 .yml 文件中定义的问题表单)。

可以使用旧议题模板工作流程在 Markdown 中手动创建单一议题模板,然后项目贡献者将自动在议题中看到模板的内容。 但是,我们建议使用已升级的多个问题模板构建器或问题表单来创建问题模板。 有关旧工作流的详细信息,请参阅 手动为仓库创建单一议题模板

您可以创建安全策略,向人们提供有关报告项目中安全漏洞的说明。 有关详细信息,请参阅“将安全策略添加到存储库”。

拉取请求模板

将拉取请求模板添加到仓库后,项目贡献者会自动在拉取请求正文中看到模板的内容。

必须在仓库的默认分支中创建模板。 在其他分支创建的模板无法供协作者使用。 你可以将拉取请求模板存储在存储库的可见根目录的 docs 文件夹或 .github 隐藏目录中。 拉取请求模板文件名不区分大小写,且具有 .md 或 .txt 等扩展名 。

有关详细信息,请参阅“为仓库创建拉取请求模板”。