Beefy Boxes and Bandwidth Generously Provided by pair Networks
good chemistry is complicated,
and a little bit messy -LW

Comment on

( #3333=superdoc: print w/replies, xml ) Need Help??

Allo, all.

I've been working on bracket-links lately. Specificly, I've fixed at least one bug, and added two new link types.

The first new link type is doc://. This is meant to combine the good bits of perldoc with the good bits of the onsite docs. It links to's documentation, like perldoc://. Unlike perldoc://, it links to actual docs, not a search for docs (currently for the documentation for 5.8.0. I will make this configurable at some point). It attempts to DWYM: If the link begins with "perl", it is to a manpage. If it does not, it is to a function. Thus, perlre, or stat DWYM, assuming you mean what I thought you did.

The more prosaic pseudo-URI-schema is href:// (also known as link://). This lets you link to whatever you like, even if it has a strange schema, or none at all. For example, to point to the "node template" setting in user settings directly, you can say "[href://?node=user+settings#Node-Template]" (?node=user+settings#Node-Template). If you're talking about a recent Mozilla in the CB, and want to link to the config screen, you can say [href://about:config] ([href://about:config]).

Oh, and the bug: At least some places where using | multiple times chopped things off. There are still bugs lurking, though. If you know of any, please reply with things that should be valid links (but aren't), and what you expected them to render like. (I don't promise to fix all of them, of course -- and I may even declare some of them to be features.)

I really want feedback on all of this -- please, don't consider any of the new things discussed here to be fixed yet -- meaning don't use them in nodes, except on this thread. OTOH, please try them out in the CB, to get a feel for them.

Update: Fixed stupidity.

Everything is subject to change

In reply to New bracket-link stuff by theorbtwo

Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post; it's "PerlMonks-approved HTML":

  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.
  • Log In?

    What's my password?
    Create A New User
    and all is quiet...

    How do I use this? | Other CB clients
    Other Users?
    Others scrutinizing the Monastery: (7)
    As of 2018-03-24 13:51 GMT
    Find Nodes?
      Voting Booth?
      When I think of a mole I think of:

      Results (298 votes). Check out past polls.