聖書ファイル形式のヘルプ

1. ファイルの読み込み

新しいファイルにはUTF-8の.jsonを推奨します。例の本文を自分の文章に置き換え、翻訳管理のファイルから選び、インストール前に名前と言語を確認します。このMarkdown説明自体は聖書データではありません。

2. 最小JSON

Bibleは大文字で記述する必須キーです。各行は[書の番号, 章, 節, 本文]です。章と節は正の整数、本文は引用符で囲む文字列です。書の番号の代わりにGenesisなどの英語名も使えます。一部の書や章だけでも読み込めます。

{
  "Bible": [
    [
      1,
      1,
      1,
      "Verse text 1"
    ],
    [
      1,
      1,
      2,
      "Verse text 2"
    ]
  ]
}

3. 任意のメタデータ

metaは任意で、metadataも同じ意味です。現在のformatVersionは1です。idは固定識別子で、同じIDのインストール済み翻訳は置き換えられます。nameは表示名、langは言語コード、directionはltrまたはrtlです。インストール前に編集できます。descriptionはタイトル、introは詳しい紹介、authorとyearは著者と年、sourceとcopyrightは出典と権利です。nameSchemeにはprotestant、catholic、kjvを使い、正典と節番号体系は別のcanonに宣言します。version、本文記号用のmarkupPolicy、書名用のbookNamesも指定できます。

{
  "meta": {
    "formatVersion": 1,
    "id": "MY-BIBLE",
    "name": "My Bible",
    "lang": "en",
    "direction": "ltr",
    "nameScheme": "protestant",
    "canon": {
      "canon": "protestant66",
      "versification": "kjv"
    }
  },
  "Bible": [
    [
      1,
      1,
      1,
      "Verse text 1"
    ]
  ]
}

4. 複数の節が一つの本文の場合

本文は最初の節に一度だけ入れ、sourceVerseGroupsをBibleと同じルートに置きます。この例では14節の本文を別に追加しません。同じ章の連続した節のみ指定でき、範囲は重複できません。

{
  "Bible": [
    [
      2,
      25,
      13,
      "Combined text of verses 13 and 14"
    ]
  ],
  "sourceVerseGroups": {
    "2:25:13": [
      13,
      14
    ]
  }
}

5. 書の番号

ファイル内の固定IDです。カトリックの表示順に合わせて既存の番号を付け直さないでください。エステル記とダニエル書の追加部分は17と27、追加の書は67–73を使います。書名体系と正典は別の設定です。

6. SDBとよくある間違い

.sdbはSQLiteファイルで、Bibleテーブルに整数のbook、chapter、verseと文字列のbtext列が必要です。任意のSQLite、PDF、Wordファイルとは異なります。JSONにコメントや末尾のカンマを入れないでください。Bibleの欠落、配列でない節一覧、文字列の章・節番号、不正なmeta、重複範囲は読み込みエラーの原因です。例は.mdではなく.jsonで保存してください。