Fork, Pull, and Push: راهنمای گام به گام GitHub

Summarize this content to 400 words in Persian Lang
در ابتدا در اینجا منتشر شد

GitHub پلتفرمی برای کنترل نسخه، همکاری و مشارکت های منبع باز است. چه بر روی پروژه خود کار می کنید و چه در پروژه دیگری مشارکت می کنید، تسلط بر اصول اولیه چنگال زدن، کشیدن و هل دادن ضروری است. این مفاهیم اصلی به توسعه دهندگان اجازه می دهد تا به طور موثر با یکدیگر همکاری کنند، نسخه های پروژه را مدیریت کنند و به جامعه منبع باز کمک کنند.

در این مقاله، فرآیند جدا کردن یک مخزن، ایجاد تغییرات به صورت محلی، و بازگرداندن این تغییرات به GitHub را در حین استفاده از گردش کاری درخواست کشش (PR) مرور خواهیم کرد.

چنگال زدن، کشیدن و هل دادن چیست؟

قبل از فرو رفتن در راهنما، درک این سه اصطلاح مهم است:

چنگال زدن: این فرآیند ایجاد یک کپی شخصی از مخزن شخص دیگری است. Forking به شما این امکان را می دهد که تغییراتی در یک پروژه ایجاد کنید بدون اینکه بر اساس کد اصلی تأثیر بگذارد.

کشیدن: این شامل بازیابی به‌روزرسانی‌ها از مخزن اصلی (یا یک شعبه راه دور) در پایگاه کد محلی شما است تا اطمینان حاصل شود که با آخرین نسخه کار می‌کنید.

هل دادن: هنگامی که تغییراتی را در فورک خود ایجاد کردید، فشار دادن به ارسال آن تغییرات به مخزن فورک شده راه دور شما در GitHub اشاره دارد.

این مراحل با هم، گردش کار اساسی برای مشارکت در یک پروژه GitHub را تشکیل می دهند.

مرحله 1: جدا کردن یک مخزن

چرا یک مخزن Fork؟

جدا کردن یک مخزن زمانی مفید است که می خواهید:

در یک پروژه منبع باز مشارکت کنید.
قبل از ارسال تغییرات خود، با پایگاه کد آزمایش کنید.
نسخه خود را از پروژه ای که متعلق به شما نیست ایجاد کنید.

نحوه فورک کردن یک مخزن:

مخزن را پیدا کنید می خواهید در GitHub فورک کنید.
در گوشه سمت راست بالا، روی “چنگال” دکمه GitHub یک کپی از مخزن اصلی در حساب GitHub شما ایجاد می کند.
شما اکنون یک نسخه فوک شده از پروژه دارید که می توانید بدون تأثیر بر مخزن اصلی آن را تغییر دهید.

مرحله 2: کلون کردن چنگال خود به صورت محلی

اکنون که مخزن را فورک کرده اید، باید آن را در دستگاه محلی خود کلون کنید تا تغییراتی ایجاد کنید.

به مخزن فورک شده خود در GitHub بروید.
را کلیک کنید “کد” را فشار دهید و URL HTTPS را کپی کنید.
ترمینال یا خط فرمان خود را باز کنید و دستور زیر را اجرا کنید:

git clone

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

این دستور مخزن را در ماشین محلی شما کلون می کند.

تغییر به دایرکتوری مخزن:

cd

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

مرحله 3: ایجاد تغییرات به صورت محلی

اکنون که پروژه را روی دستگاه خود دارید، می توانید تغییرات را شروع کنید.

یک شعبه جدید ایجاد کنید: ایجاد تغییرات در یک شاخه جداگانه، به ویژه هنگام مشارکت در یک پروژه مشترک، بهترین تمرین است. برای ایجاد و تغییر به یک شاخه جدید، اجرا کنید:

git checkout -b

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

جایگزین کنید با یک نام توصیفی برای تغییرات شما.

