Evergreen translations are currently hosted on Launchpad translations. This wiki page will document the basic steps for setting up a new series translation target.

1. Install Bazaar:

   sudo apt-get install bazaar

2. Setup your bzr account details:

   bzr whoami “FirstName LastName <email@address>”

3. Set launchpad login (replace "launchpadusr" with actual LP username):

   bzr launchpad-login launchpadusr

THIS SECTION IS OBSOLETE: Launchpad can import branches from Evergreen's Git repo all by itself

1. Install bzr-git package (if available):

   sudo apt-get install bzr-git

2. Clone git repo branch via bzr:

   bzr branch git://git.evergreen-ils.org/Evergreen.git,branch=rel_2_12

3. Push new bzr clone to Launchpad:

   cd rel_2_12 ; bzr push lp:~launchpadusr/evergreen/rel_2_12

4. Also, setup a new translation-export bzr branch (TBD)

THIS SECTION IS OBSOLETE: Launchpad can do the syncing automatically nowadays

Example crontab entries:

# update local rel_2_12 at 10:00 pm every day
0 22 * * * cd ~/rel_2_12 ; bzr pull > /dev/null 2>&1

# push to launchpad at 10:10 pm every day
10 22 * * * cd ~/rel_2_12 ; bzr push lp:~launchpadusr/evergreen/rel_2_12 > /dev/null 2>&1

TODO: Cleanup these instructions

1. In Launchpad translations site, go to area for "Set up translations for a series"
2. Click on the series you want to have setup and choose "automatic import" link
3. Click the link for "Set it now!" next to the text "This series does not have an official Bazaar branch."
4. Link to a Bazaar branch already on Launchpad like "~launchpadusr/evergreen/rel_2_12"
5. Also set the export translations to a branch option with "Choose a target branch" and link to the translation-export branch setup previously for a given series.

1. View Bazaar branches: https://code.launchpad.net/evergreen/+branches
2. Import a branch
   1. Owner: evergreen-bugs
   2. Name: rel_3_8
   3. Git: git://git.evergreen-ils.org/Evergreen.git,branch=rel_3_8
   4. dest source control is bzr
   5. then request the import and wait for to complete
3. After import done, go to overview for Evergreen in Launchpad, select the corresponding series, configure series branch, then point at the new branch you just created
4. Create a bzr checkout:
   1. bzr branch lp:evergreen/3.8
   2. cd 3.8
5. then push to a new translation-export branch
   1. bzr push lp:~evergreen-bugs/evergreen/translation-export-3.8
6. Now we have a place for LP to send translation exports
7. Go to translations
8. Choose to do an automatic export for the series
   1. by registering the branch for the series, it recognizes it, so we only need to set the settings
      1. import template and translation
      2. set the translations export branch created earlier
9. may need to request a one-time import to get it kicked off
   1. may need to wait a day