RE: [docbook-apps] Setting different levels of chunking within one docum

Finally I had time to prepare a small sample. I found that there are actually two issues I would like to resolve:

Default chunking.
Chunking controlled by just the parameter chunk.section.depth does not work the way I would expect: sections on the same level do not get chunked the same.
That illustrates the comparison between Section A1.2.2.2 and Section A2.2.2.2 and in my Sample.chm. The attached Issue1.zip file contains also my customization files and the source XML file. The output was generated using the commands:
xsltproc --xinclude --nonet --stringparam collect.xref.targets only "c:\db\sablony\db-html.xsl" Sample.xml
xsltproc --xinclude --nonet --stringparam current.docid TManual --stringparam target.database.document _targets.xml --stringparam manifest.in.base.dir 1 --stringparam base.dir output_chm/ --stringparam htmlhelp.hhc.show.root 0 "c:\db\sablony\db-chm.xsl" Sample.xml
Chunking controlled manually where the HHP file is incorrect and links in CHM do not work.
I used the editted mytoc.xml file and the htmlhelp.xsl file imports now chunktoc.xsl (instead of chunk.xsl).
The same two commands are used to generate the output, now the second with an additional parameter: --stringparam chunk.toc mytoc.xml
The CHM compilation ends up then with warnings and errors (with codes HHC4006 and HHC5003) as the HHP file does not have the right content in the [FILES] section. However, the CHM does get created and the chunking is affected the way I wanted BUT the links leading to the section that was merged with the previous one in the mytoc.xml file do not work.
The attached Issue2.zip file contains mytoc.xml file as well as the original one and the corrupt HHP file.

DocBook XSL version 1.70.1 is used.

I hope this is sufficient information. I would be happy to provide additional details if needed.

Thank you for you help.

Jana

From: Bob Stayton [mailto:bobs@sagehill.net]
Sent: Wednesday, February 21, 2007 7:09 PM
To: Jana Volencová; docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Setting different levels of chunking within one document

Let me ask if the resulting chunked files work before they are compiled into CHM. Is all the content you expect present, in the correct chunks, with cross references working?

I think the HTML Help stylesheet's manifest process is not handling the chunk.toc parameter correctly. I would file that as a bug report on the SourceForge site. Uploading short sample files that illustrate the problem to the bug report will greatly facilitate resolving the bug.

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net

----- Original Message -----

From: Jana Volencová

To: Bob Stayton ; docbook-apps@lists.oasis-open.org

Sent: Wednesday, February 21, 2007 7:06 AM

Subject: RE: [docbook-apps] Setting different levels of chunking within one document

Thank you for the hint; the mistake was, of course, somewhere else – I have omitted the xinluclude command and the tocentry file reflected just one file, but not the whole project. This is fixed now and the procedure works fine up to the point where I try to compile the CHM file.

This process fails because the htmlhelp.hhp file for some reason doesn‘t contain the list of HTML files in the [FILES] section but a large portion of texts from the document. When I correct this manually – insert the list of HTML and image files - compiling becomes possible but the resulting CHM has got lots of broken links. Most probably those links that lead to files that were merged with some others in the tocentry file do not work. In HTML output, it is the same.

So my question stilll is – how to control chunking, specifically in CHM files? Or if anyone else had a similar issue, any ideas how to solve it are very appreciated.

Jana

From: Bob Stayton [mailto:bobs@sagehill.net]
Sent: Sunday, February 18, 2007 2:32 AM
To: Jana Volencová; docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Setting different levels of chunking within one document

Try setting the parameter chunk.first.sections to 1, as well as setting chunk.section.depth to a large number, when you run maketoc.xsl.

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net

----- Original Message -----

From: Jana Volencová

To: docbook-apps@lists.oasis-open.org

Sent: Friday, February 16, 2007 12:16 AM

Subject: [docbook-apps] Setting different levels of chunking within one document

Hello,

I would like to find out how to ensure the correct chunking for a document that has its sections nested in different depths (from 2 up to 6 levels). Originally this document consists of about 1000 small XML files which are then pulled together into one big file before processing starts. Each of these small files represents a section that should not be chunked any more.

I tried to control the chunking manually as described at http://www.sagehill.net/docbookxsl/Chunking.html

but the maketoc.xsl stylesheet always produces a file with very small number of <tocentry> elements – even if I use the chunk.section.depth parameter with different values. This means that I would have to add too many entries manually to achieve the structure I want.

So my questions are:

-          How to get covered the complete structure of my document by the maketoc.xsl?

-          Is there any other way of setting different levels of chunking?

Thanks a lot for your help.

Jana

GMC Software Technology
Jana Volencova
Technical Writer
Hořická 283
500 02 Hradec Králové
Czech Republic

Phone:  +420 495 402 043
Fax: +420 495 402 010
www.gmc.net

docbook-apps message