---
name: "MojoMojo::Formatter::CPANHyperlink"
section: "3pm"
platform: "linux"
package: "libmojomojo-perl"
version: "1.12+dfsg-1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/MojoMojo::Formatter::CPANHyperlink"
---

# MojoMojo::Formatter::CPANHyperlink(3pm)

automatically hyperlink CPAN modules when using the syntax {{cpan Some::Module}}

## 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.