Patch chapter 1

Author: Davoodeh

book/01-introduction/sections/about-version-control.asc

@@ -3,21 +3,21 @@
 (((version control)))
 «کنترل نسخه» چیست و چرا باید بدان پرداخت؟ کنترل نسخه سیستمی است که تغییرات را در فایل یا دسته‌ای از
 فایل‌ها ذخیره می‌کند و به شما این امکان را می‌دهد که در آینده به نسخه و نگارش خاصی برگردید.
-برای مثال‌های این کتاب شما از سورس کد نرم‌افزار به عنوان فایل‌هایی که نسخه آنها کنترل می‌شود استفاده می‌کنید.
+برای مثال‌های این کتاب، شما از سورس کد نرم‌افزار به عنوان فایل‌هایی که نسخه آنها کنترل می‌شود استفاده می‌کنید.
 اگرچه در واقع می‌توانید تقریباً از هر فایلی استفاده کنید.
 
 اگر شما یک گرافیست یا طراح وب هستید و می‌خواهید نسخه‌های متفاوت از عکس‌ها و قالب‌های خود داشته باشید (که احتمالاً می‌خواهید)، یک سیستم کنترل نسخه (Version Control System (VCS)) انتخاب خردمندانه‌ای است.
-یک VCS به شما این امکان را می‌دهد که فایل‌های انتخابی یا کل پروژه را به یک حالت قبلی خاص برگردانید، روند تغییرات را بررسی کنید، ببینید چه کسی آخرین‌بار تغییری ایجاد کرده که احتمالاً مشکل آفرین شده،
+یک VCS به شما این امکان را می‌دهد که فایل‌های انتخابی یا کل پروژه را به یک حالت قبلی خاص برگردانید، روند تغییرات را بررسی کنید، ببینید چه کسی آخرین بار تغییری ایجاد کرده که احتمالاً مشکل آفرین شده،
 چه کسی، چه وقت مشکلی را اعلام کرده و...
-استفاده از یک VCS همچنین به این معناست که اگر شما در حین کار چیزی را خراب کردید و یا فایل‌هایی از دست رفت، به سادگی می توانید کارهای انجام شده را بازیابی نمایید.
+استفاده از یک VCS همچنین به این معناست که اگر شما در حین کار چیزی را خراب کردید و یا فایل‌هایی از دست رفت، به سادگی می‌توانید کارهای انجام شده را بازیابی نمایید.
 همچنین مقداری سربار به فایل‌های پروژه‌تان افزوده می‌شود.
 
 ==== سیستم‌های کنترل نسخهٔ محلی
 
 (((version control,local)))
 روش اصلی کنترل نسخهٔ کثیری از افراد کپی کردن فایل‌ها به پوشه‌ای دیگر است (احتمالاً با تاریخ‌گذاری، اگر خیلی باهوش باشند).
 این رویکرد به علت سادگی بسیار رایج است هرچند خطا آفرینی بالایی دارد.
-فراموش کردن اینکه در کدام پوشه بوده‌اید و نوشتن اشتباهی روی فایل یا فایل‌هایی که نمی‌خواستید روی آن بنویسید بسیار ساده است.
+فراموش کردن اینکه در کدام پوشه بوده‌اید و نوشتن اشتباهی روی فایل یا فایل‌هایی که نمی‌خواستید روی آن بنویسید بسیار آسان است.
 
 برای حل این مشکل، سال‌ها قبل VCSهای محلی را توسعه دادند که پایگاه داده‌ای ساده داشت که تمام تغییرات فایل‌های تحت مراقبتش را نگهداری می‌کرد.
 
@@ -28,36 +28,35 @@ image::images/local.png[Local version control diagram]
 https://www.gnu.org/software/rcs/[RCS] با نگه داشتن مجموعه‌هایی از پچ‌ها (Patch/وصله) -- همان تفاوت‌های بین نگارش‌های گوناگون فایل‌ها -- در قالبی ویژه کار می‌کند؛
 پس از این، با اعمال پچ‌ها می‌تواند هر نسخه‌ای از فایل که مربوط به هر زمان دلخواه است را بازسازی کند.
 
