Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Django Quiz Application

This is a Django-based quiz application that allows users to answer questions on various topics. The application supports multiple choice questions and tracks correct answers. More features wil be added progressively. The application is aimed at enabling users enhance their general knowledge on various topics.

Setup and Installation

Prerequisites

  • Python 3.x
  • Django 3.x or later
  • PostgreSQL (or any other preferred database)

Installation Steps

  1. **Clone the repository:**ry o

    Clone the repository from GitHub to your local machine. 6

  2. Create a virtual environment:

    Create and activate a virtual environment to manage dependencies.

  3. Install the dependencies:

    Install the required Python packages using a requirements.txt file.

  4. Setup the database:

    Configure your database settings in final_project/settings.py.

  5. Apply the migrations:

    Apply the database migrations to set up the necessary tables.

  6. Create a superuser:

    Create a superuser to access the Django admin interface.

  7. Run the development server:

    Start the Django development server to run the application locally.

Populating the Database

To populate the database with initial data (topics, questions, and choices), you can use the provided script.

  1. Script to populate the database:

    There is a script available to populate the database with predefined topics, questions, and choices. Save the script as populate.py and run it using the appropriate command.

Usage

Once the server is running, you can:

  • Visit the admin interface to manage your quiz content.
  • Access the quiz functionality through the designated URLs and views.

Contributing

Contributions are welcome! To contribute:

  1. Fork the repository on GitHub.
  2. Create a new branch for your feature or bugfix.
  3. Commit your changes with clear and descriptive messages.
  4. Push your changes to your forked repository.
  5. Submit a pull request to the main repository with a description of your changes.

About

Final project for PLP AFRICA Schorlaship

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages