徽章

徽章是呈现有关您的项目的简要信息的统一方法，它们由一个小图像以及该图像指向的 URL 组成。徽章的示例可以是 pipeline 状态、测试范围或项目维护者联系的方式等。

项目徽章

维护者或所有者可以将徽章添加到项目中，然后在项目的首页可见。如果发现必须将相同的徽标添加到多个项目，则可能需要在组级别添加它们。

可以通过以下步骤将新徽章添加到项目：

1. 进入项目的项目设置>通用设置>徽章
2. 输入徽章的名称，在"链接"下，输入徽章应指向的 URL，在"徽章图像 URL"下输入应显示的图像的 URL
3. 点击添加徽章按钮来提交徽章

将徽章添加到项目后，您可以在表单下方的列表中看到它，您可以通过单击旁边的图标进行编辑，也可以通过单击删除图标将其删除。

与组关联的徽章只能在组级别上进行编辑或删除。

组织徽章

可以将徽章添加到组织中，然后将在该组下的每个项目的页面上看到它们。在这种情况下，无法在项目级别上对其进行编辑或删除，如果每个项目需要单独的徽章，请考虑将其添加到项目级别或使用占位符 。

可以通过以下步骤将新徽章添加到组织：

1. 进入组织的组织设置>常规设置>徽章
2. 输入徽章的名称，在"链接"下，输入徽章应指向的 URL，在"徽章图像 URL"下输入应显示的图像的 URL
3. 点击添加徽章按钮来提交徽章

将徽章添加到组后，您可以在表格下方的列表中看到它。您可以通过单击徽章旁边的图标来编辑徽章，也可以通过单击删除图标来删除徽章。

与项目直接关联的徽章可以在项目级别上配置。

占位符

徽章指向的 URL 以及图像 URL 可以包含占位符，在显示徽章时将根据设置占位符来变化。可以使用的占位符包括：

• %{project_path} ：包含父组织的项目的路径
• %{project_id} ：数据库中与项目关联的 ID
• %{default_branch} ：为项目代码仓库配置的默认分支名称
• %{commit_sha} ：项目代码仓库中默认分支的最新提交 ID

注意: 占位符允许徽章公开其他隐私信息，例如私有项目仓库中的默认分支名称或提交 SHA。这样设计师因为徽章是用来公开使用的，对于敏感的信息，请尽量避免使用这些占位符。