NAME
Mojolicious::Plugin::PODRenderer - POD renderer plugin
SYNOPSIS
# Mojolicious
my $route = $self->plugin('PODRenderer');
my $route = $self->plugin(PODRenderer => {name => 'foo'});
my $route = $self->plugin(PODRenderer => {preprocess => 'epl'});
# Mojolicious::Lite
my $route = plugin 'PODRenderer';
my $route = plugin PODRenderer => {name => 'foo'};
my $route = plugin PODRenderer => {preprocess => 'epl'};
# foo.html.ep
%= pod_to_html "=head1 TEST\n\nC<123>"
DESCRIPTION
Mojolicious::Plugin::PODRenderer is a renderer for true Perl hackers, rawr!
The code of this plugin is a good example for learning to build new plugins, you're welcome to fork it.
OPTIONS
Mojolicious::Plugin::PODRenderer supports the following options.
name
# Mojolicious::Lite
plugin PODRenderer => {name => 'foo'};
Handler name, defaults to pod
.
no_perldoc
# Mojolicious::Lite
plugin PODRenderer => {no_perldoc => 1};
Disable Mojolicious::Guides documentation browser that will otherwise be available under /perldoc
.
preprocess
# Mojolicious::Lite
plugin PODRenderer => {preprocess => 'epl'};
Name of handler used to preprocess POD, defaults to ep
.
HELPERS
Mojolicious::Plugin::PODRenderer implements the following helpers.
pod_to_html
%= pod_to_html '=head2 lalala'
<%= pod_to_html begin %>=head2 lalala<% end %>
Render POD to HTML without preprocessing.
METHODS
Mojolicious::Plugin::PODRenderer inherits all methods from Mojolicious::Plugin and implements the following new ones.
register
my $route = $plugin->register(Mojolicious->new);
my $route = $plugin->register(Mojolicious->new, {name => 'foo'});
Register renderer in Mojolicious application.