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:
Attributes
Common attributes and common linking attributes.
Additional attributes:
- defaultlabel (enumeration)
- “none”
- “number”
- “qanda”
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
Attributes
Common attributes and common linking attributes.
- defaultlabel
Specifies the default labelling
Enumerated values: “none” No labels
“number” Numeric labels
“qanda” "Q:" and "A:" labels
Parents
These elements contain qandaset
: acknowledgements
, annotation
, answer
, appendix
, article
, bibliodiv
, bibliography
, bibliolist
, blockquote
, callout
, calloutlist
, caption
(db.caption), caution
, chapter
, colophon
, constraintdef
, cover
, dedication
, entry
, example
, figure
, footnote
, glossary
, glossdef
, glossdiv
, glosslist
, important
, index
, indexdiv
, informalexample
, informalfigure
, itemizedlist
, legalnotice
, listitem
, msgexplan
, msgtext
, note
, orderedlist
, para
, partintro
, preface
, procedure
, qandadiv
, qandaset
, question
, refsect1
, refsect2
, refsect3
, refsection
, refsynopsisdiv
, result
, revdescription
, sect1
, sect2
, sect3
, sect4
, sect5
, section
, setindex
, sidebar
, simplesect
, step
, taskprerequisites
, taskrelated
, tasksummary
, td
, textobject
, th
, tip
, toc
, tocdiv
, topic
, variablelist
, warning
.
Children
The following elements occur in qandaset: address
, anchor
, annotation
, bibliolist
, blockquote
, bridgehead
, calloutlist
, caution
, classsynopsis
, cmdsynopsis
, constraintdef
, constructorsynopsis
, destructorsynopsis
, epigraph
, equation
, example
, fieldsynopsis
, figure
, formalpara
, funcsynopsis
, glosslist
, important
, indexterm
(db.indexterm.endofrange), indexterm
(db.indexterm.singular), indexterm
(db.indexterm.startofrange), info
(db.titleforbidden.info), info
(db.titleonly.info), informalequation
, informalexample
, informalfigure
, informaltable
(db.cals.informaltable), informaltable
(db.html.informaltable), itemizedlist
, literallayout
, mediaobject
, methodsynopsis
, msgset
, note
, orderedlist
, para
, procedure
, productionset
, programlisting
, programlistingco
, qandadiv
, qandaentry
, qandaset
, remark
, revhistory
, screen
, screenco
, screenshot
, segmentedlist
, sidebar
, simpara
, simplelist
, synopsis
, table
(db.cals.table), table
(db.html.table), task
, tip
, title
, titleabbrev
, variablelist
, warning
.
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 |