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
| Field | Holds |
|---|---|
book | The book’s name or code (below) |
title | The work’s title |
license | Its license |
credit | The credit to give |
comments | The comments, one entry each |
Each entry
| Field | Holds |
|---|---|
chapter | The chapter, in the King James numbering |
verse_start, verse_end | The first and last verses commented on; the same for a single verse |
capsule | The comment’s point, in one sentence |
comment | The comment, as plain text; a blank line between paragraphs |
author | The writer’s name |
work | The work it comes from |
url | A link to the whole passage (https only) |
editions | The editions it is in: "complete", and "selected" for the shorter one |
Each comment
- Cover six verses or fewer: a comment appears under every verse it covers.
- Include only comments that discuss the verse, not passing citations.
- Leave out the verse’s own text; the reader already shows it.
- Mark a cut with
...and an editor’s insertion with [square brackets]. - Comments on the same verses appear in the order they come in the file.
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, anda. 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 );