Logia

About

Open data

All 51,240 excerpts from 57 commentaries by 29 commentators, free to download and build on. The data is CC0: no permission needed, no attribution required.

Download

Every excerpt with its verse range, its place in the work and the address of the page it was copied from. Scan misreadings are already corrected. The files are rebuilt from the repository whenever the site is.

A book or a work at a time

The same records as the CSV above, one file per book of the Bible and one per commentary, small enough for a spreadsheet. For JSON a chapter or a work at a time, use the API below.

By book: Genesis 4.5 MB · Job 332 KB · Psalms 18.2 MB · Proverbs 3.0 MB · Ecclesiastes 1.1 MB · Song of Songs 118 KB · Matthew 9.3 MB · Mark 804 KB · Luke 4.4 MB · John 12.6 MB · Romans 6.3 MB · Galatians 287 KB · Hebrews 2.1 MB

By commentary:

One record

An excerpt as the JSON file holds it (its text cut short here). The CSV has the same fields, one excerpt a row.

{
  "id": "calvin.JHN.3.16.1",
  "work": "calvin",
  "author": "calvin",
  "start": "JHN.3.16",
  "end": "JHN.3.16",
  "heading": "For God so loved the world",
  "text": "16. For God so loved the world. Christ opens up the first cause, and, as it were, the source of our salvation, and he…",
  "locus": "",
  "source_url": "https://www.ccel.org/ccel/calvin/calcom34.ix.iii.html"
}

For developers

The download's shape as a JSON Schema, and a few lines in Python and JavaScript to start from. Neither needs a key or a library.

Python: the whole download

Reads logia-en.json and prints the start of every excerpt on John 3:16 (the standard library only).

import json, urllib.request

url = "https://logia.faith/downloads/logia-en.json"
data = json.load(urllib.request.urlopen(url))
for x in data["excerpts"]:
    if x["start"] == "JHN.3.16":
        work = data["works"][x["work"]]
        print(work["title"], "|", x["text"][:80])

JavaScript: one chapter from the API

Fetches John 3 from the API and prints the start of each excerpt on verse 16 (in a browser module or Node 18 and later).

const url = "https://logia.faith/api/v1/chapters/JHN.3.json";
const chapter = await (await fetch(url)).json();
const verse = chapter.verses.find(v => v.verse === 16);
for (const id of verse.excerpts) {
  const x = chapter.excerpts[id];
  console.log(x.author_name, "|", x.text.slice(0, 80));
}

The API

The same library as static JSON for other programs and sites: every chapter of the Bible with its text and the excerpts on each verse, the works with their rights, the commentators, the topics and the whole texts. No key, any origin; fields are added within a version, never removed or renamed.

Versioned releases

The downloads above are rebuilt with every change. For a fixed copy to cite or build on, each data release is a zip of the whole library, its sources list and its documentation, numbered by format, additions and fixes, and the same bytes each time it is built from its tag.

What each field holds

idThe excerpt's permanent id: work, first verse and number (calvin.JHN.1.14.1). It never changes once published.
workThe commentary it comes from (calvin), as in library/works/.
authorThe commentator (calvin), as in library/authors/.
start, endThe verses it comments on, as BOOK.chapter.verse (JHN.1.6 to JHN.1.8).
headingThe source's own heading or lemma over the passage, where it has one.
textThe excerpt, copied from the source with scan corrections applied. Paragraphs are separated by a blank line, and a cut inside one is marked " ... ".
locusIts place in a work with its own divisions: 2.8 is Homily 2, section 8.
source_urlThe page or scan it was copied from.

In the repository

The repository holds everything the site is built from, with more than these files: the Scripture each excerpt cites, the Catena's quotations traced to their sources, and the whole homilies and tractates.

library/commentsThe excerpts, one file per work and book
library/worksEach commentary's edition, translator, year and rights
library/authorsEach commentator's dates, era and tradition
library/citationsThe Scripture each excerpt cites, found by a script, with a review status
library/quotationsThe Catena Aurea's quotations of the Fathers, traced to their works
library/textsWhole homilies and tractates, paragraph by paragraph
library/correctionsEach scan misreading and its fix
sourcesThe source text each excerpt was checked against, and where it came from

Licences

Each work's record says what is still to confirm for use outside the US. Works and biographies are marked ai_draft until a named person reviews them.