-==== سیستم‌های کنترل نسخهٔ‌ متمرکز
+==== سیستم‌های کنترل نسخهٔ متمرکز
 
 (((version control,centralized)))
-چالش بزرگ دیگری که مردم با آن روبرو می شوند نیاز به همکاری با توسعه‌دهندگانی است که با سیستم‌های دیگر کار می‌کنند.
+چالش بزرگ دیگری که مردم با آن روبرو می‌شوند نیاز به همکاری با توسعه‌دهندگانی است که با سیستم‌های دیگر کار می‌کنند.
 دربرخورد با این چالش سیستم‌های کنترل نسخه متمرکز (Centralized Version Control System (CVCS)) ایجاد شدند.
-این قبیل سیستم‌ها (چون CVS، ساب‌ورژن و Preforce) یک سرور دارند که تمام فایل‌های نسخه‌بندی شده را در بر دارد و تعدادی کلاینت (Client/خدمت‌گیرنده)
+این قبیل سیستم‌ها (مثل CVS، ساب‌ورژن و Preforce) یک سرور دارند که تمام فایل‌های نسخه‌بندی شده را در بر دارد و تعدادی کلاینت (Client/خدمت‌گیرنده)
 که فایل‌هایی را از آن سرور چک‌اوت (Checkout/وارسی) می‌کنند. (((CVS)))(((Subversion)))(((Perforce))) سال‌های سال این روش استاندارد کنترل نسخه بوده است.
 
 .کنترل نسخه متمرکز.
 image::images/centralized.png[Centralized version control diagram]
 
 
 این ساماندهی به ویژه برای VCSهای محلی منافع و مزایای بسیاری دارد. به طور مثال هر کسی به میزان مشخصی از فعالیت‌های دیگران روی پروژه آگاهی دارد.
-مدیریان دسترسی و کنترل مناسبی بر این دارند که چه کسی چه کاری می تواند انجام دهد؛
+مدیران دسترسی و کنترل مناسبی بر این دارند که چه کسی چه کاری می‌تواند انجام دهد؛
 همچنین مدیریت یک CVCS خیلی آسان‌تر از درگیری با پایگاه‌داده‌های محلی روی تک تک کلاینت‌هاست.
 
-هرچند که این گونه ساماندهی معایب جدی نیز دارد. واضح‌ترین آن رخدادن خطا در سروری که نسخه‌ها در آن متمرکز شده است.
-اگر که سرور برای یک ساعت غیرفعال باشد، در طول این یک ساعت هیچ‌کس نمی تواند همکاری یا تغییراتی که انجام داده است را ذخیره نماید.
+هرچند که این گونه ساماندهی معایب جدی نیز دارد. واضح‌ترین آن رخدادن خطا در سروری که نسخه‌ها در آن متمرکز شده‌اند است.
+اگر که سرور برای یک ساعت غیرفعال باشد، در طول این یک ساعت هیچ‌کس نمی‌تواند همکاری یا تغییراتی که انجام داده است را ذخیره نماید.
 اگر هارددیسک سرور مرکزی دچار مشکلی شود و پشتیبان مناسبی هم تهیه نشده باشد
 همه چیز (تاریخچه کامل پروژه بجز اسنپ‌شات‌هایی که یک کلاینت ممکن است روی کامپیوتر خود ذخیره کرده باشد) از دست خواهد رفت.
-VCSهای محلی نیز همگی این مشکل را دارند -- هرگاه کل تاریخچه پروژه را در یک مکان واحد ذخیره کنید، خطر از دست‌دادن همه چیز را به جان می‌خرید.
+VCSهای محلی نیز همگی این مشکل را دارند -- هرگاه کل تاریخچه پروژه را در یک مکان واحد ذخیره کنید، خطر از دست دادن همه چیز را به جان می‌خرید.
 
 ==== سیستم‌های کنترل نسخه توزیع‌شده
 
 (((version control,distributed)))
