diff --git a/docs/what_git-another.md b/docs/what_git-another.md index 69da01d..9d1d7e7 100644 --- a/docs/what_git-another.md +++ b/docs/what_git-another.md @@ -1,22 +1,236 @@ -## ۱. گیت (Git) چیست؟ -**گیت** یک سیستم **کنترل نسخه (Version Control System)** توزیع‌شده است که توسط لینوس توروالدز (خالق لینوکس) ابداع شد. گیت به شما اجازه می‌دهد تمام تغییرات ایجاد شده در کدهای خود را ردیابی کنید، به نسخه‌های قبلی بازگردید و به صورت گروهی روی یک پروژه کار کنید. +# راهنمای نصب، اجرا و اتصال Git به پروژه در VS Code - -### چرا به گیت نیاز داریم؟ -* **جلوگیری از نابودی کدها:** اگر اشتباهی مرتکب شوید، می‌توانید به نسخه سالم قبلی برگردید. -* **همکاری تیمی:** چندین نفر می‌توانند همزمان روی بخش‌های مختلف یک پروژه کار کنند. -* **شاخه‌بندی (Branching):** ایجاد محیط‌های تست جداگانه بدون آسیب زدن به نسخه اصلی برنامه. +## 1) Git چیست؟ +Git یک ابزار برای **مدیریت نسخه‌های پروژه** است. +با Git می‌توانیم تغییرات فایل‌ها را ذخیره کنیم، به نسخه قبلی برگردیم و با تیم کار کنیم. --- -## ۲. نصب و پیکربندی اولیه -ابتدا باید گیت را از [سایت رسمی Git](https://git-scm.com/) دانلود و نصب کنید. پس از نصب، ترمینال (یا CMD) را باز کرده و مشخصات خود را ثبت کنید: +## 2) نصب Git + +### مرحله 1: دانلود +1. وارد سایت رسمی Git شوید: + https://git-scm.com +2. روی دکمه **Download** کلیک کنید. +3. نسخه مناسب ویندوز را دانلود کنید. + +### مرحله 2: نصب +1. فایل دانلود شده را اجرا کنید. +2. در همه مرحله‌ها معمولاً می‌توانید گزینه **Next** را بزنید. +3. در پایان روی **Install** و سپس Finish** کلیک کنید. + +### مرحله 3: تست نصب +برای اینکه مطمئن شوید Git نصب شده، در CMD یا Terminal این دستور را بزنید: + +```bash +git --version +``` +اگر نسخه Git نمایش داده شد، یعنی نصب درست انجام شده است. + +## 3) تنظیم اولیه Git + +بعد از نصب، باید نام و ایمیل خود را ثبت کنید: ```bash -# تنظیم نام کاربری git config --global user.name "Your Name" +git config --global user.email "your@email.com" +``` +**بررسی تنظیمات:** -# تنظیم ایمیل -git config --global user.email "yourname@example.com" +```bash +git config --global --list +``` + +دونا + +Creating Markdown for Git in VS Code + +The user wants me to write markdown content about installing, running, and connecting Git to a project in VS Code, likely in Persian. I'll keep it straightforward since no tools are needed for this task. I need to ensure the markdown format is clear and helpful for users who might be new to Git or VS Code. I think I can include steps for installation and guidance on connecting Git to their projects effectively. +انجام شد + +حتماً. این متن را مستقیم داخل فایل .md بگذار: + +markdown +# راهنمای نصب، اجرا و اتصال Git به پروژه در VS Code + +## 1) Git چیست؟ +Git یک ابزار برای **مدیریت نسخه‌های پروژه** است. +با Git می‌توانیم تغییرات فایل‌ها را ذخیره کنیم، به نسخه قبلی برگردیم و با تیم کار کنیم. + +--- + +## 2) نصب Git + +### مرحله 1: دانلود +1. وارد سایت رسمی Git شوید: + https://git-scm.com +2. روی دکمه **Download** کلیک کنید. +3. نسخه مناسب ویندوز را دانلود کنید. + +### مرحله 2: نصب +1. فایل دانلود شده را اجرا کنید. +2. در همه مرحله‌ها معمولاً می‌توانید گزینه **Next** را بزنید. +3. در پایان روی **Install** و سپس Finish** کلیک کنید. + +### مرحله 3: تست نصب +برای اینکه مطمئن شوید Git نصب شده، در CMD یا Terminal این دستور را بزنید: + +```bash +git --version + +اگر نسخه Git نمایش داده شد، یعنی نصب درست انجام شده است. +``` +3) تنظیم اولیه Git + +**بعد از نصب، باید نام و ایمیل خود را ثبت کنید:** + +```bash +git config --global user.name "Your Name" +git config --global user.email "your@email.com" +``` + +**بررسی تنظیمات:** + +```bash +git config --global --list +``` + +## 4) باز کردن پروژه در VS Code +**روش باز کردن پروژه:** + VS Code را باز کنید. + از منوی File گزینه Open Folder** را بزنید. + پوشه پروژه خود را انتخاب کنید. + پروژه داخل VS Code باز می‌شود. + +--- +## 5)فعال کردن Git داخل پروژه + +اگر پروژه شما هنوز Git ندارد، داخل Terminal VS Code این دستور را بزنید: + +```bash +git init +``` + +این دستور Git را داخل همان پروژه فعال می‌کند. + +## 6)دیدن وضعیت فایل‌ها + +**برای دیدن وضعیت فایل‌ها:** + +```bash +git status +``` + +این دستور نشان می‌دهد: + چه فایل‌هایی جدید هستند + چه فایل‌هایی تغییر کرده‌اند + چه فایل‌هایی آماده Commit هستند + +## 7) اضافه کردن فایل‌ها به Git + +برای اینکه Git تغییرات را آماده ذخیره کند: + +```bash +git add . +``` +معنی این دستور: + git add . یعنی همه فایل‌های تغییر کرده را آماده Commit کن. + + +## 8) ذخیره تغییرات با Commit + +**بعد از git add باید یک Commit بزنیم:** + +```bash +git commit -m "first commit" +``` + +**معنی Commit:** +Commit یعنی یک نسخه ذخیره‌شده از پروژه. + +## 9) اتصال پروژه به مخزن Git + +اگر پروژه باید به سرور Git وصل شود، باید Remote اضافه کنیم. +اضافه کردن Remote: + +```bash +git remote add origin https://git.sadentel.net/my-projact/projact.git +``` + +**بررسی Remote:** + +```bash +git remote -v +``` + +اگر درست باشد، آدرس سرور نمایش داده می‌شود. + +## 10) ارسال پروژه به سرور + +**اگر اولین بار است که پروژه را می‌فرستید:** +```bash +git branch -M main +git push -u origin main +``` + +**معنی این دستورات:** + + git branch -M main + نام شاخه را به main تغییر می‌دهد. + + git push -u origin main + پروژه را برای اولین بار روی سرور آپلود می‌کند + + +## 11) کار روزانه با Git در VS Code + +**هر بار که تغییر دادید، این مراحل را بروید:** + +**مرحله 1: بررسی تغییرات** +```bash +git status +``` + +**مرحله 2: اضافه کردن فایل‌ها** + +```bash +git add . +``` + +**مرحله 3: Commit** + +```bash +git commit -m "update files" +``` + +**مرحله 4: ارسال به سرور** + +```bash +git push origin main +``` + +### 12) کار با Git در پنل Source Control در VS Code + + + +**در VS Code از سمت چپ روی Source Control کلیک کنید. +در این بخش:** + فایل‌های تغییر کرده را می‌بینید + روی + کلیک می‌کنید تا فایل Stage شود + یک پیام Commit می‌نویسید + Commit می‌زنید + سپس Push می‌کنید + +--- +### اموزش ورود به پنل نمایش سادن تل + +**ابتدا از طریق لینک زیر وارد شوید:** + +https://git.sadentel.net/ + + +**سپس username و password خود را در فیلد مناسب جای گذاری کرده و در انتها روی گزینه login کلیک کرده** +(my-picture/git1.png) +