RE: [Docutils-develop] QuickRef (was RE: Figure references)

eng...@ne... wrote:
> I donot beleive yet
>
> +-----+--------------------+
> | raw | the same formatted |
> +-----+--------------------+
> where  do you put the "::", inside the cell ?
> does this work ?
> i thought the lines on the left must be marked literal
> each.

David may answer this better than I can (he's *much* better at designing
directives!).

But the idea, as I would see it, is that one doesn't write::

    +-----+--------------------+
    | raw | the same formatted |
    +-----+--------------------+

but instead something like::

    ..examples::
      rst::
         The *raw* text we want
      rst::
         Another such.

which would *generate* something like (the result of processing)::

    +----------------------------+------------------------+
    | The user types             | The result is          |
    +============================+========================+
    | ``The *raw* text we want`` | The *raw* text we want |
    +----------------------------+------------------------+
    | ``Another such``           | Another such           |
    +----------------------------+------------------------+

For single lines, and simple inline things, we could obviously do
without the directive and do it "by hand", but the directive approach
also allows us to contemplate::

    ..examples::
      rst::
         The *raw* text we want.

         Which spans two paragraphs.
      rst::
         And might be a title
         ====================
         Or subtitle
         -----------

Since a directive can do "anything it likes" (that *may* be a quote)
with the stuff "inside" it, this approach seems like it should work...

Tibs

--
Tony J Ibbs (Tibs)      http://www.tibsnjoan.co.uk/
.. "equal" really means "in some sense the same, but maybe not
.. the sense you were hoping for", or, more succinctly, "is
.. confused with". (Gordon McMillan, Python list, Apr 1998)
My views! Mine! Mine! (Unless Laser-Scan ask nicely to borrow them.)