Robert B. wrote:


We are using docbook 5 “articles” for some of our technical
documentation, and the rendering to PDF is working very well. However I
can’t see how to insert page breaks into the docbook source. Our
in-house doc template starts each new H1 section on a fresh page.

This is the normal behavior for a DocBook 5 <article>.

Please consider converting your DocBook 5 <article> to <book>. This must be done by hand, but at least, it's not difficult and it's done once for all.

See for example:

- Sample DocBook 5 <article>: http://www.xmlmind.com/xmleditor/_distrib/doc/mathml/help.pdf

- Sample DocBook 5 <book>: http://www.xmlmind.com/xmleditor/_distrib/doc/gui/gui.pdf

After you'll do this, the DocBook XSL stylesheets (which are not XMLmind Software's work) will automatically insert a new page before each chapter, which is generally what you'll want in a technical
documentation.






How do I achieve the same result?




Unfortunately, there is no simple way to force a page-break. You need to do some "XSL programming" for that.

How to do this is documented in "DocBook XSL: The Complete Guide, Page breaking", http://www.sagehill.net/docbookxsl/PageBreaking.html



--
XMLmind XML Editor Support List
xmleditor-support@xmlmind.com
http://www.xmlmind.com/mailman/listinfo/xmleditor-support

Reply via email to