aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 7038cb3d3912271926fe19f46c7d8de0ccdcf213 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
# pyble
Python Bible tools

This is a Python toolbox to analyse the Bible.

Copyright © 2015 Camil Staps. See license details below.

## Overview

The Bible is stored in an SQLite database with the structure:

Table        | Column        | Data type | Specials
-------------|---------------|-----------|---------------------------
book         | name          | TEXT      | PK
reference    | book          | TEXT      | PK, FK book.name
reference    | chapter       | INTEGER   | PK
reference    | verse         | INTEGER   | PK
translation  | name          | TEXT      | PK
text         | translation   | TEXT      | PK, FK translation.name
text         | book          | TEXT      | PK, FK reference.book
text         | chapter       | INTEGER   | PK, FK reference.chapter
text         | verse         | INTEGER   | PK, FK reference.verse
text         | text          | TEXT      |

<sup>(PK: primary key; FK: foreign key)</sup>

## Setting up

You're going to need one or several translations. One possibility is to [get them from Bible Hub][biblehubdb]. Download and unzip the zipped text file, then run `read-biblehub-db.py`.

## To do

Add a table for cross references, and a script to read in the database from [OpenBible.info][openbibledb].

Make a web frontend for anyone to search, add cross references, and vote for cross references.

## Troubleshooting

In case anything goes wrong, first check you're using **Python 3**.

## License

This project is licensed under the GPLv2 license. 

[biblehubdb]: http://biblehub.net/database/
[openbibledb]: http://www.openbible.info/labs/cross-references/