Hello,
I am having difficulty understanding how Pod::Html uses --htmldir and
--htmlroot. Rather, I understand how it uses them in the code, but I cannot
grasp their overall function or purpose. Do any of you have experience with
this matter or have knowledge that can be shared? Below is an example of my
confusion.
---------------------
The documentation says that --htmldir
"Sets the directory in which the resulting HTML file is placed. This is used
> to generate relative links to other files. Not passing this causes all links
> to be absolute, since this is the value that tells Pod::Html the root of the
> documentation tree,"
>
but that still leaves questions. If $Htmldir sets the directory in which the
resulting file is placed, does that mean it will move it there, or does that
mean I need to repeat the path of the --outfile, as that is where the
--outfile will be? What is the point of that? Further, is it essentially a
boolean switch to determine if I want absolute or relative paths? Are there
any other factors that determine if the path is relative or absolute?
The comments of Pod::Html describe --htmldir as
"The directory to which the html pages will (eventually) be written."
Why is "pages" pluralized? Is --htmldir supposed to be the directory where
all the cross referenced .html pages are? Is the resulting file written
elsewhere but moved there later?
The explanation given in the usage of Pod::Html says that
"--htmldir - directory for resulting HTML files,"
which hints that it should be the directory where all the .html files that
are cross referenced live. Either that, or Pod::Html converts more than one
pod file at a time, which I do not believe is true.
---------------------
I am faced with similar questions regarding --htmlroot, but I don't see a
point in listing them right now.
Some background information: I am in the middle of converting Pod::Html to
use Pod::Simple instead of its own parser. The feature that I am currently
migrating is the cross referencing of links. I use Pod::Simple::Search to
find all POD files in @Podpath, and using a hash of { name => path } of the
POD files I need to correctly link to them from the resulting html file. My
work is on github, https://github.com/marcgreen/pod-simple for the subclass
of Pod::Simple::Xhtml that I use, and https://github.com/marcgreen/perl for
the new Pod::Html.
I appreciate any help given,
Marc
