qandaset
qandaset — A question-and-answer set.
Synopsis
qandaset ::= ![[-]](figs/web/nav/down.gif)
![[+]](figs/web/nav/right.gif)
- Sequence of:
- One of:
- Zero or more of:
bridgeheaddialoguedramapoetryremarkrevhistory- Indexing inlines
- Admonition elements
- Formal elements
- Graphic elements
- Informal elements
- List elements
- Paragraph elements
- Publishing 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”
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
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, answer, appendix, article, bibliodiv, bibliography, bibliolist, blockquote, callout, calloutlist, caption, chapter, colophon, cover, dedication, dialogue, drama, entry, example, figure, footnote, glossary, glossdef, glossdiv, glosslist, index, informalexample, informalfigure, itemizedlist, legalnotice, linegroup, listitem, note, orderedlist, para, partintro, poetry, preface, procedure, qandadiv, qandaset, question, revdescription, section, setindex, sidebar, simplesect, step, taskprerequisites, taskrelated, tasksummary, textobject, toc, variablelist.
Children
The following elements occur in qandaset: address, anchor, bibliolist, blockquote, bridgehead, calloutlist, dialogue, drama, epigraph, equation, example, figure, formalpara, glosslist, indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), info (db.titleforbidden.info), info (db.titleonly.info), informalequation, informalexample, informalfigure, informaltable, itemizedlist, literallayout, mediaobject, note, orderedlist, para, poetry, procedure, qandadiv, qandaentry, qandaset, remark, revhistory, sidebar, simpara, simplelist, table, task, title, titleabbrev, variablelist.
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 |