Localization

Musician and its plugins MusicianList and MusicianMIDI are available in the following languages:

• English
• French
• Simplified Chinese (by Grayson Blackclaw)

The add-ons also have been translated in other languages supported by WoW but using Google Translate. The resulting translations may be erratic so they need to be verified and corrected by real humans.

The translations that need to be reworked are:

• German
• Spanish
• Italian
• Korean
• Portugese
• Russian
• Traditional Chinese (Taiwan)

If you want to contribute to the project and translate Musician and its Optional modules in your language, you can do so by forking the project on GitHub or using the localization tab on CurseForge.

The GitHub method is preferred because you can test the result by yourself in-game and is much more faster than Curseforge which is very limited and may be a hassle to deal with a large amount of string. Feel free to get in touch with the dev team on Discord so we can find out what is the best solution for you.

Contribute using GitHub

The GitHub localization workflow is the same as for any git project: clone the project in your own GitHub account, make your changes then create a pull request.

The translation files are located under the add-on locale folder. These are .lua files named after the add-on and locale code. For example, Musician's spanish locale file is Musician.es.lua. You can edit them with any text editor.

Translation strings always begin with msg. as follows:

msg.SOME_NAME = "Some text"

or

msg.SOME_LIST_NAME["some-list-key"] = "Some value"

• Only the text after the = sign should be modified.
• Untranslated strings are in English and are commented out by a double dash --. Remove the -- when you're done.
• The text is always within double quotes " (ie "text"). If you need to put double quotes inside your string, you should escape them with a backslash (\), as follows "Get the \"Musician\" add-on to become a bard!"
• Text between curly braces { and } are placeholders and should not be translated.
• Always keep your text as a single line. You can use the \n character for carriage returns.
• You can add a comment after your string using a double dash --
• Comments on a single line that start with -- or --- are sections. Don't edit them.