-
 اینجا است که سیستم‌های کنترل نسخه توزیع‌شده (Distributed Version Control System (DVCS)) نمود پیدا می‌کنند.
 در یک DVCS (مانند گیت، Mercurial، Bazaar یا Darcs) کلاینت‌ها صرفاً به چک‌اوت کردن آخرین اسنپ‌شات فایل‌ها اکتفا نمی‌کنند؛
-بلکه آن‌ها کل مخزن (Repository) را کپی عینی یا آینه (Mirror) می‌کنند که شامل تاریخچه کاملش هم می‌شود.
-بنابراین اگر هر سروری که سیستم‌ها به واسطه آن در حال تعامل با یکدیگر هستند متوقف و از کار بیافتد، با کپی مخرن هر کدام از کاربران بر روی سرور، می‌توان آن را بازیابی کرد.
+بلکه آن‌ها کل مخزن (Repository) را کپی عینی یا آینه (Mirror) می‌کنند که شامل تاریخچه کامل آن هم می‌شود.
+بنابراین اگر هر سروری که سیستم‌ها به واسطه آن در حال تعامل با یکدیگر هستند متوقف شده و از کار بیافتد، با کپی مخرن هر کدام از کاربران بر روی سرور، می‌توان آن را بازیابی کرد.
 در واقع هر کلون، پشتیبان کاملی از تمامی داده‌ها است.
 
 

book/01-introduction/sections/command-line.asc

@@ -3,8 +3,8 @@
 روش‌های مختلفی برای استفاده از گیت وجود دارد.
 ابزارهای اصیل خط فرمان و بسیاری از رابط‌های کاربری گرافیکی با قابلیت‌های مختلف وجود دارد.
 برای این کتاب، ما از گیت در خط فرمان استفاده خواهیم کرد.
-اول آنکه فقط خط فرمان به شما این امکان را می دهد که بتوانید _همه_ دستورات گیت را اجرا کنید -- اکثر رابط‌های گرافیکی جهت ساده بودن فقط بخش جزئی از کارکرد گیت را پیاده‌سازی می‌کنند.
-اگر می‌دانید که چگونه نسخه خط فرمان را اجرا کنید، احتمالا می توانید از نحوه اجرای نسخه رابط گرافیکی نیز سر دربیاورید، اما برعکس آن لزوماً ممکن نیست.
+اول آنکه فقط خط فرمان به شما این امکان را می‌دهد که بتوانید _همه_ دستورات گیت را اجرا کنید -- اکثر رابط‌های گرافیکی جهت ساده بودن فقط بخش جزئی از کارکرد گیت را پیاده‌سازی می‌کنند.
+اگر می‌دانید که چگونه نسخه خط فرمان را اجرا کنید، احتمالاً می‌توانید از نحوه اجرای نسخه رابط گرافیکی نیز سر دربیاورید، اما برعکس آن لزوماً ممکن نیست.
 علاوه بر آن ممکن است که انتخاب کلاینت گرافیکی حاصل سلیقه شخصی شما باشد، اما _همه_ کاربران همیشه رابط واحد خط فرمان را نصب و در دسترس دارند.
 
 بنابرین انتظار می‌رود که شما بدانید چگونه ترمینال را در مک و یا Command Prompt یا Powershell را در ویندوز باز کنید.

book/01-introduction/sections/first-time-setup.asc

@@ -2,11 +2,11 @@
 === اولین راه‌اندازی گیت
 
 حالا که گیت را در سیستم خود دارید، وقت آن است که چند شخصی‌سازی در محیط گیت‌تان انجام دهید.
