Badges · Gitlab 中文文檔

# Badges > 原文：[https://docs.gitlab.com/ee/user/project/badges.html](https://docs.gitlab.com/ee/user/project/badges.html) * [Project badges](#project-badges) * [Group badges](#group-badges) * [Placeholders](#placeholders) * [API](#api) # Badges[](#badges "Permalink") 在 GitLab 10.7 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/41174) . 徽章是呈現有關您的項目的簡要信息的統一方法. 它們由一個小圖像以及該圖像指向的 URL 組成. 徽章的示例可以是[管道狀態](../../ci/pipelines/settings.html#pipeline-status-badge) ， [測試范圍](../../ci/pipelines/settings.html#test-coverage-report-badge)或與項目維護者聯系的方式. [![Badges on Project overview page](https://img.kancloud.cn/f0/1c/f01c8e4a394d1a80dc85827332c12315_892x249.png)](img/project_overview_badges.png) ## Project badges[](#project-badges "Permalink") 維護者或所有者可以將徽章添加到項目中，然后在項目的概述頁面上可見. 如果發現必須將相同的徽標添加到多個項目，則可能需要在[組級別](#group-badges)添加它們. 要將新徽章添加到項目： 1. 導航到項目的**設置>常規>徽章** . 2. 在"鏈接"下，輸入徽章應指向的 URL，在"徽章圖像 URL"下輸入應顯示的圖像的 URL. 3. 通過單擊**添加徽章**按鈕來提交**徽章** . 將徽章添加到項目后，您可以在表單下方的列表中看到它. 您可以通過單擊旁邊的筆圖標進行編輯，也可以通過單擊垃圾箱圖標將其刪除. 與組關聯的徽章只能在[組級別](#group-badges)上進行編輯或刪除. ## Group badges[](#group-badges "Permalink") 可以將徽章添加到組中，然后將在該組下的每個項目的概述頁面上看到它們. 在這種情況下，無法在項目級別上對其進行編輯或刪除. 如果每個項目需要單獨的徽章，請考慮將其添加到[項目級別](#project-badges)或使用[占位符](#placeholders) . 要將新徽章添加到組： 1. 導航到組的**"設置">"常規">"徽章"** . 2. 在"鏈接"下，輸入徽章應指向的 URL，在"徽章圖像 URL"下輸入應顯示的圖像的 URL. 3. 通過單擊**添加徽章**按鈕來提交**徽章** . 將徽章添加到組后，您可以在表格下方的列表中看到它. 您可以通過單擊徽章旁邊的筆圖標來編輯徽章，也可以通過單擊垃圾箱圖標來刪除徽章. 與項目直接關聯的徽章可以在[項目級別](#project-badges)上配置. ## Placeholders[](#placeholders "Permalink") 徽章指向的 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. ## API[](#api "Permalink") 您還可以通過 GitLab API 配置徽章. 與設置一樣，在[項目級別](../../api/project_badges.html)和[組級別的](../../api/group_badges.html)徽章端點之間也有所區別.