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.
• Two 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. A third type of question that can be answered by a "game" simulation will be available in the near future.
• 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.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