exams (version 2.4-1)

exams2tcexam: Generation of Exams in TCExam Format

Description

Interface for generating exams in TCExam format.

Usage

exams2tcexam(file, n = 1L, nsamp = NULL, dir = ".",
    name = NULL, quiet = TRUE, edir = NULL, tdir = NULL, sdir = NULL, verbose = FALSE,
    resolution = 100, width = 4, height = 4, svg = FALSE, encoding = "UTF-8",
    points = NULL, modulename = name, subjectname = name, subjectdescription = NULL,
    timer = 0, fullscreen = FALSE, inlineanswers = FALSE, autonext = FALSE,
    shuffle = FALSE, lang = "en", date = Sys.time(), zip = FALSE, converter = NULL,
    ...)

Value

A list of exams as generated by xexams is returned invisibly.

Arguments

file

character. A specification of a (list of) exercise files.

n

integer. The number of copies to be compiled from file.

nsamp, quiet, edir, tdir, sdir, verbose

arguments passed to xexams.

dir

character specifying the output directory path. The default is the current working directory.

name

character. A name prefix for resulting XML file.

resolution, width, height, svg

arguments passed to xweave.

encoding

character, ignored. The encoding is always assumed to be UTF-8.

points

numeric. Number of points for the questions.

modulename

character. Module name.

subjectname

character. Subject name.

subjectdescription

character. Subject description.

timer

numeric. Number of seconds for each question.

fullscreen

logical. Should the question be shown in full-screen mode?

inlineanswers

logical. Should the question list be presented inline?

autonext

logical. Automatically advance to the next item?

shuffle

logical. Should the question list of schoice/mchoice answers be shuffled (or kept fixed)?

lang

character. Two-letter indicator of the language.

date

character or "Date" object specifying the date of the exam.

zip

logical. Should the resulting XML file be zipped?

converter, ...

arguments passed on to make_exercise_transform_html. The default for converter is set to "ttm" unless there are Rmd exercises in file where "pandoc" is used.

Details

exams2tcexam generates XML exams that can be imported into the TCExam software of Asuni (2012). Currently, the subset of HTML(-like) commands that is supported in TCExam is rather limited, e.g., tables and figures cannot be directly included.

References

Asuni (2012). TCExam: Computer-Based Assessment Software. https://tcexam.org/.

Examples

## load package and enforce par(ask = FALSE)
library("exams")
options(device.ask.default = FALSE)

if (FALSE) {
## exams2tcexam creates a single XML file
exams2tcexam("tstat2", n = 2)
}