NAME

Pod::Elemental::Transformer::PPIHTML - convert "=begin perl" and shebang-marked blocks to XHTML

VERSION

version 0.093580

DESCRIPTION

This transformer, based on Pod::Elemental::Transformer::SynHi, looks for regions like this:

=begin perl

  my $x = 1_00_000 ** $::xyzzy;

=end perl

...into syntax-highlighted HTML that I can't really usefully represent here. It uses PPI::HTML, so you can read more about the kind of HTML it will produce, there.

This form is also accepted, in a verbatim paragraph:

#!perl
my $x = 1_00_000 ** $::xyzzy;

In the above example, the shebang-like line will be stripped.

The format_name attribute may be supplied during the construction of the transformer to look for a region other than perl.

AUTHOR

Ricardo SIGNES <rjbs@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2009 by Ricardo SIGNES.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.