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 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

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 (به فارسی: گیت)

+

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

+ Tweet + +

+ تهیه شده توسط 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 +

+
+ +
+

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

+

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

+

+

+

+

راهنماها

+

+

+

+

دریافت کمک

+

+

+

+
+ +
+

دیدگاه‌ها

+
+ + +
+ + + + 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

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

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

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

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

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

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でお願いします。

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, - 中文
+ 中文
, + فارسی

자, 갑시다! 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 - အရိုးအရှင်းဆုံး လမ်းညွှန မြန်မာ, 日本語, 中文, + فارسی, 한국어 တို့ဖြင့် ဖတ်နိုင်သည်။
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

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

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

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

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

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

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 提报问题