Transifex translation service with YOUR addon

  Thread Rating:
  • 0 Votes - 0 Average
  • 1
  • 2
  • 3
  • 4
  • 5
Post Reply
alanwww1 Offline
Team-Kodi Member
Posts: 1,364
Joined: Nov 2008
Reputation: 33
Location: Hungary
Exclamation  Transifex translation service with YOUR addon
Post: #1
Dear addon, skin developers !

As you might already know, XBMC has moved translations handling to a great web based translation system called Transifex lately for the Frodo release. This turned out to work really awesome with the help of our regular and a lot of new translators.

Translators would love to translate the addons and skins as well. Team XBMC would like to help the developement with providing and maintaining the same translation infrastructure, what we use for XBMC core, to YOUR addons and skins.

With this system, handling of language files for your addon becomes much more simple, because you won't have to deal with pulling translations to your upstream addon repository language-by-language, monitoring the mailing list anymore.

All you have to do is provide some basic data of your upstream repository (where the fresh English language file resides) and you can easily pull in fresh translations from time to time, (or before bumping release) from XBMC's official translations github repositories for addons and skins.

These repositories are always kept in sync with the translation work going on transifex.net. This work is done by Team-XBMC, just like we do it with XBMC-core and internal addon language files.

Along with user friendliness, one really awesome thing about Transifex is that translators will be able to use the translation memory created with the core language file and the internal addons. So they can check how a special term was already translated.

So how can you participate? It is really easy!
(If you don't know how to get this data for your addon, just send an email to alanwww1 and he will help you.)

What we need for getting things working, is an email for start (and when this data changes for some reason) on the xbmc-addons mailing list in the following form:

Email Subject:
[lang][addon data] my cool addon

Email Body
*addon - my.cool.addon
*httpurl - http://some.where/master/
*xbmc version - Dharma, Eden, Frodo is ALL supported (for Eden, Dharma we can create XML files)
*upstream langs - languages that might be updated upstream, along with the English file

Where:
httpurl is the URL of which can be reached via http and points to your English file.
For example, the URL for internal addon visualization.milkdrop is https://raw.github.com/xbmc/xbmc/master/...strings.po

A few things to note:
  • The old XML file format language files will be kept for addons that need backward compatibility.
  • For the Frodo only addons, language files will be converted to gettext PO file format. Just pull in these files and you can delete the old xml ones right after that. We will introduce new possibilities (eg. plurals handling) to PO file format later after Frodo is out.
  • The English PO (XML) file MUST always be updated with any new strings. Any ID that is not in the English file will be DELETED from the other language files.
  • If you want OUR work to be a little easier, use Github for your project. It has a great API which our sync utility can use.
  • Please, with any questions write to alanwww1 instead the mailing list. This list should only receive the emails described above. Or just use the translation forum if the subject is of public interest.

Waiting for your emails, thank you,
Team XBMC

Edit: There is also a download tool ready to help pulling in the fresh translations.

Always read the XBMC online-manual, FAQ and search the forum before posting.
Do not e-mail XBMC-Team members directly asking for support. Read/follow the forum rules.
For troubleshooting and bug reporting please make sure you read this first.
(This post was last modified: 2012-12-27 01:18 by alanwww1.)
find quote
takoi Offline
Team-Kodi Member
Posts: 799
Joined: Oct 2009
Reputation: 12
Location: Norway
Post: #2
(2012-10-14 16:35)alanwww1 Wrote:  With this system, handling of language files for your addon becomes much more simple, because you won't have to deal with pulling translations to your upstream addon repository language-by-language, monitoring the mailing list anymore.

All you have to do is provide some basic data of your upstream repository (where the fresh English language file resides) and you can easily pull in fresh translations from time to time, (or before bumping release) from XBMC's official translations github repositories for addons and skins.

Do we have to pull translations or not? I guess yes. And what happens to the strings in addon.xml?
find quote
alanwww1 Offline
Team-Kodi Member
Posts: 1,364
Joined: Nov 2008
Reputation: 33
Location: Hungary
Post: #3
Yes, the only thing I ask from addon developers is to pull in the files from time-to-time but of course you don't have to do it language by language with all small changes. Just a bulk copy of the files to your upstream repo.

I really have no time to individually make pull requests for each addon, so please pull in the langauge files and the addon.xml file as well.

Thanks, cheers !

Always read the XBMC online-manual, FAQ and search the forum before posting.
Do not e-mail XBMC-Team members directly asking for support. Read/follow the forum rules.
For troubleshooting and bug reporting please make sure you read this first.
find quote