LibrerĂa con la Biblia, open source!
Consulta los libros de la Biblia
Supports Node v18+, Modern Browsers (desktop and mobile).
## Quickstart setup
```shell
npm install bible--core
```
## Library usage
```ts
import { Bible } from 'bible--core';
const bible = new Bible();
// Get the entire Bible object
const allContent = bible.bible;
console.log(allContent);
// Get a list of all book names
const bookNames = bible.getAllBooks();
console.log(bookNames);
// Get a specific book by name
const genesis = bible.getBook('GĂ©nesis');
console.log(genesis);
// Get a specific book versiculums
const genesisVersiculums = bible.getBookVersiculums('GĂ©nesis');
console.log(genesis);
// Get the cross references (parallel passages) of a versiculum
const crossReferences = bible.getCrossReferences({ b: 'Gn', c: '1', v: '1' });
console.log(crossReferences); // ['Job 38-39', 'Sl 8', 'Sl 104', 'Pr 8:22-31', 'Jn 1:1-3', ...]
// Same references, structured
const details = bible.getCrossReferenceDetails({ b: 'Gn', c: '1', v: '1' });
console.log(details); // [{ book: 'Job', chapter: '38', chapterTo: '39' }, ..., { book: 'Pr', chapter: '8', verses: [{ from: '22', to: '31' }] }, ...]
```
`getCrossReferences` takes a versiculum with the book abbreviation (`b`), chapter (`c`) and verse (`v`), the same shape returned by `getBookVersiculums` and `allVersiculums`. It returns an empty array when the verse has no references.
The references are the parallel passages of the Biblia, in the order the edition lists them. They use the book abbreviations of this library and keep the BJ notation:
- `Job 38-39`: chapters 38 to 39. `Sl 8`: the whole chapter.
- `Gn 1:1-2:4`: from chapter 1 verse 1 to chapter 2 verse 4.
- `Gn 25:26.29-34`: verse 26 and verses 29 to 34.
- Verse suffixes: `+` the passage has a note, `s` and the following verse, `p` and its parallels, `a`/`b` part of the verse.
Section titles have their own references, under the verse `t`, e.g. `bible.getCrossReferences({ b: 'Gn', c: '2', v: 't2' })` returns `['Gn 1:1-2:4']`.
The data is built from `cross-references/paralelos.json` with `python3 cross-references/build_cross_references.py`.