Standalone FilesWARNING! Please be advised that the older "stand-alone" downloadable files (as well as music files) have not been updated nor supported since the death of Laszlo Kiss in 2011. Use at your own risk!
iOS and Android AppsWe highly recommend instead downloading the Breviarium Meum app (available for iOS) for the Breviary, as well as the iMass app for Android and iOS. The Laudate app can be downloaded for use of the Breviary on iOS or Android devices. We are now partnering with the iPieta app; Divinum Officium functionality should be available on that app in the near future.
.mobi and .ePub FilesIt is possible to generate Missal and Breviary files in .mobi or .ePub format, with all texts generated on a monthly basis. Please refer to our GitHub site for details. They can also be downloaded from the following site: http://breviarium.srubarovi.cz
GitHub RepositoryThe source code for the Divinum Officium website can be found and freely downloaded from our GitHub repository. From this repository, one can download the code to a Windows, Mac, or Linux computer and run the code as a local web host.
There are two repositories at GitHub; of these, we recommend cloning divinum-officium.
Instructions for cloning are available at the links under the 'clone URL' box on the right-hand side of the Divinum-Officium GitHub. If you have Git installed, it is strongly recommended to locally update the files (via git pull) from this repository to account for the ongoing changes and improvements to the site.
The website is contained in the web/ subdirectory of this repository. The other directories at the top level should not be served from a webserver.
Hosting Locally: PythonIt is possible to set up Divinum Officium as a local host using a Python script, and provided Perl is installed (see below). Using an Android device, this can be done via UserLAnd with its Ubuntu distribution and installing the lxde package therein. Next, download the appropriate packages (Git, Python, and then clone the Git repository as described above). Once the divinum-officium repository has been cloned, the following terminal syntax may be used:
cd ~/divinum-officium/web && python -m CGIHTTPServer
One may need to adjust python to python2 or python3, given the installed version. One may also need to adjust the path to the directory, provided the path ends in /web.
Once the server is active and running in the terminal window, navigate to (typically) 0.0.0.0:8000 in your browser. Divinum Officium should then be functional as on the live site.
Hosting Locally: ApacheIf installing on a different server (e.g. Apache), Perl >= 5.10.1 is required, as are the following modules. (Perl 5.20.1 is recommended as it contains all necessary CGI packages.) Depending on the Perl version and distribution these might already be installed; if they are not, they can be obtained from your OS/Perl distribution or from CPAN:
(Typically, you will already have all of these.)
Most importantly, your webserver must be configured to allow the execution of CGI scripts from web/cgi-bin/.
For Apache one way to achieve this is to use the following directives in a Directory element for that directory:
AddHandler cgi-script .pl
This httpd.conf file may prove useful on an Apache host; it is currently being used on a Mac OS 10.14 (Mojave). WARNING: Use at your own risk!
Hosting Locally: DockerIf you are using a linux system, or another system supporting docker, Docker is by-far the easiest method. The latest updates to the application are built and pushed in realtime to Docker Hub tag divinumofficiumweb/divinumofficium:latest, so you can pull and run this container image locally at any time.
If you're not sure how to begin, there is also a docker-compose file which wraps the needed docker commands for you. Installing docker and docker-compose are outside the scope of this guide.
$ wget https://raw.githubusercontent.com/DivinumOfficium/divinum-officium/master/docker-compose-prod.yml
$ docker-compose pull
$ docker-compose -f docker-compose-prod.yml up -d
This will now expose the application on http://localhost. To bring it down, run:
$ docker-compose -f docker-compose-prod.yml down
For more information on the docker method, see the Github Repository linked above.
If you have any problem with installation, please send a message to canon DOT missae AT gmail DOT com