Commentary format

The easiest way to send us a commentary is a JSON file: plain text that any program can write and anyone can read. This is the shape Via Patrum uses for its commentaries.

The file

One file for each book of a work, in UTF-8. A shorter edition can share the file: each comment says which editions it is in.

{
  "book": "Romans",
  "title": "Chrysostom on Romans",
  "license": "Public domain",
  "credit": "Philip Schaff, ed., Nicene and Post-Nicene Fathers, First Series, vol. 11",
  "comments": [
    {
      "chapter": 12,
      "verse_start": 1,
      "verse_end": 2,
      "capsule": "Each bodily member becomes a sacrifice not merely by avoiding evil but by being turned to active good, and the fire of this new offering does not consume the victim but gives it life.",
      "comment": "And how is the body, it may be said, to become a sacrifice? Let the eye look upon no evil thing, and it has become a sacrifice ... That [the old sacrifice] presented the thing sacrificed dead: this makes the thing sacrificed to be living.",
      "author": "John Chrysostom",
      "work": "Homilies on Romans, 20",
      "url": "https://example.org/chrysostom/romans/20/",
      "editions": ["complete", "selected"]
    }
  ]
}

The work

FieldHolds
bookThe book’s name or code (below)
titleThe work’s title
licenseIts license
creditThe credit to give
commentsThe comments, one entry each

Each entry

FieldHolds
chapterThe chapter, in the King James numbering
verse_start, verse_endThe first and last verses commented on; the same for a single verse
capsuleThe comment’s point, in one sentence
commentThe comment, as plain text; a blank line between paragraphs
authorThe writer’s name
workThe work it comes from
urlA link to the whole passage (https only)
editionsThe editions it is in: "complete", and "selected" for the shorter one

Each comment

Book codes (and MyBible numbers)
  • Genesis · GEN · 10
  • Exodus · EXO · 20
  • Leviticus · LEV · 30
  • Numbers · NUM · 40
  • Deuteronomy · DEU · 50
  • Joshua · JOS · 60
  • Judges · JDG · 70
  • Ruth · RUT · 80
  • 1 Samuel · 1SA · 90
  • 2 Samuel · 2SA · 100
  • 1 Kings · 1KI · 110
  • 2 Kings · 2KI · 120
  • 1 Chronicles · 1CH · 130
  • 2 Chronicles · 2CH · 140
  • Ezra · EZR · 150
  • Nehemiah · NEH · 160
  • Esther · EST · 190
  • Job · JOB · 220
  • Psalms · PSA · 230
  • Proverbs · PRO · 240
  • Ecclesiastes · ECC · 250
  • Song of Solomon · SNG · 260
  • Isaiah · ISA · 290
  • Jeremiah · JER · 300
  • Lamentations · LAM · 310
  • Ezekiel · EZK · 330
  • Daniel · DAN · 340
  • Hosea · HOS · 350
  • Joel · JOL · 360
  • Amos · AMO · 370
  • Obadiah · OBA · 380
  • Jonah · JON · 390
  • Micah · MIC · 400
  • Nahum · NAM · 410
  • Habakkuk · HAB · 420
  • Zephaniah · ZEP · 430
  • Haggai · HAG · 440
  • Zechariah · ZEC · 450
  • Malachi · MAL · 460
  • Matthew · MAT · 470
  • Mark · MRK · 480
  • Luke · LUK · 490
  • John · JHN · 500
  • Acts · ACT · 510
  • Romans · ROM · 520
  • 1 Corinthians · 1CO · 530
  • 2 Corinthians · 2CO · 540
  • Galatians · GAL · 550
  • Ephesians · EPH · 560
  • Philippians · PHP · 570
  • Colossians · COL · 580
  • 1 Thessalonians · 1TH · 590
  • 2 Thessalonians · 2TH · 600
  • 1 Timothy · 1TI · 610
  • 2 Timothy · 2TI · 620
  • Titus · TIT · 630
  • Philemon · PHM · 640
  • Hebrews · HEB · 650
  • James · JAS · 660
  • 1 Peter · 1PE · 670
  • 2 Peter · 2PE · 680
  • 1 John · 1JN · 690
  • 2 John · 2JN · 700
  • 3 John · 3JN · 710
  • Jude · JUD · 720
  • Revelation · REV · 730

Other books, such as those of the Apocrypha, are not loaded yet: their comments are left out.

Also accepted: a MyBible module

One SQLite file, named WORK.commentaries.SQLite3, with these tables. Its info table holds description (the title) and detailed_info (the other details of the work); each row of commentaries is one entry, with the book given by its MyBible number and the comment as HTML: its point in bold, then the comment, then the writer, the work, and a link.

  • Use p, br, em, strong, i, b, sup, sub, small, blockquote, ul, ol, li, h3–h6, and a. Any other tag is removed and its words kept.
CREATE TABLE info (name TEXT, value TEXT);
CREATE TABLE commentaries (
  book_number NUMERIC,
  chapter_number_from NUMERIC,
  verse_number_from NUMERIC,
  chapter_number_to NUMERIC,
  verse_number_to NUMERIC,
  text TEXT
);