Dist::Zilla::Plugin::GitHub::Meta - Add GitHub repo info to META.{yml,json}
version 0.13
Configure git with your GitHub credentials:
$ git config --global github.user LoginName $ git config --global github.token GitHubToken
then, in your dist.ini:
[GitHub::Meta] repo = SomeRepo
This Dist::Zilla plugin adds some information about the distribution's GitHub repository to the META.{yml,json} files, using the official CPAN::Meta specification.
It currently sets the following fields:
homepage
The official home of this project on the web, taken from the GitHub repository info. If the homepage option is set to '0' this will be skipped.
repository
web
URL pointing to the GitHub page of the project.
url
URL pointing to the GitHub repository (git://...).
git://...
type
This is set to git by default.
git
bugtracker
URL pointing to the GitHub issues page of the project. If the bugs option is set to '0' or the issues are disabled in the GitHub repository, this will be skipped.
bugs
repo
The name of the GitHub repository. By default the dist name (from dist.ini) is used.
If set to '1' (default), the META homepage field will be set to the value of the homepage field set on the GitHub repository's info.
wiki
If set to '1' (default '0'), the META homepage field will be set to the URL of the wiki of the GitHub repository, if happens to be activated (see the GitHub repository's Admin panel).
Admin
If set to '1' (default), the META bugtracker web field will be set to the issue's page of the repository on GitHub, if happens to be activated (see the GitHub repository's Admin panel).
fork
If set to '1' (default), and if the repository is a GitHub fork of another repository, this option will make all the information be taken from the original repository instead of the forked one.
Alessandro Ghedini <alexbio@cpan.org>
Copyright 2011 Alessandro Ghedini.
This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.
To install Dist::Zilla::Plugin::GitHub, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dist::Zilla::Plugin::GitHub
CPAN shell
perl -MCPAN -e shell install Dist::Zilla::Plugin::GitHub
For more information on module installation, please visit the detailed CPAN module installation guide.