summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorbwarsaw2001-08-17 21:17:43 +0000
committerbwarsaw2001-08-17 21:17:43 +0000
commit2f31e6e4b246f4687b88ce84fe50390545ec9f12 (patch)
tree98355c246b0ef7dd9e7673b92c78ce2896831df9
parent2c3013c703558bd1067dcfb504d3813adce93b22 (diff)
downloadmailman-2f31e6e4b246f4687b88ce84fe50390545ec9f12.tar.gz
mailman-2f31e6e4b246f4687b88ce84fe50390545ec9f12.tar.zst
mailman-2f31e6e4b246f4687b88ce84fe50390545ec9f12.zip
Updated some instructions on how to get i18n working. Most notably,
the addlang script is being removed since lists can now enable any site-available language thru-the-web. "ha" => "xx" Also update the list of supported languages and a list of promised languages.
-rw-r--r--README-I18N.en65
1 files changed, 28 insertions, 37 deletions
diff --git a/README-I18N.en b/README-I18N.en
index 1c3a4ed36..6df4d6c6d 100644
--- a/README-I18N.en
+++ b/README-I18N.en
@@ -8,36 +8,9 @@ INTERNATIONALIZATION
Mailman 2.1 is multilingual. By default it supports English, but
additional languages may also be available. If the language you
want to add is already supported by Mailman, then getting all your
- lists to also support that language is fairly easy. You first
- need to run the "addlang" script at the command line, giving it
- the names of the list to add language support to.
-
- Let's say for example, you're adding Spanish support. You should
- do the following:
-
- % cd $prefix (the Mailman installation directory)
- % bin/addlang -l mylist es
-
- This will add Spanish support to mylist, provided that following
- is true (all relative to the $prefix directory):
-
- 1. There must be a file messages/es/LC_MESSAGES/mailman.mo file
- which contains the catalog of translations for translatable
- strings in the Mailman source code.
-
- 2. There must be a directory templates/es which contains all the
- global default translated template files for Spanish.
-
- 3. There is an entry in the Mailman/Defaults.py file for the 'es'
- language in the constant LC_DESCRIPTIONS. If not, do not
- change Defaults.py! Instead add the following in your
- mm_cfg.py file (again, the example here is for Spanish):
-
- add_language('es', 'Spanish (Spain)', 'iso-8859-1')
-
- The add_language() function takes three arguments (as strings):
- the language code, the language description, and the language
- charset.
+ lists to also support that language is fairly easy. You just need
+ to go to the administrative web pages, click on the "Languages"
+ category, and select the languages you want your list to support.
If the language you want to use has not been previously
translated, or you don't know where to find the language pack for
@@ -54,7 +27,7 @@ ADDING NEW TRANSLATIONS
make sure nobody has already created the translations for your
language. In the example below, we're going to create a
translation for the mythical language "Fredonia" which has the
- official language code of "ha".
+ official language code of "xx".
In general you need to do two things to add translations for a
language in Mailman. You need to translate the message catalog
@@ -62,17 +35,17 @@ ADDING NEW TRANSLATIONS
To translate the message catalog, grab the file
messages/mailman.pot and make a copy called mailman.po in the
- subdirectory messages/ha/LC_MESSAGES. Then you edit the file and
+ subdirectory messages/xx/LC_MESSAGES. Then you edit the file and
add the translations for each message identified in the catalog.
It will be very helpful to have a good tool, such as po-mode for
Emacs, for this part of the job.
Once you've added your translations, you can then run msgfmt over
- your .po file to generate messages/ha/LC_MESSAGE/mailman.mo (it
+ your .po file to generate messages/xx/LC_MESSAGE/mailman.mo (it
would also be a good idea to donate your translated .po file back
to the Mailman project!)
- Next, create the subdirectory templates/ha and translate each of
+ Next, create the subdirectory templates/xx and translate each of
the files in templates/en/*.{html,txt}. These you should also
donate back to the Mailman project.
@@ -85,8 +58,7 @@ RESYNCHRONIZING THE CATALOG
As Mailman development continues, new updated catalogs
(i.e. mailman.pot files) will be made available. As mailman.pot
changes, the individual language catalogs
- (i.e. xx/LC_MESSAGES/mailman.po files) need to be updated as
- well.
+ (i.e. xx/LC_MESSAGES/mailman.po files) need to be updated as well.
In general, I as the Mailman maintainer will merge the new
catalogs with the individual language catalogs, and upload the new
@@ -94,16 +66,35 @@ RESYNCHRONIZING THE CATALOG
mailman.po files from SF or CVS and update the translated
messages. They should also update the template translations.
+ For best results, you will probably want to keep current on
+ changes to Mailman 2.1 in the CVS. As Mailman 2.1 moves towards
+ final release, the catalogs and templates should start to
+ stabilize. Alternatively, occasionally I will make new English
+ language packs available on SourceForge, and you can use these to
+ create your translations.
+
CURRENT LIST OF LANGUAGE SUPPORTED OUT-OF-THE BOX
As of this writing (27-Jul-2001), Mailman 2.1alpha2 supports the
following languages out of the box:
+ - Chinese (Simplified and Traditional)
- English
- - Spanish
- French
+ - Hungarian
- Japanese
+ - Spanish
+ - Norwegian
+
+ We've also had volunteers for these languages, although they
+ aren't yet integrated into the code base:
+
+ - Czech
+ - Dutch
+ - German
+ - Polish
+ - Swedish
Hopefully more translations will be donated as Mailman 2.1
development moves along.