Translating Saucedacity

Note: This page includes information from Translating Audacity and Translators, all from Audacity's Wiki and Audacity's website, respectively.

Most of this information is unmodified, with the obvious modifications being name changes. If you had translated Audacity before, you should be able to translate Saucedacity with little to no changes. Regardless, credit is given to the original authors of the Audacity Wiki page and the page on Audacity's site, with the additional fact that this page is a mere compilation of information into a tutorial using poEdit.

As Saucedacity is a derivative from Audacity, translation should be the exact same thing. If you translated any part of Audacity before, translating Saucedacity should be the same. Below is some important information on how to get started.

Before we get to translating Saucedacity, there are a couple of notes before we get started:

• All translations are under locale/.
• You need a program that edits PO files. poEdit should work fine for this, but you can use your favorite PO editor for this. However, this guide will be using poEdit.

With that out of the way, let's get started.

How to Translate Saucedacity

Correcting an existing translation

1. Clone this repository. You can do this through git clone https://github.com/saucedacity/saucedacity. a. If you already have cloned this repository, ensure that it is up-to-date by running git pull.
2. Find the appropriate '.po' file in locale/ in the root of the cloned repository.
3. Open the '.po' file that you want to edit in poEdit. a. From poEdit, you can click on 'Open' or 'Edit a translation'.
4. With the '.po' file now open in poEdit, you should see two columns: 'Source text - English' on the left and 'Translation - ' (e.g. Spanish) on the right.
5. Click on the string you want to translate.
6. On the bottom of the screen (in poEdit), there should be two text fields: 'Source text' on the top and 'Translation' at the bottom. For editing the translation, edit the text in the 'Translation' field.

When you are finished, make sure to save the modified PO file.

Creating a new translation

1. Clone this repository. You can do this through git clone --recurse-submodules https://github.com/saucedacity/saucedacity. a. If you already have cloned this repository, ensure that it is up-to-date by running git pull.
2. In poEdit, click on 'Create new translation'. You will then need to select audacity.pot in locale/ in the repo.
3. A dialog window will pop up asking for the language code. Select the appropriate language code for that language.
4. Towards the bottom of the main window, enter the translated string in the 'Translation' field.
5. Save the new translation.

Testing your translations

1. Build Saucedacity from source.
2. Create a new folder for your new translation. On Linux, this should be in /usr/share/saucedacity/locale or similar, e.g. /usr/local/share/saucedacity/locale. On Windows, this should be in . Be sure to look at this file from wxWidgets to ensure you use the correct language code. For example, the language code for Punjabi is "pa", so you would create a new folder in the appropriate folder on the appropriate platform.
3. Rename the saved file to 'Audacity.mo' (FIXME: this might have to be 'Saucedacity.mo' or similar, someone please test) and paste it into the newly created folder.
4. Open Saucedacity. Then, go to Edit > Preferences... > Interface. Under 'Language', select the language you created, then click 'OK'. You should be able to see your translations take effect.