qandaset — A question-and-answer set
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
+))
Common attributes and common linking attributes.
Additional attributes:
defaultlabel
(enumeration) = “none” | “number” | “qanda”
A qandaset
is a list consisting of
question
s and answer
s. A
qandaset
can be divided into sections.
Every entry in a qandaset
must contain a
question
, but answer
s are optional
(some questions have no answers), and may be repeated (some questions
have more than one answer).
Common uses for qandaset
s 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
.
Formatted as a displayed block. The defaultlabel
attribute has a significant
influence on the presentation of question
s and
answer
s.
Common attributes and common linking attributes.
Specifies the default labeling
Enumerated values: | |
---|---|
“none” | No labels |
“number” | Numeric labels |
“qanda” | “Q:” and “A:” labels |
<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>