NAME

Pod::Simple::Role::XHTML::WithAccurateTargets - Use more accurate link targets

SYNOPSIS

  package MyPodParser;
  with 'Pod::Simple::Role::XHTML::WithAccurateTargets';

  my $parser = MyPodParser->new;
  $parser->output_string(\my $html);
  $parser->parse_string_document($pod);

DESCRIPTION

Adds multiple link targets to rendered headings to allow more useful linking.

The normal targets used by Pod::Simple::XHTML are heavily filtered, meaning heading that are primarily symbolic (such as @_ in perlvar) can't be usefully linked externally. Link targets will be added using minimal filtering, which will also be used for linking to external pages.

Many headings for functions and methods include the function signature. This makes linking to the headings awkward. Link targets based on the first word of headings will be added to make linking easier. This form of linking is very common when linking to sections of perlfunc, allowing links like L<perlfunc/open>.

SUPPORT

See MetaCPAN::Pod::XHTML for support and contact information.

AUTHORS

See MetaCPAN::Pod::XHTML for authors.

COPYRIGHT AND LICENSE

See MetaCPAN::Pod::XHTML for the copyright and license.