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
- Local: Everything is on your local PC, grows with your creativity, and you own everything, unlike the many quiz generators available online.
- HTML files: Question sheets in HTML files, each named with a corresponding identification number, are distributed to students over the network.
- 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.
- Easy grading: Grade answers in text files submitted by all students can be achieved with a few keystrokes.
- Two kinds of HTML files
- First kind is to preview questions before generating sheets.
- Second kind is the set of sheets.
- Two kinds of questions
- Short answr questions of requiring a number of a word.
- Multiple choice questions whose choices are genterated randomly by one of various methods or by Python coding.
- Figures as well as mathematical expressions in LaTeX format can be included in both question texts and choices.
- Randomness is controlled completely by users with Python scripts.
- Easy correction: When some answers are found incorrect after question sheets are distributed, the answers can be corrected by simply re-generate the sheets with the "work" pickle file (refer to Version 0.0.31).
Where to get it
pip install html4quiz
Dependencies
- None
Changes
- Version 0.0.31
- A new flag is added as the last argument to the class "work".
- When some answers are found incorrect after question sheets are distributed, the answers can be corrected and grading can be completed with the corrected answers for the same questions in every sheet.
- The usage that has been used works fine as they are now. They simply use the default value of "False" for the new added flag.
- To work with the new added flag, every information used for the errorneous previous work are assumed to be the same, including the name and heading.
- Simply add the value False as the last argument when the instance is called.
- 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.31.tar.gz
(18.3 kB
view hashes)
Built Distribution
html4quiz-0.0.31-py3-none-any.whl
(19.9 kB
view hashes)
Close
Hashes for html4quiz-0.0.31-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1b553269292a9965e1b3602fb331713675010f69b48995fdd2e4763b20912350 |
|
MD5 | 6250af0204ebee8b6d8509bd7b412226 |
|
BLAKE2b-256 | 0c07736a19c50e63af36d68ff0021f8f124e510e1f34d247126f1228e2e46bdc |