Linking from POD

choroba has asked for the wisdom of the Perl Monks concerning the following question:

In Syntax::Construct, I need to link to various parts of Perl documentation. I have problems linking to (?|pattern) in perlre: The link works in CPAN, but it doesn't in MetaCPAN.

<c>
L<perlre/"(?E<124>pattern)">
[download]

is converted to the correct link in CPAN, but in MetaCPAN, only perlre/#pattern is preserved in the link. Has anyone experienced a similar problem and possibly found a solution?

Update: Maybe a trick how to test how various links would be rendered in CPAN and MetaCPAN would be enough.

لսႽ† ᥲᥒ⚪⟊Ⴙᘓᖇ Ꮅᘓᖇ⎱ Ⴙᥲ𝇋ƙᘓᖇ

Comment on Linking from POD Select or Download Code

Replies are listed 'Best First'.
Re: Linking from POD by tobyink (Canon) on Apr 29, 2014 at 22:42 UTC
If I were you, I'd just link to the "Extended Patterns" heading, rather than trying to link directly to the `=item` in question. Links seem to be one of the least consistently implemented parts of pod, so it's probably best to keep them simple. `use Moops; class Cow :rw { has name => (default => 'Ermintrude') }; say Cow->new->name`	[reply] [d/l]
Re: Linking from POD (artificial linkrot, Pod::Simple::XHTML bugs) by Anonymous Monk on Apr 29, 2014 at 23:14 UTC
Try `L<perlre/(?E<verbar>pattern)>` although it doesn't work in my local test (not surprising given the real id generated, see below ) `perl -MPod::Simple::XHTML -e " exit Pod::Simple::XHTML->filter(shift)->any_errata_seen " links.pod > links.html` Apparently Pod::Simple::XHTML is what metacpan uses, so its what needs patching Some thoughts on that who edits p3rl.org? link fixer idea, pod link anchors mangled (spaces to dashes) · Issue #988 · CPAN-API/metacpan-web · GitHub FWIW, a desperation move IMHO (since pod should just work, and this isn't guaranteed to be futureproof) `=for html <a href="https://metacpan.org/pod/perlre#pattern1">(?\|patter +n)</a> =cut` [download] Turning `(?\|pattern)` into id="pattern1" is stupid PITA , its not future proof Now if pattern) turned into https://metacpan.org/pod/perlre#pattern1 or whatever the link becomes tomorrow, thus avoiding linkrot, I could live with it But then again (?\|pattern) could disappear tomorrow as an actual linkable target/section/item (=head1...) ... Re: Shortcut for referencing specific sections of CPAN documents	[reply] [d/l] [select]
Re^2: Linking from POD (artificial linkrot, Pod::Simple::XHTML bugs) by Anonymous Monk on Apr 29, 2014 at 23:16 UTC
Aww foiled by perlmonks preview fatigue :) `Now if [href://https://metacpan.org/pod/perlre/(?\|pattern)] turned into` https://metacpan.org/pod/perlre/(?\|pattern)	[reply] [d/l]
Re: Linking from POD by RonW (Parson) on Nov 04, 2014 at 19:09 UTC
I had not noticed before, but perlpodspec does not provide any actual rules for generating anchors, not even for HTML. (There are a few examples in the detailed `About L<...> Codes` section, but not rules. Indeed, one sentence says "Formatters may choose to ignore the markup for purposes of resolving the link and use only the renderable characters in the section name". "may" in that sentence is a big loophole.) A few simple rules for generating anchor names might be enough to cover most target formats that allow anchors. If that's not feasible, then at least rules covering HTML anchors.	[reply] [d/l]