Internationalization (i18n)

[nok]

Hello, Hallo, Salut, Cześć.

How to change the language?
Change the language in the preferences CMD + , of Processing.

How to use a translation?
Just type Language.text("object.name");, anytime, anywhere. (It uses the singleton pattern and it's independent (It uses a separate file /lib/language.txt to store the favorite language).) You find the object.name in the package processing.app.languages, where every language is located as a properties file. If the specific language doens't have the translation (i.e. menu.file in PDE_fr.properties), the system will extend the default translation of PDE.properties. The default language is English.

How to add a new language?
1: Add the language ISO 639-1 code (list of codes) and name in processing.app.Language, i.e.:

// de, Deutsch
this.languages.put(Locale.GERMAN.getLanguage(), Locale.GERMAN.getDisplayLanguage(Locale.GERMAN));

2: Add the file PDE_de.properties with translations in processing.app.languages.

Note
It's a initial version of that extension. I hope, that you like it.

Happy coding,
Darius

[aengelke]

Perhaps you could add an option to change the language independent from the system settings?

[nok]

At first time the editor checks your local system language. If it matches with a available language, you will see the PDE in your local system language. Otherwise you will see it in English.

[datguy]

I like it. I hope your pull request is accepted.

[nok]

Hmm, I keep that extension in mind, but I don't know how to handle the next steps. I think, that it's very useful.

@REAS What do you think about that extension?

[REAS]

Darius, this is for @benfry to evaluate. Best, Casey

[benfry]

Thanks for this! Would you be interested in updating it for the current source?

[nok]

Currently I'm low on time, but yes, I'm going to extend it next week (2014/June/03).

[benfry]

Thanks!

[nok]

I updated the source from the remote master branch and merged/improved it with some extensions/changes. Looks fine. 👍

Happy coding,
Darius

---

[benfry]

Thank you! We're about to switch over to 3.x development, and I'll merge this in when we kick off that process.

[nok]

Okay, great!

[tyfkda]

Hi @benfry ,
I really want this pull request get merged into official processing repository,
because I want to add Japanese language to Processing.

I think it is needed to add a rule to convert .properties files to include them into pde.jar:
https://github.com/tyfkda/processing/commit/d713e00a3eb93b2aaf2c6944d6d73edf73a7f70a

I have tried this pull request merged into the currentHEAD,
and I confirmed it runs correctly.

[benfry]

Thanks again for this, I'd like to merge it into the repo. A couple small things that need to be fixed first:

• it looks like PDE_de.properties isn't using UTF-8 encoding, please fix (or verify)
• several .class files were included in the PR, which we don't want
• SerialFixer.java and VariableInspector.form seem to have re-emerged from an old commit
• mode/experimental is now gone, that code lives in the root at /pdex
• a machine-specific entry has been added to the .classpath file in the root

Please take a shot at fixing these up and re-submitting when you can. I'd love to get this integrated soon. Thanks again for your help!

[nok]

Hi Ben, thanks for the hints, I'm going to consecutively fix these.

[nok]

Okay,

I hope, that I didn't forget something ... please check out the i18n branch, build and test it too.

Happy coding,
Darius

[benfry]

Now merged; here goes! I'm super excited about this.

[REAS]

Entirely awesome. How do people add other languages? @voidplus could you write a Wiki page about that? http://wiki.processing.org Or, am I missing something?

[nok]

I'm glad too. 👍

Yes, I'm going to write a short howto page this week.

In addition I want to create a small interactive website, where people can fill out "pde-forms". I think, that's the easiest way, how contributors can help.

[genekogan]

has anyone considered translating processing/java syntax in addition to the file menu? e.g. "void", "setup", "draw", "return", "vertex", etc. since the IDE already has a parser built on top of it to convert to java, setting it up to parse different languages should be straightforward, and i think speakers of other languages may find it welcoming and more accessible than english-only.

also, i think i should be able to contribute a russian version.

[benfry]

Short answer is that we've done that in the past (http://dbn.media.mit.edu/) and it wasn't as useful as we'd hoped. Longer answer is that it's probably something better discussed as a suggestion on the forum.

Would love to add a Russian translation, thanks!

[github-actions]

This pull request has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.