We will now create a list. Two types of lists exist, which you can create with the "Unordered list" and "Ordered list" buttons in the tool-bar of the content-editor:
Figure 1.3.19. List buttons
To create a new list, first create a new paragraph at the position where you want to insert the list and then click the "Unordered list" or "Ordered list" button. The paragraph is then transformed to a list element:
Figure 1.3.20. Creating a list - step 1
The indention width and the spacing of the list items can be configured in the output-configuration (see Section 1.8.2, “Output configurations”
in this tutorial). This means, when you later on want to change the amount of spacing, you do not have to touch the content, but you can just change the output configuration and the new spacing will automatically be applied to the complete documentation.
You can now type in the text for the list items. Pressing enter creates a new list item:
Figure 1.3.21. Creating a list - step 2
You can transform a list item back to a normal paragraph, by clicking the "Unordered list" or "Ordered list" button again (you will notice, that most of the style operations can be undone by clicking the corresponding button again).
To change the marker symbol or the numbering type of an unordered or ordered list, select the desired entry from the button's drop-down list:
Figure 1.3.22. Selecting the list type of ordered and unordered lists
You can also create nested lists. To create a nested list, place the cursor on the list item and click the "Indent" (
) or "Outdent" (
) button to increase or decrease the nesting level (see screenshot below).
Figure 1.3.23. Creating a nested list
Sometimes you have to create a list which is a continuation of a previous list. Note that it's not possible to create a list item which contains several paragraphs or other block elements, because pressing enter creates a new list item but not a new paragraph within the list item. As a solution you have to create two separate lists and place the block elements in between. In the following example, an indented paragraph is placed between two lists, though for the reader it seems to be only one list, where the first list item consists of two paragraphs:
- First list item.
Second paragraph of first list item. This is an indented paragraph.
- First list item of continued list.
When you try to create such a continued list, you will notice that the numbering of the second list starts again with 1 (because it's a new list), as shown in the following screenshot:
Figure 1.3.24. Creating a continued list - step 1
The continued list should start with 2 instead of 1. To change the starting number of an ordered list, proceed as follows:
- Place the cursor at the first list item of the list.
- Click the "Insert/Edit Attributes" icon (). This opens the following dialog:
Figure 1.3.25. Setting the start value of an ordered list
- Enter the list item start value (see red arrow in the screenshot above) and close the dialog by clicking "Insert".
The list is then continued with the entered start value:
Figure 1.3.26. Creating a continued list - step 2
To switch back to the default numbering, open the "Insert/Edit Attributes" dialog and delete the list item start value.