Changes

Jump to: navigation, search

Service/translate

7,192 bytes added, 21:47, 17 September 2018
no edit summary
* http://translate.sugarlabs.org/
 
== Hosted on ==
[[Machine/pootle]]
 
== Administrative contact ==
* [[User:SayaminduDasgupta|Sayamindu Dasgupta]] has system admin and Pootle admin privs.translate AT sugarlabs DOT org
== Sysadmins ==
* [[User:Cjl|Chris Leonard]] has Pootle administrator privFor non-emergency calls, preferably send email to the administrative contact.
== Sysadmins == * [[User:SayaminduDasguptaSebastian|Sayamindu DasguptaSebastian Silva]]has assumed maintainership tasks* [[User:TomeuCjl|Tomeu VizosoChris Leonard]]has Pootle administrator privs, and heads the localization efforts.* [[User:Bernie|Bernardo Bernie Innocenti]]has system admin and Pootle administrator privs, but takes care only of OS-level administration.* [[User:SayaminduDasgupta|Sayamindu Dasgupta]] is the former admin. He still has an emeritus sysadmin account and he can be very helpful if contacted by email.
== Language Administrators ==
More information on language administrator duties can be found on [[Translation_Team/Administration_QuickStart|this page]]
== Notes ==
 
{| class="wikitable"
|-
!scope="row" | Home
|{{Code|/var/lib/pootle}}
|-
!scope="row" | Daemon
|
{{Code|/etc/init.d/apache2}}<br>
{{Code|/etc/init.d/pootle}}
|-
!scope="row" | Logs
|{{Code|/var/log/apache2}}
|-
!scope="row" | Config
|
{{Code|/etc/apache2/sites-enabled/000-default}}<br>
{{Code|/etc/cron.d/pootle}}<br>
|-
!scope="row" | Ports
|
{{Code|80}} HTTP server
|-
|}
 
== Upgrade notes ==
 
*A backup of the DB and pootle localsettings.py must be done also.
*Backup of the /var/lib/pootle structure
*New versions of Django and Translate toolkit must be installed first
*Restore localsettings and DB backup
 
== Mantainance Notes ==
 
Pootle in Sugar is maintained. (icarito has step-up to be maint)
 
== Migrated to Pootle 2.5.0 ==
 
Notes on the process were recorded here: [[Service/translate/Pootle2.5]]
 
== Files ==
 
Important files and directories in the root directory, {{Code|/var/lib/pootle}}.
 
{{Code|'''checkouts'''}}<br>
Sources are checked out in this directory and being used to keep final {{Code|.pot}} and {{Code|.po}} files. The hierarchy is:
 
checkouts/''pootle-project''/''pootle-po-filename-without-po-suffix''/''sources''
 
{{Code|'''translations'''}}<br>
Pootle uses this directory as a sources of files to translate, it contains symlinks to files from the {{Code|checkouts}} directory. The hierarchy is:
 
translations/''pootle-project''/''lang''/''symlinks-to-po-files''
 
{{Code|'''maintenance'''}}<br>
Contains some sugar-specific scripts to help maintain our Pootle instance, they are managed in http://git.sugarlabs.org/projects/pootle-helpers.
 
{{Code|'''maintenance/helpers/potupdater/project_list.ini'''}}<br>
This is an Ini file that contains configuration for all used sources repositories. Each section describes one sources repository, where section name is full path, in form of {{Code|/var/lib/pootle/checkouts/''pootle-project''/''pootle-filename''/''some-path-within-sources''/''pot-file''}}, to the {{Code|.pot}} file, and contains following options:
 
* {{Code|project}} required, meaning-less project name;
* {{Code|vcs}} required, the type of VCS for; supported values are: {{Code|git}};
* {{Code|method}} required, the method how to generate {{Code|.pot}} files from sources; supported values are: {{Code|bundlebuilder}} for activities, {{Code|intltool}} for intltool based projects;
* {{Code|layout}} required, ?;
* {{Code|ignore-files}} optional, the semicolon separated list of file paths that are relative to the sources root; if {{Code|method}} is {{Code|bundlebuilder}} this value will be used to ignore while producing {{Code|.pot files}};
 
