1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
|
<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>
|
