Bug 804917

Summary:	Please make Book_Info.xml and Revision_History.xml optional
Product:	[Community] Publican	Reporter:	Raphaël Hertzog <raphael>
Component:	publican	Assignee:	Jeff Fearn 🐞 <jfearn>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Misty Stanley-Jones <misty>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	3.0	CC:	lcarlon, misty, rlandman+disabled
Target Milestone:	3.0
Target Release:	---
Hardware:	All
OS:	All
Whiteboard:
Fixed In Version:	3.0.0	Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2012-10-31 03:11:00 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	820023

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.