Difference between revisions of "Lists"

From IMSMA Wiki
Jump to: navigation, search
Line 35: Line 35:
 
|+Bad example
 
|+Bad example
 
! scope="col" | Wikitext
 
! scope="col" | Wikitext
! scope="col" | HTML
 
 
! scope="col" | Appearance
 
! scope="col" | Appearance
 
|- style="vertical-align:top;"
 
|- style="vertical-align:top;"

Revision as of 15:54, 30 August 2013

General rules

  • Do not use lists if text is read easily as plain paragraphs.
  • Use proper wikimarkup.
  • Do not leave blank lines between items in a bulleted or numbered list unless there is a reason to do so, since this causes the Wiki software to interpret each item as beginning a new list.
  • Use numbers rather than bullets only if:
    • a need to refer to the elements by number may arise;
    • the sequence of the items is critical; or
    • the numbering has some independent meaning.
  • Use the same grammatical form for all elements in a list, and do not mix sentences and sentence fragments as elements.
  • When the elements are complete sentences, each one is formatted with sentence case (its first letter is capitalized) and a final period (full stop).

Bulleted lists

Good example
Wikitext Appearance
== Title of list ==
* Example 1
* Example 2
* Example 3
Title of list
  • Example 1
  • Example 2
  • Example 3

As a matter of style, list items should be formatted consistently in either sentence case or lower case. They should not have final punctuation unless they consist of complete sentences.

In particular, do not double-space the lines of the list by leaving blank lines or extra HTML <br> tags after them, as in this example:

Bad example
Wikitext Appearance
== Title of list ==
* Example 1

* Example 2

* Example 3
Title of list
  • Example 1
  • Example 2
  • Example 3