Translations: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>UNiversal
mNo edit summary
mNo edit summary
(28 intermediate revisions by 6 users not shown)
Line 1: Line 1:
== General ==
{{mininav|[[Development]]{{l2|[[Add-on development]]}}}}
 
{{see also|Add-on development}}
 
== History ==
In the development cycle from Eden (V11) to Frodo (V12) the translation system has been revised.  
In the development cycle from Eden (V11) to Frodo (V12) the translation system has been revised.  


The former strings.xml file has been superseeded by the appropriate strings.po files.
The former strings.xml file has been superseeded by the appropriate strings.po files. Due to that the way how translations are handled has been changed, too.
Due to that the way how translations are handled has been changed, too.


== Transifex ==
== Transifex ==
The whole translation system has been moved to [http://www.transifex.net Transifex].
The whole translation system has been moved to [http://www.transifex.net Transifex].
So if you want to help translating XBMC into your native language, first thing you need to do is to sign up at Transifex.
So if you want to help translating Kodi into your native language, first thing you need to do is to sign up at Transifex.




Next Step would be to check the current project for XBMC. Currently it is this one:
Next Step would be to check the current project for XBMC. Currently it is this one:


[https://www.transifex.net/projects/p/XBMC-Main-Frodo/ XBMC Main Translation Project (Frodo)]
[https://www.transifex.com/projects/p/xbmc-addons/ Add-on Translation Project]
[https://www.transifex.com/projects/p/kodi-main/ Main Translation Project]
[https://www.transifex.com/projects/p/xbmc-skins/ Skin Translation Project]




Line 18: Line 23:




[[File:Lang_overview.png]]
[[File:Lang overview.png|900px]]




Line 24: Line 29:




[[File:Join.png]]
[[File:Join.png|900px]]


The appropriate coordinator of your language will approve or deny your request.
The appropriate coordinator of your language will approve or deny your request.
Line 30: Line 35:
By approval you can start translating immediately.
By approval you can start translating immediately.


Currently this project is for core XBMC only! So no third party addons or stuff like that!
Currently this project is for core Kodi only! So no third party addons or stuff like that!


This will follow later on. So stay tuned in the [http://forum.xbmc.org/forumdisplay.php?fid=90 appropriate forums section for translations]
This will follow later on. So stay tuned in the [http://forum.kodi.tv/forumdisplay.php?fid=90 appropriate forums section for translations]


== Translating XBMC ==
== Translating Kodi ==
''Note: Please do not download files, modify them and upload again! Always use the "Translate Now" Button!''
''Note: Please do not download files, modify them and upload again! Always use the "Translate Now" Button!''


Line 41: Line 46:
Search that part of the project that needs updating. You can see the percentage of the translations to the right:
Search that part of the project that needs updating. You can see the percentage of the translations to the right:


[[File:Select_ressource.png]]
[[File:Select ressource.png|900px]]


You might note that there is something missing in "visualisation milkdrop". So we click on it to translate it.
You might note that there is something missing in "visualisation milkdrop". So we click on it to translate it.
Line 47: Line 52:
The red marked area is button mentioned before. Always use this one!
The red marked area is button mentioned before. Always use this one!


[[File:Translate_now.png]]
[[File:Translate now.png|900px]]


Check the missing strings on the right side. After you completed them hit the "Save and Exit" button down on the left.
Check the missing strings on the right side. After you completed them hit the "Save and Exit" button down on the left.


[[File:Translating_string.png]]
[[File:Translating string.png|900px]]


== Useful hints ==
== Useful hints ==
Line 61: Line 66:
Additionaly there is a field for the occurence which shows in which file this strings is mentioned. You get these info by hovering over the buttons of the source strings.
Additionaly there is a field for the occurence which shows in which file this strings is mentioned. You get these info by hovering over the buttons of the source strings.


[[File:Details.png]]
[[File:Details.png|900px]]




In the source file it looks like this:
In the source file it looks like this:
<source lang="xml">
<syntaxhighlight lang="xml" enclose="div">
#. play GUI sounds
#. play GUI sounds
#: xbmc/settings/GUISettings.cpp
#: xbmc/settings/GUISettings.cpp
Line 71: Line 76:
msgid "Always"
msgid "Always"
msgstr ""
msgstr ""
</source>
</syntaxhighlight>




Line 81: Line 86:
Another useful feature is the discussion board for the team. That way you can can speak about issues or just state some suggestions. You can get in conteact with other team members or the coordinator.
Another useful feature is the discussion board for the team. That way you can can speak about issues or just state some suggestions. You can get in conteact with other team members or the coordinator.


[[File:Discussion.png]]
[[File:Discussion.png|900px]]


''NOTE: This board is not for off-topic discussions! Everything besides translations should be disucussed on the forums!''
''NOTE: This board is not for off-topic discussions! Everything besides translations should be disucussed on the forums!''


== Addons ==
== Addons/Skins ==
Currently this part is under construction as there will be another project for 3rd party addons later on.
The process is the same for third-party addons/skins, except they are hosted at a different Transifex link.
For current links please visit [http://forum.kodi.tv/showthread.php?tid=141158 this] thread.


== Contact ==
== Contact ==
Line 96: Line 102:
== Sync time schedule ==
== Sync time schedule ==
We plan to make regular sync procedures from XBMC-master to Transifex weekly and from Transifex to XBMC-master monthly at the last week of the month.
We plan to make regular sync procedures from XBMC-master to Transifex weekly and from Transifex to XBMC-master monthly at the last week of the month.
For addons we do more frequent updates, with 2-3 syncs a week.
== Syntax verification ==
For keeping the strings correctly formatted, we do a constant syntax verification at each sync occasions. The results are in sync syntax-check logs. Please check these links regularly if you find any problems for your language. The following logs are available:
* The kodi-main [https://github.com/xbmc/translations/blob/master/kodi-translations/kodi-main/txupdate-syntax.log syntax-check log]
* The xbmc-addons: [https://github.com/xbmc/translations/blob/master/translations/addons/txupdate-syntax.log syntax-check log]
* The xbmc-skins: [https://github.com/xbmc/translations/blob/master/translations/xbmc-skins/txupdate-syntax.log syntax-check log]
For more info on syntax checking, please check out [http://forum.kodi.tv/showthread.php?tid=152720 this] thread!


[[Category:Development|T]]
[[Category:Development|T]]
[[category:Languages]]
[[Category:Languages]]
[[Category:Team Kodi specific notes]]

Revision as of 18:22, 26 October 2018

Home icon grey.png   ▶ Development
▶ Add-on development
▶ Translations

History

In the development cycle from Eden (V11) to Frodo (V12) the translation system has been revised.

The former strings.xml file has been superseeded by the appropriate strings.po files. Due to that the way how translations are handled has been changed, too.

Transifex

The whole translation system has been moved to Transifex. So if you want to help translating Kodi into your native language, first thing you need to do is to sign up at Transifex.


Next Step would be to check the current project for XBMC. Currently it is this one:

Add-on Translation Project Main Translation Project Skin Translation Project


On that page you should see the available languages that can be translated:


Lang overview.png


Check your native language and request to join the translation team. In this example I choose Greek:


Join.png

The appropriate coordinator of your language will approve or deny your request.

By approval you can start translating immediately.

Currently this project is for core Kodi only! So no third party addons or stuff like that!

This will follow later on. So stay tuned in the appropriate forums section for translations

Translating Kodi

Note: Please do not download files, modify them and upload again! Always use the "Translate Now" Button!

Ok, let's get to work!

Search that part of the project that needs updating. You can see the percentage of the translations to the right:

Select ressource.png

You might note that there is something missing in "visualisation milkdrop". So we click on it to translate it.

The red marked area is button mentioned before. Always use this one!

Translate now.png

Check the missing strings on the right side. After you completed them hit the "Save and Exit" button down on the left.

Translating string.png

Useful hints

This part shows some additional information for developers and translators to make things more easy. So it's worth taking a look.


Details & Comments

The developers can set special marks in the strings.po file to give a useful comment on that string. e.g. what it exactly does or where it can be found in the GUI. Additionaly there is a field for the occurence which shows in which file this strings is mentioned. You get these info by hovering over the buttons of the source strings.

Details.png


In the source file it looks like this:

#. play GUI sounds
#: xbmc/settings/GUISettings.cpp
msgctxt "#34122"
msgid "Always"
msgstr ""


With #. we can add a helper comment or context to help translators understand the meaning or usage of string.

with #: we can specify where the string is used. Sometimes this could also be a useful info.

Group Discussion

Another useful feature is the discussion board for the team. That way you can can speak about issues or just state some suggestions. You can get in conteact with other team members or the coordinator.

Discussion.png

NOTE: This board is not for off-topic discussions! Everything besides translations should be disucussed on the forums!

Addons/Skins

The process is the same for third-party addons/skins, except they are hosted at a different Transifex link. For current links please visit this thread.

Contact

If you have problems with Transifex your first person to contact should be the coordinator of your language!

If you have more general questions you might head over to the forums and post your question in the translation are there. Alanwww1 and others can help you there.

Sync time schedule

We plan to make regular sync procedures from XBMC-master to Transifex weekly and from Transifex to XBMC-master monthly at the last week of the month. For addons we do more frequent updates, with 2-3 syncs a week.

Syntax verification

For keeping the strings correctly formatted, we do a constant syntax verification at each sync occasions. The results are in sync syntax-check logs. Please check these links regularly if you find any problems for your language. The following logs are available:

For more info on syntax checking, please check out this thread!