Confirm, emeritus
1,737
edits
Changes
no edit summary
{{draft}}
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 addon.mozilla.org's interface from English into another language.
* [https://bugzilla.mozilla.org/query.cgi?format=specific Search Bugzilla] for the words "Remora 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;version=3.0;component=Add-ons;bug_severity=normal;rep_platform=All;priority=--;op_sys=All;target_milestone=---;bug_status=NEW;flag_type-280=X;flag_type-287=X;flag_type-250=X;alias=;bug_file_loc=http%3A%2F%2F;short_desc=;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=add-ons%40add-ons.bugs create a new bug] with a Summary of "Remora Localization (xx)" (replace xx with your locale) and a description announcing your intention to localize Remora for that locale.
* Join the [https://mail.mozilla.org/listinfo/amo-l10n AMO l10n 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
* Translate the [http://wiki.mozilla.org/User:Shaver/Remora_Categories initial set of categories and add-on types]
** This can just be a plain text file, and please attach it 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.
'''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:
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 - if you'd like more instruction here, look us up in #addons on irc.
I suspect most (if not all) localizers already have SVN accounts for mozilla.com (from [https://bugzilla.mozilla.org/show_bug.cgi?id=356627 bug 356627]). If you have an account already, and you would like to be able to manage the files in SVN yourself (this is everything that isn't dynamic data), please:
* Reopen the original bug that was filed to get you mozilla.com SVN access
* Click "edit" next to the word "Blocks" and add "xxxxxx" to the comma separated list (note: the "give localizers access to remora" bug doesn't exist yet. When it does, replace xxxxxx with whatever it is)
* In the comments, request SVN access to:
** svn+ssh://svn.mozilla.org/addons/trunk/app/site/locale/___ (replacing ___ with your locale)
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 addon.mozilla.org's interface from English into another language.
* [https://bugzilla.mozilla.org/query.cgi?format=specific Search Bugzilla] for the words "Remora 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;version=3.0;component=Add-ons;bug_severity=normal;rep_platform=All;priority=--;op_sys=All;target_milestone=---;bug_status=NEW;flag_type-280=X;flag_type-287=X;flag_type-250=X;alias=;bug_file_loc=http%3A%2F%2F;short_desc=;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=add-ons%40add-ons.bugs create a new bug] with a Summary of "Remora Localization (xx)" (replace xx with your locale) and a description announcing your intention to localize Remora for that locale.
* Join the [https://mail.mozilla.org/listinfo/amo-l10n AMO l10n 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
* Translate the [http://wiki.mozilla.org/User:Shaver/Remora_Categories initial set of categories and add-on types]
** This can just be a plain text file, and please attach it 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.
'''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:
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 - if you'd like more instruction here, look us up in #addons on irc.
I suspect most (if not all) localizers already have SVN accounts for mozilla.com (from [https://bugzilla.mozilla.org/show_bug.cgi?id=356627 bug 356627]). If you have an account already, and you would like to be able to manage the files in SVN yourself (this is everything that isn't dynamic data), please:
* Reopen the original bug that was filed to get you mozilla.com SVN access
* Click "edit" next to the word "Blocks" and add "xxxxxx" to the comma separated list (note: the "give localizers access to remora" bug doesn't exist yet. When it does, replace xxxxxx with whatever it is)
* In the comments, request SVN access to:
** svn+ssh://svn.mozilla.org/addons/trunk/app/site/locale/___ (replacing ___ with your locale)
