qandaset

qandaset — A question-and-answer set.

Synopsis

Sequence of:
- One of:
  - Sequence of:
    Interleave of:
    title?
    titleabbrev?
    info? (db.titleforbidden.info)
  - info (db.titleonly.info)
- Zero or more of:
  - annotation
  - bridgehead
  - remark
  - revhistory
  - Indexing inlines
    indexterm (db.indexterm.endofrange)
    indexterm (db.indexterm.singular)
    indexterm (db.indexterm.startofrange)
  - Admonition elements
    caution
    important
    note
    tip
    warning
  - Formal elements
    equation
    example
    figure
    table (db.cals.table)
    table (db.html.table)
  - Graphic elements
    mediaobject
    screenshot
  - Informal elements
    informalequation
    informalexample
    informalfigure
    informaltable (db.cals.informaltable)
    informaltable (db.html.informaltable)
  - List elements
    bibliolist
    calloutlist
    glosslist
    itemizedlist
    orderedlist
    procedure
    qandaset
    segmentedlist
    simplelist
    variablelist
  - Paragraph elements
    anchor
    formalpara
    para
    simpara
  - Publishing elements
    address
    blockquote
    epigraph
    sidebar
  - Synopsis elements
    classsynopsis
    cmdsynopsis
    constructorsynopsis
    destructorsynopsis
    fieldsynopsis
    funcsynopsis
    methodsynopsis
  - Technical elements
    constraintdef
    msgset
    procedure
    productionset
    task
  - Verbatim elements
    literallayout
    programlisting
    programlistingco
    screen
    screenco
    synopsis
- One of:
  - One or more of:
    qandadiv
  - One or more of:
    qandaentry

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

Formatted as a displayed block. The defaultlabel attribute has a significant influence on the presentation of questions and answers.

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

This element occurs in 73 elements.

Children

This element contains 65 elements.

Examples

  1 <article xmlns='http://docbook.org/ns/docbook'>
  2 <title>Example qandaset</title>
    
  4 <qandaset defaultlabel='qanda'>
      <qandaentry>
  6     <question>
          <para>To be, or not to be?</para>
  8     </question>
        <answer>
 10       <para>That is the question.</para>
        </answer>
 12   </qandaentry>
    </qandaset>
 14 
    </article>

Q:	To be, or not to be?
	That is the question.

  1 <article xmlns='http://docbook.org/ns/docbook'
  2 	 class="faq">
    <title>Frequently Asked Questions About Fonts</title>
  4 
    <qandaset>
  6   <qandadiv><title>General Information</title>
    
  8   <para>...</para>
    
 10   <qandadiv><title>Font Houses</title>
    
 12   <qandaentry><question><para>Who sells lots of fonts?</para></question>
      <answer><label>Seller</label><para>Adobe Systems, Inc.</para></answer>
 14   </qandaentry>
    
 16   <qandaentry><question><para>Who sells fonts and photos?</para></question>
      <answer><label>Seller</label><para>Veer</para></answer>
 18   </qandaentry>
    
 20   </qandadiv>
      </qandadiv>
 22 </qandaset>
    </article>

General Information

...

Font Houses

1.1.1.	Who sells lots of fonts?
.	Adobe Systems, Inc.
1.1.2.	Who sells fonts and photos?
.	Veer


qandaentry		question