Ajuda do formato de arquivos bíblicos

1. Importar um arquivo

Para novos arquivos use .json em UTF-8. Substitua o texto do exemplo pelo seu. Escolha Arquivo na gestão de traduções e confira nome e idioma antes de instalar. Esta ajuda Markdown não é um arquivo bíblico.

2. JSON mínimo

Bible é obrigatório e diferencia maiúsculas. Cada linha é [ID do livro, capítulo, versículo, texto]. Capítulo e versículo são inteiros positivos; texto é uma string entre aspas. Um nome inglês como Genesis pode substituir o ID. Livros ou capítulos parciais são aceitos.

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

3. Metadados opcionais

meta é opcional; metadata é um alias. O formatVersion atual é 1. id é permanente: uma tradução instalada com o mesmo ID é substituída. name é o nome exibido, lang o código do idioma e direction é ltr ou rtl. Confira antes de instalar. description é o título, intro a apresentação, author e year autor e ano, source e copyright origem e direitos. nameScheme aceita protestant, catholic ou kjv; declare cânone e numeração separadamente em canon. Outros campos incluem version, markupPolicy para símbolos e bookNames para nomes dos livros.

{
  "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. Versículos agrupados

Guarde o texto uma vez no primeiro versículo. Coloque sourceVerseGroups no mesmo nível de Bible. Não acrescente outra linha para o versículo 14 do exemplo. Os grupos devem ser consecutivos no mesmo capítulo e não se sobrepor.

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

5. IDs dos livros

São IDs fixos do arquivo. Não renumere os livros conforme a ordem católica de exibição. Adições a Ester e Daniel pertencem a 17 e 27; livros adicionais usam 67–73. Nomes e cânone são configurações separadas.

6. SDB e erros comuns

Um .sdb é SQLite com tabela Bible, colunas inteiras book, chapter, verse e coluna de texto btext. Um SQLite qualquer, PDF ou Word não segue este formato. JSON não aceita comentários ou vírgulas finais. Falta de Bible, lista que não seja array, números como strings, meta inválido ou grupos sobrepostos causam erro. Salve o exemplo como .json, não .md.