<sect1 id="toc"><title>Table of Contents</title> <para>When writing a large document, it is useful to include a table of contents. This can be done automatically with &kword;.</para> <para>To begin creating a table of contents &kword; needs to know what to include in the table of contents. The first part of this chapter describes how to prepare the document to generate an accurate table of contents.</para> <para>The second part of this section, discusses the actual generation and updating of the table of contents.</para> <para>The final part of this section provides pointers on changing the look of the table of contents.</para> <sect2 id="toc-prepare"><title>Preparing the document</title> <para>&kword; uses a style-based method of creating table of contents entries.</para> <para>For more information on styles, see the <link linkend="styles">Styles</link> section of this documentation.</para> <para>To mark each level of the document, use the paragraph styles <guilabel>Head 1</guilabel>, <guilabel>Head 2</guilabel> and <guilabel>Head 3</guilabel>.</para> <para>Major subjects should be marked with the <guilabel>Head 1</guilabel> style. </para> <para>Sub-headings under the <guilabel>Head 1</guilabel> subjects should be marked with <guilabel>Head 2</guilabel>.</para> <para>Sub-headings under the <guilabel>Head 2</guilabel> subject headings should be marked with <guilabel>Head 3</guilabel></para> <para>Once this is done, proceed to the next section.</para> </sect2> <sect2 id="toc-create"><title>Creating the table of contents</title> <para>To create the table of contents is easy. Simply place the cursor in a text frame where the table of contents should be inserted.</para> <para>Select <menuchoice> <guimenu>Insert</guimenu><guimenuitem>Table of Contents</guimenuitem></menuchoice> from the menubar.</para> <para>&kword; locates all entries labled with the appropriate paragraph styles, and their corresponding page numbers. It assembles this into the table of contents.</para> <note><para>Once the table of contents is created, it will remain unchanged until &kword; is instructed to update it.</para> <para>To update the table of contents, click once with the &LMB; in the current table of contents. Then select <menuchoice> <guimenu>Insert</guimenu><guimenuitem>Update table of contents</guimenuitem></menuchoice> from the menubar.</para> <para>&kword; will replace the old table of contents with a newly updated one.</para></note> </sect2> <sect2 id="toc-style"><title>Changing the look of the table of contents.</title> <para>The look of the table of contents is also adjusted by using the paragraph styles in &kword;.</para> <para>The table of contents title is formated with the <guilabel>Contents Title</guilabel> paragraph style. All major subject headings (those marked with the <guilabel>Head 1</guilabel> style), are now formatted using <guilabel>Contents Head 1</guilabel> paragraph style. All sub-headings (those marked with the <guilabel>Head 2</guilabel> style), are now formatted using <guilabel>Contents Head 2</guilabel> paragraph style. Finally, All sub-headings (those marked with the <guilabel>Head 3</guilabel> style), are now formatted using <guilabel>Contents Head 3</guilabel> paragraph style. </para> <para>By <link linkend="style-edit">changing the look</link> of those three styles, the appearance of the table of contents can be radically changed.</para> <para></para> </sect2> </sect1>