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:
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
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
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'
downloading other packages
binary distributions are available from the download section on
installing from source
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:
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
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:
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
if you require MySQL support then you will need to add the
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
once installed you will need to configure rapple.