可以为组织或个人帐户的问题模板创建默认问题模板和默认配置文件。 有关详细信息,请参阅“创建默认的社区运行状况文件”。
创建议题模板
-
在 你的 GitHub Enterprise Server 实例 上,导航到存储库的主页。
-
在存储库名称下,单击 “设置”。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。
-
在“功能”部分的“问题”下,单击“设置模板” 。 可能需要启用“问题”并刷新页面,然后才能看到按钮。
-
使用“添加模板”下拉菜单,单击要创建的模板类型。
-
要在提交到存储库之前预览或编辑模板,请单击模板旁边的“预览和编辑”。
-
要编辑模板,请单击 ,然后在字段中键入以编辑其内容。
-
要自动设置默认问题标题,将问题分配给对存储库具有读取权限的人,或将标签应用于从模板提出的问题,请使用“可选附加信息”下的字段。 还可使用 YAML frontmatter 格式中的
title
、labels
或assignees
将这些详细信息添加到问题模板中。 -
完成编辑和预览模板后,请单击页面右上角的“提供更改”。
-
在“提交消息”字段中,键入描述更改的提交消息。
-
在提交消息字段的下方,选择是直接将模板提交到默认分支,还是创建新分支并打开拉取请求。 有关拉取请求的详细信息,请参阅“关于拉取请求”。
-
单击“提交更改”。 将这些更改合并到默认分支后,贡献者在仓库中打开新议题时便可使用该模板。
配置模板选择器
可以通过向 .github/ISSUE_TEMPLATE
文件夹添加 config.yml
文件来自定义用户在存储库中创建新问题时看到的问题模板选择器。
你可通过将 blank_issues_enabled
设置为 false
来鼓励贡献者使用问题模板。 如果将 blank_issues_enabled
设置为 true
,则用户可以选择打开空白问题。
注意: 如果使用旧工作流在 .github
文件夹中手动创建 issue_template.md
文件,并在“config.yml”文件中启用空白问题,则当用户选择打开空白问题时,将使用 issue_template.md
中的模板。 如果您禁用空白议题,将永远不会使用模板。
如果你愿意在 GitHub Enterprise Server 之外接收某些报告,可使用 contact_links
将用户引导到外部网站。
下面是“config.yml”文件的一个示例。
blank_issues_enabled: false contact_links: - name: GitHub Community Support url: https://github.com/orgs/community/discussions about: Please ask and answer questions here. - name: GitHub Security Bug Bounty url: https://bounty.github.com/ about: Please report security vulnerabilities here.
blank_issues_enabled: false
contact_links:
- name: GitHub Community Support
url: https://github.com/orgs/community/discussions
about: Please ask and answer questions here.
- name: GitHub Security Bug Bounty
url: https://bounty.github.com/
about: Please report security vulnerabilities here.
当文件合并到仓库的默认分支时,您的配置文件将自定义模板选择器。
-
在 你的 GitHub Enterprise Server 实例 上,导航到存储库的主页。
-
在文件列表上方,使用“添加文件”下拉列表,在其中单击“创建新文件” 。
-
在“文件名”字段中,键入
.github/ISSUE_TEMPLATE/config.yml
。 -
在新文件的正文中,键入配置文件的内容。
-
在“提交消息”字段中,输入简短、有意义的提交消息,以描述对文件的更改。 您可以在提交消息中将提交归于多个作者。 有关详细信息,请参阅“创建有多个作者的提交”。
-
在提交消息字段下面,确定是要将提交添加到当前分支还是新分支。 如果当前分支是默认分支,则应选择为提交创建新分支,然后创建拉取请求。 有关详细信息,请参阅“创建拉取请求”。
-
单击“提交更改”或“建议更改” 。
更改模板顺序
要设置问题模板在模板选择器中的显示顺序,可以更改模板文件名。 .github/ISSUE_TEMPLATE
中的模板按字母数字列出,按文件类型分组,并且 YAML 文件显示在 Markdown 文件之前。
要控制模板的顺序,请给文件名添加数字前缀。 例如:1-bug.yml
、2-feature-request.yml
和 3-epic.yml
。
如果有 10 个或更多模板,字母数字排序意味着 11-bug.yml
将位于 1-feature.yml
和 2-support.yml
之间。 要保留预期排序,可以在数字文件名前额外加上一个 0
。 例如:01-feature.yml
、02-support.yml
和 11-bug.yml
。