Authoring interface translations

To provide new locale (interface translation) for PrinterShare console, follow these steps.

1. Locate "Language" menu in PrinterShare console (File | Language on Windows). This menu shows you the list of currently available locales.
2. Open C:\Program Files\PrinterShare\lang on Windows, or /Library/Application Support/PrinterShare/lang on MacOS. You will see xml files containing the locales.
3. Make a copy of any locale you are most comfortable with, and rename it according to your target language. E.g. en_US.xml stays for English (United States).
4. Open the file. You can use either an XML editor, or a plain text editor such as Notepad, this is not important for the end result. The file looks like this:
   
   
   <translation name="Русский" name-en="Russian" author="Nikita Frolov" version="2.0.7">
   <section id="Common">
     <text id="OK">OK</text>
     <text id="Cancel">Отменить</text>
   </section>
   <section id="Errors">
     <text id="Error">Ошибка</text>
   </section>
   
   
   Strings in blue are XML tags, don't change them. Strings in bold are text messages which need to be replaced by the messages in your language.
5. Enter new locale name (change "name" attribute of "translation" element which goes first in the file).
6. Locate "MainMenu" section and make a couple of simple changes to it.
7. Save the file, exit and reopen PrinterShare console. Your new locale should appear in Language menu. When selected, your changes should be reflected in the main menu.
8. Continue translating, starting with the parts you can easily identify. Here is the tricky part: there's no translation for English, so if you are not familiar with any of the represented languages even a little bit, you may have doubts which message goes where. But, it should not be too difficult to make guesses based on ID attributes (strings in red).
9. When you are done, check Russian locale (ru_RU.xml) to see if you missed any messages. Russian locale is the most up-to-date one. If there's no difference for you, it may be easier to use it as a template from the beginning.