reactjs/fa.react.dev

New Persian Translation Progress

Opened this issue · 103 comments

gaearon commented

Maintainers

For New Translators

To translate a page:

  1. Check that no one else has claimed your page in the checklist and comments below.
  2. Comment below with the name of the page you would like to translate. Please take only one page at a time.
  3. Clone this repo, translate your page, and submit a pull request!

Before contributing, read the glossary and style guide (once they exist) to understand how to translate various technical and React-specific terms.

Please be prompt with your translations! If you find that you can't commit anymore, let the maintainers know so they can assign the page to someone else.

For Maintainers

When someone volunteers, edit this issue with the username of the volunteer, and with the PR. Ex:

When PRs are merged, make sure to mark that page as completed!

Main Content

To do before releasing as an "official" translation. Please translate these pages first.

Note that each section has an index page, which needs to be translated too.

Learn React

API Reference

  • react: Hooks

    • useCallback
    • useContext
    • useDebugValue
    • useDeferredValue
    • useEffect
    • useId
    • useImperativeHandle
    • useInsertionEffect
    • useLayoutEffect
    • useMemo
    • useReducer (@Atefeh-Masoumi)
    • useRef
    • useState
    • useSyncExternalStore
    • useTransition

  • react: Components

    • <Fragment> (<>)
    • <Profiler>
    • <StrictMode>
    • <Suspense>

  • react: APIs

    • createContext
    • forwardRef
    • lazy
    • memo
    • startTransition

  • react-dom: Components

    • Common (e.g. <div>)
    • <input>
    • <option>
    • <progress>
    • <select>
    • <textarea>

  • react-dom: APIs

    • createPortal
    • flushSync
    • findDOMNode
    • hydrate
    • render
    • unmountComponentAtNode

  • react-dom/client: Client APIs

    • createRoot
    • hydrateRoot

  • react-dom/server: Server APIs

    • renderToNodeStream
    • renderToPipeableStream
    • renderToReadableStream
    • renderToStaticMarkup
    • renderToStaticNodeStream
    • renderToString

Navigation and UI

We suggest to leave most of the UI translation until the end. We plan to do some invasive changes to the website folder layout and components, so postponing this until your translation is almost complete would make it easier to merge the changes from our side later. It might make sense to translate the homepage above the fold early, but leave the rest for later. As individual pages get translated, you can change the page titles in the corresponding sidebar files. Finally, when you're translating the navigation, make sure to test both desktop and mobile layouts.

  • Homepage (currently in HomeContent.js)
  • Sidebars (currently in src/sidebar*.json)
  • Top-level navigation (currently in TopNav.tsx)

When You're Ready...

After everything above is translated, add your language to deployedLanguages in Seo.tsx of the original reactjs/react.dev repository.

Secondary Content

These API pages should ideally be translated too, but they're less urgent and can be done after the others:

  • Legacy React APIs
    • Children
    • cloneElement
    • Component
    • createElement
    • createFactory
    • createRef
    • isValidElement
    • PureComponent

Optional Content

These aren't the main translation targets, but if you'd like to do them, feel free to expand the list to include their subpages:

  • Community
  • Blog
  • Warnings
gaearon commented

@sorousht @zahrajoulaei @sJJdGG @Schabaani @masoud-bahrami @rezvani2647

Could you please confirm whether you'd be able to steer and maintain this translation? I'd like to get the list in https://github.com/reactjs/translations.react.dev/blob/main/langs/fa.json up-to-date. Thank you!

sJJdGG commented

@gaearon Hi dan. You can count on me. I'm willing to put 10Hrs/week at least for the next 6 months.
I'd start by closing and merging current PRs and coordianting community effort for the translation of new docs.
If nobody shows up for translations, I'm going to translate new pages myself although it would be slower.

gaearon commented

Thanks! If it turns out that other maintainers are not active, please send a PR to https://github.com/reactjs/translations.react.dev/blob/main/langs/fa.json so that the list is up-to-date.

  • 👍1
sorousht commented

Hi @gaearon, unfortunately I can't maintain the translation project. If I find time in future, I pick it up again.

  • ❤️2
rezvani2647 commented
  • ❤️1
abolfazlchaman commented

Hi, hope you are well @gaearon how can I become a maintainer for this project?

I could definetly help translate as well if needed.

mohammad-hosein-shahpouri commented

