Daily Office, Book of Common Prayer 2019 (https://www.dailyoffice2019.com)
This project is used to build the website https://www.dailyoffice2019.com. It is a Django application written in Python (to be installed in a development environment). It is used to produce a static html and javascript site which can then be deployed to the production environment.
The site invites you to join with Christians around the world in praying with the Church, at any time or in any place you may find yourself. It makes it easy to pray daily morning, midday, evening, and compline (bedtime) prayer without flipping pages, searching for scripture readings or calendars, or interpreting rubrics. The prayers are presented from The Book of Common Prayer (2019) of the Anglican Church in North America and reflect the ancient patterns of daily prayer Christians have used since the earliest days of the church.
Daily Morning Prayer and Daily Evening Prayer are the established rites (offices) by which, both corporately and individually, God’s people annually encounter the whole of the Holy Scriptures, daily confess their sins and praise Almighty God, and offer timely thanksgivings, petitions, and intercessions.
Pull requests are welcome. Take a look at the issues and see where you might help out. Updates to documentation and tests (both of which are largely missing) are also welcome.
- Python 3.7 (other 3.x may work)
- Node with npx
- Yarn
- PostgreSQL
- Clone or fork the project from
https://github.com/blocher/dailyoffice2019
cd dailyoffice2019
- Connect to Postgres
sudo psql -d postgres
- Create database
create database dailyoffice;
- Create user
create user dailyoffice with password 'password';
- Grant permissions
grant all privileges on database dailyoffice to dailyoffice;
- Exit postgres
\q
- Import
psql -U dailyoffice dailyoffice < site/dailyoffice_2020_01_12.sql
ALTERNATE: You may import the data into a clean database using the provided import
Django management commands
- Create a Python virtual environment
python3 -m venv env
- Load virtual environment
source env/bin/activate
- Install Python Requirements
pip install -r requirements.txt
cd site
- Install JavaScript Requirements
yarn install
- Bundle Javascript and CSS
npx webpack --watch
- Collect static assets
python manage.py collectstatic
- Start development server
python manage.py runserver
- The site will be accessible locally at
http://127.0.0.1:8000
- Set the
DEBUG
setting toFalse
insite\website\settings.py
- Run
python manage.py collectstatic
from thesite
directory - Run
python manage.py distill-local
from thesite
directory. This builds a static copy of the site in thestatic_export
directory - Run
netlfy deploy --prod
fromstatic_export
directory (must be done by site owner that has Netlify credentials)
- Please use
black
to format code with a line length of 119 beore submitting a pull request find . -iname "*.py" | xargs black --target-version=py37 --line-length=119
from thesite
directory
The application is built around several Django "apps". The most important are:
- website: This is the base site. All settings are defined in
website\settings.py
and all paths are defined inwebsite\routes.py
. Start here. - office: This is where the bulk of the work is down to generate each Office.
- churchcal: This is used to build the church calendar. It currently supports both the Anglican Church in North America and the Episcopal Church calendars (though only ACNA is currently used for this project)
- bible: This is used to retrieve bible passages from various sources (currently only Bible Gateway, but others such as the ESV API are coming soon)
- psalter: This is used to retrieve passages from the Psalms (currently only the renewed Coverdale translation in the Book of Common Prayer 2019)
NOTE: churchcal, bible, and psalter apps may be spun off as separate projects soon and added as dependencies to this project
- For feature requests, please submit an issue and label it "enhancement"
- For bug reports, please submit an issue and label it "bug"
- Email the original creator Ben @ feedback@dailyoffice2019.com
- Join the Facebook discussion at: https://www.facebook.com/groups/dailyoffice/