@@ -1,21 +1,32 @@ How translation works ===================== -Translation in CE is organized by translation tokens, which any text visible to users in your application should be represented by a translation token followed by a `.l` (e.g. `:this_phrase_needs_translation.l`). +Text which is visible to the user in CE is represented by translation tokens. Any text visible to users in your application should be represented by a translation token followed by a `.l` (e.g. `:this_phrase_needs_translation.l`). This tells the system to look for a translation of this phrase in the appropriate locale file. It will look for that in either `RAILS_ROOT/lang/ui` or `RAILS_ROOT/vendor/plugin/community_engine/lang/ui`, picking up a YAML-file which begins with the locale you've set in `application.yml` (e.g. `de-DE.yml`). -Why load locales from both directories? The latter holds the standard translation that come with CE. The former one is for your customized translation (use `RAILS_ROOT/vendor/plugin/community_engine/lang/en.yml` as a reference of all tokens used in CE). +Why load locales from both directories? The latter holds the standard translations that come with CE. The former is for your customized translation (use `RAILS_ROOT/vendor/plugin/community_engine/lang/en.yml` as a reference of all tokens used in CE). If you see a token like `_translation_missing_` save the URL and the context of it and post a request at Lighthouse or the Google group to get it fixed. For Developers ============== If you rework standard CE and you add a visible item to a view (a UI element, a flash notice or something similar), please use the translation tokens to add text. Place these tokens in `en.yml` for other translators to give them a chance to complete their translation files. +NOTE: If you have special characters or a colon in your translation phrase you have to surround them with double quotes. For Translators =============== -Try using the translate plugin: [http://github.com/bborn/translate](http://github.com/bborn/translate) when creating translations in new locales +Try using the translate plugin: [http://github.com/bborn/translate](http://github.com/bborn/translate) when creating or updating translations in new locales + +It provides you with some useful rake tasks, including: + + rake translate:diff_keys FROM_LOCAL=en TO_LOCALE=es + #Shows you which keys exist in FROM_LOCALE.yml but not in TO_LOCALE.yml + + rake translate:obsolete LOCALE=es + #Shows you which keys exists in LOCALE.yml but not in the application source + + rake translate:orphans LOCALE=es + #Show you which keys are in your template code but aren't in LOCALE.yml -NOTE: if you have special characters or a colon in your translation phrase you have to surround them with double quotes. \ No newline at end of file lang/TRANSLATION.markdown @@ -1349,6 +1349,8 @@ fr: user_vendor_offer: "Décrivez le produit ou le service que vous proposez :<ul><li>Expliquez aux gens ce que vous faites</li><li>Expliquez pourquoi vous aimez ce que vous faites</li><li>Comment pouvez vous être contacté ? Avez vous un site web ?</li></ul>" #en: user_bio_help: "Your bio is first thing people see on your profile. Some ideas:<ul><li> Describe your sense of style</li><li> Explain what you love about life.</li><li> What's the last thing you purchased for a friend?</li></ul>" user_bio_help: "Votre biographie est la première chose que les autres découvrent sur votre profil. Quelques bonnes idées :<ul><li> Décrivez votre style.</li><li> Présentez ce que vous aimez dans la vie.</li><li> Quelle est la dernière chose que vous ayez offerte à un ami ?</li></ul>" + #en: vendor_avatar_hint: "You may want to use your company logo, or a photo of one of your products. " + vendor_avatar_hint: "Vous souhaitez peut être utiliser le logo de votre société, ou une photo d'un de vos produits. " #en: view: View view: Consulter #en: views: Views @@ -1474,9 +1476,7 @@ fr: one: Vous avez écrit 1 article de blog. other: "Vous avez écrit {{count}} articles de blog." #en: you_last_logged_in_on: You last logged in on - you_last_logged_in_on: Dernière connexion le - #en: you_may_want_to_use_your_company_logo_or_a_photo_of_one_of_your_products_: "You may want to use your company logo, or a photo of one of your products. " - you_may_want_to_use_your_company_logo_or_a_photo_of_one_of_your_products_: "Vous souhaitez peut être utiliser le logo de votre société, ou une photo d'un de vos produits. " + you_last_logged_in_on: Dernière connexion le #en: you_must_vote_to_see_the_results: You must vote to see the resuts. you_must_vote_to_see_the_results: Vous devez voter pour voir les résultats. #en: your_about_text_goes_here: Your About Text Goes Here lang/ui/fr-FR.yml 240c3276b4743f216557e7602ecaf2d0417b25c9 bborn bruno.bornsztein@gmail.com http://github.com/bborn/communityengine/commit/dc0cdf88eab8a2da8f863ab78711d4cb5586f5f8 dc0cdf88eab8a2da8f863ab78711d4cb5586f5f8

2009-10-23T18:25:02-07:00

more i18n stuff 2c6036be17ee9f93a8aad3963a55d7e68d2e2b23 bborn bruno.bornsztein@gmail.com