Generic Linux Installation

While pBiblx2 has been designed with the evangelical concept of ShepherdPup Linux (using Hiawatha) in mind, being just a PERL CGI, it will conceivably adapt to any Web Server system with minor modifications. It might be possible even to run it on a non-unix system as well (See Footnotes below).

First, you'll need to now where your Web Server expects CGI scripts to be run from. My Linux account from Godaddy.com did not care where CGI was run from so I placed pBiblx2 in it's own folder at the root directory. Other servers might expect it in the ./CGI or ./cgi-bin folder.

Once the pBiblx2 CGI is located, you'll need to make a security decision about where to place the world writable PCARR Wiki directories. Most admins would prefer /var/www to cage users in. ShepherdPup being a Puppy Linux derivative places it in /root (perhaps not critical on smaller personal setup...but).

Once these two locations have been decided, one simply only has to change settings in the pbiblx.conf.pl file where all the locations are identified. Change the $my_HOST variable to your domain name while your at it. You should be able to fire pBiblx2 up at this point.

Footnotes:

The current pBiblx2 scripts utilize zcat + date as unix system calls. This could perhaps be remedied with the additional PERL zlib.pm or the resources could be uncompressed and read from a straight open() call. I toyed with this for a while before committing my effort to a minimal size Puppy Linux viewpoint. Either option would require some script tinkering.

New bible translations can be added either by hand or by the handy gtkdialog ./pbiblx2-admin-dialog script included (may need some modification). If by hand, you'll have to add newlines to the .list files in./pbiblx-forms. Use the existing lines as your syntax guide. There is also a ./update_resource.sh script to help you.