Mojolicious::Plugin::PPI - Mojolicious Plugin for Rendering Perl Code Using PPI
# Mojolicious $self->plugin('PPI'); # Mojolicious::Lite plugin 'PPI';
Register plugin in Mojolicious application. A register time, several options may be supplied:
toggle_button => [0/1]specifies whether a "Toggle Line Numbers" button (see below) will be created by default. Default is false.
src_folder => 'directory'specifies a folder where input files will be found. When specified, if the directory is not found, a warning is issued, but not fatally. This functionality is not (currently) available for per-file alteration, so only use if all files will be in this folder (or subfolder). Remeber, if this option is not specified, a full or relative path may be passed to
Mojolicous::Plugin::PPI provides these helpers:
%== ppi 'my $code = "highlighted";' %== ppi 'file.pl'
Returns HTML form of Perl snippet or file. The behavior may be slightly different in each case. If the argument is the name of a file that exists, it will be loaded and used. If not the string will be interpreted as an inline snippet. In either form, the call to
ppi may take the additional option:
line_numbers => [0/1]specifies if line numbers should be generated
In the case of a file, the contents are placed in a
<div> tag, and there are several additional options
id => 'string'specifies the
idto be given to the encompassing
toggle_button => [0/1]specifies if a button should be created to toggle the line numbers. If given
line_numberswill be forced and if not specified an
idwill be generated. The
toggle_buttonmay also be specified at register time to set the default.
Returns a CSS snippet for coloring the PPI::HTML generated HTML. Also provides a background for the code blocks.
Joel Berger, <email@example.com>
Copyright (C) 2011 by Joel Berger
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.