Beefy Boxes and Bandwidth Generously Provided by pair Networks
XP is just a number
 
PerlMonks  

perl pod link to anoter document

by vlad_tepesch (Acolyte)
on Apr 27, 2012 at 09:28 UTC ( [id://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?

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
Domain Nodelet?
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?Last hourOther CB clients
Other Users?
Others about the Monastery: (4)
As of 2024-03-19 06:45 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found