# Contribute a new translation

**URL:** <https://discourse.processing.org/t/contribute-a-new-translation/17405>\
**Category:** Development\
**Created:** [January 28, 2020, 11:35pm UTC](https://discourse.processing.org/t/contribute-a-new-translation/17405 "2020-01-28T23:35:50Z")\
**Posts on this page:** 10\
**Page:** 1

<div class="post-metadata">

**Author:** ![trikaphundo](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/trikaphundo/32/7913_2.png) [@trikaphundo](https://discourse.processing.org/u/trikaphundo)\
**Post date:** [January 28, 2020, 11:35pm UTC](https://discourse.processing.org/t/contribute-a-new-translation/17405/1 "2020-01-28T23:35:50Z")

</div>

Hello everyone, I would like to contribute a Catalan translation to Processing development environment (the sketchbook).

I couldn’t find any information or instructions on how to contribute a translation, neither in the [processing’s github page](https://github.com/processing/processing) nor in the website ([processing.org](http://processing.org)). Nothing in this forum on this subject either.

I found some interesting conversation under the processing-docs project though: [new translation system ongoing?](https://github.com/processing/processing-docs/pull/240). This what REAS wrote in the post on December 2019.

> We are starting work on a new way to build the site and a new translation system is a priority. I’m going to close this thread for now and we can discuss the translations in more detail when the time comes.

I’ve been searching the github page and I think I have a loose idea of how to tackle this. I would just mimic other translation commits I’ve found. You can have a look at the [Italian translation commit](https://github.com/processing/processing/pull/5169/files). Only three files need to be modified:

- Make a copy of [processing/…/languages/PDE.properties](https://github.com/processing/processing/blob/master/build/shared/lib/languages/PDE.properties) and translate it.

- Add a line for the language in [processing/…/languages/languages.txt](https://github.com/processing/processing/blob/master/build/shared/lib/languages/languages.txt).

- Add the language code to the method _static private String[] listSupported()_ of the [Language.java class](https://github.com/processing/processing/blob/master/app/src/processing/app/Language.java)

* * *

I don’t know if there is a protocol for doing translations as of today (January 2020) which I should comply to. Moreover, I don’t think it’s easy for non-programmer to get to contribute a translation as things are now. Fortunately there are [instructions to build Processing’s code from source](https://github.com/processing/processing/wiki/Build-Instructions), which I will need in order to see the translation in use and verify everything is ok before sending a pull request.

Could someone tell me why there are no tutorials on how to contribute translations? Or, if there are, point me to one? On the other side, if my effort is futile for some reason, please, tell me so as well.

Thank you.

---

<div class="post-metadata">

**Author:** ![trikaphundo](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/trikaphundo/32/7913_2.png) [@trikaphundo](https://discourse.processing.org/u/trikaphundo)\
**Post date:** [January 29, 2020, 12:24am UTC](https://discourse.processing.org/t/contribute-a-new-translation/17405/2 "2020-01-29T00:24:05Z")

</div>

I just found a hidden(?) page on [localization in the processing wiki](https://github.com/processing/processing/wiki/Localization) with the instructions I outlined in my previous message. But that page is not reachable from the [project’s wiki](https://github.com/processing/processing/wiki), I found the page by chance by following a link in an issue ticket.

Shall I not start the translation? As it seems the information is hidden on purpose.

---

<div class="post-metadata">

**Author:** ![jeremydouglass](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/jeremydouglass/32/20_2.png) [@jeremydouglass](https://discourse.processing.org/u/jeremydouglass)\
**Post date:** [February 12, 2020, 6:34pm UTC](https://discourse.processing.org/t/contribute-a-new-translation/17405/3 "2020-02-12T18:34:15Z")

</div>

Hi trikaphundo – thank you so much for your interest in contributing this translation. have you opened an issue on GitHub with this question, and were you able to get in touch with @REAS ?

---

<div class="post-metadata">

**Author:** ![ProcessingOrg](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/processingorg/32/18341_2.png) [@ProcessingOrg](https://discourse.processing.org/u/ProcessingOrg)\
**Post date:** [February 13, 2020, 12:56am UTC](https://discourse.processing.org/t/contribute-a-new-translation/17405/4 "2020-02-13T00:56:04Z")

</div>

Yes, this file is the spot for information: [https://github.com/processing/processing/wiki/Localization](https://github.com/processing/processing/wiki/Localization) As you mentioned, you can replicate the steps for the other translations. I think people usually submit a pull request on Github after the work is done.

---

<div class="post-metadata">

**Author:** ![jeremydouglass](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/jeremydouglass/32/20_2.png) [@jeremydouglass](https://discourse.processing.org/u/jeremydouglass)\
**Post date:** [February 13, 2020, 3:41am UTC](https://discourse.processing.org/t/contribute-a-new-translation/17405/5 "2020-02-13T03:41:39Z")

</div>

If you need any support on building / submitting a pull request, let us know how we can help.

Suggestions for the community on making translation more accessible are also most welcome – I’m can’t speak for the core developers here, but the community _greatly_ benefits for translation and language accessibility.

---

<div class="post-metadata">

**Author:** ![villares](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/villares/32/3166_2.png) [@villares](https://discourse.processing.org/u/villares)\
**Post date:** [February 25, 2020, 8:33pm UTC](https://discourse.processing.org/t/contribute-a-new-translation/17405/6 "2020-02-25T20:33:39Z")

</div>

What about a protocol for translating the language reference?

We had a Processing 1.0 Portuguese translation of the reference ([http://www.dainf.ct.utfpr.edu.br/~merkle/processing/reference/ptBR/index.html](http://www.dainf.ct.utfpr.edu.br/~merkle/processing/reference/ptBR/index.html)) , now I have found some people willing to make a 3.X version… but we lack an entry point.

---

<div class="post-metadata">

**Author:** ![jeremydouglass](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/jeremydouglass/32/20_2.png) [@jeremydouglass](https://discourse.processing.org/u/jeremydouglass)\
**Post date:** [February 26, 2020, 8:01am UTC](https://discourse.processing.org/t/contribute-a-new-translation/17405/7 "2020-02-26T08:01:27Z")

</div>

@REAS are there people in the core team who could point out or give advice on such a protocol / entry point – or just permission to tackle it ad-hoc?

---

<div class="post-metadata">

**Author:** ![REAS](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/reas/32/16_2.png) [@REAS](https://discourse.processing.org/u/REAS)\
**Post date:** [February 28, 2020, 5:25pm UTC](https://discourse.processing.org/t/contribute-a-new-translation/17405/8 "2020-02-28T17:25:59Z")

</div>

Translating the entire site or the entire reference into other languages is a primary goal for us, but the current website isn’t set up for it. We are trying to get a new website infrastructure working that will allow for complete translation.

So, we are working on a new entry point for translations. That work was hard to get started, but it is moving forward now. I’m hopeful.

---

<div class="post-metadata">

**Author:** ![glv](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/glv/32/18785_2.png) [@glv](https://discourse.processing.org/u/glv)\
**Post date:** [February 28, 2020, 5:47pm UTC](https://discourse.processing.org/t/contribute-a-new-translation/17405/9 "2020-02-28T17:47:51Z")

</div>

Hello,

Some of the references and examples could use an update; ideally this should be done before translating.

I am willing to contribute to this as time permits.

One example only:

This references **byteBuffer** and **interesting** in description but not in the syntax or parameters:  
[https://processing.org/reference/libraries/serial/Serial\_readBytesUntil\_.html](https://processing.org/reference/libraries/serial/Serial_readBytesUntil_.html)

This old version is correct:  
[https://www.andrew.cmu.edu/course/60-257/reference/libraries/serial/Serial\_readBytesUntil\_.html](https://www.andrew.cmu.edu/course/60-257/reference/libraries/serial/Serial_readBytesUntil_.html)

Something was lost in translation from old site (2010) to current one and will be again to another language.

Let me know how I can help.  
I am already updating these for my own use.

---

<div class="post-metadata">

**Author:** ![REAS](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.processing.org/reas/32/16_2.png) [@REAS](https://discourse.processing.org/u/REAS)\
**Post date:** [February 28, 2020, 6:03pm UTC](https://discourse.processing.org/t/contribute-a-new-translation/17405/10 "2020-02-28T18:03:02Z")

</div>

For Reference errors, please either report them here [https://github.com/processing/processing-docs](https://github.com/processing/processing-docs) or make a pull request. We’re very grateful for Reference error reports.