html4quiz 0.0.28

A package that generates questionnaires as HTML files to be distributed over the network and scores answers in text files submitted by students.

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

• Everything is on your local PC, grows with your creativity, and you own them all.
• 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.
• Grading answers from text files submitted by students can be done with a few keystrokes.
• A question begins with a short answer in a number or word.
• Questions with numeric answers can be converted to multiple choice questions simply by flipping the flag.
• Questions can start with multiple choice.
• Mathematical equations in LaTeX format can be included in both question texts and choices.
• Figures can be included in both question text and choices.
• Question text, mathematical equations, and figures are all randomly selected for each question sheet in a controlled manner.
• Randomness is acquired by executing the answer string, which is a short Python script, that is part of question.
• To increase your creativity, user-defined functions can be easily added for the answer string.

Where to get it

pip install html4quiz

• The source code is currently hosted on GitHub at: https://github.com/generateNscore/html4quiz

Dependencies

• None

Changes

• Version 0.0.28
• 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 Treu 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:
• The default value of the option is False.

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.16
• In addition to typical short-answer questions that can be answered on the screen, a new kind questions for which students are required to "play" with mouse to complete a required task to answer is added.
• Example: Nk001.py


• 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