From: Raghuram D. <dra...@gm...> - 2006-04-21 17:40:38
|
Hi, I have bullet list something like * line1 * line2 * line3 The generated HTML for this list sometime has these lines separated with a blank line and sometimes not. I am not able to find any pattern, though. An= y ideas what might be contributing to this? Thanks, Raghu. |
From: David G. <go...@py...> - 2006-04-21 17:50:10
|
On 4/21/06, Raghuram Devarakonda <dra...@gm...> wrote: > I have bullet list something like > > * line1 > * line2 > * line3 "Something like" is not very useful. Actual examples of the different behaviours would be useful. > The generated HTML for this list sometime has these lines separated with = a > blank line and sometimes not. I am not able to find any pattern, though. = Any > ideas what might be contributing to this? It's probably because of list items containing multiple paragraphs. The behaviour can be affected by the --compact-lists and --no-compact-lists options: --compact-lists Remove extra vertical whitespace between items of "simple" bullet lists and enumerated lists. Defaul= t: enabled. --no-compact-lists Disable compact simple bullet and enumerated lists. -- David Goodger <http://python.net/~goodger> |
From: Raghuram D. <dra...@gm...> - 2006-04-21 18:19:55
|
Sorry, I will try to give concrete examples from next time. Anyway, I tested the following two cases with default options. Case 1: ------------- * testing bullet lists 1 - test 2nd level bullet lists. * testing bullet lists 2 - test 2nd level bullet lists 1 - test 2nd level bullet lists 2. * testing bullet lists 3 Result: compact lists Case 2: ------------- * testing bullet lists 1 - test 2nd level bullet lists. * testing bullet lists 2 - test 2nd level bullet lists 1 - test 2nd level bullet lists 2. * testing bullet lists 3 Result: non-compact lists. The difference is the extra indentation of second level bullet list. Even running with "--compact-lists" in second case will not generate compact lis= t but atleast, I know the expected behaviour now. Thanks, Raghu. On 4/21/06, David Goodger <go...@py...> wrote: > > On 4/21/06, Raghuram Devarakonda <dra...@gm...> wrote: > > I have bullet list something like > > > > * line1 > > * line2 > > * line3 > > "Something like" is not very useful. Actual examples of the different > behaviours would be useful. > > > The generated HTML for this list sometime has these lines separated wit= h > a > > blank line and sometimes not. I am not able to find any pattern, though= . > Any > > ideas what might be contributing to this? > > It's probably because of list items containing multiple paragraphs. > The behaviour can be affected by the --compact-lists and > --no-compact-lists options: > > --compact-lists Remove extra vertical whitespace between items of > "simple" bullet lists and enumerated > lists. Default: > enabled. > --no-compact-lists Disable compact simple bullet and enumerated > lists. > > -- > David Goodger <http://python.net/~goodger> > |
From: David G. <go...@py...> - 2006-04-21 18:45:43
|
On 4/21/06, Raghuram Devarakonda <dra...@gm...> wrote: > Sorry, I will try to give concrete examples from next time. Anyway, > I tested the following two cases with default options. ... > Case 2: > ------------- > > * testing bullet lists 1 > > - test 2nd level bullet lists. > > * testing bullet lists 2 > > - test 2nd level bullet lists 1 > - test 2nd level bullet lists 2. > > * testing bullet lists 3 > > Result: non-compact lists. > > The difference is the extra indentation of second level bullet list. The extra indentation is significant: it wraps the second level list in a block quote. Look at the second top-level bullet list item: """ * testing bullet lists 2 - test 2nd level bullet lists 1 - test 2nd level bullet lists 2. """ Now remove the bullet from the item, removing the bullet's indentation: """ testing bullet lists 2 - test 2nd level bullet lists 1 - test 2nd level bullet lists 2. """ You're left with a paragraph followed by an indented block -- a block quote -- containing a bullet list. This is exactly what the parser does. Parsing the original bullet list item gives this fragment: <list_item> <paragraph> testing bullet lists 2 <block_quote> <bullet_list bullet=3D"-"> <list_item> <paragraph> test 2nd level bullet lists 1 <list_item> <paragraph> test 2nd level bullet lists 2. It may appear to be subtle, but it's essential. The problem is that you've indented subtly, by one space. I suggest that if you do want a block quote, indent by at least 4 spaces so it's visible and obvious. If you don't intend a block quote, don't indent at all. > Even running with "--compact-lists" in second case will not generate > compact list --compact-lists doesn't *force* compact lists, it just *enables* them: Remove extra vertical whitespace between items of bullet lists and enumerated lists, when list items are all "simple" (i.e., items each contain one paragraph and/or one "simple" sublist only). The behaviour can be specified directly via "class" attributes (values "compact" and "open") in the document. -- http://docutils.sourceforge.net/docs/user/config.html#compact-lists Lists are only made compact if they're simple. Your only choice is to disable compact lists if you always want the vertical whitespace. -- David Goodger <http://python.net/~goodger> |
From: Beni C. <cb...@us...> - 2006-04-22 20:39:55
|
T24gNC8yMS8wNiwgRGF2aWQgR29vZGdlciA8Z29vZGdlckBweXRob24ub3JnPiB3cm90ZToKPiBQ YXJzaW5nIHRoZSBvcmlnaW5hbCBidWxsZXQgbGlzdCBpdGVtIGdpdmVzIHRoaXMgZnJhZ21lbnQ6 Cj4KPiAgICAgPGxpc3RfaXRlbT4KPiAgICAgICAgIDxwYXJhZ3JhcGg+Cj4gICAgICAgICAgICAg dGVzdGluZyBidWxsZXQgbGlzdHMgMgo+ICAgICAgICAgPGJsb2NrX3F1b3RlPgo+ICAgICAgICAg ICAgIDxidWxsZXRfbGlzdCBidWxsZXQ9Ii0iPgo+ICAgICAgICAgICAgICAgICA8bGlzdF9pdGVt Pgo+ICAgICAgICAgICAgICAgICAgICAgPHBhcmFncmFwaD4KPiAgICAgICAgICAgICAgICAgICAg ICAgICB0ZXN0IDJuZCBsZXZlbCBidWxsZXQgbGlzdHMgMQo+ICAgICAgICAgICAgICAgICA8bGlz dF9pdGVtPgo+ICAgICAgICAgICAgICAgICAgICAgPHBhcmFncmFwaD4KPiAgICAgICAgICAgICAg ICAgICAgICAgICB0ZXN0IDJuZCBsZXZlbCBidWxsZXQgbGlzdHMgMi4KPgo+IEl0IG1heSBhcHBl YXIgdG8gYmUgc3VidGxlLCBidXQgaXQncyBlc3NlbnRpYWwuICBUaGUgcHJvYmxlbSBpcyB0aGF0 Cj4geW91J3ZlIGluZGVudGVkIHN1YnRseSwgYnkgb25lIHNwYWNlLiAgSSBzdWdnZXN0IHRoYXQg aWYgeW91IGRvIHdhbnQgYQo+IGJsb2NrIHF1b3RlLCBpbmRlbnQgYnkgYXQgbGVhc3QgNCBzcGFj ZXMgc28gaXQncyB2aXNpYmxlIGFuZCBvYnZpb3VzLgo+IElmIHlvdSBkb24ndCBpbnRlbmQgYSBi bG9jayBxdW90ZSwgZG9uJ3QgaW5kZW50IGF0IGFsbC4KPgpUaGlzIHNlZW1zIHRvIGJlIGEgRkFR LiAgTm90IGluIHRoZSBGQVEsIEknbGwgYWRkIGl0IHByZXNlbnRseS4KSSB0aGluayB3ZSBzaG91 bGQgYWRkIGEgd2FybmluZyBmb3IgbGlzdHMgaW5zaWRlIGJsb2NrIHF1b3Rlcy4KUGVyaGFwcyBv bmx5IHdoZW4gdGhlIGJsb2NrIHF1b3RlIGlzIGluc2lkZSBhIGxpc3QgaXRlbS4KT3BpbmlvbnMg KHdoZXRoZXIgYXQgYWxsLCBvbiB3aGF0IGNvbmRpdGlvbiwgaW5mby93YXJuaW5nKT8KCi0tCkJl bmkgQ2hlcm5pYXZza3kgPGNiZW5AdXNlcnMuc2YubmV0Piwgd2hvIGNhbiBvbmx5IHJlYWQgZW1h aWwgb24gd2Vla2VuZHMuCkdvdmVybm1lbnRzIGFyZSBsaWtlIGtlcm5lbHMgLSBldmVyeXRoaW5n IHBvc3NpYmxlIHNob3VsZCBiZSBkb25lIGluIHVzZXIgc3BhY2UuCg== |