از علاقه شما برای توسعه اسناد ری‌اکت به زبان فارسی سپاسگذاریم و این برای ما ارزشمند است. برای شروع آماده‌اید؟
در توضیحات موضوع 1# لیست صفحاتی که نیاز به ترجمه دارد آورده شدهاست. اولویت ما شروع از صفحات Core Pages، با ترتیبی است که مشخص شدهاست. یکی از صفحاتی را که به موضوع آن علاقه‌مند هستید را برای شروع انتخاب کنید.
نکته: ترجمه صفحاتی که با علامت ✅ مشخص شده‌اند، انجام شدهاست. اگر شناسه کاربری گیت‌هاب شخصی کنار عنوان صفحه درج شدهاست، ترجمه آن صفحه به عهده اوست.
با نوشتن یک کامنت روی موضوع 1#، به نگاه‌دارندگان اطلاع دهید که تمایل دارید روی ترجمه چه صفحه‌ای کار کنید. پس از تایید، نام‌کاربری گیت‌هاب شما روبروی آن درج و ترجمه آن صفحه به شما واگذار می‌شود.
یک انشعاب از مخزن اصلی بگیرید و یک کپی از آن را روی سیستم خود قرار دهید. مطمئن شوید که روی شاخه master هستید. یک شاخه جدید با نام دلخواه خود ایجاد کنید (نکته: برای ترجمه هر صفحه، شما نیاز به یک شاخه‌ی جدید دارید).
# نام کاربری گیت‌هاب خود را در آدرس زیر قرار دهید
1. git clone git@github.com:[username]/fa.reactjs.org.git
2. cd fa.reactjs.org
3. git checkout master
# نام دلخواه شاخه خود را در دستور زیر قرار دهید
4. git checkout -b [the-name-of-my-branch]
روش اجرای پروژه در README.md توضیح داده شدهاست. فایل‌هایی که در آن‌ها تغییر انجام شدهاست را ذخیره کنید و نتیجه را در مرورگر مشاهده کنید. نتیجه تغییر فایل‌های مسیر src و content به صورت خودکار در مرورگر بارگذاری می‌شود.
در صورت امکان، نتیجه تغییرات ظاهری را در مرورگر‌های متفاوت و همچنین روی صفحه‌نمایش بزرگ و موبایل آزمایش کنید. سپس با اجرای دستور زیر در شاخه اصلی پروژه، تست‌ها را اجرا کنید. اگر تغییرات فقط شامل ترجمه باید، نباید مشکلی در این مرحله رخ دهد.
1. yarn check-all
تغییرات را با نوشتن یک پیام مناسب، کامیت کنید و به سرور گیت‌هاب بفرستید. سپس یک پول‌ریکوست به شاخه master از مخزن اصلی ثبت کنید.
# پیام موردنظر خود را در دستور زیر جایگزین کنید
1. git add -A && git commit -m "[the-message]"
# نام کاربری گیت‌هاب و نام شاخه مورد نظر باید در دستور زیر قرارگیرد
2. git push [my-fork-name] [the-name-of-my-branch]
تغییرات شما باید توسط حداقل یک نفر از نگاه‌دارندگان بررسی و تایید شود. آن‌ها در این مرحله نظر خود را با شما در میان می‌گذارند. در صورت وجود مشکل، با همکاری آن‌ها مشکل برطرف و تغییرات با شاخه master ادغام خواهد شد.
اگر فکر می‌کنید چیزی فراموش شدهاست یا نیاز به تصحیح دارد، حتما نظر خود را با ما درمیان بگذارید.