cpan

MojoMojo::Formatter::CPANHyperlink(3pm) 		User Contributed Perl Documentation		   MojoMojo::Formatter::CPANHyperlink(3pm)

NAME

       MojoMojo::Formatter::CPANHyperlink - automatically hyperlink CPAN modules when using the syntax {{cpan Some::Module}}

DESCRIPTION

       Normally, to hyperlink to a CPAN module, you'd write:

	   [MojoMojo::Formatter::CPANHyperlink](http://search.cpan.org/perldoc?MojoMojo::Formatter::CPANHyperlink)

       This plugin lets you write just

	   {{cpan MojoMojo::Formatter::CPANHyperlink}}

       Just like POD, it supports adding a section after the module name:

	   {{cpan Catalyst::Manual::Cookbook/Deployment}}

       will create a link to

	   http://search.cpan.org/perldoc?Catalyst::Manual::Cookbook#Deployment

       Sections can contain any characters, except two consecutive closed braces:

	   {{cpan Catalyst::Test/($res, $c) = ctx request( ... ); }}

       will link to

	   http://search.cpan.org/perldoc?Catalyst::Test#($res,_$c)_=_ctx_request(_..._);

       In anticipation of future plugin syntax, you can optionally add a trailing slash

	   {{cpan Some::Module/Section /}}

METHODS

   format_content_order
       The CPANHyperlink formatter has no special requirements in terms of the order it gets run in, so it has a priority of 10.

   format_content
       Calls the formatter. Takes a ref to the content as well as the context object.

SEE ALSO

       MojoMojo and Module::Pluggable::Ordered.

AUTHORS

       Dan Dascalescu, <http://dandascalescu.com>

LICENSE

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

perl v5.14.2							    2010-04-07				   MojoMojo::Formatter::CPANHyperlink(3pm)