You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
68 lines
4.0 KiB
68 lines
4.0 KiB
<sect1 id="toc">
|
|
<sect1info>
|
|
<authorgroup>
|
|
<author>
|
|
<firstname>Mike</firstname>
|
|
<surname>McBride</surname>
|
|
</author>
|
|
<!-- TRANS:ROLES_OF_TRANSLATORS -->
|
|
</authorgroup>
|
|
</sect1info>
|
|
<title>Table of Contents</title>
|
|
<indexterm><primary>table of contents</primary><secondary>introduction</secondary></indexterm>
|
|
|
|
<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>
|
|
<indexterm><primary>table of contents</primary><secondary>preparing document for</secondary></indexterm>
|
|
|
|
<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>
|
|
<indexterm><primary>table of contents</primary><secondary>creating</secondary></indexterm>
|
|
<indexterm><primary>table of contents</primary><secondary>updating</secondary></indexterm>
|
|
|
|
<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 labeled 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>
|
|
<indexterm><primary>table of contents</primary><secondary>formatting</secondary></indexterm>
|
|
|
|
<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>
|
|
|
|
</sect2>
|
|
</sect1>
|
|
|