README
author nishanth
Tue, 29 Jun 2010 17:58:23 +0530
changeset 66 9442fb10980c
child 67 131b97c593a9
permissions -rw-r--r--
added readme file
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
66
9442fb10980c added readme file
nishanth
parents:
diff changeset
     1
This is an app for automating the process of conducting and evaluating the quizzes that are conducted during FOSSEE workshops.
9442fb10980c added readme file
nishanth
parents:
diff changeset
     2
9442fb10980c added readme file
nishanth
parents:
diff changeset
     3
Setting up the quiz
9442fb10980c added readme file
nishanth
parents:
diff changeset
     4
===================
9442fb10980c added readme file
nishanth
parents:
diff changeset
     5
9442fb10980c added readme file
nishanth
parents:
diff changeset
     6
1. Clone the repository
9442fb10980c added readme file
nishanth
parents:
diff changeset
     7
2. On terminal, navigate to the cloned repo directory 
9442fb10980c added readme file
nishanth
parents:
diff changeset
     8
3. type "python manage.py syncdb" # this command initializes the database. Select no when prompted for a super user
9442fb10980c added readme file
nishanth
parents:
diff changeset
     9
4. Open question_bank.xml file. It contains questions and time allotted (in secs) for each question.
9442fb10980c added readme file
nishanth
parents:
diff changeset
    10
5. Modify the time limit for each question according to your need
9442fb10980c added readme file
nishanth
parents:
diff changeset
    11
6. Then type "python manage.py seed_que" # this command adds the questions to the database
9442fb10980c added readme file
nishanth
parents:
diff changeset
    12
7. Then run the django server using "python manage.py runserver <desired ip>:<desired port> "
9442fb10980c added readme file
nishanth
parents:
diff changeset
    13
8. Then go to "http://<server ip>:<server port>/event/admin/ditchax"
9442fb10980c added readme file
nishanth
parents:
diff changeset
    14
9. You have to create an event in this page
9442fb10980c added readme file
nishanth
parents:
diff changeset
    15
9442fb10980c added readme file
nishanth
parents:
diff changeset
    16
Conducting the quiz
9442fb10980c added readme file
nishanth
parents:
diff changeset
    17
===================
9442fb10980c added readme file
nishanth
parents:
diff changeset
    18
9442fb10980c added readme file
nishanth
parents:
diff changeset
    19
1. Once the event has been created, the same link as in step 8 above, will now contain all the links related to that event
9442fb10980c added readme file
nishanth
parents:
diff changeset
    20
2. The quizzes and feedback will be closed by default and the admin has to open it
9442fb10980c added readme file
nishanth
parents:
diff changeset
    21
3. They can be opened using links available on event page
9442fb10980c added readme file
nishanth
parents:
diff changeset
    22
4. While opening a quiz, you have to select the quiz and the set of questions that belong to that quiz
9442fb10980c added readme file
nishanth
parents:
diff changeset
    23
5. Once you select everything and open the quiz, users can access the quiz by visiting the link "http://<server ip>:<server port> "
9442fb10980c added readme file
nishanth
parents:
diff changeset
    24
6. Users will be prompted for details and then they can take the quiz
9442fb10980c added readme file
nishanth
parents:
diff changeset
    25
9442fb10980c added readme file
nishanth
parents:
diff changeset
    26
Evaluating the quiz
9442fb10980c added readme file
nishanth
parents:
diff changeset
    27
===================
9442fb10980c added readme file
nishanth
parents:
diff changeset
    28
9442fb10980c added readme file
nishanth
parents:
diff changeset
    29
1. Once all the users have taken the quiz, the admin can close the quiz using the link available in event page
9442fb10980c added readme file
nishanth
parents:
diff changeset
    30
2. When admin closes the quiz, each user is evaluated by the app and link to view the results is available on the event page
9442fb10980c added readme file
nishanth
parents:
diff changeset
    31
3. The page showing results contains users sorted in descending order of their score
9442fb10980c added readme file
nishanth
parents:
diff changeset
    32
4. Manual evaluation of a user is also possible. Every user in the results page is a link to another page
9442fb10980c added readme file
nishanth
parents:
diff changeset
    33
5. That page contains all the answers submitted by that particular user and a checkbox beside each answer
9442fb10980c added readme file
nishanth
parents:
diff changeset
    34
6. The checkbox will be checked if the user has answered correctly and unchecked other wise
9442fb10980c added readme file
nishanth
parents:
diff changeset
    35
7. Admin can choose to manually override the checkboxes and then save the data by clicking on the save button at the bottom of page
9442fb10980c added readme file
nishanth
parents:
diff changeset
    36
8. The quiz can also be evaluated question wise. Each question in the page that shows answers submitted by a user is a link to another page
9442fb10980c added readme file
nishanth
parents:
diff changeset
    37
9. This page contains users and answers submitted each user for that particular question and of course the checkboxes
9442fb10980c added readme file
nishanth
parents:
diff changeset
    38
9442fb10980c added readme file
nishanth
parents:
diff changeset
    39
Note
9442fb10980c added readme file
nishanth
parents:
diff changeset
    40
====
9442fb10980c added readme file
nishanth
parents:
diff changeset
    41
9442fb10980c added readme file
nishanth
parents:
diff changeset
    42
The word "ditchax" here is the key to access the admin interface. It can be changed in the settings file. Hence change the word to something of your choice before starting the server.
9442fb10980c added readme file
nishanth
parents:
diff changeset
    43
9442fb10980c added readme file
nishanth
parents:
diff changeset
    44
Improvements to be made
9442fb10980c added readme file
nishanth
parents:
diff changeset
    45
=======================
9442fb10980c added readme file
nishanth
parents:
diff changeset
    46
9442fb10980c added readme file
nishanth
parents:
diff changeset
    47
Interface to modify the questions on the browser after doing seed_que
9442fb10980c added readme file
nishanth
parents:
diff changeset
    48
Better look and feel of the app
9442fb10980c added readme file
nishanth
parents:
diff changeset
    49