vlad_tepesch has asked for the wisdom of the Perl Monks concerning the following question:

Hi.

I want to embed a (in html clickable) link to another file that have to be in same direcory into text

L<file:///..myFile.html> does not work since i can not specify files in same directory with a absolute path

L<myFile.html> does not work because pod expected this to be some section of current document.

are there any options beside writing whole paragraph in a "=begin html"/"=end html" block?

Replies are listed 'Best First'.
Re: perl pod link to anoter document
by moritz (Cardinal) on Apr 27, 2012 at 09:45 UTC

    I haven't tried it, but you can specify relative paths with file:// URLs, you just have to use two slashes instead of three. (The two slashes are part of the protocol specification, if there is a third one, it's the leading slash of an absolute path).

      i tried this and it did not work. the results are empty file links (file:///) http://perldoc.perl.org/perlpod.html says
      Or you can link to a web page:
      
          L<scheme:...>
      
          L<text|scheme:...>
      
          Links to an absolute URL. For example, L<http://www.perl.org/> or L<The Perl Home Page|http://www.perl.org/>.
      

        i tried this and it did not work.

        You tried what?

        ro.pod

        =head1 LINKS TO SHAM BO C<<< file:sham.html >>> L<file:sham.html> C<<< file:./sham.html >>> L<file:./sham.html> BOGUS LINKS, ABSOLUTE NOT RELATIVE ACCORDING TO FIREFOX C<<< file://sham.html >>> L<file://sham.html> C<<< file://./sham.html >>> L<file://./sham.html> =cut

        This fails (I expected this, many bugs in pod2html)  pod2html ro.pod > ro.html

        This works  perl -MPod::Simple::HTML -e Pod::Simple::HTML::go ro.pod  ro.html

        This works pom2 html ro.pod > ro.html

        This works :) plackup -l localhost:80 -e require(Pod::POM::Web::PSGI)

Re: perl pod link to anoter document
by Anonymous Monk on Apr 27, 2012 at 10:21 UTC

    are there any options beside writing whole paragraph in a "=begin html"/"=end html" block?

    =for html this html of mine =cut

    But I don't see why you'd mix pod and html, write links to pod documents, otherwise do it all with your favorite html editor