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.

• Tables are partially supported according to the suggestion given in https://www.nntp.perl.org/group/perl.perl5.porters/2021/11/msg261904.html, within a section marked =begin table or =begin table md.

• Tables are also partially supported by a format similar to mediawiki notation, within a section marked =begin table mediawiki.

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>