<sect1 id="lists"> <title>Lists</title> <para>&kword; has a simple and flexible list creation system. Using the same interface, &kword; can create bulleted or enumerated lists of nearly any depth. For easy, simple lists, &kword; offers a toolbar button for both enumerated and bulleted lists.</para> <para>An enumerating style is a series of letters or numbers which proposes an order or hierarchy within the list. Bullets simply mark the item as part of the list and usually consist of a symbol or shape.</para> <sect2 id="list-simpl"><title>Simple lists</title> <para>To quickly create a single level list, &kword; provides two toolbar buttons.</para> <para>To create a simple enumerated list, simply select <inlinemediaobject><imageobject><imagedata fileref="enumlist.png" format="PNG"/></imageobject></inlinemediaobject> from the <link linkend="paragraph-toolbar">paragraph toolbar</link>. A small menu will list different enumerated list styles. Select the appropriate style and the selected paragraphs are converted into a list of that style.</para> <para>To create a simple bulleted list, select <inlinemediaobject><imageobject><imagedata fileref="bullist.png" format="PNG"/></imageobject></inlinemediaobject> from the <link linkend="paragraph-toolbar">paragraph toolbar</link>. A small menu will list different bulleted list styles. Select the appropriate style and the selected paragraphs are converted into a bulleted list of that style.</para> <tip><para>You are still able to make changes to the list styles by <link linkend="list-complex">using the dialog</link>.</para></tip> </sect2> <sect2 id="list-complex"><title>Complex lists</title> <para>All complex list formatting is done through the Paragraph Formatting dialog. To get to the paragraph formatting dialog you can:</para> <itemizedlist> <listitem> <para>Select <menuchoice> <guimenu>Format</guimenu><guimenuitem>Paragraph...</guimenuitem></menuchoice> from the menubar</para> </listitem> <listitem><para>Type <keycombo action="simul">&Alt;&Ctrl;<keycap>P</keycap></keycombo></para></listitem> <listitem> <para>Place the mouse pointer in the paragraphs that will become the list and click once with the &RMB;. A small menu will appear. Select <guimenuitem>Paragraph...</guimenuitem>.</para> </listitem> </itemizedlist> <para>A dialog will appear. To find the tab specific to lists, click once on the tab labeled <guilabel>Bullets/Numbers</guilabel>.</para> <sect3 id="list-dialog"> <title>List type</title> <screenshot> <mediaobject> <imageobject><imagedata fileref="fpara4.png" format="PNG"/> </imageobject> </mediaobject> </screenshot> <para>To format the selected text as a list, select <guilabel>List</guilabel> from the top section of the dialog box.</para> <para>There is a list of five bullets types and five enumerating styles along the left side of the dialog box. Select the desired list style from the list on the left.</para> </sect3> <sect3 id="list-look"><title>Changing the look of the list</title> <para>The text box labeled <guilabel>Prefix Text</guilabel> allows the user to add text before the enumeration or bullet.</para> <para>The text box labeled <guilabel>Suffix Text</guilabel> allows the user to add text after the enumeration or bullet.</para> <para>For example: If <quote>Step</quote> is typed into the <guilabel>Prefix Text</guilabel> box, and <quote>-</quote> is typed into the <guilabel>Suffix Text</guilabel> text box, the list will look like this:</para> <informalexample><simplelist> <member>Step 1 - Place 1 cup of flour in a large mixing bowl.</member> <member>Step 2 - Add 1/4 tablespoon of yeast.</member> <member>Step 3 - ....</member> </simplelist></informalexample> </sect3> <sect3 id="list-count"><title>Changing the start point of the list</title> <para>If an enumerated list style is selected, the starting number/letter for the list can be set in the spin box labeled <guilabel>Start at</guilabel>. If you have selected a bulleted list style, this box will be inactive.</para> </sect3> <sect3 id="list-depth"><title>Multi-level lists</title> <para>The spin box labled <guilabel>Depth</guilabel> is used to add subsections to your list. By selecting a depth greater than one, you are adding a subsection to the list. </para> <para>Example of a multilevel enumerated list:</para> <screenshot> <mediaobject> <imageobject><imagedata fileref="listdepth1.png" format="PNG"/> </imageobject> </mediaobject> </screenshot> <para>An example of a multilevel bulleted list:</para> <screenshot> <mediaobject> <imageobject><imagedata fileref="listdepth2.png" format="PNG"/> </imageobject> </mediaobject> </screenshot> <para>Adjust the depth setting and watch the preview section of the dialog for an example of how this will look.</para> </sect3> <sect3 id="lists-custom-bullets"><title>Custom Bullets</title> <para>If you select <guilabel>Custom Bullet</guilabel> from the list of styles, you can click on the button labeled <guilabel>Custom Character</guilabel> to choose the letter or symbol you want for your bulleted list.</para> </sect3> <sect3 id="lists-multiline"><title> Multiple paragraphs in one list element</title> <para>Each new paragraph represents a new list element. Sometimes, however, it will be desireable to have multiple paragraphs on a single list element. This is accomplished by inserting a New Line character instead of a Paragraph Break.</para> <para>To insert a New Line, type <keycombo action="simul">&Shift;<keycap>Return</keycap></keycombo>.</para> <screenshot> <mediaobject> <imageobject><imagedata fileref="listdepth3.png" format="PNG"/> </imageobject> </mediaobject> </screenshot> </sect3> </sect2> </sect1>