از علاقه شما برای توسعه اسناد ریاکت به زبان فارسی سپاسگذاریم و این برای ما ارزشمند است. برای شروع آمادهاید؟
در توضیحات موضوع 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
تغییرات را با نوشتن یک پیام مناسب، کامیت کنید و به سرور گیتهاب بفرستید. سپس یک پولریکوست به شاخه fa از مخزن اصلی ثبت کنید.
# پیام موردنظر خود را در دستور زیر جایگزین کنید
1. git add -A && git commit -m "[the-message]"
# نام کاربری گیتهاب و نام شاخه مورد نظر باید در دستور زیر قرارگیرد
2. git push [my-fork-name] [the-name-of-my-branch]
بعد از ارسال تغییرات به انشعاب خودتان، یک پولریکوست از شاخه موردنظر به شاخه fa از مخزن اصلی ثبت کنید.
نکته: اگر پول ریکوست شما مستقیم به شاخه master
ارسال شود، بر خلاف میل ما، مجبور به بستن آن هستیم، چون روال بررسی و تایید را دچار مشکل می کند!
تغییرات شما باید توسط حداقل دو نفر از نگاهدارندگان بررسی و تایید شود. آنها در این مرحله نظر خود را با شما در میان میگذارند. در صورت وجود مشکل، با همکاری آنها مشکل برطرف و تغییرات به شاخه fa
اضافه میشود. پس از اینکه تیم از انتشار تغییرات جدید اطمینان حاصل کرد، ادغام با شاخه master
انجام خواهدشد.
اگر فکر میکنید چیزی فراموش شدهاست یا نیاز به تصحیح دارد، حتما نظر خود را با ما درمیان بگذارید.