Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

referenceparser

jcuenod69ISC1.2.2TypeScript support: included

Parse a verse reference string to match for a book, chapter and verse

bible, verse-reference, string-parsing

readme

ReferenceParser

TLDR: Parse likely bible references from strings like "Jn3.16" or "1 Cor 13"

This is a simple library designed to infer an intended verse reference given a string. It is used in url parsing by https://parabible.com so that users can use any book abbreviations they want to use while also providing support for a standard set of urls.

Usage is simple

Step One: Add ReferenceParser to your project:

npm i referenceparser --save

Step Two: Import or require it somewhere in your code base and then instantiate it:

import ReferenceParser from 'referenceparser'
const rp = new ReferenceParser()

Step Three: Parse some text...

rp.parse("2 Kings 5:3")
//  { book: '2 Kings', chapter: 5, verse: 3 }

rp.parse("pss4.2")
//  { book: 'Psalms', chapter: 4, verse: 2 }

rp.parse("song of sol 10v4")
//  { book: 'Song of Songs', chapter: 10, verse: 4 }

rp.parse("ex")
//  { book: 'Exodus', chapter: null, verse: null }

rp.parse("2-kgs/3")
//  { book: '2 Kings', chapter: 3, verse: null }

rp.parse("garbage")
//  { book: null, chapter: null, verse: null }