From 65cfa541bd60a88f0e70badcb6a4e43f9ef15d1f Mon Sep 17 00:00:00 2001 From: Sayyid Ayoub Kokabi Date: Sun, 10 Dec 2017 16:17:53 +0330 Subject: [PATCH 01/17] Persian translation --- index.fa.html | 269 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 269 insertions(+) create mode 100644 index.fa.html diff --git a/index.fa.html b/index.fa.html new file mode 100644 index 00000000..920411a6 --- /dev/null +++ b/index.fa.html @@ -0,0 +1,269 @@ + + + + + + راهنمای ساده گیت | git + + + + + + +
+

راهنمای ساده git (به فارسی: گیت)

+

صرفا یک راهنمای ساده و ابتدایی برای شروع کار با گیت

+ + +

+ تهیه شده توسط Roger Dudler +
با سپاس از @tfnico, @fhd و Namics
+ این راهنما در سایر زبان‌ها: + english, + deutsch, + español, + français, + indonesian, + italiano, + nederlands, + polski, + português, + русский, + türkçe, +
+ မြန်မာ, + 日本語, + 中文, + 한국어 + Vietnamese +
+ لطفا مشکلات را در گیت‌هاب گزارش دهید. +

+ + +
+ + +
+

پیکربندی

+

+ دانلود گیت برای مک +

+

+ دانلود گیت برای ویندوز +

+

+ دانلود گیت برای لینوکس +

+
+ +
+

ساخت یک مخزن یا repository جدید

+

+ یک فولدر جدید ساخته و آن را باز کنید. سپس با اجرای این دستور مخزن جدیدی ایجاد نمایید.
+ git init
+

+
+ +
+

Checkout کردن مخزن

+

+ جهت ساخت یک کپی کاری از مخزن محلی، این دستور را اجرا نمایید:
+ git clone /path/to/repository
+ و برای سرور راه دور این یکی:
+ git clone username@host:/path/to/repository +

+
+ +
+

گردش کار

+

+ مخزن محلی شما از سه درخت تحت کنترل گیت تشکیل شده: + اولی فولدر کاری شماست که فایلهای واقعی را نگهداری می‌کند. + دومی ایندکس که در حکم منطقه استیج یا شروع عملیات بوده و نهایتا + هد (HEAD) که به آخرین commit‌ای که ساخته‌اید اشاره دارد. +

+ +
+ +
+

افزودن و تصدیق (commit)

+

+ به منظور پیشنهاد تغییرات (یا اضافه نمودن آن به ایندکس) از دستور پایین استفاده کنید
+ git add <filename>
+ git add *
+ این اولین گام در گردش کاراست. برای Commit کردن واقعی تغییرات از این دستور استفاده کنید
+ git commit -m "Commit message"
+ اکنون فایل مورد نظر به HEAD اضافه شده ولی هنوز به مخزن راه دور (روی سرور) ارسال نشده است. +

+
+ +
+

فرستادن یا Push کردن تغییرات

+

+ تغییرات شما اکنون بر روی HEAD واقع در کپی کاریِ محلی شما قرار دارد. جهت ارسال این تغییرات به مخزن راه دور دستور زیر را اجرا کنید
+ git push origin master
+ به جای master هر انشعاب یا شاخه‌ای که قصد ارسال تغییرات روی آن دارید را وارد کنید. +

+ اگر هنوز مخزن موجود را clone نکرده و قصد اتصال آن به سرور راه دور را دارید از این دستور استفاده کنید
+ git remote add origin <server>
+ اکنون می‌توانید تغییرات صورت گرفته را به ریموت سرور Push کنید.
+ +

+
+ +
+

branching - کار با شاخه‌ها

+

+ شاخه‌ها به منظور توسعه ایزوله و جداگانه فیچرهای برنامه استفاده می‌شوند. شاخه master شاخه پیش‌فرض هنگام ساخت مخزن کد است. برای توسعه کد از سایر شاخه‌ها استفاده کنید و در پایان کار آن‌ها را با شاخه اصلی یا master ادغام نمایید. +

+ +

+ یک شاخه جدید با نام «feature_x» بسازید و با دستور زیر به آن سوییچ کنید
+ git checkout -b feature_x
+ به شاخه master بازگردید
+ git checkout master
+ و شاخه قبلی را حذف کنید
+ git branch -d feature_x
+ شاخه در دسترس دیگران نیست مگر آن را بر روی سرور پوش کرده باشید.
+ git push origin <branch> +

+
+ +
+

به‌روزرسانی (update) و ادغام (merge)

+

