Apache2-PodBrowser

 view release on metacpan or  search on metacpan

README  view on Meta::CPAN

    available you'll probably get a "404 - NOT FOUND" response the next time
    the POD index page is requested if "CACHE" is set.

    The directory containing the cache file must be writable by the "httpd".

   CONTENTTYPE
    You'll probably need that only for plain text output with the
    Pod::Simple::Text parser. Here one can set the content type of the
    output.

      PerlSetVar CONTENTTYPE "text/plain; charset=UTF-8"

   PARSER and LINKBASE
    "PARSER" sets the POD-to-HTML converter class that is used. It should
    support at least the interface that Pod::Simple::Text provides.

    The Pod::Simple::Text parser gives you plain text.

    If Pod::Simple::HTML is used as parser one gets almost usable output
    except for the missing "DOCTYPE" HTML header and the broken linkage to
    other modules.

lib/Apache2/PodBrowser.pm  view on Meta::CPAN

    my ($title, $uplink)=
        ($kind==INDEX_PODINDEX ? ('POD Index', _indexlink($kind))
         :$kind==INDEX_PODCACHED ? ('POD Index', _indexlink($kind))
         :$kind==INDEX_FUNCINDEX ? ('Function and Variable Index',
                                    _indexlink($kind))
         :());

    <<"EOF";
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html><head><title>$title</title>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" >
<link rel="stylesheet" type="text/css" title="pod_stylesheet" href="$style">

</head>
<body class='podindex'>
$uplink<h1>$title</h1>
EOF
}

sub _footer {"</body></html>\n"}

lib/Apache2/PodBrowser.pm  view on Meta::CPAN

page is requested if C<CACHE> is set.

The directory containing the cache file must be writable by the C<httpd>.

=head3 CONTENTTYPE

You'll probably need that only for plain text output with the
L<Pod::Simple::Text> parser. Here one can set the content type
of the output.

  PerlSetVar CONTENTTYPE "text/plain; charset=UTF-8"

=head3 PARSER and LINKBASE

C<PARSER> sets the POD-to-HTML converter class that is used. It should
support at least the interface that L<Pod::Simple::Text> provides.

The L<Pod::Simple::Text> parser gives you plain text.

If L<Pod::Simple::HTML> is used as parser one gets almost usable output
except for the missing C<DOCTYPE> HTML header and the broken linkage

t/conf/extra.conf.in  view on Meta::CPAN

    PerlAddVar PODDIR @DocumentRoot@
    PerlAddVar PODDIR @top_dir@/blib/lib
</Location>

<Location /simpletext>
    SetHandler modperl
    PerlResponseHandler Apache2::PodBrowser
    PerlSetVar PARSER Pod::Simple::Text
    PerlAddVar PODDIR @DocumentRoot@
    PerlSetVar INDEX 1
    PerlSetVar CONTENTTYPE "text/plain; charset=UTF-8"
</Location>

<Location /simplehtml>
    SetHandler modperl
    PerlResponseHandler Apache2::PodBrowser
    PerlSetVar PARSER Pod::Simple::HTML
    PerlAddVar PODDIR @DocumentRoot@
    PerlSetVar INDEX 1
    PerlSetVar CONTENTTYPE "text/html; charset=UTF-8"
</Location>



( run in 0.247 second using v1.01-cache-2.11-cpan-4d50c553e7e )