gitea/docs/content/usage/actions/badge.en-us.md
Giteabot 1987c86f3c
Fix URL In Gitea Actions Badge Docs (#31191) (#31198)
Backport #31191 by @TheBrokenRail

The example URL given in the documentation leads to a 404.

For instance,
`https://your-gitea-instance.com/{owner}/{repo}/actions/workflows/{workflow_file}?branch={branch}&event={event}`
translates to
`https://gitea.thebrokenrail.com/minecraft-pi-reborn/minecraft-pi-reborn/actions/workflows/build.yml`,
which is a 404.

I had to check the [linked GitHub
docs](https://docs.github.com/en/actions/monitoring-and-troubleshooting-workflows/adding-a-workflow-status-badge)
to learn that you have to add `/badge.svg` to the URL.

Example:
https://gitea.thebrokenrail.com/minecraft-pi-reborn/minecraft-pi-reborn/actions/workflows/build.yml/badge.svg

Co-authored-by: TheBrokenRail <17478432+TheBrokenRail@users.noreply.github.com>
2024-05-31 21:08:04 +08:00

1.1 KiB

date title slug sidebar_position toc draft menu
2023-02-25T00:00:00+00:00 Badge badge 11 false false
sidebar
parent name sidebar_position identifier
actions Badge 11 Badge

Badge

Gitea has its builtin Badge system which allows you to display the status of your repository in other places. You can use the following badges:

Workflow Badge

The Gitea Actions workflow badge is a badge that shows the status of the latest workflow run.
It is designed to be compatible with GitHub Actions workflow badge.

You can use the following URL to get the badge:

https://your-gitea-instance.com/{owner}/{repo}/actions/workflows/{workflow_file}/badge.svg?branch={branch}&event={event}
  • {owner}: The owner of the repository.
  • {repo}: The name of the repository.
  • {workflow_file}: The name of the workflow file.
  • {branch}: Optional. The branch of the workflow. Default to your repository's default branch.
  • {event}: Optional. The event of the workflow. Default to none.