# Get started with exams2ilias

`exams2ilias` exports exercises from `R/exams` to ILIAS question pools. The package keeps the ILIAS-specific QTI 1.2 logic in one place and currently targets the import structure validated against ILIAS 9.17.

## Install

Until the package is released on CRAN, install it from GitHub:

    remotes::install_github("mchlbckr/exams2ilias")

## Minimal export

The central interface is `exams2ilias()`. A minimal export only needs an exercise file, an output directory, and a name for the resulting question pool.

    library(exams2ilias)

    outdir <- tempfile("ilias-")
    dir.create(outdir)

    exams2ilias(
      system.file("exercises/lm.Rmd", package = "exams"),
      n = 1,
      dir = outdir,
      name = "lm_ilias"
    )

This creates a ZIP file that can be imported into an ILIAS question pool.

## Internal template

By default, the package uses the bundled ILIAS template alias `"ilias"`, which currently resolves to the internal template for ILIAS 9.17. You only need to set `template` explicitly if you want to use your own XML template file.

    exams2ilias(
      system.file("examples", "stats_cloze.Rmd", package = "exams2ilias"),
      n = 1,
      dir = outdir,
      name = "stats_cloze",
      xmlcollapse = FALSE,
      solutionswitch = FALSE
    )

## Bundled examples

The package ships with self-contained statistics examples for the main exercise types:

    example_dir <- system.file("examples", package = "exams2ilias")
    list.files(example_dir, pattern = "\\.[Rr]md$", full.names = TRUE)

These examples are intended both as smoke-tested templates and as a starting point for your own question authoring workflow.