https://github.com/progit/progit2-fa
Farsi translation of progit2
https://github.com/progit/progit2-fa
Last synced: 3 months ago
JSON representation
Farsi translation of progit2
- Host: GitHub
- URL: https://github.com/progit/progit2-fa
- Owner: progit
- License: other
- Created: 2025-03-01T18:27:36.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-06-07T14:15:41.000Z (about 1 year ago)
- Last Synced: 2025-06-07T15:24:02.124Z (about 1 year ago)
- Language: CSS
- Size: 180 MB
- Stars: 1
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.asc
Awesome Lists containing this project
README
# پروگیت، ویرایش دوم
## ترجمه فارسی کتاب Pro Git
[](https://github.com/progit/progit2-fa/issues)
[](https://github.com/progit/progit2-fa/pulls)
## درباره این پروژه
به ویرایش دوم کتاب پروگیت (گیت حرفهای) خوش آمدید. این مخزن حاوی ترجمه فارسی کامل کتاب 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)
## چگونگی ساختن کتاب
### پیشنیازها
برای ساخت کتاب نیاز به ابزارهای زیر دارید:
- Ruby 2.7 یا بالاتر
- Bundler gem
- Git
### راهنمای سریع ساخت
```bash
# نصب وابستگیها
$ bundle install
# ساخت تمام فرمتهای کتاب
$ bundle exec rake book:build
```
### خروجیهای تولید شده
پس از اجرای دستورات بالا، فایلهای زیر تولید خواهند شد:
| فرمت | نام فایل | توضیحات |
|------|---------------|------------------------|
| 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
```
## گزارش مشکلات
### قبل از گزارش مشکل
قبل از ثبت مشکل جدید، لطفاً موارد زیر را بررسی کنید:
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% | در حال کار | نیازمند تکمیل |
### لینکهای انگلیسی
ترجمه و بومیسازی لینکها در مراحل پایانی پروژه انجام خواهد شد.
## مشارکت
ما از تمام کمکها استقبال میکنیم! برای مشارکت در این پروژه روشهای مختلفی وجود دارد:
### انواع مشارکت
#### 🔤 ترجمه
- ترجمه فصلهای جدید
- بهبود ترجمههای موجود
- اصلاح اشتباهات املایی و نگارشی
#### 📝 بازبینی
- بررسی متنهای ترجمه شده
- پیشنهاد بهبود در کیفیت ترجمه
- هماهنگی اصطلاحات فنی
#### 🐛 رفع مشکلات
- گزارش اشکالات
- رفع مشکلات فنی
- بهبود فرآیند ساخت
### شروع مشارکت
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)
---
**با تشکر از همه مشارکتکنندگان** 🙏
[مشاهده تمام مشارکتکنندگان](https://github.com/progit/progit2-fa/graphs/contributors)