Skip to content

Commit ae55106

Browse files
committed
Patch chapter 2
1 parent a01bb5d commit ae55106

File tree

10 files changed

+400
-479
lines changed

10 files changed

+400
-479
lines changed

TRANSLATION_NOTES.asc

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -116,4 +116,15 @@
116116
|HTTP غیرهوشمند |Dumb HTTP
117117
|HTTP هوشمند |Smart HTTP
118118
|خودمیزبان |Self-hosting
119+
|هارددیسک |Hard drive/disk
120+
|رهگیری‌شده |Tracked
121+
|رهگیری‌نشده |Untracked
122+
|قالب |Format
123+
|ASCII |ASCII
124+
|نشان بده |Show
125+
|نمایش بده |Display
126+
|لیست کردن |List
127+
|برچسب توضیحی |Annotated tag
128+
|برچسب سبک |Lightweight tag
129+
|نام‌های مستعار |Aliases
119130
|===

book/02-git-basics/sections/aliases.asc

Lines changed: 17 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,12 @@
22
=== نام‌های مستعار در گیت
33

44
(((aliases)))
5-
پیش از پایان بخش پایه‌های گیت، تنها یک نکته کوچک می ماند که میتواند تجربهٔ کارتان را با گیت ساده تر، آسان تر و آشناتر کند:
6-
نام‌های مستعار (آلیاز/alias).
7-
ما به نام‌های مستعار اشاره نخواهیم کرد یا تصور می‌کنیم که شمااز آنها در کتاب استفاده کرده‌ بودید اما شاید بهتر باشد بدانید
8-
که چگونه با آنها کار کنید.
9-
اگر شما دستوراتی را خلاصه یا بخش بخصوصی از آن را بنویسید گیت نمی‌تواند در بخش از دستورات شما را حدس بزند به همین دلیل
10-
شما می‌توانید به راحتی با تنظیم الیازهایی بر روی دستوراتی که از آن استفاده می‌کنید دستورات را آنگونه که دوست دارید بنویسید.
11-
با دستور `git config`.
5+
پیش از پایان بخش مقدمات گیت، تنها یک نکته کوچک می‌ماند که می‌تواند تجربهٔ کارتان با گیت را ساده‌تر، آسان‌تر و آشناتر کند: نام‌های مستعار (Aliases).
6+
ما به نام‌های مستعار باز نخواهیم گشت یا فرض می‌کنیم که شمااز آنها در ادامهٔ کتاب استفاده کرده‌اید، اما احتمالاً بهتر است بدانید که چگونه باید با آنها کار کنید.
127

13-
برای ساخت آلیاز، مانند مثال‌های زیر آنگونه که می‌خواهید تنظیمات را اعمال کنید:
8+
اگر دستوری را خلاصه یا بخش بخصوصی از آن را بنویسید گیت دستور شما را حدس نمی‌زند.
9+
اگر نمی‌خواهید که تمام متن هر کدام از دستورهای گیت را وارد کنید، به سادگی می‌توانید یک نام مستعار برای هر دستور با استفاده از `git config` تنظیم کنید.(((git commands, config)))
10+
مثال‌های زیر نمونه‌هایی هستند که ممکن است بخواهید برای خود داشته باشید:
1411

1512
[source,console]
1613
----
@@ -20,18 +17,18 @@ $ git config --global alias.ci commit
2017
$ git config --global alias.st status
2118
----
2219

23-
برای مثال -- به جای وارد کردن `git commit`،‌ شما فقط نیاز دستور `git ci` را وارد کنید.
24-
همین طور که با گیت کار می کنید، شاید دستورات دیگری را مکرران استفاده کنید;با خیالی راحت الیازی جدید بسازید.
20+
این به آن معناست که اگر، برای مثال، به جای تایپ کردن `git commit` فقط لازم است `git ci` را تایپ کنید.
21+
همین طور که با گیت کار می‌کنید، شاید از دستورات دیگری نیز مکرراً استفاده کنید؛ برای ساختن نام مستعار جدید تأمل نکنید.
2522

26-
این تکنیک می‌تواند در ساخت دستورات جدید بسیار مفید باشد.
27-
برای نمونه، برای رفع مشکل unstaging کردن یک فایل، می‌توانید دستور ویژه خودتان را به گیت بیافزایید:
23+
این تکنیک می‌تواند در ساخت دستورات جدیدی که فکر می‌کنید باید وجود می‌داشت بسیار مفید باشد.
24+
برای نمونه، برای رفع مشکل استفاده‌ای که هنگام آن‌استش کردن یک فایل به آن بر می‌خورید، می‌توانید نام مستعار آن‌استش ویژه خودتان را به گیت بیافزایید:
2825

