pdf / ARABIC_USAGE_GUIDE.md
fokan's picture
Upload 35 files
86fce4f verified

📄 دليل الاستخدام - محول DOCX إلى PDF للعربية

🎯 نظرة عامة

هذا المحول مصمم خصيصاً لحل المشاكل الشائعة في تحويل المستندات العربية من Word إلى PDF مع الحفاظ الكامل على التنسيق.

✅ المشاكل التي تم حلها

1. ❌ تراكب النصوص العربية

المشكلة: النصوص العربية تتداخل أو تفقد المسافات الصحيحة الحل:

  • تحسين إعدادات الخطوط العربية
  • ضبط المسافات والتباعد بدقة
  • استخدام خطوط Amiri و Noto Naskh Arabic المحسنة

2. ❌ فقدان المحاذاة اليمنى (RTL)

المشكلة: النص العربي يظهر من اليسار لليمين بدلاً من اليمين لليسار الحل:

  • تفعيل دعم CTL (Complex Text Layout)
  • إعداد اتجاه النص الافتراضي إلى RTL
  • تحسين إعدادات اللغة العربية

3. ❌ استبدال الخطوط العربية

المشكلة: الخطوط العربية الأصلية تُستبدل بخطوط لا تدعم العربية الحل:

  • تثبيت خطوط عربية عالية الجودة (Amiri, Noto Naskh, Scheherazade)
  • إعداد قواعد استبدال الخطوط المحسنة
  • تضمين الخطوط في ملف PDF النهائي

4. ❌ تشوه الجداول

المشكلة: الجداول تفقد تنسيقها أو تتشوه أثناء التحويل الحل:

  • إعدادات خاصة للجداول مع الحفاظ على الأبعاد
  • منع التغييرات التلقائية في الخط العريض
  • الحفاظ على حدود الخلايا والمحاذاة

5. ❌ تغيير مواقع قوالب التعبئة

المشكلة: قوالب مثل {{name}} و {{date}} تتحرك من مواقعها الحل:

  • تعطيل الاستبدال التلقائي للنصوص
  • الحفاظ على المواقع الدقيقة للعناصر
  • منع إعادة التدفق التلقائي للنص

6. ❌ حجم الصفحة غير مناسب للطباعة

المشكلة: ملف PDF لا يطبع بشكل صحيح على ورق A4 الحل:

  • ضبط أبعاد الصفحة بدقة لورق A4
  • تحسين الهوامش للطباعة المثلى
  • ضمان التوافق مع معايير الطباعة

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

1. الاستخدام عبر الواجهة

  1. افتح الرابط في المتصفح
  2. اضغط على "Upload DOCX File"
  3. اختر ملف Word العربي
  4. انتظر التحويل (قد يستغرق دقائق للملفات المعقدة)
  5. حمل ملف PDF المحول

2. الاستخدام المحلي

# تثبيت التبعيات
pip install -r requirements.txt

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

# اختبار التحويل
python test_conversion.py

📋 نصائح للحصول على أفضل النتائج

✅ إعداد ملف Word الأصلي

  • استخدم خطوط عربية معيارية (Traditional Arabic, Arabic Typesetting)
  • تأكد من ضبط اتجاه النص إلى RTL
  • تجنب الخطوط النادرة أو المخصصة
  • احفظ الملف بصيغة .docx (ليس .doc)

✅ للجداول

  • استخدم جداول بسيطة بدون دمج معقد للخلايا
  • تجنب الجداول المتداخلة
  • اضبط عرض الأعمدة بوضوح
  • استخدم حدود واضحة للجداول

✅ للصور

  • استخدم صور بدقة عالية (300 DPI أو أكثر)
  • تجنب الصور المضغوطة بشدة
  • اضبط حجم الصور في Word قبل التحويل

✅ للنصوص المختلطة (عربي/إنجليزي)

  • اضبط اتجاه كل فقرة حسب اللغة
  • استخدم خطوط تدعم كلا اللغتين
  • تجنب الخلط في نفس السطر إذا أمكن

🔧 استكشاف الأخطاء وإصلاحها

مشكلة: النص العربي يظهر مقطع أو مشوه

الحل:

  • تأكد من أن الملف محفوظ بترميز UTF-8
  • جرب خط عربي مختلف في Word
  • تأكد من تفعيل دعم اللغات المعقدة في Word

مشكلة: الجداول تظهر مشوهة

الحل:

  • بسط تصميم الجدول
  • تجنب دمج الخلايا المعقد
  • اضبط عرض الجدول ليناسب الصفحة

مشكلة: حجم الملف كبير جداً

الحل:

  • ضغط الصور في Word قبل التحويل
  • تجنب الصور عالية الدقة غير الضرورية
  • استخدم تنسيقات صور محسنة (JPEG بدلاً من PNG للصور)

مشكلة: التحويل يستغرق وقت طويل

الحل:

  • قسم المستند الكبير إلى أجزاء أصغر
  • أزل العناصر غير الضرورية
  • تأكد من استقرار اتصال الإنترنت

📞 الدعم الفني

إذا واجهت مشاكل لم تُحل بالطرق أعلاه:

  1. تأكد من أن ملف Word يفتح بشكل صحيح في Microsoft Word
  2. جرب تحويل ملف أبسط أولاً للتأكد من عمل النظام
  3. تحقق من حجم الملف (يُفضل أقل من 50 ميجابايت)
  4. تأكد من أن الملف ليس محمي بكلمة مرور

🎯 أمثلة ناجحة

هذا المحول تم اختباره بنجاح مع:

  • ✅ تقارير عربية معقدة مع جداول
  • ✅ رسائل رسمية بالعربية
  • ✅ مستندات أكاديمية مختلطة (عربي/إنجليزي)
  • ✅ نماذج تعبئة بقوالب ديناميكية
  • ✅ مستندات بصور وجداول معقدة