Difference between revisions of "Translations"

From SME Server
Jump to navigationJump to search
m (draft)
m
Line 25: Line 25:
  
 
===Translating a panel===
 
===Translating a panel===
The goal of this howto is 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.
 
See this [http://forums.contribs.org/index.php?topic=30780 topic] for detailled instructions.
Line 31: Line 31:
 
====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/web/functions                          => Original files ('''do not modify any of these 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
+
  /etc/e-smith/locale/en-us/etc/e-smith/web/functions => English translations path ('''origianl''')
 
  /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
Line 50: Line 49:
 
Then create a bug report and attach the patched file.
 
Then create a bug report and attach the patched file.
  
====Tips & Tricks====
+
====Limitations====
=====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.
 
Panels not using formmagik can't be translated... However there is still a quick fix to change the panel name in the server-manager.
  
Line 74: Line 72:
 
  /etc/e-smith/events/actions/navigation-conf
 
  /etc/e-smith/events/actions/navigation-conf
  
=====Duplicate menus=====
+
====Duplicate menus====
 
You may see some duplicate menus in the server-manager. This is a Formmagick related known problem.
 
You may see some duplicate menus in the server-manager. This is a Formmagick related known problem.
 
See this [http://bugs.contribs.org/show_bug.cgi?id=2734 bug] for more details.
 
See this [http://bugs.contribs.org/show_bug.cgi?id=2734 bug] for more details.
Line 91: Line 89:
 
Apply and test.
 
Apply and test.
  
===Contribs Translations===
+
===Contrib Translations===
  
Contribs that are not written with FormMagick cannot be easily translated.
+
Track which contribs have tranlations
  
 
  smeserver-userpanel        not FormMagick
 
  smeserver-userpanel        not FormMagick
Line 110: Line 108:
 
  if a language is shown the translation is finished
 
  if a language is shown the translation is finished
 
  * means the translation is incomplete
 
  * means the translation is incomplete
 
 
  ** This table may not be current, email the rpm maintainer with updates, check first
 
  ** This table may not be current, email the rpm maintainer with updates, check first
 
To translate download the contrib rpm
 
 
either install and look in the locale dir
 
/etc/e-smith/locale/en-us/etc/e-smith/web/functions [original]
 
 
/etc/e-smith/locale/de/etc/e-smith/web/functions
 
/etc/e-smith/locale/es/etc/e-smith/web/functions
 
/etc/e-smith/locale/fr/etc/e-smith/web/functions
 
/etc/e-smith/locale/it/etc/e-smith/web/functions
 
/etc/e-smith/locale/sv/etc/e-smith/web/functions
 
 
or open the noarch.rpm or src.rpm, eg. with http://www.7-zip.org/
 
to get the locale file
 
 
choose a source language make a copy and overtype the translations
 
 
for a more detailed explanation see
 
http://forums.contribs.org/index.php?topic=30780.0
 
  
  
 
[[Category:Howto]]
 
[[Category:Howto]]

Revision as of 00:51, 28 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.

See this topic for detailled instructions.

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 (origianl)
/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