TEMPLATE_USAGE_GUIDE.md

# دليل استخدام نظام تحويل template.docx مع خط Arial المحلي

## 🎯 نظرة عامة

تم تطوير نظام متقدم لتحويل ملف `template.docx` إلى PDF مع الحفاظ على أحجام الخطوط المحددة واستخدام خط Arial من مجلد `fonts` المحلي.

## 📁 هيكل المشروع

```
pdf/
├── fonts/
│   └── arial.ttf          # خط Arial المحلي
├── template.docx          # الملف المراد تحويله
├── app.py                 # التطبيق الرئيسي
├── test_template_conversion.py  # ملف الاختبار
└── TEMPLATE_USAGE_GUIDE.md      # هذا الدليل
```

## 🔤 أحجام الخطوط المحددة

### حجم 12 نقطة:
- `{{serial_number}}` - الرقم التسلسلي
- `{{t_11}}` - المتغير t_11
- `{{t_}}` - المتغير t_
- `{{date}}` - التاريخ
- النصوص: "الرقم التسلسلي"، "الساعة"، "التاريخ"

### حجم 13 نقطة:
- `{{name_1}}`, `{{name_2}}`, `{{name_3}}` - الأسماء
- `{{id_1}}`, `{{id_2}}` - أرقام الهوية
- `{{location_1}}`, `{{location_2}}`, `{{location_3}}` - المواقع
- `{{phone_1}}`, `{{phone_2}}` - أرقام الهاتف
- النصوص: "اسم المالك الشرعي"، "الطرف الاول"، "البائع"، "رقم الهوية"، "الطرف الثاني"، "المشتري"، "يسكن"، "رقم الهاتف"

### حجم 14 نقطة:
- النصوص: "الطرف البائع"، "الطرف المشتري"

### حجم 12 نقطة (افتراضي):
- جميع النصوص الأخرى في الملف

## ⚙️ الميزات الجديدة

### 1. استخدام خط Arial المحلي
- يتم تحميل خط Arial من مجلد `fonts/arial.ttf`
- يتم تثبيته في النظام تلقائياً
- يحصل على أولوية عالية في تكوين الخطوط

### 2. تحليل أحجام الخطوط
- تحليل تلقائي لملف template.docx
- استخراج أحجام الخطوط لكل نص
- تطبيق الأحجام المحددة حسب المحتوى

### 3. معالجة مسبقة متقدمة
- تطبيق خط Arial على جميع النصوص
- تعديل أحجام الخطوط حسب المواصفات
- حفظ التنسيق الأصلي

## 🚀 كيفية الاستخدام

### 1. التحضير
```bash
# تأكد من وجود خط Arial
ls fonts/arial.ttf

# تأكد من وجود ملف template.docx
ls template.docx
```

### 2. تشغيل الاختبارات
```bash
python test_template_conversion.py
```

### 3. تشغيل التطبيق
```bash
python app.py
```

### 4. رفع الملف
- افتح واجهة Gradio
- ارفع ملف `template.docx`
- انتظر التحويل
- حمل ملف PDF الناتج

## 🔧 التكوين التقني

### إعدادات الخطوط
```xml
<!-- في fontconfig -->
<alias>
  <family>Arial</family>
  <prefer>
    <family>Arial</family>
    <family>Liberation Sans</family>
  </prefer>
</alias>
```

### إعدادات LibreOffice
```xml
<!-- الخطوط الافتراضية -->
<prop oor:name="Standard">
  <value>Arial;Liberation Sans;DejaVu Sans</value>
</prop>
```

### معالجة أحجام الخطوط
```python
# حجم 12 (24 نصف نقطة)
doc_content = re.sub(
    r'(<w:r[^>]*>.*?' + pattern + r'.*?<w:sz w:val=")[^"]*(")',
    r'\g<1>24\g<2>',
    doc_content
)
```

## 📊 مراقبة الجودة

### مؤشرات النجاح
- ✅ تثبيت خط Arial المحلي
- ✅ تحليل أحجام الخطوط
- ✅ تطبيق الأحجام المحددة
- ✅ حفظ التنسيق الأصلي
- ✅ جودة PDF عالية

### التحقق من النتائج
```python
# فحص الخط المستخدم
fc-list | grep Arial

# فحص ملف PDF
python -c "
import fitz
doc = fitz.open('output.pdf')
for page in doc:
    text_dict = page.get_text('dict')
    # فحص أحجام الخطوط
"
```

## 🐛 استكشاف الأخطاء

### مشاكل شائعة

1. **خط Arial غير موجود**
   ```bash
   # تأكد من وجود الملف
   ls -la fonts/arial.ttf
   ```

2. **أحجام خطوط خاطئة**
   ```python
   # فحص تحليل الخطوط
   from app import analyze_template_font_sizes
   mapping = analyze_template_font_sizes('template.docx')
   print(mapping)
   ```

3. **فشل التحويل**
   ```bash
   # فحص LibreOffice
   libreoffice --version
   
   # فحص الخطوط المتاحة
   fc-list | grep -i arial
   ```

## 📈 تحسينات مستقبلية

- [ ] دعم خطوط إضافية
- [ ] واجهة لتخصيص أحجام الخطوط
- [ ] معاينة مباشرة للتغييرات
- [ ] تصدير إعدادات الخطوط

## 📞 الدعم

للحصول على المساعدة:
1. تشغيل ملف الاختبار أولاً
2. فحص رسائل الخطأ
3. التأكد من وجود جميع الملفات المطلوبة
4. مراجعة هذا الدليل

---

**ملاحظة**: هذا النظام مصمم خصيصاً لملف `template.docx` مع المواصفات المحددة. للملفات الأخرى، قد تحتاج إلى تعديل إعدادات أحجام الخطوط.