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
1. First kind is to preview questions before generating sheets.
2. Second kind is the set of sheets.
• Three kinds of questions
1. Short answr questions of requiring a number of a word.
2. Multiple choice questions whose choices are genterated randomly by one of various methods or by Python coding.
3. 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.46
• 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)



• Version 0.0.22
• 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.


• Version 0.0.21
• Package name has been changed from htmlfilesforquiz to html4quiz
• So is the name of repository in GitHub.


• Version 0.0.20
• Finallized a way to upload/download Javascript scripts saved in JSON files for figures.H. Download Json file of Javascript code for figure contents


• Version 0.0.11
• 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'}]

• This is about Specifying method of convering short-answer to a set of choices.

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