关于仓库
您可以个人拥有仓库,也可以与组织中的其他人共享仓库的所有权。
您可以通过选择仓库的可见性来限制谁可以访问仓库。 有关详细信息,请参阅“关于存储库可见性”。
对于用户拥有的仓库,您可以向其他人授予协作者访问权限,以便他们可以协作处理您的项目。 如果仓库归组织所有,您可以向组织成员授予访问权限,以便协作处理您的仓库。 有关详细信息,请参阅“个人帐户存储库的权限级别”和“组织的存储库角色”。
每个人和组织都可拥有无限制的存储库,并且可邀请无限制的协作者参与所有存储库。
您可以使用仓库管理您的工作并与他人合作。
- 您可以使用议题来收集用户反馈,报告软件缺陷,并组织您想要完成的任务。 有关详细信息,请参阅“关于议题”。
- 您可以使用拉取请求来建议对仓库的更改。 有关详细信息,请参阅“关于拉取请求”。
- 您可以使用项目板来组织议题和拉取请求并排定优先级。 有关详细信息,请参阅“关于 project boards”。
若要了解如何最有效地使用存储库,请参阅“存储库最佳做法”。
关于仓库可见性
可以通过选择存储库的可见性来限制谁有权访问存储库:公共、内部或专用。
创建存储库时,可以选择将存储库设为公开或私有。 如果要在 组织中创建存储库,则还可以选择将存储库设为内部存储库。
- 如果 你的 GitHub Enterprise Server 实例 未处于专用模式或位于防火墙后面,那么 Internet 上的每个人都有权访问公共存储库。 否则,公共存储库可供所有使用 你的 GitHub Enterprise Server 实例的人(包括外部协作者)使用。
- 私有仓库仅可供您、您明确与其共享访问权限的人访问,而对于组织仓库,只有某些组织成员可以访问。
- 所有企业成员均可访问内部仓库。 有关详细信息,请参阅“关于内部存储库”。
组织所有者始终有权访问其组织中创建的每个仓库。 有关详细信息,请参阅“组织的存储库角色”。
拥有仓库管理员权限的人可更改现有仓库的可见性。 有关详细信息,请参阅“设置存储库可见性”。
关于内部仓库
你可以使用内部存储库在企业内实践“内部开源”。 企业的成员可使用开源方法进行协作,而无需公开共享专有信息,即使禁用了私有模式。 有关 InnerSource 的详细信息,请参阅 GitHub 的白皮书“InnerSource 简介”。
所有企业成员对内部仓库具有读取权限,但内部仓库对非组织成员的人员不可见,包括组织仓库的外部协作者。 有关详细信息,请参阅“企业中的角色”和“组织的存储库角色”。
注意:用户必须是组织的一部分才能成为企业成员并有权访问内部存储库。 如果 你的 GitHub Enterprise Server 实例上的用户不是任何组织的成员,该用户将无权访问内部存储库。
成员可以复刻企业中组织拥有的任何内部存储库。 分支存储库将属于成员的个人帐户,分支将为私人可见。 如果用户从企业拥有的所有组织中删除,该用户的内部仓库复刻也会自动删除。
限制查看仓库中的内容和差异
有些类型的资源可能很大,需要在 GitHub Enterprise Server 上额外处理。 因此,可设置限制,以确保申请在合理的时间内完成。
以下限制大多会影响 GitHub Enterprise Server 和 API。
文本限制
GitHub 显示某些文件的格式化预览,例如 Markdown 和 Mermaid 关系图。 如果文件较小(通常小于 2 MB),则 GitHub 始终会尝试呈现这些预览,但更复杂的文件可能会超时,之后会回退到纯文本,或根本不显示。 这些文件始终以原始格式提供,通过 HOSTNAME/user/repo/raw
提供服务,例如 https://HOSTNAME/user/repo/raw/octocat/Spoon-Knife/master/index.html
。 单击“原始”按钮可获取文件的原始 URL。
差异限制
因为差异可能很大,所以我们会对评论、拉取请求和比较视图的差异施加限制:
- 在拉取请求中,总差异不得超过可加载的 20,000 行或 1 MB 的原始差异数据 。
- 任何单个文件的差异都不得超过可加载的 20,000 行或 500 KB 的原始差异数据 。 为单个文件自动加载 400 行和 20 KB 。
- 单一差异中的最大文件数限于 300。
- 单一差异中可呈现的文件(如图像、PDF 和 GeoJSON 文件)最大数量限于 25。
受限差异的某些部分可能会显示,但超过限制的任何部分都不会显示。
提交列表限制
比较视图和拉取请求页显示 base
和 head
修订之间的提交列表。 这些列表限制为 250 个提交。 如果超过该限制,将会出现一条表示附加评论的注释(但不显示)。
延伸阅读
- “关于分叉”
- “协作处理拉取请求”
- “GitHub 问题文档”
- “管理存储库的设置和功能”
- “查看存储库的活动和数据”
- “关于 wikis”
- “GitHub 词汇表”