parent nodes: DemoTextFormatting

Demo Text Lists

Contents:
Demo Text Lists
General
Unordered lists
General
Auto list
Indentation adjustment
Caution!!
Ordered lists
General
Auto list
Indentation adjustment
Mixed lists
Remarks
Todo's
Results

Back

General

Wikidpad allows the use of single- and multilevel lists; in principle these are: There is also a third (hidden) list, that is used in Wikidpad to support indentation; see Textformatting: Basics

Top

Unordered lists

General

An unordered list is a bulleted list. To create items for such a list, start with an empty line and type: a tab, an asterisk and a space and then type the text of the list item; so " * item text" will result in: Compare the results in both editor and preview.

A multilevel list can be created, using indentation; like this: The level of a list item is defined by it's indentation; i.e. the number of tabs in front of it.

Auto list

To add a second item to a list, put the cursor at the end of a list item (if it isn't already there) and press Enter; so " * item text" followed by an Enter will result in: A new list item will be created on the next line and all that has to be done, is to type the item text. This mechanism also supports multi level lists and will indent a new item in accordance with that of the preceding item. To end the auto listing, do the same, but press Enter twice.

This automatic creation of list items is called auto-bulleting. It can be switched on and of using the option: menu / Editor / Settings / Auto-bullets.
The automatic ending of a list can also be switched on and of with the option: menu / Wiki / Options / Editor /Auto-unbullets.

Indentation adjustment

The indentation of two or more consecutive list items, and with it their list level, can be increased by selecting them and pressing Tab. To reduce indentation, press Shift+Tab instead. So selecting items 2 and 3 in the list below and pressing tab, wil result in: See in preview how this not only influences the indentation, but also the type of bullets used. Tabs can of course also be added or removed manually.

Caution!!

Due to some misconduct of the Wikidpad parsing and conversion mechanism, it also interpretes lines starting with an asterisk followed by a space, but with nó tab in front of it, as a bulleted list. In this case however it will indent any and all lines on the rest of the page and there is no way, to end that. To see the result, remove the backslashes in front of the "list items" below and swicth (back) to preview.

* Part
* of list

So be sure to indent any bulleted lists, to prevent this problem from occurring.

Top

Ordered lists

General

An ordered list is a numbered list. To create such a list, start with an empty line and type: a tab, any digit or number, a period and a space and then type the text of the list item; so " 1. item text" will result in:
  1. Item text
The numbers of the list items can be any number, they don't have to be consecutive and the list may countain doubles. For html preview and export this makes no difference; the list is transformed into an html "ordered list" element ("<ol>"), that will number the list consecutive, starting with one, no matter whát it's definition is in the editor. Compare the list below in both editor and preview:
  1. item 100
  2. item 25
  3. item 36
  4. item 25
  5. item 2
Wikidpad supports hierarchical ordered lists, like these:
  1. item 1
    1. item 1.1
      1. item 1.1.1
    1. item 1.2
  2. item 2
Use indentation to control the levels of the items. Next to single numbers in combination with indentation, also hierarchical numbers of the type 15.4.3. can be used to define a leveled list; see the following list as an example:
  1. item 1
    1. item 1.1
      1. item 1.1.1
    2. item 1.2
  2. item 2
Wikidpad shóuld control the levels correctly, but evidently it doesn't. If there is no level indentation (tabs) used in the list definition or if it is not done correctly, the list will not turn out as it should. It shóuld turn out exactly like the general example for the hierarchical ordered list.

Auto list

The editor supports auto-bulleting for ordered lists, the same way it does for unordered lists and it is controled by the same options. As an extra the editor will also auto-number any next item, that is added to the list; so " 1. item text", followed by an Enter, will result in:
  1. Item text
This will only number a newly added or inserted item relative to the preceding item in the list; it will nót renumber the entire list, when an item is inserted somewhere in the middel of the list. This works both for single level lists ánd for multi level hierarchical lists; pressing Enter at the end of item 1.1.1 will result in:
  1. item 1
    1. item 1.1
      1. item 1.1.1

    1. item 1.2
  2. item 2
The editor also supports auto-numbering of hierarchical numbers: so " 15.4.3. item text", followed by an Enter will result in:
      1. Item text 15.4.3


with the correct level of indentation; compare it with the leveled list above.

Indentation adjustment

The indentation and therefore the numbering level can be changed the same way as for unordered lists. So selecting items 2 and 3 in the list below
  1. item 1
  2. item 2
  3. item 3
  4. item 4
and pressing tab, wil result in:
  1. item 1
    1. item 2
    1. item 3
  2. item 4
See in preview how this not only influences the indentation, but also the numbering of the items.

Top

Mixed lists

The ordered and unordered list types can be be mixed freely into one list; example:
  1. Project 1
    1. Assess feasibility request
      • Analyse request
      • Research html requirements
        1. Check xhtml possibilities and restrictions
        1. Check css possibilities and restrictions
        1. Check restrictions of internal previewer
      • Assess syntax requirements
    1. Todo: research possibilities Wikidpad
      • Research editor
      • Research parser
      • Research converter
        • Preview converter
        • Export converter
    1. Implement request
      • Design solution
      • Program solution
      • Test solution
      • Implement solution
  2. Project 2
  3. Project n


Top

Remarks

Top

Todo's

todo.demo.projectdemo.demo2: check out all posibilities

action.demo.development: Check out indentation not being stopped when ending a list (lonely bullet + Enter)
action.demo.development: Check out indentation of hierarchical numbers not being reset to their correct level; going from 2.1 to 2
action.demo.development: Check out empty line not being seen as "end of list" indicators, which it shóuld!

Top

Results

issue.demo.new: Wikidpad does not adjust item and indentation level correctly, when using hierarchical numbers.

[demo.status.waiting: issues]
Top
previous: Back
parents:  DemoTextFormatting