grb

Unnamed repository; edit this file 'description' to name the repository.
Log | Files | Refs | README

README.md (2504B)


      1 # grb -- Greek Bible on the Command Line
      2 
      3 A command line tool for search and reading the Bible in Greek.
      4 The Old Testament is the Septuagint (containing some differing texts), and the New Testament is the [SBL Greek New Testament](http://sblgnt.com/download/).
      5 
      6 Format and original implementation from [bontibon/kjv](https://github.com/bontibon/kjv). Meant to be a companion program.
      7 
      8 ## Usage
      9 
     10     usage: ./grb [flags] [reference...]
     11 
     12       -l      list books
     13       -W      no line wrap
     14       -h      show help
     15 
     16       Reference types:
     17           <Book>
     18               Individual book
     19           <Book>:<Chapter>
     20               Individual chapter of a book
     21           <Book>:<Chapter>:<Verse>[,<Verse>]...
     22               Individual verse(s) of a specific chapter of a book
     23           <Book>:<Chapter>-<Chapter>
     24               Range of chapters in a book
     25           <Book>:<Chapter>:<Verse>-<Verse>
     26               Range of verses in a book chapter
     27           <Book>:<Chapter>:<Verse>-<Chapter>:<Verse>
     28               Range of chapters and verses in a book
     29 
     30           /<Search>
     31               All verses that match a pattern
     32           <Book>/<Search>
     33               All verses in a book that match a pattern
     34           <Book>:<Chapter>/<Search>
     35               All verses in a chapter of a book that match a pattern
     36 
     37 ## Notes and Contents
     38 
     39 - I/II Samuel and I/II Kings are named with their English titles despite the fact that in Greek they are respectively I-IV Kings. This is simply because the interface is in English and is supposed to be consistent with `kjv`.
     40 - What are in some versions the books Erza and Nehemiah are in the Septuagit 2 Esdras. However these books/verse can be accessed via either possible name.
     41 - Apochrophal and Deuterocanonical books included, including:
     42 	- 1 Esdras
     43 	- Judith
     44 	- Tobit
     45 	- I-IV Maccabees
     46 	- Odes
     47 	- Wisdom of Solomon
     48 	- Psalms of Solomon
     49 	- Zephaniah (Sophonias)
     50 	- Baruch
     51 	- Letter of Jeremiah
     52 	- Susanna
     53 	- Bel and the Dragon
     54 - Different editions of books from different texts:
     55 	- Judges (Alexandrinus (default) & Vaticanus)
     56 	- Tobit (Vaticanus/Alexandrinus (default) & Sinaiticus)
     57 	- Daniel (Theodotion)
     58 	- Susanna (Theodotion)
     59 	- Bel and the Dragon (Theodotion)
     60 
     61 ## Install
     62 
     63 Install `grb` by running:
     64 
     65 ```
     66 git clone https://github.com/lukesmithxyz/grb.git
     67 cd grb
     68 sudo make install
     69 ```
     70 
     71 ## License
     72 
     73 The script is in the public domain.
     74 The SBL Greek New Testament translation/edition has a permissive license for non-commercial uses. See it [here](http://sblgnt.com/license/).