NAME
Dist::Zilla::Plugin::TravisCI::StatusBadge - Get Travis CI status badge for your markdown README
VERSION
version 0.007
SYNOPSIS
; in dist.ini
[TravisCI::StatusBadge]
user = johndoe
repo = p5-John-Doe-Stuff
branch = foo ;; "master" by default
vector = 1 ;; SVG image
; or just
[TravisCI::StatusBadge]
;; shortcut for "png image; master branch; user/repo from meta resources"DESCRIPTION
Injects the Travis CI Build status badge before the VERSION header into any form of README.md file.
Traget readme might be pointed via option "readme" or guessed by module.
Use Dist::Zilla::Plugin::ReadmeAnyFromPod in markdown mode or any other plugin to generate target file
[ReadmeAnyFromPod / ReadmeMdInRoot]
type = markdown
filename = README.md
location = rootOPTIONS
readme
The name of file to inject build status badge. No default value but there is some logic to guess target filename. File can be named as README or Readme and has the one of following extensions: md, mkdn or markdown.
In case of some name passed via this option, it will be used only if the target file exists otherwise will be checked default variations and used first found.
user
Github username. Might be obtained automatically (if not given) from META resources (resources.homepage, resources.repository.web, resources.repository.url).
repo
Github repository name. Might be obtained automatically (if not given) from META resources (resources.homepage, resources.repository.web, resources.repository.url).
branch
Branch name which build status should be shown. Optional. Default value is master.
vector
Use vector representation (SVG) of build status image. Optional. Default value is false which means using of the raster representation (PNG).
SEE ALSO
Dist::Zilla::Plugin::ReadmeAnyFromPod
Dist::Zilla::Plugin::GithubMeta
AUTHOR
Anton Gerasimov <chim@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2013 by Anton Gerasimov.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.