After posting the script above I realized that pod2html could not set the cross referencing between the html files correctly. Depending on the number of subdirectories it needs additionally "../../.." in href for relative referencing. Just one look to the possible parameters of pod2html showed that it needed the parameter "--htmldir=name". So this is the final version with creating a TOC-file and correct referencing: 
use strict;
use Pod::Html;
use Pod::Find qw(pod_find);
use File::Path;

my $podroot = "C:/MySw/Strawberry5.28x64/perl";
my $htmldir = "C:/MySw/Strawberry5.28x64/html";
my $indexhtml = "$htmldir/my_alternative_index.html";
my $logfile = "C:/MySw/Strawberry5.28x64/allpod.txt";

if(!-e $htmldir) { mkdir($htmldir) || die "Cannot mkdir $htmldir !!\n"
+; }

my %pods = pod_find({ -verbose => 0, -inc => 1 });
my (@sorted);
foreach my $podfile (keys %pods) {
    $podfile =~ s#\\#/#g;
    my ($path,$name) = ($podfile =~ m!^$podroot(/.+)?/([^\/]+)\.(pod|p
+m|pl)$!i);
    my (@depth) = ($path =~ /(\/)/go);
    my $depth = scalar @depth;
    my $sorted = sprintf("%010d%-s",$depth,$podfile);
    push(@sorted,$sorted);
}

open IDX, ">$indexhtml" || die "Cannot open $indexhtml\n";
print IDX "<html><head><title>Perl Documentation - Ver 5.28</title></h
+ead>\n";
print IDX "<body>\n<blockquote>\n<h2>Perl Documentation - Ver 5.28</h2
+>\n";
print IDX "<h3>Table of Content</h3>\n";
open LOG, ">$logfile" || die "Cannot open $logfile\n";
pmpod2html();
close(LOG);
print IDX "</blockquote>\n</body></html>\n";
close(IDX);

sub pmpod2html {
    my ($prepath,$predepth);
    foreach my $podfile (sort @sorted) {
        $podfile =~ s/^\d{10}//o;
        my ($path,$name) = ($podfile =~ m!^$podroot(/.+)?/([^\/]+)\.(p
+od|pm|pl)$!i);
        $path =~ s/^\///o;
        my (@depth) = ($path =~ /(\/)/go);
        my $depth = scalar @depth;

        print IDX '</blockquote>' x$predepth . "\n\n" . '<blockquote>'
+ x$depth . "\n" . "<b>$path</b><br>\n" if($prepath ne $path);

        if (! -e "$htmldir/$path/$name\.html") {
            mkpath("$htmldir/$path");
            pod2html( "--infile=$podfile",
                "--outfile=$htmldir/$path/$name.html",
                "--podroot=$podroot",
                "--podpath=lib:site:vendor",
                "--htmldir=$htmldir",
            );

            my ($htmlfile);
            open(IN,"<$htmldir/$path/$name.html") || die "Cannot open 
+$htmldir/$path/$name.html\n";
            while(<IN>) { $htmlfile .= $_; }
            my ($title) = ($htmlfile =~ /<title>\s*(.+?)\s*<\/title>/i
+os);
            close(IN);

            print LOG "$podfile\n";
            if($title) {
                print IDX "$title: <a href=\"$path/$name.html\">$name.
+html</a><br>\n";
            }
            else { print IDX "<a href=\"$path/$name.html\">$name.html<
+/a><br>\n"; }
        }

        $prepath = $path;
        $predepth = $depth;
    }
}

[download]

In reply to Re^2: Find and convert all pod to html by Anonymous Monk
in thread Find and convert all pod to html by ryddler

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.