圣经文件格式帮助

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或重叠范围都会导致导入错误。导入示例须存为.json，而非.md。