Skip to content

HebrewTools/Reader

Repository files navigation

Reader

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.

Installation

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 bhsa

Usage

To 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.

Web server

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.

Author & License

Copyright © 2018–present Camil Staps. Licensed under MIT; see the LICENSE file.