Skip to content
A tool to generate Biblical Hebrew readers
Python HTML Dockerfile TeX Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
Dockerfile
LICENSE
README.md
collectcontexts.py
hebrewreader.py
hebrewreaderserver.py
index.html
minitf.py
post.tex
posttext.tex
postvoca.tex
pre.tex
pretext.tex
prevoca.tex
runserver.sh
setup.py
texlive.profile

README.md

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.

You can’t perform that action at this time.