view release on metacpan or  search on metacpan

lib/Apache/PageKit/FAQ.pod  view on Meta::CPAN

=head2 1.4 I<Apache::PageKit> uses I<XSLT>, what is it?

XSLT (eXtensible Stylesheet Language: Transformations)

  http://www.w3.org/TR/xslt
  http://www.w3.org/Style/XSL/
  http://www.xslinfo.com/
  http://www.oasis-open.org/cover/xsl.html
  http://www.xml.com/

XSLT is a language used to apply transformations to XML.  This powerful
tool helps seperate Content from the Presentation by changing the way
the XML is presented to the end user.  It can be used to reformat the
XML into HTML, WML, XML, PDF, POD or any other template you come up with.

=head2 1.5 Is there a webpage with more information about I<Apache::PageKit>?

Yes, http://www.pagekit.org and http://sourceforge.net/projects/pagekit/

=head2 1.6 Is there a mailing list?

Yes, one for users and one for developers.

To subscribe look here:

    http://lists.sourceforge.net/mailman/listinfo/pagekit-users
    http://lists.sourceforge.net/mailman/listinfo/pagekit-devel

=head2 1.7 Is there a mailling list archive?

Yes,

  http://www.geocrawler.com/redir-sf.php3?list=pagekit-users
  http://www.geocrawler.com/redir-sf.php3?list=pagekit-devel

=head1 Installation

=head2 2.1 Apache segfaults on start, but only with I<Apache::PageKit>. What is wrong?


Apache is often compiled with the expat-lite library which is
incompatible with the XML::Parser module.  PageKit prior to 1.08
requires XML::Parser.  You'll have to compile Apache with
--disable-rule=expat for these early versions of PageKit.

It is recommended that you upgrade to PageKit 1.08 or higher, which
doesn't require XML::Parser or expat.  However, if your code uses
XML::Parser Apache will still segfault.  In this case you must recompile
Apache with --disable-rule=expat or remove dependencies on XML::Parser
in your code.

The mod_perl guide has an excellect section on compiling mod_perl and
Apache from source. http://perl.apache.org/guide/

=head2 2.2 Do I really need to recompile Apache? It works without I<Apache::PageKit>.

No, if you use I<Apache::PageKit E<gt>= 1.08> and promise to never use C<XML::Parser>. Else yes, you must recompile Apache.

=head2 2.3 perl Makefile.PL result in Can't locate Apache/test.pm in @INC ...

You use I<mod_perl-1.28> or higher. I<Apache::test> is obsolete and renamed to
Apache::testold. The future is I<Apache::Test>. To get around the error type

  perl -i -pe 's/Apache::test\b/Apache::testold/g' Makefile.PL

Or even better upgrade I<Apache::Pagekit> to a version > 1.11. There we use
I<Apache::Test>.

=head2 2.4 I can not build libapreq or it stops working after a reboot.

You use perl >= 5.8.1 which includes a new version of ExtUtils::MakeMaker.
Read more here:
  http://marc.theaimsgroup.com/?l=perl5-porters&m=105981649201380&w=2
  http://marc.theaimsgroup.com/?l=apreq-dev&m=106146287323705&w=2

To fix the problem apply this patch from Steve Hay or use I<libapreq-1.3>


  --- c/Makefile.PL.orig    2001-04-03 20:24:12.000000000 +0100
  +++ c/Makefile.PL 2004-08-21 11:31:42.000000000 +0100
  @@ -34,7 +34,8 @@
   sub MY::dynamic {
       my $self = shift;
       my $string = $self->MM::dynamic;
  -    $string =~ s/(Makefile\s+).*/$1/g;
  +    $string =~ s{ \$\(INST_DYNAMIC\)}{}g;
  +    $string =~ s{ \$\(INST_BOOT\)}{}g;
       $string;
   }

=head1 Migrating to I<Apache::PageKit> from...

=head2 3.1 I already have a website and I want to extend it with Apache::PageKit. Where can I put my data?

You have several options, some follows.

=over 2

=item *

Copy your whole site into the directory View/Default/. Of the edited eg site of I<Apache::PageKit>.

=item *

Copy the eg site of I<Apache::PageKit> to a directory in the rootdir of your site ie:

  cp -R .../Apache-PageKit-x.yz/eg .../htdocs/.../pagekit

edit MyModel/Model.pm, MyModel/Common.pm and Config/Config.xml and add I<Apache::PageKit> as the
handler for this dir in yout C<httpd.conf>.

=back

=head1 I<Apache::PageKit> beginner's FAQ's

=head2 4.1 Can I run more as one site with one Apache Server?

Sure, as long as the Perl Classes don't conflict. (You can't run both production and development
PageKits on the same server, unless you make sure that the Classes have different names.)
You will also have to make sure that the PKIT_ROOT and cache_dir configuration
option are distinct for each server. If cache_dir is not set for either of them,