Re: DOCBOOK-APPS: Chunking question

[Roel Vanhout <roel@riks.nl>]

Janning Vygen wrote:
> Isnt this the same as "chunk all sections"?? this is easier to 
> achieve by setting parameters chunk 
> look at the parameters for chunking: 
> http://docbook.sourceforge.net/release/xsl/snapshot/doc/html/rn18.html
> <xsl:param name="chunk.section.depth" select="1000">
> <xsl:param name="chunk.first.sections" select="1"/>
> these parameters should chunk every sectx or section in your doc

They do chunk every section, but I don't want the last section in an 
hierarchy to be chunked. Eg.

<sect1>
   <sect2>
     <sect3>
       <para>Text1</para>
     </sect3>
     <sect3>
       <para>Text2</para>
     </sect3>
   </sect2>
   <sect2>
     <sect3>
       <sect4>
         <para>Text3</para>
       </sect4>
       <sect4>
         <para>Text4</para>
       </sect4>
     </sect3>
     <sect3>
       <para>Text5</para>
     </sect3>
     <sect3>
       <para>Text6</para>
     </sect3>
   </sect2>
</sect1>

Should be chunked like this:
page_sect1 -> empty (maybe links to page_sect2_1 & page_sect2_2)
   page_sect2_1 -> contains Text1 and Text2
   page_sect2_2 -> contains Text5 and Text6 (maybe link to page_sect3_2)
     page_sect3_2 -> contains Text3 and Text4


So Text1 & Text2 are on one page, Text3 & Text4 are on one page, Text5 & 
Text6 are on one page. With chunk.section.depth set to a very high 
value, they would be chunked to separate pages, like this:

page_sect1
   page_sect2_1
     page_sect3_1 -> contains Text1
     page_sect3_2 -> contains Text2
   page_sect2_2
     page_sect3_3
       page_sect4_1 -> contains Text3
       page_sect4_2 -> contains Text4
     page_sect3_3 -> contains Text5
     page_sect3_4 -> contains Text6

Sorry if I bored anyone, but writing this down has actually helped me to 
clear my mind on what I really wanted :) Back to trying to implement it 
now...


cheers,

roel


