| # 📄 دليل الاستخدام - محول 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. الاستخدام المحلي | |
| ```bash | |
| # تثبيت التبعيات | |
| 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. تأكد من أن الملف ليس محمي بكلمة مرور | |
| ## 🎯 أمثلة ناجحة | |
| هذا المحول تم اختباره بنجاح مع: | |
| - ✅ تقارير عربية معقدة مع جداول | |
| - ✅ رسائل رسمية بالعربية | |
| - ✅ مستندات أكاديمية مختلطة (عربي/إنجليزي) | |
| - ✅ نماذج تعبئة بقوالب ديناميكية | |
| - ✅ مستندات بصور وجداول معقدة | |