These instructions assume Bibledit is being installed on a standard installation of OSX. Because Bibledit needs more than that, these instructions also explain how to install the additional libraries and tools that Bibledit depends on.
If you know that your system already has some of these components installed, you may skip those parts.
X11 is on the installation DVD that came with your OSX software. This DVD is marked "Mac OS X Install Disc 1". Insert this DVD into the drive. A window will open. In this window, double-click "Xcode Tools". A new window opens, and here double-click "Packages". Another window opens again, and here double-click "X11SDK.pkg". The installer will open, and follow the instructions on the screen to install it. In the same way, install Mac OS X Install Disc 1 / System / Installation / Packages / X11User.pkg.
Using the same DVD that was inserted above, double-click "Xcode Tools". A new window opens. Here double-click "XcodeTools.mpkg". Go through the whole installation procedure and let it finish. Xcode Tools needs to be upgraded to a newer version. The upgrade is available from http://connect.apple.com, file xcode25_8m2558_developerdvd.dmg available from the Downloads / Developer Tools section after free registration. It is called Xcode 2.5 Developer Tools (Disk Image). Download and install it.
Click the left icon at the bottom, called Finder. Click Applications. At the right side, scroll down and double-click Utilities. Scroll down again, and double-click X11. The terminal, called xterm, will open.
Update the search path, so that programs, still to be installed, can be found. In the terminal, type
cd
and then type
echo export PATH=$PATH:/opt/local/bin >> .bashrc
Now close the X11 terminal through menu X11 - Quit X11.
Then start a new X11 terminal.
MacPorts is available from http://www.macports.org. Follow the instructions on the site to install MacPorts. If through, continue with the next steps.
If the port has been installed a while ago, and you wish to update it, in xterm, type
sudo port -v selfupdate
and provide the password when asked. Let the update finish. It takes a while.
To install gtk2, in the terminal type
sudo port install gtk2
and provide the password when asked.
Do the same for other libraries and software that is needed:
sudo port install sqlite3 sudo port install libxml2
sudo port install git-core sudo port install enchant sudo port install libgtkhtml3 sudo port install curl
If any problems arise in this section, help can be found at www.macports.org. While installing enchant it was noticed that it failed with an error. However, when running "sudo port install enchant" again, it succeeded.
Download package bibledit-x.x.tar.gz (x.x is to be replaced with a version number).
Move it to the home directory.
In the terminal, to verify the package is there, type
ls
To unpack bibledit type
tar zxf bibledit-x.x.tar.gz
To enter the newly created directory, type
cd bibledit-x.x
Provide the password if asked for.
To configure bibledit, type
./configure
Watch many messages, but no errors.
To compile bibledit, type
make
Watch many messages, but no errors.
To install it, type
sudo make install
Watch many messages, but no errors.
To go back to the home directory, type
cd
To run Bibledit, do the following every time you use it:
Open an X11 terminal. Be sure this is not a normal Terminal, but the X11 terminal.
Start bibledit: Type
bibledit
If you do not start Bibledit this way, it will run with errors, and it will not be fully functional.
You can create an Applescript that will open X11 and BIbledit in one operation from within Finder. This will give you an easy way to start Bibledit in one click. In Finder, click Applications, then double-click AppleScript and then double-click Script Editor. In Script Editor type:
do shell script "/usr/bin/open-x11 /opt/local/bin/bibledit"
Then click the Compile button, and in the menu click File, then Save. Call it Bibledit, and save it in Applications, and set the file format to "Application". Then save it.