Wiki Lists

From Myth-Wiki
Jump to: navigation, search

Contents

List basics

wikitext rendering
* Lists are easy to do:
** start every line
* with a star
** more stars mean
*** deeper levels
  • Lists are easy to do:
    • start every line
  • with a star
    • more stars mean
      • deeper levels
*A newline
*in a list  
marks the end of the list.
Of course
*you can
*start again.
  • A newline
  • in a list

marks the end of the list. Of course

  • you can
  • start again.
# Numbered lists are good
## very organized
## easy to follow
  1. Numbered lists are good
    1. very organized
    2. easy to follow
* You can also
**break lines
**like this
  • You can also
    • break lines
    • like this
; Definition lists
; item : definition
; semicolon plus term
: colon plus definition
Definition lists
item 
definition
semicolon plus term
colon plus definition
* Or create mixed lists
*# and nest them
*#* like this
*#*; definitions
*#*: work:
*#*; apple
*#*; banana
*#*: fruits
  • Or create mixed lists
    1. and nest them
      • like this
        definitions
        work:
        apple
        banana
        fruits

A blank line within a list item or between list items

(In this and the next section, numbered lists are used in examples; unnumbered lists give a corresponding result. The only difference is the possible problem of a numbered list restarting with 1 if it is interrupted by a line that is not a list item.)

A list item can not be longer than one paragraph, unless HTML tags <br><br> or <p>...</p> are used within the list item to add space. A paragraph that does not begin with the same list item as preceding lines ("#" for a numbered list, "*" for an unnumbered list) will end the list. If the list is unnumbered, starting another paragraph with "*" will appear to continue the list, but if the list is numbered, the next paragraph which begins with "#" will start the list numbering over again from 1.

For a list with items of more than one paragraph long, adding a blank line between items may be necessary to avoid confusion.


Continuing a list item after a sub-item

In HTML, a list item may contain several sublists, not necessarily adjacent; thus there may be parts of the list item not only before the first sublist, but also between sublists, and after the last one; however, in wiki-syntax, sublists follow the same rules as sections of a page: the only possible part of the list item not in sublists is before the first sublist.

In the case of an unnumbered first-level list in wikitext code this limitation can be overcome by splitting the list into multiple lists; indented text between the partial lists may visually serve as part of a list item after a sublist; however, this may give, depending on CSS, a blank line before and after each list, in which case, for uniformity, every first-level list item could be made a separate list.

Numbered lists illustrate that what should look like one list may, for the software, consist of multiple lists; unnumbered lists give a corresponding result, except that the problem of restarting with 1 is not applicable.

<ol>
  <li>list item A1
    <ol>
      <li>list item B1</li>
      <li>list item B2</li>
    </ol>continuing list item A1
  </li>
  <li>list item A2</li>
</ol>
  1. list item A1
    1. list item B1
    2. list item B2
    continuing list item A1
  2. list item A2
vs.
#list item A1
##list item B1
##list item B2
#:continuing list item A1
#list item A2
  1. list item A1
    1. list item B1
    2. list item B2
    continuing list item A1
  2. list item A2

One level deeper, with a sublist item continuing after a sub-sublist, one gets even more blank lines; however, the continuation of the first-level list is not affected:

#list item A1
##list item B1
###list item C1
##:continuing list item B1
##list item B2
#list item A2

gives

  1. list item A1
    1. list item B1
      1. list item C1
      continuing list item B1
    2. list item B2
  2. list item A2


Extra indentation of lists

In a numbered list in a large font, some browsers do not show more than two digits, unless extra indentation is applied (if there are multiple columns: for each column).

:#abc
:#def
:#ghi

gives

  1. abc
  2. def
  3. ghi

This doesn't work directly for XHTML <ol> lists instead of #, for <ul> lists the Wiki markup * is more flexible.

Multi-column numbered lists

Specifying a starting value is useful for a numbered list with multiple columns, to avoid restarting from one in each column. This is only possible with HTML-syntax (for the first column either wiki-syntax or HTML-syntax can be used).

In combination with the extra indentation explained in the previous section:

{| 
|<ol start="125"><li>a<li>bb<li>ccc</ol>
|<ol start="128"><li>ddd<li>ee<li>f</ol>
|}

gives

  1. a
  2. bb
  3. ccc
  1. ddd
  2. ee
  3. f

Numbered list across sections

:<h3>Example A</h3>
#abc
#def<h3>Example B</h3>
#ghi
#jkl

gives

Example A

  1. abc
  2. def

    Example B

  3. ghi
  4. jkl

However, this disturbs section numbering within and after the list: "sections" produced by the h3 tag have an edit link (if enabled) and link to accordingly numbered sections, but application of "section =n " is based on sections defined by = signs only.