# Public-domain Bible texts

The `svv`, `brenton`, and `canisius` API versions are served from
`data/public_domain_bibles.sqlite`. They do not make runtime requests to an
external Bible API and do not use the passage cache.

## Sources

| API key | Text | Machine-readable source | Rights status |
| --- | --- | --- | --- |
| `svv` | Staten Vertaling | [Bible SuperSearch SQLite download](https://api.biblesupersearch.com/api/download?bible=stve&format=sqlite3&zip=1) | Listed by Bible SuperSearch as non-copyrighted and downloadable |
| `brenton` | Brenton Septuagint Translation | [eBible USFM archive](https://ebible.org/Scriptures/eng-Brenton_usfm.zip) | Public domain |
| `canisius` | Petrus Canisiusvertaling, 1939 | [eBible USFM archive](https://ebible.org/Scriptures/nld1939_usfm.zip) | Public domain |

The source URL, SHA-256 checksum, rights statement, and imported verse count for
each downloaded archive are also stored in the database's `versions` table.

## Rebuilding

Run from the project root:

```sh
python3 cli/import_public_domain_bibles.py
```

Missing archives are downloaded into `cli/public_domain_sources/`. That source
directory is excluded from Git. The importer removes USFM study notes,
cross-references, and formatting markers, retains the Scripture wording, merges
bridged or suffixed verse labels, validates representative verses and minimum
record counts, and atomically replaces the SQLite database.

## Imported records

| API key | Verses | Books |
| --- | ---: | ---: |
| `svv` | 31,102 | 66 |
| `brenton` | 28,691 | 53 |
| `canisius` | 35,336 | 73 |

Brenton contains the Septuagint Old Testament and its additional books, not a
New Testament. Canisius includes its deuterocanonical books. SVV contains the
66-book Protestant canon in the downloaded Bible SuperSearch edition.
