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.32
- A small re-recoding is done.
- 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.32.tar.gz
(18.2 kB
view hashes)
Built Distribution
html4quiz-0.0.32-py3-none-any.whl
(19.8 kB
view hashes)
Close
Hashes for html4quiz-0.0.32-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 52e7d7cda2427905e9844657a5fc135144803681da7ebc8339f94104b1faaaef |
|
MD5 | 528741a27af6d87e871211a9e54604c4 |
|
BLAKE2b-256 | 57249e16dbc24a961de37e67479a533132d092b6bf5ed4c30a91f90a1c8f4b5b |