Contents | Start | End | Previous: KB0230: Why is the author filled in with my user name in new projects? | Next: KB0232: Why is the page break in the previous paragraph repeated when I press return?


KB0231: Why does Jutoh complain about an automatic table of contents when compiling for ODT?

See also:
Building a table of contents in the Jutoh manual
Why is a chapter replaced by a table of contents in ODT export?

When compiling an OpenDocument (ODT) configuration, you may get this message:

TIP (Jutoh): consider creating an advanced table of contents to add a better TOC page.

When you don't have a table of contents in your project, Jutoh can create a simple one based on the titles of your chapters - this happens automatically when the ebook is generated.

However, you may get better results if you create an advanced table of contents - one that appears in your project, and is gathered from the headings in your book. The advantages of doing this include:

  1. you can position the TOC anywhere in your project by dragging it in the project outline;

  2. you can create a multi-level TOC;

  3. you can assign a page style to the TOC, for custom headers and footers;

  4. you can get Jutoh to replace the TOC with a special, ODT-specific TOC that includes page numbers (see below).

To create an advanced TOC, use the menu command Format | Book | Build Table of Contents to show the wizard that will take you through the steps to create an advanced table of contents.

When compiling the ODT file, Jutoh may replace this TOC page with special OpenDocument-specific code that generates the TOC dynamically if you're using OpenOffice or LibreOffice. The advantage of this is that if you decide to continue editing the ODT document in OpenOffice or LibreOffice, the TOC will magically update based on the heading styles based in the document. Also, the TOC will display page numbers, which is useful for an ODT or PDF file. On the other hand, other word processors may not recognise the special TOC code. If you'd rather just use the TOC exactly as it appears in the Jutoh project, then turn off the configuration option Special table of contents formatting.

To turn off the automatic TOC, clear the configuration option Generate table of contents.


Contents | Start | End | Previous: KB0230: Why is the author filled in with my user name in new projects? | Next: KB0232: Why is the page break in the previous paragraph repeated when I press return?