RE: [docbook-apps] RE: Creating a separate section/component for Revision History

["Kerry, Richard" <richard.kerry@atos.net>]

Bob,

Thanks for reminding me about validity.
I've just tried validating and you are correct - it gets rejected, citing "section" not allowed as only certain component types are allowed (presumably after at least one appendix).

It is an article.

At the moment I am concentrating on PDF (via Fo,and using FOP), though I will also want some html versions.  The first Html format I will want is CHM.  Then eventually epub3 and WebHelp.

I shall change the source to make it valid. 
Then :
- look again at how to place the result in the final document.
- look into using the attribute sets you list to get the formatting improved.


Appreciatively.
Richard.
 



> -----Original Message-----
> From: Bob Stayton [mailto:bobs@sagehill.net] 
> Sent: 07 December 2012 20:03
> To: Kerry, Richard; docbook-apps@lists.oasis-open.org
> Subject: Re: [docbook-apps] RE: Creating a separate 
> section/component for Revision History
> 
> 
> I don't think putting a section after an appendix is valid 
> DocBook, for 
> either book or article.  The stylesheet does not take the 
> time to validate 
> the input, but they are written on the assumption that the 
> content is valid. 
> Because they are template driven, invalid content may work, 
> but it is risky.
> 
> Is this a book or an article document?
> 
> Also, is this for print or html output?
> 
> For print output, there are three attribute-sets that can be 
> customized for 
> your purposes:
> 
> revhistory.table.properties
> revhistory.title.properties
> revhistory.table.cell.properties
> 
> Bob Stayton
> Sagehill Enterprises
> bobs@sagehill.net
> 
> 
> From: Kerry, Richard
> Sent: Friday, December 07, 2012 10:17 AM
> To: DocBook Apps Mailing List ‎[docbook-apps@lists.oasis-open.org]‎
> Subject: [docbook-apps] RE: Creating a separate section/component for 
> Revision History
> 
> 
> 
> Well, having done some more testing I can answer my own question......
> (partially if not totally)
> 
> I'd assumed that the stylesheets automatically put any 
> appendices after all 
> sections.  I now find this is not so.  If I have a <section> 
> in my source 
> after the <appendix> then it gets rendered after the appendix.
> So if I put my Revision History (or two of them) into this 
> section it gets 
> rendered there.
> 
> So that part of the question is answered.
> 
> What I now need to do is work out how to control the 
> rendering.  I want it 
> to be a table with visible borders whereas the default has 
> the borders not 
> visible.  Also I'll want a coloured heading line (which I 
> will for other 
> tables in the document as well).
> 
> Also the "Appendix" heading is indented compared to the 
> "Section" headings.
> 
> 
> Eventually,
> Richard.
> 
> 
> 
> 
> 
> 
> 
> 
> From: Kerry, Richard [richard.kerry@atos.net]
> Sent: 03 December 2012 16:42
> To: DocBook Apps Mailing List ‎[docbook-apps@lists.oasis-open.org]‎
> Subject: [docbook-apps] Creating a separate section/component 
> for Revision 
> History
> 
> 
> 
> Team,
> 
> I've successfully removed the Revision History from the 
> title-page of my 
> document (ie from the title-page of the FO transform) - that was 
> straightforward.
> I'd like to add it back as a separate section (*) later in the file - 
> probably between the appendix (which is rarely present) and 
> the index (which 
> is never present).
> 
> Can anyone advise me where in the stylesheets I need to add 
> my new section ?
> I'm expecting to see somewhere the current main structure - 
> ie title-page, 
> ToC, section 1 ... section n, Appendices, Index.  I'd expect 
> to be adding 
> something in there.
> There will probably be a pile of other stuff needed to make this work.
> It may be that I just need to write a 'section' and mark it 
> for special 
> handling, then customize a version of the section template to 
> be called 
> between the appendix and the index.  This may be simpler.  
> But I still need 
> to find out where to get it called.
> Actually, since I'll generally need two revision histories, 
> writing it into 
> a separate Section page may also make it easier
> 
> Appreciatively,
> Richard.
> 
> 
> (*) I've said 'section' here but that has a specific meaning. 
>  I think what 
> I mean here is what is sometimes referred to as a 'component'.
> 
> 
> 
> 
> 
> 
> Richard Kerry
> BNCS Engineer
> T: +44 (0)20 82259063
> M: +44 (0)7812 325518
> Room EBX 301, BBC Television Centre, Wood Lane, London, W12 7RJ
> richard.kerry@atos.net
> uk.atos.net
> 
> This e-mail and the documents attached are confidential and 
> intended solely 
> for the addressee; it may also be privileged. If you receive 
> this e-mail in 
> error, please notify the sender immediately and destroy it. 
> As its integrity 
> cannot be secured on the Internet, the Atos group liability cannot be 
> triggered for the message content. Although the sender endeavours to 
> maintain a computer virus-free network, the sender does not 
> warrant that 
> this transmission is virus-free and will not be liable for 
> any damages 
> resulting from any virus transmitted. 
>