Creating a New Translation

If you want to create a new translation (i.e. language file) for openlp.org, these are the steps you need to follow.

The translation should work correct only in a localized Windows. (e.g. Slovak translation will work in Slovak Windows) The technical reason see below.

1. Copy the C:\Documents and Settings\All Users\Application Data\openlp.org\Languages\english.xml file to your My Documents directory.
2. Open the file in a text editor, (an XML editor might be easier to use if you can find one), replacing all the English values (in the Caption="" and other similar XML attributes) with your translation. If you have any special characters (like è) then you need to use the HTML/XML entity code instead. There is a list of entities on the W3Schools site, you can use the codes from the Entity Number column (not the Entity Name, as previously published).
3. Save this new file with a new name, setting the "Name" of your language.
4. The new file must be saved in the codepage as is your Windows version. (e.g. for Slovak it should be codepage 1250, cp1250 in short). There is a list of codepages for different Windows language versions. Not doing this will probable result in screens with broken translations.
5. Import the new language into openlp.org by using the Import Language option (see Figure 1).

The reason, why unicode encoding for translated files can't be used is that the programming environment doesn't use unicode win32 api. In Windows there are to similar APIs. One that can handle unicode and one that can't.