cocoon-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Dr. Gerald Schröder <Gerald.Schroe...@InfoDesign-OSD.de>
Subject Success story & hints: Generating static web sites using Cocoon 2.0.1
Date Fri, 08 Mar 2002 21:43:31 GMT
For a change here a success story, not a question or cry for help.

I have successfully installed and used Cocoon 2.0.1 in batch mode for generating our static
web site http://www.infodesigner.biz (I am afraid it is in German, sorry ;-).

Effort: one week with no prior knowledge of Cocoon and only slight knowledge of XSL. (From
this two days were spent for translating the original HTML stuff to small XML pieces - boring
:-((. Could be faster, I know. But see the hints below to overtake me.

If you are interested in our small (not as sophisticated as the one delivered with Cocoon
2.0.1) example you can download it from
  http://www.infodesigner.biz/de/about/website.zip (ca. 500 kb). You will get our website
and all you need to build it. You will find two different style sheets (XSL), some XML code,
some plain HTML pages, and css, gif, jpg, bmp. 

My platform: Windows XP.

Hints (see also the README in the zip - again in German, so here the translation and some
more remarks):
- Use the source distribution Cocoon-2.0.1-src.zip - the binary distribution seems to be useless
for us "standalonies".
- You have to build cocoon.jar with the command:
  build all
- Then you have to copy the jars so that run.bat finds them:
   copy %COCOON_HOME%\build\cocoon\cocoon.jar %COCOON_HOME%\lib\
   copy %COCOON_HOME%\lib\core\* %COCOON_HOME%\lib\
   copy %COCOON_HOME%\lib\optional\* %COCOON_HOME%\lib\
- If you do not start Cocoon from %COCOON_HOME% (and it is not on your PATH) you have to change
run.bat so that appendcp.bat can be found (a simple %COCOON_HOME%\appendcp.bat is fine).
- Try run -h to get the command line parameters. Note that you have to give a LogKit.xconf
configuration file via -k if you want a finer control of the logging information (since I
use log4j and not LogKit here ends my advice). The redirection of log output to a file via
-l does not work - even if the build.xml does assume that.
- Do not rely on the output of the LogKit - there are no ERRORs or WARNings when files could
not be found or the link serializer could not find links for recursive build. You may see
Broken Links - or you may not when a file has been translated but the links were not extracted.
So check your web site for broken links. I could not get hold of useful information in the
mass of the log output.
- I could not figure out if the link serializer can extract links from *.css stylesheets.
 So files mentioned in css-stylesheets are not recognized.
- Do not change the name "link" of the view for the link serializer - it is hardwired in the
code!
- Lacking a smart XML editor I used the Internet Explorer 6.0 for checking the syntax of my
XML and XSL code. It shows errors at the end of the file. Dumb but useful.

If you have questions you can reach me via gerald.schroeder@infodesign-osd.de.

Regards,

Gerald

InfoDesign-OpenSourceDeveloper GmbH
gerald.schroeder@infodesign-osd.de
http://www.infodesigner.biz


Mime
View raw message