processing / p5.js-website-legacy

Archived p5.js website 2015-2024
http://archive.p5js.org
MIT License
241 stars 484 forks source link

addition of a new language: src/data/nl.yml #1001

Open sharethewisdom opened 3 years ago

sharethewisdom commented 3 years ago

hi, the contributor's docs told be to open an issue here. I'm preparing a pull request for dutch (language code nl).

At the moment, this will only include the website's src/data/nl.yml file. I've translated most of it, some exceptions being references to external libraries, books and conferences. I carefully considered a language which is both expressive and inclusive. I still need a few days to fix thing here and there.

I've tried to start translating the reference, too, but that's not so easy: many programming terms are simply not translated in real life. The reason for my efforts is that I use p5js to coach 10-12 year olds at CoderDojo in Belgium. They know a fair bit of English, but it helps to give them to option to enable a context sensitive translation (unlike google translate). Please let me know to what degree it is acceptable to include a src/data/reference/nl.json that leaves a lot of English terminology unchanged. I generally prefer to only translate sentences/explanations.

edit: is there a reason why templates/pages/learn/p5-screen-reader.hbs is not templated with {{#i18n tags}}?

limzykenneth commented 3 years ago

@sharethewisdom It's great to see you are interested in translating p5.js into Dutch. I'm not currently aware of upcoming projects that adds additional languages to the official website at the moment and in general we err on the side of caution when adding new languages to the website as one of the things we consider is the long term maintenance of the materials, including translated version of the website, which means some level of continuous maintenance of the translation after the translation is "finished".

I'm not involved in the decision to add new languages to the website but at this point I would advice you to publish your translated version of the website onto a URL of your choosing (p5jsnl.org for example) and let us know what the URL is, we can list it as an unofficial translation of the website. If future projects came along that will translate the website into Dutch, whoever is working on it can also based their work off of it. Thanks.

limzykenneth commented 3 years ago

edit: is there a reason why templates/pages/learn/p5-screen-reader.hbs is not templated with {{#i18n tags}}?

It probably should be.

limzykenneth commented 3 years ago

On a personal note, I'm currently working on some research into translation on open source software and will probably need some help/perspectives of people working on translations as part of my research. If you are interested to be involved (will most probably be working on p5.js related materials), do let me know and I'll contact you with more details when available.

sharethewisdom commented 3 years ago

hi, thanks for your response. I'm coaching 10-14 year olds and I'd like to refer them to the official site. My understanding is that when the official site gets used in a particular community, like CoderDojo Netherlands and CoderDojo Belgium, there is stronger incentive for continued improvement on that language.

It would really help and motivate to have a part of the translation integrated, at least the introductions and the color and coordinates tutorials. Most kids know enough English by the age of 15 to manage on their own. Maybe one of them could prepare a pull request to improve translations and learn about git.

I used to translate subs for some of Dan Shiffman's video's but Google decided to remove that functionality. :rage:

sharethewisdom commented 3 years ago

I hope that this community continues to "recognize and encourage involvement of all kinds", especially translations, as they will diversify the community. I'd like to continue to maintain and translate the relevant files for a few years if the pull requests get through.

sharethewisdom commented 3 years ago

I'll see if I can publish a dutch version of the reference here.

sharethewisdom commented 3 years ago

see also https://github.com/processing/p5.js-website/issues/283