PrayTimes.org

Add-on Translation Guide

From Pray Times

(Difference between revisions)
m (→Start Translation)
m (→Prepare files)
 
(9 intermediate revisions not shown)
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 ==
-
=== Copy files ===
+
=== Install add-on ===
-
Download [http://praytimes.org/addon/files/PrayTimes-1.2.zip Pray Times! 1.2 zip file] and extract it into a directory on your local drive. We refer to this directory as [addon-dir].
+
* Install Pray Times! onto your Firefox browser from [http://praytimes.org/addon/files/azan.xpi this link].
 +
* Also install [https://addons.mozilla.org/en-US/firefox/addon/1333 Quick Locale Switcher] to easily switch between languages.
-
=== Make a new Firefox profile ===
+
=== Open add-on folder ===
-
* Open [addon-dir]/dev folder and double-click on <code>my-firefox.bat</code> to run it (assuming that you are using Windows).
+
* Find your Firefox profile folder, as described in [http://support.mozilla.com/en-US/kb/Profiles#How_to_find_your_profile this page].
-
* 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].
+
* Open [profile-folder]/extensions/azan-times@hamid.net/. We call this folder [addon-folder].
-
* Press Finish on the dialog box and then press 'Exit'.
+
-
You can now double-click on <code>my-firefox.bat</code> to open Firefox under the newly created profile.
+
=== Prepare files ===
-
=== Install Pray Times! ===
+
* Goto [addon-folder]/chrome/locale/, make a copy of the folder <code>en-US</code> and rename it to your language id, say <code>fr</code>. (You can find your language id from [https://wiki.mozilla.org/L10n:Teams this list].)
-
 
+
* Open <code>chrome.manifest</code> file in the [addon-folder] and add a line like this into the file:<br/><code> locale  praytimes  fr  chrome/locale/fr/</code> <br/>where <code>fr</code> must be replaced by your language id.
-
* Copy a file named <code>azan-times@hamid.net</code> from [addon-dir]/dev to [profile-dir]/extensions.
+
* Open <code>options.js</code> in the [addon-folder]/chrome/locale/ folder and add a line like this to the languages array, filled with your language information: <br/><code> {id: 'fr', name: 'French', lname: 'Français'}</code>
-
* Open the file using Notepad and change its first line to [addon-dir].
+
-
* Close your Firefox and reopen it using <code>my-firefox.bat</code>.
+
-
 
+
-
=== 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:
+
-
 
+
-
* Install [https://addons.mozilla.org/en-US/firefox/addon/1333 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 ==
== 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 [https://addons.mozilla.org/en-US/firefox/addon/1333 Quick Locale Switcher] add-on.)
 
=== Translate ===
=== Translate ===
-
* Open [addon-dir]/chrome/locale/[your-language-id].
+
* Open [addon-folder]/chrome/locale/[your-language-id]/.
* Open the two files <code>praytimes.dtd</code> and <code>common.properties</code> using a text editor like Notepad. (Note: your editor should be able to store files in UTF-8 format.)
* Open the two files <code>praytimes.dtd</code> and <code>common.properties</code> 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.
* Start translating expressions in the above two files.
-
=== Translation Hints ===
+
=== Hints ===
-
There are several resources that can help you improve your translation.  
+
* 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 [http://www.mozilla.com/en-US/firefox/all.html localized versions of Firefox].
-
* For general words like OK, Cancel, Options, etc. please use translation used in [http://www.mozilla.com/en-US/firefox/all.html localized versions of Firefox].
+
* For technical terms like Time Zone, Daylight Saving, etc. you can extensively use [http://en.wikipedia.org/ Wikipedia] in your language.  
-
* For technical words like Time Zone, Daylight Saving, etc. you can extensively use [http://en.wikipedia.org/ Wikipedia] in your language.  
+
* Taking a look at other Prayer Times websites and application in your language would be also helpful.
* Taking a look at other Prayer Times websites and application in your language would be also helpful.
=== View changes ===
=== 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 [https://addons.mozilla.org/en-US/firefox/addon/7434/ Extension Developer add-on] to reload all chromes without restart).
+
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 [https://addons.mozilla.org/en-US/firefox/addon/7434/ Extension Developer add-on] to reload all chromes without restart).
== Submit Your Translation ==
== Submit Your Translation ==
-
After your translation is complete, please send the two files <code>praytimes.dtd</code> and <code>common.properties</code> to the developer, along with your complete name and your url to be included in the [http://praytimes.org/addon/credits credits page]. Thank you!
+
After your translation is complete, please send the two files <code>praytimes.dtd</code> and <code>common.properties</code> to the developer, along with your complete name and your url to be included in the [[Add-on:_Credits|credits page]]. Thank you!
-
 
+
[[Category:Add-on]]
[[Category:Add-on]]

Latest revision as of 22:13, 24 May 2009

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

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, say fr. (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/
    where fr 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 and common.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!

Retrieved from "http://praytimes.org/wiki/Add-on_Translation_Guide"
Personal tools