NAME
CIPP - CgI Perl Preprocessor
SYNOPSIS
This module is a preprocessor for the CIPP language. To use
it you need either CGI::CIPP, Apache::CIPP or new.spirit.
Please download the packages from CPAN (new.spirit is
available at http://spirit.dimedis.de/ ) and refer to their
documentation for details.
So this SYNOPSIS is empty... ;)
DESCRIPTION
CIPP is a Perl module for translating CIPP sources to pure
Perl programs. CIPP defines a HTML embedding language also
called CIPP which has powerful features for CGI and database
developers.
Many standard CGI and database operations (and much more)
are covered by CIPP, so the developer does not need to code
them again and again.
Development started spring 1997 at dimedis GmbH, Germany.
It improved over the time while used in several projects.
Since early 1999 this module is Open Source software and
published on CPAN.
SIMPLE EXAMPLE
Here is a (really) simple example of using CIPP in a HTML
source to retrieve some information from a database. Think
this as a HTML page which is "executed" on the fly by
Apache::CIPP or CGI::CIPP. If you use new.spirit the source
will be translated to a standalone CGI program.
Note: there is no code to connect to the database. This is
done implicitely. The configuration is taken from Apache
or from a global configuration file.
# print table of users who match the given parameter
<?INTERFACE INPUT="$search_name">
<HTML>
<HEAD><TITLE>tiny litte CIPP example</TITLE></HEAD>
<BODY>
<H1>Users matching '$search_name'</H1>
<P>
<TABLE BORDER=1>
<TR><TD>Name</TD><TD>Adress</TD><TD>Phone</TD></TR>
<?SQL SQL="select name, adress, phone
from people
where name like '%' || ? || '%'"
PARAMS="$search_name"
MY VAR="$n, $a, $p">
<TR><TD>$n</TD><TD>$a</TD><TD>$p</TD></TR>
<?/SQL>
</TABLE>
</BODY>
</HTML>
PREREQUISITES
CIPP itself needs perl 5.004_04 or better. To use its database
interface you need the DBI module (somewhat better than version
0.97) and a DBD-module for your database system.
CIPP is a pure Perl module, so you need no C compiler.
WHICH PLATFORMS ARE SUPPORTED
CIPP runs on any Unix system with a perl interpreter.
Also you can use it under Win32, it is widely tested with
the ActiveState Perl distribution and also in production
usage on this platform.
There is special Apache webserver support through the module
Apache::CIPP. You can use CIPP on any CGI capable webserver
using either CGI::CIPP or new.spirit.
DOWNLOAD CIPP
CIPP and friends can be downloaded from CPAN
$CPAN/modules/by-authors/id/J/JR/JRED/
INSTALLING CIPP
perl Makefile.PL
make
make test
make install
DOCUMENTATION
There is some technical information about the interface
of CIPP embedded as POD in CIPP.pm. This section is in
german language only. But usually you need not to care about
the internal mechanisms of CIPP.
The CIPP language reference manual can be downloaded from CPAN
as a extra package. This is usefull, because the format of the
documentation is PDF and the uncompressed file has more than
500kb. Also not every modification of CIPP leads to modification
of the documentation.
The CIPP::Manual module is part of this distribution. It is
a excerpt of the english PDF documention containing only the
command reference chapter. You can read this manual using perldoc:
perldoc CIPP::Manual
SUPPORTED LANGUAGES
When CIPP development started early 1997 it was intended to be
a tool for internal usage only. So the whole documentation was
written in german.
Since September 1999 CIPP has multilanguage support for its
error messages. Also the documentation has been translated
to english. The german documentation is not longer maintained.
BUG REPORTING
Please send any bug reports or comments to
cipp@dimedis.de
AUTHOR
Joern Reder <joern@dimedis.de>
COPYRIGHT
Copyright (C) 1999 by Joern Reder and
dimedis GmbH, 50170 Koeln, Germany
All Rights Reserved.
This library is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.