為你的 GitHub 倉庫新增狀態徽章

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022

在 GitHub 的倉庫 README.md 檔案中加入 Markdown 語法,以徽章顯示你的看板狀態。 從你的主板設定複製語法,貼到 README 裡。

此語法適用於 GitHub.com 與 GitHub Enterprise Server 連線。 對於 GitHub Enterprise Server,你的伺服器必須能透過網路連線到 Azure DevOps Services。

Prerequisites

Category Requirements
許可 董事會團隊管理員,或專案管理員小組成員。
GitHub 整合 專案連結到你想顯示徽章的 GitHub 倉庫 。
董事會 球隊現有的董事會。 每隊自動獲得一塊棋盤。 如需詳細資訊,請參閱 關於小組和敏捷式工具。
儲存庫存取 貢獻者可存取 GitHub 倉庫,並在此添加徽章。

新增狀態徽章

  1. 登入 Azure Boards 並 開啟你的公告板。

  2. 選擇 齒輪圖示以開啟板子設定。

    開啟面板設定的螢幕快照。

  3. 選擇 狀態徽章,然後選擇或清除 「允許匿名使用者存取狀態徽章」。 當此選項清除後,未登入的用戶仍可查看徽章。

    面板設定對話框的螢幕快照,[狀態徽章] 索引標籤。

  4. 選擇徽章類型,然後選擇 複製來複製 Markdown 語法。

    • 僅顯示「進行中」欄位 ——排除第一欄和最後一欄。

    • 包含所有欄位 — 顯示所有欄位,包括第一欄和最後一欄。

    • 自訂欄位 — 設定 columnOptions=2 並新增逗號分隔的欄位清單。 將空間編碼為 %20 (例如, In%20Progress)。

      範例語法:

     [![Board Status](https://dev.azure.com/fabrikam/677da0fb-b067-4f77-b89b-f32c12bb8617/cdf5e823-1179-4503-9fb1-a45e2c1bc6d4/_apis/work/boardbadge/6fa7b56f-d27c-4e96-957d-f9e7b0f56705?columnOptions=2&columns=Proposed,Committed,In%20Progress,In%20Review)](https://dev.azure.com/fabrikam/677da0fb-b067-4f77-b89b-f32c12bb8617/_boards/board/t/cdf5e823-1179-4503-9fb1-a45e2c1bc6d4/Microsoft.RequirementCategory/)
    

    渲染出來的徽章看起來與以下圖片相似。

    顯示已呈現徽章的螢幕快照。

  5. 選取 [儲存]。

    「 允許匿名使用者存取狀態徽章 」是唯一可設定的選項。 徽章類型的選擇只會改變可複製的 Markdown 語法。

  6. 在你的 GitHub 倉庫打開檔案 README.md ,貼上複製的語法。

    徽章的數值會對應你的棋盤。