in reply to Creating not so plain documentation

and re "those <p> tags:
inside the list items, they force (usually) a blank line which trails the content so that there's a blank line between bullets.

eg:

<ul> <li><p>foo</p></li> <li><p>foo1</p></li> <li>foo2</li> <li>foo3</li> </ul>
will look like this:
∙ foo

∙ foo1

∙ foo2
∙ foo3

And, as ikegami said, you can control the presentation with css -- http://www.w3schools.com/ has a decent tutorial if you're unfamiliar with style sheets. Once you have the basics, you may find it worthwhile to read the various css specs at http://www.w3.org/Style/CSS/.

For a example (anything more is well outside the scope of the Monastery), change the display of those updated for clarity the content of the list-items with something like this (inline for ease of display):

<ul> <li><p style="color: red; background-color: transparent; font-size: 1. +1em; font-weight:bold;">foo</p></li> <li><p style="color: #000000; background-color: #dddddd;; font-size: 1 +.1em; font-weight:bold;">foo1</p></li> <li style="color: blue; background-color: transparent; font-size: 1.1e +m; font-weight:bold;">foo2</li> <li style="font-size: 1.1em; font-weight:bold;">foo3</li> </ul>

which would give you bold, slightly larger than normal-font-size type, with "foo" in red; "foo1" in black on a silver background; "foo2" in blue, and "foo3" in black again (assuming you had not used some other color as a default for the page.

Update ikegami provides a more technical (and CORRECT) answer; however, if you're just starting with css the code and descriptions of the rendering are correct; the statement re the placement of the blank lines is imprecise ok, admit it! wrong.

Replies are listed 'Best First'.
Re^2: Creating not so plain documentation
by ikegami (Patriarch) on Jan 08, 2007 at 21:46 UTC
    The blank space appears before the bullet instead of after because of collapsing margins.

    The bullet doesn't count as content, so the bottom margin of the previous P, the bottom margin of the previous LI, the top margin of the LI and the top margin of the P are collapsed into one margin whose size is the biggest of the 4 margins.

    ( Contrary to his claims, there's nothing wrong with what ww said. I was just expanding on it. )