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 steps.
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 on the screen. 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.
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 popt
sudo port install libxml2
sudo port install git-core sudo port install nspr sudo port install firefox-x11
If any problems arise in this section, help can be found at www.macports.org.
A file needs to be fixed for proper operation.
cd /opt/local/lib/pkgconfig
sudo nano firefox-xpcom.pc
There is a line that says "Requires: nspr >= ...". Change the "nspr" in that line to "firefox-nspr", and write the file by pressing Ctrl-O, then quite by presssing Ctrl-X. If the change has been done already, then that's fine.
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
To configure bibledit for firefox, type
./use-firefox
To patch some files on the Macintosh, type
sudo scripts/patch-macintosh
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.