rapple installation guide

before you begin

before installing rapple you need to ensure that the following libraries are already installed (if you use Debian binary installation these dependencies will be automatically resolved so you can ignore this section):

• expat a library for parsing XML documents.
• tidylib a library version of Dave Raggett's popular HTML Tidy.
• pcre a library for regular expression pattern matching (using the same syntax and semantics as Perl 5).

along with one of the following XSLT processors:

• sablotron an XML toolkit that includes the Sablot XSLT processor.
• libxslt an XSLT processor originally developed for the GNOME project (you may also need to install libxml2).

if you wish to include MySQL support for rapple then you will need to ensure that you have the MySQL client libraries installed on your system. please see MySQL documentation for further information.

to check if a required library is installed, you can use the pkg_info command on BSD-based systems, or look in usr/lib or usr/local/lib on Linux.

please refer to the appropriate projects in the event of installation issues.

binary installation

install Debian package

Debian now includes a binary package of rapple, so you can install rapple in your Debian system by just typing

aptitude install rapple

as root (or, of course, you may use your favorite package management tool. Please note that this Debian package was only recently created, so it is only contained in the Debian unstable distribution (sid); if you want to install rapple on a Debian 3.1 (sarge) or older system, please follow the 'installation from source' instructions below.

downloading other packages

binary distributions are available from the download section on rapple.sourceforge.net.

installing from source

building rapple

to build rapple you will be to configure the build for your needs. the configure script takes a number of options governing install location, choice of XSLT processor and availability of MySQL support. the basic form of configure (standard location, choice of Sablot XSLT processor and no MySQL support) is:

%./configure

you must ensure that any additional variables (e.g., CFLAGS, LDFLAGS) are set after this command if you have dependent libraries that are installed in non-standard locations (see README file for an example)

if you wish to install rapple in a non-standard location (e.g., your home directory or if you do not have admin rights on your machine) then you will need to use the --prefix option:

%./configure --prefix=/path/to/install/rapple

by default rapple works with the Sablotron XSLT (this choice is rather arbitrary) but if you prefer to use libxml/libxslt then you should add the --with-xslt-proc option to configure, e.g., to use libxml/libxslt try:

%./configure --with-xslt-proc=libxslt

if you require MySQL support then you will need to add the following option

%./configure --enable-mysql

if you plan to use MySQL support then you will also need to ensure that the appropriate tables have been created in your database (see the MySQL section of configure.)

once configured you can make and install rapple using the following commands:

%make
%make install

once installed you will need to configure rapple.