The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
App-sdview-0.18
River stage one • 2 direct dependents • 2 total dependents
/ App::sdview::Parser::Pod

NAME

App::sdview::Parser::Pod - parse Pod files for App::sdview

SYNOPSIS

$ sdview README.pod

$ sdview -f Pod my-document

DESCRIPTION

This parser module adds to App::sdview the ability to parse input text in Pod formatting.

It uses Pod::Simple as its driving parser.

The S<...> formatting code is handled by converting inner spaces to non-breaking spaces (U+00A0) characters in the returned string.

By default, verbatim blocks are scanned for likely patterns that indicate perl code, and emitted with the language> field set to perl if it looks plausible. This can be overridden by embedded =code or =for highlighter directives; see below.

Extensions

Partly as an experiment into how to handle possible future features of the Pod spec, the following extensions are recognised:

  • Inline formatting code U<...> to request underline formatting.

  • =code directive to set the highlighter language name for the next verbatim paragraph.

  • Also follows the =for highlighter ... spec used by https://metacpan.org/pod/Pod::Simple::XHTML::WithHighlightConfig for setting the language name for following verbatim paragraphs.

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>