|
|
| Line 2: |
Line 2: |
| | {{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/download/license.txt http://www.geogebra.org/download/license.txt]).}} |
| | | | |
| − | =Attesoro Editor=
| + | '''Translation of GeoGebra is suspended this week while we deploy a new online translation system''' |
| − | Download the file [http://www.geogebra.org/source/translation/gui/attesoro.jar attesoro.jar]. This file is the editor Attesoro that you will use to do the translation of GeoGebra's user interface. Double click "attesoro.jar" in order to start the editor. If it does not work, you need to install Java 1.5 or later which you can get from [http://www.java.com www.java.com]).
| |
| − | | |
| − | =Download properties zip file=
| |
| − | | |
| − | Download the latest version of the properties files from [http://www.geogebra.org/source/translation/gui/ http://www.geogebra.org/source/translation/gui/] This file includes all properties files in all languages currently supported by GeoGebra: '''geogebra_prop_XX_YYYYYYYY.zip''' (XX is the version number, YYYYYYYY is the date). Unzip the downloaded '''geogebra_prop_XX_YYYYYYYY.zip''' to your computer. You are going to translate the following files:
| |
| − | * command.properties
| |
| − | * error.properties
| |
| − | * javaui.properties (NEW in version 3.2, PLEASE SEE NOTES BELOW)
| |
| − | * menu.properties
| |
| − | * plain.properties
| |
| − | * colors.properties (NEW in version 4.0)
| |
| − | * symbols.properties (NEW in version 4.0, PLEASE SEE NOTES BELOW)
| |
| − | The archive also includes following files, which are not directly related to the user interface
| |
| − | * wiki.properties (NEW in version 4.0)
| |
| − | * tube.properties -- translation of [[GeoGebra]]
| |
| − | * navigation -- translation of main menu of http://www.geogebra.org
| |
| − | | |
| − | =The translation process=
| |
| − | * Start the editor "Attesoro" that you downloaded
| |
| − | * From the "File" menu choose "Open" and open the file '''menu.properties''' from the directory where you unpacked all the properties files.
| |
| − | * Do '''not''' open the '''menu_<language code>.properties''', but directly '''menu.properties'''. You will set the language once the file is open via the language list on the left.
| |
| − | * In the upper-left window of Attesoro you see all available translations of this properties file.
| |
| − | | |
| − | ==Adding a new language==
| |
| − | If there is no previous translation of the help files in your language, you should now create a new "Locale". From the "Edit" menu choose "Locale" and "New..." and select your language in the dialog. Usually you should leave the country as "All". Please remember your language code (i.e. "af" for Afrikaans).
| |
| − | | |
| − | ==Doing the translation==
| |
| − | * Select your language in the upper-left window of Attesoro.
| |
| − | * Click on the first "Key" in the lower-left window of Attesoro.
| |
| − | * In the upper-right window of Attesoro you can now start to do your translation of the "Default Text", i.e. the English text.
| |
| − | * Continue with the translation of the next key using "Ctrl + N"
| |
| − | * Please translate the six properties files in this way: command.properties, error.properties, menu.properties, plain.properties, wiki.properties, colors.properties
| |
| − | * Please only translate the javaui.properties file if your language is not supported by Java for the file-Open and Save dialog
| |
| − | * Please only change the symbols.properties file if you want to add symbols for your own language
| |
| − | ==Notes and restrictions==
| |
| − | ===commands.properties===
| |
| − | | |
| − | 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.properties===
| |
| − | | |
| − | We will be using this file to display special characters for each language in the symbols popup, so please add as many as you want starting with S.1 - if think you need more than 19 please send us an email.
| |
| − | | |
| − | ===javaui.properties file===
| |
| − | | |
| − | 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.properties file===
| |
| − | | |
| − | 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"
| |
| − | | |
| − | ===wiki.properties===
| |
| − | This file is needed to generate wiki stubs. Several keys that might be confusing to you:
| |
| − | * 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:
| |
| − | **<code>%0 Command</code> produces Midpoint Command
| |
| − | **<code>%0 (Command)</code> produces Midpoint (Command)
| |
| − | **<code>Command %0</code> 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.
| |
| − | | |
| − | ==Updating an existing translation==
| |
| − | * Download the latest version of the properties files from [http://www.geogebra.org/source/translation/gui http://www.geogebra.org/source/translation/gui]. This file should have a name like '''geogebra_prop_XX_YYYYYYYY.zip''' (XX is the version number and YYYYYYYY is the date).
| |
| − | * Read the change notes for this version to learn about recent changes in the properties files:
| |
| − | ** '''[[Changes in Translation|GeoGebra 3.2 -> 4.0 changes]]'''
| |
| − | * In Attesoro you can easily see all untranslated keys in the lower-left window: they are printed in BLUE color.
| |
| − | | |
| − | =Send us your translation=
| |
| − | When you have finished your translation, pack your files into one zip file. For example, if you did a translation to Afrikaans (language code "af") your zip file should contain these files: command_af.properties, error_af.properties, javaui_af.properties, menu_af.properties, plain_af.properties, colors_af.properties, symbols_af.properties, tube_af.properties, navigation_af.properties, wiki_af.properties.
| |
| − | {{Note|it is sufficient to send only those files in which you have made changes.}}
| |
| − | | |
| − | Please send your zip file to [mailto:translation@geogebra.org translation@geogebra.org] via e-mail.
| |
| − | | |
| − | | |
| − | '''Thank you for your support of the GeoGebra project!'''
| |
| | | | |
| | [[Category:Translation]] | | [[Category:Translation]] |
