2,751
edits
Changes
Activity Library/Localizers (view source)
Revision as of 13:36, 18 March 2009
, 13:36, 18 March 2009initial content
{{draft}}
= Introduction =
One of the big advantages of Remora is support for localization.
Generally, localizations will only be accepted from people who are already active members of a [http://wiki.mozilla.org/Category:L10n_Teams language team] which starts [http://developer.mozilla.org/en/docs/Localization here].
= Steps to localizing AMO in a new language =
This is a comprehensive list of steps to completely localize addons.mozilla.org's interface from English into another language.
* If you don't already have one, create a new [https://addons.mozilla.org/en-US/firefox/users/register AMO Account]
* [https://bugzilla.mozilla.org/buglist.cgi?query_format=advanced&product=addons.mozilla.org&component=Localization Search Bugzilla] for the words "AMO Localization (xx)" where xx is your locale code.
** If a bug appears for your locale, then someone is already working on it. This will be a case by case basis depending on how far along the translation is, but if the bug isn't resolved, I'd suggest commenting in the bug and offering to help there.
* Assuming a bug doesn't exist, [https://bugzilla.mozilla.org/enter_bug.cgi?product=addons.mozilla.org;token=OIqPyweTwO;version=3.0;component=Localization;bug_severity=normal;rep_platform=All;priority=--;op_sys=All;target_milestone=---;bug_status=NEW;flag_type-278=X;flag_type-279=X;flag_type-277=X;flag_type-287=X;flag_type-250=X;alias=;bug_file_loc=http%3A%2F%2F;short_desc=AMO%20Localization%20%28xx%29;comment=;data=;description=;contenttypemethod=autodetect;contenttypeselection=text%2Fplain;contenttypeentry=;flag_type-1=X;keywords=;dependson=;blocked=;maketemplate=Remember%20values%20as%20bookmarkable%20template;form_name=enter_bug;assigned_to=nobody%40mozilla.org;qa_contact=l10n%40add-ons.bugs create a new bug] with a Summary of "AMO Localization (xx)" (replace xx with your locale) and a description announcing your intention to localize AMO for that locale (include your AMO account name, please!). Assign the bug to yourself.
* Join the [https://lists.mozilla.org/listinfo/dev-l10n-web dev-l10n-web mailing list] so you can get notified when strings are added or changed
* Translate the main [http://svn.mozilla.org/addons/trunk/site/app/locale/en_US/LC_MESSAGES/messages.po english gettext file]
** If you're not sure what the Plural-Forms are for your language, mention this in the bug and we can help
** Attach the completed document to your bug
* Translate the [http://svn.mozilla.org/addons/trunk/site/app/locale/en_US/pages/ specialized pages] ''except for privacy.thtml''
** [https://bugzilla.mozilla.org/show_bug.cgi?id=372995 We can't accept translations of privacy.thtml at this time]
** Attach each of the translated files separately to your bug
* Translate [http://wiki.mozilla.org/Update:Remora_Sandbox_Flowchart the strings for the flowchart]
** We'll create the image for you, just attach the translated strings to your bug
* When this is all complete, please post a comment in your bug asking for all updates to be pushed to the staging site for review.
* Once everything is setup, when you login to addons.mozilla.org, there will be a link in the left menu that says "localizer tools." It holds links to change dynamic data in the system - it's pretty intuitive, but if you'd like more instruction here, look us up in #addons on irc. ''You should look at this link as soon as it's available to you on the live site, because all the categories, add-on types, etc. are here and need to be translated.''
'''An optional (but recommended) aside:'''
After a locale has been setup, it's possible for a localizer to add/edit translations with little to no help from the admins/developers. We're happy to assist if we can, but once a localizer learns the process, we usually just slow things down, so:
If you already have an SVN account from another project (like mozilla.com) you should reopen the original bug and ask for additional write permissions to /addons/trunk/site/app/locale/___ where ___ is your locale.
If you don't have an SVN account yet, follow [http://wiki.mozilla.org/SVN#SVN_account_for_localizers these instructions].
I'd also recommend subscribing to the rss feed for your locale. You can get to the feeds from [http://viewvc.svn.mozilla.org/vc/addons/trunk/site/app/locale/ viewvc]. When a new string is added, the developers will merge the string into your file and mark it as fuzzy. If you're subscribed to the feed, you'll be notified of the change almost immediately.
= What about the extension metadata? =
AMO supports localized metadata about the extensions (like their titles and descriptions) but offers no way for localizers to directly edit them. The responsibility for translation lies solely with the authors. We're looking at more usable ways to implement the system and still keep a good level of quality and accuracy. In the mean time, add-on authors are given this brief [http://developer.mozilla.org/en/docs/Localizing_extension_metadata_on_addons.mozilla.org summary on how to get help].
= Introduction =
One of the big advantages of Remora is support for localization.
Generally, localizations will only be accepted from people who are already active members of a [http://wiki.mozilla.org/Category:L10n_Teams language team] which starts [http://developer.mozilla.org/en/docs/Localization here].
= Steps to localizing AMO in a new language =
This is a comprehensive list of steps to completely localize addons.mozilla.org's interface from English into another language.
* If you don't already have one, create a new [https://addons.mozilla.org/en-US/firefox/users/register AMO Account]
* [https://bugzilla.mozilla.org/buglist.cgi?query_format=advanced&product=addons.mozilla.org&component=Localization Search Bugzilla] for the words "AMO Localization (xx)" where xx is your locale code.
** If a bug appears for your locale, then someone is already working on it. This will be a case by case basis depending on how far along the translation is, but if the bug isn't resolved, I'd suggest commenting in the bug and offering to help there.
* Assuming a bug doesn't exist, [https://bugzilla.mozilla.org/enter_bug.cgi?product=addons.mozilla.org;token=OIqPyweTwO;version=3.0;component=Localization;bug_severity=normal;rep_platform=All;priority=--;op_sys=All;target_milestone=---;bug_status=NEW;flag_type-278=X;flag_type-279=X;flag_type-277=X;flag_type-287=X;flag_type-250=X;alias=;bug_file_loc=http%3A%2F%2F;short_desc=AMO%20Localization%20%28xx%29;comment=;data=;description=;contenttypemethod=autodetect;contenttypeselection=text%2Fplain;contenttypeentry=;flag_type-1=X;keywords=;dependson=;blocked=;maketemplate=Remember%20values%20as%20bookmarkable%20template;form_name=enter_bug;assigned_to=nobody%40mozilla.org;qa_contact=l10n%40add-ons.bugs create a new bug] with a Summary of "AMO Localization (xx)" (replace xx with your locale) and a description announcing your intention to localize AMO for that locale (include your AMO account name, please!). Assign the bug to yourself.
* Join the [https://lists.mozilla.org/listinfo/dev-l10n-web dev-l10n-web mailing list] so you can get notified when strings are added or changed
* Translate the main [http://svn.mozilla.org/addons/trunk/site/app/locale/en_US/LC_MESSAGES/messages.po english gettext file]
** If you're not sure what the Plural-Forms are for your language, mention this in the bug and we can help
** Attach the completed document to your bug
* Translate the [http://svn.mozilla.org/addons/trunk/site/app/locale/en_US/pages/ specialized pages] ''except for privacy.thtml''
** [https://bugzilla.mozilla.org/show_bug.cgi?id=372995 We can't accept translations of privacy.thtml at this time]
** Attach each of the translated files separately to your bug
* Translate [http://wiki.mozilla.org/Update:Remora_Sandbox_Flowchart the strings for the flowchart]
** We'll create the image for you, just attach the translated strings to your bug
* When this is all complete, please post a comment in your bug asking for all updates to be pushed to the staging site for review.
* Once everything is setup, when you login to addons.mozilla.org, there will be a link in the left menu that says "localizer tools." It holds links to change dynamic data in the system - it's pretty intuitive, but if you'd like more instruction here, look us up in #addons on irc. ''You should look at this link as soon as it's available to you on the live site, because all the categories, add-on types, etc. are here and need to be translated.''
'''An optional (but recommended) aside:'''
After a locale has been setup, it's possible for a localizer to add/edit translations with little to no help from the admins/developers. We're happy to assist if we can, but once a localizer learns the process, we usually just slow things down, so:
If you already have an SVN account from another project (like mozilla.com) you should reopen the original bug and ask for additional write permissions to /addons/trunk/site/app/locale/___ where ___ is your locale.
If you don't have an SVN account yet, follow [http://wiki.mozilla.org/SVN#SVN_account_for_localizers these instructions].
I'd also recommend subscribing to the rss feed for your locale. You can get to the feeds from [http://viewvc.svn.mozilla.org/vc/addons/trunk/site/app/locale/ viewvc]. When a new string is added, the developers will merge the string into your file and mark it as fuzzy. If you're subscribed to the feed, you'll be notified of the change almost immediately.
= What about the extension metadata? =
AMO supports localized metadata about the extensions (like their titles and descriptions) but offers no way for localizers to directly edit them. The responsibility for translation lies solely with the authors. We're looking at more usable ways to implement the system and still keep a good level of quality and accuracy. In the mean time, add-on authors are given this brief [http://developer.mozilla.org/en/docs/Localizing_extension_metadata_on_addons.mozilla.org summary on how to get help].