تغییرات خود را انجام دهید: فایل‌ها را ویرایش کنید، ویژگی‌های جدید اضافه کنید یا اشکالات موجود در محیط محلی خود را برطرف کنید.

وضعیت را بررسی کنید تغییرات شما با اجرای:

git status

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

این دستور نشان می دهد که کدام فایل ها اصلاح شده اند. 4. تغییرات خود را مرحله بندی کنید برای انجام دادن:

git add

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

یا برای افزودن همه فایل های تغییر یافته:

git add .

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

مرحله 4: انجام تغییرات

بعد از ایجاد تغییرات و مرحله بندی آنها، گام بعدی این است که آن تغییرات را به صورت محلی انجام دهید.

برای انجام تغییرات دستور زیر را اجرا کنید:

git commit -m “Your detailed commit message”

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

متن مکان‌نما را با توضیح معنی‌داری از تغییراتی که ایجاد کرده‌اید جایگزین کنید.

مرحله 5: فشار دادن تغییرات خود به GitHub

اکنون که تغییرات را به صورت محلی انجام داده اید، باید آنها را به مخزن فورک شده خود در GitHub فشار دهید.

برای فشار دادن شاخه خود به GitHub، اجرا کنید:

git push origin

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

این دستور تغییرات شما را به مخزن فورک شده شما تحت شاخه جدیدی که ایجاد کرده اید فشار می دهد. 2. پس از تکمیل فشار، GitHub پیوندی را در مخزن شما نمایش می دهد که در آن می توانید یک لینک باز کنید. درخواست کشش (PR).

مرحله 6: ایجاد یک درخواست کشش (PR)

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

به مخزن فورک شده خود در GitHub بروید.
پیامی خواهید دید که از شما می خواهد برای شاخه ای که اخیراً فشار داده اید، درخواست کشش ایجاد کنید. را کلیک کنید “درخواست مقایسه و کشش” دکمه
در فرم درخواست کشش:

عنوان و توضیحات بنویسید از تغییرات شما
هر زمینه لازم را برای کمک به نگهبانان در درک آنچه که روابط عمومی شما نشان می دهد، درج کنید.

با کلیک کردن، درخواست کشش را ارسال کنید “ایجاد درخواست کشش.”

مرحله 7: فورک خود را با تغییرات جدید به روز کنید

با گذشت زمان، مخزن اصلی ممکن است تعهدات جدیدی دریافت کند. مهم است که چنگال خود را با این تغییرات به روز نگه دارید.

همگام سازی فورک خود:

مخزن اصلی را به عنوان یک راه دور اضافه کنید در مخزن محلی شما:

git remote add upstream

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

آخرین تغییرات را واکشی کنید از مخزن اصلی:

git fetch upstream

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

تغییرات را ادغام کنید در چنگال محلی خود:

git merge upstream/main

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

جایگزین کنید main با نام شاخه صحیح اگر پروژه از یک شاخه پیش فرض متفاوت استفاده می کند (به عنوان مثال، master).

تغییرات به روز شده را فشار دهید به مخزن فورک شده شما در GitHub:

git push origin main

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

نتیجه گیری

فورک کردن، کشیدن، و هل دادن مفاهیم اساسی GitHub هستند که به توسعه دهندگان اجازه می دهند به روشی سازمان یافته و کارآمد در پروژه ها مشارکت کنند. با دنبال کردن این راهنما، مهارت‌های لازم برای فورک کردن مخازن، ایجاد تغییرات به صورت محلی و ارسال درخواست‌های کشش برای مشارکت در پروژه‌های منبع باز یا همکاری در مخازن خصوصی را خواهید داشت.

هرچه بیشتر این گردش کار را تمرین کنید، یکپارچه‌تر می‌شود و شما را به مشارکت مؤثرتر و مطمئن‌تری در هر پروژه GitHub تبدیل می‌کند.

git clone 

cd 

git checkout -b 

git status

git add 

git add .

git commit -m "Your detailed commit message"

git push origin 

git remote add upstream 

git fetch upstream

git merge upstream/main

git push origin main