@c0m1t - Hook intro #12

sorousht · 2019-02-15T19:18:16Z

This PR was originally made by @c0m1t. Because he/she targeted master directly, I had to close the original one, and submit this PR to fa branch.

Update master

zahrajoulaei

نظر من اینه که هدف ما صرفا ترجمه ی سریع و بدون توجه یک صفحه نیست!
اصلا اصراری نداریم خیلی سریع کل یک صفحه رو سرهم کنیم اما کیفیتی توش نبینیم.
من پیشنهاد میکنم خودتون رو بزارین جای دانشجو و دانش آموزی که به دلیل خوب نبودن سطح زبانش مجبور شده به صفحه فارسی رجوع کنه، و در مرحله ی بعد کسی رو تصور کنید که زبانش هم خوبه اما انقدر ترجمه ی فارسی ری اکت رو با کیفیت دیده که تصمیم گرفته فارسیش رو بخونه!
پس لطفا جوری بنویسید که تمام متن موقع خوندن قابل فهم باشه و احترام به شعور خواننده باشه و در افراد انگیزه و شوق ادامه رو ایجاد کنه
با تشکر

zahrajoulaei · 2019-02-16T13:23:49Z

content/docs/hooks-intro.md

-At React Conf 2018, Sophie Alpert and Dan Abramov introduced Hooks, followed by Ryan Florence demonstrating how to refactor an application to use them. Watch the video here:
+<blockquote dir="rtl">
+<p>نکته</p>
+<p>ری‌‌اکت ۱۶.۸.۰ اولین نسخه منتشر شده است که از هوک‌‌ها پشتیبانی می‌‌کند. هنگام ارتقاع، فراموش نکنید همه‌‌ی پکیج‌‌ها شامل React DOM را آپدیت نمایید. React Native در نسخه‌‌ی بعدی پایدار از هوک‌‌ها پشتیبانی خواهد کرد. </p>


@c0m1t @sorousht
از املای این کلمه مطمین هستین؟

من فکر میکنم ارتقاء درست باشد.

http://www.vajehyab.com/dehkhoda/%D8%A7%D8%B1%D8%AA%D9%82%D8%A7%D8%A1

zahrajoulaei · 2019-02-16T13:26:03Z

content/docs/hooks-intro.md


-## No Breaking Changes {#no-breaking-changes}
+<p dir="rtl">در کنفرانس ۲۰۱۸ react، سوفیا آلپرت(Sophie Alpert) و دن آبرامف(Dan Abramov) هوک‌‌ها را معرفی کردند. بعد از آن رایان فلورنس (Ryan Florence) نشان داد که چگونه می‌‌توان به منظور استفاده از آنها[هوک‌‌ها] یک اپلیکیشن را بازنویسی(refactor) کرد. ویدیوی زیر را ببینید:</p>


دو اسم سوفی و سوفیا کاملا دو اسم متفاوت هستن.
در اینجا اسم شخص سوفی هست.

@sorousht @c0m1t

zahrajoulaei · 2019-02-16T13:28:35Z

content/docs/hooks-intro.md


-## Motivation {#motivation}
+<ul dir="rtl">
+<li><strong>کاملا اختیاری.</strong> شما می‌‌توانید هوک‌‌ها را  بدون نیاز به دوباره نوشتن کدهای قبلی، در چند کامپوننت جدید امتحان کنید. ولی شما در صورت عدم تمایل،‌‌ مجبور به فراگیریی یا استفاده از هوک‌‌ها کنید.</li>


ولی شما در صورت عدم تمایل،‌‌ مجبور به فراگیریی یا استفاده از هوک‌‌ها کنید
!این جمله اصلا ساختار اشتباهی دارد

@sorousht @c0m1t

zahrajoulaei · 2019-02-16T13:35:38Z

content/docs/hooks-intro.md


-### Complex components become hard to understand {#complex-components-become-hard-to-understand}
+<p dir="rtl">ری‌‌اکت راهی برای «اضافه‌کردن» یک رفتار  قابل استفاده‌‌ی مجدد یه یک کامپوننت را فراهم نمی‌‌کند (برای مثال اتصال به یک store). اگر شما مدتی با ری‌‌اکت کار کرده باشید، ممکن است با الگوهایی مانند <a href="/docs/render-props.html">render props</a> و <a href="/docs/higher-order-components.html">higher-order components</a> آشنا باشید که سعی در حل این مسیله دارند.  اما این الگوها شما را مجبور به تغییر ساختار مجدد کامپوننتتان هنگام استفاده‌‌ از آن‌‌ها می‌‌کنند، که این مسیله می‌‌تواند مایه‌‌ی زحمت و سخت‌‌تر شدن فهم کد باشد. اگر به یک اپلیکیشن ری‌‌اکت نوعی در React DevTools نگاه کنید، احتمالا با «wrapper hell»ای از کامپوننت‌‌ها مواجه می‌‌شوید. کامپوننت‌‌هایی که با لایه‌‌هایی از providerها، consumerها، HOCها، render props و دیگر کامپوننت‌‌هایی که به تجرید کمک می‌‌کنند، احاطه شده‌‌اند.  در حالی که ما می‌‌توانیم <a href="https://github.com/facebook/react-devtools/pull/503">آن‌‌ها را در DevTools فیلتر کنیم</a>، این [مشکل] به یک مسیله‌‌ی بنیادین اشاره دارد: ری‌‌اکت باید عناصری ابتدایی برای به اشتراک گذاری منطق دارای state فراهم کند.</p>


احتمالا با «wrapper hell»ای از کامپوننت‌‌ها مواجه می‌‌شوید
@sorousht پیشنهادی برای جایگزینی این قسمت نداری؟
نظر من اینه که این نوع ترجمه اصلا کمکی به فهم خواننده نمیکنه و بدتر گیجش میکنه.

خود من موقع یادگیری ری‌اکت از روی داکیومنتیشن، به یه سری چیزای اینطوری بر خوردم که مجبور شدم برم و از سورس‌های دیگه نگاه کنم. ولی قطعا این خیلی خوبه که داکیومنتیشن طوری کامل باشه که مخاطب با خوندنش بدون نیاز به منابع خارجی بتونه کلیت همه چی رو بفهمه.
برای wrapper hell معادل فارسی‌ای ندارم ولی اگه هدف صرف ترجمه نباشه و امکان اضافه کردن توضیحات یا عکس برای رسوندن بیشتر مفهوم امکان‌پذیر باشه، میشه این قسمت رو بهبود داد.

zahrajoulaei · 2019-02-16T13:38:49Z

content/docs/hooks-intro.md


-In many cases it's not possible to break these components into smaller ones because the stateful logic is all over the place. It's also difficult to test them. This is one of the reasons many people prefer to combine React with a separate state management library. However, that often introduces too much abstraction, requires you to jump between different files, and makes reusing components more difficult.
+<p dir="rtl">ما در این رابطه بیشتر در  <a href="/docs/hooks-custom.html">هوک مخصوص خود را بسازید</a> بحث خواهیم کرد.</p>


!این جمله اصلا ساختار اشتباهی دارد
پیشنهاد میکنم یکبار متنی که خودتون نوشتین رو از دید یک دانشجو یا دانش آموز بخونید. آیا به نظرتون روانه ؟!
@sorousht @c0m1t

.ما در این رابطه بیشتر در فلان بخش بحث خواهیم کرد
بنظر من مشکلی نداره البته اگر پیشنهادی دارین حتما بگین

zahrajoulaei · 2019-02-16T13:45:21Z

content/docs/hooks-intro.md


-## Gradual Adoption Strategy {#gradual-adoption-strategy}
+<p dir="rtl">بعلاوه، ری‌‌اکت ۵ سال است که عرضه شده است، و ما می‌‌خواهیم در ۵ سال آینده مطرح باشد. همانطور که <a href="https://svelte.technology/">Svelte</a>، <a href="https://angular.io/">Angular</a>،<a href="https://glimmerjs.com/">Glimmer</a>و دیگران نشان می‌‌دهند، <a href="https://en.wikipedia.org/wiki/Ahead-of-time_compilation">کامپایل پیش از موعد</a> کامپوننت‌‌ها، پتانسیل قابلیت‌‌های زیادی را دارد. بالاخص اگر به تمپلت‌‌ها مححدود نباشد. ما اخیرا  با


غلط املایی:
محدود
@sorousht @c0m1t

zahrajoulaei · 2019-02-16T13:49:06Z

content/docs/hooks-intro.md


-## Frequently Asked Questions {#frequently-asked-questions}
+<p dir="rtl"><strong>اساسا، هوک ها در کنار کدهای نوشته‌‌شده از قبل کار خواهند کرد، پس شما می‌‌توانید بصورت تدریجی از آن‌‌ها بهره گیرید.</strong> ما این API آزمایشی را برای این به اشتراک  می‌‌گذاریم تا بتوانیم از بازخوردهای سریع افراد در جامعه که برای شکل دادن به آینده‌‌ی ری‌‌اکت مشتاق هستند بهره گیریم. — and we will iterate on Hooks in the open.</p>


and we will iterate on Hooks in the open
دلیل ترجمه نکردن این بخش چیست؟

