Name
qandaset — A question-and-answer set
Synopsis
qandaset ::=
((((title? &
titleabbrev?),
info? db.titleforbidden.info) |
info db.titleonly.info),
(annotation | bridgehead |
remark | revhistory | Indexing inlines | Admonition elements | Formal elements | Graphic elements | Informal elements | List elements | Paragraph elements | Publishing elements | Synopsis elements | Technical elements | Verbatim elements)*,
(qandadiv+ | qandaentry+))
Attribute synopsis
Common attributes and common linking attributes.
Additional attributes:
defaultlabel(enumeration) = “none” | “number” | “qanda”
Description
A qandaset is a list consisting of
questions and answers. A
qandaset can be divided into sections.
Every entry in a qandaset must contain a
question, but answers are optional
(some questions have no answers), and may be repeated (some questions
have more than one answer).
Common uses for qandasets include reader
questionnaires and lists of Frequently Asked Questions
(FAQs). For the purpose of a FAQ,
DocBook V3.1 added the FAQ class
to article.
Processing expectations
Formatted as a displayed block. The defaultlabel attribute has a significant
influence on the presentation of questions and
answers.
Attributes
Common attributes and common linking attributes.
- defaultlabel
Specifies the default labeling
Enumerated values: “none” No labels
“number” Numeric labels
“qanda” “Q:” and “A:” labels
Examples
<article xmlns='http://docbook.org/ns/docbook'>
<title>Example qandaset</title>
<qandaset defaultlabel='qanda'>
<qandaentry>
<question>
<para>To be, or not to be?</para>
</question>
<answer>
<para>That is the question.</para>
</answer>
</qandaentry>
</qandaset>
</article><article xmlns='http://docbook.org/ns/docbook' class="faq"> <title>Frequently Asked Questions About Fonts</title> <qandaset> <qandadiv><title>General Information</title> <para>...</para> <qandadiv><title>Font Houses</title> <qandaentry><question><para>Who sells lots of fonts?</para></question> <answer><label>Seller</label><para>Adobe Systems, Inc.</para></answer> </qandaentry> <qandaentry><question><para>Who sells fonts and photos?</para></question> <answer><label>Seller</label><para>Veer</para></answer> </qandaentry> </qandadiv> </qandadiv> </qandaset> </article>