docbook-apps

  • 1.  [FILES] section of htmlhelp.hhp contains document text when htmlhelp.xsl is used with chunktoc.xsl

    Posted 03-15-2008 16:33
    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:


    "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
    <book id="book1">

    <chapter id="chap1">



    <para>para1.


    <para>para1_1</para>



    <para>para1_2</para>




    <para>para2</para>

    </chapter>
    </book>

    2. My TestBooktoc.xml contains this:
    <toc role="chunk-toc">
    <tocentry linkend="book1">
    <tocentry linkend="chap1">
    <tocentry linkend="chap1__sec1">
    </tocentry>
    <tocentry linkend="chap1__sec2">
    </tocentry>
    </tocentry>
    </tocentry>
    </toc>

    3. I replaced chunk.xsl with chunktoc.xsl in my htmlhelp.xsl so now it looks like this:

    <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




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

    Posted 03-18-2008 15:46
    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:
    >
    >
    > > "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
    > <book id="book1">
    >
    > <chapter id="chap1">
    >
    >

    >
    > <para>para1.
    >

    >
    > <para>para1_1</para>
    >

    >

    >
    > <para>para1_2</para>
    >

    >

    >

    >
    > <para>para2</para>
    >

    > </chapter>
    > </book>
    >
    > 2. My TestBooktoc.xml contains this:
    > <toc role="chunk-toc">
    > <tocentry linkend="book1">
    > <tocentry linkend="chap1">
    > <tocentry linkend="chap1__sec1">
    > </tocentry>
    > <tocentry linkend="chap1__sec2">
    > </tocentry>
    > </tocentry>
    > </tocentry>
    > </toc>
    >
    > 3. I replaced chunk.xsl with chunktoc.xsl in my htmlhelp.xsl so now it
    > looks like this:
    >
    > <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
    >
    >
    >




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

    Posted 03-19-2008 16:38
    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:
    >
    >
    > > "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
    > <book id="book1">
    >
    > <chapter id="chap1">
    >
    >

    >
    > <para>para1.
    >

    >
    > <para>para1_1</para>
    >

    >

    >
    > <para>para1_2</para>
    >

    >

    >

    >
    > <para>para2</para>
    >

    > </chapter>
    > </book>
    >
    > 2. My TestBooktoc.xml contains this:
    > <toc role="chunk-toc">
    > <tocentry linkend="book1">
    > <tocentry linkend="chap1">
    > <tocentry linkend="chap1__sec1">
    > </tocentry>
    > <tocentry linkend="chap1__sec2">
    > </tocentry>
    > </tocentry>
    > </tocentry>
    > </toc>
    >
    > 3. I replaced chunk.xsl with chunktoc.xsl in my htmlhelp.xsl so now it
    > looks like this:
    >
    > <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