shortanswer directive provides a free-form assessment that is stored
and can be manually graded by an instructor.
The general format of the
shortanswer directive is:
.. shortanswer:: unique_id :optional: + --- Content area --- | | A question or prompt for the assessment. | + --------------------
A feedback region underneath user content displays
Your answer has not been saved yet!
in red background, until the ‘Save’ button is pressed. Then the feedback region displays
Your answer has been saved.
in green background. Each time the content is modified, the save warning is redisplayed until ‘Save’ is pressed.
- unique id
A unique identifier after a space and the
shortanswerdirective. Valid identifiers must not contain spaces. You should also avoid the characters `` `
- content area
A question or prompt for the assessment.
Boolean. If present, changes the assessment area background color, except for the feedback area, to light green.
Sphinx configuration options¶
No directive specific configuration options exist.
Responses must be plain text only. There is no ‘upload’ feature.
There is no option to set an initial height or width for the text area, although users can resize it.
This directive requires a back end server to be useful.
There is no ‘reset’ or ‘undo’ as found in other directives. Simply delete response text to reset to it’s initial state.
This directive erroneously labels each assessment twice:
Q-1: Q-2: What colors are in the rainbow?
in green background.
shortanswer appearance displays only the feedback region green.
.. shortanswer:: short-ex3 What are the colors in the rainbow?
:optional: is set,
shortanswer appearance displays the entire assessment area green.
.. shortanswer:: short-ex2 :optional: What are the colors in the rainbow?