diff --git a/src/00intro/00_introduction.md b/src/00intro/00_introduction.md index 424d38d..dfe4a66 100644 --- a/src/00intro/00_introduction.md +++ b/src/00intro/00_introduction.md @@ -1,29 +1,29 @@ # مقدمه -در این مقدمه، شما قراره چندین ساعت از زندگی خود را به مظالعه گیت صرف کنید. بنابراین، بیایید کمی وقت بگذاریم تا توضیح دهیم که چه چیزی در این کتاب در انتظار شماست. در اینجا خلاصه‌ای از ده فصل و سه پیوست این کتاب اورده شده است. +در این مقدمه، شما قراره چندین ساعت از زندگی خود را به مطالعه گیت صرف کنید. بنابراین، بیایید کمی وقت بگذاریم تا توضیح دهیم که چه چیزی در این کتاب در انتظار شماست. در اینجا خلاصه‌ای از ده فصل و سه پیوست این کتاب اورده شده است. -در فصل۱، به سیستم های کنترل نسخه (VCS) و اصول گیت می ‌پردازد - این بخش شامل مباحث فنی نمی‌باشد، بلکه توضیح میدهد گیت چیست، چرا در دنیایی پر از سیستم های کنترل نسخه به وجود امد، چه چیزی ان را متمایز میکند، و چرا بسیاری از افراد از ان استفاده میکنند. سپس، نحوه دانلود و راه‌اندازیه اولیه گیت را که در صورتی که ان را روی سیستم خود ندارید، توضیح خواهیم داد. +در **فصل** ۱، به سیستم های کنترل نسخه (VCS) و اصول گیت می ‌پردازد - این بخش شامل مباحث فنی نمی‌باشد، بلکه توضیح میدهد گیت چیست، چرا در دنیایی پر از سیستم های کنترل نسخه به وجود آمد، چه چیزی آن را متمایز میکند، و چرا بسیاری از افراد از آن استفاده میکنند. سپس، نحوه دانلود و راه‌اندازی اولیه گیت را که در صورتی که آن را روی سیستم خود ندارید، توضیح خواهیم داد. -در فصل۲‌، به بررسی استفاده‌ی پایه از گیت می باشد - یعنی چگونگی استفاده از گیت در ۸۰٪ مواردی که به احتمال زیاد با انها روبرو خواهید شد. پس از طالعه این فصل، باید قادر باشید یک مخزن را کلون(کپی) کنید. تغییرات تاریخی پروژ را مشاهده کنید، فایل ها را اصلاح کرده و تغییرات خود را ثبت نمایید. حتی اگر کتاب خود به خود بسوزد، شما باید تا اینجا توانایی کافی برای استفاده از گیت را داشته باشید. +در **فصل ۲**‌، به بررسی استفاده‌ی پایه از گیت می باشد - یعنی چگونگی استفاده از گیت در ۸۰٪ مواردی که به احتمال زیاد با آنها روبرو خواهید شد. پس از مطالعه این فصل، باید قادر باشید یک مخزن را clone (کپی) کنید. تغییرات تاریخی پروژه را مشاهده کنید، فایل ها را اصلاح کرده و تغییرات خود را ثبت نمایید. حتی اگر کتاب خود به خود بسوزد، شما باید تا اینجا توانایی کافی برای استفاده از گیت را داشته باشید. -در فصل۳، در مورد مدل شاخه بندی (branching) در گیت است که اغلب به عنوان ویژگی اصلی آن شناخته می‌شود. در این بخش ، شما خواهید اموخت که چه چیزی واقعا گیت را از سایرین متمایز میکند. پس از اتمام این فصل، ممکن است نیاز به لحظه ای خلوت داشته باشید تا به زندگی قبل از اشنایی شاخه بندی در گیت فکر کنید. +در **فصل ۳**، در مورد مدل شاخه بندی (branching) در گیت است که اغلب به عنوان ویژگی اصلی آن شناخته می‌شود. در این بخش ، شما خواهید آموخت که چه چیزی واقعاً گیت را از سایرین متمایز میکند. پس از اتمام این فصل، ممکن است نیاز به لحظه‌ای خلوت داشته باشید تا به زندگی قبل از آشنایی شاخه بندی در گیت فکر کنید. -در فصل۴، به گیت روی سرور می‌پردازد. این فصل برای کسانی است که میخواهند گیت را در سازمان خود یا روی سرور شخصی خود برای همکاری تنظیم کنند. همچنین، به بررسی گزینه های میزبانی مختلف در صورتی که ترجیح میدهید دیگران این کار را برای شما انجام دهند، خواهیم پرداخت. +در **فصل ۴**، به گیت روی سرور می‌پردازد. این فصل برای کسانی است که میخواهند گیت را در سازمان خود یا روی سرور شخصی خود برای همکاری تنظیم کنند. همچنین، به بررسی گزینه های میزبانی مختلف در صورتی که ترجیح میدهید دیگران این کار را برای شما انجام دهند، خواهیم پرداخت. -در فصل۵، به جزئیات کامل درباره‌ی جریان های کاری توزیع شده و نحوه اجرای انها با گیت می‌پردازد.پس از مطالعه این فصل، شما باید بتوانید به صورت حرفه‌ای با چندین مخزن راه دور کا کنید، از گیت از طریق ایمیل استفاده کرده و به‌طور ماهرانه شاخه های راه دور متعدد و وصله های مشارکت شده را مدیریت کنید. +در **فصل ۵**، به جزئیات کامل درباره‌ی جریان های کاری توزیع شده و نحوه اجرای آنها با گیت می‌پردازد.پس از مطالعه این فصل، شما باید بتوانید به صورت حرفه‌ای با چندین مخزن راه دور کار کنید، از گیت از طریق ایمیل استفاده کرده و به‌طور ماهرانه شاخه های راه دور متعدد و وصله های مشارکت شده را مدیریت کنید. -در فصل۶، سرویس میزبانی گیت‌هاب و ابزارهای آن را به طور کامل پوشش می‌دهد. ما به بررسی ثبت نام و مدیریت حساب کاربری، ایجاد و استفاده از مخازن گیت، جریان های کاری رایج برای مشارکت‌ها به پروژه های خودتان، رابط برنامه نویسی گیت هاب و نکاتی ه زندگی شما را به طور کامل اسان‌تر میکنند، خواهیم پرداخت. +در **فصل ۶**، سرویس میزبانی گیت‌هاب و ابزارهای آن را به طور کامل پوشش می‌دهد. ما به بررسی ثبت نام و مدیریت حساب کاربری، ایجاد و استفاده از مخازن گیت، جریان های کاری رایج برای مشارکت‌ها به پروژه های خودتان، رابط برنامه نویسی گیت‌هاب و نکاتی که زندگی شما را به طور کامل آسان‌تر می‌کنند، خواهیم پرداخت. -در فصل۷، به دستورات پیشرفته‌ی گیت اختصاص دارد. در اینجا، شما در مورد مباحثی مانند تسلط بر دستور 'reset' که ممکن است به نظر بیاید، استفاده از جستجوی دودویی برای شناسایی باگ ها، ویرایش تاریخچه، انتخاب دقیق نسخه ها و بسیاری موارد دیگر یاد خواهید گرفت. این فصل دانش شما از گیت را کامل خواهد کرد تا واقعا به یک استاد در استفاده از گیت تبدیل شوید. +در **فصل ۷**، به دستورات پیشرفته‌ی گیت اختصاص دارد. در اینجا، شما در مورد مباحثی مانند تسلط بر دستور `reset` که ممکن است به نظر ترسناک بیاید، استفاده از جستجوی دودویی برای شناسایی باگ ها، ویرایش تاریخچه، انتخاب دقیق نسخه ها و بسیاری موارد دیگر یاد خواهید گرفت. این فصل دانش شما از گیت را کامل خواهد کرد تا واقعاً به یک استاد در استفاده از گیت تبدیل شوید. -در فصل۸، به تنظیم محیط سفارشی گیت شما می‌پردازد. این بخش شامل اسکریپت‌های هوک (hook) برای اعمال یا تشویق به پیروی از سیاست‌های سفارشی و استفاده از تنظیمات پیکربندی محیط برای کار به شیوه‌ای که مدنظر دارید،خواهد بود. ما همچنین به ساخت مجموعه‌ای از اسکریپت‌های خودتان برای اعمال یک سیاست سفارشی برای ثبت تغییرات می‌پردازیم. +در **فصل ۸**، به تنظیم محیط سفارشی گیت شما می‌پردازد. این بخش شامل اسکریپت‌های هوک (hook) برای اعمال یا تشویق به پیروی از سیاست‌های سفارشی و استفاده از تنظیمات پیکربندی محیط برای کار به شیوه‌ای که مدنظر دارید، خواهد بود. ما همچنین به ساخت مجموعه‌ای از اسکریپت‌های خودتان برای اعمال یک سیاست سفارشی برای ثبت تغییرات می‌پردازیم. -در فصل۹، با گیت و سایر سیستم های کنترل نسخه سروکار دارد. این بخش شامل استفاده از گیت در دنیای subversion(SVN) و تبدیل پروژه‌هااز سیستم‌های کنترل نسخه دیگر به گیت می‌شود. بسیاری از سازمان‌ها هنوز از SVN استفاده می‌کنند و قصد تغییر ندارد، اما در این مرحله شما به قدرت شگفت انگیز گیت پی برده اید - و این فصل به شما نشپن می‌دهد چگونه با این موضوع کنار بیایید اگر همچنان به نحوه وارد کردن پروژه‌ها از سیستم‌های مختلف در صورتی که بتوانید دیگران را قانع به تغییر کنید، خواهیم پرداخت. +در **فصل ۹**، با گیت و سایر سیستم های کنترل نسخه سروکار دارد. این بخش شامل استفاده از گیت در دنیای subversion(SVN) و تبدیل پروژه‌هااز سیستم‌های کنترل نسخه دیگر به گیت می‌شود. بسیاری از سازمان‌ها هنوز از SVN استفاده می‌کنند و قصد تغییر ندارد، اما در این مرحله شما به قدرت شگفت انگیز گیت پی برده اید - و این فصل به شما نشان می‌دهد ، اگر هنوز مجبور به استفاده از سرور SVN هستید ، چگونه با آن کنار بیایید. ما همچنین به نحوه وارد کردن پروژه‌ها از سیستم‌های مختلف در صورتی که بتوانید دیگران را قانع به تغییر کنید، خواهیم پرداخت. -در فصل۱۰، به عمق های مبهم اما زیبا از اجزای داخلی گیت می‌پردازند. اکنون که شماهمه چیز را درباره گیت می‌دانید و می‌توانید با قدرت و دقت از ان استفاده کنید، می‌توانید به بررسی نحوه ذخیره سازی اشیاء در گیت، مدل شیء(object model)، جزئیات فایل‌های بسته بندی شده(packfiles)، پروتکل‌های سرور و موارد دیگر بپردازید. در طول کتاب ما به بخش‌هایی از این فصل اشاره خواهیم کرد در صورتی که بخواهید در همان لحظه به عمق موضوع وارد شوید؛ اما اگر مانند ما به جزئیات فنی علاقه دارید،ممکن است بخواهید فصل ۱۰ را ابتدا بخوانید. تصمیم با شماست. +در **فصل ۱۰**، به عمق های مبهم اما زیبا از اجزای داخلی گیت می‌پردازد. اکنون که شما همه چیز را درباره گیت می‌دانید و می‌توانید با قدرت و دقت از آن استفاده کنید، می‌توانید به بررسی نحوه ذخیره سازی اشیاء در گیت، مدل شیء (object model)، جزئیات فایل‌های بسته بندی شده (packfiles)، پروتکل‌های سرور و موارد دیگر بپردازید. در طول کتاب ما به بخش‌هایی از این فصل اشاره خواهیم کرد در صورتی که بخواهید در همان لحظه به عمق موضوع وارد شوید؛ اما اگر مانند ما به جزئیات فنی علاقه دارید،ممکن است بخواهید فصل ۱۰ را ابتدا بخوانید. تصمیم با شماست. -در پیوست A، به تعدادی از مثال‌های استفاده از گیت در محیط‌های خاص مختلف خواهیم پرداخت. ما به بررسی تعدادی از رابط‌های کاربری گرافیکی (GUI) و محیط های برنامه نویسی IDE که ممکن است بخواهید از گیت در آن‌ها استفاده کنید و امکانات موجود برای شما می‌پردازیم. اگر به بررسی کلی استفاده از گیت در محیط خود علاقه دارید، این بخش برای شما مناسب است. +در **پیوست A**، به تعدادی از مثال‌های استفاده از گیت در محیط‌های خاص مختلف خواهیم پرداخت. ما به بررسی تعدادی از رابط‌های کاربری گرافیکی (GUI) و محیط های برنامه نویسی IDE که ممکن است بخواهید از گیت در آن‌ها استفاده کنید و امکانات موجود برای شما می‌پردازیم. اگر به بررسی کلی استفاده از گیت در محیط خود علاقه دارید، این بخش برای شما مناسب است. -در پیوست B، به بررسی نحوه‌ی اسکریپت‌نویسی و توسعه‌ی گیت از طریق ابزارهای مانند libgit2 و jgit می‌پردازیم. اگر به نوشتن ابزارهای سفارشی پیچیده و سریع علاقه‌مند هستید و نیاز به دسترسی به سطوح پایین‌تر گیت دارید، این بخش شما را با آنچه در این زمینه وجود دارد، اشنا می‌کند. +در **پیوست B**، به بررسی نحوه‌ی اسکریپت‌نویسی و توسعه‌ی گیت از طریق ابزارهای مانند libgit2 و jgit می‌پردازیم. اگر به نوشتن ابزارهای سفارشی پیچیده و سریع علاقه‌مند هستید و نیاز به دسترسی به سطوح پایین‌تر گیت دارید، این بخش شما را با آنچه در این زمینه وجود دارد، آشنا می‌کند. -در نهایت، پبوستC، تمامی دستورات اصلی در گیت را یکی یکی مرور و بررسی میکنیم که در کجای کتاب به آن‌ها پرداخته‌ایم و چگونه از آن‌ها استفاده کرده‌ایم. اگر می‌خواهید بدانید در کدام بخش از کتاب از یک دستور خاص گیت استفاده کرده‌ایم. می‌توانید در این بخش جستجو کنید. حالا بیایید شروع کنیم. +در نهایت، در **پیوست C**، ما تمامی دستورات اصلی در گیت را یکی یکی مرور و بررسی می‌کنیم که در کجای کتاب به آن‌ها پرداخته‌ایم و چگونه از آن‌ها استفاده کرده‌ایم. اگر می‌خواهید بدانید در کدام بخش از کتاب از یک دستور خاص گیت استفاده کرده‌ایم. می‌توانید در این بخش جستجو کنید. حالا بیایید شروع کنیم. diff --git a/src/SUMMARY.md b/src/SUMMARY.md index 78f2073..2040787 100644 --- a/src/SUMMARY.md +++ b/src/SUMMARY.md @@ -1,29 +1,28 @@ # Summary -- [مقدمه](./intro/00_introduction.md) -- [شروع به کار](./chapter1/01_getting%20started.md) - - [درباره نسخه کنترل](./chapter1/01.1_about%20version%20control.md) - - [سیستم‌های کنترل نسخه محلی](./chapter1/01.1.1_local%20version%20control%20systems.md) - - [سیستم‌های کنترل نسخه متمرکز](./chapter1/01.1.2_centralized%20version%20control%20systems.md) - - [سیستم‌های کنترل نسخه توزیع شده](./chapter1/01.1.3_distributed%20version%20control%20systems.md) - - [تاریخچه کوتاهی از گیت](./chapter1/01.2_a%20short%20history%20of%20git.md) - - [گیت چیست؟](./chapter1/01.3_what%20is%20git.md) - - [snapshot,هیچ فرقی ندارد](./chapter1/01.3.1_snapshot,%20not%20diffrence.md) - - [تقریبا هر عملیت به صورت محلی انجام می‌شود](./chapter1/01.3.2_nearly%20every%20operation%20local.md) - - [گیت دارای یکپارچگی است](./chapter1/01.3.3_git%20has%20integrity.md) - - [گیت به طور کلی فقط داده‌ها را اضافه می‌کند](./chapter1/01.3.4_git%20generally%20only%20adds%20data.md) - - [سه حالت](./chapter1/01.3.5_the%20three%20states.md) - - [خط فرمان](./chapter1/01.4_the%20command%20line.md) - - [نصب گیت](./chapter1/01.5_installing%20git.md) - - [نصب بر روی لینوکس](./chapter1/01.5.1_installing%20on%20linux.md) - - [نصب بر روی macOS](./chapter1/01.5.2_installing%20on%20macOS.md) - - [نصب بر روی ویندوز](./chapter1/01.5.3_installing%20on%20windows.md) - - [نصب از منبع](./chapter1/01.5.4_installing%20from%20source.md) - - [راه‌اندازی اولیه گیت](./chapter1/01.6_first-time%20git%20setup.md) - - [هویت شما](./chapter1/01.6.1_your%20identity.md) - - [ویرایشگر شما](./chapter1/01.6.2_your%20editor.md) - - [نام برنچ پیش فرض شما](./chapter1/01.6.3_your%20default%20branch%name.md) - - [بررسی تنظیمات شما](./01.6.4_checking%20your%20settings.md) - - [دریافت کمک](./chapter1/01.7_getting%20help.md) - - [خلاصه](./chapter1/01.8_summary.md) - - +- [مقدمه](./00intro/00_introduction.md) +- [شروع به کار](./chapter_1/01_getting_started.md) + - [درباره نسخه کنترل](./chapter_1/01.1_about_version_control.md) + - [سیستم‌های کنترل نسخه محلی](./chapter_1/01.1.1_local_version_control_systems.md) + - [سیستم‌های کنترل نسخه متمرکز](./chapter_1/01.1.2_centralized_version_control_systems.md) + - [سیستم‌های کنترل نسخه توزیع شده](./chapter_1/01.1.3_distributed_version_control_systems.md) + - [تاریخچه کوتاهی از گیت](./chapter_1/01.2_a_short_history_of_git.md) + - [گیت چیست؟](./chapter_1/01.3_what_is_git.md) + - [snapshot,هیچ فرقی ندارد](./chapter_1/01.3.1_snapshot,_not_diffrence.md) + - [تقریبا هر عملیات به صورت محلی انجام می‌شود](./chapter_1/01.3.2_nearly_every_operation_local.md) + - [گیت دارای یکپارچگی است](./chapter_1/01.3.3_git_has_integrity.md) + - [گیت به طور کلی فقط داده‌ها را اضافه می‌کند](./chapter_1/01.3.4_git_generally_only_adds_data.md) + - [سه حالت](./chapter_1/01.3.5_the_three_states.md) + - [خط فرمان](./chapter_1/01.4_the_command_line.md) + - [نصب گیت](./chapter_1/01.5_installing_git.md) + - [نصب بر روی لینوکس](./chapter_1/01.5.1_installing_on_linux.md) + - [نصب بر روی macOS](./chapter_1/01.5.2_installing_on_macOS.md) + - [نصب بر روی ویندوز](./chapter_1/01.5.3_installing_on_windows.md) + - [نصب از منبع](./chapter_1/01.5.4_installing_from_source.md) + - [راه‌اندازی اولیه گیت](./chapter_1/01.6_first-time_git_setup.md) + - [هویت شما](./chapter_1/01.6.1_your_identity.md) + - [ویرایشگر شما](./chapter_1/01.6.2_your_editor.md) + - [نام برنچ پیش فرض شما](./chapter_1/01.6.3_your_default_branch%name.md) + - [بررسی تنظیمات شما](./chapter_1/01.6.4_checking_your_settings.md) + - [دریافت کمک](./chapter_1/01.7_getting_help.md) + - [خلاصه](./chapter_1/01.8_summary.md) diff --git a/src/chapter 1/01.1.1_local version control systems.md b/src/chapter_1/01.1.1_local_version_control_systems.md similarity index 100% rename from src/chapter 1/01.1.1_local version control systems.md rename to src/chapter_1/01.1.1_local_version_control_systems.md diff --git a/src/chapter 1/01.1.2_centralized version control systems.md b/src/chapter_1/01.1.2_centralized_version_control_systems.md similarity index 100% rename from src/chapter 1/01.1.2_centralized version control systems.md rename to src/chapter_1/01.1.2_centralized_version_control_systems.md diff --git a/src/chapter 1/01.1.3_distributed version control systems.md b/src/chapter_1/01.1.3_distributed_version_control_systems.md similarity index 100% rename from src/chapter 1/01.1.3_distributed version control systems.md rename to src/chapter_1/01.1.3_distributed_version_control_systems.md diff --git a/src/chapter 1/01.1_about version control.md b/src/chapter_1/01.1_about_version_control.md similarity index 100% rename from src/chapter 1/01.1_about version control.md rename to src/chapter_1/01.1_about_version_control.md diff --git a/src/chapter 1/01.2_a short history of git.md b/src/chapter_1/01.2_a_short_history_of_git.md similarity index 100% rename from src/chapter 1/01.2_a short history of git.md rename to src/chapter_1/01.2_a_short_history_of_git.md diff --git a/src/chapter 1/01.3.1_snapshot, not diffrence.md b/src/chapter_1/01.3.1_snapshot,_not_diffrence.md similarity index 100% rename from src/chapter 1/01.3.1_snapshot, not diffrence.md rename to src/chapter_1/01.3.1_snapshot,_not_diffrence.md diff --git a/src/chapter 1/01.3.2_nearly every operation local.md b/src/chapter_1/01.3.2_nearly_every_operation_local.md similarity index 97% rename from src/chapter 1/01.3.2_nearly every operation local.md rename to src/chapter_1/01.3.2_nearly_every_operation_local.md index 64897c7..21fdd05 100644 --- a/src/chapter 1/01.3.2_nearly every operation local.md +++ b/src/chapter_1/01.3.2_nearly_every_operation_local.md @@ -1,4 +1,4 @@ -# تقریبا هر عملیت به صورت محلی انجام می‌شود +# تقریبا هر عملیات به صورت محلی انجام می‌شود بیشتر عملیات در گیت تنها به فایل‌ها و منابع محلی نیاز دارند و معمولا نیازی به اطلاعات از رایانه‌های دیگر در شبکه شما نیست. اگر به یک سیستم کنترل نسخه متمرکز(CVCS) عادت دارید که بیشتر عملیات آن با تاخیر شبکه همراه است، این ویژگی گیت ممکن است به نظر شما مانند برکتی از سوی خدایان سرعت باشد. چون تمام تاریخچه پروژه در دیسک محلی شما موجود است، بیشنر عملیات به طور تقریبی آنی به نظر می‌رسند. برای مثال، برای مرور تاریخچه پروژه، گیت نیازی به اتصال به سرور ندارد تا تاریخچه را دریافت و نمایش دهدـ بلکه مستقیما از پایگاه داده محلی شما آن را می‌خواند. این بدان معنی است که شما تاریخچه پروژه را تقریبا به طور آنی مشاهده میکنید. اگر بخواهید تغییرات معرفی شده بین نسخه کنونی یک فایل و فایلی که یک ماه پیش بوده را ببینید، گیت می‌تواند فایل مربوط به یک ماه پیش را جستجو کرده و محاسبات تفاوت را به طور محلی انجام دهد. به جای اینکه از یک سرور راه دور درخواست کند یا نسخه قدیمی فایل را از سرور راه‌دور بگیرد و به طور محلی محاسبه کند. این به این معناست که اگر افلاین یا خارج از VPN باشید، بسیاری از کار‌ها را می‌توانید انجام دهید. اگر در هواپیما یا قطار باشید و بخواهید کمی کار کنید، می‌توانید با خوشحالی کامیت کنید‌(به نسخه محلی خود،یادتان است؟) تا زمانی که به اتصال به شبکه برسید بارگذاری کنید. اگر به خانه بروید و نتوانید کلاینت vpn خود را به درستی راه‌اندازی کنید، هنوز هم می‌توانید. در بسیاری از سیستم‌های دیگر، انجام چنین کارهایی یا غیرممکن است یا دردسرساز است. به عنوان مثال، در perforce، هنگامی که به سرور متصل نیستید، نمی‌توانید کار زیادی انجام دهید؛ در subversion و CVS، می‌توانید فایل‌ها را ویرایش کنید، اما نمی‌توانید تغییرات را به پایگاه داده خود کامیت کنید(چون پایگاه داده شما افلاین است). این ممکن است به نظر نرسد که تفاوت بزرگی ایجاد کند، اما ممکن است متوجه شوید که چقدر تفاوت بزرگی می‌تواند ایجاد کند. diff --git a/src/chapter 1/01.3.3_git has integrity.md b/src/chapter_1/01.3.3_git_has_integrity.md similarity index 100% rename from src/chapter 1/01.3.3_git has integrity.md rename to src/chapter_1/01.3.3_git_has_integrity.md diff --git a/src/chapter 1/01.3.4_git generally only adds data.md b/src/chapter_1/01.3.4_git_generally_only_adds_data.md similarity index 100% rename from src/chapter 1/01.3.4_git generally only adds data.md rename to src/chapter_1/01.3.4_git_generally_only_adds_data.md diff --git a/src/chapter 1/01.3.5_the three states.md b/src/chapter_1/01.3.5_the_three_states.md similarity index 100% rename from src/chapter 1/01.3.5_the three states.md rename to src/chapter_1/01.3.5_the_three_states.md diff --git a/src/chapter 1/01.3_what is git.md b/src/chapter_1/01.3_what_is_git.md similarity index 100% rename from src/chapter 1/01.3_what is git.md rename to src/chapter_1/01.3_what_is_git.md diff --git a/src/chapter 1/01.4_the command line.md b/src/chapter_1/01.4_the_command_line.md similarity index 100% rename from src/chapter 1/01.4_the command line.md rename to src/chapter_1/01.4_the_command_line.md diff --git a/src/chapter 1/01.5.1_installing on linux.md b/src/chapter_1/01.5.1_installing_on_linux.md similarity index 96% rename from src/chapter 1/01.5.1_installing on linux.md rename to src/chapter_1/01.5.1_installing_on_linux.md index 12ba955..37bc90a 100644 --- a/src/chapter 1/01.5.1_installing on linux.md +++ b/src/chapter_1/01.5.1_installing_on_linux.md @@ -9,4 +9,4 @@ $ sudo apt install git-all ``` برای گزینه‌های بیشتر، می‌توانید دستورالعمل‌های نصب روی چندین توزیع مختلف یونیکس را در وب‌سایت گیت مشاهده کنید: -https://git-scm.com/download/linux + diff --git a/src/chapter 1/01.5.2_installing on macOS.md b/src/chapter_1/01.5.2_installing_on_macOS.md similarity index 92% rename from src/chapter 1/01.5.2_installing on macOS.md rename to src/chapter_1/01.5.2_installing_on_macOS.md index a63fb3c..461005f 100644 --- a/src/chapter 1/01.5.2_installing on macOS.md +++ b/src/chapter_1/01.5.2_installing_on_macOS.md @@ -7,6 +7,6 @@ $ git --version اگر می‌خواهید نسخه به‌روزتری از گیت داشته باشید، می‌توانید آن را از طریق یک نصب‌کننده باینری نصب کنید. نصب‌کننده گیت برای macOS به روز و در دسترس برای دانلود در وب‌سایت گیت قرار دارد: -https://git-scm.com/download/mac + -![alt text](git2/git-osx-installer.png) \ No newline at end of file +![alt text](git2/git-osx-installer.png) diff --git a/src/chapter 1/01.5.3_installing on windows.md b/src/chapter_1/01.5.3_installing_on_windows.md similarity index 50% rename from src/chapter 1/01.5.3_installing on windows.md rename to src/chapter_1/01.5.3_installing_on_windows.md index 8feef3b..8f4b048 100644 --- a/src/chapter 1/01.5.3_installing on windows.md +++ b/src/chapter_1/01.5.3_installing_on_windows.md @@ -1,6 +1,6 @@ # نصب در ویندوز -روش‌های مختلفی برای نصب گیت در ویندوز وجود دارد. رسمی‌ترین نسخه برای دانلود در وب‌سایت گیت در دسترس است. به سادگی به https://git-scm.com/download/win مراجعه کنید و دانلود به طور خودکار اغاز خواهد شد. توجه داشته باشید که این پروژه تحت عنوان <<گیت برای ویندوز>> نامیده می‌شود که از خود گیت جدا است؛ برای اطلاعات بیشتر به https://gitforwindows.org مراجعه کنید. +روش‌های مختلفی برای نصب گیت در ویندوز وجود دارد. رسمی‌ترین نسخه برای دانلود در وب‌سایت گیت در دسترس است. به سادگی به مراجعه کنید و دانلود به طور خودکار اغاز خواهد شد. توجه داشته باشید که این پروژه تحت عنوان <<گیت برای ویندوز>> نامیده می‌شود که از خود گیت جدا است؛ برای اطلاعات بیشتر به مراجعه کنید. برای نصب خودکار، می‌توانید از بسته chocolatey استفاده کنید توجه داشته باشید که این بسته به طور جامعه‌ محور نگهداری می‌شود. -https://gitforwindows.org/ \ No newline at end of file + diff --git a/src/chapter 1/01.5.4_installing from source.md b/src/chapter_1/01.5.4_installing_from_source.md similarity index 88% rename from src/chapter 1/01.5.4_installing from source.md rename to src/chapter_1/01.5.4_installing_from_source.md index 1759002..ac7cf0d 100644 --- a/src/chapter 1/01.5.4_installing from source.md +++ b/src/chapter_1/01.5.4_installing_from_source.md @@ -40,7 +40,7 @@ $ sudo ln -s /usr/bin/db2x_docbook2texi /usr/bin/docbook2x-tex ``` این دستور به دلیل تفاوت در نام‌های باینری است. -پس از نصب تمام وابستگی‌های لازم، می‌توانید آخرین نسخه تگ شده را از چندین مکان دانلود کنید. می‌توانید آن را از سایت kernel.org در https://www.kernel.org/pub/software/scm/git یا از آینه گیت‌هاب در https://github.com/git/git/tags دریافت کنید. معمولاً در صفحه گیت‌هاب مشخص‌تر است که آخرین نسخه چیست، اما صفحه kernel.org همچنین امضاهای انتشار را نیز دارد تا بتوانید دانلود خود را تأیید کنید. +پس از نصب تمام وابستگی‌های لازم، می‌توانید آخرین نسخه تگ شده را از چندین مکان دانلود کنید. می‌توانید آن را از سایت kernel.org در یا از آینه گیت‌هاب در دریافت کنید. معمولاً در صفحه گیت‌هاب مشخص‌تر است که آخرین نسخه چیست، اما صفحه kernel.org همچنین امضاهای انتشار را نیز دارد تا بتوانید دانلود خود را تأیید کنید. سپس گیت را کامپایل و نصب کنید: ``` diff --git a/src/chapter 1/01.5_installing git.md b/src/chapter_1/01.5_installing_git.md similarity index 100% rename from src/chapter 1/01.5_installing git.md rename to src/chapter_1/01.5_installing_git.md diff --git a/src/chapter 1/01.6.1_your identity.md b/src/chapter_1/01.6.1_your_identity.md similarity index 100% rename from src/chapter 1/01.6.1_your identity.md rename to src/chapter_1/01.6.1_your_identity.md diff --git a/src/chapter 1/01.6.2_your editor.md b/src/chapter_1/01.6.2_your_editor.md similarity index 100% rename from src/chapter 1/01.6.2_your editor.md rename to src/chapter_1/01.6.2_your_editor.md diff --git a/src/chapter 1/01.6.3_your default branch%name.md b/src/chapter_1/01.6.3_your_default_branch%name.md similarity index 100% rename from src/chapter 1/01.6.3_your default branch%name.md rename to src/chapter_1/01.6.3_your_default_branch%name.md diff --git a/src/chapter 1/01.6.4_checking your settings.md b/src/chapter_1/01.6.4_checking_your_settings.md similarity index 100% rename from src/chapter 1/01.6.4_checking your settings.md rename to src/chapter_1/01.6.4_checking_your_settings.md diff --git a/src/chapter 1/01.6_first-time git setup.md b/src/chapter_1/01.6_first-time_git_setup.md similarity index 100% rename from src/chapter 1/01.6_first-time git setup.md rename to src/chapter_1/01.6_first-time_git_setup.md diff --git a/src/chapter 1/01.7_getting help.md b/src/chapter_1/01.7_getting_help.md similarity index 90% rename from src/chapter 1/01.7_getting help.md rename to src/chapter_1/01.7_getting_help.md index 9a614a7..0b93ddf 100644 --- a/src/chapter 1/01.7_getting help.md +++ b/src/chapter_1/01.7_getting_help.md @@ -11,7 +11,7 @@ $ man git- $ git help config ``` -این دستورات بسیار مفید هستند زیرا می‌توانید هر زمان و در هر جایی به آن‌ها دسترسی داشته باشید، حتی در حالت آفلاین. اگر صفحات man و این کتاب کافی نیستند و به کمک حضوری نیاز دارید، می‌توانید به کانال‌های #git، #github یا #gitlab در سرور IRC Libera Chat مراجعه کنید که در آدرس https://libera.chat/ قابل دسترسی است. این کانال‌ها معمولاً پر از افرادی هستند که در مورد گیت دانش بالایی دارند و اغلب آماده کمک به دیگران هستند. +این دستورات بسیار مفید هستند زیرا می‌توانید هر زمان و در هر جایی به آن‌ها دسترسی داشته باشید، حتی در حالت آفلاین. اگر صفحات man و این کتاب کافی نیستند و به کمک حضوری نیاز دارید، می‌توانید به کانال‌های #git، #github یا #gitlab در سرور IRC Libera Chat مراجعه کنید که در آدرس قابل دسترسی است. این کانال‌ها معمولاً پر از افرادی هستند که در مورد گیت دانش بالایی دارند و اغلب آماده کمک به دیگران هستند. علاوه بر این، اگر به کمک کامل manpage نیاز ندارید و فقط به یک یادآوری سریع درباره گزینه‌های موجود برای یک دستور گیت نیاز دارید، می‌توانید از گزینه -h برای دریافت خروجی کمک مختصر استفاده کنید، مانند: ``` @@ -39,4 +39,4 @@ Usage: git add [] [--] ... - --chmod (+|-)x : override the executable bit of the listed files - --pathspec-from-file : read pathspec from file - --pathspec-file-nul : with --pathspec-from-file, pathspec elements -``` \ No newline at end of file +``` diff --git a/src/chapter 1/01.8_summary.md b/src/chapter_1/01.8_summary.md similarity index 100% rename from src/chapter 1/01.8_summary.md rename to src/chapter_1/01.8_summary.md diff --git a/src/chapter 1/01_getting started.md b/src/chapter_1/01_getting_started.md similarity index 100% rename from src/chapter 1/01_getting started.md rename to src/chapter_1/01_getting_started.md diff --git a/src/chapter 1/git2/areas.png b/src/chapter_1/git2/areas.png similarity index 100% rename from src/chapter 1/git2/areas.png rename to src/chapter_1/git2/areas.png diff --git a/src/chapter 1/git2/centralized.png b/src/chapter_1/git2/centralized.png similarity index 100% rename from src/chapter 1/git2/centralized.png rename to src/chapter_1/git2/centralized.png diff --git a/src/chapter 1/git2/deltas.png b/src/chapter_1/git2/deltas.png similarity index 100% rename from src/chapter 1/git2/deltas.png rename to src/chapter_1/git2/deltas.png diff --git a/src/chapter 1/git2/distributed.png b/src/chapter_1/git2/distributed.png similarity index 100% rename from src/chapter 1/git2/distributed.png rename to src/chapter_1/git2/distributed.png diff --git a/src/chapter 1/git2/git-osx-installer.png b/src/chapter_1/git2/git-osx-installer.png similarity index 100% rename from src/chapter 1/git2/git-osx-installer.png rename to src/chapter_1/git2/git-osx-installer.png diff --git a/src/chapter 1/git2/local.png b/src/chapter_1/git2/local.png similarity index 100% rename from src/chapter 1/git2/local.png rename to src/chapter_1/git2/local.png diff --git a/src/chapter 1/git2/snapshots.png b/src/chapter_1/git2/snapshots.png similarity index 100% rename from src/chapter 1/git2/snapshots.png rename to src/chapter_1/git2/snapshots.png