Bibledit runs on Fedora OLPC, hereafter called F-OLPC.
As the OLPC (One Laptop Per Child) is not yet available, a simulator is used instead.
In these instructions you'll learn how to set up this simulator, then you will install Bibledit together with all the libraries and programs it depends on.
Instructions on how to set up the simulator are at http://people.redhat.com/berrange/olpc/sdk or the newest link http://fedoraproject.org/wiki/OLPC/Projects. If followed exactly, and everything works out well, you will have F-OLPC running on your PC, and you'll be in Gnome. If things do not work out, there is the #olpc IRC channel where people might be kind enough to help out.
We will be needing a terminal to work in the simulator. To do that, in Gnome right-click on the top panel, and choose Add to panel..., then choose Custom Application Launcher. Put "xterm" for the command. Press Ok to close all windows, and the launcher will be on the panel. Click the launcher to start a terminal.
Normally you would install Bibledit by compiling it on the laptop. But F-OLPC is not set up for compiling programs. Installing software goes through copying a self-contained image to it. This image contains the program and all its dependencies.
At present the F-OLPC firmware image is binary compatible with Fedora Core 5 test 2, hereafter called FC5t2. Therefore all software that works on FC5t2 will also work on F-OLPC.
What will we do therefore to install Bibledit on F-OLPC? We will install FC5t2 on a normal computer, and install Bibledit on it. Then we will look for all programs and libraries Bibledit depends on, find out which ones are already on F-OLPC, and gather the ones that are missing. Then we will copy them into a tarball, move the tarball to F-OLPC, and unpack it there. And that finishes the Bibledit installation.
We need to get a list of libraries and programs and other files that are already intalled on F-OLPC. Do it this way:
Go to the computer where F-OLPC is installed.
Open a terminal.
Ensure F-OLPC is shut down. If needed type
olpc-simulator stop demo
Create the directory where the image of F-OLPC will be mounted. Type
cd
mkdir olpc-image
Mount the image. If we assume that the image is ~/olpc-2006_02_06_16_08.ext3, then type
sudo mount -o loop,offset=32256 -t ext3 ~/olpc-2006_02_06_16_08.ext3 ~/olpc-image
No errors should occur.
To get a list of files on the image, type
ls -R ~/olpc-image > ~/olpc-files
It will say "Permission denied" several times, but this is normal. When ready, file ~/olpc-files contains a list of all files on F-OLPC. The size of the file will be a bit more than 500 kbytes.
Download FC5t2 and install it on a computer.
Download the iso images from the internet. Search for either FC5-test2-i386-DVD.iso or FC5-test2-i386-disc1.iso up to disc5. Burn these images to DVD or CD. Install FC5t2. Then install Bibledit as you would install it on Fedora Core 5.
Ensure that Bibledit runs properly.
Then collect all files and dependencies Bibledit needs. To do this, type
./bibledit-olpc-librarian ~/olpc-files ~/bibledit-olpc
This will create a file called bibledit-olpc.tar.gz in your home directory. This file contains all files and dependencies you need to get Bibledit on F-OLPC. The size of it will be less than 2 Mbyte. If it is more than that, it probably means you have data in /usr/var/bibledit. Empty that directory completely and do it again.
The next step is to copy this the bibledit-olpc.tar.gz tarball to the F-OLPC image, and unpack it there. We assume that the image is still mounted, see above.
To unpack the tarball in the image, type
cd
cd olpc-image
sudo tar zxf ~/bibledit-olpc.tar.gz
Next unmount the image, so type
sudo umount ~/olpc-image
Everything should be ready now for running Bibledit.
To start the simulator, type
olpc-simulator start demo
Then inside the simulator, you can open a terminal, and then type
bibledit
There you are, Bibledit on OLPC.
Note that at present the dialog boxes are too large to fit on the screen. This means that some buttons and entries are not accessible. To move a dialog box around the screen, press the Alt key down, and drag the dialogbox around till the desired button becomes visible.