    | DocBook: The Definitive Guide 0.0.12 for DocBook V5.0b1 (Alpha) |
| | DocBook: The Definitive Guide 0.0.12 for DocBook V5.0b1 (Alpha) |
qandaset — A question-and-answer set
qandaset ::=
addressanchorannotationbibliolistblockquotebridgeheadcalloutlistcautionclasssynopsiscmdsynopsisconstraintdefconstructorsynopsisdestructorsynopsisepigraphequationexamplefieldsynopsisfigureformalparafuncsynopsisglosslisthtml:formimportantindexterm (db.indexterm.endofrange)indexterm (db.indexterm.singular)indexterm (db.indexterm.startofrange)informalequationinformalexampleinformalfigureinformaltable (db.cals.informaltable)informaltable (db.html.informaltable)itemizedlistliterallayoutmediaobjectmethodsynopsismsgsetnoteorderedlistparaprocedureproductionsetprogramlistingprogramlistingcoqandasetremarkrevhistoryscreenscreencoscreenshotsegmentedlistsidebarsimparasimplelistsynopsistable (db.cals.table)table (db.html.table)tasktipvariablelistwarningCommon attributes and common linking attributes.
Additional attributes:
A QandASet is a list consisting of
Questions and Answers.
QandASets 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 an
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
Questions and Answers.
Common attributes and common linking attributes.
FIXME:
Enumerated values: | |
|---|---|
| “none” | FIXME: |
| “number” | FIXME: |
| “qanda” | FIXME: |
These elements contain qandaset: annotation, answer, appendix, article, bibliodiv, bibliography, bibliolist, blockquote, callout, calloutlist, caption (db.caption), caution, chapter, colophon, constraintdef, dedication, entry, example, figure, footnote, glossary, glossdef, glossdiv, glosslist, html:fieldset, html:form, important, index, indexdiv, informalexample, informalfigure, itemizedlist, legalnotice, listitem, msgexplan, msgtext, note, orderedlist, para, partintro, preface, procedure, qandadiv, qandaset, question, refsect1, refsect2, refsect3, refsection, refsynopsisdiv, revdescription, sect1, sect2, sect3, sect4, sect5, section, setindex, sidebar, simplesect, step, taskprerequisites, taskrelated, tasksummary, td, textobject, th, tip, toc, tocdiv, variablelist, warning.
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, html:form, 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.
<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> <para>...</para> <qandaset> <qandadiv><title>General Information</title> <para>...</para> <qandadiv><title>Font Houses</title> <qandaentry><question><para>Adobe Systems, Inc.</para></question> <answer><para>...</para></answer> </qandaentry> <qandaentry><question><para>Agfa, Inc.</para></question> <answer><para>...</para></answer> </qandaentry> </qandadiv> </qandadiv> </qandaset> </article>
...
| | | |
| qandaentry | | question |