Projects BibleWeb Commentaries Kanttekeningen (Dutch)
Done

Kanttekeningen (Dutch)

Area: Commentaries Milestone: v2

Context

Problem: Dutch-speaking Bible readers have a unique historical resource: the Kanttekeningen bij de Statenvertaling — the official marginal notes published alongside the original 1637 Statenvertaling. These notes are a treasure of Dutch Reformed theology and textual scholarship, but are rarely available digitally.

Solution: BibleWeb includes the complete Kanttekeningen as the third commentary source. Unlike Matthew Henry and John Gill (which are English), the Kanttekeningen are natively Dutch — they were written in Dutch alongside the Dutch Bible translation.

Not included: Modern Dutch commentaries. The Kanttekeningen are a historical document from 1637.

Functional

The Kanttekeningen appear as the third tab in the commentary drawer. They are displayed in their original Dutch text — no translation needed, since they were written in Dutch.

User flow:

  1. User opens the commentary drawer on any verse
  2. Clicks the "Kanttekeningen" tab
  3. Reads the original Dutch marginal notes
  4. Text is in 17th-century Dutch (Statenvertaling-era language)

Edge cases:

  • The text column already contains Dutch — the text_nl column would be redundant for this source
  • 25,223 entries — more than Matthew Henry but fewer than John Gill
  • Language is archaic Dutch (1637), matching the Statenvertaling style

UX & Design

Same as other commentaries — third tab in the commentary drawer. The text is in Dutch regardless of the UI language setting (it's the original Dutch, not a translation).

Technical

Data:

  • DB table: commentaries with source = 'kanttekeningen_sv'
  • Row count: 25,223 entries
  • Unique characteristic: the text column IS Dutch (not English) — this is the one commentary source where translation to Dutch (text_nl) would be redundant

Data source: Imported from BibleGame source database (~/Code/BibleGame/Data/output/bible.db) via scripts/seed-commentaries.ts.

Component: Same CommentaryDrawer.svelte — Kanttekeningen is the third tab in SOURCE_ORDER.

Dutch fallback logic: When the UI is in Dutch and text_nl is NULL, CommentaryDrawer.svelte normally shows a fallback message "(Alleen beschikbaar in het Engels)". For Kanttekeningen, this message would be misleading since the text is already Dutch — but the fallback only triggers when text_nl is null AND the user is in Dutch mode, so it correctly falls back to showing the English text column which in this case already contains Dutch text.

Files:

  • apps/web/src/lib/components/bible/CommentaryDrawer.svelte — shared component
  • apps/web/src/routes/api/commentaries/[bookId]/[chapter]/[verse]/+server.ts — shared API
  • apps/web/src/lib/server/queries/commentaries.ts — shared queries
  • scripts/seed-commentaries.ts — import script

Status

Current: DONE Milestone: v2 Priority: High — unique Dutch resource unavailable in most Bible apps

History:

  • The Kanttekeningen are a distinctive feature of BibleWeb — few digital Bible tools include them
  • Originally digitized for the BibleGame desktop app
  • Provides a uniquely Dutch perspective alongside the English commentaries

Dependencies:

  • Requires: commentary drawer (DONE), tier system (DONE)
  • Used by: AI chat RAG pipeline (Dutch commentary context)

Screenshots

Feature screenshot