Skip to content

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: 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

Contact

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.

About

ASKER generates tons of questions from a definitions input file.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •