1 · Insluiten met de widget
Plak dit op je pagina — geen bouwstap, geen afhankelijkheden. De widget rendert in een afgeschermde Shadow DOM, dus je eigen opmaak blijft ongemoeid:
De widget gebruikt bewust een neutrale systeemfont, zodat hij naadloos in jouw eigen opmaak past en we onze webfonts niet opdringen. Wil je juist onze stijl? Zet data-stijl="vsv":
Eén <script> volstaat voor de hele pagina; plaats zoveel div's als je wilt. Opties via data-attributen:
| Attribuut | Voorbeeld | Doel |
|---|---|---|
data-passage | "Psalm 23:1-3" | Vrije verwijzing: boek + hoofdstuk, optioneel :vers of :vers-vers. Afkortingen (Joh, Ps, 1Kor) mogen. |
data-boek + data-hoofdstuk | "Markus" / "1" | Alternatief voor data-passage; met data-verzen="1-8" voor een bereik. |
data-godsnaam | "heere" | Toon de Godsnaam als HEERE i.p.v. Jahweh (standaard jahweh). |
data-kopjes | "uit" | Verberg tussenkopjes (standaard aan). |
data-noten | "aan" | Toon grondtekst-noten (standaard uit). |
data-stijl | "vsv" | Gebruik onze projectfonts (standaard een neutrale systeemfont). |
data-bron | "uit" | Verberg de bronvermelding-voet (standaard aan — zie licentie). |
Alleen nagekeken hoofdstukken zijn beschikbaar (zie Voortgang). Voor een nog niet beschikbaar gedeelte toont de widget een nette verwijzing naar de site.
2 · JSON-API
Liever zelf de weergave bouwen? Alle leesacties zijn publiek en CORS-open (Access-Control-Allow-Origin: *), dus rechtstreeks vanuit je eigen JavaScript te bevragen. Basis-URL:
| action | Parameters | Geeft |
|---|---|---|
list | — | Alle beschikbare hoofdstukken (boek, hoofdstuk, goedgekeurd). |
lezen | boek, hoofdstuk | Eén hoofdstuk: verzen, kopjes, notities, verwijzingen, kanttekeningen. |
search | q | Volledige-tekst-zoekresultaten (referentie + tekst). |
export_book | boek, variant | Heel boek in één respons (variant=jahweh|heere). |
get_translation | boek_nr, hoofdstuk, translation | Parallel: Berean (EN) of Luther (DE). |
get_woordindex / get_kantindex / get_hertaalregels | — | Woordindex, kanttekening-index en de hertaalregels. |
Voorbeeld — een hoofdstuk ophalen:
De brontekst (Grieks/Hebreeuws, Nestle-Aland) is auteursrechtelijk en niet via de open API beschikbaar. Schrijven kan niet: de API is uitsluitend lezen.
3 · Download de hele vertaling
Wil je de tekst zelf hosten of verwerken? Pak de volledige goedgekeurde vertaling als JSON of XML:
De XML volgt het schema <book><chapter><verse> met <heading>, <note>, <ref> en <kanttekening>. De JSON groepeert boek → hoofdstuk → verzen.
4 · Licentie & bronvermelding
De tekst van de Vrije Statenvertaling is vrij — vrij te gebruiken, te wijzigen en te verspreiden, ook commercieel — onder CC BY-SA 4.0. Twee dingen houden we daarbij vast:
- Het blijft vrij. Bewerk of verspreid je de tekst, dan blijft die onder dezelfde vrije licentie. Zo kan niemand er een gesloten, eigen versie van maken — verkopen of drukken mag wél.
- Geen verwarring. Een gewijzigde versie is jouw bewerking — noem of presenteer die daarom niet als “Vrije Statenvertaling”.
Een korte bronvermelding (link naar vrijestatenvertaling.nl) stellen we op prijs — de widget doet dit automatisch. De brontekst (Grieks/Hebreeuws) valt buiten deze licentie en is niet inbegrepen.
Vragen of iets bijzonders nodig? Neem contact op.