ما بصورت عمومی سعی در بهبود هوک‌ها داریم؟

zahrajoulaei · 2019-02-16T13:50:14Z

content/docs/hooks-intro.md


-We've prepared a [Hooks FAQ page](/docs/hooks-faq.html) that answers the most common questions about Hooks.
+<p dir="rtl">در انتها، هیچ عجله‌‌ای برای مهاجرت به هوک‌‌ها وجود ندارد. ما پیشنهاد می‌‌کنیم از هرگونه «بازنویسی بزرگ» بپرهیزید، مخصوصا برای کامپوننت‌‌های کلاسی موجود و پیچیده. برای «تفکر مبتنی بر هوک‌‌ها» مقداری نیازمند تامل است.  تجربه‌‌ی ما این است که بهترین کار برای شروع، تمرین و کار با هوک‌‌ها در کامپوننت‌‌های جدید و غیرحیاتی است، و حصول اطمینان از اینکه همه‌‌ی افراد تیم شما با آن‌‌ها ارتباط برقرار کرده‌‌اند. بعد از اینکه هوک‌‌ها را امتحان کردید، لطفا <a href="https://github.com/facebook/react/issues/new">بازخوردهای خود را برای ما بفرستید</a> ، چه مثبت و چه منفی.</p>


برای «تفکر مبتنی بر هوک‌‌ها» مقداری نیازمند تامل است.
ساختار این جمله غلط است!

تفکر مبتنی بر هوک‌ها نیازمند تغییر در نگرش ماست

Sync with reactjs.org @ 99e97c3

zahrajoulaei · 2019-02-26T10:50:27Z

Hey.there is no new changes for this PR?
I am checking to accept the changes and merge them...
@sorousht @c0m1t

sorousht · 2019-02-26T11:59:31Z

@zahrajoulaei It's been a long time since @c0m1t have opened this PR. I know it isn't well written and does not meet our standards for being published, so I'm going to retouch and improve as much as possible by tonight.

sorousht and others added 3 commits February 12, 2019 02:50

Merge pull request reactjs#8 from reactjs/fa

4f5e55f

Update master

hook-intro translated, v.1.0

42c9a89

minor fixes and remove unicode chars

0d9c3f5

sorousht self-assigned this Feb 15, 2019

sorousht requested review from masoud-bahrami, zahrajoulaei and Schabaani February 15, 2019 19:18

sorousht changed the title ~~C0m1t - Hook intro~~ @c0m1t - Hook intro Feb 15, 2019

sorousht mentioned this pull request Feb 15, 2019

Hook intro #11

Closed

zahrajoulaei requested changes Feb 16, 2019

View reviewed changes

asantarissy pushed a commit to asantarissy/fa.reactjs.org that referenced this pull request Feb 24, 2019

Merge pull request reactjs#12 from reactjs/sync-99e97c33

cd6ca87

Sync with reactjs.org @ 99e97c3

sorousht merged commit 0d9c3f5 into reactjs:fa Feb 27, 2019

tesseralis mentioned this pull request Mar 1, 2019

[OLD] Legacy Persian Translation Progress #1

Closed

87 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

@c0m1t - Hook intro #12

@c0m1t - Hook intro #12

sorousht commented Feb 15, 2019

zahrajoulaei left a comment

zahrajoulaei Feb 16, 2019

zahrajoulaei Feb 16, 2019

zahrajoulaei Feb 16, 2019

zahrajoulaei Feb 16, 2019

c0m1t Feb 17, 2019

zahrajoulaei Feb 16, 2019

c0m1t Feb 17, 2019

zahrajoulaei Feb 16, 2019

zahrajoulaei Feb 16, 2019

c0m1t Feb 17, 2019

zahrajoulaei Feb 16, 2019

c0m1t Feb 17, 2019

zahrajoulaei commented Feb 26, 2019

