Beefy Boxes and Bandwidth Generously Provided by pair Networks
There's more than one way to do things
 
PerlMonks  

perl pod link to anoter document

by vlad_tepesch (Novice)
on Apr 27, 2012 at 09:28 UTC ( #967566=perlquestion: print w/ replies, xml ) Need Help??
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?

Comment on perl pod link to anoter document
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

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: perlquestion [id://967566]
Approved by moritz
Front-paged by Corion
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others studying the Monastery: (3)
As of 2015-07-28 05:13 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    The top three priorities of my open tasks are (in descending order of likelihood to be worked on) ...









    Results (252 votes), past polls