As you may be aware, we have added internationalization (I18N) support
throughout the SME Server 5.5 code - in the installer, console and
server manager.

We will be shipping 5.5 with two languages - English and French
(Canadian). The French translations are incomplete in 5.5alpha1, but
will appear over the coming weeks.

We are interested in providing the SME Server in other languages for
future releases, so if you are able to provide a translation, please
let [EMAIL PROTECTED] know.

Please note: We will only be providing English and French for the
5.5 release. We are looking into the possibility of downloading other
languages as blades which can be installed onto 5.5

TECHNICAL DETAILS
=================

For those curious about the I18N support, or wanting to have a go at
translation, the following files are of interest:

/etc/sysconfig/i18n
-------------------

This file specifies the system language. By default it is set to
LANG="en_US". If you change this to LANG="fr_FR", the console will appear
in French. This setting affects the console and the command line (though
you need to reboot to affect the command line, though the console picks
up the change immediately).

Browser language
----------------

The server manager panels are displayed according to the preferred
languages provided by your web browser, defaulting to "en_US". In order
to view the panels in another language, appropriate lexicons need to
be installed on the server, and your browser needs to be configured to
request that language. Check the "Languages" setting in your browser to
see how to change this.

Note: You may have to shuffle the order of the Languages in your browser
to ensure that your chosen language is presented first.

Note: Only the "en" locale has been created for 5.5alpha1

/usr/share/locale/en/LC_MESSAGES/server-console.po
--------------------------------------------------

This is the source file which is used for localization of the console
messages. The translations are added in the "msgstr" sections, and
then converted using 'msgfmt'. The file is placed in this location for
convenience only - the .mo files described below contain the run-time
message catalogs.

/usr/share/local/fr/LC_MESSAGES/server-console.mo
-------------------------------------------------

This is the compiled output file from msgfmt. These are binary files
and should not be edited. Edit the .po file and use msgfmt to regenerate
the .mo file.

Translating the console
-----------------------
  - Translate all of the strings in server-console.po
  - Run msgfmt to convert this to server-console.mo
  - Place server-console.mo in the appropriate locale subdirectory

/etc/e-smith/web/functions/*
----------------------------

These are the web panels, which contain embedded lexicons and their
translations. Only some panels have been converted to FormMagick in
5.5alpha1

For example, /etc/e-smith/web/functions/remoteaccess contains in part:

<lexicon lang="en">

      <entry>
        <base>SUCCESS</base>
        <trans>The new remote access settings have been saved.</trans>
      </entry>

</lexicon>

This is, naturally enough, the lexicon for the "en" locale.  The string
"SUCCESS" is translated in English as the phrase "The new remote access
settings have been saved."

The string "SUCCESS" is defined earlier in the file in the 
FormMagick page description:

   <page name="Done" pre-event="turn_off_buttons">
      <description>SUCCESS</description>
    </page>

If an appropriate lexicon entry cannot be found, the <base> string will
be displayed (in this case "SUCCESS").

Translating web panels
----------------------
  - Create a new lexicon, tagged with the appropriate locale
  - Provide <trans>...</trans> blocks for each of the <base>...</base> 
    blocks

Note: FormMagick will soon merge lexicons from external files, which
will allow each localization to be stored in a separate file.

Translating the installer
-------------------------

The installer needs to be rebuilt to include a new language. The installer
message catalog files are in the anaconda source RPM.

Gordon
--
  Gordon Rowell                        [EMAIL PROTECTED]
  Director, Engineering
  Network Server Solutions Group       http://www.e-smith.com
  Mitel Networks Corporation           http://www.mitel.com


--
Please report bugs to [EMAIL PROTECTED]
Please mail [EMAIL PROTECTED] (only) to discuss security issues
Support for registered customers and partners to [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
Archives by mail and http://www.mail-archive.com/devinfo%40lists.e-smith.org

Reply via email to