创建讨论类别表单

您可以自定义社区成员在您的仓库中打开新讨论时可用的模板。

本文内容

关于讨论类别表单

您可以通过在您的仓库中使用讨论表单来鼓励社区成员在他们的讨论中包含特定的结构化信息。使用讨论类别表单，您可以创建具有可自定义的 Web 表单字段的讨论模板。讨论表单使用 GitHub 表单模式以 YAML 编写。有关更多信息，请参阅“GitHub 表单模式语法”。

如果您是 YAML 新手，想要了解更多信息，请参阅“在 Y 分钟内学习 YAML”。

要在您的仓库中使用讨论类别表单，您必须创建一个新文件并将其添加到您的仓库中的 /.github/DISCUSSION_TEMPLATE/ 文件夹中。

您也可以为您的组织创建讨论类别表单。有关更多信息，请参阅“创建默认社区健康文件”。

讨论类别表单不支持投票。有关投票的更多信息，请参阅“关于讨论”。

以下是问题表单的渲染版本。

Screenshot of a rendered discussion category form.

创建讨论类别表单

具有仓库写入权限的人员可以创建讨论类别表单。

  1. 导航到您要创建讨论类别表单的仓库。
  2. 在您的仓库中，创建一个名为 /.github/DISCUSSION_TEMPLATE/FORM-NAME.yml 的文件，将 FORM-NAME 替换为您的讨论类别表单的名称。该名称必须与您的某个讨论类别的 slug 相对应。例如，“公告”类别的模板应为 .github/DISCUSSION_TEMPLATE/announcements.yml。有关在 GitHub 上创建新文件的更多信息，请参阅“创建新文件”。
  3. 在新文件的正文中，键入您的讨论类别表单的内容。有关更多信息，请参阅“讨论类别表单语法”。
  4. 将您的文件提交到您的仓库的默认分支。有关更多信息，请参阅“创建新文件”。