> kind regards 
> janning
> 
> 
> 
>>cheers,
>>
>>roel
>>
>>Janning Vygen wrote:
>>
>>>Am Montag, 13. Januar 2003 23:09 schrieb Bob Stayton:
>>>
>>>>On Mon, Jan 13, 2003 at 02:13:24PM -0500, Jeff Beal wrote:
>>>>
>>>>>Customizing the chunking to the extent you appear to want is
>>>>>quite difficult, especially if you want to maintain reasonable
>>>>>previous/next/up links in the output.
>>>
>>>[...]
>>>
>>>
>>>>There was another message that suggested the use of PIs
>>>>in the document, but I don't think it was ever implemented.
>>>>
>>>>http://lists.oasis-open.org/archives/docbook-apps/200209/msg00007
>>>>.h tml
>>>
>>>It was implemented.
>>>
>>>The file is attached to this mail. It was quite easy but it is
>>>not very well tested because the need for manual chunking via PI
>>>didn't arrise in the project it was made for.
>>>
>>>It just overrides the template name="chunk"
>>>
>>>you can use PIs like this to chunk a section. Just put it inside
>>>the section as a child of the section element.
>>>
>>><?dbhtml chunk-childs="1" chunk-first-sections="0"?>
>>>
>>>I dont know if this file works with the newest docbook-xsl
>>>release. and it works only with chunkfast.xsl i think.
>>>
>>>I just hope it gives you a hint how easy it is to implement
>>>chunking with PIs. I hope this file can be of any help.
>>>
>>>kind regards
>>>janning
>>>
>>>
>>>
>>>-----------------------------------------------------------------
>>>-------
>>>
>>><?xml version="1.0"?>
>>><xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform";
>>>                version="1.0">
>>>
>>><!--
>>>      2002, written by vygen@planwerk6.de,
>>>      1) you can decide via Processing Instruction
>>>      if you want to chunk the childs of the parent node of the
>>>PI 2) you can override the value of chunk.first.sections via PI
>>>
>>>     Put PIs like this into your chapter or sections
>>>
>>>     <?dbhtml chunk-childs="1" chunk-first-sections="0"?>
>>>
>>>     chunk-first-sections is inherited by all subsequent childs
>>>if not changed again by another PI
>>>
>>>     chunk-childs affects only the childs of the parnet node of
>>>the PI (put your PI _into_ a chapter to chunk the sections inside
>>>this chapter
>>>
>>>     you can only decide to
>>>     - chunk all childs but not the first
>>>     - chunk all child including the first
>>>     - chunk no childs
>>>
>>>     NO WARRENTY, most of the code is copyright by xsl guru norm
>>>walsh -->
>>>
>>><xsl:include href="chunkfast.xsl"/>
>>>
>>><xsl:template name="dbhtml-chunk-childs">
>>>  <xsl:param name="pis"
>>>select="./processing-instruction('dbhtml')"/> <xsl:call-template
>>>name="dbhtml-attribute">
>>>    <xsl:with-param name="pis" select="$pis"/>
>>>    <xsl:with-param
>>>name="attribute">chunk-childs</xsl:with-param>
>>></xsl:call-template>
>>></xsl:template>
>>>
>>><xsl:template name="dbhtml-chunk-first-sections">
>>>  <xsl:param name="pis"
>>>select="./processing-instruction('dbhtml')"/> <xsl:call-template
>>>name="dbhtml-attribute">
>>>    <xsl:with-param name="pis" select="$pis"/>
>>>    <xsl:with-param
>>>name="attribute">chunk-first-sections</xsl:with-param>
>>></xsl:call-template>
>>></xsl:template>
>>>
>>><xsl:template name="chunk">
>>>  <xsl:param name="node" select="."/>
>>>  <!-- returns 1 if $node is a chunk -->
>>>
>>>  <xsl:variable name="dbhtml-chunk-childs">
>>>    <xsl:call-template name="dbhtml-chunk-childs">
>>>      <xsl:with-param name="pis"
>>>select="$node/parent::*/processing-instruction('dbhtml')"/>
>>></xsl:call-template>
>>>  </xsl:variable>
>>>
>>>  <xsl:variable name="dbhtml-chunk-first-sections">
>>>    <xsl:call-template name="dbhtml-chunk-first-sections">
>>>    <xsl:with-param name="pis"
>>>select="$node/ancestor::*[contains(./processing-instruction('dbht
>>>ml'),'chunk-first-sections=')][1]/processing-instruction('dbhtml')
>>>"/> </xsl:call-template>
>>>  </xsl:variable>
>>>
>>>  <xsl:choose>
>>>    <xsl:when test="not($node/parent::*)">1</xsl:when>
>>>
>>>    <xsl:when test="local-name($node) = 'sect1'
>>>                    and (  $dbhtml-chunk-childs = 1 or
>>>($chunk.section.depth &gt;= 1 and $dbhtml-chunk-childs = '') )
>>>and ( ($dbhtml-chunk-first-sections = 1 or ($chunk.first.sections
>>>  != 0 and $dbhtml-chunk-first-sections = '') ) or
>>>count($node/preceding-sibling::sect1) &gt; 0)">
>>><xsl:text>1</xsl:text>
>>>    </xsl:when>
>>>    <xsl:when test="local-name($node) = 'sect2'
>>>                    and (  $dbhtml-chunk-childs = 1 or
>>>($chunk.section.depth &gt;= 2 and $dbhtml-chunk-childs = '') )
>>>and ( ($dbhtml-chunk-first-sections = 1 or ($chunk.first.sections
>>>  != 0 and $dbhtml-chunk-first-sections = '') ) or
>>>count($node/preceding-sibling::sect2) &gt; 0)">
>>><xsl:call-template name="chunk">
>>>        <xsl:with-param name="node" select="$node/parent::*"/>
>>>      </xsl:call-template>
>>>    </xsl:when>
>>>    <xsl:when test="local-name($node) = 'sect3'
>>>                    and (  $dbhtml-chunk-childs = 1 or
>>>($chunk.section.depth &gt;= 3 and $dbhtml-chunk-childs = '') )
>>>and ( ($dbhtml-chunk-first-sections = 1 or ($chunk.first.sections
>>>  != 0 and $dbhtml-chunk-first-sections = '') ) or
>>>count($node/preceding-sibling::sect3) &gt; 0)">
>>><xsl:call-template name="chunk">
>>>        <xsl:with-param name="node" select="$node/parent::*"/>
>>>      </xsl:call-template>
>>>    </xsl:when>
>>>    <xsl:when test="local-name($node) = 'sect4'
>>>                    and (  $dbhtml-chunk-childs = 1 or
>>>($chunk.section.depth &gt;= 4 and $dbhtml-chunk-childs = '') )
>>>and ( ($dbhtml-chunk-first-sections = 1 or ($chunk.first.sections
>>>  != 0 and $dbhtml-chunk-first-sections = '') ) or
>>>count($node/preceding-sibling::sect4) &gt; 0)">
>>><xsl:call-template name="chunk">
>>>        <xsl:with-param name="node" select="$node/parent::*"/>
>>>      </xsl:call-template>
>>>    </xsl:when>
>>>    <xsl:when test="local-name($node) = 'sect5'
>>>                    and (  $dbhtml-chunk-childs = 1 or
>>>($chunk.section.depth &gt;= 5 and $dbhtml-chunk-childs = '') )
>>>and ( ($dbhtml-chunk-first-sections = 1 or ($chunk.first.sections
>>>  != 0 and $dbhtml-chunk-first-sections = '') ) or
>>>count($node/preceding-sibling::sect5) &gt; 0)">
>>><xsl:call-template name="chunk">
>>>        <xsl:with-param name="node" select="$node/parent::*"/>
>>>      </xsl:call-template>
>>>    </xsl:when>
>>>    <xsl:when test="local-name($node) = 'section'
>>>                    and (  $dbhtml-chunk-childs = 1 or
>>>($chunk.section.depth &gt;= count($node/ancestor::section)+1 and
>>>$dbhtml-chunk-childs = '') ) and ( ($dbhtml-chunk-first-sections
>>>= 1 or ($chunk.first.sections   != 0 and
>>>$dbhtml-chunk-first-sections = '') ) or
>>>count($node/preceding-sibling::section) &gt; 0)">
>>><xsl:call-template name="chunk">
>>>        <xsl:with-param name="node" select="$node/parent::*"/>
>>>      </xsl:call-template>
>>>    </xsl:when>
>>>
>>>    <xsl:when test="name($node)='preface'">1</xsl:when>
>>>    <xsl:when test="name($node)='chapter'">1</xsl:when>
>>>    <xsl:when test="name($node)='appendix'">1</xsl:when>
>>>    <xsl:when test="name($node)='article'">1</xsl:when>
>>>    <xsl:when test="name($node)='part'">1</xsl:when>
>>>    <xsl:when test="name($node)='reference'">1</xsl:when>
>>>    <xsl:when test="name($node)='refentry'">1</xsl:when>
>>>    <xsl:when test="name($node)='index'
>>>                    and (name($node/parent::*) = 'article'
>>>                         or name($node/parent::*) =
>>>'book')">1</xsl:when> <xsl:when test="name($node)='bibliography'
>>>                    and (name($node/parent::*) = 'article'
>>>                         or name($node/parent::*) =
>>>'book')">1</xsl:when> <xsl:when test="name($node)='glossary'
>>>                    and (name($node/parent::*) = 'article'
>>>                         or name($node/parent::*) =
>>>'book')">1</xsl:when> <xsl:when
>>>test="name($node)='colophon'">1</xsl:when> <xsl:when
>>>test="name($node)='book'">1</xsl:when>
>>>    <xsl:when test="name($node)='set'">1</xsl:when>
>>>    <xsl:when test="name($node)='setindex'">1</xsl:when>
>>>    <xsl:otherwise>0</xsl:otherwise>
>>>  </xsl:choose>
>>></xsl:template>
>>>
>>></xsl:stylesheet>
> 
>