docbook-apps

Hi!

I am wondering. DITA has the attribute "chunk" that gives the user some control about how a topic/section is treated when it comes to output chunking. Setting that attribute to "to-content", the topic (including its children) is "… rendered as a single chunk of content". Is there something similar in DocBook? I know that I can control the chunking level – but that’s a different story. I need a more fine-grain control for the chunking mechanism. Could this be achieved in a customisation? Which "key" stylesheets in DocBook XSLT would be promising candidates to look at?

Thank you!
/frank

Hi Frank,

Am Freitag, 6. November 2015, 16:59:32 schrieb Frank Arensmeier:
>
> I am wondering. DITA has the attribute "chunk" that gives the user some
> control about how a topic/section is treated when it comes to output
> chunking. Setting that attribute to "to-content", the topic (including its
> children) is "… rendered as a single chunk of content". Is there something
> similar in DocBook?

I'm not aware of anything similar. DocBook has no attribute that is targetted
for this purpose.

However, you could (ab?)use some common attributes (maybe condition?) and
customize the chunking template. Haven't tried it yet.

A possible easier solution would be to use the processing
instruction. It's explained in the link below.


> I know that I can control the chunking level – but
> that’s a different story. I need a more fine-grain control for the chunking
> mechanism. Could this be achieved in a customisation? Which "key"
> stylesheets in DocBook XSLT would be promising candidates to look at?

Would the following link fit your needs?

http://www.sagehill.net/docbookxsl/Chunking.html


--
Gruß/Regards
Thomas Schraitle

Hi Frank,
I have some experience with customizing chunking in the stylesheet.
Many of the features of DocBook XSL were designed to be easily
customized, but chunking isn't one of them. So it is possible, but
there are a lot of details that must be attended to. One of those
details is navigation to Next and Previous, which is altered when you
change chunking behavior.

There is a section in my online book on customizing chunking, including
a section on "How chunking works", but it is not a complete guide. It
does point out the files and templates that will need to be looked at.

http://www.sagehill.net/docbookxsl/ChunkingCustomization.html

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

On 11/6/2015 7:59 AM, Frank Arensmeier wrote:
> Hi!
>
> I am wondering. DITA has the attribute "chunk" that gives the user
> some control about how a topic/section is treated when it comes to
> output chunking. Setting that attribute to "to-content", the topic
> (including its children) is "… rendered as a single chunk of
> content". Is there something similar in DocBook? I know that I can
> control the chunking level – but that’s a different story. I need a
> more fine-grain control for the chunking mechanism. Could this be
> achieved in a customisation? Which "key" stylesheets in DocBook XSLT
> would be promising candidates to look at?
>
> Thank you! /frank
> ---------------------------------------------------------------------
>
>
To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail:
> docbook-apps-help@lists.oasis-open.org
>
>
>

Hi!

Thomas and Bob, thank you for pointing me in the right direction. I’ll give it a try.

/frank

Frank Arensmeier
Paligo - The truly user-friendly CMS for technical documentation
www.paligo.se

> 18 nov 2015 kl. 23:31 skrev Bob Stayton <bobs@sagehill.net>:
>
> Hi Frank,
> I have some experience with customizing chunking in the stylesheet. Many of the features of DocBook XSL were designed to be easily customized, but chunking isn't one of them. So it is possible, but there are a lot of details that must be attended to. One of those details is navigation to Next and Previous, which is altered when you change chunking behavior.
>
> There is a section in my online book on customizing chunking, including a section on "How chunking works", but it is not a complete guide. It does point out the files and templates that will need to be looked at.
>
> http://www.sagehill.net/docbookxsl/ChunkingCustomization.html
>
> Bob Stayton
> Sagehill Enterprises
> bobs@sagehill.net
>
> On 11/6/2015 7:59 AM, Frank Arensmeier wrote:
>> Hi!
>>
>> I am wondering. DITA has the attribute "chunk" that gives the user
>> some control about how a topic/section is treated when it comes to
>> output chunking. Setting that attribute to "to-content", the topic
>> (including its children) is "… rendered as a single chunk of
>> content". Is there something similar in DocBook? I know that I can
>> control the chunking level – but that’s a different story. I need a
>> more fine-grain control for the chunking mechanism. Could this be
>> achieved in a customisation? Which "key" stylesheets in DocBook XSLT
>> would be promising candidates to look at?
>>
>> Thank you! /frank
>> ---------------------------------------------------------------------
>>
>>
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
>> For additional commands, e-mail:
>> docbook-apps-help@lists.oasis-open.org
>>
>>
>>