A tool to generate Biblical Hebrew readers. A reader contains a number of texts, joined with a vocabulary containing exactly those lemmas that occur in the text.
The tool can also be used at reader.hebrewtools.org.
This tool relies on text-fabric for accessing the Hebrew Bible, and on the data in the BHSA.
Make sure that you have Python 3 and XeLaTeX installed.
$ pip3 install text-fabric
$ git clone https://github.com/HebrewTools/Reader
$ svn export https://github.com/ETCBC/bhsa/trunk/tf/c /tmp/bhsa
$ cd Reader
$ mkdir data
$ ./collectcontexts.py --bhsa /tmp --module bhsaTo get a reader for Genesis:
./hebrewreader.py \
--pdf genesis.pdf \
Genesis
Instead of Genesis, you can also specify passages, e.g. Psalms 1, Exodus 3:15, 1 Kings 17:7-end or Job 38:1-bookend.
You can also specify multiple passages:
./hebrewreader.py \
--pdf job-fragments.pdf \
'Job 28' 'Job 38:1-38'
When you combine multiple passages, you can add --combine-voca to include one
vocabulary list at the end of the document, rather than separate lists after
each passage.
See ./hebrewreader.py --help for more options.
The easiest way to access the reader is using the web server. It is not needed to install it; simply go to reader.hebrewtools.org.
To run the web server locally, run ./runserver.sh. It is distributed as a
Docker app, so besides Docker you will not need to have anything installed.
It may be that the LaTeX installation in the Docker image fails due to
contemporaneous updates to the TeX Live registry. In that case, run
./runserver.sh again later.
Copyright © 2018–present Camil Staps. Licensed under MIT; see the LICENSE file.