By setting the rootid
parameter, you can tell the processor to
select one
chapter of a book for printing. More precisely, you tell the
processor to select one element of your document to use as the root
element. For printed output, the selected element must be of a type
that generates a page-sequence in FO output, so it could be an
appendix, reference, or preface. It must also have an
id
attribute, because that is
the value used in the rootid
parameter.
When you print a single chapter from a book, it will always be numbered 1. So you can't assemble a book from individual chapter outputs. But printing a single chapter is useful for checking formatting and page breaking.
If you want a table of contents with the chapter, you need one more parameter. By default, chapters don't have a TOC. But the generate.toc
parameter can turn one on for your single
chapter.
xsltproc --output myfile.fo \ --stringparam rootid mychapterid \ --stringparam generate.toc "chapter title,toc" \ fo/docbook.xsl myfile.xml
The first parameter selects the element whose id
attribute is mychapterid
. The second parameter turns on the TOC for chapters, and prints the Table of Contents
title at the top of the TOC. If you don't want that title on the TOC, you can remove the word title
(and the comma) from the parameter value.
DocBook XSL: The Complete Guide - 3rd Edition | PDF version available | Copyright © 2002-2005 Sagehill Enterprises |