Re: Bug Report: new line for lists

Wed, 31 Dec 2008 10:39:26 -0800

Thanks Christophe!

Below are my comments:

Christophe de VIENNE wrote: 
Hi,

Do you refer to http://sphinx.pocoo.org/rest.html#lists-and-quotes ?
Yes.
The way I understand it is that there is no need to write a long item
on one line, one can split it in several line while 'staying' in the
list item.
It is not saying that this second line will be a new line in the
output. On the contrary.

Generally speaking, one line in rest does not become one line on the
output, and this is one of the things where rest powerful : you don't
need to handle by yourself the line length.
I understand now.  Keeping the source files in good shape is part of
a good documentation too.  I am new for the Sphinx Documentation
and I am still not sure if it is possible to force a new lines (end of a line)
in a list and in a paragraph.  In my understanding reST currently does not
identify symbol "\" as line continuation that is a Python feature.

That is why in my original posting I thought that:

* Item 1a.
   Item 1b.
* Item 2.

will result in:

<ol>
  <li>Item 1a</li>
  <dd style="margin-left: 0px;">Item 1b</dd>
  <li>Item 2</li>
</ol>

and:

* Item 1a.  \
   Item 1b.
* Item 2.

should be the more appropriate way to handle long lines.

-- Marin

 
Christophe

2008/12/31  <[email protected]>:
  
The manual at http://sphinx.pocoo.org/rest.html suggest that (un)order
lists:

* This is a bulleted list.
* It has two items, the second
  item uses two lines.

#. This is a bulleted list.
#. It has two items, the second
   item uses two lines.

will output second line of the second items on new line.

It does not.


--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups "sphinx-dev" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [email protected]
For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to