Difference between revisions of "Translation:GUI"

From GeoGebra Manual
Jump to: navigation, search
m (update)
 
(13 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This article describes how you can help us with translation of GeoGebra User interface. Before you start translation, plese check whether someone else isn't already working on it (see [[Translation Status]]).
+
This article describes how you can help us with translation of GeoGebra User interface. Before you start translation, plese check whether someone else isn't already working on it (see [[Translation:Status]]).
{{attention|You may only start any translations if you agree to GeoGebra's license terms (see [http://www.geogebra.org/download/license.txt http://www.geogebra.org/download/license.txt]).}}
+
{{attention|You may only start any translations if you agree to GeoGebra's license terms (see [http://www.geogebra.org/license http://www.geogebra.org/license]).}}
  
 
== Doing the Translation ==
 
== Doing the Translation ==
  
You need to obtain a login for the online translation system in order to translate GeoGebra's GUI. To use it, you need to do the following:
+
Please write to [mailto:support@geogebra.org support@geogebra.org] to obtain a login for the [http://dev.geogebra.org/ggbtrans/ online translation system] in order to translate GeoGebra's GUI. To use it, you need to do the following:
  
 
* login
 
* login
* select '''Translation from:''' (eg Default)
+
* when asked to confirm copyright assignment, please do so
* select '''Translation to:''' (there will normally just be one to choose from)
+
* pick one of the categories on top and start translating
* select '''Category''' (colors, commands etc)
+
* by default you only see the last 100 untranslated keys. To see more you can either click the "show all" link below header or reload the page once you have translated some keys
* select '''Version''' (4.0 for doing a new translation)
+
* Please only translate the Java section if your language is not supported by Java for the file-Open and Save dialog
* Click '''Go'''
 
* Add the translation for each key in the red box (or gray box for keys you've already edited and want to change)
 
* Click '''Save translation''' for each key (or press <Tab>)
 
* Please only translate the javaui section if your language is not supported by Java for the file-Open and Save dialog
 
 
* Please only change the symbols section if you want to add symbols for your own language
 
* Please only change the symbols section if you want to add symbols for your own language
  
{{note|The tube, wiki and navigation sections are used to translate parts of the geogebra.org website}}
+
{{note|The GUI and Commands sections are used to translate the apps, the Website section is for translationg www.geogebra.org. Resource IDs section is for translating the official tutorials.}}
  
 
Then your translation will automatically appear in the next release :)
 
Then your translation will automatically appear in the next release :)
  
 
==Notes and restrictions==
 
==Notes and restrictions==
===commands.properties===
+
===Commands===
  
 
Command names must not include any spaces or other special characters (eg - < > ), i.e. a command name has to be one single word. The only special character that is allowed is an underscore _.
 
Command names must not include any spaces or other special characters (eg - < > ), i.e. a command name has to be one single word. The only special character that is allowed is an underscore _.
  
===symbols===
+
===Symbols===
  
 
This file is used to display special characters for each language in the symbols popup, so please add as many as you want (maximum 19) starting with S.1. Use T.1 etc to add an optional tooltip to say what the symbol is.
 
This file is used to display special characters for each language in the symbols popup, so please add as many as you want (maximum 19) starting with S.1. Use T.1 etc to add an optional tooltip to say what the symbol is.
  
===javaui===
+
===GUI===
 
 
This file allows you to translate the File-Open and the Save Dialog windows.
 
 
 
{{note|It is only necessary to translate this new properties file to your language if your language '''is not already supported by Java''' for these dialogs. There is an easy way to find out if you need to do the translation: Open GeoGebra and try out these two dialog windows (File-Open, and Save). If the text appears in English, you might want to translate the new properties file to your language. }}
 
 
 
===plain===
 
  
 
With GeoGebra 3.2 we have introduced a more sophisticated way to describe objects. For example, the key "HyperbolaWithFociABPassingThroughC" has English translation "Hyperbola with foci %0, %1 passing through %2". The symbols %0 %1 and %2 should remain in your translation but you can put them in the correct position for your language and they will be replaced with the names of objects by GeoGebra.  
 
With GeoGebra 3.2 we have introduced a more sophisticated way to describe objects. For example, the key "HyperbolaWithFociABPassingThroughC" has English translation "Hyperbola with foci %0, %1 passing through %2". The symbols %0 %1 and %2 should remain in your translation but you can put them in the correct position for your language and they will be replaced with the names of objects by GeoGebra.  
Line 44: Line 34:
 
{{Note| The translations for the keys '''xAxis, yAxis, zAxis''' must not contain any spaces or other punctuation, eg - }}
 
{{Note| The translations for the keys '''xAxis, yAxis, zAxis''' must not contain any spaces or other punctuation, eg - }}
  
===wiki===
+
===Website===
This file is needed to generate wiki stubs. Several keys that might be confusing to you:
+
This category contains translations for the whole website and parts of the wiki.
* CommandPattern, CommandsPattern, ToolPattern: these keys are used for generating command pages (e.g. "Midpoint Command", command group pages ("Algebra Commands") and Tool Pages ("Midpoint or Center Tool"). Translation of these is quite important since possible errors affect a lot of pages, so please do it carefully. Some possible values of CommandPattern are shown:
+
 
 +
Several keys that might be confusing to you:
 +
* CommandPattern, CommandsPattern, ToolPattern: these keys are used for generating command pages in the Wiki (e.g. "Midpoint Command", command group pages ("Algebra Commands") and Tool Pages ("Midpoint or Center Tool"). Translation of these is quite important since possible errors affect a lot of pages, so please do it carefully. Some possible values of CommandPattern are shown:
 
**<code>%0 Command</code> produces Midpoint Command
 
**<code>%0 Command</code> produces Midpoint Command
 
**<code>%0 (Command)</code> produces Midpoint (Command)
 
**<code>%0 (Command)</code> produces Midpoint (Command)
Line 52: Line 44:
 
** you can think of other values, but please try to avoid using : and / as these have special meaning in wiki article names.
 
** you can think of other values, but please try to avoid using : and / as these have special meaning in wiki article names.
 
* ManualTalk, ReferenceTalk, TipsTalk, TutorialTalk: wiki uses talk pages like this one: http://wiki.geogebra.org/en/Manual_talk:Boolean_values for problem reports and related discussion. You may have look how such talk pages are named in your version of wikipedia to make your translation more consistent.
 
* ManualTalk, ReferenceTalk, TipsTalk, TutorialTalk: wiki uses talk pages like this one: http://wiki.geogebra.org/en/Manual_talk:Boolean_values for problem reports and related discussion. You may have look how such talk pages are named in your version of wikipedia to make your translation more consistent.
[[Category:Translation]]
+
[[Category:For Translators]]

Latest revision as of 13:43, 4 December 2019

This article describes how you can help us with translation of GeoGebra User interface. Before you start translation, plese check whether someone else isn't already working on it (see Translation:Status).


Doing the Translation

Please write to support@geogebra.org to obtain a login for the online translation system in order to translate GeoGebra's GUI. To use it, you need to do the following:

  • login
  • when asked to confirm copyright assignment, please do so
  • pick one of the categories on top and start translating
  • by default you only see the last 100 untranslated keys. To see more you can either click the "show all" link below header or reload the page once you have translated some keys
  • Please only translate the Java section if your language is not supported by Java for the file-Open and Save dialog
  • Please only change the symbols section if you want to add symbols for your own language
Note: The GUI and Commands sections are used to translate the apps, the Website section is for translationg www.geogebra.org. Resource IDs section is for translating the official tutorials.

Then your translation will automatically appear in the next release :)

Notes and restrictions

Commands

Command names must not include any spaces or other special characters (eg - < > ), i.e. a command name has to be one single word. The only special character that is allowed is an underscore _.

Symbols

This file is used to display special characters for each language in the symbols popup, so please add as many as you want (maximum 19) starting with S.1. Use T.1 etc to add an optional tooltip to say what the symbol is.

GUI

With GeoGebra 3.2 we have introduced a more sophisticated way to describe objects. For example, the key "HyperbolaWithFociABPassingThroughC" has English translation "Hyperbola with foci %0, %1 passing through %2". The symbols %0 %1 and %2 should remain in your translation but you can put them in the correct position for your language and they will be replaced with the names of objects by GeoGebra.

For example "Hyperbola with foci %0, %1 passing through %2" would become "Hyperbola with foci A,F passing through Q". In German it would be "Hyperbel mit Brennpunkten %0, %1 durch %2" which would become "Hyperbel mit Brennpunkten A, F durch Q"

Note: The translations for the keys xAxis, yAxis, zAxis must not contain any spaces or other punctuation, eg -

Website

This category contains translations for the whole website and parts of the wiki.

Several keys that might be confusing to you:

  • CommandPattern, CommandsPattern, ToolPattern: these keys are used for generating command pages in the Wiki (e.g. "Midpoint Command", command group pages ("Algebra Commands") and Tool Pages ("Midpoint or Center Tool"). Translation of these is quite important since possible errors affect a lot of pages, so please do it carefully. Some possible values of CommandPattern are shown:
    • %0 Command produces Midpoint Command
    • %0 (Command) produces Midpoint (Command)
    • Command %0 produces Command Midpoint
    • you can think of other values, but please try to avoid using : and / as these have special meaning in wiki article names.
  • ManualTalk, ReferenceTalk, TipsTalk, TutorialTalk: wiki uses talk pages like this one: http://wiki.geogebra.org/en/Manual_talk:Boolean_values for problem reports and related discussion. You may have look how such talk pages are named in your version of wikipedia to make your translation more consistent.
© 2024 International GeoGebra Institute