I do some work on the PHP documentation.

To allow for multiple languages, the documentation is primarily
written in English and stored in a CVS repository. The translators
watch for CVS commits and then update their versions of the manual,
committing those changes back to CVS. There is a separate build
process to take the CVS and construct webpages and CHM in all the
languages.

The format at the moment is Docbook and a combination of DSSSL and XSL
along with a bit of PHP are used to do all of this.

Unfortunately, I'm no Docbook/DSSSL/XSL expert.

Having a repository for the documentation would be useful.

The biggest issue is for non-english speaking users getting out of
date documentation as there translators (all volunteers) have not
translated the most recent amendments.

Having said that, for such a small API, there shouldn't be too much of
an issue keeping on to of the edits.

Richard.

On 22/02/07, Mislav Marohnić <[EMAIL PROTECTED]> wrote:
> We briefly mentioned translations in one of our discussions. If they
> existed, they would have to be hosted and maintained elsewhere. How many
> volunteers would there be and will the multilingual docs be up-to-date with
> the official ones, we don't know.
>
> I guess the idea doesn't have enough interest yet.
>
>
>
> On 2/22/07, Jussi Salminen <[EMAIL PROTECTED] > wrote:
> > Hi,
> >
> > I wonder is there any needs to translate official Prototype manual to
> another language than english?
> > English is the "internet" language, but still there are many peoples that
> doesn't understand some meanings of manual.
> >
> > If need, I could translate manual in english to finnish.
> >
> > I think that at least next languages should have own manual
> > * Spain
> > * German
> >
> > Just idea, not yet anything more..
> >
> >
> >
>
>
>  >
>


-- 
-----
Richard Quadling
Zend Certified Engineer : http://zend.com/zce.php?c=ZEND002498&r=213474731
"Standing on the shoulders of some very clever giants!"

--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"Prototype: Core" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/prototype-core?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to