Skip to main content
我们经常发布文档更新,此页面的翻译可能仍在进行中。 有关最新信息,请访问英语文档

此版本的 GitHub Enterprise 已停止服务 2023-03-15. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

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

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

关于默认社区健康文件

可以将默认社区运行状况文件添加到存储库根目录下或者 docs.github 文件夹中名为 .github 的公共存储库中。

对于在以下任何位置不含该类型自有文件的帐户所拥有的任何仓库,GitHub Enterprise Server 将使用并显示默认文件:

  • 仓库的根目录
  • .github 文件夹
  • docs 文件夹

例如,在不含自有 CONTRIBUTING 文件的仓库中创建议题或拉取请求的人将会看到指向默认 CONTRIBUTING 文件的链接。 如果存储库在其自己的 .github/ISSUE_TEMPLATE 文件夹中含有任何文件,包括议题模板或 config.yml 文件,则不会使用默认 .github/ISSUE_TEMPLATE 文件夹的内容。

默认文件不包含在各个存储库的克隆、包或下载中,因为它们只存储在 .github 存储库中。

支持的文件类型

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

社区运行状况文件 | 说明 --- | ---CONTRIBUTING.md | CONTRIBUTING 文件指示应如何参与你的项目。 有关详细信息,请参阅“设置仓库参与者指南”。问题和拉取请求模板和 config.yml | 问题和拉取请求模板可自定义和标准化你希望参与者在存储库中打开问题或拉取请求时包含的信息。 有关详细信息,请参阅“关于议题和拉取请求模板。”SECURITY.md | SECURITY 文件阐述了如何报告项目中的安全漏洞。 有关详细信息,请参阅“将安全策略添加到存储库。”SUPPORT.md | SUPPORT 文件介绍在项目中获取帮助的途径。 有关详细信息,请参阅“将支持资源添加到项目”。

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

创建用于默认文件的仓库

  1. 在任何页面的右上角,使用 下拉菜单选择“新建存储库”。 包含创建新存储库选项的下拉菜单
  2. 使用“所有者”下拉菜单,选择要为其创建默认文件的组织或个人帐户。 所有者下拉菜单
  3. 输入“.github”作为存储库的名称和描述(可选)。 创建存储库字段
  4. 确保存储库状态设置为“公共”(默认文件的存储库不能是私有的)。 用于选择私有或公共状态的单选按钮 1. 选择“使用 README 初始化此存储库”。 1. 单击“创建存储库”。 创建存储库的按钮
  5. 在仓库中,创建一个受支持的社区健康文件。 议题模板 及其配置文件 必须位于名为 .github/ISSUE_TEMPLATE 的文件夹中。 所有其他支持的文件可能位于存储库根目录、.github 文件夹或 docs 文件夹中。 有关详细信息,请参阅“创建新文件”。