Advance-topics/language-translation: Difference between revisions

From Snakeoil OS Reference
Jump to navigation Jump to search
No edit summary
No edit summary
 
(One intermediate revision by the same user not shown)
Line 3: Line 3:
Snakeoil is designed for the English Speaking population, however, this is only approximately 1.5 out of 7+ billion. To allow more people to use Snakeoil, the system is designed for internationalism support. The following three languages are currently supported:
Snakeoil is designed for the English Speaking population, however, this is only approximately 1.5 out of 7+ billion. To allow more people to use Snakeoil, the system is designed for internationalism support. The following three languages are currently supported:


* English (UK)
*English (UK)
* 中文 (简体)
*中文 (简体)
* 中文 (繁體)
*中文 (繁體)


We need your help to expand the list! Follow this simple documentation to translate the Snakeoil Web App to your language of choice and share it with the rest of the world.
We need your help to expand the list! Follow this simple documentation to translate the Snakeoil Web App to your language of choice and share it with the rest of the world.
Line 11: Line 11:
Please note that language translations only applies to the web interface. Internationalisation support in software players are still down to the respective developers.
Please note that language translations only applies to the web interface. Internationalisation support in software players are still down to the respective developers.


= Language Edtior =
=Language Edtior=
A language editor is included in the Snakeoil WebApp from v1.1.0 (Blind Testing) onwards. To start:
A language editor is included in the Snakeoil WebApp from v1.1.0 (Blind Testing) onwards. To start:


# Click on the ''System'' menu item to go to the System page
#Click on the ''System'' menu item to go to the System page
#  
#


you can invoke it in the ''System'' menu, under ''Customisation'' (The two little icons on the right hand side)
you can invoke it in the ''System'' menu, under ''Customisation'' (The two little icons on the right hand side)
[[File:System - custom.png|center|thumb|570x570px|Click on the tiny icons on the top right to edit existing language, or create a new language respectively]]


== Edit Current Translation ==
==Edit Current Translation==
The first icon on the left looks like a pen writing on a square sheet of paper. Click this button when you want to edit the currently selected language.
The first icon on the left looks like a pen writing on a square sheet of paper. Click this button when you want to edit the currently selected language.


For example, in the example below you'd be modifying the language file ''English (UK)'' if you click the button highlighted by the yellow square.
For example, in the example below you'd be modifying the language file ''English (UK)'' if you click the button highlighted by the yellow square.
 
[[File:System - langeditor edit.png|center|thumb|567x567px|Click on the edit button to edit existing language.]]
This is a partial screenshot of the language editor when you are editing a pre-existing language file. Notice that you cannot change the ''File name'' of a current language file when operating in this mode. You are free to update the text in Language. This field is used by the Snakeoil Web App when changing language.
This is a partial screenshot of the language editor when you are editing a pre-existing language file. Notice that you cannot change the ''File name'' of a current language file when operating in this mode. You are free to update the text in Language. This field is used by the Snakeoil Web App when changing language.
 
[[File:System - langedit edit current.png|center|thumb|1439x1439px|System - langedit edit current]]
The specifics of using the language editor will be discussed later at the end of this article.
The specifics of using the language editor will be discussed later at the end of this article.


== Create New Translation ==
==Create New Translation==
Click the 2nd icon (plus sign) to create a new translation.
Click the 2nd icon (plus sign) to create a new translation.
 
[[File:System - langeditor new.png|center|thumb|482x482px|Create A New Language]]
You'd need to provide a file name for the new language you're creating. This will be the physical filename that will be stored on the computer file system, and distributed with each release of the Snakeoil OS firmware. We recommend the use of WW3 country code. The ''Language Editor'' will not allow 2 translations for the same region. So if there is a name clash, just enter a number or a special code at the end (e.g. for American English, enter the code as en-US).
You'd need to provide a file name for the new language you're creating. This will be the physical filename that will be stored on the computer file system, and distributed with each release of the Snakeoil OS firmware. We recommend the use of WW3 country code. The ''Language Editor'' will not allow 2 translations for the same region. So if there is a name clash, just enter a number or a special code at the end (e.g. for American English, enter the code as en-US).
 
[[File:System - langedit create new.png|center|thumb|1441x1441px|Create New Language]]
As an example, to create an American English translation, you can use the following:
For example, to create an American English translation, you can use the following:
 
[[File:System - langedit - us english.png|center|thumb|505x505px|Creating New Language - US English]]
Once you've saved the file, the new language can be selected from the drop down box, like so:
Once you've saved the file, the new language can be selected from the drop down box, like so:
<br />
[[File:System - langedit - language selection.png|center|thumb|595x595px|New language created]]


