Re: [docbook-apps] Specific chunk.section.depth on one section

From
Kasun Gajasinghe <>
Date
2018-01-18T18:11:03+00:00
ID
Thread
Re: [docbook-apps] Specific chunk.section.depth on one section
On Thu, Jan 18, 2018 at 11:30 PM, Bob Stayton <> wrote:
A related approach that uses the same mechanism is to write a custom stylehsheet that generates a manual toc file from the document, and by setting role attributes or using other match criteria you can handle your special cases.  Typically that would add an extra step to your processing, but not necessarily.  It is possible to generate such a file in your main customization the way the olink database is updated before the content is processed.

I'm just not sure if Webhelp will follow the manual toc in all aspects of processing.

I'm afraid so though I didn't try it myself. So, we should give it a try. WebHelp ToC is generated via the webhelptoc mode [1]. This gets recursively via like #832.

[1] https://github.com/docbook/xslt10-stylesheets/blob/master/xsl/webhelp/xsl/webhelp-common.xsl#L790

 

Bob Stayton

Sagehill Enterprises



On 1/18/2018 8:44 AM, Mats S. E. Broberg wrote:

Hi,

Thanks. I looked at that one, but as it says,

"... since it requires hand editing of a generated table of contents file, it is only useful if done infrequently or with documents that have stable structure."

I didn't think it would work well. My doc is updated every other day and the content continously expands.

Kind regards,

Mats Broberg

On 01/18/2018 11:26 AM, Kasun Gajasinghe wrote:

Hi Mats,

Webhelp uses the default chunking behavior that comes with Docbook. I checked the chunking docs at [1]. It seems your requirement can be addressed by a manually edited table of contents file. [1] The chunk.section.depth param will be ignored, and the chunking will happen with the given toc file.

We however should check how this works with Webhelp though. Especially the Table of Contents in the left pane.

[1] http://www.sagehill.net/docbookxsl/Chunking.html#ManualChunking

On Thu, Jan 18, 2018 at 2:46 AM, Mats S. E. Broberg < <mailto:>> wrote:

    Greetings,

    I have a (frequently updated) document (DocBook 5.0 'article') that

    I publish to WebHelp and PDF. For the WebHelp version

    chunk.section.depth is set to 1.

    However, one particular (top level) section contains subsections

    with so many images that I want that section to have a

    chunk.section.depth set to 3.

    Is this at all possible?

    Thanks in advance.

    Kind regards,

    Mats Broberg

    ---------------------------------------------------------------------

    To unsubscribe, e-mail:

    

    <mailto:>

    For additional commands, e-mail:

    

    <mailto:>

-- 

~~~*******'''''''''''''*******~~~

*Kasun Gajasinghe*

Senior Software Engineer; WSO2 Inc.; http://wso2.com <http://wso2.com/>,

/Linked-in: /http://lk.linkedin.com/in/gajasinghe/

/

/Blog: //http://blog.kasunbg.org/ <http://blog.kasunbg.org/>

/

GitHub: //http://github.com/kasunbg/

---------------------------------------------------------------------

To unsubscribe, e-mail: 

For additional commands, e-mail: 

---------------------------------------------------------------------

To unsubscribe, e-mail: 

For additional commands, e-mail: 

-- 

~~~*******'''''''''''''*******~~~

Kasun Gajasinghe
Senior Software Engineer; WSO2 Inc.; http://wso2.com,

Linked-in: http://lk.linkedin.com/in/gajasinghe

Blog: http://blog.kasunbg.org
 

GitHub: http://github.com/kasunbg