ASKER

Asker generates a large number of questions from an input text file containing entities from a specific domain.

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 entitiess	Text plain editor	Create input file with your entities. 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: HAML, XML.
• Output formats: Moodle XML, GIFT, YAML.
• Question types: true/false, multiple choice, short answer, matching and ordering.
• Embeded type files: mp3, ogg, wav, jpg, jpeg, png, mp4, ogv and plain text files.

Documentation

• About the tool
• Installation
• Videos
• Get started
• Usage
• Reference

Contact

• Email: teuton.software@protonmail.com

Contributing

If you want to contribute:

• Talk about this tool with your colleagues.
• Use this tool as much as posible.
• Report bugs.
• Share with us, your ideas for new features. "4 eyes see more than 2".
• Share with us your own input files and "create a better world".

But if you love git, md files or ruby, you can develop with us or work on the issues.

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.