Skip to content

rBiblia/bib2xml

Repository files navigation

rBiblia bib2xml converter

This conversion tool enables you to convert a Bible translation (in one of the supported formats) to the XML format used by rBiblia. The subsequent conversion from *.xml to a *.bibx file can be accomplished using the free xml2bibx translations converter.

Supported input formats are:

Name Id File extension
eSword sword *.bblx, *.mybible
Zefania zefania *.xml
theWord word *.ot, *.nt, *.ont
tab as a separator tsv *.tsv
comma as a separator csv *.csv
MyBible (Android) mybible *.SQLite3

Compilation steps:

Note

Compiled bib2xml.phar file can be downloaded directly from the GitHub Releases page. To use the converter, PHP v8.2 must be installed on your operating system.

You need to have PHP v8.2 or newer installed onto your system.

  • clone this repo
  • go to the ./project folder
  • run composer install -o --no-dev
  • go back to the main folder
  • run create-phar.bat file

bib2xml.phar file will be created in ./bin folder.

Conversion steps:

Converter requires PHP v8.2 installed onto your system to work.

Example of use (from the ./bin folder):

php bib2xml.phar convert input_translation.bblx output_translation.xml sword

or just

php bib2xml.phar convert input_translation.bblx

Changelog:

  • v0.6.1.0 (2024-08-26):

    • upgraded PHP to v8.2
    • added GitHub Action for release automation
    • fix incorrect namespace in exception classes
  • v0.6.0.0 (2023-11-24):

    • added csv input format support
  • v0.5.0.0 (2022-03-17):

    • upgraded PHP to v8
    • added mybible input format support
    • added input file format auto-detection
    • minor fixes and improvements
    • added bib2xml.bat helper in bin folder
  • v0.4.0.0 (2021-05-04):

    • added tsv input format support
    • added support for 3es book
    • small internal fixes
  • v0.3.0.0 (2020-12-15):

    • added theWord input format support
    • added text sanitizer for global use when parsing translations
    • generate default output filename if no output given
    • many internal improvements and fixes
  • v0.2.0.0 (2020-12-06):

    • added Zefania XML input format support
    • added additional trim rules for eSword input format
    • directory structure fixes
  • v0.1.0.0 (2020-12-04):

    • initial release (eSword input format support only)

About

Author: Rafał Toborek

Feel free to contribute and support my work.

Download rBiblia for free here.