Re: [docbook-apps] [FILES] section of htmlhelp.hhp contains document text when htmlhelp.xsl is used with chunktoc.xsl

[Glemba Tamás <gpost@freemail.hu>]

Bob

Thanks for your reply. I had time to look at this problem again yesterday and as I see the problem is that chunktoc.xsl does not load chunk-code.xsl where all the templates with mode="enumerate-files" are defined. Putting <xsl:include href="chunk-code.xsl"/> into chunktoc.xsl resulted in lots of Ambiguous template rule warnings. So instead of loading chunk-code.xsl I simply copied all templates with mode="enumerate-files" from chunk-code.xsl to chunktoc.xsl and that solved the problem for now. I think the right solution would be to move these templates to a separate stylesheet and include that stylesheet in both chunktoc.xsl and chunk.xsl. Anyway I will file a bug report on the SourceForge site.

Regards
Tamas
 
 
 
 Bob Stayton <bobs@sagehill.net> írta: 
 
 I think the problem is that the htmlhelp templates that generate the extra 
 project files are not written to use the chunk.toc parameter properly, and 
 so the project files are mangled.  I think that feature only works with 
 straight html and xhtml chunked output.  It is a deficiency that should be 
 corrected, but I don't see any easy workaround from here.  You might file a 
 bug report on the SourceForge site.
 
 Bob Stayton
 Sagehill Enterprises
 bobs@sagehill.net
 
 
 ----- Original Message ----- 
 From: "Glemba Tamás" <gpost@freemail.hu>
 To: <docbook-apps@lists.oasis-open.org>
 Sent: Saturday, March 15, 2008 9:33 AM
 Subject: [docbook-apps] [FILES] section of htmlhelp.hhp contains document 
 text when htmlhelp.xsl is used with chunktoc.xsl
 
 
 > Hi
 >
 > I try to use manually controlled chunking with htmlhelp output. I followed 
 > the instructions in Bob Stayton's book (maketoc.xsl -> chunktoc.xsl) and I 
 > got the html output chunked the way I wanted, but the [FILES] section of 
 > the generated htmlhelp.hhp contains plain document text (merged text 
 > nodes) instead of file names. If I manually fix the [FILES] section of 
 > htmlhelp.hhp I can compile the help project and I get the expected chm 
 > file.
 >
 > I would appreciate it if someone could confirm that this is an existing 
 > bug or someone could tell me if I am doing something wrong and help me to 
 > solve this problem.
 >
 > 1. I have made this simple book for testing:
 >
 > <?xml version="1.0" encoding="UTF-8"?>
 > <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
 > "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd";>
 > <book id="book1">
 >  <title>Book</title>
 >  <chapter id="chap1">
 >    <title>Chapter 1</title>
 >    <section id="chap1__sec1">
 >      <title>Section 1</title>
 >      <para>para1.
 >      <section id="chap1__sec1__sec1">
 >        <title>Section 1_1</title>
 >        <para>para1_1</para>
 >      </section>
 >      <section id="chap1__sec1__sec2">
 >        <title>Section 1_2</title>
 >        <para>para1_2</para>
 >      </section>
 >    </section>
 >    <section id="chap1__sec2">
 >      <title>Section 2</title>
 >      <para>para2</para>
 >    </section>
 >  </chapter>
 > </book>
 >
 > 2. My TestBooktoc.xml contains this:
 > <toc role="chunk-toc">
 >  <tocentry linkend="book1"><?dbhtml filename="index.html"?>
 >    <tocentry linkend="chap1"><?dbhtml filename="ch01.html"?>
 >      <tocentry linkend="chap1__sec1"><?dbhtml filename="ch01s01.html"?>
 >      </tocentry>
 >      <tocentry linkend="chap1__sec2"><?dbhtml filename="ch01s02.html"?>
 >      </tocentry>
 >    </tocentry>
 >  </tocentry>
 > </toc>
 >
 > 3. I replaced chunk.xsl with chunktoc.xsl in my htmlhelp.xsl so now it 
 > looks like this:
 > <?xml version="1.0"?>
 > <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform";
 >                version="1.0">
 > <xsl:import href="html/chunktoc.xsl"/>
 > <xsl:include href="htmlhelp/htmlhelp-common.xsl"/>
 >
 > 4. I run myhtmlhelp.xsl with the following parameters:
 > chunk.section.depth=3
 > chunk.toc=TestBooktoc.xml
 > generate.section.toc.level=0
 > generate.toc=book toc,figure
 > htmlhelp.use.hhk=1
 > saxon.character.representation=native;decimal
 > use.id.as.filename=1 - It's not documented (at least I could not find any 
 > hint), but I had to realize that this does not work with chunktoc.xsl 
 > (maketoc.xsl also generates automatic file names).
 >
 > 5. Running the stylesheet gives properly chunked html files with 
 > auto-generated filenames: ch01.htm, ch01s01.html, ch01s02.html.
 >
 > 6. The generated htmlhelp.hhp file looks like this with document text in 
 > the [FILES] section:
 > [OPTIONS]
 > Binary TOC=Yes
 > Compatibility=1.1 or later
 > Compiled file=htmlhelp.chm
 > Contents file=toc.hhc
 > Default Window=Main
 > Default topic=index.html
 > Display compile progress=Yes
 > Full-text search=Yes
 > Language=0x0409 English (UNITED STATES)
 > Title=Book
 > Enhanced decompilation=No
 >
 > [WINDOWS]
 > Main="Book","toc.hhc",,"index.html","index.html",,,,,0x2520,,0x703006,,,,,,,,0
 >
 > [FILES]
 > BookChapter 1Section 1para1.Section 1_1para1_1Section 1_2para1_2Section 
 > 2para2
 >
 > If I use chunk.xsl instead of chunktoc.xsl the [FILES] section is 
 > generated properly. I guess that when I use chunktoc.xsl the 
 > <xsl:apply-templates select="/" mode="enumerate-files"/> instruction in 
 > htmlhelp-common.xsl does not find matching template rule to generate the 
 > [FILES] section so it simply copies all text nodes to the output.
 >
 > I use 1.73.1 version of the XSL Stylesheets and Saxon 6.5.
 >
 > Regards
 > Tamas
 >
 >
 > ---------------------------------------------------------------------
 > To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
 > For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
 >
 >
 > 
 
 
 ---------------------------------------------------------------------
 To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
 For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org