2926
[source,console]
3027
----
3128
$ git config --global alias.unstage 'reset HEAD --'
3229
----
3330

34-
با این کار دو دستور زیر با هم برابراند و یک کار را انجام می‌دهند:
31+
این باعث می‌شود که دو دستور زیر با یکدیگر برابر باشند:
3532

3633
[source,console]
3734
----
@@ -40,14 +37,14 @@ $ git reset HEAD -- fileA
4037
----
4138

4239
به نظر، کمی قضیه قابل فهم و روشن شد.
43-
همچنین معمولا از دستور `last` نیز به دین صورت استفاده می‌شود:
40+
همچنین اضافه کردن دستور `last` نیز به دین صورت رایج است:
4441

4542
[source,console]
4643
----
4744
$ git config --global alias.last 'log -1 HEAD'
4845
----
4946

50-
با این روش، به سادگی می‌توانید آخرین کامیت را مشاهده کنید.
47+
با این روش، به سادگی می‌توانید آخرین کامیت را مشاهده کنید:
5148

5249
[source,console]
5350
----
@@ -62,12 +59,11 @@ Date: Tue Aug 26 19:48:51 2008 +0800
6259
----
6360

6461

65-
همانطور که گیت به سادگی دستورات جدید را با هرآنچه شما به عنوان نام مستعار می سازید جایگزین می کند.
66-
با این وجود، شاید بخواهید یک دستور خارجی را اجرا کنید که آن دستور زیر مجموعه‌ی گیت باشد.
67-
در این مورد، دستور را با علامت `!` آغاز می کنیم.
68-
این امکان زمانی سودمند است که ابزار خودتان را برای کار با مخزن گیت بنویسید.
69-
70-
ما می‌توانیم با آلیاز، به جای دستور `gitk`، دستور `git visual` را بکار بگیریم. به این ترتیب:
62+
همانطور که پی بردید گیت به سادگی دستورات جدید را با هرآنچه شما به عنوان نام مستعار می‌سازید جایگزین می‌کند.
63+
با این وجود، شاید بخواهید به جای یک زیردستور گیت، یک دستور خارجی را اجرا کنید.
64+
در این صورت، دستور را با علامت `!` آغاز می‌کنیم.
65+
اگر می‌خواهید ابزار خودتان را برای کار با مخزن گیت بنویسید این مفید واقع می‌شود.
66+
با اضافه کردن نام مستعار `git visual` برای اجرای `gitk` می‌توانیم این را نشان دهیم:
7167

7268

7369
[source,console]
Lines changed: 26 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
11
[[_getting_a_repo]]
2-
=== راه‌اندازی یک مخزن گیت
2+
=== دستیابی به یک مخزن گیت
33

4-
شما می توانید مخزن گیت را به یکی از دو روش زیر به دست آورید:
4+
به طور کل می‌توانید به یکی از دو روش زیر یک مخزن به دست آورید:
55

66
1. یک پوشه محلی که تحت نظارت کنترل نسخه نیست را به مخزن گیت تبدیل کنید، یا
7-
2. یک نسخه از یک مخزن از پیش موجود گیت کلون کنید.
7+
2. یک نسخه از یک مخزن از پیش موجود گیت را از جایی دیگر کلون کنید.
88

9-
به هر روی شما یک مخزن گیت محلی آماده به کار خواهید داشت.
9+
در هر صورت شما یک مخزن گیت محلی آماده به کار خواهید داشت.
1010

11-
==== راه‌اندازی مخرن گیت در یک پوشه موجود
11+
==== راه‌اندازی مخزن گیت در یک پوشه موجود
1212

1313
اگر شما پروژه‌ای دارید که هنوز تحت نظارت کنترل نسخه نیست و می‌خواهید که مدیریت نسخه‌های آن را به کمک گیت انجام دهید، ابتدا به پوشه اصلی پروژه بروید.
14-
اگر تا کنون این کار را نکرده‌اید، این کار به نظر می‌رسد بسته سیستم‌عامل شما کمی گوناگون باشد:
14+
اگر تا کنون این کار را نکرده‌اید، این کار بسته سیستم‌عامل شما ممکن است کمی متفاوت باشد:
1515

1616
در لینوکس:
1717
[source,console]
@@ -23,26 +23,26 @@ $ cd /home/user/my_project
2323
----
2424
$ cd /Users/user/my_project
2525
----
26-
در ویندوز:
26+
برای ویندوز:
2727
[source,console]
2828
----
2929
$ cd C:/Users/user/my_project
3030
----
3131

