Badges
Badges
在 GitLab 10.7 中引入 .
徽章是呈现有关您的项目的简要信息的统一方法. 它们由一个小图像以及该图像指向的 URL 组成. 徽章的示例可以是管道状态 , 测试范围或与项目维护者联系的方式.
Project badges
维护者或所有者可以将徽章添加到项目中,然后在项目的概述页面上可见. 如果发现必须将相同的徽标添加到多个项目,则可能需要在组级别添加它们.
要将新徽章添加到项目:
- 导航到项目的设置>常规>徽章 .
- 在”链接”下,输入徽章应指向的 URL,在”徽章图像 URL”下输入应显示的图像的 URL.
- 通过单击添加徽章按钮来提交徽章 .
将徽章添加到项目后,您可以在表单下方的列表中看到它. 您可以通过单击旁边的笔图标进行编辑,也可以通过单击垃圾箱图标将其删除.
与组关联的徽章只能在组级别上进行编辑或删除.
Group badges
可以将徽章添加到组中,然后将在该组下的每个项目的概述页面上看到它们. 在这种情况下,无法在项目级别上对其进行编辑或删除. 如果每个项目需要单独的徽章,请考虑将其添加到项目级别或使用占位符 .
要将新徽章添加到组:
- 导航到组的“设置”>”常规”>”徽章” .
- 在”链接”下,输入徽章应指向的 URL,在”徽章图像 URL”下输入应显示的图像的 URL.
- 通过单击添加徽章按钮来提交徽章 .
将徽章添加到组后,您可以在表格下方的列表中看到它. 您可以通过单击徽章旁边的笔图标来编辑徽章,也可以通过单击垃圾箱图标来删除徽章.
与项目直接关联的徽章可以在项目级别上配置.
Placeholders
徽章指向的 URL 以及图像 URL 可以包含占位符,在显示徽章时将对其进行评估. 可以使用以下占位符:
%{project_path}
:包含父组的项目的路径%{project_id}
:与项目关联的数据库 ID%{default_branch}
:为项目存储库配置的默认分支名称%{commit_sha}
:对项目存储库的默认分支的最新提交的 ID
Note: Placeholders allow badges to expose otherwise-private information, such as the default branch or commit SHA when the project is configured to have a private repository. This is by design, as badges are intended to be used publicly. Avoid using these placeholders if the information is sensitive.