I would like to offer the services of kangax to handle documentation
publishing, I am sure we can solve many of the problems you are currently
experiencing.

Kangax is a simple publishing tool which leverages cocoon technology.

Please contact Dean McGowan to discuss, this would be a free service to the
community, however editors and contributors are still necessary.

If you are using a win 32 operating system with ie6.0 installed please
download and trial Kangax from

http://www.kangax.com/client/kangax/downloads/setup.exe


Regards,

Dean McGowan




-----Original Message-----
From: Diana Shannon [mailto:[EMAIL PROTECTED]]
Sent: Thursday, July 04, 2002 9:10 AM
To: [EMAIL PROTECTED]
Subject: Re: Website documention problem with page widths



On Wednesday, July 3, 2002, at 06:55  PM, Scott Bussinger wrote:

> Many of the pages have severe issues with page widths. For example, if
> you
> go to http://xml.apache.org/cocoon/developing/sunspot.html, you'll find
> the
> the pages are much wider than the browser screen width (same problem in
> both
> IE and Netscape). It's _very_ hard to read these pages and you can't
> really
> print them at all (half the text is missing off of the side of the
> page).
> There are many of these pages scattered throughout the site.

This is a known problem with source snippets that are made up of CDATA
sections running longer than the designed screen width. We're addressing
this in Forrest. Right now, the only solution is to manually break these
snippets in the source XML file for "pretty printing" in docs. I always
fix this when I encounter such problems in the existing files I edit,
and I screen these problems out of all new submissions, but I simply
haven't had time to fix *all* problematic files, yet. Volunteers?

> This is sounds like a small thing, but this information isn't available
> anywhere else and it's extremely hard to get it from the one place it is
> available. I finally resorted to cutting and pasting the text into Word
> so I
> could print it.

Sorry you had to go to this trouble.

> Also making these pages available as PDF files for easy printing would
> be
> wonderful as well. I've read messages that seem to discuss a new
> documentation method coming in the future and maybe that will solve the
> problem, but simply fixing the webpages would be much appreciated.

Also a Forrest goal.

Thanks for your input.

Diana


---------------------------------------------------------------------
Please check that your question  has not already been answered in the
FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>

To unsubscribe, e-mail:     <[EMAIL PROTECTED]>
For additional commands, e-mail:   <[EMAIL PROTECTED]>




---------------------------------------------------------------------
Please check that your question  has not already been answered in the
FAQ before posting.     <http://xml.apache.org/cocoon/faq/index.html>

To unsubscribe, e-mail:     <[EMAIL PROTECTED]>
For additional commands, e-mail:   <[EMAIL PROTECTED]>

Reply via email to