| At line 1 removed one line |
| == List markup features == |
| At line 5 removed 4 lines |
| * Hyphen |
| * Asterisk |
| * Other |
|
| At line 11 changed one line |
| The use of asterisk can introduce conflicts with bold markup. |
| ==== Asterisk ==== |
| The use of asterisk "*" can introduce conflicts with bold markup in certain combinations of these features. In particular, when "Repeated bullet" is used for marking nesting, there is a need a additional disambiguation, either in form of a space at either side or and escape character. |
| At line 13 changed one line |
| The use of hyphen introduces conflicts with various casual uses of hyphens, dashes, minus sign and horizontal line. |
| ==== Hyphen ==== |
| The use of hyphen "-" introduces conflicts with various casual uses of hyphens, dashes, minus sign and horizontal line. In particular, while the horizontal line conflict appears always, and additional rules are needed to disambiguate them, the hyphen conflict only appears when the user puts the hyphen(s) at the beginning of the line; unfortunately, just adding spaces is not enough for disambiguation in this case. |
| At line 12 added one line |
| ==== Other ==== |
| At line 17 changed 4 lines |
| === Indentation === |
| * Mandatory |
| * Optional |
| * Forbidden |
| == Indentation == |
| At line 17 added one line |
| ==== Mandatory ==== |
| At line 20 added one line |
| ==== Forbidden ==== |
| At line 23 added one line |
| ==== Optional ==== |
| At line 28 changed 5 lines |
| === Space after bullet === |
| * Mandatory |
| * Optional |
| * Meaningful |
|
| == Space after bullet == |
| ==== Mandatory ==== |
| At line 35 changed one line |
| Requiring the space //only// when there is an ambiguity is a loosening of this rule that gives up visual clarity on behalf of "user freedom". The ambiguity with second-level lists and bold remains, unless it is accounted for in a different way. |
| ==== Optional ==== |
| Requiring the space //only// when there is an ambiguity is a loosening of this rule that gives up visual clarity on behalf of "user freedom". The ambiguity with second-level lists and bold remains, unless it is accounted for in a different way. Visual clarify disappears, as [[Bullet List On Wikipedia Research]] shows that users will not create clear markup if they don't have to. |
| At line 33 added one line |
| ==== Meaningful ==== |
| At line 39 changed 7 lines |
| === Nesting indication === |
| * Repeated bullet |
| * Repeated bullet with spaces |
| * Indentation with spaces/tabs |
| * Indentation with other characters |
| * Changing bullet character |
|
| == Nesting indication == |
| ==== Repeated bullet ==== |
| At line 40 added 8 lines |
| Example: |
| {{{ |
| * list |
| ** sublist |
| *** subsublist |
| }}} |
|
| ==== Repeated bullet with spaces ==== |
| At line 50 added 8 lines |
| Example: |
| {{{ |
| * list |
| * * sublist |
| * * * subsublist |
| }}} |
|
| ==== Indentation with spaces/tabs ==== |
| At line 60 added 8 lines |
| Example: |
| {{{ |
| * list |
| * sublist |
| * subsublist |
| }}} |
|
| ==== Indentation with other characters ==== |
| At line 70 added 8 lines |
| Example: |
| {{{ |
| * list |
| .* sublist |
| ..* subsublist |
| }}} |
|
| ==== Changing bullet character ==== |
| At line 79 added 6 lines |
| Example: |
| {{{ |
| * list |
| + sublist |
| - subsublist |
| }}} |
| At line 57 removed 5 lines |
| * Explicit, parenthesis-like notation |
| * List must begin with first-level item |
| * List ends with non-list line |
| * List ends with un-indent |
| * List ends with empty line |
| At line 88 added one line |
| ==== Explicit, parenthesis-like notation ==== |
| At line 91 added one line |
| ==== List must begin with first-level item ==== |
| At line 94 added one line |
| ==== List ends with non-list line ==== |
| At line 97 added one line |
| ==== List ends with un-indent ==== |
| At line 100 added one line |
| ==== List ends with empty line ==== |
| At line 74 changed 2 lines |
| * Ignore conflicts |
| * Conflicts create new nesting level |
| It is possible to include several list items of different kinds on the same nesting level -- but this usually cannot be rendered (and even if it could, the semantics and aesthetics are disputable). Therefore the wiki needs to handle these conflicts. |
| At line 77 changed one line |
| It is possible to include several list items of different kinds on the same nesting level -- but this usually cannot be rendered (and even if it could, the semantics and aesthetics are disputable). Therefore the wiki needs to handle these conflicts. One way is to ignore the kind of any item that doesn't start a (sub)list -- this way a lone numbered list item in a bullet list would be considered a normal bullet list item. This is usually not what the user meant, though. |
| ==== Ignore conflicts ==== |
| One way is to ignore the kind of any item that doesn't start a (sub)list -- this way a lone numbered list item in a bullet list would be considered a normal bullet list item. This is usually not what the user meant, though. |
| At line 109 added one line |
| ==== Conflicts create new nesting level ==== |
| At line 112 added 3 lines |
| ==== Don't treat as list item ==== |
| There is also an option to just leave there any text that doesn't fit, hoping that the user will notice the error and correct it. |
|
| At line 82 removed 5 lines |
| * Don't treat as list item |
| * Only use the maximum number of list characters |
| * Use all list characters but limit the level |
| * Introduce empty lists |
| * Disregard ordering of nesting levels |
| At line 117 added one line |
| ==== Don't treat as list item ==== |
| At line 120 added one line |
| ==== Only use the maximum number of list characters ==== |
| At line 123 added one line |
| ==== Use all list characters but limit the level ==== |
| At line 126 added one line |
| ==== Introduce empty lists ==== |
| At line 129 added one line |
| ==== Disregard ordering of nesting levels ==== |
| At line 99 changed 4 lines |
| * Escape list markup |
| * Escape list characters |
| * Disappearing markup |
|
| ==== Escape list markup ==== |
| At line 136 added one line |
| ==== Escape list characters ==== |
| At line 107 changed one line |
| Finally one can introduce some markup that is not rendered to "break" the list markup -- something like C2:SixSingleQuotes or, in case of Creole, {{{{{{~}}}}}}. This disables list markup nicely but is counter-intuitive and ugly. |
| ==== Disappearing markup ==== |
| Finally one can introduce some markup that is not rendered to "break" the list markup -- something like C2:SixSingleQuotes or, in case of Creole, {{{{{{~}}}}}} or {{{****}}} or {{{////}}}. This disables list markup nicely but is counter-intuitive and ugly. |
.