Difference between revisions of "Translations"

From SME Server
Jump to navigationJump to search
m
Line 26: Line 26:
 
===Translating a panel===
 
===Translating a panel===
 
To create a translation for a given language of an existing panel in the server-manager.
 
To create a translation for a given language of an existing panel in the server-manager.
 
See this [http://forums.contribs.org/index.php?topic=30780 topic] for detailled instructions.
 
  
 
====Locate needed files====
 
====Locate needed files====
 
Translating a panel is really easy, here are paths to files:
 
Translating a panel is really easy, here are paths to files:
 
  /etc/e-smith/locale/de/etc/e-smith/web/functions    => German  translations path
 
  /etc/e-smith/locale/de/etc/e-smith/web/functions    => German  translations path
  /etc/e-smith/locale/en-us/etc/e-smith/web/functions => English translations path ('''origianl''')
+
  /etc/e-smith/locale/en-us/etc/e-smith/web/functions => English translations path ('''original''')
 
  /etc/e-smith/locale/es/etc/e-smith/web/functions    => Spanish translations path
 
  /etc/e-smith/locale/es/etc/e-smith/web/functions    => Spanish translations path
 
  /etc/e-smith/locale/fr/etc/e-smith/web/functions    => French  translations path
 
  /etc/e-smith/locale/fr/etc/e-smith/web/functions    => French  translations path
 
  /etc/e-smith/locale/it/etc/e-smith/web/functions    => Italian translations path
 
  /etc/e-smith/locale/it/etc/e-smith/web/functions    => Italian translations path
 
  /etc/e-smith/locale/sv/etc/e-smith/web/functions    => Swedish translations path
 
  /etc/e-smith/locale/sv/etc/e-smith/web/functions    => Swedish translations path
 +
 
Usually, panels have a user-friendly name. Check if a translation hasn't been started, else if the panel translation doesn't exist in your language path, simply copy the file from the English path and start to translate this new file!
 
Usually, panels have a user-friendly name. Check if a translation hasn't been started, else if the panel translation doesn't exist in your language path, simply copy the file from the English path and start to translate this new file!
 
You will have to translate the content of text between '''<trans>''' and '''</trans>'''
 
You will have to translate the content of text between '''<trans>''' and '''</trans>'''

Revision as of 23:56, 27 December 2007

Translations

SME Server Supports English, French, German, Spanish, Italian and Swedish.

Other Languages are in progress [Bug tracker - translations]

Adding new Languages

There is one file per server-manager panel, plus a few others.

To translate to another language

  • Raise a bug in the bug tracker to let us know you're starting or add to a work in progress
  • Refer to these forum posts

http://forums.contribs.org/index.php?topic=30780.0

http://forums.contribs.org/index.php?topic=29298.0

Maintaining Existing Languages

Ongoing updates to SME Server occasionally modify panel text and this requires updating of the translations.

These changes are tracked in the Bug Tracker, please add updated translations at each bug if you can.

Translating a panel

To create a translation for a given language of an existing panel in the server-manager.

Locate needed files

Translating a panel is really easy, here are paths to files:

/etc/e-smith/locale/de/etc/e-smith/web/functions    => German  translations path
/etc/e-smith/locale/en-us/etc/e-smith/web/functions => English translations path (original)
/etc/e-smith/locale/es/etc/e-smith/web/functions    => Spanish translations path
/etc/e-smith/locale/fr/etc/e-smith/web/functions    => French  translations path
/etc/e-smith/locale/it/etc/e-smith/web/functions    => Italian translations path
/etc/e-smith/locale/sv/etc/e-smith/web/functions    => Swedish translations path

Usually, panels have a user-friendly name. Check if a translation hasn't been started, else if the panel translation doesn't exist in your language path, simply copy the file from the English path and start to translate this new file! You will have to translate the content of text between <trans> and </trans>

Apply changes

For changes to take effects, you will have to issue the following command:

/etc/e-smith/events/actions/navigation-conf

Now open your web browser at https://yourserver/server-manager and see your own modifications!

Share your work

See this article to learn how to help modifying existing contribs. Then create a bug report and attach the patched file.

Limitations

Panels not using formmagik can't be translated... However there is still a quick fix to change the panel name in the server-manager.

Let's take a look at AWStats and try to translate the panel name to French as an example:

Open the default file /etc/e-smith/web/functions/awstats and take a look on the first lines. You should see what is needed to change:

# heading     : Administration => in which submenu the panel is put
# description : Web statistics => display the panel name
# navigation  : 4000 4350      => Not needed here, used for panel order

create a file called awstats in /etc/e-smith/locale/fr/etc/e-smith/web/functions/ with the following content:

<lexicon lang="fr">
   <entry>
       <base>Administration</base>
       <trans>Administration</trans>
   </entry>
   <entry>
       <base>Web statistics</base>
       <trans>Statistiques Web</trans>
   </entry>
</lexicon>

And finally, apply changes with the following command:

/etc/e-smith/events/actions/navigation-conf

Duplicate menus

You may see some duplicate menus in the server-manager. This is a Formmagick related known problem. See this bug for more details. Still using FR and AWStats as an example... Simply modify original file to:

<lexicon lang="fr">
   <entry>
       <base>Administration</base>
       <trans>\n      Administration\n    </trans>
   </entry>
   <entry>
       <base>Web statistics</base>
       <trans>Statistiques Web</trans>
   </entry>
</lexicon>

(\n and 6 spaces, then \n and 4 spaces) Apply and test.

Contrib Translations

Track which contribs have tranlations

smeserver-userpanel        not FormMagick

smeserver-userpanels 
- forwarding               fr, de, es*, it*, sv
- password                 fr, de, es, it, sv
- useraccounts/backup      not FormMagick

smeserver-vacation         fr, de, es

smeserver-mailsorting      fr, de, es

smeserver-remoteuseraccess fr, de, es, sv

if a language is shown the translation is finished
* means the translation is incomplete
** This table may not be current, email the rpm maintainer with updates, check first