<question>
Question
A question (request for an answer) used in the text or as part of a quiz, exam, etc.
Remarks
Questions (<question>) may be associated with their answer(s)(<answer>) or explanations (<explanation>). This association is encoded using the Pointer to Question (@pointer-to-question) attribute on the <answer> or the Pointer to Object Described in Explanation attribute on the <explanation>.
Pointing from within a question should be part of the text and be tagged with an internal (<xref>) or external (<ext-link>) link as appropriate.
Milestones for Explanations: Some BITS users write a
description or
explanation of a question and its answer(s) (<explanation>), which may
be long and full of sections, figures, and text. Other BITS users use <milestone-start>
and <milestone-end> elements to point to a section of the existing
narrative of the book that should be reread as an explanation of the answer to the question. Both
techniques are valid BITS.
Attributes
Content Model
<!ELEMENT question %question-model; >
Expanded Content Model
((object-id)*, sec-meta?, label?, title?, subtitle*, alt-title*, ((sec)+ | ((address | alternatives | answer | answer-set | array | boxed-text | chem-struct-wrap | code | explanation | fig | fig-group | graphic | media | name-address-wrap | preformat | question | question-wrap | question-wrap-group | supplementary-material | table-wrap | table-wrap-group | disp-formula | disp-formula-group | def-list | list | tex-math | mml:math | p | related-article | related-object | ack | disp-quote | speech | statement | verse-group | x)+, (sec)*)), (option)*, (notes | fn-group | glossary | ref-list | sig-block)*)
Description
The following, in order:
- <object-id> Object Identifier, zero or more
- <sec-meta> Section Metadata, zero or one
- <label> Label (of an Equation, Figure, Reference, etc.), zero or one
- <title> Title, zero or one
- <subtitle> Document Subtitle, zero or more
- <alt-title> Alternate Title, zero or more
- Any one of:
- <sec> Section, one or more
- The following, in order:
- One or more of any of:
- <address> Address/Contact Information
- <alternatives> Alternatives For Processing
- <answer> Answer to a Question
- <answer-set> Answer Set
- <array> Array (Simple Tabulation)
- <boxed-text> Boxed Text
- <chem-struct-wrap> Chemical Structure Wrapper
- <code> Code
- <explanation> Explanation
- <fig> Figure
- <fig-group> Figure Group
- <graphic> Graphic
- <media> Media Object
- <name-address-wrap> Name/Address Block Wrapper
- <preformat> Preformatted Text
- <question> Question
- <question-wrap> Question Wrapper
- <question-wrap-group> Question Wrapper Group
- <supplementary-material> Supplementary Material
- <table-wrap> Table Wrapper
- <table-wrap-group> Table Wrapper Group
- <disp-formula> Formula, Display
- <disp-formula-group> Formula, Display Group
- Lists
- Math Elements
- <p> Paragraph
- Related Material Elements
- <ack> Acknowledgments
- <disp-quote> Quote, Displayed
- <speech> Speech
- <statement> Statement, Formal
- <verse-group> Verse Form for Poetry
- <x> X - Generated Text and Punctuation
- <sec> Section, zero or more
- One or more of any of:
- <option> Option (of a question), zero or more
- Any combination of:
This element may be contained in:
<abstract>, <ack>, <answer>, <app>, <app-group>, <bio>, <body>, <book-app-group>, <boxed-text>, <disp-quote>, <explanation>, <glossary>, <index>, <index-div>, <index-group>, <license-p>, <named-book-part-body>, <named-content>, <notes>, <option>, <p>, <question>, <question-preamble>, <question-wrap>, <ref-list>, <sec>, <styled-content>, <td>, <th>, <toc>, <toc-div>, <toc-entry>, <toc-group>, <trans-abstract>
Example 1
Multiple-choice style question, giving options:
...
<sec id="sec45">...
<question-wrap>
<question id="q1" question-response-type="multiple-choice">
<label>1</label>
<p>Where was the first permanent English
settlement in the New World?</p>
<option correct="no">
<label>A</label><p>Plymouth</p>
</option>
<option correct="yes" id="q1b">
<label>B</label><p>Jamestown</p>
</option>
<option correct="no">
<label>C</label><p>Roanoke</p>
</option>
</question>
<explanation pointer-to-explained="q1b">
<p>Established by the Virginia Company of London, Jamestown
was the first permanent English settlement in the New World;
it flourished from 1607 to 1699. Although the Roanoke colony
was founded earlier (in 1587), that colony failed; upon returning
from a trip to England for supplies, its Governor found the
settlement abandoned. Although one of the earliest New England
colonies, Plymouth (in modern Massachusetts) was not founded
by the Pilgrims until 1620.</p>
</explanation>
</question-wrap>
</sec>
...
Example 2
True/False question, tagged as an answer:
...
<sec id="sec45">...
<question-wrap>
<question id="q2" question-response-type="true-false">
<p>Peregrine White was the first English
child born in North America.</p>
<answer pointer-to-question="q2" id="ans2"><p>False</p></answer>
</question>
<explanation pointer-to-explained="ans2">
<p>The first English child born in North America was
Virginia Dare. She was born in August 1587, in the
short-lived colony of Roanoke. Although the settlement
was later abandoned and the fate of its inhabitants a
mystery, records brought to England by her grandfather,
the governor of the colony, later in 1587 note her birth
and baptism. Born in November 1620, Peregrine White
was the first child born in the Plymouth colony.</p>
</explanation>
</question-wrap>
</sec>
...
Example 3
True/False question, tagged as two options:
...
<sec id="sec45">...
<question-wrap>
<question id="q2" question-response-type="multiple-choice">
<p>Peregrine White was the first English
child born in North America.</p>
<option correct="no"><p>True</p></option>
<option correct="yes" id="q2b"><p>False</p></option>
</question>
<explanation pointer-to-explained="q2b">
<p>The first English child born in North America was
Virginia Dare. She was born in August 1587, in the
short-lived colony of Roanoke (NC). Although the settlement
was later abandoned and the fate of its inhabitants a
mystery, records brought to England by her grandfather,
the governor of the colony, later in 1587 note her birth
and baptism. Born in November 1620, Peregrine White
was the first child born in the Plymouth colony (MA).</p>
</explanation>
</question-wrap>
</sec>
...