Dist::Zilla::Plugin::ReadmeFromPod - dzil plugin to generate README from POD
# dist.ini [ReadmeFromPod] # or [ReadmeFromPod] filename = lib/XXX.pod type = markdown readme = READTHIS.md
This plugin generates the README from main_module (or specified) by Pod::Readme.
main_module
The following options are supported:
filename
The name of the file to extract the README from. This defaults to the main module of the distribution.
type
The type of README you want to generate. This defaults to "text".
Other options are "html", "pod", "markdown" and "rtf".
pod_class
This is the Pod::Simple class used to translate a file to the format you want. The default is based on the "type" setting, but if you want to generate an alternative type, you can set this option instead.
readme
The name of the file, which defaults to one based on the "type".
We will remove the README created by Dist::Zilla::Plugin::Readme automatically.
Fayland Lam <fayland@gmail.com> and Ævar Arnfjörð Bjarmason <avar@cpan.org>
Robert Rothenberg <rrwo@cpan.org> modified this plugin to use Pod::Readme.
Copyright 2010-2014 Fayland Lam <fayland@gmail.com> and Ævar Arnfjörð Bjarmason <avar@cpan.org>
This program is free software, you can redistribute it and/or modify it under the same terms as Perl itself.
To install Dist::Zilla::Plugin::ReadmeFromPod, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dist::Zilla::Plugin::ReadmeFromPod
CPAN shell
perl -MCPAN -e shell install Dist::Zilla::Plugin::ReadmeFromPod
For more information on module installation, please visit the detailed CPAN module installation guide.