----
==  This process turned out to be much too complicated and error prone. 3rd party GUI translations are now done at [http://i18n.kacperkasper.pl Polyglot] ==
----


This document outlines how to manage a new project at [https://i18n.haiku-os.org/pootle/projects/3rd_party/ the pootle site]. Esp. how to manage the "3rd party apps" project there.


== How to add a pootle project: ==

1. For each language, create the folder/subfolder hierarchy of the apps together with their respective catkeys and zip it up.[[BR]]
  The zip for English would look like this, e.g:

{{{
unzip -l English.zip 
Archive:  English.zip
  Length      Date    Time    Name
---------  ---------- -----   ----
        0  04-06-2017 09:03   App-1/
    11545  03-30-2017 17:33   App-1/en.catkeys
        0  04-06-2017 09:04   App-2/
     5974  03-30-2017 17:34   App-2/en.catkeys
---------                     -------
    17519                     4 files
}}}

1.5. '''!Important! ''' Only for English: prepare the en.catkeys with a script to remove the translated string, i.e. the last column in the catkeys.

  Script 'pootle-en.catkeys.sh':

{{{
for i in `find . -name en.catkeys`; do
	sed -i -e '2,$s/[^\t]*$//g' "$i"; done
}}}

2. Enter the English language.
3. Upload the English zip.
4. Go to "''Administrate''" of the project and "''Update against templates''" all languages.
5. Enter all those languages at the pootle site and upload the zip with that language's catkeys, if available.


== How to update catkeys: ==

Just like when adding the project. Of course only update the original en.catkeys ('''after running them through the script! ''').[[BR]]
When uploading the zip, choose "''Overwrite the current file if exists''".[[BR]]
Then go to "''Administrate''" of the project and "''Update against templates''" all languages.


== How to add another app to the project: ==

Like when adding the project, make sure the zip contains the whole file hierarchy with the already existing project folders. '''Those folders have to be empty! '''[[BR]]
The zip adding a "New-App" for English would look like this, two empty folders for the existing apps, one folder with the en.catkeys for the new app:

{{{
unzip -l New-App.zip 
Archive:  New-App.zip
  Length      Date    Time    Name
---------  ---------- -----   ----
        0  04-06-2017 09:05   App-1/
        0  04-06-2017 09:05   App-2/
        0  04-06-2017 09:05   New-App/
     5974  03-30-2017 17:34   New-App/en.catkeys
---------                     -------
     5974                     4 files
}}}

When uploading, choose "''Merge''" option.


== How to export an app's catkeys: ==

Just enter the app and "''Download''" a zip with all languages.