Installation
Installing PhiloLogic consists of two steps:
You can find more detailed installation instructions for specific OSes here:
IMPORTANT: Do not install from the master branch on github: this is the development branch and is in no way garanteed to be stable
You can find a copy of the latest version of PhiloLogic4 here.
Installing PhiloLogic’s libraries requires administrator privileges.
The C library depends on gdbm
, which must be installed first, to compile correctly.
Just run the install.sh in the top level directory of the PhiloLogic4 you downloaded to install PhiloLogic and its dependencies:
./install.sh
The installer creates a file in /etc/philologic/philologic4.cfg
which contains several important global variables:
database_root
defines the filesytem path to the root web directory for your PhiloLogic install such as /var/www/html/philologic
. Make sure your user or group has full write permissions to that directory.url_root
defines the URL path to the same root directory for your philologic install, such as http://localhost/philologic/web_app_dir
defines the location of the PhiloLogic4 www directory. By default, the installer will copy the contents of the PhiloLogic www directory (which contains the web app) to /etc/philologic/web_app/.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.
Make sure you configure the /etc/philologic/philologic4.cfg
appropriately.
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.