[publican-list] Proposed changes to Book_Info.xml

Jeff Fearn jfearn at redhat.com
Tue Aug 5 07:22:56 UTC 2008


A bug has been raised about how the titles currently differ between the HTML and PDF outputs, this has lead to a review to the way the Book_Info.xml files are structured.

https://bugzilla.redhat.com/show_bug.cgi?id=456497

Currently the usage is:

title: the name of the Product the book is about.
subtitle: the actual title of the book.
issuenum: the version of the Product the book is about.
productnumber: the release of the book for this Product version.

This is somewhat confusing and I'd like to change it to:

productname: the name of the product this book is about.
productnumber: the version of the product this book is about.
pubsnumber: the release of this book for this products version. (Only used for rpm)
title: the title of this book.
subtitle: a secondary title for this book.

This would then lead to a restructuring of the way the titles are displayed.

The cover page display would be:

Top of page centered, font size 2em, colored block: ProductName ProductVersion
Below that block, centered, font size 2em: BookTitle
Below that, centered, font size 1.8em: BookSubTitle

The centering is because the current layout makes it hard to separate the titles from the content, this small changes highlights the titles and brings the HTML and PDF in to alignment.

No feedback means I am right and should proceed however I want :D

Cheers, Jeff.

-- 
Jeff Fearn <jfearn at redhat.com>
Software Engineer
Engineering Operations
Red Hat, Inc




More information about the publican-list mailing list