Add-on Translation Guide
From Pray Times
m (→Start Translation) |
m |
||
| Line 1: | Line 1: | ||
| - | This is a quick guide on how to translate Pray Times! Firefox add-on. | + | This is a quick guide on how to translate Pray Times! Firefox add-on into your language. |
== Set Up the Environment == | == Set Up the Environment == | ||
| Line 21: | Line 21: | ||
* Close your Firefox and reopen it using <code>my-firefox.bat</code>. | * Close your Firefox and reopen it using <code>my-firefox.bat</code>. | ||
| - | === Choose | + | === Choose locale === |
If you are using a [http://www.mozilla.com/en-US/firefox/all.html localized version of Firefox], then skip this step. Otherwise, do the followings: | If you are using a [http://www.mozilla.com/en-US/firefox/all.html localized version of Firefox], then skip this step. Otherwise, do the followings: | ||
| Line 35: | Line 35: | ||
* Open [addon-dir]/chrome/locale. | * Open [addon-dir]/chrome/locale. | ||
| - | * Make a copy of the folder en-US and rename it to your language id, say fr-FR. (You may find your language id using [https://addons.mozilla.org/en-US/firefox/addon/1333 Quick Locale Switcher] add-on.) | + | * Make a copy of the folder 'en-US' and rename it to your language id, say fr-FR. (You may find your language id using [https://addons.mozilla.org/en-US/firefox/addon/1333 Quick Locale Switcher] add-on.) |
=== Translate === | === Translate === | ||
| Line 43: | Line 43: | ||
* Start translating expressions in the above two files. | * Start translating expressions in the above two files. | ||
| - | === Translation | + | === Translation hints === |
There are several resources that can help you improve your translation. | There are several resources that can help you improve your translation. | ||
Revision as of 06:20, 16 March 2009
This is a quick guide on how to translate Pray Times! Firefox add-on into your language.
Contents |
Set Up the Environment
Copy files
Download Pray Times! 1.2 zip file and extract it into a directory on your local drive. We refer to this directory as [addon-dir].
Make a new Firefox profile
- Open [addon-dir]/dev folder and double-click on
my-firefox.batto run it (assuming that you are using Windows). - The Firefox profile dialog appears. Click on 'Create Profile..' to create a profile with name 'praytimes' in a custom folder that you choose. We refer to this folder as [profile-dir].
- Press Finish on the dialog box and then press 'Exit'.
You can now double-click on my-firefox.bat to open Firefox under the newly created profile.
Install Pray Times!
- Copy a file named
azan-times@hamid.netfrom [addon-dir]/dev to [profile-dir]/extensions. - Open the file using Notepad and change its first line to [addon-dir].
- Close your Firefox and reopen it using
my-firefox.bat.
Choose locale
If you are using a localized version of Firefox, then skip this step. Otherwise, do the followings:
- Install Quick Locale Switcher add-on onto your browser.
- From the add-on options menu, change the browser's default language to your own language.
Start Translation
The translation process is pretty easy. You only need to translate expressions inside two text files.
Prepare files
- Open [addon-dir]/chrome/locale.
- Make a copy of the folder 'en-US' and rename it to your language id, say fr-FR. (You may find your language id using Quick Locale Switcher add-on.)
Translate
- Open [addon-dir]/chrome/locale/[your-language-id].
- Open the two files
praytimes.dtdandcommon.propertiesusing a text editor like Notepad. (Note: your editor should be able to store files in UTF-8 format.) - Start translating expressions in the above two files.
Translation hints
There are several resources that can help you improve your translation.
- For general words like OK, Cancel, Options, etc. please use translation used in localized versions of Firefox.
- For technical words like Time Zone, Daylight Saving, etc. you can extensively use Wikipedia in your language.
- Taking a look at other Prayer Times websites and application in your language would be also helpful.
View changes
The changes you make to the dialogue windows (including Options, About, and Comments dialogues) can be viewed immediately. Changes to the main menu and the display panel in the status bar needs a browser restart (you can use Extension Developer add-on to reload all chromes without restart).
Submit Your Translation
After your translation is complete, please send the two files praytimes.dtd and common.properties to the developer, along with your complete name and your url to be included in the credits page. Thank you!
