NAME

   Dist::Zilla::Plugin::TravisCI::StatusBadge - Get Travis CI status badge
   for your markdown README

VERSION

   version 0.009

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|pod] 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 = root

OPTIONS

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,
   markdown or pod.

   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.

format

   Either pod or markdown. Optional. When unspecified, format is pod if
   readme has a .pod file extension and markdown otherwise.

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

   Please see those modules/websites for more information related to this
   module.

     * https://travis-ci.org

     * Dist::Zilla::Plugin::ReadmeAnyFromPod

     * Dist::Zilla::Plugin::GithubMeta

     * Dist::Zilla::Role::AfterBuild

     * Dist::Zilla

BUGS

   Please report any bugs or feature requests on the bugtracker website
   https://github.com/Wu-Wu/Dist-Zilla-Plugin-TravisCI-StatusBadge/issues

   When submitting a bug or request, please include a test-file or a patch
   to an existing test-file that illustrates the bug or desired feature.

AUTHOR

   Anton Gerasimov <[email protected]>

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.