Badge::Depot - A framework for badges
Version 0.0104, released 2016-02-19.
# Define a badge class package Badge::Depot::Plugin::Example; use Moose; with 'Badge::Depot'; has user => ( is => 'ro', isa => 'Str', required => 1, ); sub BUILD { my $self = shift; $self->link_url(sprintf 'https://example.com/users/%s', $self->user); $self->image_url(sprintf 'https://example.com/users/%s.svg', $self->user); $self->image_alt('Example text'); } # Somewhere else my $badge = Badge::Depot::Plugin::Example->new(user => 'my_username'); print $badge->to_html; # prints '<a href="https://example.com/users/my_username"><img src="https://example.com/users/my_username.svg" alt="Example text" /></a>'
Badge::Depot is a framework for documentation badges. Using badges in your documentation can give end users of your distribution dynamic information without you having to update the documentation.
Badge::Depot
You only need use this distribution directly if you want to create a new badge in the Badge::Depot::Plugin namespace. See Task::Badge::Depot for a list of existing badges.
Badge::Depot::Plugin
For use together with Pod::Weaver, see Pod::Weaver::Section::Badges.
Badge::Depot is a Moose role that adds a few attributes and methods.
These attributes are expected to be set when the badge class returns from new. See synopsis.
new
Required. Uri.
The url to the actual badge. The src attribute for the img tag when rendered to html.
Optional. Str.
The alternative text of the badge. The alt attribute for the img tag when rendered to html. No alternative text is created if this isn't set.
Optional (but recommended). Uri.
The url to link the badge to. The href attribute for the a tag when rendered to html. No link is created if this isn't set.
This is not a user setable attribute, but rather can be used by plugins that might need to look at distribution meta data. This is only usable when using Pod::Weaver::Section::Badges together with Dist::Zilla.
These methods are used when rendering the badge, and are not useful inside badge classes.
Returns a string with the badge rendered as html.
Returns a string with the badge rendered as markdown.
Task::Badge::Depot - List of available badges
Pod::Weaver::Section::Badges - Weave the badges
WWW::StatusBadge - An alternative badge framework
https://github.com/Csson/p5-Badge-Depot
https://metacpan.org/release/Badge-Depot
Erik Carlsson <info@code301.com>
This software is copyright (c) 2016 by Erik Carlsson.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Badge::Depot, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Badge::Depot
CPAN shell
perl -MCPAN -e shell install Badge::Depot
For more information on module installation, please visit the detailed CPAN module installation guide.