A package that generates questionnaires as HTML files to be distributed over the network and scores answers in text files submitted by students.
Project description
html4quiz
What is it?
html4quiz is a package that helps you generate question sheets with as many HTML files as you want and grade answers from text files submitted by students.
Features
- Unlike the many quiz generators available online, everything is on your local PC, grows with your creativity, and you own everything.
- Question sheets in HTML files, each named with a corresponding identification number, are distributed to students over the network.
- Except for the math equations, each HTML file is complete in itself.
- Students use their mobile devices to read, answer questions, save answers to a text file for submission within the same HTML page, and submit the text file as directed over the network.
- Saving answers to a file can be repeated as many times as desired.
- Grade answers in text files submitted by all students can be achieved with a few keystrokes.
- A question begins with a short answer in a number or word.
- Questions with numeric answers can be converted to multiple choice questions simply by flipping the option flag.
- Questions can start with multiple choice.
- Mathematical equations in LaTeX format can be included in both question texts and choices.
- Figures can be included in both question text and choices.
- Question text, mathematical equations, and figures are all randomly selected for each question sheet in a controlled manner.
- Randomness is acquired by executing the answer string, which is a short Python script, that is part of question.
- To increase your creativity, user-defined functions can be easily added for the answer string.
Where to get it
pip install html4quiz
- The source code is currently hosted on GitHub at: https://github.com/generateNscore/html4quiz
Dependencies
- None
Changes
- Version 0.0.30
- In addition to using a user-defined function for answers, a new way to use resources saved in html4quiz/res is added.
- For details, please look at Ex004.py
- Previews
- Version 0.0.29
- Added an option to reuse previous work.
- When an answer of question among many in previous work whose question sheets has been distributed is found incorrect, simply setting the option True and re-running the work is all you need to do.
- The new option, flag4Previous can be added as the last argument to the instance as:
- If not provided, the default value of the option, False, is assumed.
flag4Previous = True
h4q.work('exam1', 'testing', STDs, QGs, flag4Preview, flag4Choice, flag4Shuffling, resources, flag4Previous)
- Added "res" folder to GitHub for the Javascript scripts of figures and additional data saved in JSON format.
- Added a "getResource()" function to the package to access the data.
- Some procedures of calling functions were removed to simplify the usages of package.
- Package name has been changed from htmlfilesforquiz to html4quiz
- So is the name of repository in GitHub.
- Finallized a way to upload/download Javascript scripts saved in JSON files for figures.H. Download Json file of Javascript code for figure contents
- A way to stay in short-answer question is added as:
answer = [{'choices':None, 'ans': ans}]
- This answering form is different from the one of
answer = [{'choices':None, 'ans':vA+vB, 'fn': 'variation0_int'}]
Example shots
- A short-answer question
- A multiple-choice question
- A multiple-choice question with a figure
- A question with multiple-choice figures
- A question with equation and with multiple-choices
- A question with equation and with multiple-choice figures
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
html4quiz-0.0.30.tar.gz
(18.1 kB
view hashes)
Built Distribution
html4quiz-0.0.30-py3-none-any.whl
(19.7 kB
view hashes)
Close
Hashes for html4quiz-0.0.30-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 63c1d71e7edd2f898686fe543c80f6f3fde53f93097fc1349cfde13014100edd |
|
MD5 | fc6ef60a3f0c9040c36fa6ab450720b4 |
|
BLAKE2b-256 | bcb3ca9a50ee6e0c72a725daecbeebe2f3566c7892fdd52b392a12144b1bba9c |