AP/TA_1/AP-ECE-UT.github.io/docs/tutorials/04-git-github/03-github.md

metadata

sidebar_position: 3

Github

Github چیست؟

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

• کنترل نسخه: Github از گیت، یک سیستم کنترل نسخه توزیع شده، برای پیگیری تغییرات در فایل‌های پروژه شما در طول زمان استفاده می‌کند.
• مخازن: یک مخزن Github (یا "ریپو") یک فضای ذخیره‌سازی است که پروژه شما در آن قرار دارد. شما می‌توانید چندین مخزن عمومی یا خصوصی داشته باشید.
• همکاری: Github به توسعه‌دهندگان متعدد اجازه می‌دهد که به طور همزمان روی یک پروژه کار کنند، تضادها را مدیریت کنند و کار یکدیگر را بررسی کنند.
• Pull Requests: یک ویژگی که به شما اجازه می‌دهد تغییرات پیشنهادی را به یک مخزن ارائه دهید و درخواست کنید که کسی آن‌ها را بررسی کرده و ادغام کند.

راه‌اندازی

1. ایجاد حساب

اگر حساب Github ندارید می تواند با مراجعه به Github.com یک حساب بسازید.

2. پیکربندی کلید SSH (اختیاری)

کلید SSH یک راه ایمن اتصال به Github است که با کمک دو کلید برای احراز هویت انجام می شود. ثبت کردن کلید SSH به شما این امکان را می دهید که بدون وارد کردن نام کاربری و رمز خود تغییرات را push کنید.

• راه اندازی کلید SSH:

ابتدا کلید SSH را ایجاد کنید.

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

سپس کلید SSH را با کپی کردن محتوای فایل id_rsa.pub که معمولا در مسیر /ssh./~ قرار دارد در تنظیمات SSH، حساب Github خود وارد کنید.

اتصال مخزن محلی به Github

1. ایجاد یک مخزن در Github

• به پروفایل Github خود بروید و روی تب Repositories کلیک کنید.
• روی دکمه New کلیک کنید تا یک مخزن جدید ایجاد کنید.
• برای مخزن خود نامی انتخاب کنید، یک توضیح اختیاری اضافه کنید، تعیین کنید که مخزن عمومی یا خصوصی باشد، و روی Create repository کلیک کنید.

2. اتصال مخزن محلی به Github

• برای اتصال دایرکتوری محلی به مخزن Github:

git remote add origin <remote-url>

• برای تایید:

git remote -v

کار کردن با مخزن‌های راه دور

هنگامی که به مخزن Github متصل شدید میتوانید تغییرات را push یا pull کنید.

Push

منظور از push کردن تغییرات، اپلود کردن کامیت ها بر روی مخزن Github مرتبط است. اگر اولین بار است که کامیت های خود را push می کنید دستور زیر را باید وارد کنید:

git push -u origin main

برای دفعات بعدی کافیست که تنها از git push استفاده کنید.

Pull

منظور از pull کردن تغییرات دانلود کردن تغییرات و کامیت ها از مخزن Github است.

git pull

Clone

منظور از clone کردن یک مخزن کپی کردن مخزن مربوط به آن از Github در دستگاه شماست.

git clone <remote url>

<div style={{ display: 'flex', justifyContent: 'center' }}>

همکاری (Contributing)

Fork کردن مخزن

فورک کردن یک کپی از مخزن شخصی دیگر ایجاد می کند. این کار زمانی استفاده می شود که شما می خواهید تغییراتی در مخزن شخصی دیگر ایجاد کنید و آن را به صورت pull request به صاحب مخزن پیشنهاد دهید.

ایجاد Pull Request

• Pull Request(PR) راهی برای پیشنهاد تغییرات شما به مخزن اصلی است.
• مراحل ایجاد یک Pull Request:
  1. تغییرات خود را به یک شاخه در مخزن فورک شده خود ارسال کنید.
  2. به مخزن اصلی در Github بروید و روی New Pull Request کلیک کنید.
  3. تغییرات شاخه خود را با شاخه پایه مخزن اصلی مقایسه کنید.
  4. توضیحی اضافه کنید و روی Create Pull Request کلیک کنید.