My earlier post on the topic finally got accepted; is sphinx-dev fully monitored (i.e. need each post review)?
2011/11/4 Guenter Milde <mi...@users.berlios.de>: >> It appears by inspection of the html source code, that indeed the >> sublist is not contained in a <p> tag. This appears like a mistake to >> me. Because it should be a paragraph, since it is an entity on its >> own to be rendered such. It also generates a rather wrong-looking >> visual impression of the rendered html output. > > I don't think that a sub-list of a list should be nested in a paragraph > element. OK, I don't think I'm knowledgable enough to decide that. But to a LaTeX user, a list makes a paragraph, although it might contain paragraphs in its items. But the list as is could be treated just "as is", without caring if there are paragraphs inside or not. MHO. Your mileage may vary :-) of course. >> I don't know it this issue is a general docutils issue or if it can be >> handled within Sphinx. > > I compiled the example with Docutils (rst2html.py). In my browser > (firefox as well as midori) there is the correct "paragraph separating > space" between "subitem 1.2" and "item 2" (with the default stylesheet > html4css1.css). Thanks for the hint, I agree fully on the observation. >> I would appreciate a solution, since I'm >> observing this mistake since years now; although I seem to be a rare >> case in constructing such lists, it apprears regularly to me. > > I suppose that the visual impression of the rendered html output is due > the used CSS style sheet and can be fixed in a style sheet (either as a fix > in the default Sphinx style or as a workaround in a custom style sheet). I also agree that it seems to be style sheet related. I think it can be solved fully via this. I see that the ``simple`` as well as the ``first`` classes are missing at least in the default + nature style sheets; it is the ``ol.simple, ul.simple`` that introduces ``margin-bottom:1em``. Now that I know what I have to work on I can try a fix. Thank you very much for the helpful pointers, Friedrich P.S.: I was apparently too quick in believing that the <p> tag is necessarily the only solution. Although I still believe it is a more elegant solution. The browser can decide how much space to place, and the stylesheet does not need to say ``1em`` explicitly. I have put my thoughts in a comprehensive form on http://friedrichromstedt.github.com/lists1.html, with an example how it could work out in terms of resulting HTML. -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to sphinx-dev@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.
