Update tagging.asc

Author: hjavadish

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

@@ -1,15 +1,14 @@
 [[_git_tagging]]
-=== Tagging
+=== برجسب گذاری
 
 (((tags)))
-Like most VCSs, Git has the ability to tag specific points in history as being important.
-Typically people use this functionality to mark release points (v1.0, and so on).
-In this section, you'll learn how to list the available tags, how to create new tags, and what the different types of tags are.
+همچون دیگر سامانه های کنترل نسخه، گیت هم می تواند یک نقطه ی خاص از تاریخچه ی پروژه را به عنواه نقطه ی مهم و با اهمیت برچسب گذاری کند.
+معمولا افراد از این قابلیت برای نشانه گذاری نسخه های قابل ارائه یا همان release کردن پروژه بهره می برند.( نسخه v1.0، و به همین ترتیب).
+در این بخش یاد فهرست گرفتن از برچسب های موجود، شیوه ساخت برچسب جدید و این که گونه های متفاوت برچسب ها هر کدام چه هستند را یاد خواهید گرفت.
 
-==== Listing Your Tags
+==== فهرست برچسب های موجود
 
-Listing the available tags in Git is straightforward.
-Just type `git tag` (with optional `-l` or `--list`):(((git commands, tag)))
+فهرست گیری از برچسب هیا موجود در گیت بسیار ساده است. تنها نیاز است که دستور `git tag` (با پارامتر دلخواه `-l` و یا `--list`) را وارد نمایید:(((git commands, tag)))
 
 [source,console]
 ----
@@ -18,11 +17,11 @@ v0.1
 v1.3
 ----
 
-This command lists the tags in alphabetical order; the order in which they appear has no real importance.
+این دستور، برچسب های موجود را به ترتیب حرف الفبا نشان می دهد; درواقع ترتیب نمایش آنها هیچ اهمیت ندارد.
 
-You can also search for tags that match a particular pattern.
-The Git source repo, for instance, contains more than 500 tags.
-If you're only interested in looking at the 1.8.5 series, you can run this:
+همچنین می توان برچسب ها را جست و جو کنید و از قواعد الگوها نیز بهره مند شود. 
+برای نمونه مخزن اصلی گیت، بیش از 500 برچسب دارد.
+مثلا اگر میخواید تنها به دنبال برجسب های سری 1.8.5 بگردید، می توانید دستور زیر را اجرا نمایید.
 
 [source,console]
 ----
@@ -47,22 +46,23 @@ If you want just the entire list of tags, running the command `git tag` implicit
 If, however, you're supplying a wildcard pattern to match tag names, the use of `-l` or `--list` is mandatory.
 ====
 
-==== Creating Tags
+==== ساخت برچسب ها
 
-Git supports two types of tags: _lightweight_ and _annotated_.
+گیت دو گونه برچسب دارد: _lightweight_ یا __سبک__ و  _annotated_ یا __مفصل__.
 
-A lightweight tag is very much like a branch that doesn't change -- it's just a pointer to a specific commit.
+یگ برچسب  lightweight بسیار شبیه یک شاخه ی بدون تغییر است. -- فقط اشاره گری به یک ثبت ویژ] و مشخص است.
 
-Annotated tags, however, are stored as full objects in the Git database.
-They're checksummed; contain the tagger name, email, and date; have a tagging message; and can be signed and verified with GNU Privacy Guard (GPG).
-It's generally recommended that you create annotated tags so you can have all this information; but if you want a temporary tag or for some reason don't want to keep the other information, lightweight tags are available too.
+برچسب های Annotated , however, به عنوان مجموعه ای از اشیاء کامل در پایگاه داده گیت ذخیره می شوند.
+این برچسب ها کنترل checksum می شوند; شامل نام کاربر، ایمیل و تاریخ  برجسب گذاری هستند; پیام مربوط به برچسب را دارند; و می توان آنها را با GPG (GNU Privacy Guard) علامت گذاری و تایید نمود.
+
+بیشتر پیشنهاد می شود که برچسب های annotated ایجاد کنید تا به همه این داده ها دسترسی داشته باشد; اما اگر تنها یک برچسب موفت و گذرا نیاز دارید و یا به هر روی نباید داده ها ذخیره شوند می توانید از برچسب های lightweight بهره بگیرید.
 
 [[_annotated_tags]]
-==== Annotated Tags
+==== برچسبهای Annotated
 
 (((tags, annotated)))
-Creating an annotated tag in Git is simple.
-The easiest way is to specify `-a` when you run the `tag` command:(((git commands, tag)))
+ساخت یک برچسب Annotated در گیت بسیار ساده است.
+ساده ترین راه افزدون `-a` هنگام اجرای دستور `tag` می باشد:(((git commands, tag)))
 
 [source,console]
 ----
@@ -73,10 +73,10 @@ v1.3
 v1.4
 ----
 
-The `-m` specifies a tagging message, which is stored with the tag.
-If you don't specify a message for an annotated tag, Git launches your editor so you can type it in.
+`-m` مشخص گننده پیام برچسب است، که با برچسب ذخیره خواهد شد.
+اگر پیامی برای یک برچسب annotated مشخص نکنید گیت ویرایش پیش فرض را اجرا کرده و شما می توانید آنجا نوشتن را بیاغازید.
 
-You can see the tag data along with the commit that was tagged by using the `git show` command:
+داده های برچسب را میتوانید در همان ثبت برچسب گذاری شده با دستور `git show` ببینید.
 
 [source,console]
 ----
@@ -94,14 +94,15 @@ Date:   Mon Mar 17 21:52:11 2008 -0700
     changed the version number
 ----
 
-That shows the tagger information, the date the commit was tagged, and the annotation message before showing the commit information.
+این دستور داده های کاربر برچسب گذار، تاریخ برچسب 
+گذاری و پیام مربوط به برچسب را پیش ا ز داده های ثبت مربوطه نشان می دهد.
 
-==== Lightweight Tags
+==== برچسب های Lightweight
 
 (((tags, lightweight)))
-Another way to tag commits is with a lightweight tag.
-This is basically the commit checksum stored in a file -- no other information is kept.
-To create a lightweight tag, don't supply any of the `-a`, `-s`, or `-m` options, just provide a tag name:
+راه دیگری برای برچسب گذاری ثبت ها برچسب lightweight است.
+این برچسب تنها checksum مربوط به ثبت است که در یک فایل ذخیره می شود -- اطلاعات دیگری نگه داشته نمیشود.
+برای ساخت یک برچشب lightweight، هیچکدام از گزینه های `-a`، `-s`، یا `-m` را بکار نگیرید، تنها نام برچسب را وارد نمایید.
 
 [source,console]
 ----
@@ -114,8 +115,8 @@ v1.4-lw
 v1.5
 ----
 
-This time, if you run `git show` on the tag, you don't see the extra tag information.(((git commands, show)))
-The command just shows the commit:
+اکنو اگر `git show` را بر روی یک برچسب اجرا کنید، داده های بیشتری از برچسب را نخواهید دید.(((git commands, show)))
+این دستور تنها ثبت را نشان خواهد:
 
 [source,console]
 ----
@@ -127,10 +128,10 @@ Date:   Mon Mar 17 21:52:11 2008 -0700
     changed the version number
 ----
 
-==== Tagging Later
+==== برچسب گذاری با تاخیر
 
-You can also tag commits after you've moved past them.
-Suppose your commit history looks like this:
+همچینین می توانید بعد از چند ثبت،ثبت های پیشین را برچسب گذاری کتید.
+فرض کنید تاریخچه ی برچسب های شما شبیه این باشد:
 
 [source,console]
 ----
@@ -147,16 +148,17 @@ a6b4c97498bd301d84096da251c98a07c7723e65 beginning write support
 8a5cbc430f1a9c3d00faaeffd07798508422908a updated readme
 ----
 
+اینک فرض کنید که در ثبت ``updated rakefile`` فراموش کرده اید پروژ] را با v1.2 برچسب گذاری نمایید.
 Now, suppose you forgot to tag the project at v1.2, which was at the ``updated rakefile'' commit.
-You can add it after the fact.
-To tag that commit, you specify the commit checksum (or part of it) at the end of the command:
+پس از ثبت می توانید این کار را انجام دهید.
+برای برچسب گذاری ثبت های پیشین، checksum مربوط به ثبت  را (یا بخشی از آن را ) در پایان دستور وارد نمایید.
 
 [source,console]
 ----
 $ git tag -a v1.2 9fceb02
 ----
 
