Open-Source Book Hub(OS|HB)

Introduction

OS|BH Provides free access to diverse genres of resources including hobby-related ones and aims to reduce the challenging barriers to sharing and accessing knowledge or niche readings by empowering learning, literary leisure and exploration through community-driven open access.

Blog Posts

For a more in-depth description of OSBH as well as an overview of its tech stack and development process, do visit the links below:

• The Adventure of Building OSBH: Triumphs, Trials, and Thrills
• Building a Community

Authors

Philip: Twitter | LinkedIn | GitHub

David: Twitter | LinkedIn | GitHub

Davidson: Twitter | LinkedIn | GitHub

Installation

Getting started Locally

To get this project up and running locally on your computer:

1. Set up the Python development environment. We recommend using a Python virtual environment.
2. Assuming you have Python setup, run the following commands (if you're on Windows you may use py or py -3 instead of python3 to start Python):

   pip3 install -r requirements.txt   # To install all project dependecies
   cd src
   python manage.py makemigrations
   python manage.py makemigrations blog forum file_library
   python manage.py migrate
   python manage.py collectstatic
   python manage.py test # Run the standard tests. These should all pass.
   python manage.py createsuperuser  # Create a superuser
   python manage.py runserver
   

3. Open a browser to http://127.0.0.1:8000/admin/ to open the admin site
4. Create a few test objects of each type.
5. Open tab to http://127.0.0.1:8000 to see the main site, with your new objects.

How to deploy this code

• This project was deployed using Digital Ocean free tier plan. You can click here for a detailed documention on how to deploy this code.

Usage

Direactions on how to use this site with detailed screenshot

License

This project is licensed under the MIT License - see the LICENSE file for details.