/ 
Pod-HtmlPsPdf-0.02
/ Extended

NAME

Extended Pod::Html

DESCRIPTION

Extended POD format used in this build package:

I've taken the original Pod::Html made some fixes and extended its semantics. This package uses Guide::Pod2Html and Guide::Pod2HtmlPS for creating HTML and PS versions respectively. The two are almost identical but the generated html is different a little bit in Guide::Pod2HtmlPS as it's written to become a PS at the final point.

Pod::Html fixes

  • links handling

    Now

    http://foo/bar.html.

    will be rendered as

    <a href="http://foo/bar.html">http://foo/bar.html</a>.

    and not broken:

    <a href="http://foo/bar.html.">http://foo/bar.html.</a>

    as before (notice the dot).

    The same goes for comma and other semantics

  • HTTP::Foo problem

    In the original Pod::Html a text such as

    this is HTTP::Foo module

    becomes

    this is <a href="HTTP::Foo">HTTP::Foo</a> module

    this was fixed to correctly detect http:// constructs

  • linking

    Some pod structures didn't go thru the linking code so

    http://

    and alike links weren't highlighted. It's fixed now

POD extension

I needed additional functionality from the POD and I didn't want to break the nice to read pod format with HTML, so I've extended the POD semantics as follows

  • valid =head tags numbering

    Allow as many levels as wanted than just =head{1|2}

  • code examples

    New pod tag:

    =example 1.1 This is a title

    becomes:

    <p><i>Example 1.1: This is a title</i></p>

  • figures (images)

    New pod tag:

     =figure 1.1 This is a title

becomes

<p><center><img src="fig1.1.gif"></center></p>
<p><center><b>Figure 1.1: This is a title</b></center></p>

  • linking to code snippets instead of inlining

    New pod tag:

    =code filename This is a comment

    becomes

    <p><a href="code/filename"><code>filename</code></a>This is a comment</p>

AUTHOR

Stas Bekman <stas@stason.org>