Scroll DocBook pagination not matching Confluence pagination

[Robert Lauriston]

I exported DocBook from Confluence and generated webhelp. The webhelp output generally looks right, except where there are H2 and H3 headings within a Confluence page. In webhelp, those are getting split into multiple pages.

In the Scroll DocBook Exporter documentation I find instructions for defining manual page breaks but not for suppressing unwanted ones.

[Robert Lauriston · Accepted solution]

I got this answer from K15t support:

I think you'll need to configure chunking in the Docbook to HTML converter:
http://www.sagehill.net/docbookxsl/Chunking.html
Could this be related? I found a link to that page here: http://docbook.sourceforge.net/release/xsl/1.76.1/webhelp/docs/content/ch02s02.html

Our default export template creates processing instruction in front of every section that has been created for a new Confluence page:
<?confluence type="page" ?>

You would need to configure the converter's chunking configuration to only start a new HTML page for <section> elements having such a processing instruction. I am however not familiar with this tool and can't therefore support you in doing this.

An alternative approach would be to create your own export template: http://www.k15t.com/display/DBK/Creating+a+Template
Then adapt the file 'section.vm' to create any other docbook element instead of 'section'. (See in that file how the processing instruction is inserted)

[Robert Lauriston]

I got this answer from K15t support:

I think you'll need to configure chunking in the Docbook to HTML converter:
http://www.sagehill.net/docbookxsl/Chunking.html
Could this be related? I found a link to that page here: http://docbook.sourceforge.net/release/xsl/1.76.1/webhelp/docs/content/ch02s02.html

Our default export template creates processing instruction in front of every section that has been created for a new Confluence page:
<?confluence type="page" ?>

You would need to configure the converter's chunking configuration to only start a new HTML page for <section> elements having such a processing instruction. I am however not familiar with this tool and can't therefore support you in doing this.

An alternative approach would be to create your own export template: http://www.k15t.com/display/DBK/Creating+a+Template
Then adapt the file 'section.vm' to create any other docbook element instead of 'section'. (See in that file how the processing instruction is inserted)

[Nils Bier _K15t_]

Hi Robert,

could you please open a support-request by emailing to support@k15t.com ?

It would be great if you could attach your template-jar file and a XML export of the space.
We can then have a deeper look at your problem and will come back to you as soon as possible.

Cheers,
Nils