-You can see that you've tagged the commit:(((git commands, tag)))
+می بینید که ثبت مورد نظر برچسب گذاری شده است:(((git commands, tag)))
 
 [source,console]
 ----
@@ -183,11 +185,11 @@ Date:   Sun Apr 27 20:43:35 2008 -0700
 ----
 
 [[_sharing_tags]]
-==== Sharing Tags
+==== اشتراک گذری برجسب ها
 
-By default, the `git push` command doesn't transfer tags to remote servers.(((git commands, push)))
-You will have to explicitly push tags to a shared server after you have created them.
-This process is just like sharing remote branches -- you can run `git push origin <tagname>`.
+دستور `git push` برچسب ها را به صورت پیش فرض به سرور منتقل نمی کند.(((git commands, push)))
+شما باید برچسب ها را پس از ساخت و ایجاد آنها، مستقلا انتقال دهید.
+این فرآیند دقیقا شبیه انتقال و انتشار شاخه هاست -- شما می توانید دستور `git push origin <tagname>` را بکار ببرید.
 
 [source,console]
 ----
@@ -201,8 +203,9 @@ To [email protected]:schacon/simplegit.git
  * [new tag]         v1.5 -> v1.5
 ----
 
-If you have a lot of tags that you want to push up at once, you can also use the `--tags` option to the `git push` command.
-This will transfer all of your tags to the remote server that are not already there.
+
+اگر برچسب های زیادی دارید که میخواهید همه را یکجا به سرور منتقل کنید، می توانید از گزینه `--tags` در دستور `git push` استفاده نمایید.
+این دستور تمام برچسب هایی را که در سرور نیستند به سرور منتقل خواهد کرد.
 
 [source,console]
 ----
@@ -215,11 +218,11 @@ To [email protected]:schacon/simplegit.git
  * [new tag]         v1.4-lw -> v1.4-lw
 ----
 
-Now, when someone else clones or pulls from your repository, they will get all your tags as well.
+اینک اگر کسی دیگر از مخزن ما نمونه برداری کرد یا تنها ثبت ها را فراخوانی و بارگزاری کرد، تمام برجسب ها را نیز دریافت خواهد نمود.
 
 ==== Checking out Tags
 
-If you want to view the versions of files a tag is pointing to, you can do a git checkout, though this puts your repository in ``detached HEAD'' state, which has some ill side effects:
+اگر نسخه های فایلهایی که برچسب به آنها اشاره می کند را می خواهید ببینید، می توانید یک git checkout  اجرا کنید، آگاه باشید که این کار مخزن شما را در وضعیت  **detached HEAD** قرار میدهد, که امکان تاثیر جانبی ناپسندی دارد.:
 
 [source,console]
 ----
@@ -242,12 +245,12 @@ Previous HEAD position was 99ada87... Merge pull request #89 from schacon/append
 HEAD is now at df3f601... add atlas.json and cover image
 ----
 
-In ``detached HEAD'' state, if you make changes and then create a commit, the tag will stay the same, but your new commit won't belong to any branch and will be unreachable, except for by the exact commit hash. Thus, if you need to make changes -- say you're fixing a bug on an older version, for instance -- you will generally want to create a branch:
+در وضعیت **detached HEAD** اگر تغییراتی ایجاد کنید و آنها را ثبت کنید، برچسب تغییر نخواهد کرد، ولی ثبت جدید در هیچ شاخه ای جای نمیگیرد و از دسترس خارج میشود، مگر با کد کامل hash مربوط به آن ثبت. بنابراین اگر نیاز به ایجاد تغییرات دارید -- مثلا میخواهید یک باگ را در نسخه های پیشین برطرف نمایید -- شماه باید یک شاخه ی جدید بسازید.
 
 [source,console]
 ----
 $ git checkout -b version2 v2.0.0
 Switched to a new branch 'version2'
 ----
 
-If you do this and make a commit, your `version2` branch will be slightly different than your `v2.0.0` tag since it will move forward with your new changes, so do be careful.
+با اجرای دستور بالا، اگر یک ثبت تازه ایجاد نمودید، شاخه ی `version2` اندکی متفاوت از برچسب `v2.0.0` خواهد بود. تا زمانی که با تغییرات جدید در این شاخه به پیش می رود. پس مرافب باشید.