Hi, I would like to translate "Installation" page

sJJdGG commented

Hi @mohammad-hosein-shahpouri
If you could start the translation and open the related PR, I can assign it to you as mentioned int the manual.
Thanks.

faeghe-hajiabadi commented

Hi @gaearon Dan, I would like to help on this page: 'Thinking in React'. Thanks

  • 👍1
amin-da commented

Hi @gaearon
Hi @sJJdGG
I would like to translate " Describing the UI" page
Thanks.

  • 👍1
nafasebra commented

Hello @gaearon
I am interested in becoming one of the maintainers of the fa.react.dev
Is it possible?

faeghe-hajiabadi commented

And i want translate bellow pages:
1- Quick Start
2- Tutorial: Tic Tac Toe
3 -Thinking in React

please check the list of ongoing pages in farsi repo. most of these are in progress. so you need to choose different pages

nafasebra commented

And i want translate bellow pages:
1- Quick Start
2- Tutorial: Tic Tac Toe
3 -Thinking in React

please check the list of ongoing pages in farsi repo. most of these are in progress. so you need to choose different pages

Isn't the list here?
So please send me the current check list for me.

nafasebra commented

I can translate these pages?
Your First Component

faeghe-hajiabadi commented

I can translate these pages? Your First Component

https://github.com/reactjs/fa.react.dev > بخش راهنمای مشارکت کنندگان

@rezvani2647 please help on this matter, for new joiners

rezvani2647 commented

I can translate these pages? Your First Component

@nafasebra sounds good, and thanks!

rezvani2647 commented

@mohammad-hosein-shahpouri "installation" was assigned to you.

rezvani2647 commented

@faeghe-hajiabadi "Thinking in React " was assigned to you.

rezvani2647 commented

@amin-da "Describing the UI" was assigned to you.

faeghe-hajiabadi commented

@faeghe-hajiabadi "Thinking in React " was assigned to you.

please review my first pr : #342 for thinking in react, almost half is done

rezvani2647 commented

@faeghe-hajiabadi "Thinking in React " was assigned to you.

please review my first pr : #342 for thinking in react, almost half is done

it was great!.
and it needs some improvements. so I wrote some comments for you. :)

  • 👍1
rezvani2647 commented

دوستانی که میخوان برای اولین بار ترجمه صفحات رو انجام بدن.
لطفا حتما بخش واژه‌نامه و بخش بحث در مورد واژه‌نامه را مطالعه کنند.
مرسی از لطف همتون

  • 👍3
sr-ssh commented

Hi @rezvani2647
I would like to participate in translating Responding to Events .
thanks :)

  • 👍1
rezvani2647 commented

Hi @rezvani2647 I would like to participate in translating Responding to Events . thanks :)

it's assigned to you.
thank you as well.

  • 👍1
sr-ssh commented

Hi @rezvani2647
I have finished the Responding to Events part and it is pended for review. I also want to participate in translating Adding Interactivity part completely.
thanks

faeghe-hajiabadi commented

Hi, #346 reviewed, please check the comments. Thank you for your time and effort
@sr-ssh

  • 👍1
sr-ssh commented

hi @faeghe-hajiabadi
I have some more questions in #346 . would you please help .

  • ❤️1
faeghe-hajiabadi commented

please assign it to me: State: A Component's Memory
@rezvani2647

faeghe-hajiabadi commented

please help to review the revised PR for the "thinking in React" page:
#344
cc @rezvani2647 @abolfazlchaman

faeghe-hajiabadi commented

hi @faeghe-hajiabadi I have some more questions in #346 . would you please help .

please check this link for any .md file's result in vscode: https://code.visualstudio.com/docs/languages/markdown

rezvani2647 commented

please assign it to me: State: A Component's Memory @rezvani2647

@faeghe-hajiabadi State: A Component's Memory was assigned to you.

  • 🎉1
rezvani2647 commented

Hi @rezvani2647 I have finished the Responding to Events part and it is pended for review. I also want to participate in translating Adding Interactivity part completely. thanks

@sr-ssh many thanks to you.
after I finished reviewing your PR, I will assign that page to you.

  • 👍1
  • 😄1
  • 🎉1
nikch97 commented

Hello @gaearon , @rezvani2647
Could you please assign the page ' Reacting to Input with State' to me?
Thank you

  • 👍1
