[publican-list] Oddities with draft settings

Jeff Fearn jfearn at redhat.com
Tue Oct 28 07:12:41 UTC 2008


Hi ho, I have been taking a look at drafting due to https://bugzilla.redhat.com/show_bug.cgi?id=468305 and there is some crazy stuff happening in the default DocBook XSL.

In HTML you can only get the draft image in the background in the root node for the current page and everything on that page is marked as draft.

In html-single you have to set status to draft in the book and everything in the book is marked.

In html the node it will take affect in depends on whether on not that block is on it's own page.

In PDF you can only set draft at book or chapter levels.

I've had a look at the XSL and it's possible to get the HTML outputs to behave as you'd expect, switch ON at the book/chapter/section level regardless of it's position on the page. However the PDF is a different story, it may not be possible to imitate this behaviour without rewriting a large quantity of the default XSL.

How should we handle this? I'm tempted to leave the PDF in it's current state and make the HTML outputs work properly. While this would make drafting with the PDF less manageable than drafting with the HTML, it will mean drafting gets fixed in the HTML a lot sooner.

Also I have been asked to add other status' to allow documentation to be marked as beta/alpha/RC etc, this is easy in the HTML but requires the same rewrite as for the beta status in the PDF.

All comments welcome.

Cheers, Jeff.

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




More information about the publican-list mailing list