View source for User:IulianU/TransZilla

'''TransZilla''' is a tool for localisation of Mozilla-based apps. It is especially aimed at helping with Firefox/Thunderbird source-level localisation.

==What you can do with it==
* Read l10n trees 
* Output l10n files '''maintaining the original structure of the file intact'''. That includes comments, annotations; spacing is preserved too. This makes TransZilla very CVS- and diff-friendly.

==Getting started==
# Download the latest build of XULRunner 1.9a1 from http://ftp.mozilla.org/pub/mozilla.org/xulrunner/nightly/lat
# Get TransZilla from [here] and unpack it in a folder on your disk.
# Unpack XULRunner in a subfolder named <tt>xulrunner</tt> of the TransZilla folder.
# Create a l10n project file, based on the following example (using en-US and ro):
<code>
</code>
# Start TransZilla using <tt>run.cmd</tt> (on Windows) or <tt>run.sh</tt> (on Linux)
# ''It's important to start off with a consistent translation, i.e. your ab-CD tree should be a good consistent translation of the en-US tree that you have''. We will arrive at updating the trees in a moment.
# Choose Open, then open your l10n project.
# Hit Refresh to populate the string database. This will take a long time - around 30 secs
# Initially all strings will be marked ''fuzzy''. To 
# Now that you've bootstrapped the string database, you can <tt>CVS update</tt> the source (en-US) and destination trees. 
# Hit Refresh again, to incorporate the latest changes in the source and destination trees. It'll take a long time this time too.
# Now you can start translating :-) New strings are red, changed (fuzzy) strings are on a yellowish background. Unchanged strings are in black. To hide those, uncheck the "translated" checkbox at the top of the list.
# After you've done translating, hit "Merge back". This will incorporate your translation back into the destination tree.
# Now you can <tt>CVS commit</tt> the changes in the destination tree, or maybe create a patch and send it to your locale owner.


==How you can help==
* Report bugs
* Send in patches :-)
* Translate the app itself into your language

==TODO list==
* New project wizard
* Use progress bars to give feedback of long operations (refresh, mergeback, etc)