1.0.1 • Published 6 years ago

bible-books v1.0.1

Weekly downloads
9
License
SEE LICENSE IN LI...
Repository
github
Last release
6 years ago

Bible Books • npm version

Access the books of the Bible in the traditional Hebrew and Protestant canon with a few handy methods.

Getting Started

yarn install bible-books

API

get(input)

Return an individual book of the Bible based on a search input.

input

Type: string

The string can be the 3 character ID of the book, or the full title of the book from any canon.

getAll(section, orderBy)

Return a list of books from a certain set of books and order them.

section

Type: string - OT | NT | *

orderBy

Type: string - hebrew | alpha

Order a list of books by a given canon order or alphabetically. Defaults to Protestant canon.

If ordered according to the Hebrew canon, the OT will be returned first with the Hebrew canon, and the NT (if requested) will be returned after it in traditional protestant order. Alphabetically does not respect the section.

Structure

All of the data can be found as two JSON objects in the data directory as new-testament.json or old-testament.json. When using the methods the data will be returned as either a single JSON object (for get()) or an array of Book Objects (for getAll()).

Book Objects

PropertyTypeOptional
titlesTitlefalse
orderOrderfalse

Title Objects

A title object is a simple object with the name of a book with different languages as keys.

This object is likely to expand in higher versions, with new additions being documented here.

PropertyTypeDescriptionOptional
englishstringThe common English title of the bookfalse
hebrewObjecttrue
hebrew.transliterationstringThe transliteration of the original Hebrew title of the bookfalse
hebrew.meaningstringThe translation of the original Hebrew title of the booktrue

Order Objects

Order objects are assigned to a top-level order object on a book by a sortable key referring to their order within some canon. Currently the two canons accounted for in ordering are the Hebrew canon (Old Testament) and the Protestant canon (Old & New Testaments).

PropertyTypeDescriptionOptional
globalnumberA number indicating the order the book occurs in across the whole testament.false
sectionObjectfalse
section.titlestringThe traditional title of the section of the Bible according to the given canonfalse
section.sequencenumberThe order in which the book appears in the given section of the given canonfalse
section.subtitlestringAn optional subtitle of the subsection to which the book belongs in the given canontrue
section.joinedWithstringCertain books that are two books in one canon are considered a single book in other canons. This field references the ID of the book for which it shares a book in the given canontrue

License

VOL • Made by me, but use how you want.

1.0.1

6 years ago

1.0.0

6 years ago