OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] Is there any way to control what level a page break occurs at for webhelp?

Hash: SHA1

Hi Peter and Derek,
This thread made me notice that chunk.section.depth is set to 1 by
default in webhelp. I've just changed that to 3 since that makes more
sense as a default value for webhelp (or maybe even a higher value
would makes sense). This change should be in 1.77.1 if it hasn't been
cut yet.

One thing I'll also mention in this context. If you decide to set
chunk.section.depth to a high value (something I do), there's a PI,
<?dbhtml stop-chunking?>, that lets you stop chunking at arbitrary
places in your tree so that a section with many subsections, now
becomes a single long page. This is useful if the subsections of a
particular section happen to be short:



On 06/04/2012 09:45 AM, Peter Desjardins wrote:
> Try adjusting the chunk.section.depth parameter. I set mine to
> two.
> <xsl:param name="chunk.section.depth" select="2"></xsl:param>
> Other chunking parameters:
> http://docbook.sourceforge.net/release/xsl/current/doc/html/chunking.html
>  Peter
> On Mon, Jun 4, 2012 at 9:19 AM, Derek Van Kooten
> <derekavk@gmail.com> wrote:
>> Ok, so I have the following structure to my document:
>> <?xml version='1.0' encoding='UTF-8'?> <!-- This document was
>> created with Syntext Serna Free. --><!DOCTYPE book PUBLIC
>> "-//OASIS//DTD DocBook XML V4.5//EN" "docbookV4.5/docbookx.dtd"
>> []> <book> <title>Help Guid</title> <chapter> <title>Whats
>> New</title> <para>Describe here what is new in this release.
>> Include links to sections that reference the fnctionality and
>> some how tos.</para> </chapter> <chapter id="Installation"> 
>> <title>Installation</title> <section id="Download"> 
>> <title>Download</title> <para>This section will be used to show
>> how to download the <link 
>> linkend="Installation">application</link>.</para> </section> 
>> </chapter> <chapter> <title>Reference Guide</title> <section
>> id="AP_Vendor_Maintenance"> <title>A/P Vendor
>> Maintenance</title> <graphic
>> fileref="images/ap_vendor_maintenance.png"/> </section> <section
>> id="AP_Not_Posted"> <title>A/P Not Posted</title> <graphic
>> fileref="images/ap_not_posted.png"/> </section> <section
>> id="AP_Checks"> <title>A/P Checks</title> <graphic
>> fileref="images/ap_checks.png"/> </section> </chapter> <chapter> 
>> <title>How To&apos;s</title> <section> <title>How To Close a
>> Month</title> <para>Describe here how to close a month. Include
>> pictures, links, etc....</para> </section> </chapter> </book>
>> So what I have here is a tree that only has two levels of nodes.
>> The second level of nodes becomes pages when I convert it to
>> webhelp. I would like to have three levels though. So for
>> example, all of our Accounts Payable documents would be under a
>> node called Accounts Payable. But, when I do that it creates a
>> page for Accounts Payable, then each section under Accounts 
>> Payable becomes just a section of that page. Now, I dont want
>> that because each of those sections under Accounts Payable are
>> going to be really long, and I dont want a web page that long. I
>> want a page for each section under Accounts Payable.  Maybe a
>> different way of asking is, when I have a tree of nodes two
>> levels deep I get a page for each top level node, and a page for 
>> each second level node. The top level node also shows a Table Of
>> Contents for each child node it has. The second level nodes each
>> get a page. But, when I go to 3 levels of nodes in a tree, it
>> does not create a page for each 3rd level node. Is there way to
>> make it do that????
>> This example above only has a few nodes just to show the example,
>> but in our actual document we have about 60+ nodes at this level,
>> this is why it would make more sense to break them up by group.
>> Thanks.
> ---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail:
> docbook-apps-help@lists.oasis-open.org

Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]