#!/usr/bin/perl -w
use strict;
use Pod::Simple::HTML;
use File::Find::Rule;
use File::Spec;
use File::Basename;
use File::Path;
=head1 NAME
local-doc.pl - create local documentation
=cut
my ($docdir,$bindir) = @ARGV;
my $rel_docroot = '.';
{
no warnings 'redefine';
sub Pod::Simple::HTML::resolve_pod_page_link {
my ($self,$link) = @_;
my $to = $link;
$to =~ s!::!-!g;
$to .= '.html';
# warn "$rel_docroot/$to";
return "$rel_docroot/$to";
};
};
my @files = File::Find::Rule->file()->name(qr(^.*\.(pm|pl|pod)$))->in(
+$bindir);
for my $file (@files) {
my $input = $file;
my @outfile = File::Spec->splitdir( File::Spec->abs2rel( $file, $bin
+dir ));
my $outfile = File::Spec->catfile( $docdir, join "-", @outfile );
$outfile =~ s/\.[^.]+$/.html/;
# print "Generating $outfile";
my $stylesheet = "style.css";
my $parser = Pod::Simple::HTML->new();
my $html;
$parser->output_string($html);
$parser->parse_file($file);
$html =~ s!</title>\s*</head>!</title><link rel="stylesheet" href="$
+stylesheet" /></head>!sm;
open OUTPUT, ">", $outfile
or die "Couldn't create '$outfile': $!";
print OUTPUT $html;
close OUTPUT;
# print ", done.\n";
};
=head1 AUTHOR
Max Maischein (corion@cpan.org)
=cut
-
Are you posting in the right place? Check out Where do I post X? to know for sure.
-
Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
<code> <a> <b> <big>
<blockquote> <br /> <dd>
<dl> <dt> <em> <font>
<h1> <h2> <h3> <h4>
<h5> <h6> <hr /> <i>
<li> <nbsp> <ol> <p>
<small> <strike> <strong>
<sub> <sup> <table>
<td> <th> <tr> <tt>
<u> <ul>
-
Snippets of code should be wrapped in
<code> tags not
<pre> tags. In fact, <pre>
tags should generally be avoided. If they must
be used, extreme care should be
taken to ensure that their contents do not
have long lines (<70 chars), in order to prevent
horizontal scrolling (and possible janitor
intervention).
-
Want more info? How to link
or How to display code and escape characters
are good places to start.
|