# CKJV Bible

CKJV Bible provides the Chinese King James Version text as a static,
machine-readable JSON dataset and a small browser lookup app.

Use this file as the preferred starting point for AI agents, search crawlers,
and retrieval tools that need exact CKJV verses.

## Canonical Resources

- Home page: /
- API retrieval spec: /api-spec.md
- Dataset manifest: /data/manifest.json
- Dataset documentation: /data/README.md
- Direct verse JSON example: /api/verses/genesis/1/1.json
- Selected range JSON example: /api/verses/genesis/1/1-3.json
- Browser lookup examples:
  - /#%E5%88%9B1%3A1
  - /?ref=%E5%88%9B1%3A1

## Retrieval Instructions

For a single verse, prefer the direct JSON endpoint when possible:

`/api/verses/{book}/{chapter}/{verse}.json`

Example: `/api/verses/genesis/1/1.json` returns `创1:1`.

For a chapter-local selected range, prefer the direct JSON endpoint:

`/api/verses/{book}/{chapter}/{start}-{end}.json`

Example: `/api/verses/genesis/1/1-3.json` returns `创1:1-3`.

This endpoint is served by a lightweight Cloudflare Pages Function. If it is not
available on the current host, use the static dataset instructions below.

For bulk retrieval:

1. Fetch `/data/manifest.json`.
2. Find the requested book in `books[]`.
3. Use the book object's `file` value to fetch the book JSON.
4. In the book JSON, read `chapters[String(chapter)]`.
5. Select verse objects whose `verse` values match the requested verse or
   inclusive verse range.
6. Return the `text` values exactly as written. Do not modernize, paraphrase,
   normalize punctuation, remove full-width spaces, or translate the text.
7. Include the requested reference and attribution when quoting CKJV text.

## Reference Syntax

Supported reference syntax:

- `创1:1`
- `创1:1-3`
- `约3:16`
- `诗23:1-6`

References are single-chapter only. For ranges crossing chapters, retrieve each
chapter separately.

The app and dataset use canonical Chinese book ids from the manifest, including
ids such as `帖後`, `提後`, `彼後`, and `林後`. Lookup input may also accept
simplified `后` in the browser app, but dataset keys should be treated as
canonical.

## Dataset Shape

`/data/manifest.json`:

- `version`: dataset version label.
- `generatedAt`: ISO timestamp for the generated JSON files.
- `books[]`: ordered Bible book metadata.
- `books[].id`: short Chinese book id, such as `创`.
- `books[].name`: Chinese book name.
- `books[].englishName`: English book name.
- `books[].file`: URL path relative to `/data/`.
- `books[].chapters[]`: chapter numbers and verse counts.

Book JSON files:

- `id`: short Chinese book id.
- `name`: Chinese book name.
- `englishName`: English book name.
- `chapters`: object keyed by chapter number as a string.
- `chapters[chapter][]`: ordered verse objects.
- `verse`: verse number.
- `text`: exact CKJV verse text.

## Attribution And License

Bible text: 《中文英王欽定本》 by ckjv.asia.

License: Creative Commons Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0).

When quoting or reusing CKJV text, attribute the source and preserve the license
requirements.

Suggested attribution:

> Scripture quotations are from 《中文英王欽定本》 by ckjv.asia, licensed under
> CC BY-SA 3.0.

## Agent Guidance

- Prefer the JSON data files over scraping rendered page text.
- Quote verse text exactly.
- Preserve Chinese punctuation and spacing.
- Do not infer missing verses; if a reference is not present, report that it was
  not found.
- Do not treat the browser hash URL as the only source of truth. Use
  `/data/manifest.json` and the book JSON files for retrieval.