It is a tool to generate quizzes from Markdown files. This means that you can structure the format of the text, bold, italic, tables, etc.
install.bat - automatically download and install all requirements and dependencies
(Python-3.11.x, pip )
Once python
and pip
are installed, simply run (within the application already downloaded):
python -m pip install -r requirements.txt
Although it is based on markdown for its style format, at the moment the following types of questions are supported:
- Question of a selection:
1. MaxSoft is a software company.
- (x) True
- ( ) False
2. The domain of MaxSoft is test automation framework development.
- (x) True
- ( ) False
Note that the correct answer is specified with an x ( x or X, upper or lower case) and must be in parentheses to specify that it is only one to be selected, for example, for false or true questions.
- Multiple selection question:
3. What are the test automation frameworks developed by MaxSoft?
- [x] IntelliAPI
- [x] WebBot
- [ ] Gauge
- [ ] Selenium
Very similar to the previous one but this type of question allows you to select more than one at a time, they must be in square brackets with an x to the correct answers. The result to these types of questions is prorated, that is, you must select only the correct ones so that that question is interpreted as correct.
Note that for questions types 1 and 2, you must leave a space for the wrong answers, eg. () or [], the questions must be multiple selection or a selection, you cannot mix them.
- Open question (Enter text)
4. Who is the Co-Founder of MaxSoft?
- R:= Osanda
It is a question where you must write the correct answer, this is specified in the following line of the question preceded by R: = (R or, upper or lower case) then the correct answer (it is validated regardless of whether it is uppercase or lowercase)
There are several tools out there on the internet that allow you to preview Markdown files. Some online examples:
The application will generate all the .md (Markdown) files that are inside the folder
./markdown-quiz-files/**
. Note that this folder already has a default quiz (sample-quiz.md).
You can add as many as Markdown files you want, and each of them will be generated separate quizzes.
To generate quizzes, there are two batch files,
-
quiz-generator-local.bat
This is a batch file that simply executespython quiz-generator.py
and will generate the quizzes including the required libraries (Bootstrap, jQuery) to execute it independently in the browser (usually to verify that everything is fine). -
quiz-generator-local-server.bat
This is a batch file that executes,
python quiz-generator.py
cd generated-quizzes
start https://localhost:8000/
python -m http.server 8000
This is almost same as quiz-generator-local.bat
. The only difference is, this will spin up a new local server for your quizzes at https://localhost:8000/
quiz-generator-embed.bat
This is a batch file that simply executespython quiz-generator.py embed
in this way the quizzes will be generated without including any external library, it is assumed that it will be included in another Web as (Embedded).
The resulting quizzes will have the same name of the markdown file but with their .html extension, they will be created in the ./generated-quizzes/
folder.