timed directive is a container that adds a timer to any Runestone assessment or Activecode directive.
.. timed:: unique_id :timelimit: + --- Content area --- | | one or more assessment directives, or an activecode directive | + --------------------
By default the feedback will be shown after the user clicks the “Finish Exam” button or after the time runs out for an exam with a specified duration.
To start the exam click on the “Start” button.
Pause the time by clicking on the “Pause” button
Start it again by clicking on the “Resume” button.
When you pause the exam the questions will be hidden. There is also a clock icon that will display the time remaining if it is a timed exam and the time used otherwise when the reader hovers over it. Questions are presented one at a time.
timed tests always display questions one at a time,
time limit or not,
a ‘timed’ assessment with
provide a means to present many questions, one at a time, but with no time or other statistics displayed.
A “Reset” button allows restarting a timed assessment under certain conditions. Reset is only available if there is no record of a completed exam and the localStorage does not reflect a partially completed exam.
- unique id
A unique identifier after a space and the
::in the timed directive. Valid identifiers must not contain spaces. You should also avoid the characters `` `
- content area
The timed directive must contain at least one line of content.
Integer. Maximum time allowed to complete all assessment items in the container.
Specify the maximum duration of the exam in minutes and it will display the time remaining. If you don’t include a duration it will keep track of the amount of time used and give the user unlimited time to finish the exam.
Boolean. Allows the items in the timed assessment to take the full width of the screen.
Boolean. Do not display feedback if defined.
Default displays feedback.
Boolean. Do not display score if defined.
Default displays score.
Boolean. Do not display timer if defined.
Default displays timer.
Sphinx configuration options¶
Runestone currently only supports one timed assessment per html page.
ActiveCode questions are not graded, even if they contain unit tests.
‘Hidden’ assessment questions can be seen by students if they choose to examine the raw source of a web page. Do not assume that ‘hidden’ assessment information is hidden from everyone.
The ‘Reset’ button does not reset exams.
.. timed:: time-ex1 :timelimit: 60 .. mchoice:: timed_mc_ex1_1 What color is a stop sign? - red + Red it is. - brown - Not brown. - blue - Not blue. - gray - Not gray. .. mchoice:: timed_mc_ex1_2 :multiple_answers: :correct: a, c :answer_a: red :answer_b: brown :answer_c: blue :answer_d: gray :feedback_a: Red it is. :feedback_b: Not brown. :feedback_c: Blue it is. :feedback_d: Not gray. What colors might you see in a rainbow?