My question is best begun by quoting perlpod about the L<> linking sequence 

    L<name/ident>	item in manual page
    L<name/"sec">	section in other manual page ...
		(Text can not contain the characters '/' and '|', 
		and should contain matched '<' or '>')

How then to specify a directory structure for a link?

Specifically, I wanted to be able to link between pod, pl, pm files that were arranged as follows 

aproject/code/ascript.pl         # all code in one directory
aproject/code/modules/amodule.pm     # modules in another
aproject/docs/anote.pod            # general documentation seperated f
+rom code

[download]

and then I wanted to be able to link within docs/anote.pod (say) as follows 

L<../code/ascript.pl>    # link in docs/anote.pod to code/ascript.pl

[download]

I'm becoming quite fond of using pod, especially given my lack of html experience. This however is a showstopper for me if I can't incorporate directory heirarchies and be able to pod up my general project notes seperately with links to the pl pod.

I have tried the perl2html utility, searched through Pod::Tree::Html and tried the pods2html snippet all to no avail.

The only two clues I have found are examples of link sequences written as 

L<C<ascript>>

[download]
and maybe that produces something different and examples of links written 
L<Pod::Tree::Html>

[download]
which must somehow give close to what I would like to do given my perl html docs.

Which (no doubt obvious) points am I missing?

Thanks Tony

In reply to How to link to other directories within Pod by tonyday

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.