Digital Oxford Wagtail Site

The repository for the Wagtail powered Digital Oxford site.

Notes

• Requires Python 3.*
• This project uses django-sass-processor to manage scss files. Refer to that repository's README for instructions on how to manage the files.

Local setup

Clone this repository and then:

$ cd <install-directory>

Create and activate your virtual environment:

$ python -m venv env
$ source ./env/bin/activate

Install requirements:

$ pip install -r requirements/requirements-dev.txt

(NOTE: requirements-dev.txt includes requirements.txt automatically)

Pre-commit hooks

This repository uses the pre-commit framework to perform certain sanity checks during development. These include code formatting with Black and DjHTML, import sorting with isort, and detecting any private keys you may have accidentally added to the repository. For a full list see the file <install-directory>/.pre-commit-config.yaml.

Run pre-commit install to set up the git hook scripts

$ pre-commit install

Now pre-commit will run automatically on git commit.

Configuration

Create a local environment file by copying <install-directory>/home/.env_example to <install-directory>/home/.env and filling out the details.

Run the migrations and create the superuser:

$ ./manage.py makemigrations
$ ./manage.py migrate
$ ./manage.py createsuperuser

Finally, start the development server:

$ ./manage.py runserver_plus