sorousht commented Feb 26, 2019


		## No Breaking Changes {#no-breaking-changes}
		<p dir="rtl">در کنفرانس ۲۰۱۸ react، سوفیا آلپرت(Sophie Alpert) و دن آبرامف(Dan Abramov) هوک‌‌ها را معرفی کردند. بعد از آن رایان فلورنس (Ryan Florence) نشان داد که چگونه می‌‌توان به منظور استفاده از آنها[هوک‌‌ها] یک اپلیکیشن را بازنویسی(refactor) کرد. ویدیوی زیر را ببینید:</p>


		### Complex components become hard to understand {#complex-components-become-hard-to-understand}
		<p dir="rtl">ری‌‌اکت راهی برای «اضافه‌کردن» یک رفتار قابل استفاده‌‌ی مجدد یه یک کامپوننت را فراهم نمی‌‌کند (برای مثال اتصال به یک store). اگر شما مدتی با ری‌‌اکت کار کرده باشید، ممکن است با الگوهایی مانند <a href="/docs/render-props.html">render props</a> و <a href="/docs/higher-order-components.html">higher-order components</a> آشنا باشید که سعی در حل این مسیله دارند. اما این الگوها شما را مجبور به تغییر ساختار مجدد کامپوننتتان هنگام استفاده‌‌ از آن‌‌ها می‌‌کنند، که این مسیله می‌‌تواند مایه‌‌ی زحمت و سخت‌‌تر شدن فهم کد باشد. اگر به یک اپلیکیشن ری‌‌اکت نوعی در React DevTools نگاه کنید، احتمالا با «wrapper hell»ای از کامپوننت‌‌ها مواجه می‌‌شوید. کامپوننت‌‌هایی که با لایه‌‌هایی از providerها، consumerها، HOCها، render props و دیگر کامپوننت‌‌هایی که به تجرید کمک می‌‌کنند، احاطه شده‌‌اند. در حالی که ما می‌‌توانیم <a href="https://github.com/facebook/react-devtools/pull/503">آن‌‌ها را در DevTools فیلتر کنیم</a>، این [مشکل] به یک مسیله‌‌ی بنیادین اشاره دارد: ری‌‌اکت باید عناصری ابتدایی برای به اشتراک گذاری منطق دارای state فراهم کند.</p>


		In many cases it's not possible to break these components into smaller ones because the stateful logic is all over the place. It's also difficult to test them. This is one of the reasons many people prefer to combine React with a separate state management library. However, that often introduces too much abstraction, requires you to jump between different files, and makes reusing components more difficult.
		<p dir="rtl">ما در این رابطه بیشتر در <a href="/docs/hooks-custom.html">هوک مخصوص خود را بسازید</a> بحث خواهیم کرد.</p>


		## Gradual Adoption Strategy {#gradual-adoption-strategy}
		<p dir="rtl">بعلاوه، ری‌‌اکت ۵ سال است که عرضه شده است، و ما می‌‌خواهیم در ۵ سال آینده مطرح باشد. همانطور که <a href="https://svelte.technology/">Svelte</a>، <a href="https://angular.io/">Angular</a>،<a href="https://glimmerjs.com/">Glimmer</a>و دیگران نشان می‌‌دهند، <a href="https://en.wikipedia.org/wiki/Ahead-of-time_compilation">کامپایل پیش از موعد</a> کامپوننت‌‌ها، پتانسیل قابلیت‌‌های زیادی را دارد. بالاخص اگر به تمپلت‌‌ها مححدود نباشد. ما اخیرا با


		## Frequently Asked Questions {#frequently-asked-questions}
		<p dir="rtl"><strong>اساسا، هوک ها در کنار کدهای نوشته‌‌شده از قبل کار خواهند کرد، پس شما می‌‌توانید بصورت تدریجی از آن‌‌ها بهره گیرید.</strong> ما این API آزمایشی را برای این به اشتراک می‌‌گذاریم تا بتوانیم از بازخوردهای سریع افراد در جامعه که برای شکل دادن به آینده‌‌ی ری‌‌اکت مشتاق هستند بهره گیریم. — and we will iterate on Hooks in the open.</p>


		We've prepared a [Hooks FAQ page](/docs/hooks-faq.html) that answers the most common questions about Hooks.
		<p dir="rtl">در انتها، هیچ عجله‌‌ای برای مهاجرت به هوک‌‌ها وجود ندارد. ما پیشنهاد می‌‌کنیم از هرگونه «بازنویسی بزرگ» بپرهیزید، مخصوصا برای کامپوننت‌‌های کلاسی موجود و پیچیده. برای «تفکر مبتنی بر هوک‌‌ها» مقداری نیازمند تامل است. تجربه‌‌ی ما این است که بهترین کار برای شروع، تمرین و کار با هوک‌‌ها در کامپوننت‌‌های جدید و غیرحیاتی است، و حصول اطمینان از اینکه همه‌‌ی افراد تیم شما با آن‌‌ها ارتباط برقرار کرده‌‌اند. بعد از اینکه هوک‌‌ها را امتحان کردید، لطفا <a href="https://github.com/facebook/react/issues/new">بازخوردهای خود را برای ما بفرستید</a> ، چه مثبت و چه منفی.</p>

@c0m1t - Hook intro #12

@c0m1t - Hook intro #12

Conversation

sorousht commented Feb 15, 2019

zahrajoulaei left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

zahrajoulaei commented Feb 26, 2019

sorousht commented Feb 26, 2019