refactor(import-hg): fixed persian translate issue and headers

Author: YasinDehfuli

book/09-git-and-other-scms/sections/import-hg.asc

@@ -1,35 +1,33 @@
 ==== Mercurial
 
 (((Mercurial)))(((Importing, from Mercurial)))
-از آنجا که مرکیوریال و گیت مدل‌های نسبتاً مشابهی برای نمایش نسخه‌ها دارند و از آنجا که گیت کمی انعطاف‌پذیرتر
-        است، تبدیل یک مخزن از مرکیوریال به گیت نسبتاً ساده است، با استفاده از ابزاری به نام "hg-fast-export" که شما به
-        یک نسخه از آن نیاز دارید:
+
+از آنجا که مرکیوریال و گیت مدل‌های نسبتاً مشابهی برای نمایش نسخه‌ها دارند و گیت کمی انعطاف‌پذیرتر است، تبدیل یک مخزن از مرکیوریال به گیت به‌طور نسبتاً ساده‌ای امکان‌پذیر است، با استفاده از ابزاری به نام "hg-fast-export"، که شما به یک نسخه از آن نیاز خواهید داشت:
 
 [source,console]
 ----
 $ git clone https://github.com/frej/fast-export.git
 ----
 
-اولین مرحله در تبدیل، دریافت یک کلون کامل از مخزن مرکیوریال است که می‌خواهید تبدیل کنید:
+اولین قدم در تبدیل، گرفتن یک کلون کامل از مخزن مرکیوریالی است که می‌خواهید آن را تبدیل کنید:
+
 
 [source,console]
 ----
 $ hg clone <remote repo URL> /tmp/hg-repo
 ----
 
 مرحله بعدی ایجاد یک فایل نگاشت نویسنده است.
-        مرکیوریال کمی بیشتر از گیت در مورد آنچه که در فیلد نویسنده برای تغییرات قرار می‌دهد، بخشنده است، بنابراین این
-        زمان خوبی برای تمیز کردن است.
-        تولید این یک دستور یک‌خطی در یک شل `bash` است:
+مرکیوریال کمی بیشتر از گیت در مورد چیزی که در فیلد نویسنده برای تغییرات قرار می‌دهد، انعطاف‌پذیر است، بنابراین این زمان مناسبی برای پاک‌سازی است.
+برای تولید این فایل، کافی است که یک دستور یک‌خطی در شل `bash` اجرا کنید:
 
 [source,console]
 ----
 $ cd /tmp/hg-repo
 $ hg log | grep user: | sort | uniq | sed 's/user: *//' > ../authors
 ----
 
-این چند ثانیه طول می‌کشد، بسته به اینکه تاریخچه پروژه شما چقدر طولانی است، و بعد از آن فایل
-        `/tmp/authors` به شکل زیر خواهد بود:
+این فرایند چند ثانیه طول خواهد کشید، بسته به اینکه تاریخچه پروژه شما چقدر طولانی باشد، و پس از آن فایل `/tmp/authors` چیزی شبیه به این خواهد بود:
 
 [source]
 ----
@@ -41,16 +39,12 @@ Bob Jones <[email protected]>
 Joe Smith <[email protected]>
 ----
 
-در این مثال، همان شخص (باب) تغییرات را تحت چهار نام مختلف ایجاد کرده است، یکی از آن‌ها واقعاً درست به نظر
-        می‌رسد و یکی از آن‌ها کاملاً نامعتبر برای یک کامیت گیت خواهد بود.
-        Hg-fast-export به ما اجازه می‌دهد این را با تبدیل هر خط به یک قانون اصلاح کنیم: `"&lt;input&gt;"="&lt;output&gt;"`،
-        که یک `&lt;input&gt;` را به یک `&lt;output&gt;` نگاشت می‌کند.
-        در داخل رشته‌های `&lt;input&gt;` و `&lt;output&gt;`، تمام توالی‌های فرار که توسط کدگذاری
-        `string_escape` پایتون درک می‌شوند، پشتیبانی می‌شوند.
-        اگر فایل نگاشت نویسنده شامل یک `&lt;input&gt;` مطابقت نداشته باشد، آن نویسنده بدون تغییر به گیت ارسال
-        می‌شود.
-        اگر تمام نام‌های کاربری خوب به نظر برسند، ما به این فایل نیازی نخواهیم داشت.
-        در این مثال، ما می‌خواهیم فایل ما به این شکل باشد:
+در این مثال، همان شخص (باب) تغییرات را تحت چهار نام مختلف ایجاد کرده است، که یکی از آن‌ها به درستی به نظر می‌رسد و یکی دیگر به طور کامل برای یک کامیت گیت نامعتبر است.
+ابزار `hg-fast-export` به ما اجازه می‌دهد این مشکل را با تبدیل هر خط به یک قانون حل کنیم: "<input>"="<output>"، که یک `<input>` را به یک `<output>` نگاشت می‌کند.
+در داخل رشته‌های `<input>` و `<output>`، تمام دنباله‌های فرار که توسط کدگذاری `string_escape` پایتون درک می‌شوند، پشتیبانی می‌شوند.
+اگر فایل نگاشت نویسنده شامل `<input>` مطابقت نداشته باشد، آن نویسنده بدون تغییر به گیت ارسال خواهد شد.
+اگر تمام نام‌های کاربری درست به نظر برسند، نیازی به این فایل نخواهیم داشت.
+در این مثال، ما می‌خواهیم فایل ما به این شکل باشد:
 
 [source]
 ----
