The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

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.