rezvani2647 commented

@nikch97 yes of course, it's assigned to you.

  • 👍1
faeghe-hajiabadi commented

Please assign to me: adding interactivity and also some more pull requests

faeghe-hajiabadi commented

@nikch97 @sr-ssh @nafasebra and all dear devs, please refer to this page to start your translations: how to start?, any questions about how to start and what format is accepted please just drop me an email at: faeghe.hajiabadi@gmail.com or leave a comment on my fork
Thank you

  • 👍1
AlirezaBs commented

Can I request to translate, or is more experience needed?

rezvani2647 commented

Can I request to translate, or is more experience needed?

by experience you mean a certificate, then i should say no. you do not need any certificates here. but of course your translation will carefully reviewed and it should be correct and fluent.

AlirezaBs commented

Can I request to translate, or is more experience needed?

by experience you mean a certificate, then i should say no. you do not need any certificates here. but of course your translation will carefully reviewed and it should be correct and fluent.

thanks for your answer, can I translate Choosing the State Structure page in adding Interactivity section?

rezvani2647 commented

Can I request to translate, or is more experience needed?

by experience you mean a certificate, then i should say no. you do not need any certificates here. but of course your translation will carefully reviewed and it should be correct and fluent.

thanks for your answer, can I translate Choosing the State Structure page in adding Interactivity section?

it's assign to you, good luck.

  • 👍1
Ehsan-Yari commented

Hi @rezvani2647
I would like to participate in translating Sharing State Between Components .
thanks <3

  • 👍1
nikch97 commented

@nikch97 @sr-ssh @nafasebra and all dear devs, please refer to this page to start your translations: how to start?, any questions about how to start and what format is accepted please just drop me an email at: faeghe.hajiabadi@gmail.com or leave a comment on my fork Thank you

Hello, is there any finished translation in the project that I can see it?
I found "thinking-in-react" , but it has error and does not work properly, Could you assist with this?
Here is the error that I get on my machine :
error

  • 👍1
faeghe-hajiabadi commented

@nikch97 @sr-ssh @nafasebra and all dear devs, please refer to this page to start your translations: how to start?, any questions about how to start and what format is accepted please just drop me an email at: faeghe.hajiabadi@gmail.com or leave a comment on my fork Thank you

Hello, is there any finished translation in the project that I can see it? I found "thinking-in-react" , but it has error and does not work properly, Could you assist with this? Here is the error that I get on my machine : error

Thank you. PR NO: 358 raised to fix this issue

  • 👍1
faeghe-hajiabadi commented

Hi @rezvani2647 I would like to participate in translating Sharing State Between Components . thanks <3

Assigned to you, please start

  • 👍1
  • ❤️1
mohammadrezanamjoo commented

Hi @rezvani2647
I would like to participate in translating Updating Objects in State .
regards

rezvani2647 commented

Hi @rezvani2647 I would like to participate in translating Updating Objects in State . regards

it's assign to you, good luck.

Jam-Hejrati commented

Dear @rezvani2647
Hi
May I participate to translate the page "Editor Setup" ?
Best regards.

rezvani2647 commented

Dear @rezvani2647 Hi May I participate to translate the page "Editor Setup" ? Best regards.

Of course. we will be glad. it's assigned to you, good luck.

Hadi-bakhshi commented

Dear @rezvani2647
Hello
I would like to be a translation participant.
May I translate page "Render and Commit" ?
I can translate many more pages if it is possible.

Thanks in advance

  • 👍1
faeghe-hajiabadi commented

Dear @rezvani2647 Hello I would like to be a translation participant. May I translate page "Render and Commit" ? I can translate many more pages if it is possible.

Thanks in advance

please check the list of taken ones, this one is taken

Hadi-bakhshi commented

@rezvani2647
How about "Extracting State Logic into a Reducer" and "Preserving and Resetting State"?

  • 👍1
bolbolamir commented

Hi, I would like to translate "Manipulating the DOM with Refs", if you don't mind

  • 👍1
masoudmhmdi commented

Dear @rezvani2647
Hi
May I participate to translate the page "State as a Snapshot" ?

rezvani2647 commented

@rezvani2647 How about "Extracting State Logic into a Reducer" and "Preserving and Resetting State"?

it's assigned to you, good luck.

rezvani2647 commented