-شما باید این کارها را فقط یک بار به ازای هر کامپیوتری انجام دهید؛ این تنظیمات با بروزرسانی‌ها از بین نمی‌رود.
-همچنین شما می‌توانید هر زمان که خواستید آنها را با اجرای دوباره دستورات تغییر دهید.
+باید این کارها را فقط یک بار به ازای هر کامپیوتری انجام دهید؛ این تنظیمات با بروزرسانی‌ها از بین نمی‌رود.
+همچنین می‌توانید هر زمان که خواستید آنها را با اجرای دوباره دستورات تغییر دهید.
 
-گیت با ابزاری به نام `git config` ارائه می‌شود که به شما امکان تنظیم و خواندن متغیرهای پیکربندی که تمام جوانب کاری گیت و ظاهر آن را مدیریت می‌کنند را می‌دهد.(((git commands, config)))
-این متغیرها را می توان در سه مکان مختلف ذخیره کرد:
+گیت با ابزاری به نام `git config` ارائه می‌شود، که به شما امکان تنظیم و خواندن متغیرهای پیکربندی که تمام جوانب کاری گیت و ظاهر آن را مدیریت می‌کنند را می‌دهد.(((git commands, config)))
+این متغیرها را می‌توان در سه مکان مختلف ذخیره کرد:
 
 1. فایل `/etc/gitconfig`: شامل مقادیری است که برای تمام کاربران سیستم و تمام مخازن آنها اعمال می‌شود.
 اگر از آپشن `--system` برای `git config` استفاده کنید خواندن و نوشتن با فایل مذکور انجام می‌شود.
@@ -21,7 +21,7 @@
 
 در سیستم‌های ویندوزی گیت به دنبال فایل `.gitconfig` در پوشه `$HOME` می‌گردد (که برای اکثریت `C:\Users\$USER` است).
 علاوه بر آن همچنان به دنبال `/etc/gitconfig` می‌گردد،
-اگرچه به دنبال آن به نسبت روت MSys می‌گردد که هنگامی نصب گیت روی سیستم ویندوزتان آنرا تنظیم می‌کنید.
+اگرچه به دنبال آن به نسبت روت MSys می‌گردد که هنگام نصب گیت روی سیستم ویندوزتان آنرا تنظیم می‌کنید.
 اگر از نسخه 2.x یا بالاتر گیت برای ویندوز استفاده می‌کنید باید یک فایل پیکربندی مرتبه-سیستمی
 در `C:\Documents and Settings\All Users\Application Data\Git\config` روی ویندوز XP و
 در `C:\ProgramData\Git\config` روی ویندوز ویستا و جدیدتر وجود داشته باشد.
@@ -67,7 +67,7 @@ $ git config --global core.editor emacs
 این مسیر می‌تواند بسته به نحوه پکیج‌شدن ویرایشگر شما متفاوت باشد.
 
 نوت‌پد++ را نظر بگیرید، یک ویرایشگر محبوب برنامه‌نویسی، که از آنجایی که نسخه ۶۴ بیتی در زمان نوشتن این متن از تمام افزونه‌ها پشتیبانی نمی‌کند احتمالاً از نسخه ۳۲ بیت آن استفاده می‌کنید.
-اگر شما از یک سیستم ویندوز ۲۳ بیتی استفاده می‌کنید یا یک ویرایشگر ۶۴ بیتی روی یک سیستم ۶۴ بیتی دارید، ورودی مسیر کامل چیزی شبیه زیر خواهد بود:
+اگر شما از یک سیستم ویندوز ۳۲ بیتی استفاده می‌کنید یا یک ویرایشگر ۶۴ بیتی روی یک سیستم ۶۴ بیتی دارید، ورودی مسیر کامل چیزی شبیه زیر خواهد بود:
 
 [source,console]
 ----
@@ -102,7 +102,7 @@ color.diff=auto
 ...
 ----
 
