3
<indexterm><primary>lists</primary></indexterm>
5
<para>&kword; has a simple and flexible list creation system.
6
Using the same interface, &kword; can create bulleted or enumerated lists of nearly any depth.
7
For easy, simple lists, &kword; offers
8
a toolbar button for both enumerated and bulleted lists.</para>
10
<para>An enumerating style is a series of letters or
11
numbers which proposes an order or hierarchy within the list. Bullets
12
simply mark the item as part of the list and usually consist of a symbol or shape.</para>
14
<sect2 id="list-simpl"><title>Simple lists</title>
16
<para>To quickly create a single level list, &kword; provides two toolbar buttons.</para>
17
<para>To create a simple enumerated list, simply select <inlinemediaobject><imageobject><imagedata
18
fileref="enumlist.png" format="PNG"/></imageobject></inlinemediaobject> from the
19
<link linkend="paragraph-toolbar">paragraph toolbar</link>.
20
A small menu will list different enumerated list styles. Select the appropriate style and the selected
21
paragraphs are converted into a list of that style.</para>
22
<para>To create a simple bulleted list, select <inlinemediaobject><imageobject><imagedata
23
fileref="bullist.png" format="PNG"/></imageobject></inlinemediaobject> from the
24
<link linkend="paragraph-toolbar">paragraph toolbar</link>.
25
A small menu will list different bulleted list styles. Select the appropriate style and the selected
26
paragraphs are converted into a bulleted list of that style.</para>
27
<tip><para>You are still able to make changes to the list styles by <link linkend="list-complex">using the dialog</link>.</para></tip>
30
<sect2 id="list-complex"><title>Complex lists</title>
31
<para>All complex list formatting is done through the Paragraph Formatting dialog. To get to the paragraph formatting dialog you can:</para>
35
<para>Select <menuchoice>
36
<guimenu>Format</guimenu><guimenuitem>Paragraph...</guimenuitem></menuchoice>
37
from the menubar</para>
40
<listitem><para>Type <keycombo action="simul">&Alt;&Ctrl;<keycap>P</keycap></keycombo></para></listitem>
43
<para>Place the mouse pointer in the paragraphs that will become the list and click once
44
with the &RMB;. A small menu
45
will appear. Select <guimenuitem>Paragraph...</guimenuitem>.</para>
49
<para>A dialog will appear. To find the tab specific to lists, click once on the tab labeled <guilabel>Bullets/Numbers</guilabel>.</para>
51
<sect3 id="list-dialog">
52
<title>List type</title>
55
<imageobject><imagedata fileref="fpara4.png" format="PNG"/>
60
<para>To format the selected text as a list, select <guilabel>List</guilabel> from the top section of the dialog box.</para>
62
<para>There is a list of five bullets types and five enumerating styles along the left
63
side of the dialog box. Select the desired list style from the list on the left.</para>
65
<sect3 id="list-look"><title>Changing the look of the list</title>
67
<para>The text box labeled <guilabel>Prefix Text</guilabel> allows the user to add text before
68
the enumeration or bullet.</para>
70
<para>The text box labeled <guilabel>Suffix Text</guilabel> allows the user to add text after
71
the enumeration or bullet.</para>
73
<para>For example: If <quote>Step</quote> is typed into the <guilabel>Prefix Text</guilabel>
74
box, and <quote>-</quote> is typed into the <guilabel>Suffix Text</guilabel> text box, the list will look like this:</para>
76
<informalexample><simplelist>
77
<member>Step 1 - Place 1 cup of flour in a large mixing bowl.</member>
78
<member>Step 2 - Add 1/4 tablespoon of yeast.</member>
79
<member>Step 3 - ....</member>
80
</simplelist></informalexample>
82
<sect3 id="list-count"><title>Changing the start point of the list</title>
84
<para>If an enumerated list style is selected, the starting number/letter for the list can be set in the spin box
85
labeled <guilabel>Start at</guilabel>. If you have selected a bulleted list style, this box will be inactive.</para>
87
<sect3 id="list-depth"><title>Multi-level lists</title>
89
<para>The spin box labled <guilabel>Depth</guilabel> is used to add subsections to your list. By selecting a depth greater than one,
90
you are adding a subsection to the list. </para>
92
<para>Example of a multilevel enumerated list:</para>
96
<imageobject><imagedata fileref="listdepth1.png" format="PNG"/>
101
<para>An example of a multilevel bulleted list:</para>
105
<imageobject><imagedata fileref="listdepth2.png" format="PNG"/>
110
<para>Adjust the depth setting and watch the preview section of the dialog for an example of how
111
this will look.</para>
114
<sect3 id="lists-custom-bullets"><title>Custom Bullets</title>
115
<para>If you select <guilabel>Custom Bullet</guilabel> from the list of styles, you can click on the button labeled
116
<guilabel>Custom Character</guilabel> to choose the letter or symbol you want for your bulleted list.</para>
118
<sect3 id="lists-multiline"><title> Multiple paragraphs in one list element</title>
119
<para>Each new paragraph represents a new list element. Sometimes, however, it will be desireable to have multiple
120
paragraphs on a single list element. This is accomplished by inserting a New Line character instead of a Paragraph Break.</para>
122
<para>To insert a New Line, type <keycombo action="simul">&Shift;<keycap>Return</keycap></keycombo>.</para>
126
<imageobject><imagedata fileref="listdepth3.png" format="PNG"/>