For HTML output, the stylesheets use an HTML TABLE
element to lay out the question and answer text and their labels. Each qandaentry
takes up two rows, one for the question and one for the answer. It is a two-column table with the labels in the left column and the question and answer text in the right column.
HTML tables do a good job of automatically adjusting their column widths to fit their text, but you may want finer control. There are certain features of the Q and A table formatting that you can control using processing instructions embedded in your document. For example:
<qandaset> <?dbhtml label-width="10%" ?> <?dbhtml toc="1" ?> <?dbhtml cellspacing="3px" cellpadding="3px" ?> <qandaentry> <question>Left button</question> <answer><para>Blah blah</para></answer> </qandaentry> ... </qandaset>
For FO output, a qandaset
is processed as an fo:list-block
in a manner similar to a variablelist
. The labels are processed into fo:list-item-label
elements, and the question and answer text as list-item-body
elements. The width allocated for the labels is automatically calculated. Or you can use a dbfo label-width
processing instruction to manually adjust the width for a given qandaset
. Use it like the dbhtml
processing instruction described above.
For print output, the stylesheets provide the following attribute-sets for customizing titles in qandaset
and qandadiv
elements.
qanda.title.properties General properties for all levels qanda.title.level1.properties Properties specific to each level qanda.title.level2.properties qanda.title.level3.properties qanda.title.level4.properties qanda.title.level5.properties
These attribute sets are nearly identical to the section.title.properties
attribute-sets. See the section “Section titles” for examples of how to customize such attribute-sets. The main difference with these attribute-sets is that the level is used somewhat differently. A qandaset
is contained within a section, so its title level is considered one below its container section level in the hierarchy. So a qandaset
within a sect1
would be treated as level 2 for its title. Any qandadiv
elements inside it would have their titles treated as level 3. If you prefer that all your qandaset
titles be the same size regardless of their location within a section hierarchy, then you need to set that font size in each of attribute-sets with level
in their name.
By default, qandadiv
elements have numbered titles. You can set the qandadiv.autolabel
parameter to zero to turn off the numbering of the
qandadiv
titles.
DocBook XSL: The Complete Guide - 3rd Edition | PDF version available | Copyright © 2002-2005 Sagehill Enterprises |