+ برای به‌روزکردن مخزن محلی به جدیدترین commit این فرمان را در فولدر کاری اجرا کنید
+ git pull
+ تا تغییرات راه دور دریافت یا fetch و ادغام شوند.
+ برای ادغام سایر شاخه‌ها داخل شاخه فعالتان (مثلا master) از دستور پایین استفاده کنید
+ git merge <branch>
+ در هر دو حالت گیت تلاش می‌کند تا تغییرات را به صورت خودکار ادغام کند. متاسفانه این کار همیشه مقدور نیست و گاهی اوقات منجر به تداخل می‌شود. + در این شرایط خودتان مسئول ویرایش فایل‌های گزارش شده، رفعاختلال‌ها + و ادغام آن هستید.
+ git add <filename>
+ قبل از ادغام تغییرات با این دستور می‌توانید پیش‌نمایش آن را مشاهده نمایید
+ git diff <source_branch> <target_branch> +

+
+ +
+

برچسب‌گذاری یا tagging

+

+ پیشنهاد می‌شود برای هر نسخه از برنامه یک تگ یا برچسب تعیین کنید. این یک مفهوم شناخته شده است که در سورس‌کنترل‌های دیگری مثل ساب‌ورژن هم وجود دارد. شما می‌توانید برچسبی تحت عنوان 1.0.0 را با دستور زیر ایجاد کنید
+ git tag 1.0.0 1b2e1d63ff
+ عبارت 1b2e1d63ff بیانگر 10 کاراکتر اول شناسه یا id آن Commit ای است که می‌خواهید برچسب‌گذاری کنید. برای به دست آوردن این آی‌دی از دستور log که در ادامه معرفی خواهیم کرد استفاده می‌شود.
+

+
+ +
+

گزارش وقایع یا Log

+

+ در ساده‌ترین شکل، تاریخچه مخزن را با استفاده از دستور + git log مشاهده کنید.
+ شما می‌توانید تعداد زیادی پارامتر جهت ساخت گزارش یا لاگ مطابق میل خود اضافه کنید. برای مشاهده Commit های متعلق به فرد خاصی از این دستور استفاده نمایید
+ git log --author=bob
+ برای دیدن نسخه فشرده لاگ طوری که هر Commit تنها در یک خط نمایش داده شود از این دستور استفاده کنید
+ git log --pretty=oneline
+ و یا شاید دوست داشته باشید همه شاخه‌ها را به صورت درخت‌واره اسکی شامل عنوان برچسب‌ها و شاخه‌ها مشاهده کنید
+ git log --graph --oneline --decorate --all
+ تنها فایل‌هایی که تغییر کرده‌اند را ببینید
+ git log --name-status
+ این‌ها تنها بخشی کوچکی از پارامترهای قابل استفاده است. برای اطلاعات بیشتر از این دستور استفاده کنید + git log --help
+

+
+ +
+

بازیابی تغییرات محلی

+

+ در صورتی که اشتباهی انجام دادید و قصد بازگردانی کد را داشتید، این دستور را وارد کنید:
+ git checkout -- <filename>
+ این دستور تغییرات working tree را با آخرین محتوای موجود در Head جایگزین می‌کند. البته تغییراتی که پیش از این به ایندکس اضافه شده‌ا‌ند و همچنین فایل‌های جدید، پابرجا خواهند بود. +

+

+ به جای این کار اگر قصد داشته باشید همه commitها و تغییرات محلی‌تان را حذف کنید، آخرین تاریخچه را از سرور دریافت کرده و شاخه master خود را به آن اشاره دهید:
+ git fetch origin
+ git reset --hard origin/master +

+
+ +
+

نکات مفید

+

+ رابط گرافیکی git
+ gitk
+ خروجی git را به صورت رنگی مشاهده کنید
+ git config color.ui true
+ نمایش یک خط به ازای هر Commit در لاگ
+ git config format.pretty oneline
+ فرمان add را به صورت تعاملی تجربه کنید.
+ git add -i +

+
+ +
+

لینک‌ها و منابع

+

کلاینت‌های گرافیکی

+

+

+

+

راهنماها

+

+

+

+

دریافت کمک

+

+

+

+
+ +
+

دیدگاه‌ها

+
+ + +
+ + + + From ef1a9ca0f888106375cfbb7bcd8fa44f80c7aa04 Mon Sep 17 00:00:00 2001 From: Sayyid Ayoub Kokabi Date: Sun, 10 Dec 2017 16:24:48 +0330 Subject: [PATCH 02/17] Persian translation was added. --- index.html | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index 5a2f2db1..037a187e 100644 --- a/index.html +++ b/index.html @@ -48,8 +48,9 @@

git - the simple guide

မြန်မာ, 日本語, 中文, - 한국어 - Vietnamese + 한국어, + Vietnamese, + فارسی
please report issues on github

