[Doc-SIG] References in the same line as the target text

[Simon Budig]

David Goodger (goodger@users.sourceforge.net) wrote:
> You seem to feel inline URLs are important.  Here's a chance to prove
> your position.  I'll leave it up to you to implement them, on an
> experimental basis.

In the sandbox there is a drop in replacement for the states.py file.
I have not yet come around to implement this as a subclass of
Inliner() but it should not be too hard - all changes to the file are
insde this class... It is nearly 5 am now and I don't want to think
about that now...   :-)

[...]
> However, I really don't like that syntax; it doesn't make sense.
> Let's examine it and see if we can come up with something better.  I
> have two objections:
> 
> 1. The "`ref`_(URL)" syntax forces the last word of the reference text
>    to be joined to the URL, making a potentially very long word that
>    can't be wrapped (URLs can be very long).  The reference and the
>    URL should be separate.
>
> 2. The "inline hyperlink" text is *not* a named reference (there's no
>    lookup by name), so it shouldn't look like one.

I have now implemented  reference__ __<uri> and `refe rence`__ __<uri>.
they are analogous to anonymous links. I also implemented
reference_ _<uri> and `refe rence`_ _<uri> analogoes to named links,
this is some kind of closure of the syntax (mathematically speaking... :-)

I am currently not sure if the possibility to wrap before long URLs
is worth the added line noise by doubling the underscores.
I think reference_<uri> resp. reference__<uri> might be acceptable too.

Comments?

Bye,
        Simon
-- 
      Simon.Budig@unix-ag.org       http://www.home.unix-ag.org/simon/