Re: Wyona with FO

Jason:

> >  And if I wanted to install this functionality
> into Wyona I would just 
> > include all the required generators, serializers


This would be correct.  Below is info from the cocoon
site on how to rebuild cocoon with you added
functionalities (e.g. FOP serializer).  It would be
great if when you do download cocoon with any extra
features, you send a line or two to Michael or the
user's list as to how you replaced the version of
Cocoon packaged with Wyona with your newer version (if
you made any changes to what I wrote below).  Again
any contributions to the documentation is useful.  

************************************************
Adding optional components

Some of the components delivered with Cocoon require
additional libraries, e.g. the Php generator or the
FOP serializer (for more information about these
components, refer to their documentation).

Most of these libraries are already included in the
distribution, but some have to be downloaded manually.
The build task checks whether you have the required
libraries or not and includes the optional components
only if you have the libraries available when you
build Cocoon. Refer to the Cocoon JARs page for a list
of libraries and locations where you could get them.

A library/package is available to the build process
when it is located in the ./lib/optional or the
./lib/local directory.

The following table contains a list of the optional
components, their needed libraries and if they are
already included or not.

Component Required Library Library Included
HTML Generator | JTidy | Yes
Php Generator | Php Servlet | No
LDAP Transformer | JNDI | No
PDF Serializer | FOP | Yes
RTF Serializer | jfor | No

If you want to add additional libraries, put them in
the ./lib/local directory as this directory is not
touched by CVS. Note: If you added a library/package,
you need to rebuild Cocoon as described in 'Create the
Cocoon WAR package'. 
 
************************************************
build webapp

Creates the Cocoon WAR package. It's a non-interactive
version of installwar.

    * target: webapp
    * required properties: include.webapp.libs
    * buildfile: build.xml

To do this you simply have to type:

[unix]  ./build.sh  -Dinclude.webapp.libs=yes webapp
[win32] .\build.bat -Dinclude.webapp.libs=yes webapp

this will create the cocoon.war file in the
./build/cocoon directory. Follow instructions in the
next chapter to deploy this webapp in your container.

If you want a "clean" web application, you can specify
these optional properties:

    * exclude.webapp.samples : to exclude the samples
    * exclude.webapp.documentation : to exclude the
documentation
    * exclude.webapp.javadocs : to exclude the java
docs

So, if you first remove all libraries from the
./lib/local and the ./lib/optional directory except
the servlet.jar and then type:

[unix]  ./build.sh  -Dinclude.webapp.libs=yes
                    -Dexclude.webapp.samples=yes 
                    -Dexclude.webapp.documenation=yes
                    -Dexclude.webapp.javadocs=yes
webapp
[win32] .\build.bat -Dinclude.webapp.libs=yes
                    -Dexclude.webapp.samples=yes 
                    -Dexclude.webapp.documenation=yes
                    -Dexclude.webapp.javadocs=yes
webapp

you get a minimal Cocoon web application without any
samples or documentation. But remember to make a build
clean beforehand.

Note:This feature is only available in the latest
developer version of Cocoon which you can find in the
CVS. 
***************************************
Hope this helps, thanks Apache Cocooners.
For more info, chech out:
http://xml.apache.org/cocoon/installing/index.html

-Julian

=====
Live simply so others may simply live.
 
-Ghandi
 
Pluralitas non est ponenda sine neccesitate.
"Entities should not be multiplied unneccesarily"
 
-William of Occam

__________________________________________________
Do you Yahoo!?
Y! Web Hosting - Let the expert host your web site
http://webhosting.yahoo.com/