User Tools

Site Tools


i18n:setting_up_a_new_series_translation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
i18n:setting_up_a_new_series_translation [2023/05/03 12:58] – [WIP: updating the instructions] gmcharltoni18n:setting_up_a_new_series_translation [2024/05/23 17:11] (current) – Introducing screenshots to illistrate configure branch bmagic
Line 1: Line 1:
-====== Setting up a new series translation in Launchpad ======+======= Setting up a new series translation in Launchpad =======
  
-Evergreen translations are currently hosted on [[https://translations.launchpad.net/evergreen|Launchpad translations]]. This wiki page will document the basic steps for setting up a new series translation target.+Evergreen translations that involve PO and POT files are currently hosted on [[https://translations.launchpad.net/evergreen|Launchpad translations]]. (Translations for the Angular staff interface are managed using POEditor). This wiki page will document the basic steps for setting up a new series translation target.
  
 +====== Prerequisites ======
 +
 +===== Launchpad Permissions =====
 +
 +In order to perform these steps, you must have the following privileges in Launchpad:
 +
 +  - Be a member of the [[https://launchpad.net/~evergreen-release|Evergreen Release Team]] team. This is needed in order to attach a bzr branch to the code series and designate branches to import from and export to for the strings.
 +  - Be a member of the [[https://launchpad.net/~evergreen-bugs|Evergreen Bugs]] team. This is needed in order to create bzr branches owned by the evergreen-bugs team to follow the naming convention set up by this procedure.
 ===== Install and setup Bazaar ===== ===== Install and setup Bazaar =====
  
Line 9: Line 17:
   - Set launchpad login (replace "launchpadusr" with actual LP username): <code>bzr launchpad-login launchpadusr</code>   - Set launchpad login (replace "launchpadusr" with actual LP username): <code>bzr launchpad-login launchpadusr</code>
  
-===== Use bzr-git to clone Evergreen git branch ===== 
  
-  - Install bzr-git package (if available): <code bash>sudo apt-get install bzr-git</code> +====== Procedure ======
-  - Clone git repo branch via bzr: <code bash>bzr branch git://git.evergreen-ils.org/Evergreen.git,branch=rel_2_12</code> +
-  - Push new bzr clone to Launchpad: <code bash>cd rel_2_12 ; bzr push lp:~launchpadusr/evergreen/rel_2_12</code> +
-  - Also, setup a new translation-export bzr branch (TBD)+
  
-===== Setup cron job to sync things ===== +This procedure uses Evergreen 3.11 as an example. When implementing this procedure, replace **rel_3_11** and **3.11** with values appropriate to the series that you are setting up.
- +
-Example crontab entries:<code> +
-# update local rel_2_12 at 10:00 pm every day +
-0 22 * * * cd ~/rel_2_12 ; bzr pull > /dev/null 2>&+
- +
-# 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>&+
-</code> +
- +
-===== Setup Launchpad translation for series ===== +
- +
-TODO: Cleanup these instructions +
- +
-  - In Launchpad translations site, go to area for "Set up translations for a series" +
-  - Click on the series you want to have setup and choose "automatic import" link +
-  - Click the link for "Set it now!" next to the text "This series does not have an official Bazaar branch.+
-  - Link to a Bazaar branch already on Launchpad like "~launchpadusr/evergreen/rel_2_12" +
-  - 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. +
- +
-====== WIP: updating the instructions ======+
  
   - View Bazaar branches: https://code.launchpad.net/evergreen/+branches   - View Bazaar branches: https://code.launchpad.net/evergreen/+branches
- - Import a branch+ - Import a branch {{translations_import_branch.png}}
  - Owner: evergreen-bugs  - Owner: evergreen-bugs
- - Name: rel_3_8 + - Name: **rel_3_11** 
- - Git: [[git://git.evergreen-ils.org/Evergreen.git,branch=rel_3_8]] + - Git: [[git://git.evergreen-ils.org/Evergreen.git,branch=rel_3_11]] 
-dest source control is bzr +Target source control is bazaar {{translations_options.png}} 
- - then request the import and wait for to complete+ - then request the import and wait for to complete {{translations_processing.png}}
  - 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  - 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
 + - {{:i18n:1lp_configure_branch.png?400|}}
 + - {{:i18n:2lp_spyglass.png?400|}}
 + - {{:i18n:3lp_search_branch.png?400|}}
 + - {{:i18n:4lp_click_update.png?200|}}
  - Create a bzr checkout:   - Create a bzr checkout: 
- - bzr branch lp:evergreen/3.8 +<code>bzr branch lp:evergreen/3.11</code> 
- - cd 3.8+<code>cd 3.11</code>
  - then push to a new translation-export branch  - then push to a new translation-export branch
- - bzr push lp:~evergreen-bugs/evergreen/translation-export-3.8+<code>bzr push lp:~evergreen-bugs/evergreen/translation-export-3.11</code>
   - Now we have a place for LP to send translation exports   - Now we have a place for LP to send translation exports
- - Go to translations + - Go to translations https://translations.launchpad.net/evergreen 
- - Choose to do an automatic export for the series+ - Choose to do an automatic export for the series {{:i18n:screenshot_2023-05-05_175041.png?nolink&400}}
  - by registering the branch for the series, it recognizes it, so we only need to set the settings  - by registering the branch for the series, it recognizes it, so we only need to set the settings
  - import template and translation   - import template and translation 
- - set the translations export branch created earlier + - set the translations export branch created earlier {{translations_sync_settings.png}} 
- - may need to request a one-time import to get it kicked off +Once the translation automatic sync is set up, you may need to wait for up to a day for the imports and exports to run for the first time. 
- - may need to wait a day+
  
i18n/setting_up_a_new_series_translation.1683133089.txt.gz · Last modified: 2023/05/03 12:58 by gmcharlton

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki

© 2008-2022 GPLS and others. Evergreen is open source software, freely licensed under GNU GPLv2 or later.
The Evergreen Project is a U.S. 501(c)3 non-profit organization.