Scripture & Reading Entity

Readings are first-class entities, not generic text blocks. This allows lectionaries, service books, teaching tools, and Bible references to interoperate.

{
  "id": "reading-john-1-1-17",
  "type": "gospel",
  "role": "role-deacon",
  "reference": {
    "system": "osis",
    "osisRef": "John.1.1-John.1.17",
    "book": "John",
    "chapterStart": 1,
    "verseStart": 1,
    "chapterEnd": 1,
    "verseEnd": 17
  },
  "text": {
    "en": "In the beginning was the Word..."
  }
}

Reference-Only and Embedded Readings

Use reference when a service book points to a passage that a licensed Bible provider or local lectionary will supply. Include text when the package is permitted to distribute the wording and the exact translation matters.

{
  "id": "reading-john-1-1-17",
  "type": "gospel",
  "role": "role-deacon",
  "reference": {
    "system": "osis",
    "osisRef": "John.1.1-John.1.17"
  }
}

Do not derive an OSIS reference by parsing a localized display label. Keep the canonical reference structured, then render book names and verse punctuation for the reader’s locale.

When embedded wording comes from a copyrighted translation, attach its citation and license. The scripture reference itself and permission to redistribute a particular translation are separate concerns.

”Your word is a lamp to my feet and a light to my path.”

Psalm 119:105