exams2tcexam: Generation of Exams in TCExam Format

In exams: Automatic Generation of Exams in R

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,
    ...)

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.

Value

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

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)

## Not run: 
## exams2tcexam creates a single XML file
exams2tcexam("tstat2", n = 2)

## End(Not run)

exams documentation built on May 1, 2025, 3:01 a.m.