Skip to content

E
edx-platform
Commit 366f5246 by Mark Hoeber
Options

Merge pull request #2644 from edx/sylvia/documentation/BLD-842 

Sylvia/documentation/bld 842
parents 0deb47a4 089443c2
Showing with 77 additions and 78 deletions
docs/en_us/course_authors/source/additional_tools.rst
...@@ -111,7 +111,7 @@ Chemical Equation Problem Code ...@@ -111,7 +111,7 @@ Chemical Equation Problem Code
\( \text{H}_2\text{SO}_4 \longrightarrow \text { H}^+ + \text{ HSO}_4^-\) \( \text{H}_2\text{SO}_4 \longrightarrow \text { H}^+ + \text{ HSO}_4^-\)
<customresponse> <customresponse>
<chemicalequationinput size="50"/> <chemicalequationinput size="50" label="Enter the chemical equation"/>
<answer type="loncapa/python"> <answer type="loncapa/python">
if chemcalc.chemical_equations_equal(submission[0], 'H2SO4 -> H^+ + HSO4^-'): if chemcalc.chemical_equations_equal(submission[0], 'H2SO4 -> H^+ + HSO4^-'):
......
docs/en_us/course_authors/source/advanced_problems.rst
...@@ -34,6 +34,8 @@ These problems are easy to access in Studio. To create them, click ...@@ -34,6 +34,8 @@ These problems are easy to access in Studio. To create them, click
**Problem** under **Add New Component**, click the **Advanced** tab, and **Problem** under **Add New Component**, click the **Advanced** tab, and
then click the name of the problem that you want to create. then click the name of the problem that you want to create.
To add a label for an advanced problem, you'll add a **label** attribute to one of the XML tags for the problem. For more information, see :ref:`Appendix E`.
.. _Circuit Schematic Builder: .. _Circuit Schematic Builder:
...@@ -139,8 +141,6 @@ file that you'll download. ...@@ -139,8 +141,6 @@ file that you'll download.
#. In the problem component editor, replace the example code with the code below. #. In the problem component editor, replace the example code with the code below.
#. Click **Save.** #. Click **Save.**
JavaScript Input Problem Code JavaScript Input Problem Code
############################# #############################
...@@ -183,25 +183,17 @@ JavaScript Input Problem Code ...@@ -183,25 +183,17 @@ JavaScript Input Problem Code
.. note:: When you create this problem, keep the following in mind. .. note:: When you create this problem, keep the following in mind.
- The webGLDemo.js file defines the three JavaScript functions (**WebGLDemo.getGrade**, - The webGLDemo.js file defines the three JavaScript functions (**WebGLDemo.getGrade**, **WebGLDemo.getState**, and **WebGLDemo.setState**).
**WebGLDemo.getState**, and **WebGLDemo.setState**).
- The JavaScript input problem code uses **WebGLDemo.getGrade**, **WebGLDemo.getState**, - The JavaScript input problem code uses **WebGLDemo.getGrade**, **WebGLDemo.getState**, and **WebGLDemo.setState** to grade, save, or restore a problem. These functions must be global in scope.
and **WebGLDemo.setState** to grade, save, or restore a problem. These functions must
be global in scope.
- **WebGLDemo.getState** and **WebGLDemo.setState** are optional. You only have to define - **WebGLDemo.getState** and **WebGLDemo.setState** are optional. You only have to define these functions if you want to conserve the state of the problem.
these functions if you want to conserve the state of the problem.
- **Width** and **height** represent the dimensions of the IFrame that holds the - **Width** and **height** represent the dimensions of the IFrame that holds the application.
application.
- When the problem opens, the cone and the cube are both blue, or "unselected." When - When the problem opens, the cone and the cube are both blue, or "unselected." When you click either shape once, the shape becomes yellow, or "selected." To unselect the shape, click it again. Continue clicking the shape to select and unselect it.
you click either shape once, the shape becomes yellow, or "selected." To unselect
the shape, click it again. Continue clicking the shape to select and unselect it.
- The response is graded as correct if the cone is selected (yellow) when the user - The response is graded as correct if the cone is selected (yellow) when the user clicks **Check**.
clicks **Check**.
- Clicking **Check** or **Save** registers the problem's current state. - Clicking **Check** or **Save** registers the problem's current state.
......
docs/en_us/course_authors/source/appendices/e.rst
...@@ -41,6 +41,9 @@ Most problems have the following tags. ...@@ -41,6 +41,9 @@ Most problems have the following tags.
* - ``<solution> <div class="detailed-solution"> </div> </solution>`` (optional) * - ``<solution> <div class="detailed-solution"> </div> </solution>`` (optional)
- If you want to include more information in the problem, such as a detailed explanation of the problem's answer, you'll enter the text between the two ``<div>`` tags, which are inside the ``<solution>`` tags. (These tags do not have to be on the same line.) - If you want to include more information in the problem, such as a detailed explanation of the problem's answer, you'll enter the text between the two ``<div>`` tags, which are inside the ``<solution>`` tags. (These tags do not have to be on the same line.)
Additionally, all problems must include a **label** attribute. This attribute adds a descriptive label that helps visually impaired students navigate through the problem.
You'll add a **label** attribute to one of the XML tags for the problem. Each example problem below includes a label.
.. _Choice Response: .. _Choice Response:
Choice Response (Checkbox Problems) Choice Response (Checkbox Problems)
...@@ -61,7 +64,7 @@ Although you can create checkbox problems by using the Simple Editor in Studio, ...@@ -61,7 +64,7 @@ Although you can create checkbox problems by using the Simple Editor in Studio,
* - ``<choiceresponse>`` * - ``<choiceresponse>``
- Specifies that the problem lists answer options for students to choose from. - Specifies that the problem lists answer options for students to choose from.
* - ``<checkboxgroup>`` * - ``<checkboxgroup>``
- A child of ``<choiceresponse>``. Specifies that the problem is a checkbox problem. - A child of ``<choiceresponse>``. Specifies that the problem is a checkbox problem. Can include a ``direction`` attribute and a ``label`` attribute.
* - ``<choice>`` * - ``<choice>``
- A child of ``<checkboxgroup>``. Designates an answer option. Each choice must include the ``correct`` attribute, set to ``true`` (for a correct answer) or ``false`` (for an incorrect answer). For checkbox problems, more than one option can be a correct answer. - A child of ``<checkboxgroup>``. Designates an answer option. Each choice must include the ``correct`` attribute, set to ``true`` (for a correct answer) or ``false`` (for an incorrect answer). For checkbox problems, more than one option can be a correct answer.
...@@ -75,7 +78,7 @@ Although you can create checkbox problems by using the Simple Editor in Studio, ...@@ -75,7 +78,7 @@ Although you can create checkbox problems by using the Simple Editor in Studio,
difficult. Check all of the reasons below why this may be the case.</p> difficult. Check all of the reasons below why this may be the case.</p>
<choiceresponse> <choiceresponse>
<checkboxgroup> <checkboxgroup direction="vertical" label="Check all of the reasons below why this may be the case">
<choice correct="true"><text>A large amount of time passes between undertaking <choice correct="true"><text>A large amount of time passes between undertaking
a preventative measure and seeing the result.</text></choice> a preventative measure and seeing the result.</text></choice>
<choice correct="false"><text>Non-immunized people will always fall sick.</text> <choice correct="false"><text>Non-immunized people will always fall sick.</text>
...@@ -112,7 +115,7 @@ Although you can create checkbox problems by using the Simple Editor in Studio, ...@@ -112,7 +115,7 @@ Although you can create checkbox problems by using the Simple Editor in Studio,
<choiceresponse> <choiceresponse>
<checkboxgroup> <checkboxgroup direction="vertical" label="label text">
<choice correct="false"><text>Answer option 1 (incorrect)</text></choice> <choice correct="false"><text>Answer option 1 (incorrect)</text></choice>
<choice correct="true"><text>Answer option 2 (correct)</text></choice> <choice correct="true"><text>Answer option 2 (correct)</text></choice>
</checkboxgroup> </checkboxgroup>
...@@ -147,7 +150,7 @@ In chemical equation problems, students enter text that represents a chemical eq ...@@ -147,7 +150,7 @@ In chemical equation problems, students enter text that represents a chemical eq
* - ``<customresponse>`` * - ``<customresponse>``
- Indicates that this problem has a custom response. The ``<customresponse>`` tags must surround the ``<chemicalequation>`` tags. - Indicates that this problem has a custom response. The ``<customresponse>`` tags must surround the ``<chemicalequation>`` tags.
* - ``<chemicalequationinput>`` * - ``<chemicalequationinput>``
- A child of ``<customresponse>``. Indicates that the answer to this problem is a chemical equation. - A child of ``<customresponse>``. Indicates that the answer to this problem is a chemical equation. Must contain the ``size`` and ``label`` attributes.
* - ``<answer type=loncapa/python>`` * - ``<answer type=loncapa/python>``
- A child of ``<chemicalequationinput>``. Contains the Python script that grades the problem. - A child of ``<chemicalequationinput>``. Contains the Python script that grades the problem.
...@@ -164,7 +167,7 @@ Chemical equation problems use MathJax to create formulas. For more information ...@@ -164,7 +167,7 @@ Chemical equation problems use MathJax to create formulas. For more information
\( \text{H}_2\text{SO}_4 \longrightarrow \text { H}^+ + \text{ HSO}_4^-\) \( \text{H}_2\text{SO}_4 \longrightarrow \text { H}^+ + \text{ HSO}_4^-\)
<customresponse> <customresponse>
<chemicalequationinput size="50"/> <chemicalequationinput size="50" label="Practice by writing out the following reaction in the box below."/>
<answer type="loncapa/python"> <answer type="loncapa/python">
if chemcalc.chemical_equations_equal(submission[0], 'H2SO4 -> H^+ + HSO4^-'): if chemcalc.chemical_equations_equal(submission[0], 'H2SO4 -> H^+ + HSO4^-'):
...@@ -202,7 +205,7 @@ Chemical equation problems use MathJax to create formulas. For more information ...@@ -202,7 +205,7 @@ Chemical equation problems use MathJax to create formulas. For more information
<p>Problem text</p> <p>Problem text</p>
<customresponse> <customresponse>
<chemicalequationinput size="50"/> <chemicalequationinput size="50" label="label text"/>
<answer type="loncapa/python"> <answer type="loncapa/python">
if chemcalc.chemical_equations_equal(submission[0], 'TEXT REPRESENTING CHEMICAL EQUATION'): if chemcalc.chemical_equations_equal(submission[0], 'TEXT REPRESENTING CHEMICAL EQUATION'):
...@@ -246,7 +249,7 @@ In custom Python-evaluated input (also called “write-your-own-grader”) probl ...@@ -246,7 +249,7 @@ In custom Python-evaluated input (also called “write-your-own-grader”) probl
* - ``<customresponse cfn="test_add" expect="20">`` * - ``<customresponse cfn="test_add" expect="20">``
- -
* - <textline size="10" correct_answer="3"/> * - <textline size="10" correct_answer="3"/>
- This tag includes the ``size`` and ``correct_answer`` attributes. The ``correct_answer`` attribute is optional. - This tag includes the ``size``, ``correct_answer``, and ``label`` attributes. The ``correct_answer`` attribute is optional.
**Sample Problem XML**: **Sample Problem XML**:
...@@ -272,14 +275,14 @@ In custom Python-evaluated input (also called “write-your-own-grader”) probl ...@@ -272,14 +275,14 @@ In custom Python-evaluated input (also called “write-your-own-grader”) probl
<p>Part 1: Enter two integers that sum to 10. </p> <p>Part 1: Enter two integers that sum to 10. </p>
<customresponse cfn="test_add_to_ten"> <customresponse cfn="test_add_to_ten">
<textline size="10" correct_answer="3"/><br/> <textline size="10" correct_answer="3" label="Integer #1"/><br/>
<textline size="10" correct_answer="7"/> <textline size="10" correct_answer="7" label="Integer #2"/>
</customresponse> </customresponse>
<p>Part 2: Enter two integers that sum to 20. </p> <p>Part 2: Enter two integers that sum to 20. </p>
<customresponse cfn="test_add" expect="20"> <customresponse cfn="test_add" expect="20">
<textline size="10"/><br/> <textline size="10" label="Integer #1"/><br/>
<textline size="10"/> <textline size="10" label="Integer #2"/>
</customresponse> </customresponse>
<solution> <solution>
...@@ -309,8 +312,8 @@ The following template includes answers that appear when the student clicks **Sh ...@@ -309,8 +312,8 @@ The following template includes answers that appear when the student clicks **Sh
<p>Problem text</p> <p>Problem text</p>
<customresponse cfn="test_add" expect="20"> <customresponse cfn="test_add" expect="20">
<textline size="10" correct_answer="11"/><br/> <textline size="10" correct_answer="11" label="Integer #1"/><br/>
<textline size="10" correct_answer="9"/> <textline size="10" correct_answer="9" label="Integer #2"/>
</customresponse> </customresponse>
<solution> <solution>
...@@ -337,8 +340,8 @@ The following template does not return answers when the student clicks **Show An ...@@ -337,8 +340,8 @@ The following template does not return answers when the student clicks **Show An
<p>Enter two real numbers that sum to 20: </p> <p>Enter two real numbers that sum to 20: </p>
<customresponse cfn="test_add" expect="20"> <customresponse cfn="test_add" expect="20">
<textline size="10" /><br/> <textline size="10" label="Integer #1"/><br/>
<textline size="10" /> <textline size="10" label="Integer #2"/>
</customresponse> </customresponse>
<solution> <solution>
...@@ -366,11 +369,9 @@ Formula Response (Math Expression Input Problems) ...@@ -366,11 +369,9 @@ Formula Response (Math Expression Input Problems)
* - ``<formularesponse>`` * - ``<formularesponse>``
- -
* - ``<formulaequationinput>`` * - ``<formulaequationinput>``
- - This tag includes the ``size`` and ``label`` attributes.
* - ``<script type="loncapa/python">`` * - ``<script type="loncapa/python">``
- -
* - ``<textline size="10" correct_answer="3"/>``
- This tag includes the ``size`` and ``correct_answer`` attributes. The ``correct_answer`` attribute is optional.
**Sample Problem XML** **Sample Problem XML**
...@@ -390,7 +391,7 @@ Formula Response (Math Expression Input Problems) ...@@ -390,7 +391,7 @@ Formula Response (Math Expression Input Problems)
<p>Write an expression for the product of R_1, R_2, and the inverse of R_3.</p> <p>Write an expression for the product of R_1, R_2, and the inverse of R_3.</p>
<formularesponse type="ci" samples="R_1,R_2,R_3@1,2,3:3,4,5#10" answer="$VoVi"> <formularesponse type="ci" samples="R_1,R_2,R_3@1,2,3:3,4,5#10" answer="$VoVi">
<responseparam type="tolerance" default="0.00001"/> <responseparam type="tolerance" default="0.00001"/>
<formulaequationinput size="20" /> <formulaequationinput size="40" label="Enter the equation"/>
</formularesponse> </formularesponse>
<script type="loncapa/python"> <script type="loncapa/python">
...@@ -403,7 +404,7 @@ Formula Response (Math Expression Input Problems) ...@@ -403,7 +404,7 @@ Formula Response (Math Expression Input Problems)
</script> </script>
<formularesponse type="ci" samples="x,n@1,2:3,4#10" answer="$derivative"> <formularesponse type="ci" samples="x,n@1,2:3,4#10" answer="$derivative">
<responseparam type="tolerance" default="0.00001"/> <responseparam type="tolerance" default="0.00001"/>
<formulaequationinput size="20" /> <formulaequationinput size="40" label="Enter the equation"/>
</formularesponse> </formularesponse>
<solution> <solution>
...@@ -422,7 +423,7 @@ Formula Response (Math Expression Input Problems) ...@@ -422,7 +423,7 @@ Formula Response (Math Expression Input Problems)
<p>Problem text</p> <p>Problem text</p>
<formularesponse type="ci" samples="VARIABLES@LOWER_BOUNDS:UPPER_BOUNDS#NUMBER_OF_SAMPLES" answer="$VoVi"> <formularesponse type="ci" samples="VARIABLES@LOWER_BOUNDS:UPPER_BOUNDS#NUMBER_OF_SAMPLES" answer="$VoVi">
<responseparam type="tolerance" default="0.00001"/> <responseparam type="tolerance" default="0.00001"/>
<formulaequationinput size="20" /> <formulaequationinput size="20" label="Enter the equation"/>
</formularesponse> </formularesponse>
<script type="loncapa/python"> <script type="loncapa/python">
...@@ -549,7 +550,7 @@ Although you can create multiple choice problems by using the Simple Editor in S ...@@ -549,7 +550,7 @@ Although you can create multiple choice problems by using the Simple Editor in S
* - ``<multiplechoiceresponse>`` * - ``<multiplechoiceresponse>``
- Indicates that the problem is a multiple choice problem. - Indicates that the problem is a multiple choice problem.
* - ``<choicegroup type="MultipleChoice">`` * - ``<choicegroup type="MultipleChoice">``
- Indicates the beginning of the list of options. - Indicates the beginning of the list of options. Contains the ``label`` attribute.
* - ``<choice>`` * - ``<choice>``
- Lists an option. This tag includes the ``correct`` and ``name`` attributes. - Lists an option. This tag includes the ``correct`` and ``name`` attributes.
...@@ -560,7 +561,7 @@ Although you can create multiple choice problems by using the Simple Editor in S ...@@ -560,7 +561,7 @@ Although you can create multiple choice problems by using the Simple Editor in S
<problem> <problem>
<p>Lateral inhibition, as was first discovered in the horsehoe crab...</p> <p>Lateral inhibition, as was first discovered in the horsehoe crab...</p>
<multiplechoiceresponse> <multiplechoiceresponse>
<choicegroup type="MultipleChoice"> <choicegroup type="MultipleChoice" label="Lateral inhibition, as was first discovered in the horsehoe crab">
<choice correct="false">is a property of touch sensation, referring to the ability of crabs to detect nearby predators.</choice> <choice correct="false">is a property of touch sensation, referring to the ability of crabs to detect nearby predators.</choice>
<choice correct="false">is a property of hearing, referring to the ability of crabs to detect low frequency noises.</choice> <choice correct="false">is a property of hearing, referring to the ability of crabs to detect low frequency noises.</choice>
<choice correct="false">is a property of vision, referring to the ability of crabs eyes to enhance contrasts.</choice> <choice correct="false">is a property of vision, referring to the ability of crabs eyes to enhance contrasts.</choice>
...@@ -584,7 +585,7 @@ Although you can create multiple choice problems by using the Simple Editor in S ...@@ -584,7 +585,7 @@ Although you can create multiple choice problems by using the Simple Editor in S
<problem> <problem>
<p>Question text</p> <p>Question text</p>
<multiplechoiceresponse> <multiplechoiceresponse>
<choicegroup type="MultipleChoice"> <choicegroup type="MultipleChoice" label="label text">
<choice correct="false" name="a">Incorrect choice</choice> <choice correct="false" name="a">Incorrect choice</choice>
<choice correct="true" name="b">Correct choice</choice> <choice correct="true" name="b">Correct choice</choice>
</choicegroup> </choicegroup>
...@@ -653,14 +654,14 @@ Sample Problem: ...@@ -653,14 +654,14 @@ Sample Problem:
<p>What base is the decimal numeral system in? <p>What base is the decimal numeral system in?
<numericalresponse answer="10"> <numericalresponse answer="10">
<formulaequationinput /> <formulaequationinput label="What base is the decimal numeral system in?"/>
</numericalresponse> </numericalresponse>
</p> </p>
<p>What is the value of the standard gravity constant <i>g</i>, measured in m/s<sup>2</sup>? Give your answer to at least two decimal places. <p>What is the value of the standard gravity constant <i>g</i>, measured in m/s<sup>2</sup>? Give your answer to at least two decimal places.
<numericalresponse answer="9.80665"> <numericalresponse answer="9.80665">
<responseparam type="tolerance" default="0.01" /> <responseparam type="tolerance" default="0.01" />
<formulaequationinput /> <formulaequationinput label="Give your answer to at least two decimal places"/>
</numericalresponse> </numericalresponse>
</p> </p>
...@@ -672,7 +673,7 @@ Sample Problem: ...@@ -672,7 +673,7 @@ Sample Problem:
<p>What is the distance in the plane between the points (pi, 0) and (0, e)? You can type math. <p>What is the distance in the plane between the points (pi, 0) and (0, e)? You can type math.
<numericalresponse answer="$computed_response"> <numericalresponse answer="$computed_response">
<responseparam type="tolerance" default="0.0001" /> <responseparam type="tolerance" default="0.0001" />
<formulaequationinput /> <formulaequationinput label="What is the distance in the plane between the points (pi, 0) and (0, e)?"/>
</numericalresponse> </numericalresponse>
</p> </p>
<solution> <solution>
...@@ -701,7 +702,7 @@ Exact values ...@@ -701,7 +702,7 @@ Exact values
<problem> <problem>
<numericalresponse answer="10"> <numericalresponse answer="10">
<formulaequationinput /> <formulaequationinput label="label text"/>
</numericalresponse> </numericalresponse>
<solution> <solution>
...@@ -719,7 +720,7 @@ Answers with decimal precision ...@@ -719,7 +720,7 @@ Answers with decimal precision
<numericalresponse answer="9.80665"> <numericalresponse answer="9.80665">
<responseparam type="tolerance" default="0.01" /> <responseparam type="tolerance" default="0.01" />
<formulaequationinput /> <formulaequationinput label="label text"/>
</numericalresponse> </numericalresponse>
<solution> <solution>
...@@ -737,7 +738,7 @@ Answers with percentage precision ...@@ -737,7 +738,7 @@ Answers with percentage precision
<numericalresponse answer="100"> <numericalresponse answer="100">
<responseparam type="tolerance" default="10%" /> <responseparam type="tolerance" default="10%" />
<formulaequationinput /> <formulaequationinput label="label text"/>
</numericalresponse> </numericalresponse>
<solution> <solution>
...@@ -760,7 +761,7 @@ Answers with scripts ...@@ -760,7 +761,7 @@ Answers with scripts
<numericalresponse answer="$computed_response"> <numericalresponse answer="$computed_response">
<responseparam type="tolerance" default="0.0001" /> <responseparam type="tolerance" default="0.0001" />
<formulaequationinput /> <formulaequationinput label="label text"/>
</numericalresponse> </numericalresponse>
<solution> <solution>
...@@ -932,7 +933,7 @@ Although you can create dropdown problems by using the Simple Editor in Studio, ...@@ -932,7 +933,7 @@ Although you can create dropdown problems by using the Simple Editor in Studio,
* - ``<optionresponse>`` * - ``<optionresponse>``
- Indicates that the problem is a dropdown problem. - Indicates that the problem is a dropdown problem.
* - ``<optioninput>`` * - ``<optioninput>``
- Lists the answer options. This tag includes the ``options`` and ``correct`` attributes. - Lists the answer options. This tag includes the ``options``, ``correct``, and ``label`` attributes.
**Problem Code:** **Problem Code:**
...@@ -946,15 +947,15 @@ Although you can create dropdown problems by using the Simple Editor in Studio, ...@@ -946,15 +947,15 @@ Although you can create dropdown problems by using the Simple Editor in Studio,
<p>What type of data are the following?</p> <p>What type of data are the following?</p>
<p>Age:</p> <p>Age:</p>
<optionresponse> <optionresponse>
<optioninput options="('Nominal','Discrete','Continuous')" correct="Continuous"/> <optioninput options="('Nominal','Discrete','Continuous')" correct="Continuous" label="Age"/>
</optionresponse> </optionresponse>
<p>Age, rounded to the nearest year:</p> <p>Age, rounded to the nearest year:</p>
<optionresponse> <optionresponse>
<optioninput options="('Nominal','Discrete','Continuous')" correct="Discrete"/> <optioninput options="('Nominal','Discrete','Continuous')" correct="Discrete" label="Age, rounded to the nearest year"/>
</optionresponse> </optionresponse>
<p>Life stage - infant, child, and adult:</p> <p>Life stage - infant, child, and adult:</p>
<optionresponse> <optionresponse>
<optioninput options="('Nominal','Discrete','Continuous')" correct="Nominal"/> <optioninput options="('Nominal','Discrete','Continuous')" correct="Nominal" label="Life stage"/>
</optionresponse> </optionresponse>
</problem> </problem>
...@@ -966,7 +967,7 @@ Although you can create dropdown problems by using the Simple Editor in Studio, ...@@ -966,7 +967,7 @@ Although you can create dropdown problems by using the Simple Editor in Studio,
<p> <p>
Problem text</p> Problem text</p>
<optionresponse> <optionresponse>
<optioninput options="('Option 1','Option 2','Option 3')" correct="Option 2"/> <optioninput options="('Option 1','Option 2','Option 3')" correct="Option 2" label="label text"/>
</optionresponse> </optionresponse>
<solution> <solution>
<div class="detailed-solution"> <div class="detailed-solution">
...@@ -983,6 +984,7 @@ Although you can create dropdown problems by using the Simple Editor in Studio, ...@@ -983,6 +984,7 @@ Although you can create dropdown problems by using the Simple Editor in Studio,
<optionresponse> <optionresponse>
options="('A','B')" options="('A','B')"
correct="A"/> correct="A"/>
label="label text"
</optionresponse> </optionresponse>
<solution> <solution>
...@@ -1103,7 +1105,7 @@ You can add ``regexp`` to the value of the ``type`` attribute, for example: ``ty ...@@ -1103,7 +1105,7 @@ You can add ``regexp`` to the value of the ``type`` attribute, for example: ``ty
* - ``<stringresponse>`` * - ``<stringresponse>``
- Indicates that the problem is a text input problem. - Indicates that the problem is a text input problem.
* - ``<textline>`` * - ``<textline>``
- Child of ``<stringresponse>``. Lists the answer options. - Child of ``<stringresponse>``. Lists the answer options and contains the ``label`` attribute.
* - ``<additional_answer>`` (optional) * - ``<additional_answer>`` (optional)
- Specifies an additional correct answer for the problem. A problem can contain an unlimited number of additional answers. - Specifies an additional correct answer for the problem. A problem can contain an unlimited number of additional answers.
* - ``<hintgroup>`` (optional) * - ``<hintgroup>`` (optional)
...@@ -1129,7 +1131,7 @@ You can add ``regexp`` to the value of the ``type`` attribute, for example: ``ty ...@@ -1129,7 +1131,7 @@ You can add ``regexp`` to the value of the ``type`` attribute, for example: ``ty
<stringresponse answer=".*herd immunity.*" type="ci regexp"> <stringresponse answer=".*herd immunity.*" type="ci regexp">
<additional_answer>community immunity</additional_answer> <additional_answer>community immunity</additional_answer>
<additional_answer>population immunity</additional_answer> <additional_answer>population immunity</additional_answer>
<textline size="20"/> <textline size="20" label="What is the technical term that refers to the fact that, when enough people sleep under a bednet, the disease may altogether disappear?"/>
<hintgroup> <hintgroup>
<stringhint answer="contact immunity" type="ci" name="contact_immunity_hint" /> <stringhint answer="contact immunity" type="ci" name="contact_immunity_hint" />
<hintpart on="contact_immunity_hint"> <hintpart on="contact_immunity_hint">
...@@ -1162,7 +1164,7 @@ You can add ``regexp`` to the value of the ``type`` attribute, for example: ``ty ...@@ -1162,7 +1164,7 @@ You can add ``regexp`` to the value of the ``type`` attribute, for example: ``ty
<stringresponse answer="**.Correct answer 1.**" type="ci regexp"> <stringresponse answer="**.Correct answer 1.**" type="ci regexp">
<additional_answer>Correct answer 2</additional_answer> <additional_answer>Correct answer 2</additional_answer>
<additional_answer>Correct answer 3</additional_answer> <additional_answer>Correct answer 3</additional_answer>
<textline size="20"/> <textline size="20" label="label text"/>
<hintgroup> <hintgroup>
<stringhint answer="Incorrect answer A" type="ci" name="hintA" /> <stringhint answer="Incorrect answer A" type="ci" name="hintA" />
<hintpart on="hintA"> <hintpart on="hintA">
......
docs/en_us/course_authors/source/common_problems.rst
...@@ -30,6 +30,8 @@ Types** tab, and then click the name of the problem. (Note that ...@@ -30,6 +30,8 @@ Types** tab, and then click the name of the problem. (Note that
**Checkbox** doesn't appear in the list of common problem types. To **Checkbox** doesn't appear in the list of common problem types. To
create a checkbox problem, you'll click **Blank Common Problem**.) create a checkbox problem, you'll click **Blank Common Problem**.)
To add labels to these problems, enclose the text that you want to use as a label in two sets of angle brackets (<<>>).
.. _Checkbox: .. _Checkbox:
******************* *******************
...@@ -53,6 +55,7 @@ Create a Checkbox Problem ...@@ -53,6 +55,7 @@ Create a Checkbox Problem
#. In the Problem component that appears, click **Edit**. #. In the Problem component that appears, click **Edit**.
#. In the component editor, replace the default text with the text of your #. In the component editor, replace the default text with the text of your
problem. Enter each answer option on its own line. problem. Enter each answer option on its own line.
#. Determine the text of the problem to use as a label, and then surround that text with two sets of angle brackets (<<>>).
#. Select all the answer options, and then click the checkbox button. #. Select all the answer options, and then click the checkbox button.
.. image:: Images/ProbComponent_CheckboxIcon.gif .. image:: Images/ProbComponent_CheckboxIcon.gif
...@@ -76,7 +79,7 @@ following. ...@@ -76,7 +79,7 @@ following.
:: ::
Learning about the benefits of preventative healthcare can be particularly Learning about the benefits of preventative healthcare can be particularly
difficult. Check all of the reasons below why this may be the case. difficult. >>Check all of the reasons below why this may be the case.<<
[x] A large amount of time passes between undertaking a preventative measure [x] A large amount of time passes between undertaking a preventative measure
and seeing the result. and seeing the result.
...@@ -122,6 +125,7 @@ To create a dropdown problem, follow these steps. ...@@ -122,6 +125,7 @@ To create a dropdown problem, follow these steps.
#. In the new Problem component that appears, click **Edit**. #. In the new Problem component that appears, click **Edit**.
#. Replace the default text with the text for your problem. Enter each of the possible #. Replace the default text with the text for your problem. Enter each of the possible
answers on the same line, separated by commas. answers on the same line, separated by commas.
#. Determine the text of the problem to use as a label, and then surround that text with two sets of angle brackets (<<>>).
#. Select all the answer options, and then click the dropdown button. #. Select all the answer options, and then click the dropdown button.
.. image:: Images/ProbCompButton_Dropdown.gif .. image:: Images/ProbCompButton_Dropdown.gif
...@@ -145,7 +149,7 @@ following. ...@@ -145,7 +149,7 @@ following.
:: ::
What type of data are the following? >>What type of data are the following?<<
Age: Age:
[[Nominal, Discrete, (Continuous)]] [[Nominal, Discrete, (Continuous)]]
...@@ -180,6 +184,7 @@ Create a Multiple Choice Problem ...@@ -180,6 +184,7 @@ Create a Multiple Choice Problem
#. When the new Problem component appears, click **Edit**. #. When the new Problem component appears, click **Edit**.
#. In the component editor, replace the sample problem text with the text of your #. In the component editor, replace the sample problem text with the text of your
problem. Enter each answer option on its own line. problem. Enter each answer option on its own line.
#. Determine the text of the problem to use as a label, and then surround that text with two sets of angle brackets (<<>>).
#. Select all the answer options, and then click the multiple choice button. #. Select all the answer options, and then click the multiple choice button.
.. image:: Images/ProbCompButton_MultChoice.gif .. image:: Images/ProbCompButton_MultChoice.gif
...@@ -204,7 +209,7 @@ following. ...@@ -204,7 +209,7 @@ following.
:: ::
Lateral inhibition, as was first discovered in the horsehoe crab: >>Lateral inhibition, as was first discovered in the horsehoe crab:<<
( ) is a property of touch sensation, referring to the ability of crabs to ( ) is a property of touch sensation, referring to the ability of crabs to
detect nearby predators. detect nearby predators.
...@@ -261,7 +266,7 @@ Create a Numerical Input Problem ...@@ -261,7 +266,7 @@ Create a Numerical Input Problem
Input** on the **Common Problem Types** tab. Input** on the **Common Problem Types** tab.
#. When the new Problem component appears, click **Edit**. #. When the new Problem component appears, click **Edit**.
#. In the component editor, replace the sample problem text with your own text. #. In the component editor, replace the sample problem text with your own text.
#. Determine the text of the problem to use as a label, and then surround that text with two sets of angle brackets (<<>>).
#. Select the text of the answer, and then click the numerical input button. #. Select the text of the answer, and then click the numerical input button.
.. image:: Images/ProbCompButton_NumInput.gif .. image:: Images/ProbCompButton_NumInput.gif
...@@ -291,7 +296,7 @@ following. ...@@ -291,7 +296,7 @@ following.
:: ::
How many different countries do edX students live in as of May 2013? >>How many different countries do edX students live in as of May 2013?<<
= 193 +- 5% = 193 +- 5%
...@@ -343,6 +348,7 @@ To create a text input problem, follow these steps. ...@@ -343,6 +348,7 @@ To create a text input problem, follow these steps.
on the **Common Problem Types** tab. on the **Common Problem Types** tab.
#. In the new Problem component that appears, click **Edit**. #. In the new Problem component that appears, click **Edit**.
#. Replace the default text with the text for your problem. #. Replace the default text with the text for your problem.
#. Determine the text of the problem to use as a label, and then surround that text with two sets of angle brackets (<<>>).
#. Select the text of the answer, and then click the text input button. #. Select the text of the answer, and then click the text input button.
.. image:: Images/ProbCompButton_TextInput.gif .. image:: Images/ProbCompButton_TextInput.gif
...@@ -365,8 +371,8 @@ following. ...@@ -365,8 +371,8 @@ following.
:: ::
What is the technical term that refers to the fact that, when enough people >>What is the technical term that refers to the fact that, when enough people
sleep under a bednet, the disease may altogether disappear? sleep under a bednet, the disease may altogether disappear?<<
= herd immunity = herd immunity
[explanation] [explanation]
......
docs/en_us/course_authors/source/create_problem_component.rst
...@@ -107,16 +107,17 @@ All problems on the edX platform have several component parts. ...@@ -107,16 +107,17 @@ All problems on the edX platform have several component parts.
.. note:: Problems can be **open** or **closed.** Closed problems do not .. note:: Problems can be **open** or **closed.** Closed problems do not
have a **Check** button. Students can still see questions, solutions, have a **Check** button. Students can still see questions, solutions,
and revealed explanations, but they cannot check their work, submit and revealed explanations, but they cannot check their work, submit
responses, or change their stored score. responses, or change an earlier score.
There are also some attributes of problems that are not immediately There are also some attributes of problems that are not immediately
visible. visible. You can set these attributes in Studio.
- **Randomization.** For some problems, the instructor can specify - **Randomization.** For some problems, the instructor can specify
whether a problem will use randomly generated numbers that vary from whether a problem will use randomly generated numbers that vary from
student to student. student to student.
- **Weight.** Different problems in a particular problem set may be - **Weight.** Different problems in a particular problem set may be
given different weights. given different weights.
- **Label.** To improve accessibility for students who have disabilities, each problem needs a descriptive label. The label typically contains part or all of the text of the question in the problem. Most templates include a space for a label. You can find example labels in the documentation for each problem or tool type.
.. _Studio UI: .. _Studio UI:
...@@ -158,7 +159,7 @@ the text for you automatically. The toolbar buttons are the following: ...@@ -158,7 +159,7 @@ the text for you automatically. The toolbar buttons are the following:
The following image shows a multiple choice problem in the Simple Editor. The following image shows a multiple choice problem in the Simple Editor.
.. image:: Images/MultipleChoice_SimpleEditor.gif .. image:: Images/MultipleChoice_SimpleEditor.png
:alt: Image of a problem in the simple editor :alt: Image of a problem in the simple editor
.. _Advanced Editor: .. _Advanced Editor:
...@@ -173,7 +174,7 @@ For more information about the XML for different problem types, see :ref:`Append ...@@ -173,7 +174,7 @@ For more information about the XML for different problem types, see :ref:`Append
The following image shows the multiple choice problem above in the Advanced Editor The following image shows the multiple choice problem above in the Advanced Editor
instead of the Simple Editor. instead of the Simple Editor.
.. image:: Images/MultipleChoice_AdvancedEditor.gif .. image:: Images/MultipleChoice_AdvancedEditor.png
:alt: Image of a problem in the advanced editor :alt: Image of a problem in the advanced editor
.. _Problem Settings: .. _Problem Settings:
...@@ -182,19 +183,17 @@ instead of the Simple Editor. ...@@ -182,19 +183,17 @@ instead of the Simple Editor.
Problem Settings Problem Settings
****************** ******************
All problems except word cloud and open response assessment problems Most problems have the following settings. These settings appear on the **Settings** tab in
have the following settings. These settings appear on the **Settings** tab in the component editor.
the component editor. (The settings for open response assessments and word clouds
are listed on the page for those problem types.)
- Display Name - **Display Name**
- Maximum Attempts - **Maximum Attempts**
- Problem Weight - **Problem Weight**
- Randomization - **Randomization**
- Show Answer - **Show Answer**
.. image:: Images/ProbComponent_Attributes.gif .. image:: Images/ProbComponent_Attributes.png
:alt: Image of the problem settings dialog box :alt: Image of the Settings tab in a Problem component
=============== ===============
Display Name Display Name
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment