git - راهنمای ساده
+یک راهنمای ساده برای شروع کار با گیت. بدون مزخرفات عمیق ;)
+ Tweet + + + +
+
+ یک پوشه جدید بسازید، واردش شوید و دستور
+ git init
+ را اجرا کنید تا یک مخزن جدید گیت بسازید.
+
+ با اجرای دستور زیر یک کپی از مخزن محلی ایجاد کنید
+ git clone /path/to/repository
+ وقتی به یک سرور دیگر وصل می‌شوید، دستور شما اینطوری خواهد بود
+ git clone username@host:/path/to/repository
+
+ مخزن محلی شما از سه «درخت» که توسط git نگهداری می‌شود تشکیل شده است.
+ اولی Working Directory شماست که فایل‌های واقعی را نگه می‌دارد.
+ دومی Index است که نقش منطقه شروع عملیات را دارد
+ در نهایت HEAD را داریم که به آخرین ارسال (commit) شما اشاره می‌کند.
+
+
+ می‌توانید با دستور زیر تغییرات (افزودن فایل‌ها به index) را مطرح کنید
+ git add <filename>
+ git add *
+ این اولین قدم در گردش کار ساده git است. برای ارسال واقعی این تغییرات از دستور زیر استفاده کنید
+ git commit -m "Commit message"
+ حالا فایل برای HEAD، ارسال شده اما هنوز به سرور ریموت شما فرستاده نشده است.
+
+ تغییرات شما الان در HEAD مخزن محلی شما هستند. برای ارسال آن‌ها به سرور ریموت دستور زیر را اجرا کنید
+ git push origin master
+ عبارت master را با اسم هر شاخه (branch) که می‌خواهید تغییراتش را ارسال کنید عوض کنید.
+
+ اگر یک مخزن محلی را کپی (clone) نکردید و می‌خواهید مخزن محلی را خود را به سرور ریموت متصل کنید، باید از دستور زیر استفاده کنید
+ git remote add origin <server>
+ حالا قادر هستید تغییرات را به سرور ریموت انتخاب شده ارسال کنید
+
+
+ شاخه‌ها برای توسعه‌دادن نرم‌افزار و افزودن امکانات به صورت مجزا و ایزوله شده از هم، به کار می‌روند. وقتی یک مخزن می‌سازید master شاخه «پیش فرض» (default) آن مخزن است. شاخه‌های دیگر را برای توسعه و کدنویسی استفاده کنید و بعد از تکمیل شدن، آن‌ها را با master ادغام کنید. +
+
+
+ با استفاده از دستور زیر یک شاخه به نام "feature_x" بسازید به آن سوئیچ کنید
+ git checkout -b feature_x
+ بازگشت به شاخه master
+ git checkout master
+ و حذف شاخه
+ git branch -d feature_x
+ تا زمانی که یک شاخه را به سرور ارسال (push) نکنید برای دیگران در دسترس نیست
+ git push origin <branch>
+
+ برای اینکه مخزن محلی خود را با آخرین کامیت بروز کنید، دستور
+ git pull
+ را در پوشه محلی اجرا کنید تا تغییرات سرور ریموت،
دریافت (fetch) و ادغام (merge) شوند.
+ برای ادغام یک شاخه (branch) دیگر بر روی شاخه فعال
+
+ (مثلاً master)، از دستور زیر استفاده کنید
+ git merge <branch>
+ در هر دو حالت، گیت تلاش می‌کند تا تغییرات را به صورت اتوماتیک ادغام کنید. متاسفانه، ادغام اتوماتیک همیشه ممکن نیست و منجر به تداخل (conflict) می‌شود.
+ شما مسئول ادغام دستی تداخل‌ها
+ با ویرایش فایل‌های تداخل‌دار که توسط گیت نشان داده می‌شوند هستید. بعد از ویرایش، لازم است آن‌ها را با دستور زیر به عنوان «ادغام شده» علامت بزنید
+ git add <filename>
+ قبل از ادغام تغییرات می‌توانید پیش‌نمایشی از آن‌ها را با دستور زیر ببینید
+ git diff <source_branch> <target_branch>
+
+ ایجاد برچسب، برای عرضه نرم‌افزار توصیه می‌شود.
این روالی شناخته شده است که در SVN هم وجود دارد.
+
+ می‌توانید برچسبی به نام 1.0.0 را با اجرای دستور زیر بسازید
+ git tag 1.0.0 1b2e1d63ff
+ عبارت 1b2e1d63ff اولین ده کاراکتر شناسه کامیتی است که می‌خواهید برچسب‌گذاری کنید. می‌توانید شناسه کامیت را با گشتن در لاگ‌ها پیدا کنید...
+
+ در ساده‌ترین حالت، تاریخچه مخزن را با دستور زیر می‌توانید مطالعه کنید..
+ git log
+ می‌توانید کلی پارامتر به این دستور اضافه کنید تا شبیه آن چیزی که می‌خواهید بشود. برای دیدن کامیت‌های یک شخص خاص:
+ git log --author=bob
+ برای دیدن نسخه فشرده کامیت‌ها که هر کامیت تنها یک خط دارد:
+ git log --pretty=oneline
+ یا شاید بخواهید درخت اسکی (ASCII) همه شاخه‌ها را که با نام شاخه و برچسب تزئین شده را ببینید:
+ git log --graph --oneline --decorate --all
+ فقط دیدن اینکه چه فایل‌هایی تغییر کرده:
+ git log --name-status
+ این‌ها فقط بعضی از پارامترهایی هستند که می‌توانید استفاده کنید، برای اطلاعات بیشتر این دستور را ببینید
+ git log --help
+
+ اگر کار اشتباهی انجام دادید، که عمراً برای شما اتفاق نمی‌افتد ;)، می‌توانید تغییرات محلی را با دستور زیر جایگزین کنید
+ git checkout -- <filename>
+ این تغییرات را با آخرین محتوای HEAD جایگزین می‌کند. تغییراتی که به index فرستاده شدند به همراه فایل‌های جدید نگه داشته می‌شوند.
+
+ اگر می‌خواهید همه تغییرات محلی را دور بریزید و بعد کامیت کنید، آخرین تاریخچه را از سرور بگیرید و با دستورات زیر کاری کنید که شاخه master شما به آخرین تغییرات دریافتی از سرور اشاره کنید
+
+ git fetch origin
+ git reset --hard origin/master
+
+ رابط کاربری توکار git
+ gitk
+ خروجی رنگ git
+ git config color.ui true
+ نمایش لاگ در یک خط برای هر کامیت
+ git config format.pretty oneline
+ افزودن تعاملی
+ git add -i
+
+
+
+ ++
+ +
diff --git a/index.es.html b/index.es.html
index d3f78ce9..64e8760b 100644
--- a/index.es.html
+++ b/index.es.html
@@ -31,10 +31,10 @@
diff --git a/index.html b/index.html
index 5a2f2db1..b5a6eff3 100644
--- a/index.html
+++ b/index.html
@@ -34,12 +34,12 @@
diff --git a/index.ja.html b/index.ja.html
index 30dd7f4c..3fa9e37d 100644
--- a/index.ja.html
+++ b/index.ja.html
@@ -35,15 +35,17 @@
diff --git a/index.my.html b/index.my.html
index 52ecc656..48546d6b 100644
--- a/index.my.html
+++ b/index.my.html
@@ -63,7 +63,9 @@ یک راهنمای ساده برای شروع کار با گیت. بدون مزخرفات عمیق ;)
- Tweet + Tweet
توسط Roger Dudler
From 76cc19dd7632d52307fe946ff30d89a5e0174f1a Mon Sep 17 00:00:00 2001
From: kokabi1365 یک راهنمای ساده برای شروع کار با گیت. بدون مزخرفات عمیق ;) مقدمه‌ای برای شروع کار با گیت
- یک پوشه جدید بسازید، واردش شوید و دستور
- با اجرای دستور زیر یک کپی از مخزن محلی ایجاد کنید
- مخزن محلی شما از سه «درخت» که توسط git نگهداری می‌شود تشکیل شده است.
- اولی
- می‌توانید با دستور زیر تغییرات (افزودن فایل‌ها به index) را مطرح کنید
- تغییرات شما الان در HEAD مخزن محلی شما هستند. برای ارسال آن‌ها به سرور ریموت دستور زیر را اجرا کنید
- شاخه‌ها برای توسعه‌دادن نرم‌افزار و افزودن امکانات به صورت مجزا و ایزوله شده از هم، به کار می‌روند. وقتی یک مخزن می‌سازید، شاخه «پیش فرض» (default) آن مخزن، master است. شاخه‌های دیگر را برای توسعه و کدنویسی استفاده کنید و بعد از تکمیل شدن، آن‌ها را با master ادغام کنید.
+ شاخه‌ها برای افزودن فیچرهای جدید در مسیری مجزا به کار می‌روند. هنگام ساخت یک مخزن جدید، شاخۀ مستر به عنوان شاخۀ پیش‌فرض در نظر گرفته می‌شود. هر شاخه به صورت مجزا توسعه می‌یابد و بعد از اتمام کار با شاخۀ مستر ترکیب می‌شود.
- با استفاده از دستور زیر یک شاخه به نام "feature_x" بسازید به آن سوئیچ کنید
برای اینکه مخزن محلی خود را با آخرین کامیت بروز کنید، دستور
- ایجاد برچسب، برای عرضه نرم‌افزار توصیه می‌شود.
- در ساده‌ترین حالت، تاریخچه مخزن را با دستور زیر می‌توانید مطالعه کنید:
- اگر کار اشتباهی انجام دادید، که عمراً برای شما اتفاق نمی‌افتد ;)، می‌توانید تغییرات محلی را با دستور زیر جایگزین کنید
- اگر می‌خواهید همه تغییرات محلی را دور بریزید و بعد کامیت کنید، آخرین تاریخچه را از سرور بگیرید و با دستورات زیر کاری کنید که شاخه master شما به آخرین تغییرات دریافتی از سرور اشاره کند
+ اگر می‌خواهید همه تغییرات محلی را حذف و بعد کامیت کنید، آخرین تاریخچه را از سرور دریافت و با دستور ریست (با پرچم hard--) شاخه مسترِ را به آخرین تغییرات دریافتی از سرور اشاره دهید.
- رابط کاربری توکار git
- پوشۀ جدیدی بسازید؛ واردش شوید و دستور
با اجرای دستور زیر می‌توانید یک نسخۀ کپی از مخزن محلی ایجاد کنید
- مخزن محلی شامل سه «درخت» است که توسط git نگهداری می‌شود:
- اولی
- برای ارسال تغییرات به سرورِ ریموت دستور زیر را اجرا کنید
- با دستور زیر شاخه‌ای به نام "feature_x" ساخته شده و به آن سوئیچ می‌شود
- برای اینکه مخزن محلی خود را با آخرین کامیت بروز کنید، دستور
معمولاً به هر نسخه از برنامه، شماره‌ای اختصاص می‌دهند که در گیت به آن تگ گفته می‌شود. این موضوع در سایر سیستم‌های کنترل نسخه مانند ساب‌ورژن (SVN) نیز وجود دارد.
در ساده‌ترین حالت، تاریخچه مخزن با دستور زیر نمایش داده می‌شود:
- در صورتی که مرتکب اشتباهی شدید، تغییرات محلی را می‌توانید با دستور پایین جایگزین کنید
- اگر می‌خواهید همه تغییرات محلی را حذف و بعد کامیت کنید، آخرین تاریخچه را از سرور دریافت و با دستور ریست (با پرچم hard--) شاخه مسترِ را به آخرین تغییرات دریافتی از سرور اشاره دهید.
+ اگر می‌خواهید همه تغییرات محلی را حذف و بعد کامیت کنید، آخرین تاریخچه را از سرور دریافت و با دستور ریست (با پرچم hard--) شاخه مستر را به آخرین تغییرات دریافتی از سرور اشاره دهید.
- رابط گرافیکی گیت git
- git für Windows herunterladen
+ git für Windows herunterladen
just a simple guide for getting started with git. no deep shit ;)
+ create a new directory, open it and perform a
+ create a working copy of a local repository by running the command
+ your local repository consists of three "trees" maintained by git.
+ the first one is your
+ You can propose changes (add it to the Index) using
+ Your changes are now in the HEAD of your local working copy. To send those changes to your remote repository, execute
+ Branches are used to develop features isolated from each other. The master branch is the "default" branch when you create a repository. Use other branches for development and merge them back to the master branch upon completion.
+
+ create a new branch named "feature_x" and switch to it using
+ to update your local repository to the newest commit, execute
+ it's recommended to create tags for software releases. this is a known concept, which also exists in SVN. You can create a new tag named 1.0.0 by executing
+ in its simplest form, you can study repository history using..
+
+ In case you did something wrong, which for sure never happens ;), you can replace local changes using the command
+ If you instead want to drop all your local changes and commits, fetch the latest history from the server and point your local master branch at it like this
+ built-in git GUI
+
+
+
-
@@ -183,41 +179,41 @@ git - راهنمای ساده
- راهنمای سادۀ گیت (git)
+ git - راهنمای ساده
Vietnamese،
فارسی
- لطفاً مشکلات ترجمه فارسی را در گیت‌هاب گزارش کنید
+ لطفاً مشکلات ترجمه فارسی را در گیت‌هاب گزارش دهید
@@ -90,29 +90,29 @@ نصب
ساخت مخزن جدید
+ پوشۀ جدیدی بسازید؛ واردش شوید و دستور
git init
- را اجرا کنید تا یک مخزن جدید گیت بسازید.
+ را اجرا کنید تا یک مخزن جدید (Git Repository) ساخته شود.
-
تحویل گرفتن یک مخزن
+ دریافت مخزن (Checkout)
- git clone /path/to/repository
- وقتی به یک سرور دیگر وصل می‌شوید، دستور شما اینطور خواهد بود
+ با اجرای دستور زیر می‌توانید یک نسخۀ کپی از مخزن محلی ایجاد کنید
+ کپی یا کلون git clone /path/to/repository
+ برای کپی کردن مخزنی که در سرور قرار گرفته از دستور پایین استفاده کنید
git clone username@host:/path/to/repository
-
@@ -120,43 +120,43 @@ گردش کار
+ گردش کار (Workflow)
Working Directory شماست که فایل‌های واقعی را نگه می‌دارد.
- دومی Index است که نقش منطقه شروع عملیات را دارد
- در نهایت HEAD را داریم که به آخرین ارسال (commit) شما اشاره می‌کند.
+ مخزن محلی شامل سه «درخت» است که توسط git نگهداری می‌شود:
+ اولی Working Directory است که فایل‌های واقعی پروژه را نگهداری می‌کند؛
+ دومی ایندکس (Index) بوده که نقش منطقه شروع عملیات (Staging area) را بازی می‌کند؛
+ و آخری هِد (HEAD) است که به آخرین کامیتِ ارسالی (commit) اشاره می‌کند.
گردش کار
اضافه کردن و کامیت
+ می‌توانید با دستور زیر فایل‌ها را به ایندکس اضافه کنید:
git add <filename>
git add *
- این اولین قدم در گردش کار ساده git است. برای ارسال واقعی این تغییرات از دستور زیر استفاده کنید
+ این اولین قدمِ یک گردش کار ساده در گیت محسوب می‌شود. برای ارسال واقعی تغییرات از دستور پایین استفاده کنید
git commit -m "Commit message"
- حالا فایل برای HEAD، ارسال شده اما هنوز به سرور ریموت شما فرستاده نشده است.
+ اکنون فایل‌های مورد نظر در هِد قرار گرفته ولی هنوز به سرور ارسال نشده‌اند.
-
ارسال تغییرات
+ ارسال تغییرات (Push)
+ برای ارسال تغییرات به سرورِ ریموت دستور زیر را اجرا کنید
git push origin master
- عبارت master را با اسم هر شاخه (branch) که می‌خواهید تغییراتش را ارسال کنید عوض کنید.
+ به جای مَستر (master)، اسم شاخه‌ای (branch) را وارد کنید که می‌خواهید تغییراتش را ارسال کنید.
- اگر یک مخزن محلی را کپی (clone) نکردید و می‌خواهید مخزن محلی را خود را به سرور ریموت متصل کنید، باید از دستور زیر استفاده کنید
+ اگر هیچ مخزن محلی‌ای را کلون نکرده بودید می‌توانید با دستور پایین مخزن محلی‌تان را به مخزن ریموت متصل کنید
git remote add origin <server>
- حالا قادر هستید تغییرات را به سرور ریموت انتخاب شده ارسال کنید.
+ حالا می‌توانید تغییرات را به کمک ریموت ساخته شده به سرور ارسال نمایید.
-
@@ -166,16 +166,12 @@ شاخه‌بندی
+ شاخه‌بندی (Branching)
+ با دستور زیر شاخه‌ای به نام "feature_x" ساخته شده و به آن سوئیچ می‌شود
git checkout -b feature_x
بازگشت به شاخه master
git checkout master
- و حذف شاخه
+ حذف شاخه
git branch -d feature_x
- تا زمانی که یک شاخه را به سرور ارسال (push) نکنید برای دیگران در دسترس نیست
+ تا زمانی که شاخه‌ای را به سرور پوش نکنید، سایر افراد به آن دسترسی ندارند.
git push origin <branch>
بروزرسانی و ادغام
git pull
- را در پوشه محلی اجرا کنید تا تغییرات سرور ریموت،
دریافت (fetch) و ادغام (merge) شوند.
- برای ادغام یک شاخه (branch) دیگر بر روی شاخه فعال
-
- (مثلاً master)، از دستور زیر استفاده کنید
+ را در پوشه محلی (فولدر پروژه روی سیستم‌تان) اجرا کنید تا تغییرات مخزن ریموت (واقع روی سرور)،
دریافت (fetch) و ادغام (merge) شوند. برای ادغام یک شاخۀ دیگر با شاخۀ کنونی (مثلاً master)، از دستور زیر استفاده کنید:
git merge <branch>
- در هر دو حالت، گیت تلاش می‌کند تا تغییرات را به صورت اتوماتیک ادغام کند. متاسفانه، ادغام اتوماتیک همیشه ممکن نیست و منجر به تداخل (conflict) می‌شود.
- شما مسئول ادغام دستی تداخل‌ها
- با ویرایش فایل‌های تداخل‌دار که توسط گیت نشان داده می‌شوند هستید. بعد از ویرایش، لازم است آن‌ها را با دستور زیر به عنوان «ادغام شده» علامت بزنید
+ گیت در هر دو حالت تلاش می‌کند تغییرات را به صورت خودکار ادغام کند ولی این کار همیشه میسر نیست چون ممکن است منجر به تداخل (conflict) شود.
+ تداخل‌ها را باید خودتان به صورتی دستی برطرف نمایید و سپس عمل ادغام را انجام دهید. پس از ویرایش باید با دستور زیر، آن‌ها را به عنوان «ادغام شده» علامت بزنید
git add <filename>
- قبل از ادغام تغییرات می‌توانید پیش‌نمایشی از آن‌ها را با دستور زیر ببینید
+ قبل از ادغام تغییرات، پیش‌نمایش آن را می‌توانید با دستور زیر ببینید
git diff <source_branch> <target_branch>
بروزرسانی و ادغام
برچسب‌گذاری
این روالی شناخته شده است که در SVN هم وجود دارد.
+ معمولاً به هر نسخه از برنامه، شماره‌ای اختصاص می‌دهند که در گیت به آن تگ گفته می‌شود. این موضوع در سایر سیستم‌های کنترل نسخه مانند ساب‌ورژن (SVN) نیز وجود دارد.
- می‌توانید برچسبی به نام 1.0.0 را با اجرای دستور زیر بسازید
+ می‌توانید با دستور زیر برچسبی به نام 1.0.0 بسازید
git tag 1.0.0 1b2e1d63ff
- عبارت 1b2e1d63ff اولین ده کاراکتر شناسه کامیتی است که می‌خواهید برچسب‌گذاری کنید. می‌توانید شناسه کامیت را با گشتن در لاگ‌ها پیدا کنید...
+ عبارت 1b2e1d63ff، اولین ده کاراکتر شناسۀ (ID) کامیتی است که می‌خواهید برچسب‌گذاری کنید. می‌توانید شناسه کامیت را با جستجو در لاگ پیدا کنید...
لاگ
+ در ساده‌ترین حالت، تاریخچه مخزن با دستور زیر نمایش داده می‌شود:
git log
- می‌توانید کلی پارامتر به این دستور اضافه کنید تا شبیه آن چیزی که می‌خواهید بشود. برای دیدن کامیت‌های یک شخص خاص:
+ می‌توانید کلی پارامتر دیگر هم به این دستور اضافه کنید تا شبیه آن چیزی شود که می‌خواهید. دیدن کامیت‌های یک شخص خاص:
git log --author=bob
- برای دیدن نسخه فشرده کامیت‌ها که هر کامیت تنها یک خط دارد:
+ دیدن کامیت‌ها به صورت مختصر؛ هر کدام در یک خط:
git log --pretty=oneline
- یا شاید بخواهید درخت اسکی (ASCII) همه شاخه‌ها را که با نام شاخه و برچسب تزئین شده را ببینید:
+ یا شاید بخواهید درخت اسکی (ASCII) همه شاخه‌ها را که با نام شاخه و برچسب‌ها تزئین شده ببینید:
git log --graph --oneline --decorate --all
- فقط دیدن اینکه چه فایل‌هایی تغییر کرده:
+ فقط مشاهدۀ فایل‌های تغییر یافته:
git log --name-status
- این‌ها فقط بعضی از پارامترهایی هستند که می‌توانید استفاده کنید، برای اطلاعات بیشتر این دستور را ببینید
+ موارد بالا فقط گوشه‌ای از پارامترها بودند. برای اطلاعات بیشتر، دستور پایین را وارد کنید:
git log --help
-
@@ -219,30 +219,7 @@ جایگزینی تغییرات محلی
+ جایگزین کردن تغییرات محلی
+ در صورتی که مرتکب اشتباهی شدید، تغییرات محلی را می‌توانید با دستور پایین جایگزین کنید
git checkout -- <filename>
- این دستور، تغییرات را با آخرین محتوای HEAD جایگزین می‌کند. تغییراتی که به index فرستاده شدند به همراه فایل‌های جدید نگه داشته می‌شوند.
+ این دستور، تغییرات working directory (فولدر پروژه روی سیستم) را با آخرین محتوایی که هِد به آن اشاره می‌کند جایگزین می‌کند. البته فایل‌های جدید و تغییراتی که از قبل به ایندکس اضافه شده، دست نخورده باقی می‌مانند.
git fetch origin
git reset --hard origin/master
@@ -227,20 +223,20 @@ جایگزینی تغییرات محلی
نکات مفید
+ رابط گرافیکی گیت git
gitk
- خروجی رنگ git
+ نمایش خروجی دستورات به صورت رنگی
git config color.ui true
- نمایش لاگ در یک خط برای هر کامیت
+ نمایش مختصر لاگ، تنها یک کامیت در هر سطر
git config format.pretty oneline
- افزودن تعاملی
+ افزودن فایل‌ها به صورت تعاملی
git add -i
منابع و پیوندها
- کلاینت‌های با رابط کاربری
+ کلاینت‌های گرافیکی گیت
- کلاینت‌های با رابط کاربری
راهنماها
+ آموزشِ گیت
-
- دریافت کمک
+ درخواست کمک
نصب
@@ -109,10 +109,10 @@ ساخت مخزن جدید
+ پوشۀ جدیدی بسازید؛ واردش شوید و دستورِ
git init
را اجرا کنید تا یک مخزن جدید (Git Repository) ساخته شود.
ساخت مخزن جدید
دریافت مخزن (Checkout)
- کپی یا کلون git clone /path/to/repository
- برای کپی کردن مخزنی که در سرور قرار گرفته از دستور پایین استفاده کنید
+ کپی یا کلون: git clone /path/to/repository
+ برای کپیِ مخزنی که در سرور قرار گرفته دستور پایین را اجرا کنید:
git clone username@host:/path/to/repository
دریافت مخزن (Checkout)
@@ -123,20 +123,20 @@ گردش کار (Workflow)
Working Directory است که فایل‌های واقعی پروژه را نگهداری می‌کند؛
- دومی ایندکس (Index) بوده که نقش منطقه شروع عملیات (Staging area) را بازی می‌کند؛
- و آخری هِد (HEAD) است که به آخرین کامیتِ ارسالی (commit) اشاره می‌کند.
+ مخزن محلی شامل سه «درخت» است که توسط گیت نگهداری می‌شود:
+ اولی Working Directory است که مسئول نگهداری فایل‌های واقعی پروژه است؛
+ دومی ایندکس (Index) است که نقش منطقه شروع عملیات (Staging area) را بازی می‌کند؛
+ و آخری هِد (HEAD) که به آخرین کامیتِ ارسالی (commit) اشاره می‌کند.
اضافه کردن و کامیت
می‌توانید با دستور زیر فایل‌ها را به ایندکس اضافه کنید:
git add <filename>
git add *
- این اولین قدمِ یک گردش کار ساده در گیت محسوب می‌شود. برای ارسال واقعی تغییرات از دستور پایین استفاده کنید
+ این اولین قدمِ یک گردش کار ساده در گیت محسوب می‌شود. برای ارسال واقعی تغییرات از دستور پایین استفاده کنید:
git commit -m "Commit message"
- اکنون فایل‌های مورد نظر در هِد قرار گرفته ولی هنوز به سرور ارسال نشده‌اند.
+ اکنون فایل‌های مورد نظر در هِد قرار گرفته‌اند؛ ولی هنوز به سرور ارسال نشده‌اند.
diff --git a/index.en.html b/index.en.html
new file mode 100644
index 00000000..38e233c1
--- /dev/null
+++ b/index.en.html
@@ -0,0 +1,238 @@
+
+
+
+
+
+ ارسال تغییرات (Push)
+ برای ارسال تغییرات به سرورِ ریموت دستور زیر را اجرا کنید:
git push origin master
به جای مَستر (master)، اسم شاخه‌ای (branch) را وارد کنید که می‌خواهید تغییراتش را ارسال کنید.
- اگر هیچ مخزن محلی‌ای را کلون نکرده بودید می‌توانید با دستور پایین مخزن محلی‌تان را به مخزن ریموت متصل کنید
+ اگر هیچ مخزن محلی‌ای را کلون نکرده بودید می‌توانید با دستور پایین مخزن محلی‌تان را به مخزن ریموت متصل کنید:
git remote add origin <server>
حالا می‌توانید تغییرات را به کمک ریموت ساخته شده به سرور ارسال نمایید.
@@ -150,11 +150,11 @@ شاخه‌بندی (Branching)
+ با دستور زیر شاخه‌ای به نام "feature_x" ساخته شده و به آن سوئیچ می‌شود:
git checkout -b feature_x
- بازگشت به شاخه master
+ بازگشت به شاخۀ مستر:
git checkout master
- حذف شاخه
+ حذف شاخه:
git branch -d feature_x
تا زمانی که شاخه‌ای را به سرور پوش نکنید، سایر افراد به آن دسترسی ندارند.
git push origin <branch>
@@ -164,12 +164,12 @@ شاخه‌بندی (Branching)
- بروزرسانی و ادغام
+ برای اینکه مخزن محلی خود را به آخرین کامیت بروز کنید، دستور
git pull
را در پوشه محلی (فولدر پروژه روی سیستم‌تان) اجرا کنید تا تغییرات مخزن ریموت (واقع روی سرور)،
دریافت (fetch) و ادغام (merge) شوند. برای ادغام یک شاخۀ دیگر با شاخۀ کنونی (مثلاً master)، از دستور زیر استفاده کنید:
git merge <branch>
- گیت در هر دو حالت تلاش می‌کند تغییرات را به صورت خودکار ادغام کند ولی این کار همیشه میسر نیست چون ممکن است منجر به تداخل (conflict) شود.
- تداخل‌ها را باید خودتان به صورتی دستی برطرف نمایید و سپس عمل ادغام را انجام دهید. پس از ویرایش باید با دستور زیر، آن‌ها را به عنوان «ادغام شده» علامت بزنید
+ گیت در هر دو حال تلاش می‌کند تغییرات را به صورت خودکار ادغام کند ولی این کار همیشه میسر نیست چون ممکن است به تداخل (conflict) منجر شود.
+ تداخل‌ها را باید خودتان به صورتی دستی برطرف نمایید و سپس عمل ادغام را انجام دهید. پس از ویرایش باید با دستور زیر، آن‌ها را به عنوان «ادغام شده» علامت بزنید:
git add <filename>
قبل از ادغام تغییرات، پیش‌نمایش آن را می‌توانید با دستور زیر ببینید
git diff <source_branch> <target_branch>
@@ -181,7 +181,7 @@ برچسب‌گذاری
- می‌توانید با دستور زیر برچسبی به نام 1.0.0 بسازید
+ می‌توانید با دستور زیر برچسبی به نام 1.0.0 بسازید:
git tag 1.0.0 1b2e1d63ff
عبارت 1b2e1d63ff، اولین ده کاراکتر شناسۀ (ID) کامیتی است که می‌خواهید برچسب‌گذاری کنید. می‌توانید شناسه کامیت را با جستجو در لاگ پیدا کنید...
لاگ
git log
- می‌توانید کلی پارامتر دیگر هم به این دستور اضافه کنید تا شبیه آن چیزی شود که می‌خواهید. دیدن کامیت‌های یک شخص خاص:
+ می‌توانید کلی پارامتر دیگر هم به این دستور اضافه کنید تا بشود آن چیزی که می‌خواهید. دیدن کامیت‌های یک شخص خاص:
git log --author=bob
دیدن کامیت‌ها به صورت مختصر؛ هر کدام در یک خط:
git log --pretty=oneline
@@ -208,12 +208,12 @@ لاگ
@@ -221,28 +221,7 @@ جایگزین کردن تغییرات محلی
+ در صورتی که مرتکب اشتباهی شدید، تغییرات محلی را می‌توانید با دستور پایین جایگزین کنید:
git checkout -- <filename>
این دستور، تغییرات working directory (فولدر پروژه روی سیستم) را با آخرین محتوایی که هِد به آن اشاره می‌کند جایگزین می‌کند. البته فایل‌های جدید و تغییراتی که از قبل به ایندکس اضافه شده، دست نخورده باقی می‌مانند.
git fetch origin
git reset --hard origin/master
@@ -223,13 +223,13 @@ جایگزین کردن تغییرات محلی
@@ -249,7 +249,7 @@ نکات مفید
+ رابط گرافیکی گیت git:
gitk
- نمایش خروجی دستورات به صورت رنگی
+ نمایش خروجی دستورات به صورت رنگی:
git config color.ui true
- نمایش مختصر لاگ، تنها یک کامیت در هر سطر
+ نمایش مختصر لاگ، تنها یک کامیت در هر سطر:
git config format.pretty oneline
- افزودن فایل‌ها به صورت تعاملی
+ افزودن فایل‌ها به صورت تعاملی:
git add -i
کلاینت‌های گرافیکی گیت
آموزشِ گیت
-
+
+این مخزن ترجمه‌ای از پروژه انگلیسی http://rogerdudler.github.com/git-guide/ است. پروژه اصلی مدت‌هاست متوقف شده و Pull Request ترجمه فارسی هم مثل سایر PRها به دلیل عدم نگهداری، ادغام نشده است.
+
+
+
diff --git a/index.de.html b/index.de.html
index b1d8490d..2411933a 100644
--- a/index.de.html
+++ b/index.de.html
@@ -33,7 +33,7 @@ git - Der einfache Einstieg
von Roger Dudler
Dank an @tfnico, @fhd und Namics
diese Anleitung in
- english,
+ english,
deutsch,
español,
français,
@@ -49,7 +49,7 @@ git - Der einfache Einstieg
中文,
한국어,
Vietnamese,
- فارسی
+ فارسی
Feedback auf github
@@ -63,10 +63,10 @@ Installation
git für OS X herunterladen
Anleitungen
-
-
-
- 
-
-
-
-
+ Kommentare
-
-
-
-
+
+
+
+
+
+ git - the simple guide
+
+
+
+
+ create a new repository
+
+ git init
+ to create a new git repository.
+
+
+
+ checkout a repository
+
+ git clone /path/to/repository
+ when using a remote server, your command will be
+ git clone username@host:/path/to/repository
+
+
+
+ workflow
+ Working Directory which holds the actual files.
+ the second one is the Index which acts as a staging area and
+ finally the HEAD which points to the last commit you've made.
+
+
+
+
+ add & commit
+
+ git add <filename>
+ git add *
+ This is the first step in the basic git workflow. To actually commit these changes use
+ git commit -m "Commit message"
+ Now the file is committed to the HEAD, but not in your remote repository yet.
+
+
+
+ pushing changes
+
+ git push origin master
+ Change master to whatever branch you want to push your changes to.
+
+ If you have not cloned an existing repository and want to connect your repository to a remote server, you need to add it with
+ git remote add origin <server>
+ Now you are able to push your changes to the selected remote server
+
+
+
+
+ branching
+
+
+ git checkout -b feature_x
+ switch back to master
+ git checkout master
+ and delete the branch again
+ git branch -d feature_x
+ a branch is not available to others unless you push the branch to your remote repository
+ git push origin <branch>
+
+
+
+ update & merge
+
+ git pull
+ in your working directory to fetch and merge remote changes.
+ to merge another branch into your active branch (e.g. master), use
+ git merge <branch>
+ in both cases git tries to auto-merge changes. Unfortunately, this is not always possible and results in conflicts.
+ You are responsible to merge those conflicts
+ manually by editing the files shown by git. After changing, you need to mark them as merged with
+ git add <filename>
+ before merging changes, you can also preview them by using
+ git diff <source_branch> <target_branch>
+
+
+
+ tagging
+
+ git tag 1.0.0 1b2e1d63ff
+ the 1b2e1d63ff stands for the first 10 characters of the commit id you want to reference with your tag. You can get the commit id by looking at the...
+
+
+
+ log
+ git log
+ You can add a lot of parameters to make the log look like what you want. To see only the commits of a certain author:
+ git log --author=bob
+ To see a very compressed log where each commit is one line:
+ git log --pretty=oneline
+ Or maybe you want to see an ASCII art tree of all the branches, decorated with the names of tags and branches:
+ git log --graph --oneline --decorate --all
+ See only which files have changed:
+ git log --name-status
+ These are just a few of the possible parameters you can use. For more, see
+ git log --help
+
+
+
+ replace local changes
+
+ git checkout -- <filename>
+ this replaces the changes in your working tree with the last content in HEAD. Changes already added to the index, as well as new files, will be kept.
+
+ git fetch origin
+ git reset --hard origin/master
+
+
+
+ useful hints
+
+ gitk
+ use colorful git output
+ git config color.ui true
+ show log on just one line per commit
+ git config format.pretty oneline
+ use interactive adding
+ git add -i
+
+
+
+
+
diff --git a/index.es.html b/index.es.html
index 64e8760b..ab2f754a 100644
--- a/index.es.html
+++ b/index.es.html
@@ -29,7 +29,7 @@ links & resources
+ graphical clients
+
+
+
+ guides
+ get help
+ git - la guía sencilla
por Roger Dudler (traducido por @lfbarragan y @adrimatellanes)
créditos a @tfnico, @fhd y Namics
disponible en
- english,
+ english,
deutsch,
español,
français,
@@ -45,7 +45,7 @@ git - la guía sencilla
中文,
한국어,
Vietnamese,
- فارسی
+ فارسی
por favor, reporta cualquier problema en github
@@ -59,10 +59,10 @@ configuración
Descarga git para OSX
guías
-
-
نظرات
+ + + +