Project

asker-tool

0.01
A long-lived project that still receives updates
ASKER helps trainers to create a huge amount of questions, from a definitions input file.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Runtime

~> 5.2
~> 3.0
~> 3.0
~> 1.2
~> 3.2
 Project Readme

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

  • 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.