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.

WHAT IS THE SITE FOR?

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.

WHAT IS THE DAILY OFFICE?

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.

Contributing

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.

Requirements

Python 3.7 (other 3.x may work)
Node with npx
Yarn
PostgreSQL

Setting up a development environment

Clone project

Clone or fork the project from https://github.com/blocher/dailyoffice2019
cd dailyoffice2019

Import database

Connect to Postgres sudo psql -d postgres
Create database create database dailyoffice;
Create usercreate 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

Setup up python environment

Create a Python virtual environment python3 -m venv env
Load virtual environment source env/bin/activate
Install Python Requirements pip install -r requirements.txt

Setup up Javascript environment

cd site
Install JavaScript Requirements yarn install
Bundle Javascript and CSS npx webpack --watch

Run development server (in separate terminal)

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

Generate static site and deploy

Set the DEBUG setting to False in site\website\settings.py
Run python manage.py collectstatic from the site directory
Run python manage.py distill-local from the site directory. This builds a static copy of the site in the static_export directory
Run netlfy deploy --prod from static_export directory (must be done by site owner that has Netlify credentials)

Code formatting standard

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 the site directory

Quick overview

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 in website\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

Submitting Issues and Contact

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 @ [email protected]
Join the Facebook discussion at: https://www.facebook.com/groups/dailyoffice/

cwatersaudio / dailyoffice2019 Goto Github PK

dailyoffice2019's Introduction