The R package exams2learnr provides an R/exams (https://www.R-exams.org/) interface for learnr tutorials.
Currently, there is support for the following question types:
| Description | R/exams | learnr |
|---|---|---|
| Single-choice | schoice |
learnr_radio |
| Multiple-choice | mchoice |
learnr_checkbox |
| Numeric | num |
learnr_numeric |
| Text | string |
learnr_text |
Thus, there is no support, yet, for cloze questions.
The main function is exams2learnr() which is typically
used within learnr Rmd tutorials. For a single exercise the
function returns a learnr tutorial_question
and for several exercises it yields a learnr
tutorial_quiz. Both usages are illustrated by two example
files provided within the package.
learnr_questions.Rmd: All questions set up
indvidually.learnr_quiz.Rmd: An entire quiz set up in one go.Additionally, the function run_quiz() can be used to
quickly set up and run a quiz interactively based on a set of R/exams
exercises. For example:
run_quiz(c("capitals.Rmd", "fruit.Rmd", "function.Rmd"))
An introductory tutorial is hosted on the R/exams website at https://www.R-exams.org/tutorials/exams2learnr/.
The stable version of exams2learnr is available from CRAN:
install.packages("exams2learnr")The latest development version can be installed from R-universe:
install.packages("exams2learnr", repos = "https://zeileis.R-universe.dev")The package is available under the General Public License version 3 or version 2