创建讨论分类表单

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

本文内容

关于讨论分类表单

您可以通过在您的代码库中使用讨论表单来鼓励社区成员在其讨论中包含具体的、结构化的信息。使用讨论分类表单，您可以创建具有可自定义 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. 将您的文件提交到代码库的默认分支。有关更多信息，请参阅“创建新文件”。