Document i18n features of Forrest

• Key: FOR-707
• Type: Task
• Status: Closed
• Resolution: Fixed
• Priority: Critical
• Assignee: Unassigned
• Reporter: Ross Gardler
• Component/s: Documentation and website, Internationalisation (i18n)
• Affects Version/s: 0.7, 0.8
• Fix Version/s: 0.9-dev

Description

There is next to no documentation about i18n, just a pretty poor FAQ entry that points at an issue that has now been closed.

Cheche wrote a blog entry on his work:

http://casa.che-che.com/blog/2005/05/10/internalization-a-site-using-forrest-07-dev/

We could, at the very least use the locationmap to pull this content into our site [OT: I wonder if this could be a way to generate more documentation?)

Comments

Ross,
I am happy to document i18n. I am currently trying to get it to work for multiple languages in a test F7 app. posting my question via users mailing list. Any info on how to get it running is appreciated. The sooner my test runs, the sooner I can play around with the possibilities, write the howto and attach the any menu/tabs/catalogue lang files I create aside from what is currently in the distro.

helena

[David Crossley]

http://article.gmane.org/gmane.text.xml.forrest.user/3620
Subject: Re: Recommendations for URL-based i18n like at www.verit.de?
Message-ID: <[e-mail]>

[Thomas Witteriede]

Ross,
At the moment I am stumbling through the i18n jungle myself and I can document my findings for the benefit of others. As I am not familiar with SVN and being a Windows user the easiest way for me would be to create an XML document for Forrest and mail it to you or dev<at>forrest.apache.org . Would this be a viable way of contributing?

Thomas

[David Crossley]

Thomas, create the xml document and test/develop it using 'forrest run'. Rather than email it, please attach it to this FOR-707 issue.

Also don't forget that there is some basic documentation in a "forrest seed" sample site. The earlier comment in this FOR-707 at 17/May/06 provides more detail. Perhaps it would be better to expand that sample - it is up to you.

[Thomas Witteriede]

I tried to expand the i18n.xml as far as I understood the workings of Forrest. It is a mixture of What and How-to. Please check for errors and glitches.

I hope you will find it helpful. I might provide a German version if this is of any use.

Thomas

[Gavin]

Thanks Thomas, Patch applied with a few minor xml edits, but documentation itself as-is.

Apologies for delay in applying.