创建默认的社区运行状况文件

您可以创建默认社区健康文件，例如 CONTRIBUTING 和 CODE_OF_CONDUCT。 默认文件将用于不包含该类型自有文件的帐户所拥有的任何仓库。

本文内容

关于默认社区健康文件

默认社区运行状况文件是一组预定义文件，提供维护协作型开放源代码项目正常运行所需的指导和模板。 这些文件有助于你实现项目开发及社区互动各个方面的自动化和标准化，促进透明度、最佳做法及协作。

可以将默认社区运行状况文件添加到名为 .github 的公共 或 内部 存储库，GitHub 将按以下顺序使用和显示帐户拥有的任何存储库的默认文件，这些存储库没有自己的该类型文件：

  • .github 文件夹
  • 存储库的根文件夹
  • docs 文件夹

如果在当前存储库中找不到相应的文件，GitHub 将按照相同的优先级顺序使用 .github 存储库中的默认文件。

          **注意：** 存储库 `.github` 必须是 **public** 才能应用整个组织的模板。 不支持专用 `.github` 存储库。

例如，在不含自有 CONTRIBUTING.md 文件的存储库中创建问题或拉取请求的人将会看到 .github 存储库中默认 CONTRIBUTING.md 的链接。 然而，如果存储库在其自己的 .github/ISSUE_TEMPLATE 文件夹中有任何文件（如问题模板或 _config.yml 文件），则不会使用默认 .github/ISSUE_TEMPLATE 文件夹的任何内容。 这允许存储库维护人员在每个存储库的基础上用特定的模板或内容覆盖默认文件。

将文件存储在 .github 存储库中允许只在一个位置更改默认值。 此外，它们不会出现在单个存储库的文件浏览器或 Git 历史记录中，也不会包含在其克隆、包或下载中。

支持的文件类型

可以在组织或个人帐户中为以下社区运行状况文件创建默认内容：

社区健康文件说明
CONTRIBUTING.mdCONTRIBUTING 文件说明了人们应该如何参与项目。 有关详细信息，请参阅“设置仓库参与者指南”。
讨论类别表单讨论类别表单可自定义模板，供社区成员在存储库中打开新讨论时使用。 有关详细信息，请参阅“创建讨论类别表单”。
GOVERNANCE.mdGOVERNANCE 文件让人们了解项目是如何治理的。 例如，其中可能会讨论项目角色以及如何做出决策。
问题和拉取请求模板，以及 config.yml__问题和拉取请求模板可自定义和标准化你希望参与者在存储库中打开问题和拉取请求时添加的信息。 有关详细信息，请参阅“关于议题和拉取请求模板”。

如果问题模板设置了标签，则必须在 .github 存储库和将使用该模板的任何存储库中创建该标签。
SECURITY.md安全性文件提供了如何报告项目中的安全漏洞的说明，以及对该文件进行超链接的描述。 有关详细信息，请参阅“将安全策略添加到存储库”。
SUPPORT.mdSUPPORT 文件可让人们了解获得项目帮助的途径。 有关详细信息，请参阅“将支持资源添加到项目”。

您不能创建默认许可文件。 必须将许可文件添加到各个仓库中，以便在克隆、打包或下载项目时包含该文件。

创建用于默认文件的仓库

  1. 在任何页面的右上角，选择 ，然后单击“新建存储库”。

    GitHub 下拉菜单的屏幕截图，其中显示了用于创建新项的选项。 菜单项“新建存储库”用深橙色框标出。

  2. 使用“所有者”下拉菜单，选择要为其创建默认文件的组织或个人帐户。****

    新 GitHub 存储库的所有者菜单的屏幕截图。 菜单显示两个选项：“octocat”和“github”。

  3. 在“存储库名称”字段中，键入 .github。

  4. （可选）在“描述”字段中键入描述。

  5. 确保存储库状态设置为 Public。 默认文件的存储库不能是专用的。

  6. 将 README 切换为 开启。

  7. 单击“创建存储库”。

  8. 在仓库中，创建一个受支持的社区健康文件。 议题模板及其配置文件必须位于名为 .github/ISSUE_TEMPLATE 的文件夹中。 所有其他支持的文件可能位于存储库根目录、.github 文件夹或 docs 文件夹中。 有关详细信息，请参阅“创建新文件”。