Re: [Docutils-users] Problem (?) with inline literals

[David G. <go...@py...>]

David Abrahams wrote:
> The following line doesn't seem to format as expected:
> 
>     Those bracketed expressions are Python ``list``s.  A ``list`` is
> 
> I just wanted the word "list" to appear twice as an inline literal,
> with the 's' following in a normal font.  Is there a way to do this?

reStructuredText's inline markup is designed to work at the phrase-level,
not at the character level.  So no, you can't do it, at least not directly.
However, there is a work-around; certain punctuation characters *are*
allowed adjacent to inline markup end-strings, such as apostrophes.  So you
could write it like this:

    Those bracketed expressions are Python ``list``'s.  A ``list`` is
                                                  (^ note the apostrophe)

This rule allows for text like "Use double backquotes ("``") for inline
literals."  For all the gory details, see

    http://docutils.sf.net/spec/rst/reStructuredText.html#inline-markup

-- 
David Goodger  <go...@py...>  Open-source projects:
  - Python Docutils: http://docutils.sourceforge.net/
    (includes reStructuredText: http://docutils.sf.net/rst.html)
  - The Go Tools Project: http://gotools.sourceforge.net/