Aide sur le format des fichiers bibliques

1. Importer un fichier

Pour un nouveau fichier, utilisez .json encodé en UTF-8. Remplacez le texte de l’exemple par le vôtre. Choisissez Fichier dans la gestion des traductions et vérifiez le nom et la langue avant l’installation. Cette notice Markdown n’est pas un fichier biblique.

2. JSON minimal

Bible est obligatoire et sensible à la casse. Chaque ligne est [ID du livre, chapitre, verset, texte]. Chapitre et verset sont des entiers positifs ; le texte est entre guillemets. Un nom anglais comme Genesis peut remplacer l’ID. Les livres ou chapitres partiels sont acceptés.

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

3. Métadonnées facultatives

meta est facultatif ; metadata est un alias. Le formatVersion actuel est 1. id est permanent : une traduction installée avec le même ID sera remplacée. name est le nom affiché, lang le code de langue et direction vaut ltr ou rtl. Vérifiez-les avant l’installation. Utilisez description pour le titre, intro pour la présentation, author et year pour auteur et année, source et copyright pour l’origine et les droits. nameScheme accepte protestant, catholic ou kjv ; le canon et la numérotation sont déclarés séparément dans canon. Autres champs : version, markupPolicy pour les symboles et bookNames pour les noms de livres.

{
  "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. Versets regroupés

Enregistrez le texte une seule fois au premier verset. Placez sourceVerseGroups au même niveau que Bible. N’ajoutez pas une autre ligne pour le verset 14 de l’exemple. Les groupes doivent être consécutifs dans un même chapitre et ne pas se chevaucher.

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

5. ID des livres

Ces ID sont fixes. Ne renumérotez pas les livres pour suivre l’ordre catholique d’affichage. Les ajouts à Esther et Daniel appartiennent à 17 et 27 ; les livres supplémentaires utilisent 67–73. Les noms et le canon sont des paramètres distincts.

6. SDB et erreurs courantes

Un .sdb est un fichier SQLite avec une table Bible, les colonnes entières book, chapter, verse et la colonne texte btext. Un SQLite quelconque, un PDF ou un Word n’a pas ce format. Évitez commentaires et virgules finales en JSON. Une clé Bible absente, une liste non-tableau, des numéros en chaînes, un meta invalide ou des groupes qui se chevauchent provoquent des erreurs. Importez l’exemple en .json, pas en .md.