processing / processing/p5.js-website

Adding the Persian/Farsi translation to the website

Open
#1,594 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Discussion Feature Request
Dominant language
MDX
Stars
96
Forks
322
Avg merge
5d 22h
Merged PRs (30d)
8

Description

Increasing Access

The Farsi/Persian translation can help Farsi speakers who have limited knowledge of English, to better understand the documentation and educational materials on the website. This would be especially helpful for younger generations of Iranians, Afghans and Tajiks.
Integrating the Farsi lettering and RTL (right-to-left) direction would also lay the groundwork for adding Arabic in future.

Most appropriate sub-area of p5.js?

Tutorials

Feature request details

My friend Arash Ebrahimifar is doing the heavy work of the translation and editorial work, while I am helping him with complementary tasks and clarifying certain coding concepts and definitions. We may also have the assistance of other people along the process. All the texts will be reviewed by native speakers.

We have started the translation from the "Introduction to p5.js" section in Tutorials. Our strategy for preparing the translations is to start with the Tutorials and slowly add to the Reference, based on the hyperlinks or keywords that the readers might encounter through the Tutorials.

The primary issue would be the RTL layout. Especially when we want to add English texts or inline code, that text needs to remain in the right place and keep its own direction separate from the Farsi text. For example the inline functionName() need to stay in line within the Farsi paragraph while keeping its parentheses on the right-side.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the website's Tutorials, especially the "Introduction to p5.js" section, and inspect how tutorial text and inline code are rendered. Done means the translated material can be added with correct Persian/Farsi RTL layout, while English text and inline code retain their intended direction; the Reference can follow later.

Written by the indexing model from the issue text.

Assessment

Domain
accessibility, documentation, localization
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.