Difference between revisions of "Lists"

From IMSMA Wiki
Jump to: navigation, search
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
 +
'''Lists''' are used to better structure text that is unsuitable as a paragraph.
 +
 
== General rules ==
 
== General rules ==
 
* Do not use lists if text is read easily as plain paragraphs.
 
* Do not use lists if text is read easily as plain paragraphs.
 
* Use proper wikimarkup.
 
* 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.
 
* 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 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).
 
* Use numbers rather than bullets only if:
 
* Use numbers rather than bullets only if:
 
** a need to refer to the elements by number may arise;
 
** a need to refer to the elements by number may arise;
 
** the sequence of the items is critical; or
 
** the sequence of the items is critical; or
 
** the numbering has some independent meaning.
 
** 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 ===
+
== Bulleted lists ==
  
{| class="wikitable"
+
{| class="wikitable" style="margin: 1em auto 1em auto;"
 
|+Good example
 
|+Good example
 
! scope="col" | Wikitext
 
! scope="col" | Wikitext
Line 29: Line 31:
 
* Example 3
 
* 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 <nowiki><br></nowiki> tags after them, as in this example:
 
In particular, '''do not double-space the lines of the list''' by leaving blank lines or extra HTML <nowiki><br></nowiki> tags after them, as in this example:
{| class="wikitable"
+
{| class="wikitable" style="margin: 1em auto 1em auto;"
 
|+Bad example
 
|+Bad example
 
! scope="col" | Wikitext
 
! scope="col" | Wikitext
Line 52: Line 53:
 
* Example 3
 
* Example 3
 
|}
 
|}
 +
 +
==Numbered lists==
 +
Similar to the above, use a # symbol to obtain a numbered list:
 +
{| class="wikitable" style="margin: 1em auto 1em auto;"
 +
! Wikitext
 +
! Appearance
 +
|-
 +
| <pre>
 +
== Title of list ==
 +
# Example 1
 +
# Example 2
 +
# Example 3
 +
</pre>
 +
| style="white-space:nowrap; padding:1em;" | <div style="padding-top:0.5em; padding-bottom:0.17em; border-bottom:1px solid #aaa; font-size:150%; margin-bottom:0.6em;"> Title of list </div>
 +
# Example 1
 +
# Example 2
 +
# Example 3
 +
|}
 +
Blank lines between items of an ordered list will not only cause the same problems as in the previous example, but will also restart the numbering at "1".
 +
 +
== IMSMA Menu and Sub-menu ==
 +
If you want to refer to menu and/or sub-menu within {{IMSMANG}} use this arrow → for example File menu → Export → Translations.
 +
{{Policies}}

Latest revision as of 09:56, 16 September 2013

Lists are used to better structure text that is unsuitable as a paragraph.

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 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).
  • 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.

Bulleted lists

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

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

Numbered lists

Similar to the above, use a # symbol to obtain a numbered list:

Wikitext Appearance
== Title of list ==
# Example 1
# Example 2
# Example 3
Title of list
  1. Example 1
  2. Example 2
  3. Example 3

Blank lines between items of an ordered list will not only cause the same problems as in the previous example, but will also restart the numbering at "1".

IMSMA Menu and Sub-menu

If you want to refer to menu and/or sub-menu within IMSMANG use this arrow → for example File menu → Export → Translations.