Add options for book TOC to be parent and to specify other parent-child relationships in Wiki deployments
NOTE: Implemented in the ePublisher 2010.1 release.
EPUB221 Confluence - Allow specification of a parent page on deployment
Summary
We need the option to subsume all book pages in a Confluence Wiki deployment under a single page that represents the book (e.g., the TOC).
Detailed Description
The current WebWorks Wiki-Confluence target generates a TOC page that does retain parent/child relationships among higher-level and lower-level topics/files within a book (and reflects the TOC). That's all great.
But right now when you deploy to a space on the Wiki, all pages are deployed (a) at the same level as the Home page for the space, rather than as children of the Home page, and (b) pages in a book are not subsumed under (contained in) a single top-level parent page that represents the book as a collection of lower level pages. It doesn't seem like you have any option in WebWorks to deploy pages as children to a specified Home page. Nor do you have an option to subsume pages in a book under a parent page for the book.
So, we would like (a) the option to have pages deployed as children to the space Home page, and (b) to be subsumed under a single top-level parent page that represents the book.
This would let us deploy multiple books to a product page in a space, and manage and display them effectively in terms of organization and macros.
Use Cases
This would be useful in a number of ways:
(1) We could use a macro like {pagetree:root=@home\|searchBox=true} to display an expandable list of books w/their topics underneath each TOC. (Like they do on the left bar of the Confluence Docs site at: http://confluence.atlassian.com/display/DOC/Confluence+Documentation+Home) The way things are deployed via WebWorks right now, no topics automatically show up via this macro, because pages are not deployed as children of the Home page but rather at the same level. Also, because book topics aren't deployed as children to a high-level "book or TOC" page, if we did manually move pages to be children of the space Home page, every chapter page would show up on that left bar at the top level, rather than each book TOC.
(2) If we wanted to do a bulk move of pages, we could do that by simply moving the parent page for a book.
(3) The tree view would show an organized view of books and topics within each book. (Browse > Pages > Tree View would show a list of books, and the TOC relationship of topics within each book)