From e456d66f65b8e6030ef63a950b3b1155885f1b0d Mon Sep 17 00:00:00 2001 From: Sayyid Ayoub Kokabi Date: Sat, 16 Dec 2017 09:07:24 +0330 Subject: [PATCH 03/17] Update index.de.html --- index.de.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/index.de.html b/index.de.html index b3f9acba..c6364138 100644 --- a/index.de.html +++ b/index.de.html @@ -47,7 +47,8 @@

git - Der einfache Einstieg

မြန်မာ, 日本語, 中文, - 한국어 + 한국어, + فارسی
日本語, 中文, 한국어
Feedback auf github From 4f7d945828571e3ca104f682829cba4cd4d1ea06 Mon Sep 17 00:00:00 2001 From: Sayyid Ayoub Kokabi Date: Sat, 16 Dec 2017 09:08:29 +0330 Subject: [PATCH 04/17] Update index.es.html --- index.es.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/index.es.html b/index.es.html index d3f78ce9..68434159 100644 --- a/index.es.html +++ b/index.es.html @@ -43,7 +43,8 @@

git - la guía sencilla

မြန်မာ, 日本語, 中文, - 한국어 + 한국어, + فارسی
por favor, reporta cualquier problema en github

From 0d6fe94a507f3b867376c1003206259ec436feda Mon Sep 17 00:00:00 2001 From: Sayyid Ayoub Kokabi Date: Sat, 16 Dec 2017 09:09:19 +0330 Subject: [PATCH 05/17] Update index.fr.html --- index.fr.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/index.fr.html b/index.fr.html index 975c48d8..3198da07 100644 --- a/index.fr.html +++ b/index.fr.html @@ -58,7 +58,8 @@

git - petit guide

မြန်မာ, 日本語, 中文, - 한국어 + 한국어, + فارسی

From b34e74703ccc284e9f860516da2d87c58151729f Mon Sep 17 00:00:00 2001 From: Sayyid Ayoub Kokabi Date: Sat, 16 Dec 2017 09:10:05 +0330 Subject: [PATCH 06/17] Update index.id.html --- index.id.html | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/index.id.html b/index.id.html index 5ed57bc1..5578ee7e 100644 --- a/index.id.html +++ b/index.id.html @@ -47,8 +47,9 @@

git - panduan ringkas

မြန်မာ, 日本語, 中文, - 한국어 - Vietnamese + 한국어, + Vietnamese, + فارسی
silahkan laporkan permasalan ke github

From 69f2d1ae0515b6f1bf09c18cde6d7eece6f731d8 Mon Sep 17 00:00:00 2001 From: Sayyid Ayoub Kokabi Date: Sat, 16 Dec 2017 09:11:05 +0330 Subject: [PATCH 07/17] Update index.it.html --- index.it.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/index.it.html b/index.it.html index 8cd320e3..eaa526ae 100644 --- a/index.it.html +++ b/index.it.html @@ -47,7 +47,8 @@

git - la guida tascabile

မြန်မာ, 日本語, 中文, - 한국어 + 한국어, + فارسی

From b39110bbdbd3eceb21727bc359b17afe8d059686 Mon Sep 17 00:00:00 2001 From: Sayyid Ayoub Kokabi Date: Sat, 16 Dec 2017 09:11:34 +0330 Subject: [PATCH 08/17] Update index.ja.html --- index.ja.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/index.ja.html b/index.ja.html index 30dd7f4c..084618d9 100644 --- a/index.ja.html +++ b/index.ja.html @@ -43,7 +43,8 @@

git - 簡単ガイド


မြန်မာ, 中文, - 한국어 + 한국어, + فارسی
問題などの報告はgithubでお願いします。

From f8228b8eefa6d92a1f9e00d5c4c65589eb16f34b Mon Sep 17 00:00:00 2001 From: Sayyid Ayoub Kokabi Date: Sat, 16 Dec 2017 09:11:57 +0330 Subject: [PATCH 09/17] Update index.ko.html --- index.ko.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/index.ko.html b/index.ko.html index 062a77f1..223756e5 100644 --- a/index.ko.html +++ b/index.ko.html @@ -104,7 +104,8 @@

git - 간편 안내서

Português, Русский, Türkçe, - 中文
+ 中文
, + فارسی

자, 갑시다! From 2d5e34fecd9d632b9509805134485589a0392f7c Mon Sep 17 00:00:00 2001 From: Sayyid Ayoub Kokabi Date: Sat, 16 Dec 2017 09:12:31 +0330 Subject: [PATCH 10/17] Update index.my.html --- index.my.html | 1 + 1 file changed, 1 insertion(+) diff --git a/index.my.html b/index.my.html index 52ecc656..e4bf974d 100644 --- a/index.my.html +++ b/index.my.html @@ -63,6 +63,7 @@

