Contributing to Site
This project is responsible for maintaining the website, all of it's subdomains, and the backend API that our Python Discord Bot relies on to function.
The website is built on the Django web framework, uses django-wiki for resource pages and utilises Bulma for CSS.
- Python 3.7
- Docker CE
- Docker Compose
pip install docker-compose
pip install pipenv
You will need access to a copy of the git repository of your own that will allow you to edit the code and push your commits to. Creating a copy of a repository under your own account is called a fork.
This is where all your changes and commits will be pushed to, and from where your PRs will originate from.
For any Core Developers, since you have write permissions already to the original repository, you can just create a feature branch to push your commits to instead.
- Clone your fork to a local project directory
- Install the project's dependencies
- Prepare your hosts file
Before running the project, build the docker service via docker-compose from your project directory.
To run the project, launch the project containers using docker-compose.
The development environment will watch for code changes in your project directory and will restart the server when a module has been edited automatically. Unless you are editing the Dockerfile or docker-compose.yml, you shouldn't need to manually restart the container during a developing session.
Django provides an interface for administration with which you can view and edit the models among other things. It can be found at http://admin.pythondiscord.local:8000. The default credentials are
admin for the username and
admin for the password.