GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  HTML::RESOLVELINK (3)

.ds Aq ’

NAME

HTML::ResolveLink - Resolve relative links in (X)HTML into absolute URI

CONTENTS

SYNOPSIS



  use HTML::ResolveLink;

  my $resolver = HTML::ResolveLink->new(
      base => http://www.example.com/foo/bar.html,
      callback => sub {
         my($uri, $old) = @_;
         # ...
      },
  );
  $html = $resolver->resolve($html);



DESCRIPTION

HTML::ResolveLink is a module to rewrite relative links in XHTML or HTML into absolute URI.

For example. when you have



  <a href="foo.html">foo</a>
  <img src="/bar.gif" />



and use http://www.example.com/foo/bar as base URL, you’ll get:



  <a href="http://www.example.com/foo/foo.html">foo</a>
  <img src="http://www.example.com/bar.gif" />



If the parser encounters <base> tag in HTML, it’ll honor that.

METHODS

new


  my $resolver = HTML::ResolveLink->new(
      base => http://www.example.com/,
      callback => \&callback,
  );



base is a required parameter, which is used to resolve the relative URI found in the document.

callback is an optional parameter, which is a callback subroutine reference which would take new resolved URI and the original path as arguments.

Here’s an example code to illustrate how to use callback function.



  my $count;
  my $resolver = HTML::ResolveLink->new(
      base => $base,
      callback => sub {
          my($uri, $old) = @_;
          warn "$old is resolved to $uri";
          $count++;
      },
  );

  $html = $resolver->resolve($html);

  if ($count) {
      warn "HTML::ResolveLink resolved $count links";
  }



resolve


  $html = $resolver->resolve($html);



Resolves relative URI found in $html into absolute and returns a string containing rewritten one.

resolved_count


  $count = $resolver->resolved_count;



Returns how many URIs are resolved during the previous resolve method call. This should be called after the resolve, otherwise returns undef.

AUTHOR

Tatsuhiko Miyagawa <miyagawa@bulknews.net>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

HTML::Parser, HTML::LinkExtor

POD ERRORS

Hey! <B>The above document had some coding errors, which are explained below:B>
Around line 193: You forgot a ’=back’ before ’=head1’
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 HTML::RESOLVELINK (3) 2006-11-28

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.