Ayuda del formato de archivos bíblicos

1. Importar un archivo

Para archivos nuevos usa .json con UTF-8. Sustituye el texto del ejemplo por el tuyo. Elige Archivo en la gestión de traducciones y revisa el nombre y el idioma antes de instalar. Esta guía Markdown no es un archivo bíblico.

2. JSON mínimo

Bible es obligatorio y distingue mayúsculas. Cada fila es [ID del libro, capítulo, versículo, texto]. Capítulo y versículo son enteros positivos; el texto es una cadena entre comillas. También se admite un nombre inglés como Genesis en lugar del ID. Se permiten libros o capítulos parciales.

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

3. Metadatos opcionales

meta es opcional; metadata es un alias. El formatVersion actual es 1. id es persistente: una traducción instalada con el mismo ID se reemplaza. name es el nombre visible, lang el código de idioma y direction es ltr o rtl. Revisa estos datos antes de instalar. Usa description para el título, intro para la introducción, author y year para autor y año, y source y copyright para atribución. nameScheme admite protestant, catholic o kjv; declara canon y numeración por separado en canon. También existen version, markupPolicy para símbolos y bookNames para nombres de libros.

{
  "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

Guarda el texto una vez en el primer versículo. Pon sourceVerseGroups al mismo nivel que Bible. No añadas otra fila de texto para el versículo 14 del ejemplo. Los grupos deben ser consecutivos dentro de un capítulo y no solaparse.

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

5. ID de libros

Son ID fijos del archivo. No renumeres los libros según el orden católico de pantalla. Los añadidos de Ester y Daniel pertenecen a 17 y 27; los libros adicionales usan 67–73. Los nombres y el canon se configuran por separado.

6. SDB y errores frecuentes

Un .sdb es SQLite con una tabla Bible y columnas enteras book, chapter, verse, y la columna de texto btext. Un SQLite arbitrario, PDF o Word no tiene este formato. No incluyas comentarios ni comas finales en JSON. La falta de Bible, una lista que no sea un array, números como cadenas, meta inválido o grupos solapados causan errores. Guarda el ejemplo como .json, no .md.