Re: [docbook-apps] Moving towards docbook

["Bob Stayton" <bobs@sagehill.net>]

Hi,
Regarding item #2, support for the <acknowledgements> element is just now 
being added to the stylesheets. The latest snapshot versions will do better.

Regarding item #5, it is not the default behavior to generate an index 
(back-of-book alphabetized index) for each part element.  You should only 
get an index where you place an empty <index/> element, which is typically 
at the end of a book element.  Or perhaps you mean Table of Contents? If the 
latter, then you want to customize the stylesheet parameter named 
"generate.toc". That process is described here:

http://www.sagehill.net/docbookxsl/TOCcontrol.html#TOCcomponents

Regarding item #6, my book has an example of customizing footnotes to be 
rendered as endnotes:

http://www.sagehill.net/docbookxsl/Endnotes.html

My book also describes how to create a stylesheet customization layer, but 
I'm not clear on how that would integrate into the "frameworks" you are 
talking about.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net


----- Original Message ----- 
From: "Bram Vogelaar" <mylists@teambla.com>
To: "DocBook Apps" <docbook-apps@lists.oasis-open.org>
Sent: Friday, March 13, 2009 10:21 AM
Subject: [docbook-apps] Moving towards docbook


> Hello Docbook community
>
> For one of projects we are moving away from using word (large files  are 
> almost impossible to edit by multiple people in a controlled way,  and 
> limited output options)  as our main documentation system.
> We are planning to move to docbook and the initial transition went  very 
> smoothly and impressed my non-CS bosses. Now i am stuck with a  couple of 
> questions you might be able to help me with :
>
> 1) when i create the following docbook files.
>
> manual.xml
> <?xml version="1.0" encoding="UTF-8"?>
> <?oxygen 
> RNGSchema="http://www.oasis-open.org/docbook/xml/5.0/rng/docbookxi.rng " 
> type="xml"?>
> <book xmlns="http://docbook.org/ns/docbook"; 
> xmlns:xi="http://www.w3.org/2001/XInclude "
> xmlns:xlink="http://www.w3.org/1999/xlink"; version="5.0">
> <xi:include href="parts/info.xml"
>   xmlns:xi="http://www.w3.org/2001/XInclude";>
> </xi:include>
> <xi:include href="parts/part1.xml"
>   xmlns:xi="http://www.w3.org/2001/XInclude";>
> </xi:include>
> ........
> </book>
>
> info.xml
> <?xml version="1.0" encoding="UTF-8"?>
> <info xmlns="http://docbook.org/ns/docbook"; version="5.0">
> .......
> </info>
>
> in which i make all sections of the book /manual an external file i  get 
> the following error
>
> "E [oNVDL] element "info" from namespace "http://docbook.org/ns/ docbook" 
> not allowed in this context"
> while when i use the same info block in the manual.xml the file is 
> rendered fine.
> Could some explain to me how to use the info block in a separate file.
>
> 2) when using a acknowledgement i get an error rendering with the $ 
> {frameworks}/docbook/xsl/fo/docbook.xsl file i get an
> rendering error while using the ${frameworks}/docbook/xsl/html/ 
> docbook.xsl it gets rendered as a dedication.
> Is this expected behavior or a bug?
>
> 3) i am also a bit overwhelmed by the amount of rendering options in  the 
> framework folder,  could someone point me towards a introduction/  howto 
> about all the different output options.
> I figured out how to use the pdf, html , html-chunked and chm ones but  i 
> am not sure i also might like to use.
>
> 4)  seeing as that the rendering steps can be written as ant jobs (i 
> believe please correct me),  has anyone any pointers as how to setup  up a 
> cruisecontrol (http://cruisecontrol.sourceforge.net/ )setup ( or  similar)
> that renders the files automagically upon change
>
> 5) we would like to divide our manuals into parts , but in the default 
> setup this results in the generation of a new index for every part of  the 
> book. Where can i change this behavior?
>
> 6) As biologist we are attached to the hip with endnote (or reference 
> manager), could someone explain how they incorporated and or replaced 
> their endnote reference libraries to work with  their docbook workflow.
> especially  the conversion from endnote to docbook, cite-while-you- write 
> , and the auto numbering and formating that is done by endnote
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>
>
>