@@ -60,10 +54,10 @@ Joe Smith <[email protected]>
 "bob jones <bob <AT> company <DOT> com>"="Bob Jones <[email protected]>"
 ----
 
-همین نوع فایل نگاشت می‌تواند برای تغییر نام شاخه‌ها و برچسب‌ها زمانی که نام مرکیوریال توسط گیت مجاز نیست،
-        استفاده شود.
+همین نوع فایل نگاشت می‌تواند برای تغییر نام شاخه‌ها و تگ‌ها زمانی که نام مرکیوریال توسط گیت مجاز نیست، استفاده شود.
+
+مرحله بعدی ایجاد مخزن جدید گیت ما است و سپس اجرای اسکریپت صادرات:
 
-مرحله بعدی ایجاد مخزن جدید گیت ما و اجرای اسکریپت صادرات است:
 
 [source,console]
 ----
@@ -72,13 +66,9 @@ $ cd /tmp/converted
 $ /tmp/fast-export/hg-fast-export.sh -r /tmp/hg-repo -A /tmp/authors
 ----
 
-پرچم `-r` به hg-fast-export می‌گوید که کجا مخزن مرکیوریال که می‌خواهیم تبدیل کنیم را پیدا کند و پرچم
-        `-A` به آن می‌گوید که کجا فایل نگاشت نویسنده را پیدا کند (فایل‌های نگاشت شاخه و برچسب به ترتیب با
-        پرچم‌های `-B` و `-T` مشخص می‌شوند).
-        این اسکریپت تغییرات مرکیوریال را تجزیه می‌کند و آن‌ها را به یک اسکریپت برای ویژگی "fast-import" گیت تبدیل می‌کند
-        (که در ادامه به تفصیل در مورد آن صحبت خواهیم کرد).
-        این کمی طول می‌کشد (اگرچه این _بسیار_ سریع‌تر از آن است که از طریق شبکه باشد)، و خروجی نسبتاً verbose
-        است:
+فلگ `-r` به hg-fast-export می‌گوید که مخزن مرکیوریال که می‌خواهیم تبدیل کنیم کجا قرار دارد، و فلگ `-A` به آن می‌گوید که فایل نگاشت نویسندگان کجا قرار دارد (فایل‌های نگاشت شاخه و تگ به ترتیب با فلگ‌های `-B` و `-T` مشخص می‌شوند).
+اسکریپت تغییرات مرکیوریال را تجزیه می‌کند و آن‌ها را به یک اسکریپت برای ویژگی "fast-import" گیت تبدیل می‌کند (که بعداً به تفصیل در مورد آن صحبت خواهیم کرد).
+این فرایند کمی طول می‌کشد (اگرچه بسیار سریع‌تر از زمانی است که بخواهید از طریق شبکه این کار را انجام دهید)، و خروجی آن نسبتاً مفصل است:
 
 [source,console]
 ----
@@ -126,10 +116,9 @@ $ git shortlog -sn
    365  Joe Smith
 ----
 
-این تقریباً تمام چیزی است که باید انجام دهید.
-        تمام برچسب‌های مرکیوریال به برچسب‌های گیت تبدیل شده‌اند و شاخه‌ها و نشانک‌های مرکیوریال به شاخه‌های گیت تبدیل
-        شده‌اند.
-        اکنون شما آماده‌اید که مخزن را به سرور جدید خود فشار دهید:
+تقریباً همین‌قدر است.
+تمامی تگ‌های مرکیوریال به تگ‌های گیت تبدیل شده‌اند، و شاخه‌ها و بوک‌مارک‌های مرکیوریال به شاخه‌های گیت تبدیل شده‌اند.
+حالا شما آماده‌اید که مخزن را به سرور جدید خود ارسال کنید:
 
 [source,console]
 ----