Documentation and structure of BibleJSON.

Converter Script

We want to make it easy to transfer to BibleJSON. Currently, we have a very buggy converter script written in Rust that converts eBible.org HTML files into BibleJSON. Soon we want to include more formats, so you can convert from USFM, USX, txt, etc.

BibleJSON Formatting

We plan to have 2 versions of BibleJSON, the formatted version with full text formatting, and the minimal version which is just plain text inside verse objects.

Red - something already implemented

Yellow - something we plan to add

Structure (formatted)

• details
  • bibleAbrv - the abbreviation of the translation that the file is, ex. “BSB”
  • bibleName - the name of the translation, ex “Berean Standard Bible”
  • bookAbrv - the short ID or abbreviation of the book that the file is, ex. “JHN”
  • bookName - the name of the book, ex. “John”
  • chapterNumber - the chapter number
  • verseCount - the amount of verses in that file
  • langEnglish - the language of the translation in English
  • lang - the language
• content - the actual Bible content, an array
  • item - each item is an object
    • type - the type of the item - header | subheader | verse | whitespace
    • verse (only type verse ) - the verse number
    • text - array of the content
      • more items, just like content
        • text - the content string
        • style - the style of the item - text | qoute | footnote | italic | red | smallCaps | smallCapsBold
        • footnoteText (only for footnotes) - the content of the footnote

Structure (minimal)

• details
  • bibleAbrv - the abbreviation of the translation that the file is, ex. “BSB”
  • bibleName - the name of the translation, ex “Berean Standard Bible”
  • bookAbrv - the short ID or abbreviation of the book that the file is, ex. “JHN”
  • bookName - the name of the book, ex. “John”
  • chapterNumber - the chapter number
  • verseCount - the amount of verses in that file
  • langEnglish - the language of the translation in English
  • lang - the language
• content - the actual Bible content, an array
  • item - each item is an object
    • type - the type of the item - header | subheader | verse | whitespace
    • verse (only type verse ) - the verse number
    • text - the content (string)

Resources

https://wiki.crosswire.org/OSIS_Book_Abbreviations

eBible HTML Tags

span.wj = words of Jesus, red text

span.add = italic

span.sc = small caps

span.nd = bold & small caps

div.nd = book title

div.q = a quote that is indented

div.s = section header

div.d = section sub header, ex. for psalms

div.b = white space, usually front/back quotes