Line 23: |
Line 23: |
| These changes are tracked in the | | These changes are tracked in the |
| [http://bugs.contribs.org/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=SME+Server+Translations&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailqa_contact2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Bug+Number&field0-0-0=noop&type0-0-0=noop&value0-0-0= Bug Tracker,] please add updated translations at each bug if you can. | | [http://bugs.contribs.org/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=SME+Server+Translations&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailqa_contact2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Bug+Number&field0-0-0=noop&type0-0-0=noop&value0-0-0= Bug Tracker,] please add updated translations at each bug if you can. |
| + | |
| + | ===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. |
| + | |
| + | See this [http://forums.contribs.org/index.php?topic=30780 topic] for detailled instructions. |
| + | |
| + | ====Locate needed 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/en-us/etc/e-smith/web/functions => English 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/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 [http://wiki.contribs.org/Package_Modification article] to learn how to help modifying existing contribs. |
| + | Then create a bug report and attach the patched file. |
| + | |
| + | ====Tips & Tricks==== |
| + | =====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 [http://bugs.contribs.org/show_bug.cgi?id=2734 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. |
| | | |
| ===Contribs Translations=== | | ===Contribs Translations=== |
Line 65: |
Line 132: |
| http://forums.contribs.org/index.php?topic=30780.0 | | http://forums.contribs.org/index.php?topic=30780.0 |
| | | |
− | ====Menus with non FormMagick contribs====
| |
− | There is a workaround to translate just the menu category and heading.
| |
− |
| |
− | create a locale file
| |
− | nano /etc/e-smith/locale/fr/etc/e-smith/web/functions/userpanelaccess
| |
− | <lexicon lang="fr">
| |
− | <entry>
| |
− | <base>Security</base>
| |
− | <trans>\n Sécurité\n </trans>
| |
− | </entry>
| |
− | <entry>
| |
− | <base>User Panel Access</base>
| |
− | <trans>Panneaux Utilisateurs</trans>
| |
− | </entry>
| |
− | </lexicon>
| |
− |
| |
− | regenerate the menus
| |
− | /etc/e-smith/events/actions/navigation-conf
| |
| | | |
− | And email the locale file to the contrib maintainer for the next release
| + | [[Category:Howto]] |