git - အရိုးအရှင်းဆုံး လမ်းညွှန မြန်မာ, 日本語, 中文, + فارسی, 한국어 တို့ဖြင့် ဖတ်နိုင်သည်။
From 3378efb357e1dfd6083df56a6cd9ff64a7850757 Mon Sep 17 00:00:00 2001 From: Sayyid Ayoub Kokabi Date: Sat, 16 Dec 2017 09:12:51 +0330 Subject: [PATCH 11/17] Update index.nl.html --- index.nl.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/index.nl.html b/index.nl.html index 9a818dc9..7bf07f77 100644 --- a/index.nl.html +++ b/index.nl.html @@ -48,7 +48,8 @@

git - een simpele uitleg

မြန်မာ, 日本語, 中文, - 한국어 + 한국어, + فارسی
opmerkingen en aanpassingen op github

From f50dcfc579fdee1bea4b51b29756cc831c960de2 Mon Sep 17 00:00:00 2001 From: Sayyid Ayoub Kokabi Date: Sat, 16 Dec 2017 09:13:20 +0330 Subject: [PATCH 12/17] Update index.pl.html --- index.pl.html | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/index.pl.html b/index.pl.html index d69f0a75..feb1238e 100644 --- a/index.pl.html +++ b/index.pl.html @@ -47,8 +47,9 @@

git - prosty przewodnik

မြန်မာ, 日本語, 中文, - 한국어 - Vietnamese + 한국어, + Vietnamese, + فارسی
please report issues on github

From b59e59d900db6be039b4be53df7afa60279ca81a Mon Sep 17 00:00:00 2001 From: Sayyid Ayoub Kokabi Date: Sat, 16 Dec 2017 09:13:35 +0330 Subject: [PATCH 13/17] Update index.pt_BR.html --- index.pt_BR.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/index.pt_BR.html b/index.pt_BR.html index a421b0dd..644b9907 100644 --- a/index.pt_BR.html +++ b/index.pt_BR.html @@ -48,7 +48,8 @@

git - guia prático

မြန်မာ, 日本語, 中文, - 한국어 + 한국어, + فارسی
por favor informe problemas em github

From bff00c03755881fef8052ec28ba5af2dbfba9e3b Mon Sep 17 00:00:00 2001 From: Sayyid Ayoub Kokabi Date: Sat, 16 Dec 2017 09:13:51 +0330 Subject: [PATCH 14/17] Update index.ru.html --- index.ru.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/index.ru.html b/index.ru.html index 545b1977..11a68c20 100644 --- a/index.ru.html +++ b/index.ru.html @@ -48,7 +48,8 @@

git - the simple guide

မြန်မာ, 日本語, 中文, - 한국어 + 한국어, + فارسی
об ошибках сообщайте на github

From b69a7f3a8e6131f6074ff395c638ad5eb2e1bc08 Mon Sep 17 00:00:00 2001 From: Sayyid Ayoub Kokabi Date: Sat, 16 Dec 2017 09:14:13 +0330 Subject: [PATCH 15/17] Update index.tr.html --- index.tr.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/index.tr.html b/index.tr.html index 436a7a44..28afd518 100644 --- a/index.tr.html +++ b/index.tr.html @@ -48,7 +48,8 @@

git - basit rehber

မြန်မာ, 日本語, 中文, - 한국어 + 한국어, + فارسی
please report issues on github

From caa41c7d392d470a0052b847c46d3d2f8a8a66d5 Mon Sep 17 00:00:00 2001 From: Sayyid Ayoub Kokabi Date: Sat, 16 Dec 2017 09:14:35 +0330 Subject: [PATCH 16/17] Update index.vi.html --- index.vi.html | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/index.vi.html b/index.vi.html index 498b9ed9..48cd5426 100644 --- a/index.vi.html +++ b/index.vi.html @@ -48,8 +48,9 @@

Sổ tay Git

မြန်မာ, 日本語, 中文, - 한국어 - Vietnamese + 한국어, + Vietnamese, + فارسی
vui lòng báo cáo vấn đề trên github

From c18066c9f62aac23fa21c00d855e0c6949d1a31e Mon Sep 17 00:00:00 2001 From: Sayyid Ayoub Kokabi Date: Sat, 16 Dec 2017 09:14:57 +0330 Subject: [PATCH 17/17] Update index.zh.html --- index.zh.html | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/index.zh.html b/index.zh.html index 00f5b3c8..9460959c 100644 --- a/index.zh.html +++ b/index.zh.html @@ -48,8 +48,9 @@

git - 简明指南


မြန်မာ, 日本語, - 한국어 - Vietnamese + 한국어, + Vietnamese, + فارسی
如有纰漏，请在 github 提报问题