{"meta":{"title":"添加工作流状态徽章","intro":"您可以在您的仓库中显示状态徽章，以指示您的工作流程状态。","product":"GitHub Actions","breadcrumbs":[{"href":"/zh/actions","title":"GitHub Actions"},{"href":"/zh/actions/how-tos","title":"操作方法"},{"href":"/zh/actions/how-tos/monitor-workflows","title":"监视工作流"},{"href":"/zh/actions/how-tos/monitor-workflows/add-a-status-badge","title":"添加状态徽章"}],"documentType":"article"},"body":"# 添加工作流状态徽章\n\n您可以在您的仓库中显示状态徽章，以指示您的工作流程状态。\n\n> \\[!NOTE]\n> 无法从外部访问专用存储库中的工作流徽章，因此无法嵌入它们或者从外部站点链接到它们。\n\n状态徽章显示工作流程目前失败还是通过。 添加状态徽章的常见位置是存储库的 `README.md` 文件，但也可将其添加到你喜欢的任何网页。 默认情况下，徽章显示默认分支的状态。 如果默认分支上没有工作流运行，它将显示所有分支中最近运行的状态。 也可以在 URL 中使用 `branch` 和 `event` 查询参数显示特定分支或事件的工作流运行的状态。\n\n\n\n若要向 `README.md` 文件添加工作流状态徽章，请首先找到要显示的状态徽章的 URL。 然后，可以使用 Markdown 将徽章显示为 `README.md` 文件中的图像。 有关 Markdown 中图像标记的详细信息，请参阅“[基本写作和格式语法](/zh/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#images)”。\n\n## 使用该 UI\n\n可以直接在 UI 上使用工作流文件名、分支参数和事件参数创建工作流状态徽章。\n\n1. 在 GitHub 上，导航到存储库的主页面。1. 在仓库名称下，单击“ Actions”\\*\\*\\*\\*。\n\n 1. 在左侧边栏中，单击您想要查看的工作流程。\n\n \n2. 在页面右侧的“筛选工作流运行”字段旁边，单击 显示下拉菜单，然后单击“创建状态徽章”\\*\\*\\*\\*。\n3. （可选）如果要显示某个与默认分支不同的分支的状态徽章，请选择该分支。\n4. （可选）选择将触发工作流的事件。\n5. 单击 ** 复制状态徽章 Markdown**。\n6. 将 Markdown 复制到 `README.md` 文件中。\n\n## 使用工作流程文件名\n\n可以使用工作流文件的名称生成工作流状态徽章的 URL：\n\n```text\nhttps://github.com/OWNER/REPOSITORY/actions/workflows/WORKFLOW-FILE/badge.svg\n```\n\n若要在 `README.md` 文件中显示工作流状态徽章，请使用 Markdown 标记来嵌入图像。 有关 Markdown 中图像标记的详细信息，请参阅“[基本写作和格式语法](/zh/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#images)”。\n\n例如，将以下 Markdown 添加到 `README.md` 文件，可为文件路径为 `.github/workflows/main.yml` 的工作流添加状态徽章。 存储库的 `OWNER` 是 `github` 组织，`REPOSITORY` 名称为 `docs`。\n\n```markdown\n\n```\n\n## 使用 `branch` 参数\n\n若要显示特定分支的工作流运行状态，请将 `?branch=BRANCH-NAME` 添加到状态徽章 URL 的末尾。\n\n例如，将以下 Markdown 添加到 `README.md` 文件，可为名称为 `feature-1` 的分支显示状态徽章。\n\n```markdown\n\n```\n\n## 使用 `event` 参数\n\n若要显示 `push` 事件触发的工作流运行状态，请将 `?event=push` 添加到状态徽章 URL 的末尾。\n\n例如，将以下 Markdown 添加到 `README.md` 文件，以显示由 `push` 事件触发的工作流运行状态的徽章，该徽章将展示该分支当前状态的构建状态。\n\n```markdown\n\n```"}