Version 4.1 on Mac OS X 10.6 Snow Leopard

These instructions install Bibledit on OS X.

Install Xcode

Xcode is on the installation DVD that came with your OS X software. This DVD is marked "Mac OS X Snow Leopard Install DVD". Insert this DVD into the drive. A window will open. In this window, double-click "Optional Installs". A new window opens, and here double-click "Xcode.mpkg". The installer will open, and follow the instructions on the screen to install it.

Install Web server and database

(Installing a web server and database is no longer necessary for Bibledit-Gtk)

To start the Apache Web Server, you must go into the “System Preferences" located on the “Apple Menu”. Click on the Icon labeled "Sharing". Then tick the service labeled  "Web Sharing". This starts up Web sharing which starts the Apache Web Server.

Install MySQL through following the steps at http://dev.mysql.com/doc/refman/5.0/en/mac-os-x-installation.html.

(To do the above in a single step, install the MAMP server from http://www.mamp.info).

X11 terminal

Click the "Applications" icon at the bottom. Scroll down a bit and click "Utilities". Scroll down to the bottom, and click X11. A 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

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 was 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.

Dependencies

To install gtk2, in the terminal type

sudo port install gtk2

and provide the password when asked.

Do the same for other software:

sudo port install git-core
sudo port install libgtkhtml3
sudo port install gtksourceview2
sudo port install webkit-gtk

If anything fails to compile, try again, it probably will succeed then. If a problem persists, help is at www.macports.org.

Then enable dbus to launch at startup:

sudo launchctl load -w /Library/LaunchDaemons/org.freedesktop.dbus-system.plist
sudo launchctl load -w /Library/LaunchAgents/org.freedesktop.dbus-session.plist

After these commands have been given it is necessary to reboot the computer.

Bibledit

Install Bibledit.

Run

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-gtk

If you do not start Bibledit this way, it will run with errors, and it will not be fully functional.

Notes

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.