Skip to content

ASKER generates tons of questions from a definitions input file.

License

Notifications You must be signed in to change notification settings

teuton-software/asker

Repository files navigation

ASKER

Gem Version GitHub

Generate a lot of questions from an input text file with on your own definitions. In a way, this input file is a concept map.

Asker helps trainers to create a huge amount of questions, from a definitions (conceptual entities) input file.

logo

Installation

At first install Ruby and then:

gem install asker-tool

REMEMBER: Update Asker with gem update asker-tool

Usage

Step Action Tool Description
1 Define your concepts Text plain editor Create input file with your contents (conceptual map). Here are some examples. And more examples at this repository.
2 Generate questions asker PATH/TO/INPUT Run asker to process input file. Output files are saved into the output folder

Let's see an example creating questions from ACDC input example file:

asker docs/examples/bands/acdc.haml

+--------------------+-----------+---------+---------+---+---+----+---+---+----+
| Concept            | Questions | Entries | xFactor | d | b | f  | i | s | t  |
+--------------------+-----------+---------+---------+---+---+----+---+---+----+
| AC/DC              | 46        | 18      | 2.5     | 7 | 0 | 15 | 0 | 4 | 20 |
| Excluded questions | 0         | -       | -       | 0 | 0 | 0  | 0 | 0 | 0  |
+--------------------+-----------+---------+---------+---+---+----+---+---+----+
| 1 concept/s        | 46        | 18      | 2.5     | 7 | 0 | 15 | 0 | 4 | 20 |
+--------------------+-----------+---------+---------+---+---+----+---+---+----+

Features

  • Free Software License.
  • Multiplatform.
  • Input files formats: XML, HAML.
  • Output formats: GIFT, Moodle XML, YAML.
  • Question types: true/false, multiple choice, short answer, matching and ordering.
  • Embeded files: mp3, ogg, wav, jpg, jpeg, png, mp4, ogv and plain text files.

Documentation

Contact

Contributing

  1. Make sure you have Ruby installed
  2. Fork it
  3. Create your feature branch (git checkout -b my-new-feature)
  4. Commit your changes (git commit -am 'Add some feature')
  5. Push to the branch (git push origin my-new-feature)
  6. Create new Pull Request.