Bug 804917 - Please make Book_Info.xml and Revision_History.xml optional
Summary: Please make Book_Info.xml and Revision_History.xml optional
Alias: None
Product: Publican
Classification: Community
Component: publican
Version: 3.0
Hardware: All
OS: All
Target Milestone: 3.0
Assignee: Jeff Fearn 🐞
QA Contact: Misty Stanley-Jones
Depends On:
Blocks: 820023
TreeView+ depends on / blocked
Reported: 2012-03-20 07:32 UTC by Raphaël Hertzog
Modified: 2014-06-18 07:04 UTC (History)
3 users (show)

Fixed In Version: 3.0.0
Doc Type: Bug Fix
Doc Text:
Clone Of:
Last Closed: 2012-10-31 03:11:00 UTC

Attachments (Terms of Use)

Description Raphaël Hertzog 2012-03-20 07:32:10 UTC
It would be nice if publican could do without Book_Info.xml and Revision_History.xml. The former would then be merged in the main XML document and the latter would simply not exist.

This would make it easier to use publican to generate documentation out of a random docbook file. It would also make it easier to convert an existing document to Publican.

(Bug filed as per request in <4F682EDE.5060403> on the list)

Comment 1 Jeff Fearn 🐞 2012-06-24 08:50:01 UTC
Added info_file parameter to allow overriding where to look for info fields.

Added rev_file parameter to allow overriding where to look for revision history.

Both fields go in the Publican cfg file and need the full name of the file without the path. .e.g. "test.xml" not "en-US/test.xml" not "test".

For books that don't contain a revision history at all, the new add_revision action is a quick way of getting a structure Publican will be happy with, you don't have to xi:include the new file for Publican to use it.

To ssh://git.fedorahosted.org/git/publican.git
   a8b827b..bcedf1e  master -> master

Comment 2 Misty Stanley-Jones 2012-06-29 05:17:54 UTC
Test method:

1. Create new book
2. Copy XML from Revision_History.xml to the appropriate part of my test book's main XML file (starting from <appendix> and ending with </appendix>)
3. Add the following to publican.cfg: rev_file: <bookname>.xml
4. Remove Revision_History.xml and its xi:include from the book's main XML file
5. Build the book

Result: Success

Similar test for info_file: Success

I'm happy to verify this.

Note You need to log in before you can comment on or make changes to this bug.