Skip to main content

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

关于自述文件

您可以将自述文件添� 到仓库,告知其他人您的项目为什么有用,他们可以对您的项目做什么,以及他们可以如何使用。

关于自述文件

您可以将 README 文件添� 到仓库来交流有关您项目的重要信息。 自述文件以及存储库许可证 和贡献指南 � 达了对项目的期望,并帮助您管理贡献。

有关为项目提供指南的更多信息,请参阅 “设置健康参与的项目”。

自述文件通常是访问者在访问仓库时看到的第一个项目。 自述文件通常包含以下信息:

  • 项目做什么
  • 项目为什么有用
  • 用户如何使用项目
  • 用户能从何处获取项目的帮助
  • 谁维护和参与项目

如果将自述文件放在仓库隐藏的 .github 目录、� �目录或 docs 目录中,GitHub Enterprise Server 将会识别您的自述文件并自动向仓库访问者显示。

如果仓库包含多个自述文件,则按以下顺序从位置中选择显示的文件:.github 目录,然后是仓库的� �目录,最后是 docs 目录。

Github/scientist 仓库的主页面及其自述文件

如果将 README 文件添� 到与用户名同名的公共仓库的� �目录,则该 README 将自动显示在您的个人资料页面上。 您可以使用 GitHub Flavored Markdown 编辑您的个人资料以在您的个人资料 README,以在您的个人资料上创建个性化的区域。 更多信息请参阅“管理个人资料自述文件”。

用户名/用户名仓库上的自述文件

您可以直接链接到渲染文件中的某个部分,方法是将� � �悬停在该部分� �题上以显示链接:

github/scientiorist 仓库的自述文件中的部分链接

您可以在渲染的文件中定义相对链接和图像路径,以帮助读者导航到仓库中的其他文件。

相对链接是相对于当前文件的链接。 例如,如果在仓库� �目录下有一个自述文件,而在 docs/CONTRIBUTING.md 中有另一个文件,则自述文件中的 CONTRIBUTING.md 的相关链接如下所示:

[此项目的参与指南](docs/CONTRIBUTING.md)

GitHub Enterprise Server 将� �据您当前使用的分支自动转换相对链接或图像路径,从而使链接或路径始终有效。 链接的路径将相对于当前文件。 以 / 开头的链接将相对于存储库� �目录。 您可以使用所有相对链接操作符,如 ./../

相对链接更便于用户克隆仓库。 绝对链接可能� 法用于仓库的克隆 - 建议使用相对链接引用仓库中的其他文件。

Wikis

自述文件应仅包含开发人员开始使用和参与项目的必要信息。 较长的文档最适合维基。 更多信息请参阅“关于 wiki”。

延伸阅读