Sponsoring The Perl Toolchain Summit 2025: Help make this important event another success Learn more

NAME
Dist::Zilla::Plugin::GitHubREADME::Badge - Dist::Zilla - add badges to
github README.md
SYNOPSIS
# in dist.ini
[GitHubREADME::Badge]
# configure it yourself
[GitHubREADME::Badge]
badges = travis
badges = travis-ci.com
badges = appveyor
badges = coveralls
badges = gitter
badges = cpants
badges = issues
badges = github_tag
badges = license
badges = version
badges = codecov
badges = gitlab_ci
badges = gitlab_cover
badges = docker_automated
badges = docker_build
badges = github_actions/test.yml
badges = cpancover
place = bottom
phase = release
branch = main
DESCRIPTION
Dist::Zilla::Plugin::GitHubREADME::Badge adds badges to GitHub
README.md
CONFIG
badges
Currently only travis, coveralls, codecov, gitter, cpants and GH issues
are supported. However patches are welcome.
The default goes to travis, coveralls and cpants.
[GitHubREADME::Badge]
badges = travis
badges = coveralls
badges = gitter
badges = cpants
branch
[GitHubREADME::Badge]
branch = main
defaults to 'master'. you need set to 'main' for new github repos
place
[GitHubREADME::Badge]
place = bottom
Place the badges at the top or bottom of the README. Defaults to top.
phase
[GitHubREADME::Badge]
phase = release
Which Dist::Zilla phase to add the badges: build, release or filemunge.
For the build and release phases, the README that is on disk will be
modified, whereas for the filemunge it's the internal zilla version of
the README that will be modified.
The default is build.
SEE ALSO
Minilla, Dist::Zilla::Plugin::TravisCI::StatusBadge
AUTHOR
Fayland Lam <fayland@gmail.com>
COPYRIGHT
Copyright 2014- Fayland Lam
LICENSE
This library is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.