Skip to content

Latest commit

 

History

History
75 lines (52 loc) · 2.86 KB

installation.md

File metadata and controls

75 lines (52 loc) · 2.86 KB
Raw

Installation

Installing PhiloLogic consists of two steps:

  1. Install the C and Python libraries system-wide
  2. Set up a directory in your web server to serve databases from

You can find more detailed installation instructions for specific OSes here:

Downloading

IMPORTANT: Do not install from the master branch on github: this is a the development branch and in no way garanteed to be stable

You can find a copy of the latest version of PhiloLogic4 here.

For the rest of this document, we will assume the PhiloLogic source code is installed in your home directory at ~/PhiloLogic4/

Prerequisites

Installing the C library

Installing PhiloLogic's libraries requires administrator privileges. This C library depends on gdbm_, which must be installed first, to compile correctly. Installation is standard for a Makefile-style distribution.

cd ~/PhiloLogic4/libphilo
make
sudo make install

In addition to the library, the Makefile also generates two binary executables, corpus_search and pack4, which are then copied into the binary execution directory, usually /bin.

Installing the Python philologic module system-wide

Once libphilo is installed, we need to install its Python bindings and library: philologic. Once again, this step requires administrator privileges. You probably want to install its prerequiste, lxml , first.

You can install the libraries either with Python's distutils:

cd ~/PhiloLogic4/python
sudo python setup.py install

or via the pip command::

cd ~/PhiloLogic4/python
sudo pip install .

Setting up PhiloLogic Web Application

Each new PhiloLogic database you load, containing one or more TEI-XML files, will be served by a its own dedicated copy of PhiloLogic web application. By convention, this database and web app reside together in a directory accessible via an HTTP server configured to run Python CGI scripts.

In Mac OS X systems, you will probably want to create a directory at /Library/WebServer/Documents/philologic to serve up PhiloLogic databases with the URL prefix: http://<your_server's_name>/philologic/; for Linux systems, the proper directory may vary, but /var/www/philologic/ or /var/www/html/philologic/

Configuring your web server is outside of the scope of this document; but the web install does come with a preconfigured .htaccess file that allows you to run the Web App. Therefore, you need to make sure your server is configured to allow htaccess files. if in doubt, ask a friendly sysadmin..