Development/Localization
From MatterControl Manual
Revision as of 18:39, 4 December 2015 by MatterHackers (Talk | contribs) (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 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:
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
C:\Program Files (x86)\MatterControl\StaticData\Translations
- On Mac, right click the application, select Show Package Contents, go to
Contents\MonoBundle\StaticData\Translations
- On PC this is typically
- 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.
\StaticData\Translations\es\Translation.txt
- 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
C:\Program Files (x86)\MatterControl\StaticData\Translations
- On Mac, right click the application, select Show Package Contents, go to
Contents\MonoBundle\StaticData\Translations
- On PC this is typically
- Locate the 'Translation.txt' file within the appropriate folder (folder names use 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.
\StaticData\Translations\es\Translation.txt
- Email the translated file to support@matterhackers.com for inclusion in the next release.