Re: [Rails-devel] Re: HELP

[Brett L. <wak...@ea...>]

See my reply to John in which I reference that same tutorial.  ;-)

While I don't (yet) want to completely internationalize/localize the code, it is good to be aware of how Java approaches this and make a future move a bit less cumbersome.

Also, regardless of the implementation, my bigger concern is that maintaining a help system that is intertwined with the code is excessively cumbersome and ought to be avoided by everything but the earliest stages of development.


---Brett.

-----Original Message-----
From: ia...@co...
Sent: Nov 30, 2005 5:02 PM
To: rai...@li...
Subject: [Rails-devel] Re: HELP

>> Subject: RE: [Rails-devel] Help
>> 
>> I just had a chance to look at the help system a little more in-depth.
>> 
>> >At some point we're going to want to separate the text strings from the code.  >Perhaps we should generate a global help xml file to hold the text, or maybe a >help directory to hold multiple files, and then also have a game->specific help file for including any game-specific help information.

You need to read up on internationalization (aka I18N) and localization (aka L10N). Basically your code ends up referring to property names, which are then looked up in property files for the actual text. Different versions of the props file(s) are provided for each locale, and the user's settings determine which one is used.

ISTR the tutorial trail on Suns's Java website explaining the process covered it very nicely, and didn't take long to read. I internationalised a small app in about couple of hours, including reading the tutorial. There's also an Eclipse wizard which helps configure it all for you.

I'd advise having a small number of files, probably only one for the base 
application, rather than one per package (which is the alternative). Also make sure you use Format strings where appropriate so that you can cope with parameters (e.g. company name, currency refs, etc) being in different places in the text in different languages.

Iain.





-------------------------------------------------------
This SF.net email is sponsored by: Splunk Inc. Do you grep through log files
for problems?  Stop!  Download the new AJAX search engine that makes
searching your log files as easy as surfing the  web.  DOWNLOAD SPLUNK!
http://ads.osdn.com/?ad_id=7637&alloc_id=16865&op=click
_______________________________________________
Rails-devel mailing list
Rai...@li...
https://lists.sourceforge.net/lists/listinfo/rails-devel