Hi, I would like to translate "Manipulating the DOM with Refs", if you don't mind

it's assigned to you, good luck.

rezvani2647 commented

Dear @rezvani2647 Hi May I participate to translate the page "State as a Snapshot" ?

it's assigned to you, good luck.

nafasebra commented

@nikch97 @sr-ssh @nafasebra and all dear devs, please refer to this page to start your translations: how to start?, any questions about how to start and what format is accepted please just drop me an email at: faeghe.hajiabadi@gmail.com or leave a comment on my fork Thank you

I was start to translate my selected page. ✌

  • 👍1
faeghe-hajiabadi commented

Dear @rezvani2647 Hi May I participate to translate the page "State as a Snapshot" ?

sorry this page is taken, please take another one or review the pr which I will raise soon. thank you

  • 👍1
masoudmhmdi commented

Dear @rezvani2647 Hi May I participate to translate the page "State as a Snapshot" ?

sorry this page is taken, please take another one or review the pr which I will raise soon. thank you

I can choose another page
Consider "Passing Props to a Component" instead. thank you

sr-ssh commented

I have done Responding to Events but it isn't merged yet. I'm waiting for this merge to do a new translation.
@faeghe-hajiabadi @rezvani2647

  • 👍2
faeghe-hajiabadi commented

I have done Responding to Events but it isn't merged yet. I'm waiting for this merge to do a new translation. @faeghe-hajiabadi @rezvani2647

لطفا دوباره پی ار رو باز کنین تا ما بتونیم مرج کنیم.

  • 👍1
faeghe-hajiabadi commented

everyone, please help to review some PRs (not yours) in order to make the PR review better and more general!
PR NOs: #355 #361 #359 #360

rezvani2647 commented

Dear @rezvani2647 Hi May I participate to translate the page "State as a Snapshot" ?

sorry this page is taken, please take another one or review the pr which I will raise soon. thank you

I can choose another page Consider "Passing Props to a Component" instead. thank you

it's Done, good luck.

next time please make sure before you ask because another person may want to translate the page but they don't ask for it because you tended to do so.

  • ❤️1
behrouz-shafaati commented

Hi, I want to translate 'Queueing a Series of State Updates.' Thanks!

Jam-Hejrati commented

Hi @rezvani2647
The page "Editor Setup" translated & I made a pull request
Sincerely.

  • ❤️1
sr-ssh commented

Hi @faeghe-hajiabadi , @rezvani2647 . Thanks for the merge on my last branch. Can you assing me the Conditional Rendering part as well.

  • 🚀1
rezvani2647 commented

Hi @faeghe-hajiabadi , @rezvani2647 . Thanks for the merge on my last branch. Can you assing me the Conditional Rendering part as well.

it's assigned to you, good luck.

behrouz-shafaati commented

Hi @faeghe-hajiabadi , @rezvani2647 . can i translate 'Queueing a Series of State Updates' page? Thanks!

  • 🚀2
rezvani2647 commented

Hi @faeghe-hajiabadi , @rezvani2647 . can i translate 'Queueing a Series of State Updates' page? Thanks!

it's assigned to you, good luck.

faeghe-hajiabadi commented

here is a simple wiki page in Farsi for everyone to learn about how to avoid errors. please read it before raising PR. Thanks

behrouz-shafaati commented

Hi @faeghe-hajiabadi, @rezvani2647. I have finished the translation of 'Queueing a Series of State Updates' and have set the PL (Pull Request) for it. Please check it. Now, I would like to translate 'Passing Data Deeply with Context' if it's possible. Thanks :)

faeghe-hajiabadi commented

Hi @faeghe-hajiabadi, @rezvani2647. I have finished the translation of 'Queueing a Series of State Updates' and have set the PL (Pull Request) for it. Please check it. Now, I would like to translate 'Passing Data Deeply with Context' if it's possible. Thanks :)

I have reviewed the PR, I guess some parts are not clear. can you please send us the screenshot of the working localhost with no errors? Passing Data Deeply with Context is assigned to you.

  • 👍1
ami87878 commented

hi, i so excited to find this repo and to help to translate document of React to Persian i for first time i want translate Writing Markup with JSX page if no one has been chosen it

nafasebra commented

