- Quick Start Guide
- Native DSD Support
This is outdated. Will be revised soon.
Snakeoil is now multi-lingual. The following languages are available:
- English (UK)
- 中文 (简体)
- 中文 (繁體)
And the Snakeoil Squad needs your help to expand the above list! Please follow this simple documentation to translate Snakeoil to your language of choice. (Please note that language translations only applies to the web interface and not the underlying software players)
This article assumes you are using the English language as you edit/create your translations. Please use the equivalent text if your Snakeoil system is set to another language.
Viewing/Editing Existing Translations
You need to invoke the Language Editor to look at or modify the translations. This is located in the System tab, under Customisation.Click on the Language Editor button to start. The Language Editor looks something like this:Click the drop down box labeled Current Language at the top of the Language Editor to browse a list of available languages (see above picture). Select any language from this list to see it's translation. The last option (New language) is for adding a new translation.
Each translated language has it's unique language code (a read only attribute). The translations will be instantly loaded from the section beginning with metadata and on wards. The translation texts are "logically grouped", it is advised that you go through the list of items briefly, and work out where they are in the web interface, before performing a translation.
Once you are comfortable with the act of translation you can start and modify the files are you see fit. The input fields are expandable if you need more space. To expand the box simply drag the triangle on the lower right corner with your mouse to the required size. Once you have made all the necessary changes, scroll down to the bottom of the page and click the Save Changes button to save your translation. Or click the Back button to exit the Language Editor (Any modifications will be abandoned). If everything works as expected you should see the following message after a save. The translations will appear on your Snakeoil machine immediately.
Please send all your modified translations to the Snakeoil Squad so we can roll it for the next release. Refer to the last section on how to submit your modifications to us.
Creating A New Translation
To create a new translation, click on the Current Language drop down box and scroll down till you reached the last item - New language.Once selected you'd notice the Language Code is now a editable field, enter the ISO language code for your translation in this field (e.g. en is English, zh is Chinese). You can refer to this WW3 webpage for a complete list of codes.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).
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.