-شما ممکن است بعضی از کلیدها را بیش از سایر کلیدها ببینید چرا که گیت آن کلیدها را از فایل‌های مختلف می‌خواند (`/etc/gitconfig` و `~/.gitconfig` به طور مثال).
+ممکن است بعضی از کلیدها را بیش از سایر کلیدها ببینید چرا که گیت آن کلیدها را از فایل‌های مختلف می‌خواند (`/etc/gitconfig` و `~/.gitconfig` به طور مثال).
 در این حالت گیت از آخرین مقداری که برای هر کلید یکتا می‌خواند استفاده می‌کند.
 
 همچنین می‌توانید مقدار مد نظر گیت را برای یک کلید خاص را با `git cofnig <key>` بررسی کنید:(((git commands, config)))
@@ -115,9 +115,8 @@ John Doe
 
 [NOTE]
 ====
-
-از آنجا که ممکن است گیت مقدار یک متغییر پیکربندی را از بیش از یک فایل بخواند، احتمال دارد که یک مقدار غیرمنتظره برای یکی از این مقادیر پیدا کنید و چرایی این قضیه را ندانید.
-در چنین مواردی می توانید از گیت _origin_ (مرجع) یک مقدار را پرس‌وجو کنید و به شما خواهد گفت که کدام فایل پیکربندی آخرین حرف را در تنظیم مقدار مورد نظر زده است:
+از آنجا که ممکن است گیت مقدار یک متغیر پیکربندی را از بیش از یک فایل بخواند، احتمال دارد که یک مقدار غیرمنتظره برای یکی از این مقادیر پیدا کنید و چرایی این قضیه را ندانید.
+در چنین مواردی می‌توانید از گیت _origin_ (مرجع) یک مقدار را پرس‌وجو کنید و به شما خواهد گفت که کدام فایل پیکربندی آخرین حرف را در تنظیم مقدار مورد نظر زده است:
 
 [source,console]
 ----

book/01-introduction/sections/help.asc

@@ -1,7 +1,7 @@
 [[_git_help]]
-=== مددخواهی
+=== کمک گرفتن
 
-در شرایطی که برای کار با گیت به کمک احتیاج داشتید، سه روش معادل برای گرفتن یک راهنمای مشروح (_manpage_/من‌پیچ/صفحهٔ راهنما) دربارهٔ هر یک از دستورات گیت وجود دارد:
+در شرایطی که برای کار با گیت به کمک احتیاج داشتید، سه روش معادل برای گرفتن یک راهنمای مشروح (manpage) دربارهٔ هر یک از دستورات گیت وجود دارد:
 
 [source,console]
 ----
@@ -21,7 +21,8 @@ $ git help config
 اگر صفحات راهنما و این کتاب کافی نیستند و شما به کمک فردی احتیاج دارید، می‌توانید به کانال `#git` یا `#github` روی سرور IRC فری‌نود متصل شوید که در https://freenode.net[] واقع است.
 معمولاً این کانال‌ها با صدها داوطلب پر شده است که همه دربارهٔ گیت بسیار آگاه و مایل به کمک کردن هستند.(((IRC)))
 
-آخر اینکه اگر نیازی به یک صفحه راهنمای کامل و جامع ندارید و فقط به یک یادآوری سریع برای آپشن‌های یک دستور احتیاج دارید، می‌توانید از خروجی مختصر آپشن «کمک» بوسیلهٔ `-h` بخواهید که به شما یادآوری کند؛ همانگونه که در مثال زیر آمده:
+آخر اینکه اگر نیازی به یک صفحه راهنمای کامل و جامع ندارید و فقط به یک یادآوری سریع برای آپشن‌های یک دستور احتیاج دارید، می‌توانید از خروجی مختصر آپشن «کمک» بوسیلهٔ `-h` بخواهید که به شما یادآوری کند؛
+همانگونه که در مثال زیر آمده است:
 
 [source,console]
 ----