Re: [docbook-apps] Moving towards docbook

[Bram Vogelaar <mylists@teambla.com>]

Hello Bob
On 13 Mar 2009, at 18:45, Bob Stayton wrote:

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

excellent thanks
>
> 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

sorry, yes of course i meant Toc , ill have a look at your book again,  
It been very informative so far
>
> Regarding item #6, my book has an example of customizing footnotes  
> to be rendered as endnotes:
>
> http://www.sagehill.net/docbookxsl/Endnotes.html

What i understand from this, is that the full text references will end  
up at the bottom of the same page where you added the actual  
reference. In the biology world we are raised with the notion that  
references will end up at the end of a book/ article in a index type  
style. do have any clues how to achieve this or have i completely  
missed your point?
>
> 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.

I dont really get this question, to what specific section does this  
reference?
if its with regards to my 2nd question, than i am trying to find out   
what all the xsl's in the docbook-xsl-ns folder can do. (which is  
included in the oxygen project as the framework folder.

bram
>
> 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
>>
>>
>