Modules localization workflow

[alexey.rudy@…]

There's no description for modules localization workflow. It would be good to provide working example here TracDev/PluginDevelopment or here TracL10N.

I failed in attempts of localizing my module :)

[Christian Boos]

Right, it's possible to do but undocumented ;-)

One of the reasons is that I only did it for the TracMercurial plugin so far, and I still want to do it for yet another plugin and check for possible bad interactions. Definitely something to do ASAP.

[Christian Boos]

… for some definition of ASAP ;-)

There's another example in ​http://trac-hacks.org/changeset/7515.

[hoff.st@…]

Thanks for the link. Since I use this plugin in German env, it's definitely time to upgrade it now.

For the i18n support example: May I put it into PluginDevelopment since I found no place where it would fit in better?

[hasienda <hoff.st@…>]

Have a look at CookBook PluginL10N, please.

This is a preliminary version, driven by the enhancement request of this ticket and by the need of documentation for my own work as well. It will be improved with attachments containing at least a diff (holding all the i18n/l10n changes for a plugin) and the unmodified source of that plugin for reference/training as well. I'm open to suggestions, and hey, that one is just a wiki page, open to your contributions as well, isn't it?

[Christian Boos]

Thanks a lot for getting this started. I've reviewed the page (half-way through) and made some more changes.

[hasienda <hoff.st@…>]

Replying to cboos:

Thanks a lot for getting this started.

Well, thanks to you for reviewing including new/better content, formatting, some I had in mind but was not able to produce myself. Just saw your edits while already adding more information there. I had already done the file upload for a(other) i18n/l10n example work of mine. I'd like to change the diff according to your improvements and corrections, but how to replace it then?

I've reviewed the page (half-way through) and made some more changes.

Oh, sorry, meant you where already through and removed the continue review from here comment.

[hasienda <hoff.st@…>]

reset revision marker before a desputed paragraph, so now cboos, you should be able to continue. Still advice on updating the attached example diff would be appreciated.

[Christian Boos]

Replying to hasienda <hoff.st@…>:

… Still advice on updating the attached example diff would be appreciated.

You mean, according to the changes I made? Well, if it's not yet clear from the CookBook/PluginL10N#Prepareplugincode section, then I should explain things better and the page should be fixed ;-)

[hasienda <hoff.st@…>]

Replying to cboos:

Replying to hasienda <hoff.st@…>:

… Still advice on updating the attached example diff would be appreciated.

You mean, according to the changes I made? Well, if it's not yet clear from the CookBook/PluginL10N#Prepareplugincode section, then I should explain things better and the page should be fixed ;-)

No, I simply missed your hints since I was working on that example for quite some time. So it happend that I uploaded shortly after your edits, not having read before, sorry. All your information is clear, my example is just to make it even more 'for dummies'.

What else is missing there to make it complete, or at least clear enough to follow?

[Christian Boos]

I have to finish the review (2nd half) and both examples miss the translation of templates, which should theoretically be possible using i18n:domain, but I haven't tried yet.

[hasienda <hoff.st@…>]

Replying to cboos:

I have to finish the review (2nd half) and both examples miss the translation of templates, which should theoretically be possible using i18n:domain, but I haven't tried yet.

I see. Regarding template translation I have something half-finished: ​Watchlist plugin. This has a template, and I was unable to get l10n working after i18n old style (no domain_functions() but own translation submodule). So I'll do another run with the lessons learned by now and report back.

[hasienda <hoff.st@…>]

I did some more i18n work and was able to find enough for a dedicated section on Genshi templates.

Still anyone with some knowledge about i18n of Java scripts is welcome to contribute.

[Christian Boos]

TODO

• example of the two forms of domain_functions in r9770
• talk about r9763, example usage for a plugin with translation but no Javascript support in r9771
• try to see if support for Javascript translations works for a plugin

[Christian Boos]

Okay, CookBook/PluginL10N@22 is now in an acceptable shape.

There are still improvements that could be made, both by adding more details (how to the _() function in Javascript for example, adding a "HelloWorld" plugin i18n'ed from the inside out), and by also producing a terse version of this page, assuming all the basics of TracL10N are already known (maybe in TracDev/PluginDevelopment#InternationalizationLocalizationofplugins), but I think this is good enough for getting the ball rolling after the 0.12 release.

Thanks again to Steffen, without his own contributions and his inciting me to finally write something on this, the topic would still be undocumented.