== Tools ==
 
* {{Code|potupdater/pogenerator.py}} pulls from git and svn so we have updated sources, then it generates a new .pot file from them. Translated strings get reflected in the .po files in each module, and when the language maintainer clicks the Commit to VCS link, get pushed back to the upstream module.
* {{Code|admin/pootlepopulator.py}} checkout sources.
* {{Code|misc/pootle.cron}} all daily basis routines.
* ''...''
 
== Tips ==
 
=== Create new Pootle project ===
 
* Create new project in Pootle admin menu, ''admin->projects'';
* Add all needed langs;
* Checkout all sources using command:
 
sudo -u pootle -i python maintenance/helpers/admin/pootlepopulator.py ''pootle-project'' ''git-clone-url'' ''pootle-filename-wo-po-suffix'' ''git-branch''
 
Example:
 
To checkout the sugar in the branch sucrose-0.94 (in pootle is in the project glucose94) we sshould do:
 
cd /var/lib/pootle/
sudo -u pootle -i python maintenance/helpers/admin/pootlepopulator.py glucose94 gitorious@git.sugarlabs.org:sugar/mainline.git sugar sucrose-0.94
 
* Add new sections to the [[#Files|project_list.ini]] file to describe new {{Code|.pot}} locations;
* Run {{Code|misc/pootle.cron}} script from {{Code|pootle}} user to generate all sufficient files;
* Click ''rescan the project files'' in ''Templates->Project->Files'' to reveal newly created {{Code|.pot}} files;
* Click ''Update from templates'' for all languages in newly created project to peek up {{Code|.po}} files symlinked by {{Code|misc/pootle.cron}} script.
 
=== Adding activities ===
 
Before registering new activity on http://translate.sugarlabs.org, make sure that:
 
* New activity is being hosted on http://git.sugarlabs.org;
* The {{Code|pootle}} user was added to the repository with commit access rights;
* You have a proper {{Code|GIT_URL}} to clone repository from with commit permissions, e.g., {{Code|gitorious@git.sugarlabs.org:cartoon-builder/mainline.git}}; that might be found on home page in Gitorious, e.g., http://git.sugarlabs.org/cartoon-builder, in ''Clone & push urls'' field with selector ''SSH'';
* You know the proper {{Code|CATEGORY}} name to register the project in;
* There is an unique {{Code|NAME}} of activity, this name will be used as a name of project in Pootle and directory name;
* You know the proper {{Code|BRANCH}} in Git repository to use for translation; by default, it is {{Code|master}}.
 
To process the registration, login to translate.sugarlabs.org and enter:
 
sudo -u pootle python /var/lib/pootle/maintenance/helpers/admin/pootlepopulator.py ''<CATEGORY>'' ''<GIT_URL>'' /var/lib/pootle/checkouts/''<CATEGORY>''/''<NAME>'' [''<BRANCH>'']
 
After that, for [http://git.sugarlabs.org/pootle-helpers pootle-helper] project in {{Code|potupdater/project_list.ini}}, add the following strings:
 
[/var/lib/pootle/checkouts/''<CATEGORY>''/''<NAME>''/po/''<.pot-filename>'']
project = ''<NAME>''
vcs = git
method = bundlebuilder
layout = gnu
 
Commit new changes, and pull from on pootle VM:
 
(cd /var/lib/pootle/maintenance/helpers; sudo -u pootle git pull origin master)
 
Do ''update from templates'' on the ''templates'' project on Pootle's frontend. And wait until daily cron job will populate languages for newly registered project, or run it immediately:
 
sudo -u pootle python /var/lib/pootle/maintenance/helpers/admin/add_langs.py
 
Then your activity must be in place to be translated and ''commit to VCS/update from VCS'' links must be activated.
 
=== Working with git in the pootle server ===
 
The git operations must be done by the pootle user:
 
sudo -u pootle git log
 
sudo -u pootle git push origin sucrose-0.82
 
This script tell you when you can update different clones of activities, when new strings are added via gettext in each repo.
 
/var/lib/pootle/maintenance/helpers/potupdater/check_unmerged_translations.sh
 
Other important script is pogenerator.py this script re-generates pot in each repo.
== Notes = Resolving conflicts ===  If the maintainer did a commit with a file in the po directory we will have a conflict, and Pootle can not do a pull. Pootle build the pot file from the sources, if we compare and the translations are updated in pootle we can do a pull preserving the info in pootle:  sudo -u pootle git pull -s ours === Checking that pootle is working ===
How * When commiting from pootle interface, repos in git reflect the commit as something similar to manipulate users: pootle pushed 3fd0cf7b to taportfolio/mainline:master on March 04, 2011 01:32 Commit from Sugar Labs: Translation System by user cjl.: 2 of 25 messages translated (0 fuzzy).
django-admin shell --settings=pootle* Pogenerator.settingspy (in cronjob), it's also giving mails with info like: >>> from django.contrib.auth.models import User >>> u = User.objects.get(username='bernie') >>> uAlready up-to-date.is_superuser = Trueor >>> u.save####### Checking POT for Write (master)######
=== Etoys .pot update ===
Various scripts documented hereGo to Etoys translation directory (that is svn checkout from upstream project):
http://git.sugarlabs.org su - pootle cd ~/projectstranslations/pootle-helpersetoys_new
Scheduled jobsSince there is no need in changing .pot files on Pootle level, revert local changes if they present:
pootle@pootle:~$ crontab -l MAILTO="sayamindu@sugarlabs.org" # m h dom mon dow command 30 00 * * * /usr/bin/python /var/lib/pootle/maintenance/helpers/potupdater/pogenerator.py /var/lib/pootle/maintenance/helpers/potupdater/project_list.ini #00 00 * * * git --git-dir=/var/lib/pootle/checkouts/etoys/.git pull 45 00 * * * python /var/lib/pootle/langpackgen/src/LangPackGen/pack_generator.py /var/lib/pootle/langpackgen/data/langpackgen_84.ini /var/lib/pootle/public_html/packssvn revert templates/0.84 40 00 * * * python /var/lib/pootle/langpackgen/src/LangPackGen/pack_generator.py /var/lib/pootle/langpackgen/data/langpackgen_82.ini /var/lib/pootle/public_html/packs/0.82pot
Refresh stats, needed when Fetch new update from the database and the checked out modules get out of syncupstream:
/usr/lib/python-django/bin/django-admin.py refresh_stats --settings=pootle.settingssvn up templates
Important directories:=== Tips ===
'''checkouts'''* How to manipulate users: modules are checked out in this directory. pogenerator.py pulls from git and svn so we have updated sources, then it generates a new .pot file from them. Translated strings get reflected in the .po files in each module, and when the language maintainer clicks the Commit to VCS link, get pushed back to the upstream module.
django-admin shell --settings=pootle.settings >>> from django.contrib.auth.models import User >>> u = User.objects.get(username='bernie''dbs''': internal db used by Pootle, no need to mess directly with it) >>> u.is_superuser = True >>> u.save()
'''maintenance''': contains some sugar-specific scripts to help maintain our Pootle instance* Refresh stats, they are managed in httpneeded when the database and the checked out modules get out of sync://git.sugarlabs.org/projects/pootle-helpers
'''po''': contains xapian indexes for the search feature sudo -u pootle django-admin refresh_stats --settings=pootle.settings
* If you have a commit error file because of only read git url, please rm the old '''translations/var/lib/pootle/checkouts/''': more Pootle internal datafiles related with that activity or project and re run pootlepopulator.
== Upgrade notes ==* Also if there are errors related with git add, is likely that some lang.po files are not versionated on pootle server, please run '''git add .''' inside the activity or project.
* When there are '''commit to cvs/update to cvs''' links missing in activities or projects please check git url in .git/config , this URL must be writable by pootle.
== See Also References ==
* http://translate.sourceforge.net/wiki/pootle/installation
* http://lists.laptop.org/listinfo/localization
* http://git.sugarlabs.org/pootle-helpers
* /usr/lib/python2.6/dist-packages/translate/storage/versioncontrol/git.py (Translate)
[[Category:Service|translate]]

Navigation menu