Add-on Translation Guide
From Pray Times
This is a quick guide on how to translate Pray Times! Firefox add-on into your language.
Contents |
Set Up the Environment
Install add-on
- Install Pray Times! onto your Firefox browser from this link.
- Also install Quick Locale Switcher to easily switch between languages.
Open add-on folder
- Find your Firefox profile folder, as described in this page.
- Open [profile-folder]/extensions/azan-times@hamid.net/. We call this folder [addon-folder].
Prepare files
- Goto [addon-folder]/chrome/locale/, make a copy of the folder
en-US
and rename it to your language id, sayfr
. (You can find your language id from this list.) - Open
chrome.manifest
file in the [addon-folder] and add a line like this into the file:locale praytimes fr chrome/locale/fr/
wherefr
must be replaced by your language id. - Open
options.js
in the [addon-folder]/chrome/locale/ folder and add a line like this to the languages array, filled with your language information:{id: 'fr', name: 'French', lname: 'Français'}
Start Translation
Translate
- Open [addon-folder]/chrome/locale/[your-language-id]/.
- Open the two files
praytimes.dtd
andcommon.properties
using 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.
Hints
- Always pick the shortest possible translation, in particular for expressions in the main display pad and its tooltip.
- For general terms like OK, Cancel, Options, etc., please use the translations used in the localized versions of Firefox.
- For technical terms 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
Changes made to the dialogue windows (including Options, About, and Comments dialogues) can be viewed immediately. Changes to the main menu and the display pad 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!