Skip to content

convert a simply formatted text document into a zip file that can be imported to Canvas

License

Notifications You must be signed in to change notification settings

backyardbiomech/qtiConverter

Repository files navigation

QTI converter

This program will convert a simply formatted text (.txt or .md) document containing most question types available in Canvas into a zip file that can be imported to Canvas to add the questions to a question bank or as a quiz. This is updated to work with some of the more modern formats of questions available in "New Quizzes" like "hotspot" and "categorization". It should still be backward compatible with classic quizzes as long as you stick to question types found there.

NOTE: With the classic quizzes Canvas import process will also make an actual quiz containing all of the questions in the bank. If you just want the question bank to pull from, I suggest deleting that quiz after import.

  • Written by Brandon E. Jackson, Ph.D.
  • jacksonbe3 at longwood dot edu
  • last updated: December 30, 2024

Installation and Usage

For more details click on the link for each step.

  1. Installation: - download this repo and run from the command line
  2. Preparing the document - make a markdown (or text) file that includes the questions, answers, and links to images
  3. Importing to Canvas - import the output to a specific quiz or to a question bank in Canvas
  4. Tips and FAQ - Help, common causes of errors, etc
  5. Sample question formatting - samples of every question type to demonstrate formatting

Question types supported

Note: All question types support images as part of the question.

  • Multiple choice
    • includes support for images in the answer options
  • Multiple answer (i.e. "select all that apply")
    • includes support for images in the answer options
  • Fill in the blank
    • includes support for multiple blanks as "open answer" asking students to type in answers. You can define multiple acceptable answers per blank.
    • Also "dropdown" multiple blanks where you can define a list of choices per blank. Formerly this was the "multiple dropdown" question type, but in new quizzes, it's an option under Fill in the blank.
  • Matching
  • Ordering
  • True/False
  • Categorization
  • Hot Spot (i.e. click on the part of the image where...)
    • This repository includes a small script that lets you load an image and define the region that is "correct" for this question type
  • Essay

Quick tutorial video

Currently outdated but may be helpful

Tutorial Video

License

This project is licensed under the GNU Lesser General Public License v3.0; see the LICENSE.md file for details. Note that the software is provided "as is", without warranty of any kind, express or implied.

About

convert a simply formatted text document into a zip file that can be imported to Canvas

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages