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.
- Each HTML file is complete in itself with everything included.
- 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.
- Answers can be changed, and saving answers to a text file can be repeated as many times as desired until the file is submitted.
- 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.
- Three 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.
- Unlike the previous two kinds, students have to "play" the simulation provided with question to answer (refer to Ex005 Preview).
- 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.29).
Where to get it
pip install html4quiz
Dependencies
- None
Changes
- Version 0.0.44 ~ 0.0.45
- When question sheet is a mixture of multiple choices and short answers, old answers of the short answers has been deleted as soon as a choice is selected. This annoying bug is corrected.
- Version 0.0.40 ~ 0.0.43
- An addition to check if all provided choices are different each other. If not, an error message is displayed as question.
- Version 0.0.39
- A minor bug in scoreAnswers is corrected.
- Version 0.0.38
- Minor bug correction.
- Version 0.0.37
- Third kind question is added (refer to Ex005 Preview).
- Version 0.0.33
- A small re-coding 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.45.tar.gz
(19.2 kB
view hashes)
Built Distribution
html4quiz-0.0.45-py3-none-any.whl
(20.6 kB
view hashes)
Close
Hashes for html4quiz-0.0.45-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f8521113c765bb67776337a014186a64922a1e55cda9d339a256f90e8c4e6645 |
|
MD5 | e103ad75dae339778fb4185608a9163e |
|
BLAKE2b-256 | b35960b70f8e88f793dc471cf31868833472ba163fe71483bb7b4772a1c898d4 |