view release on metacpan or  search on metacpan

README  view on Meta::CPAN

Apache::PageKit
===============

Status
------
	Version: 1.17

Description
-----------
	PageKit is a web applications framework that is based on mod_perl.
	This framework is distinguished from others such as Embperl and Mason
	by providing a clear separation of programming, content and
	presentation.

	It does this by implementing a Model/View/Content/Controller (MVCC)
	design paradigm:
		- Model is user supplied Perl Classes
		- View is set of PageKit Templates and/or XSLT files
		- Content is set of XML Files
		- Controller is PageKit

	This allows your programmers, designers and content editors to work
	independently with clean well-defined interfaces.

	PageKit provides the following features:
		- Component-based architecture
		- Language Localization and charset translation
		- Session Management
		- Input Validation
		- Sticky HTML Forms
		- Authentication
		- Co-branding and XML,WML, and PDF output
		- Automatic Dispatching of URIs
		- Easy Error Handling
		- Online Editing Tools
		- Page based sessions
		- Localized error/messages


Requirements
------------
	- perl 5.005 or greater
	- mod_perl 1.24_01 (lastest version requir'd for make test only)
	- Apache 1.3.x (at best compiled _without_ expat (1.3.21 or higher recommended))
	- Apache::libapreq

	- Apache::SessionX
	- Compress::Zlib
	- Data::FormValidator
	- Digest::MD5
	- HTML::FillInForm 0.12
	- HTML::Template 2.2
	- HTML::Template::XPath
	- HTML::Clean
	- Text::Iconv
        - libxml2 library - download from http://www.xmlsoft.org
	- XML::LibXML 1.31

Required for example web site located in eg/ directory
----------------------
	- DBD::SQLite
	- HTTP::Headers
	- Apache::Reload

Recommended
-----------
	- Mail::Mailer (needed if you use Apache::ErrorReport)
	- Apache::DBI (*strongly* recommended if you use DBI)
	- MIME::Types (needed if you want to serve static files from
		View/Default directory)
	- XML::LibXSLT 1.31 (needed if you want to use XSLT tranformations)
	- Apache XML FOP - need for generating PDF
        - Locale::gettext 1.01 (needed if you want to localize pkit messages)

Installation
------------
PageKit >= 1.08
	You must have a mod_perl enabled apache server. That's all.

        PageKit avoids the expat conflict by not using XML::Parser anymore.
        If your application relies on XML::Parser, follow the instructions
        for installation PageKit <= 1.07.

PageKit <= 1.07
        First you must have a mod_perl enabled apache server _without_
	expat compiled in.  Apache 1.3.21 and above do not include
	expat if you already have expat installed.

	However, if you are using a version below 1.3.21, then
	you should supply the option
	--disable-rule=EXPAT to ./configure when you build Apache.  Alternatively
	if you build Apache with mod_perl, it will supply this option
	automatically for you.  For more information on the expat conflict,
	read http://www.axkit.org/faq.xml under "I install AxKit and Apache
	segfaults when it starts".  For an excellent reference on installing
	a mod_perl server from source, see http://perl.apache.org/guide/

	It is recommended that you compile mod_perl with the EVERYTHING switch.
	In any case, you should make sure that you allow the httpd.conf <Perl>
	directive.

	By the way, you may download the expat library from sourceforge
		http://sourceforge.net/projects/expat/
	(Required for XML::Parser)