Developers

Code Repository

If you are here, then you know that the code is stored on github. Bug and requests should be reported in the "Issues" section.

Bug Reports

Please include as much information as possible. Include the /tmp/bibledit/bibledit.log file, or a copy-and-paste of the Help | System log window. If you know how to run gdb, do that, and copy and paste a backtrace from it. If you can include the contents of your ~/.bibledit folder (tar -czf bibledit.tar.gz .bibledit) that would be helpful.

Building in Linux

Here's how to set up your build environment in Ubuntu 16.04 LTS or ArchLinux. I will assume you can adapt these instructions for your flavor of Linux if it is not one of those.

1. Make sure you have git (on Ubuntu: sudo apt-get install git)
2. cd ~
3. git clone https://github.com/postiffm/bibledit-desktop.git
4. bibledit-desktop/linux/buildenvLinux.sh

Doing the Build

1. cd bibledit-desktop
2. ./autogen.sh
3. ./configure
4. make
5. sudo make install
6. Run the program from /usr/bin/bibledit-desktop (was bibledit-gtk)
7. I recommend you lock the icon in Ubuntu launcher.

Building in Windows

See https://www.fbcaa.org/bible-resources/bibledit/developers/create-build-windows.

Debugging

See linux/DEBUGGING.txt and linux/PROFILING.txt for some tips on debugging in Linux.

See windows/DEBUGGING.txt and other files in that directory for tips on development in Windows.

Configure source

Introduction

When installing Bibledit from source, at one stage you run:./configure

If your system has been prepared for bibledit installation, then all should go well. There should be no error messages.

MySQL database

If there is an error regarding the MySQL database, check whether this database has been installed and is running.

If the above is the case, and there is still an error, then it could be related to the password to access the database.When Bibledit gets configured, it has a default password of "root" for the database root user. On your system the value is probably different.

You can pass the root password of the database to the configure script:./configure --with-mysql-root-password=mysecret

The above uses password "mysecret".

Web server

Bibledit has been tested with the Apache web server. The ./configure script is capable of finding the web server document root on several distributions. If you like to use a special location for the document root, you can pass that to the ./configure script:./configure --with-web-document-root=/home/joe/publicThe above changes the web server document root for Bibledit to /home/joe/public.