Add French 🇫🇷 language support

[alanakra]

Topic

I would like to offer my contribution as a translator to make the p5.js website accessible in French.
As a front-end developer with a solid background in web development and French as my first language, I'm motivated by the idea of making this fantastic tool more accessible to the French-speaking community and especially to curious young people who don't necessarily have a good grounding in English to enable them to read the documentation properly and make to more accessible to them.
However, I am aware that doing this work alone will be a complicated task. That's why I'm calling on other French speakers who might be interested in this work to draw up a roadmap and ensure that the work is carried out with maximum quality assurance.
Thanks 👋

[multiverseweb]

Hey @alanakra, I believe that most modern browsers, such as Chrome, already offer built-in translation capabilities that automatically detect and translate webpages, providing a convenient solution for users. Considering this, it might not be entirely necessary to add a dedicated translation feature.

[Ankitgkp]

Is this issue still open can i work on this?

[alanakra]

Hey @Ankitgkp,
I'm still working in this issue.
I've already started the project on this fork:
I've started by translating the main pages. The key point (which I haven't had time to work on yet) is the ‘reference’ page and the various associated p5 functions. Don't hesitate to contact me for more information. Luckily I've planned to continue this weekend.

[ksen0]

Hi @Ankitgkp and @alanakra! It's really awesome if you want to create a French-language fork!

Please feel free to continue to organize here, and perhaps there's other on Discourse, such as these contributors from a few years ago that might be interested in your project? Anyone working on a translation fork of the website if also of course welcomed to add themselves to the all-contributors list for 🌍 translation.

Some other things that might be useful:

• There is an active community-maintained Japanese website fork here that might be inspiring: https://github.com/p5js-i18n-ja
• Keep in mind that the English translation is auto-generated during the website build process from data.json, which is based on the p5.js JSDoc-style reference in the core library. The translated .mdx files are only on the website, but the English files reflect the documentation in the code. There is a new major release that will be available soon that will, at the end of March 2025, have updated documentation. The timeline is spread until August 2026 (next year!) and the new docs will live on a beta website. So it is definitely very useful to have a French translation of 1.x for a while, and if you end up wanting to expand the project, there will be new updates coming up shortly.

Lastly, if you do publish a French translation that you'd like to like to share more widely, please feel free to make a PR adding your website to Education Resources.

[lamitafarah]

Hello, I would like to help translating to French, can someone guide me on where to start!

[alanakra]

Hi @Ankitgkp & @lamitafarah, thanks for your enthusiasm!
The message posted by @ksen0 about the Japanese community creating an organisation containing the fork of the website in Japanese inspired me to do the same. We could also set up a common glossary of words like the one proposed by the Korean p5.js community. As I explained in my previous messages, I'm currently working and it's complicated for me to work on this task alone, but I'd still like something serious rather than something badly organised.
So I'm thinking of creating a GitHub organisation where I'll transfer my fork in order to be more visible! I'll do it by the end of the week.
@ksen0 i'll translate the Code of Conduct as soon as possible 😊.

[lamitafarah]

Hi @alanakra, this sounds good! Should we create a Slack server (or use any other messaging/collaborating platform) to facilitate the communication and help us work effectively with all the contributors?

[davepagurek]

In case it's helpful, in the p5.js Discord, you can make a new group in the Groups section (some local meetups use that!) So feel free to do whatever's easiest, be that a Slack you run or a group in discord or something else 🙂

[alanakra]

UPDATE: I have transferred my fork to an organisation I have created dedicated to the French translation of the p5 website. The link is here 🚀.