refactor(readme): change readme.md to new format

Author: YasinDehfuli

README.md

@@ -1,62 +1,197 @@
-<h1 dir="rtl">پروگیت، ویرایش دوم</h1>
-<p dir="rtl">به ویرایش دوم کتاب پروگیت (گیت حرفه ای) خوش آمدید</p>
-<p dir="rtl">نسخه آنلاین این کتاب را <a href="http://git-scm.com/book/fa/v2" target="_blank">اینجا</a> ببینید.
-</p>
-<p dir="rtl">
-همانند ویرایش اول، ویرایش دوم پروگیت هم متن-باز تحت لایسنس «کریتیو کامنز» است. (Creative Commons)
-</p>
-<p dir="rtl">
-از زمان متن-باز شدن نسخه اول تغییراتی اعمال شده.
-ابتدا اینکه برای متن کتاب، ما از مارک‌دان به قالب شگفت‌انگیز اسکی‌داک مهاجرت کرده‌ایم. رفرنس سریع اسکی‌داک  را می‌توانید در <a href="https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/">اینجا</a> پیدا کنید.
-</p>
-<p dir="rtl">
-ما، همچنین، انتقالی انجام دادیم تا ترجمه‌ها را در مخزن‌های جدایی به جای پوشه‌هایی در مخزن انگلیسی نگه‌داری کنیم.
-برای اطلاعات بیشتر به <a href="https://github.com/progit2-fa/progit2/blob/master/TRANSLATING.md">سند ترجمه</a> مراجعه کنید.
-</p>
-<h2 dir="rtl">چگونگی ساختن کتاب</h2>
-<p dir="rtl">
-شما می‌توانید فایل‌های این کتاب الکترونیک را به طور دستی با اسکی‌داکتر بسازید.
-اگر دستورات پیش‌رو را اجرا کنید احتمالاً می‌توانید خروجی‌های اچ‌تی‌ام‌ال، ای-پاب، موبی و پی‌دی‌اف بگیرید:
-</p>
-<pre>
+<div align="center">
+
+# پروگیت، ویرایش دوم
+## ترجمه فارسی کتاب Pro Git
+
+[![GitHub Issues](https://img.shields.io/github/issues/progit/progit2-fa)](https://github.com/progit/progit2-fa/issues)
+[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/progit/progit2-fa)](https://github.com/progit/progit2-fa/pulls)
+
+</div>
+
+<div dir="rtl">
+
+## درباره این پروژه
+
+به ویرایش دوم کتاب پروگیت (گیت حرفه‌ای) خوش آمدید. این مخزن حاوی ترجمه فارسی کامل کتاب Pro Git است که یکی از جامع‌ترین منابع آموزشی سیستم کنترل نسخه Git محسوب می‌شود.
+
+**📖 [نسخه آنلاین کتاب را اینجا مطالعه کنید](http://git-scm.com/book/fa/v2)**
+
+## ویژگی‌ها
+
+- ✅ ترجمه کامل ویرایش دوم کتاب Pro Git
+- 📝 فرمت AsciiDoc برای قابلیت نگهداری بهتر
+- 🔄 به‌روزرسانی مداوم محتوا
+- 📱 پشتیبانی از خروجی‌های مختلف (HTML، PDF، EPUB، MOBI)
+- 🎯 تطبیق کامل با نسخه انگلیسی
+
+## فهرست مطالب
+
+- [نحوه ساخت کتاب](#چگونگی-ساختن-کتاب)
+- [گزارش مشکلات](#ارجاع-یک-مشکل)
+- [مشکلات شناخته شده](#مشکلات-شناخته-شده)
+- [نحوه مشارکت](#مشارکت)
+
+## اطلاعات لایسنس
+
+همانند ویرایش اول، ویرایش دوم پروگیت نیز متن‌باز تحت لایسنس [Creative Commons](LICENSE) منتشر شده است.
+
+## تغییرات نسبت به ویرایش اول
+
+- **فرمت جدید**: مهاجرت از Markdown به فرمت AsciiDoc
+- **مخزن جداگانه**: ترجمه‌ها در مخزن‌های مستقل نگهداری می‌شوند
+- **بهبود ساختار**: سازماندهی بهتر محتوا و فایل‌ها
+
+[📋 راهنمای کامل ترجمه](https://github.com/progit/progit2-fa/blob/master/TRANSLATING.md)
+
+</div>
+<div dir="rtl">
+
+## چگونگی ساختن کتاب
+
+### پیش‌نیازها
+
+برای ساخت کتاب نیاز به ابزارهای زیر دارید:
+
+- Ruby 2.7 یا بالاتر
+- Bundler gem
+- Git
+
+### راهنمای سریع ساخت
+
+```bash
+# نصب وابستگی‌ها
 $ bundle install
+
+# ساخت تمام فرمت‌های کتاب
 $ bundle exec rake book:build
-Converting to HTML...
- -- HTML output at progit.html
-Converting to EPub...
- -- Epub output at progit.epub
-Converting to Mobi (kf8)...
- -- Mobi output at progit.mobi
-Converting to PDF...
- -- PDF output at progit.pdf
-</pre>
-<h1 dir="rtl">ارجاع یک مشکل</h1>
-<p dir="rtl">
-قبل از ارجاع یک مشکل، لطفاً بررسی کنید که پیشتر مشکل مشابهی در سیستم رهگیری باگ وجود نداشته باشد.
-</p><p dir="rtl">
-همچنین اگر این مشکل سابقاً روی سایت رسمی گیت مشاهده شده، لطفاً بازنگری کنید که آیا هنوز در این مخزن موجود است یا خیر.
-ممکن است پیش از این مشکل اصلاح شده باشد، اما تغییرات هنوز اعمال نشده باشند.
-</p>
-<h2 dir="rtl">مشکل فونت فارسی</h2>
-<p dir="rtl">
-در بعضی سیستم‌ها ممکن است خروجی پی‌دی‌اف خوانا نباشد و یا مشکلات قالبی (راست‌چین بودن) و... داشته باشد.
-پیشنهاد می‌شود که اسکی‌داکتر را بازتنظیم کنید و از فونت‌سازگار استفاده کنید.
-</p><p dir="rtl">
-با توجه به دشواری بازتنظیمی اسکی‌داکتر ممکن است بخواهید از خروجی اچ‌تی‌ام‌ال استفاده کرده یا در صورت نیاز به پی‌دی‌اف، خروجی اچ‌تی‌ام‌ال را توسط ابزاری مانند مرورگر به پی‌دی‌اف تبدیل کنید.
-</p>
-<h2 dir="rtl">ترجمهٔ ناقص</h2>
-<p dir="rtl">
-ممکن است ترجمه‌ها پیش‌نویس یا ناقص و یا کلمات یکپارچگی نداشته باشند. این امر ممکن است به دلایل مختلف (محدودیت‌های فنی) اتفاق افتاده باشد. اگر چنین موردی مشاهده کردید و در تودو ذکر نشده بود یا برای
-آن ایشوی نظیری وجود نداشت یا آنرا حل کرده و پول ریکوئست درست کنید و یا در ایشوهای به ما یادآوری کنید تا در اسرع وقت آنرا پیگیری کنیم.
-</p><p dir="rtl">
-به طور کل فایل‌های بالای ۸۰ درصد در فایل استاتوس.جی‌سان کامل تلقی می‌شوند.
-فایل‌های ۹۵ درصد ترجمهٔ نهایی شده‌اند و نیازمند بازبینی هستند و فایل‌های ۹۰ درصد پیش‌نویس نهایی هستند.
-</p>
-<h2 dir="rtl">لینک‌های انگلیسی یا ناقص</h2>
-<p dir="rtl">
-ترجمهٔ لینک‌ها و اتصال آنها کار دشواری است. به همین دلیل این کار در مراحل آخر اصلاح خواهد شد. لطفاً شکیبا باشید.
-</p>
-<h1 dir="rtl">مشارکت</h1>
-<p dir="rtl">
-اگر مایلید کمک کنید تا تغییری ایجاد شود، لطفاً به <a href="https://github.com/progit2-fa/progit2/blob/master/CONTRIBUTING.md">راهنمای مشارکت در پروژه</a> مراجعه کنید.
-</p>
+```
+
+### خروجی‌های تولید شده
+
+پس از اجرای دستورات بالا، فایل‌های زیر تولید خواهند شد:
+
+| فرمت | نام فایل | توضیحات |
+|------|----------|---------|
+| HTML | `progit.html` | نسخه وب کتاب |
+| EPUB | `progit.epub` | مناسب برای e-reader ها |
+| MOBI | `progit.mobi` | سازگار با Kindle |
+| PDF | `progit.pdf` | نسخه قابل چاپ |
+
+### ساخت فرمت خاص
+
+```bash
+# فقط HTML
+$ bundle exec rake book:build_html
+
+# فقط PDF
+$ bundle exec rake book:build_pdf
+
+# فقط EPUB
+$ bundle exec rake book:build_epub
+```
+
+</div>
+<div dir="rtl">
+
+## گزارش مشکلات
+
+### قبل از گزارش مشکل
+
+قبل از ثبت مشکل جدید، لطفاً موارد زیر را بررسی کنید:
+
+1. **جستجو در مسائل موجود**: ممکن است مشکل شما قبلاً گزارش شده باشد
+2. **بررسی سایت اصلی Git**: اگر مشکل روی [git-scm.com](https://git-scm.com/book/en/v2) حل شده، ممکن است در حال به‌روزرسانی باشد
+3. **وضعیت ترجمه**: وضعیت فعلی ترجمه را در فایل `status.json` بررسی کنید
+
+### نحوه گزارش مشکل
+
+برای گزارش مشکل:
+
+1. به [صفحه Issues](https://github.com/progit/progit2-fa/issues) بروید
+2. روی "New Issue" کلیک کنید
+3. عنوان توصیفی و جزئیات کامل ارائه دهید
+4. اگر امکان دارد، راه‌حل پیشنهادی ارائه دهید
+
+## مشکلات شناخته شده
+
+### مشکل فونت فارسی در PDF
+
+**علت**: برخی سیستم‌ها فونت‌های فارسی را به درستی پردازش نمی‌کنند
+
+**راه‌حل‌های پیشنهادی**:
+- استفاده از خروجی HTML به جای PDF
+- تبدیل HTML به PDF از طریق مرورگر
+- بازتنظیم AsciiDoctor با فونت‌های سازگار
+
+### ترجمه ناقص
+
+**وضعیت فایل‌ها بر اساس درصد تکمیل**:
+
+| درصد تکمیل | وضعیت | توضیحات |
+|------------|--------|---------|
+| 95%+ | نهایی | نیازمند بازبینی نهایی |
+| 90-94% | پیش‌نویس نهایی | آماده برای بازبینی |
+| 80-89% | کامل | محتوای اصلی تکمیل شده |
+| <80% | در حال کار | نیازمند تکمیل |
+
+### لینک‌های انگلیسی
+
+ترجمه و بومی‌سازی لینک‌ها در مراحل پایانی پروژه انجام خواهد شد.
+
+</div>
+<div dir="rtl">
+
+## مشارکت
+
+ما از تمام کمک‌ها استقبال می‌کنیم! برای مشارکت در این پروژه روش‌های مختلفی وجود دارد:
+
+### انواع مشارکت
+
+#### 🔤 ترجمه
+- ترجمه فصل‌های جدید
+- بهبود ترجمه‌های موجود
+- اصلاح اشتباهات املایی و نگارشی
+
+#### 📝 بازبینی
+- بررسی متن‌های ترجمه شده
+- پیشنهاد بهبود در کیفیت ترجمه
+- هماهنگی اصطلاحات فنی
+
+#### 🐛 رفع مشکلات
+- گزارش اشکالات
+- رفع مشکلات فنی
+- بهبود فرآیند ساخت
+
+### شروع مشارکت
+
+1. **Fork** کردن مخزن
+2. ایجاد شاخه جدید برای تغییرات:
+   ```bash
+   git checkout -b feature/my-contribution
+   ```
+3. اعمال تغییرات و commit
+4. Push به مخزن fork شده
+5. ایجاد Pull Request
+
+### راهنماهای مفصل
+
+- 📖 [راهنمای کامل مشارکت](https://github.com/progit/progit2-fa/blob/master/CONTRIBUTING.md)
+- 🌐 [راهنمای ترجمه](https://github.com/progit/progit2-fa/blob/master/TRANSLATING.md)
+
+### ارتباط با تیم
+
+برای سوالات و پیشنهادات:
+- [GitHub Issues](https://github.com/progit/progit2-fa/issues)
+- [GitHub Discussions](https://github.com/progit/progit2-fa/discussions)
+
+---
+
+<div align="center">
+
+**با تشکر از همه مشارکت‌کنندگان** 🙏
+
+[مشاهده تمام مشارکت‌کنندگان](https://github.com/progit/progit2-fa/graphs/contributors)
+
+</div>
+
+</div>