View source for Developer Area/Language Packs/Launchpad Migration

{{Obsolete|<br><br>As of June 2015, all active translations have been migrated to Launchpad.}}

Steps required to do a one-off language pack migration from gitorious to launchpad

===Convert the existing language pack to a .po file===

This should be done on a language-by-language basis for all branches (1.3, 1.4, and master) because it's not possible to have some branches using gitorious and others using launchpad.

Use the script <tt>mahara-langpacks/update-po.sh</tt> in the [http://gitorious.org/mahara/mahara-scripts mahara-scripts] repository.  You probably want to change the directory locations near the top, and you definitely want to change the list of languages.

===Update the Last-Translator line in each .po file===

 "Last-Translator: Gregor Anželj <gregor.anzelj@gmail.com>\n"

If you don't include an email address on this line, you (as the uploader) will be credited as the translator after it's uploaded to Launchpad.

===Get the most up to date .pot templates from launchpad===

You need one mahara.pot for each branch.  You can find them on these bzr branches:

* http://bazaar.launchpad.net/~mahara-lang/mahara-lang/master/files/head:/mahara/
* http://bazaar.launchpad.net/~mahara-lang/mahara-lang/1.4_STABLE/files/head:/mahara/
* http://bazaar.launchpad.net/~mahara-lang/mahara-lang/1.3_STABLE/files/head:/mahara/

===Create a tarball for each branch===

Put all the files in a mahara directory, and rename the .po files to just sl.po, etc., so you now have 3 tarballs, named something like master.tar.gz, 14stable.tar.gz and 13stable.tar.gz, each containing:

 mahara/mahara.pot
 mahara/sl.po

You can upload individual .po files rather than tarballs, but don't.  It seems to take forever for them to be imported, possibly because it requires human approval.

===Upload the tarballs===

'''Starting here, you need to be a direct member of the [https://launchpad.net/~mahara-lang/+members mahara-lang team].'''

Each branch has its own upload page: 

* https://translations.launchpad.net/mahara-lang/trunk/+translations-upload
* https://translations.launchpad.net/mahara-lang/1.4/+translations-upload
* https://translations.launchpad.net/mahara-lang/1.3/+translations-upload

All the files should now be visible on the [https://translations.launchpad.net/mahara-lang/+imports import queue].

After 24 hours the translations should have been imported into launchpad and should be [https://translations.launchpad.net/mahara-lang visible].

===Make the Gitorious repo read-only===

Once the translation has been moved to Launchpad, disable commits on the old Gitorious repo:

* Remove all external people from the repo.
* Leave mahara-core with permissions to '''administer''' the repo, but remove "commit" and "review".

===Create a translation team===

Go to the Translation group at https://translations.launchpad.net/+groups/mahara-translation-group

Ideally, get the Mahara translators to join the general Launchpad translation groups for their languages. For example:

* [https://launchpad.net/~lp-l10n-zh-tw Chinese (Traditional)]
* [https://launchpad.net/~lp-l10n-he Hebrew]

If the Mahara translators are unable to join them, then:

* only one translator:
# just add their launchpad user as the Team on that page
* multiple translators:
# create a regular Launchpad team with a name like ''mahara-lang-es''
# change the team's owner to mahara-reviewers
# remove yourself from the list of active members
# add each translator's launchpad user as a member of the team
# go back to the Translation group and add the team as the maintainer.

===Update the master language pack location===

In mahara-scripts/mahara-langpacks/language-repos.txt, change the location for each language you imported to launchpad from gitorious to lp:mahara-lang.  The langpack list at http://langpacks.mahara.org will start pulling from launchpad instead of gitorious.

If you are starting a new translation in launchpad, hold off on updating this file until the translation is complete enough to be useful to someone, or users will waste time downloading and installing language packs with only a few translated strings.