Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add French 🇫🇷 language support #640

Open
alanakra opened this issue Nov 20, 2024 · 4 comments
Open

Add French 🇫🇷 language support #640

alanakra opened this issue Nov 20, 2024 · 4 comments
Labels

Comments

@alanakra
Copy link

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
Copy link

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
Copy link

Ankitgkp commented Feb 5, 2025

Is this issue still open can i work on this?

@alanakra
Copy link
Author

alanakra commented Feb 5, 2025

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
Copy link
Contributor

ksen0 commented Feb 19, 2025

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.

@ksen0 ksen0 added Help Wanted Extra attention is needed Translation labels Feb 19, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

4 participants