== Using The Language Editor ==
==Using The Language Editor==
Once you are comfortable with the act of translation you can start and modify the files are you see fit. New translations will always use English as the default template. This is to avoid Chinese whispers (pun intended), i.e. translating from language X to Y, and then from Y to Z may result in undesirable consequences.
Once you are comfortable with the act of translation you can start and modify the files are you see fit. New translations will always use English as the default template. This is to avoid Chinese whispers (pun intended), i.e. translating from language X to Y, and then from Y to Z may result in undesirable consequences.


Please remember to click the ''Save Changes'' button at the end of the page to create the language file. Once you have created a new translation please download it and send it to the Snakeoil Squad. Refer to the next section for more details.
Please remember to click the ''Save Changes'' button at the end of the page to create the language file. Once you have created a new translation please download it and send it to the Snakeoil Squad. Refer to the next section for more details.


== Sending Your Translation To The Snakeoil Squad ==
==Sending Your Translation To The Snakeoil Squad==
You should see a white text book like this for every translation. Click on the download link to download the translation resource file (XML format), and then click on the Snakeoil Squad link for our email.Any questions please post in the forums.{{ManualNavigation|[[advance-topics|Advanced Topics]]|[[advance-topics/quick-start-guide|Quick Start Guide]]|[[advance-topics/native-dsd-support|Native DSD Support]]}}
You should see a white text book like this for every translation. Click on the download link to download the translation resource file (XML format), and then click on the Snakeoil Squad link for our email.Any questions please post in the forums.{{ManualNavigation|[[advance-topics|Advanced Topics]]|[[advance-topics/quick-start-guide|Quick Start Guide]]|[[advance-topics/native-dsd-support|Native DSD Support]]}}
[[Category:Advanced Topics]]

Latest revision as of 09:34, 30 July 2020

Music transcends time, borders and languages. Unfortunately, very little else has this super power.

Snakeoil is designed for the English Speaking population, however, this is only approximately 1.5 out of 7+ billion. To allow more people to use Snakeoil, the system is designed for internationalism support. The following three languages are currently supported:

  • English (UK)
  • 中文 (简体)
  • 中文 (繁體)

We need your help to expand the list! Follow this simple documentation to translate the Snakeoil Web App to your language of choice and share it with the rest of the world.

Please note that language translations only applies to the web interface. Internationalisation support in software players are still down to the respective developers.

Language Edtior

A language editor is included in the Snakeoil WebApp from v1.1.0 (Blind Testing) onwards. To start:

  1. Click on the System menu item to go to the System page

you can invoke it in the System menu, under Customisation (The two little icons on the right hand side)

Click on the tiny icons on the top right to edit existing language, or create a new language respectively

Edit Current Translation

The first icon on the left looks like a pen writing on a square sheet of paper. Click this button when you want to edit the currently selected language.

For example, in the example below you'd be modifying the language file English (UK) if you click the button highlighted by the yellow square.

Click on the edit button to edit existing language.

This is a partial screenshot of the language editor when you are editing a pre-existing language file. Notice that you cannot change the File name of a current language file when operating in this mode. You are free to update the text in Language. This field is used by the Snakeoil Web App when changing language.

System - langedit edit current

The specifics of using the language editor will be discussed later at the end of this article.

Create New Translation

Click the 2nd icon (plus sign) to create a new translation.

Create A New Language

You'd need to provide a file name for the new language you're creating. This will be the physical filename that will be stored on the computer file system, and distributed with each release of the Snakeoil OS firmware. We recommend the use of WW3 country code. The Language Editor will not allow 2 translations for the same region. So if there is a name clash, just enter a number or a special code at the end (e.g. for American English, enter the code as en-US).

Create New Language

For example, to create an American English translation, you can use the following:

Creating New Language - US English

Once you've saved the file, the new language can be selected from the drop down box, like so:

New language created

Using The Language Editor

Once you are comfortable with the act of translation you can start and modify the files are you see fit. New translations will always use English as the default template. This is to avoid Chinese whispers (pun intended), i.e. translating from language X to Y, and then from Y to Z may result in undesirable consequences.

Please remember to click the Save Changes button at the end of the page to create the language file. Once you have created a new translation please download it and send it to the Snakeoil Squad. Refer to the next section for more details.

Sending Your Translation To The Snakeoil Squad

You should see a white text book like this for every translation. Click on the download link to download the translation resource file (XML format), and then click on the Snakeoil Squad link for our email.Any questions please post in the forums.

 Main   Advanced Topics   Quick Start Guide   Native DSD Support