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

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:] 

Sent: Wednesday, February 21, 2007
7:09 PM

To: Jana Volencová;


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



 

 

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

From: Jana
Volencová 

To: Bob Stayton ; 

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:] 

Sent: Sunday, February 18, 2007
2:32 AM

To: Jana Volencová; 

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



 

 

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

From: Jana Volencová

To: 

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

Issue1.zip

Issue2.zip