Справка по формату файлов Библии

1. Импорт файла

Для новых файлов используйте UTF-8 и .json. Замените пример текста своим. Выберите «Файл» в управлении переводами и проверьте название и язык перед установкой. Сама справка Markdown не является файлом Библии.

2. Минимальный JSON

Bible — обязательный ключ с учетом регистра. Каждая строка: [ID книги, глава, стих, текст]. Глава и стих — положительные целые числа, текст — строка в кавычках. Вместо ID допускается английское название, например 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 книг

Это фиксированные ID файла. Не перенумеровывайте книги по католическому порядку отображения. Дополнения к Есфири и Даниилу относятся к 17 и 27; дополнительные книги используют 67–73. Названия книг и канон — разные настройки.

6. SDB и частые ошибки

.sdb — файл SQLite с таблицей Bible, целочисленными столбцами book, chapter, verse и текстовым btext. Произвольные SQLite, PDF или Word не подходят. JSON не допускает комментарии и завершающие запятые. Отсутствие Bible, список не-массив, номера строками, неверный meta или пересечение групп вызывают ошибки. Сохраните пример как .json, не .md.