Troubleshooting Books
When you work with books, you may encounter problems or errors you need to correct so that the book will be generated and updated properly.
-
If the generated file is empty, make sure that the name of the generated file in the book window has this icon () (Figure 13.75). If it does not, the file was added to the book as a document file rather than generated. Select the file in the book window and choose Edit > Delete File from Book. Make sure that the file has the correct default name, add a generated filename to the book, and then update the book. The update should generate a new file and pick up formatting from the nongenerated (bad) file.
Figure 13.75 The book has two generated files.
-
If one or more chapters start on the wrong side, select the document in a book window, choose Format > Page Layout > Pagination, and correct the pagination.
The Book Error Log reports all errors that occur when you perform book tasks (Figure 13.76). Click a link in the Book Error Log to display the problem document.
Figure 13.76 In the Book Error Log, you can click a link to display the problem document.
Understanding book error messages
Here are some of the messages you might see in the Book Error Log and explanations. The following errors will not stop a book from generating.
Unresolved cross-referencesSearch for unresolved cross-references in the problem document and resolve them.
Conditional text settingsThe file has conditional text settings that differ from those of the previous file in the book. To make settings consistent, make the settings in one file correct, and then import them into the book.
Inconsistent color settingsThe file has color definitions or color separation settings that differ from those in the previous file in the book. To make settings consistent, make the settings in one file correct and then import them into the book. At the same time, you may have to delete unused color definitions.
The following error will stop a book from generating and can be one of the most frustrating messages to receive. If you can't open even one file in a book, you can't print the book and you can't create a PDF file.
Couldn't open file
Open the individual file with the errorthe alert message that appears tells you why the file can't be opened (Figure 13.77). The most common cause of this issue is unavailable fonts, especially if you're moving files across platforms (see page 359).
Figure 13.77 This warning about unavailable fonts is common, especially if you're moving files across platforms.
Tips
When you are doing final production on a book, you may want to be more selective about what you update. For example, if you've done some touch-up on the TOC, you may want to exclude it from being generated when you perform a final update of the index (Figure 13.78).
Figure 13.78 You can generate the index without generating the TOC.
To find out what conditions are being used in a document, try to delete them one at a time. Choose Special > Conditional Text, and in the Conditional Text window, select a condition and click Edit Condition Tag. In the Edit Condition Tag dialog box, click Delete. If the Delete Condition Tag dialog box (Figure 13.79) appears, you know the condition is used somewhere in the document. Click Cancel to abort the deletion.
Figure 13.79 If this dialog box appears when you try to delete a condition, you know that the condition is used somewhere in the document.