Hello, I have worked on the 'your-first-component' page and have fully translated it.
Please review this pull request (PR #385)
@faeghe-hajiabadi @rezvani2647

rezvani2647 commented
nafasebra commented

Hello, thanks for merging my PR.
Can i translate 'Importing and Exporting Components' page?

nikch97 commented

@rezvani2647
Hi there. could you please merge PR #382 as well?
Thank you

Atefeh-Masoumi commented

Hi Can I translate Keeping Components Pure page?

minajalili commented

@rezvani2647
Hello, I would like to translate the page titled 'Scaling Up with Reducer and Context'. Is that possible?

faeghe-hajiabadi commented

@rezvani2647 Hello, I would like to translate the page titled 'Scaling Up with Reducer and Context'. Is that possible?

it is assigned to you, good luck!

faeghe-hajiabadi commented

Hi Can I translate Keeping Components Pure page?

assigned to you, good luck!

faeghe-hajiabadi commented

Hello, thanks for merging my PR. Can i translate 'Importing and Exporting Components' page?

assigned to you. good luck!

Atefeh-Masoumi commented

Hello I would like to translate useReducer in API Reference section

nafasebra commented

Hi,
I have translated the ‘importing-and-exporting-components’ page. Could you please review this pull request (PR #391)?
@faeghe-hajiabadi @rezvani2647

sr-ssh commented

Hi,
I have translated the conditional rendering page. Could you please review this pull request (PR #392) and assign me Escape Hatches page?
thanks
@faeghe-hajiabadi @rezvani2647

rezvani2647 commented

Hello I would like to translate useReducer in API Reference section

Assigned to you. Good luck!

Abolfazl2647 commented

Hi, I want to translate 'Queueing a Series of State Updates.' Thanks!

Your PR about "Queueing a Series of State Updates" has been merged.
Thank your for your time.

Abolfazl2647 commented

@nafasebra
Your PR "importing-and-exporting-components" has been merged.
Thank your for your time.

Atefeh-Masoumi commented

@Abolfazl2647 @faeghe-hajiabadi could you please review and merge my pull request for Translate: translate 'Keeping Components Pure' page to Farsi. #388?

  • 🚀1
minajalili commented

Hi, I have worked on the 'scaling-up-with-reducer-and-context' page and have fully translated it.
Please review this pull request (PR #390)
@faeghe-hajiabadi @rezvani2647

  • 🚀1
rezvani2647 commented

@sr-ssh
Your PR "translated the conditional rendering" has been merged.
Thank your for your time.

  • 👍1
sr-ssh commented

Hi,
Would you please assign me Escape Hatches page?
thanks
@faeghe-hajiabadi @rezvani2647

Mahdi-Hazrati commented

Hello! As a new translator for React, I’d like to contribute by translating the Tutorial: Tic-Tac-Toe page on the React website. Could you please assign this task to me? Thank you! 😊

Mahdi-Hazrati commented

Hello! As a new translator for React, I’d like to contribute by translating the Tutorial: Tic-Tac-Toe page on the React website. Could you please assign this task to me? Thank you! 😊

@gaearon

ablfaxl commented

Hello! As new translator for React, i'd want to contribute by translating the " Start a New React Project" page on React Web.
Could you please assing this task to me ? Thanks 🙏
@rezvani2647 @gaearon

rezvani2647 commented

Hi, Would you please assign me Escape Hatches page? thanks @faeghe-hajiabadi @rezvani2647

Please be more specific.

rezvani2647 commented

Hello! As a new translator for React, I’d like to contribute by translating the Tutorial: Tic-Tac-Toe page on the React website. Could you please assign this task to me? Thank you! 😊

it's assigned to you, good luck.

rezvani2647 commented

Hello! As new translator for React, i'd want to contribute by translating the " Start a New React Project" page on React Web. Could you please assing this task to me ? Thanks 🙏 @rezvani2647 @gaearon

it's assigned to you, good luck.

  • ❤️1
abolfazlchaman commented

Hello Mr. @rezvani2647
As i have previously talked with Mr. @sJJdGG about becoming a co-maintainer of this repo and part time translator and pr reviewer in private,

i would like to discuss things further with you sir.
Could you please provide me with a Telegram or WhatsApp handle sir?

Many thanks,
-Abolfazl chaman

  • ❤️1
mrbadri commented

Hi,

Could you please add the React Reference Overview to your TODO list in the API Reference section?

Thanks!