qandaset
qandaset — A question-and-answer set.
Synopsis
- Sequence of:
- One of:
- Zero or more of:
annotation
bridgehead
remark
revhistory
- Indexing inlines
- Admonition elements
- Formal elements
- Graphic elements
- Informal elements
informalequation
informalexample
informalfigure
informaltable
(db.cals.informaltable)informaltable
(db.html.informaltable)
- List elements
- Paragraph elements
- Publishing elements
- Synopsis elements
- Technical elements
- Verbatim elements
- One of:
- One or more of:
- One or more of:
- One of:
Additional Constraints
- If this element is the root element, it must have a version attribute.
Description
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
.
Processing expectations
Formatted as a displayed block. The defaultlabel
attribute has a significant
influence on the presentation of question
s and
answer
s.
Attributes
- defaultlabel
Specifies the default labelling
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>
Q: | To be, or not to be? |
That is the question. |
<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>
General Information
...
Font Houses
.1. | Who sells lots of fonts? |
. | Adobe Systems, Inc. |
.2. | Who sells fonts and photos? |
. | Veer |