Beefy Boxes and Bandwidth Generously Provided by pair Networks
P is for Practical
 
PerlMonks  

Re^3: Bookmarklet to show deeplinks in perldoc.perl.org

by LanX (Sage)
on Jun 17, 2019 at 15:07 UTC ( #11101478=note: print w/replies, xml ) Need Help??


in reply to Re^2: Bookmarklet to show deeplinks in perldoc.perl.org
in thread Bookmarklet to show deeplinks in perldoc.perl.org

> If I can be convinced that perldoc.pl is a better choice for our (PM) needs, I'll switch it.

some thoughts:

  • If switching means that old doc-links will refer to perldoc.pl I'm not sure if URL paths are consistent.
  • We used to have a [metacpan:://...] alternative to [cpan://..] . ( [docpl://..] might be an option but I'm not too convinced.)
  • you may add a user setting such that users like Choroba can choose jumping perldoc.pl for each ... link

Personally I prefer direct auto-linking of bare http-URLs. My wikisyntax does this.

> It was claimed that perldoc.perl.org was moribund,

I only had minor issues with perldoc.perl.org. (like the need to scroll up after a deeplink, because the first lines where covered by the navbar.)

And like already mentioned in the OP are possible deep-targets not easily accessible.

What I have trouble to understand is why they suddenly replaced it with a worse beta-version of something else.

Cheers Rolf
(addicted to the Perl Programming Language :)
Wikisyntax for the Monastery FootballPerl is like chess, only without the dice

Replies are listed 'Best First'.
Re^4: Bookmarklet to show deeplinks in perldoc.perl.org
by jdporter (Chancellor) on Jun 17, 2019 at 15:25 UTC
    If switching means that old doc-links will refer to perldoc.pl I'm not sure if URL paths are consistent.

    OTOH, not switching would have the same problem, as perldoc.perl.org is messing with their own stuff.

    But I'm not sure this is in fact a problem. [doc://open] has no URL paths.

    direct auto-linking of bare http-URLs.

    I have no idea what that means. Can you clarify? TIA.

    I reckon we are the only monastery ever to have a dungeon stuffed with 16,000 zombies.
        the #hash part for deep-linking to anchors

        Oh... So you're not talking about path parts. You're talking about fragment parts — URI parts

        So in some sense this is a form of link rot. I think there will always be some risk of this, since we don't have any control over how any external web site manages their anchors — nor indeed their paths — nor indeed even the domain names.

        It's the nature of the beast. People put external links in their posts; ten years later those links don't work. We just have to live with the risk.

        In general, I'd prefer to stay with perldoc.perl.org, since it is "official". I think we'd need a really compelling reason to switch to something else. Like we did with MetaCPAN.

        I reckon we are the only monastery ever to have a dungeon stuffed with 16,000 zombies.
Re^4: Bookmarklet to show deeplinks in perldoc.perl.org
by choroba (Archbishop) on Jun 17, 2019 at 15:25 UTC
    > why they suddenly replaced it

    Because the old one was out of date (it hadn't been updated for more than a year, so it didn't show the latest Perl version's documentation, it was stuck at 5.26 IIRC) and there was no one to maintain it in its current state.

    Another question is, why they suddenly replaced it when a replacement had already existed at perldoc.pl. I don't know the answer.

    map{substr$_->[0],$_->[1]||0,1}[\*||{},3],[[]],[ref qr-1,-,-1],[{}],[sub{}^*ARGV,3]
      Am I mislead or did the old version allow to be downloaded with an embedded JS search engine?

      Cheers Rolf
      (addicted to the Perl Programming Language :)
      Wikisyntax for the Monastery FootballPerl is like chess, only without the dice

Re^4: Bookmarklet to show deeplinks in perldoc.perl.org
by Anonymous Monk on Jun 17, 2019 at 15:23 UTC
    Any URL paths to actual documentation pages should still work. Index pages are an invention of perldoc.perl.org and won't, though I could be convinced to add forwarding for them. -Grinnz
        As far as I can tell that anchor still works fine on perldoc.pl, despite the unnecessary encoding.

Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Node Status?
node history
Node Type: note [id://11101478]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others rifling through the Monastery: (4)
As of 2022-05-28 08:29 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?
    Do you prefer to work remotely?



    Results (99 votes). Check out past polls.

    Notices?