32-
و سپس در آنجا دستور زیر را بزنید:
32+
و تایپ کنید:
3333

3434
[source,console]
3535
----
3636
$ git init
3737
----
3838

39-
با زدن این دستور یک پوشه تازه به نام `.git` ساخته می شود که تمام فایل‌هایی که مخزن نیاز دارد -- اسکلت یک مخزن گیت -- را در برد دارد.
40-
تا اینجای کار، گیت تغییرات هیچ فایلی را دنبال نمی کند.
41-
(برای اینکه بدانید در پوشه `.git` که هم اکنون ایجاد کردید، چه فایلهایی وجود دارند، <<ch10-git-internals#ch10-git-internals>> را ببینید.)(((git commands, init)))
39+
با زدن این دستور یک پوشه تازه به نام `.git` ساخته می‌شود که تمام فایل‌هایی که مخزن نیاز دارد -- اسکلت یک مخزن گیت -- را در بر دارد.
40+
تا اینجای کار، گیت تغییرات هیچ فایلی را دنبال نمی‌کند.
41+
(برای اینکه بدانید در پوشه `.git` که هم اکنون ایجاد کردید، چه فایل‌هایی وجود دارند، <<ch10-git-internals#ch10-git-internals>> را ببینید.)(((git commands, init)))
4242

4343
اگر می‌خواهید شروع به کنترل نسخه فایل‌های موجود در پروژه کنید (مگر اینکه پوشه خالی باشد) شاید بهتر باشد که آنها را ترک
44-
یا مورد پیگیری قرار دهید و اولین کامیت یا کامیت ابتدایی را انجام دهید. شما می‌توانید با وارد کردن چند دستور `git add` مشخص کنید
45-
که چه فایل‌هایی ترک شوند و در اخر نیز آنها را با دستور `git commit` کامیت می‌کنید.
44+
یا مورد پیگیری قرار دهید و اولین کامیت یا کامیت ابتدایی را انجام دهید.
45+
برای انجام این کار می‌توانید با چند دستور `git add` فایل‌های انتخابی را رهگیری کنید و و در نهایت `git commit` بزنید:
4646

4747
[source,console]
4848
----
@@ -51,36 +51,33 @@ $ git add LICENSE
5151
$ git commit -m 'Initial project version'
5252
----
5353

54-
کمی جلوتر خواهید فهمید که دستورات بالا دقیقاُ چه کاری انجام می‌دهند.
55-
در حال حاضر ما یک مخزن گیت با فایل‌هایی که ترک شده‌اند و یک کامیت شروع داریم.
54+
کمی جلوتر به بررسی کاربرد این دستور‌ها می‌پردازیم.
55+
در حال حاضر یک مخزن گیت با فایل‌هایی که ترک شده‌اند و یک کامیت شروع دارید.
5656

5757
[[_git_cloning]]
5858
==== کلون‌کردن از مخزن موجود
5959

60-
اگر می‌خواهید یک کپی کامل از یک مخزن از پیش موجود را داشته باشید -- برای مثال، پروژه‌ای که علاقه دارید در آن مشارکت کنید -- دستوری که به آن
61-
احتیاج دارید `git clone` است.
62-
اگر کمی با دیگر نرم‌افزارهای کنترل نسخه مانند ساب‌ورژن آشنا باشید، متوجه‌ خواهید شد که فعل این دستور `clone` است،
63-
نه `checkout`،‌این یک تفاوت خیلی مهم است -- به جای اینکه یک نسخه کپی از پروژه به دست آورید، گیت به طور مستقیم یک نسخه کامل از تمامی
64-
داده‌هایی که در سرور وجود دارد را تحویل می‌گیرد.
65-
60+
اگر می‌خواهید یک کپی کامل از یک مخزن از پیش موجود را داشته باشید -- برای مثال، پروژه‌ای که علاقه دارید در آن مشارکت کنید -- دستوری که به آن احتیاج دارید `git clone` است.
61+
اگر کمی با دیگر نرم‌افزارهای کنترل نسخه مانند ساب‌ورژن آشنا باشید، متوجه‌ خواهید شد که فعل این دستور `clone` است، نه `checkout`.
62+
این یک تفاوت خیلی مهم است -- به جای اینکه یک نسخه کپی از پروژه به دست آورید، گیت به طور مستقیم یک نسخه کامل از تمامی داده‌هایی که در سرور وجود دارد را تحویل می‌گیرد.
6663
به صورت پیش‌فرض با اجرای دستور `git clone` هر نسخه‌ای از هر فایلی که در تاریخچهٔ پروژه است توسط گیت آورده می‌شود.
67-
در حقیقت اگر احیاناً دیسک سرور شما دچار مشکل گردد و اطلاعات از دست روند اکثراً شما این می‌توانید به طور مستقیم از هر کلون دیگری
68-
روی هر کلاینت دیگری استفاده کنید تا اطلاعات سرور را به همان حالتی که به هنگام کلون کردن بود بازگردد.
64+
در حقیقت اگر احیاناً دیسک سرور شما دچار مشکل گردد و اطلاعات از دست روند غالباً می‌توانید به طور مستقیم از هر کلون دیگری
65+
روی هر کلاینت دیگری استفاده کنید تا اطلاعات سرور را به همان حالتی که به هنگام کلون کردن بود بازگردانید.
6966
(ممکن است بعضی از هوک‌های سرور و این قبیل اطلاعات از دست بروند اما تمام نسخه‌های کنترل شده خواهند ماند -- برای جزئیات بیشتر <<ch04-git-on-the-server#_getting_git_on_a_server>> را مطالعه کنید.)
7067

71-
با دستور (((git commands, clone))) `git clone (url)` یک مخزن را کلون می‌کنید.
72-
برای مثال، اگر بخواهید یک کتاب‌خانه گیت قابل لینک به نام `libgit2` را کلون کنید، می‌توانید با این روش انجام دهید:
68+
با دستور `git clone <url>` یک مخزن را کلون می‌کنید.(((git commands, clone)))
69+
برای مثال، اگر بخواهید یک کتاب‌خانه گیت قابل لینک به نام `libgit2` را کلون کنید، می‌توانید اینگونه انجام دهید:
7370

7471
[source,console]
7572
----
7673
$ git clone https://github.com/libgit2/libgit2
7774
----
7875

79-
با اجرای خط بالا در مرحلهٔ اول یک پوشه به نام `libgit2` ساخته می‌شود، در پوشه `libgit2` یک پوشه جدید به نام `.git` ساخته
76+
با اجرای خط بالا در مرحلهٔ اول یک پوشه به نام `libgit2` ساخته می‌شود، در پوشه `libgit2` یک پوشه جدید به نام `.git` ساخته شده
8077
و مخزن گیت راه‌اندازی ‌می‌شود، تمام اطلاعات از مخزن اصلی دریافت می‌شوند و ما را به اخرین نسخه از پروژه چک‌اوت می‌کند.
8178
اگر وارد پوشه جدید `libgit2` شوید، ‌خواهید دید که فایل‌های پروژه حاضر و آماده استفاده هستند.
8279

83-
اگر بخواهید مخزن مورد نظر را در پوشه‌ای با نام دلخواه خودتان (بجای libgit2) کلون کنید، می‌توانید نام پوشه دلخواه را مانند دستور پایین به عنوان آرگومان اضافه مشخص کنید.
80+
اگر بخواهید مخزن مورد نظر را در پوشه‌ای با نام دلخواه خودتان (بجای libgit2) کلون کنید، می‌توانید نام پوشه دلخواه را مانند دستور پایین به عنوان آرگومان اضافه مشخص کنید:
8481

8582
[source,console]
8683
----
@@ -90,7 +87,5 @@ $ git clone https://github.com/libgit2/libgit2 mylibgit
9087
دستور بالا همان مراحل قبل را انجام می‌دهد، با این تفاوت که نام پوشه‌ای که ساخته می‌شود `mylibgit` خواهد بود.
9188

9289
گیت دارای تعداد زیادی پروتکل‌های انتقال است که شما می‌توانید از آن‌ها استفاده کنید.
93-
در مثال قبل از پروتکل `//:https` استفاده شد، اما شاید شما `//:git` یا `user@server:path/to/repo.git` نیز دیده باشید،
94-
که از پروتکل SSH استفاده می‌کند.
95-
در <<ch04-git-on-the-server#_getting_git_on_a_server>> تمام گزینه‌های موجود برای را دسترسی به مخزن گیت را معرفی خواهد کرد و درباره مضرات و فواید هر کدام
96-
توضیح خواهد داد.
90+
در مثال قبل از پروتکل `https://` استفاده شد، اما شاید `git://` یا `user@server:path/to/repo.git` را نیز دیده باشید، که از پروتکل SSH استفاده می‌کند.
91+
<<ch04-git-on-the-server#_getting_git_on_a_server>> تمام گزینه‌های موجود برای را دسترسی به مخزن گیت را معرفی خواهد کرد و درباره مضرات و فواید هر کدام توضیح خواهد داد.

0 commit comments

Comments
 (0)