2,552
edits
Changes
Created page with "MatterControl uses a file-based localization system for translating the software into other languages. == Access the most up-to-date files == Before you begin, make sure..."
MatterControl uses a file-based localization system for translating the software into other languages.
== Access the most up-to-date files ==
Before you begin, make sure you get the most current code:
#You need access to the 'Master.txt' file that is on the 'Master' branch of our source code.
#You can do so by going to our [https://github.com/MatterHackers/MatterControl MatterHackers/MatterControl] GitHub repository, switching to the ''master'' branch, clicking on the '''StaticData/Translations''' folder and clicking on the ''Master.txt'' file.
#Alternatively, you can access this file by clicking on the following link:
#:https://github.com/MatterHackers/MatterControl/blob/master/StaticData/Translations/Master.txt
== Create a new translation ==
For languages that do not currently have translations, follow these instructions:
#Install the latest version and find the 'Translations' folder in the installed location.
#:On PC this is typically <code>C:\Program Files (x86)\MatterControl\StaticData\Translations</code>
#:On Mac, right click the application, select Show Package Contents, go to <code>Contents\MonoBundle\StaticData\Translations</code>
#Locate the 'Master.txt' file, create a working copy in a separate location.
#The 'Translation.txt' file contains all translatable strings within MatterControl in the following format:
#:English: '''Add a file to be printed'''
#:Translated: '''Add a file to be printed'''
#Replace the 'Translated' line with the appropriate translation:
#:English: '''Add a file to be printed'''
#:Translated: '''Agregar archivo a ser impreso'''
#Test the translated file by saving over an existing translation file (ex. <code>\StaticData\Translations\es\Translation.txt</code>
#Email the translated file to support@matterhackers.com for inclusion in the next release.
== Edit an existing translation ==
For languages which already have translations but need corrections, follow these instructions:
#Install the latest version and find the 'Translations' folder in the installed location.
#:On PC this is typically <code>C:\Program Files (x86)\MatterControl\StaticData\Translations</code>
#:On Mac, right click the application, select Show Package Contents, go to <code>Contents\MonoBundle\StaticData\Translations</code>
#Locate the 'Translation.txt' file within the appropriate folder (folder names use [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 2-Digit] codes).
#The 'Master.txt' file contains all translatable strings within MatterControl in the following format:
#:English: '''Add a file to be printed'''
#:Translated: '''Add a file to be printed'''
#Replace the 'Translated' line with the appropriate translation:
#:English: '''Add a file to be printed'''
#:Translated: '''Agregar archivo a ser impreso'''
#Test the translated file by saving over an existing translation file (ex. <code>\StaticData\Translations\es\Translation.txt</code>
#Email the translated file to support@matterhackers.com for inclusion in the next release.
[[Category:Development]]
== Access the most up-to-date files ==
Before you begin, make sure you get the most current code:
#You need access to the 'Master.txt' file that is on the 'Master' branch of our source code.
#You can do so by going to our [https://github.com/MatterHackers/MatterControl MatterHackers/MatterControl] GitHub repository, switching to the ''master'' branch, clicking on the '''StaticData/Translations''' folder and clicking on the ''Master.txt'' file.
#Alternatively, you can access this file by clicking on the following link:
#:https://github.com/MatterHackers/MatterControl/blob/master/StaticData/Translations/Master.txt
== Create a new translation ==
For languages that do not currently have translations, follow these instructions:
#Install the latest version and find the 'Translations' folder in the installed location.
#:On PC this is typically <code>C:\Program Files (x86)\MatterControl\StaticData\Translations</code>
#:On Mac, right click the application, select Show Package Contents, go to <code>Contents\MonoBundle\StaticData\Translations</code>
#Locate the 'Master.txt' file, create a working copy in a separate location.
#The 'Translation.txt' file contains all translatable strings within MatterControl in the following format:
#:English: '''Add a file to be printed'''
#:Translated: '''Add a file to be printed'''
#Replace the 'Translated' line with the appropriate translation:
#:English: '''Add a file to be printed'''
#:Translated: '''Agregar archivo a ser impreso'''
#Test the translated file by saving over an existing translation file (ex. <code>\StaticData\Translations\es\Translation.txt</code>
#Email the translated file to support@matterhackers.com for inclusion in the next release.
== Edit an existing translation ==
For languages which already have translations but need corrections, follow these instructions:
#Install the latest version and find the 'Translations' folder in the installed location.
#:On PC this is typically <code>C:\Program Files (x86)\MatterControl\StaticData\Translations</code>
#:On Mac, right click the application, select Show Package Contents, go to <code>Contents\MonoBundle\StaticData\Translations</code>
#Locate the 'Translation.txt' file within the appropriate folder (folder names use [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 2-Digit] codes).
#The 'Master.txt' file contains all translatable strings within MatterControl in the following format:
#:English: '''Add a file to be printed'''
#:Translated: '''Add a file to be printed'''
#Replace the 'Translated' line with the appropriate translation:
#:English: '''Add a file to be printed'''
#:Translated: '''Agregar archivo a ser impreso'''
#Test the translated file by saving over an existing translation file (ex. <code>\StaticData\Translations\es\Translation.txt</code>
#Email the translated file to support@matterhackers.com for inclusion in the next release.
[[Category:Development]]