doc:lists

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
doc:lists [2026/03/31 14:13] – [Using the toolbar] Simon Grantdoc:lists [2026/08/03 10:12] (current) – [Using the toolbar] Simon Grant
Line 11: Line 11:
 {{list-icons.png}} {{list-icons.png}}
  
-The one on the left has numbers; the one on the right has dots. However, because of the Markdown plugin, both of these actually give you an unordered, bulleted list. So, least confusing to use the one on the right, when\\+The one on the left has numbers; the one on the right has dots. The simplest one to use is the one on the right, when\\
 `  * Unordered List Item` appears, with the two blank spaces before it. The text is highlighted already, so just type what you want to appear as the item. `  * Unordered List Item` appears, with the two blank spaces before it. The text is highlighted already, so just type what you want to appear as the item.
  
-A nice feature of the DokuWiki editor is that if you are at the end of a list item line, and press the 'return' key, it gives you the start of a new list item of the same kind at the same level. Press return again if you don't want that, and it goes away, adding blank lines so DokuWiki knows you have finished the list. With no blank line, the text is simply appended to the list item.+A nice feature of the DokuWiki editor is that if you are at the end of a list item line, and press the 'return' key, it gives you the start of a new list item of the same kind at the same level. Press return again if you don't want that, and it goes away, adding blank lines so DokuWiki knows you have finished the list. With no blank line, the text is simply appended to the last list item.
  
-For ordered lists, on a new blank line, pressing the other icon gives `  - Ordered List Item`:+/* 
 +For ordered lists, on a new blank line, pressing the other icon on the left gives `  - Ordered List Item`:
 ``` ```
   - Ordered List Item   - Ordered List Item
Line 22: Line 23:
   - another   - another
 ``` ```
-giving:+which gives:
   - Ordered List Item   - Ordered List Item
   - another   - another
   - another   - another
  
-Make sure you do //**not**// have a blank line before the ordered list starts.+ 
 + 
 +Make sure you do **not** have a blank line before the ordered list starts. If you do, it interprets it following Markdown syntax. 
 +*/ 
 + 
 +For the time being, the only ordered list method that works is using Markdown syntax. 
  
  
Line 43: Line 50:
  
 gives you this, in proper DokuWiki style: gives you this, in proper DokuWiki style:
- +  * unordered List Item  
-  * unordered List Item+
   * two spaces before is the norm for DokuWiki list items   * two spaces before is the norm for DokuWiki list items
     * a sub-item     * a sub-item
Line 67: Line 73:
  
 ==== Ordered lists ==== ==== Ordered lists ====
 +FIXME: ordered lists currently don't work with DokuWiki syntax, because it is overridden by Markdown syntax.
 ``` ```
 To get ordered lists to work with DokuWiki syntax: To get ordered lists to work with DokuWiki syntax:
Line 92: Line 99:
 For an unordered (bulleted) list in Markdown, just start a line with `-` or `*`. Indent, as shown above, to create sub-items. Another **very important point** for Markdown list to work, they need a blank link before them. For an unordered (bulleted) list in Markdown, just start a line with `-` or `*`. Indent, as shown above, to create sub-items. Another **very important point** for Markdown list to work, they need a blank link before them.
  
-For ordered (numbered) lists, you can use numbers — this comes out exactly as expected:+For ordered (numbered) lists, you can use numbers and no spaces on the left — this comes out exactly as expected:
 ``` ```
 1. the first point 1. the first point
Line 101: Line 108:
 2. the second point 2. the second point
  
-The interesting quirk of Markdown list syntax is that the numbers you use are ignored for the display. Look what happens when you type this:+The interesting quirk of Markdown list syntax is that the numbers you use are ignored for the display, except the first number in the list. Look what happens when you type this:
  
 ``` ```
-2. even if you number the first point '2' it is displayed as '1' +2. now, if you put the first point as '2' it is displayed as '2' 
-1. and even if you go backwards, the display moves forward +1. but if you go backwards, the display moves forward 
-  8. indent, and you get a sub-list, probably with letters instead of numbers+  1. indent, and you get a sub-list, probably with letters instead of numbers
 10. and even if you use two-digit numbers, they are just more numbers. 10. and even if you use two-digit numbers, they are just more numbers.
 ``` ```
  
-2. even if you number the first point '2' it is displayed as '1' +2. now, if you put the first point as '2' it is displayed as '2' 
-1. and even if you go backwards, the display moves forward +1. but if you go backwards, the display moves forward 
-  8. indent, and you get a sub-list, probably with letters instead of numbers+  1. indent, and you get a sub-list, probably with letters instead of numbers
 10. and even if you use two-digit numbers, they are just more numbers. 10. and even if you use two-digit numbers, they are just more numbers.
  
  • doc/lists.1774966430.txt.gz
  • Last modified: 2026/08/18 23:39
  • (external edit)