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

From
"Cob Rtayton"
Date
2007-02-21T18:08:55+00:00
ID
122d01c755e3$513e8f20$6400a8c0@totoro
Thread
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