Skip to content

igor-primo/commandline-breviary

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

brev: commandline-breviary

I modified the Divinum-Officium script for generating EPUB files in order to show the Office or Mass Propers in plain text format, serving as a command-line program.

The perl script that calculates the Office of the day generates the Office content in Xhtml format. I use 'html2text' to extract the contents and 'sed' to format it a little bit. This may cause some overhead, specially when generating several files. While I learn perl scripting this will be the way to go. One may view the files in Xhtml as well.

Generating Mass Propers and generating Offices are mutually exclusive operations. If one wishes to do both, he/she will have to generate one after the other.

usage

brev -o <HOUR>

This command generates of office of current day and pipes the content into 'less' pager. Can be: Matutinum, Laudes, Tertia, Sexta, Nona, Vespera, Completorium.

brev -o <HOUR> -x

This command generates the office of current day leaving it as a Xhtml files and pipes it into lynx.

brev -m

Generates the Mass Propers for the current day and pipes the Xhtml contents into 'less' pager.

brev -m -x

Generates the Mass Propers for the current day and pipes it into lynx. This is a buggy option for the time being.

brev -w

Generates all Office files of all months of the current year and writes them into files with names 'breviarium-$MONTH.xhtml'. A file for all Offices of the year is created. This last file is just the appending of all month files in order.

brev -w -m

The same as the previous one, but the contents are the Mass Propers.

The other options are similar to the original script.

brev -o <HOUR> -r <RUBRICS>

This command generates the Office using the rubric. can be 1570, 1910, DA, 1955, 1960, Newcal, Dominican, Monastic. A similar command is provided for Mass Propers: brev -m -r <RUBRICS>. In both cases, the default rubric is 1960.

brev -o <HOUR> -v

Generates the Office using the Parvum Blessed Virgin Mary votive office.

brev -p -o <HOUR>

Generates the Office with statements suitable to a priest. For example, 'Domine, exaudi orationem meam' is substituted for 'Dominus vobiscum'.

brev -y <FIRST_YEAR> -t <LAST_YEAR> -w

Generates all the files specified as in '-w' but with the first year <FIRST_YEAR> and last year <LAST_YEAR>. Can be combined with -m.

brev -o <HOUR> -d MONTH-DAY-YEAR

Generates the hour of the specified date. The -d can also be combined with -m. If the date is invalid, brev will print the office/mass of the current day.

installation

You can place the project directory in some digital attic of your preference and modify the CDUR brev script veriable to the directory of brev script. You can simply execute the 'cdur' script and it will do this for you. Also, place the to brev into the PATH environment variable.

dependencies

Perl modules CGI.pm and LWP/Simple.pm.

similar programs

Vulgate

King James Version

Septuagint and more

thanks

Thanks for the Divinum-Officium project for the dedication they put into preserving the spiritual oasis that once glorified the Church of Rome.

license

The original project is under the MIT License. I quote the license note from the original project README:

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

This permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE."

About

Roman breviary and other offices for use in the CLI.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages