TOC Processing instructions in the book component metadata
re our chat about #63 (closed), we discussed two use cases for processing instructions in the metadata that affect the TOC.
1. Some book components should not be included in the TOC
Instead they are displayed in a sidebar on the Bookshelf site, as in "GeneReviews Links" section for the GeneReviews Book.
The rendering of the components is controlled by a processing instruction
<?hideTOC?> in the book component metadata.
We spoke about one way to handle this:
In the book manager page we have sections Front / Body / Back. There could be an additional section "Other", "Sidebar", or some other appropriate wording. Users would move the book component to this section. Book components in this section are excluded from the TOC preview and the toc.xml file Coko system creates. When these component are published, coko system does not need to send a toc.xml file.
2. Some book components should be included on the TOC in more than one part
For books that have parts, a book component may be listed in the TOC in more than one part. It should display in both places in the TOC preview and be included accordingly in the toc.xml file.
Both use case apply to books processed at the chapter level in all workflows:
- We need to support a way for the user to do in this the UI for Word books.
- @lathrops1 , since most PDF and XML books are submitted via FTP, would the Sys admin take this action in the UI? Or is it possible that this processing instruction can be included in the meta.xml file in the FTP submission?
Please provide example xml files for both cases.