github/gollum — Issue #274: POD absolute links with text break
Author: bigpresh
Created: 2012-02-15 12:47:26+00:00
State: open

I'm using POD-format wiki pages, and finding that, if I create links to absolute pages with text, they get broken (turned into a perldoc link).

To illustrate, I've created a test page at https://github.com/bigpresh/test/wiki/Test showing the issue.

The first link, created with `L`, works as expected.

The second, created with `L`, gets incorrectly turned into a link to `http://search.cpan.org/perldoc?http%3A#%2Fwww.preshweb.co.uk%2F`.

I believe Gollum uses `Pod::Simple::HTML` to turn the POD into HTML; I've tested with `Pod::Simple::HTML` 3.19, and it does not suffer from the problem using default options - for instance, given this simple test case:

```perl
#!/usr/bin/perl

use strict;
use Pod::Simple::HTML;

my $parser = Pod::Simple::HTML->new;
$parser->output_string(\my $html);
$parser->parse_string_document(<

POD
print $html
```

... the resulting HTML output includes the link correctly:

`

Here's a link

`

I believe Gollum uses the call to Pod::Simple::HTML which I see in the github/markup repo:

https://github.com/github/markup/blob/master/lib/github/markups.rb

That looks like it should work fine, though, and indeed testing it locally shows it handles the links correctly.

Is there some later post-processing going on which is causing this, or are you using an older version of Pod::Simple::HTML which has problems with links with text, or something?