1185037 - Suggestions for Localization Guide page

Status: UNCONFIRMED

(Other Applications :: ChatZilla, defect)

Description

[scootergrisen]

I tried following the instructions on http://chatzilla.hacksrus.com/localization and here are some comment on that.

Where it says the following i would like the next lines to be indented:
On Windows:
   ... indented
On Mac:
   ... indented
On Linux/Unix:
   ... indented

So the following line with "Once you have opened a terminal, naviga..." does not appear to be part of "On Linux/Unix:".



Also the part where it says "python makexpi.py ab-CD" maybe it should include info about what python version can be used and what version can't be used, because it works with python 2.7.10 on my computer, but fails using python 3.4.3 with this error message:

python.exe makexpi.py da-DK
  File "makexpi.py", line 43
    print 'ERROR: Directory %s not found.' % value
                                         ^
SyntaxError: Missing parentheses in call to 'print'



I wanted to test my translation as written in "5. Test out your localization", but when i open the XPI in Firefox 39.0, Firefox says it is not compatible, because in install.rdf is says : "<em:maxVersion>19.0a1</em:maxVersion>".



Also i wanted to test my translation in the standalone ChatZilla (ChatZilla on XULRunner) http://chatzilla.rdmsoft.com/xulrunner/ but it does not say how to test it in that program.



And maybe is would be a good idea to add information/links near the top of the page so people what see what languages ChatZilla have been translated to, so people can know if it have already been translated or someone else is working on translating into a specific language.

Comment 1

[Robert Utasi [:hunboy]]

in install.rdf use : "<em:maxVersion>*</em:maxVersion>" for testing

Comment 2

[scootergrisen]

Do i change to "<em:maxVersion>*</em:maxVersion>" i \locales\generic\install.rdf only ?

Maybe this should be mentioned on the page.

The ChatZilla xpi file from https://addons.mozilla.org/da/firefox/addon/chatzilla/ have "<em:maxVersion>35.*</em:maxVersion>" but Firefox does not complain about not being compatible, even though Firefox is a higher version (Firefox 39.0).

Comment 3

[James Ross]

I've just done a bit of a re-write of the localization guide at http://chatzilla.hacksrus.com/localization but didn't check this bug first - I think some of it is covered but not all.

Comment 4

[scootergrisen]

"For example, French would likely use 'fr-FR'." could be on new line.
Maybe add list of all the language currently translated so people can see more example and perhaps a link to website where people can look up they language code.

Maybe it would look better if everything after a <h*> is indented:

Instead of:
2. Make locale directory

To get started on your...

Perhaps:
2. Make locale directory

    To get started on your...

In "to have a link added to the official homepage" perhaps make "official homepage" into a link to the front page (//chatzilla.hacksrus.com/) so people can see links to the other languages.

It says "Bundling your localization with SeaMonkey".
But how about "Bundling your localization with ChatZilla"?
I would think it would be a much better idea to have the translation built-in ChatZilla instead of having to download seperately, but i have already suggested that. But even if you don't want to bundle the translations with ChatZilla you could still add "Bundling your localization with ChatZilla" to the page and tell why the translations are not bundlet with ChatZilla.

Comment 5

[scootergrisen]

I think there is stille missing info about what to write at:

chatzilla/locales/da/chrome/chatzilla.properties:
    locale.version = 0.9.92.x

chatzilla/xul/content/static.js:
    const __cz_version   = "0.9.92.x";
    const __cz_locale    = "0.9.92.x";

Could we have the version just one place instead of multiple places?
How come one is called locale.version and then the other are version and locale. Its confusing and i don't know what to write.

Missing info about what to write (so we can have consistant names), search for the translations on addons.mozilla.org and see how different they are:
chatzilla/locales/generic/install.rdf:
    em:name="ChatZilla (@MOZ_LANG_TITLE@) Language Pack"

I think addons.mozilla.org complained about not having this, not sure:
    <em:multiprocessCompatible>true</em:multiprocessCompatible>

Would like to know what type to use:
    https://developer.mozilla.org/en-US/Add-ons/Install_Manifests#type
        2 Extensions
        4 Themes
        8 Locale
    Type 2 asks browser to restart.
    Type 8 does not ask to restart. Even though the new translation does not get loaded before a restart.

Maybe missing info about (but properly just need to change in source translation):
chatzilla/xpi/makexpi.py:
    Se https://addons.mozilla.org/en-US/firefox/pages/appversions/
    ffversion = '*'
    smversion = '*'

Still missing info about what Python version to use. If only 2.7 works then write that and write that 3.5 does not work. If that is still the case.

Also please add info on how not to use jar file. addons.mozilla.org will complain about use of jar file.