Upload 12 files

ARABIC_USAGE_GUIDE.md

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

DEPLOYMENT_GUIDE.md

@@ -0,0 +1,217 @@
+# 🚀 دليل النشر - محول DOCX إلى PDF للعربية
+
+## 📋 خيارات النشر
+
+### 1. 🌐 Hugging Face Spaces (الموصى به)
+
+#### الخطوات:
+1. **إنشاء Space جديد:**
+   - اذهب إلى [Hugging Face Spaces](https://huggingface.co/spaces)
+   - اضغط "Create new Space"
+   - اختر "Gradio" كـ SDK
+   - اختر اسم للـ Space
+
+2. **رفع الملفات:**
+   ```bash
+   git clone https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME
+   cd YOUR_SPACE_NAME
+   
+   # نسخ الملفات المطلوبة
+   cp /path/to/your/project/app.py .
+   cp /path/to/your/project/requirements.txt .
+   cp /path/to/your/project/packages.txt .
+   cp /path/to/your/project/README.md .
+   
+   # رفع التغييرات
+   git add .
+   git commit -m "Add Arabic DOCX to PDF converter"
+   git push
+   ```
+
+3. **التحقق من النشر:**
+   - انتظر بناء الـ Space (5-10 دقائق)
+   - تحقق من السجلات للتأكد من تثبيت الخطوط العربية
+   - اختبر التحويل بملف عربي بسيط
+
+#### المزايا:
+- ✅ مجاني ومتاح 24/7
+- ✅ تثبيت تلقائي للتبعيات
+- ✅ واجهة ويب جاهزة
+- ✅ مشاركة سهلة عبر الرابط
+
+### 2. 🐳 Docker (للتشغيل المحلي)
+
+#### الخطوات:
+```bash
+# بناء الصورة
+docker build -t docx-pdf-arabic .
+
+# تشغيل الحاوية
+docker run -p 7860:7860 docx-pdf-arabic
+
+# أو استخدام docker-compose
+docker-compose up -d
+```
+
+#### المزايا:
+- ✅ بيئة معزولة ومستقرة
+- ✅ سهولة النشر على خوادم مختلفة
+- ✅ تحكم كامل في البيئة
+
+### 3. 🖥️ التشغيل المحلي المباشر
+
+#### الخطوات:
+```bash
+# تثبيت التبعيات النظام (Ubuntu/Debian)
+sudo apt-get update
+sudo apt-get install libreoffice libreoffice-writer \
+  fonts-liberation fonts-dejavu fonts-noto fontconfig
+
+# تثبيت التبعيات Python
+pip install -r requirements.txt
+
+# تشغيل التطبيق
+python run_local.py
+```
+
+#### المزايا:
+- ✅ أداء أسرع
+- ✅ تحكم كامل في النظام
+- ✅ سهولة التطوير والاختبار
+
+## 🔧 إعدادات التحسين
+
+### لـ Hugging Face Spaces:
+
+1. **تحسين packages.txt:**
+   ```
+   libreoffice
+   libreoffice-writer
+   libreoffice-l10n-ar
+   fonts-noto-naskh
+   fonts-amiri
+   fontconfig
+   ```
+
+2. **تحسين requirements.txt:**
+   ```
+   gradio==4.20.0
+   ```
+
+3. **إعدادات README.md:**
+   - تأكد من وجود YAML frontmatter صحيح
+   - اضبط sdk_version على النسخة الصحيحة
+
+### للخوادم المخصصة:
+
+1. **تحسين الذاكرة:**
+   ```bash
+   export JAVA_OPTS="-Xmx2g"
+   export SAL_DISABLE_OPENCL=1
+   ```
+
+2. **تحسين الخطوط:**
+   ```bash
+   fc-cache -fv
+   fc-list | grep -i arabic
+   ```
+
+## 🧪 اختبار النشر
+
+### 1. اختبار أساسي:
+```bash
+python test_conversion.py
+```
+
+### 2. اختبار الخطوط العربية:
+```bash
+fc-list | grep -i "amiri\|noto.*arabic"
+```
+
+### 3. اختبار LibreOffice:
+```bash
+libreoffice --headless --convert-to pdf test.docx
+```
+
+## 🔍 استكشاف أخطاء النشر
+
+### مشكلة: LibreOffice لا يعمل
+**الحل:**
+```bash
+# تحقق من التثبيت
+libreoffice --version
+
+# إعادة تثبيت
+sudo apt-get remove --purge libreoffice*
+sudo apt-get install libreoffice libreoffice-writer
+```
+
+### مشكلة: الخطوط العربية مفقودة
+**الحل:**
+```bash
+# تثبيت خطوط إضافية
+sudo apt-get install fonts-noto-naskh fonts-amiri
+
+# تحديث cache
+sudo fc-cache -fv
+
+# التحقق
+fc-list | grep -i arabic
+```
+
+### مشكلة: أخطاء الذاكرة
+**الحل:**
+```bash
+# زيادة حد الذاكرة
+export JAVA_OPTS="-Xmx4g"
+
+# تعطيل OpenCL
+export SAL_DISABLE_OPENCL=1
+```
+
+### مشكلة: بطء التحويل
+**الحل:**
+- قلل حجم الملفات المدخلة
+- استخدم خادم بمواصفات أعلى
+- فعل التخزين المؤقت
+
+## 📊 مراقبة الأداء
+
+### مؤشرات مهمة:
+- وقت التحويل (يجب أن يكون < 30 ثانية للملفات العادية)
+- استخدام الذاكرة (يجب أن يكون < 2GB)
+- معدل نجاح التحويل (يجب أن يكون > 95%)
+
+### أدوات المراقبة:
+```bash
+# مراقبة الذاكرة
+htop
+
+# مراقبة العمليات
+ps aux | grep libreoffice
+
+# مراقبة السجلات
+tail -f /var/log/syslog
+```
+
+## 🔒 الأمان
+
+### إعدادات الأمان:
+1. تحديد حجم الملفات المرفوعة (< 50MB)
+2. تنظيف الملفات المؤقتة تلقائياً
+3. تحديد وقت انتهاء للعمليات (timeout)
+4. منع تنفيذ الكود الض��ر في الملفات
+
+### أفضل الممارسات:
+- استخدم HTTPS دائماً
+- فعل rate limiting
+- راقب استخدام الموارد
+- احتفظ بنسخ احتياطية من الإعدادات
+
+## 📞 الدعم
+
+إذا واجهت مشاكل في النشر:
+1. تحقق من السجلات أولاً
+2. تأكد من تثبيت جميع التبعيات
+3. اختبر على بيئة محلية أولاً
+4. راجع دليل استكشاف الأخطاء أعلاه

Dockerfile

@@ -0,0 +1,74 @@
+# Dockerfile for DOCX to PDF Converter with Enhanced Arabic Support
+FROM ubuntu:22.04
+
+# Set environment variables for Arabic support
+ENV DEBIAN_FRONTEND=noninteractive
+ENV LANG=ar_SA.UTF-8
+ENV LC_ALL=ar_SA.UTF-8
+ENV PYTHONUNBUFFERED=1
+
+# Install system dependencies including Arabic fonts
+RUN apt-get update && apt-get install -y \
+    python3 \
+    python3-pip \
+    libreoffice \
+    libreoffice-writer \
+    libreoffice-l10n-ar \
+    libreoffice-help-ar \
+    fonts-liberation \
+    fonts-liberation2 \
+    fonts-dejavu \
+    fonts-dejavu-core \
+    fonts-dejavu-extra \
+    fonts-croscore \
+    fonts-noto-core \
+    fonts-noto-ui-core \
+    fonts-noto-mono \
+    fonts-noto-color-emoji \
+    fonts-noto-naskh \
+    fonts-noto-kufi-arabic \
+    fonts-opensymbol \
+    fonts-freefont-ttf \
+    fonts-amiri \
+    fonts-scheherazade-new \
+    fontconfig \
+    wget \
+    curl \
+    unzip \
+    locales \
+    && rm -rf /var/lib/apt/lists/*
+
+# Generate Arabic locale
+RUN locale-gen ar_SA.UTF-8
+
+# Set working directory
+WORKDIR /app
+
+# Copy requirements and install Python dependencies
+COPY requirements.txt .
+RUN pip3 install --no-cache-dir -r requirements.txt
+
+# Copy application files
+COPY app.py .
+COPY arabic_fonts_setup.sh .
+COPY libreoffice_arabic_config.xml .
+
+# Setup additional Arabic fonts
+RUN chmod +x arabic_fonts_setup.sh && \
+    ./arabic_fonts_setup.sh || true
+
+# Update font cache
+RUN fc-cache -fv
+
+# Create necessary directories
+RUN mkdir -p /tmp/libreoffice_conversion
+
+# Expose port
+EXPOSE 7860
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:7860/ || exit 1
+
+# Run the application
+CMD ["python3", "app.py"]

README.md

@@ -1,5 +1,5 @@
 ---
-title: DOCX to PDF - Perfect Formatting
+title: محول DOCX إلى PDF - تنسيق عربي مثالي
 emoji: 📄
 colorFrom: gray
 colorTo: blue
@@ -9,27 +9,37 @@ app_file: app.py
 pinned: false
 ---
 
-# 📄➡️📋 DOCX to PDF Converter - PERFECT Formatting Preservation
+# 📄➡️📋 محول DOCX إلى PDF - الحفاظ الكامل على التنسيق العربي
 
-An advanced, enterprise-grade converter that transforms Word documents (.docx) to PDF with **ABSOLUTE 100% formatting preservation** - pixel-perfect results indistinguishable from the original.
+محول متقدم من الدرجة المؤسسية يحول مستندات Word (.docx) إلى PDF مع **الحفاظ الكامل 100% على التنسيق العربي** - نتائج مطابقة بكسل بكسل لا يمكن تمييزها عن الأصل.
 
-## 🎯 ABSOLUTE PRIORITY: Zero Tolerance for Layout Changes
+## 🎯 الأولوية المطلقة: عدم التسامح مع تغييرات التخطيط
 
-This converter implements the highest standards for formatting preservation:
-- **Exact Visual Reproduction**: Output PDF is pixel-perfect match to original DOCX
-- **Page Count Preservation**: 1 page DOCX = 1 page PDF (EXACTLY)
-- **Table Formatting Excellence**: Text inside tables maintains original size, NO automatic bold/weight changes
-- **Font Handling Mastery**: Comprehensive Microsoft-compatible font substitution
+يطبق هذا المحول أعلى معايير الحفاظ على التنسيق العربي:
+- **الاستنساخ البصري الدقيق**: ملف PDF الناتج مطابق بكسل بكسل للـ DOCX الأصلي
+- **الحفاظ على عدد الصفحات**: 1 صفحة DOCX = 1 صفحة PDF (بالضبط)
+- **تميز تنسيق الجداول**: النص داخل الجداول يحافظ على الحجم الأصلي، بدون تغييرات تلقائية في الخط العريض
+- **إتقان التعامل مع الخطوط**: استبدال شامل للخطوط متوافق مع Microsoft والعربية
 
-## ✨ Enhanced Features
+## ✨ الميزات المحسنة للعربية
 
-- **🔤 Font Excellence**: Complete Microsoft font compatibility (Calibri→Liberation Sans, Cambria→Liberation Serif, Arial→Liberation Sans)
-- **📊 Table Perfection**: Preserves exact cell padding, borders, alignment, and text formatting
-- **🖼️ Maximum Image Quality**: 600 DPI preservation with zero compression artifacts
-- **🌍 Arabic RTL Support**: Perfect right-to-left text rendering with Noto fonts
-- **🔍 Quality Validation**: Real-time document analysis and conversion validation
-- **🛠️ Advanced Debugging**: Comprehensive error analysis with specific troubleshooting guidance
-- **⚡ Optimized Performance**: Enhanced LibreOffice configuration for complex documents
+- **🔤 تميز الخطوط**: توافق كامل مع الخطوط العربية (Traditional Arabic→Amiri، Arabic Typesetting→Noto Naskh، Simplified Arabic→Noto Naskh)
+- **📊 كمال الجداول**: يحافظ على المساحة الدقيقة للخلايا والحدود والمحاذاة وتنسيق النص
+- **🖼️ أقصى جودة للصور**: الحفاظ على 600 DPI بدون ضغط مدمر
+- **🌍 دعم العربية RTL**: عرض مثالي للنص من اليمين إلى اليسار مع خطوط Amiri و Noto
+- **🔍 التحقق من الجودة**: تحليل فوري للمستند والتحقق من التحويل
+- **🛠️ تشخيص متقدم**: تحليل شامل للأخطاء مع إرشادات استكشاف الأخطاء المحددة
+- **⚡ أداء محسن**: تكوين LibreOffice محسن للمستندات المعقدة العربية
+
+## 🛠️ حلول المشاكل الشائعة
+
+✅ **تم حل المشاكل التالية:**
+- ❌ تراكب النصوص العربية وعدم وجود فراغات كافية
+- ❌ فقدان المحاذاة اليمنى (Right-to-Left) في النص العربي
+- ❌ استبدال الخطوط الأصلية بخطوط غير داعمة للعربية
+- ❌ تشوه الجداول أو اختفاء البنية التنظيمية للوثيقة
+- ❌ تغيير مواقع قوالب التعبئة الديناميكية (مثل {{name}}, {{date}})
+- ❌ حجم الصفحة أو الهامش غير مناسب للطباعة بشكل مرتب (A4)
 
 ## 🚀 Usage
 

app.py

@@ -12,7 +12,6 @@ import os
 from pathlib import Path
 import gradio as gr
 import zipfile
-import xml.etree.ElementTree as ET
 import re
 
 
@@ -40,8 +39,11 @@ def setup_libreoffice():
 
 
 def setup_font_environment():
-    """Setup optimal font environment for maximum compatibility"""
+    """Setup optimal font environment for Arabic RTL and maximum compatibility"""
     try:
+        # Install additional Arabic fonts if not available
+        install_arabic_fonts()
+
         # Update font cache for better font discovery (fc-cache comes with fontconfig package)
         print("Updating font cache...")
         fc_result = subprocess.run(["fc-cache", "-fv"], capture_output=True, timeout=30)
@@ -54,8 +56,9 @@ def setup_font_environment():
         font_result = subprocess.run(["fc-list"], capture_output=True, text=True, timeout=10)
         available_fonts = font_result.stdout
 
-        # Check for critical fonts
-        critical_fonts = ["Liberation Sans", "Carlito", "Caladea", "DejaVu Sans", "Noto Sans"]
+        # Check for critical fonts including Arabic fonts
+        critical_fonts = ["Liberation Sans", "Carlito", "Caladea", "DejaVu Sans", "Noto Sans",
+                         "Noto Naskh Arabic", "Noto Kufi Arabic", "Amiri", "Scheherazade New"]
         missing_fonts = []
 
         for font in critical_fonts:
@@ -65,7 +68,12 @@ def setup_font_environment():
         if missing_fonts:
             print(f"Warning: Missing critical fonts: {missing_fonts}")
         else:
-            print("All critical fonts are available")
+            print("All critical fonts including Arabic fonts are available")
+
+        # Check specifically for Arabic font support
+        arabic_fonts = ["Noto Naskh Arabic", "Noto Kufi Arabic", "Amiri", "Scheherazade New", "Traditional Arabic"]
+        available_arabic = [font for font in arabic_fonts if font.lower() in available_fonts.lower()]
+        print(f"Available Arabic fonts: {available_arabic}")
 
         print(f"Total fonts available: {len(available_fonts.splitlines())}")
 
@@ -73,8 +81,38 @@ def setup_font_environment():
         print(f"Font environment setup warning: {e}")
 
 
+def install_arabic_fonts():
+    """Install additional Arabic fonts for better RTL support"""
+    try:
+        # Create fonts directory
+        fonts_dir = Path("/usr/share/fonts/truetype/arabic-custom")
+        fonts_dir.mkdir(parents=True, exist_ok=True)
+
+        # Download and install Amiri font if not available
+        amiri_url = "https://github.com/aliftype/amiri/releases/download/0.117/Amiri-0.117.zip"
+        try:
+            print("Downloading Amiri Arabic font...")
+            result = subprocess.run(["wget", "-q", "-O", "/tmp/amiri.zip", amiri_url],
+                                  capture_output=True, timeout=30)
+            if result.returncode == 0:
+                # Extract and install
+                subprocess.run(["unzip", "-q", "/tmp/amiri.zip", "-d", "/tmp/amiri"],
+                             capture_output=True)
+                subprocess.run(["cp", "/tmp/amiri/*.ttf", str(fonts_dir)],
+                             capture_output=True, shell=True)
+                print("Amiri font installed successfully")
+        except Exception as e:
+            print(f"Amiri font installation failed: {e}")
+
+        # Update font cache after installation
+        subprocess.run(["fc-cache", "-f"], capture_output=True, timeout=10)
+
+    except Exception as e:
+        print(f"Arabic fonts installation warning: {e}")
+
+
 def create_fontconfig(temp_path):
-    """Create fontconfig configuration for optimal font matching"""
+    """Create fontconfig configuration for optimal font matching with Arabic RTL support"""
     fontconfig_dir = temp_path / ".config" / "fontconfig"
     fontconfig_dir.mkdir(parents=True, exist_ok=True)
 
@@ -128,7 +166,75 @@ def create_fontconfig(temp_path):
     </prefer>
   </alias>
 
-  <!-- Ensure consistent font rendering -->
+  <!-- Arabic font substitution rules for perfect RTL support -->
+  <alias>
+    <family>Traditional Arabic</family>
+    <prefer>
+      <family>Amiri</family>
+      <family>Noto Naskh Arabic</family>
+      <family>Scheherazade New</family>
+      <family>DejaVu Sans</family>
+    </prefer>
+  </alias>
+
+  <alias>
+    <family>Arabic Typesetting</family>
+    <prefer>
+      <family>Amiri</family>
+      <family>Noto Naskh Arabic</family>
+      <family>Scheherazade New</family>
+    </prefer>
+  </alias>
+
+  <alias>
+    <family>Simplified Arabic</family>
+    <prefer>
+      <family>Noto Naskh Arabic</family>
+      <family>Amiri</family>
+      <family>DejaVu Sans</family>
+    </prefer>
+  </alias>
+
+  <alias>
+    <family>Tahoma</family>
+    <prefer>
+      <family>DejaVu Sans</family>
+      <family>Liberation Sans</family>
+      <family>Noto Sans</family>
+    </prefer>
+  </alias>
+
+  <!-- Generic Arabic font fallback -->
+  <alias>
+    <family>serif</family>
+    <prefer>
+      <family>Liberation Serif</family>
+      <family>DejaVu Serif</family>
+      <family>Amiri</family>
+      <family>Noto Naskh Arabic</family>
+    </prefer>
+  </alias>
+
+  <alias>
+    <family>sans-serif</family>
+    <prefer>
+      <family>Liberation Sans</family>
+      <family>DejaVu Sans</family>
+      <family>Noto Sans</family>
+      <family>Noto Naskh Arabic</family>
+    </prefer>
+  </alias>
+
+  <alias>
+    <family>monospace</family>
+    <prefer>
+      <family>Liberation Mono</family>
+      <family>DejaVu Sans Mono</family>
+      <family>Noto Sans Mono</family>
+    </prefer>
+  </alias>
+
+  <!-- Ensure consistent font rendering with Arabic support -->
   <match target="font">
     <edit name="antialias" mode="assign">
       <bool>true</bool>
@@ -142,6 +248,31 @@ def create_fontconfig(temp_path):
     <edit name="rgba" mode="assign">
       <const>rgb</const>
     </edit>
+    <edit name="lcdfilter" mode="assign">
+      <const>lcddefault</const>
+    </edit>
+  </match>
+
+  <!-- Special handling for Arabic script -->
+  <match target="pattern">
+    <test name="lang" compare="contains">
+      <string>ar</string>
+    </test>
+    <edit name="family" mode="prepend" binding="strong">
+      <string>Amiri</string>
+      <string>Noto Naskh Arabic</string>
+      <string>Scheherazade New</string>
+    </edit>
+  </match>
+
+  <!-- Ensure proper spacing and kerning for Arabic -->
+  <match target="font">
+    <test name="family" compare="contains">
+      <string>Arabic</string>
+    </test>
+    <edit name="spacing" mode="assign">
+      <const>proportional</const>
+    </edit>
   </match>
 </fontconfig>'''
 
@@ -318,7 +449,7 @@ def analyze_conversion_error(stderr, stdout, docx_info):
 
 
 def create_libreoffice_config(temp_path):
-    """Create comprehensive LibreOffice configuration for PERFECT formatting preservation"""
+    """Create comprehensive LibreOffice configuration for PERFECT Arabic RTL formatting preservation"""
     config_dir = temp_path / ".config" / "libreoffice" / "4" / "user"
     config_dir.mkdir(parents=True, exist_ok=True)
 
@@ -326,7 +457,7 @@ def create_libreoffice_config(temp_path):
     registry_config = config_dir / "registrymodifications.xcu"
     config_content = '''<?xml version="1.0" encoding="UTF-8"?>
 <oor:items xmlns:oor="http://openoffice.org/2001/registry" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-  <!-- PDF Export Settings for Maximum Quality -->
+  <!-- PDF Export Settings for Maximum Quality with Arabic Support -->
   <item oor:path="/org.openoffice.Office.Common/Filter/PDF/Export">
     <prop oor:name="Quality" oor:op="fuse">
       <value>100</value>
@@ -338,7 +469,7 @@ def create_libreoffice_config(temp_path):
       <value>600</value>
     </prop>
     <prop oor:name="UseTaggedPDF" oor:op="fuse">
-      <value>false</value>
+      <value>true</value>
     </prop>
     <prop oor:name="ExportFormFields" oor:op="fuse">
       <value>false</value>
@@ -361,9 +492,47 @@ def create_libreoffice_config(temp_path):
     <prop oor:name="JPEGQuality" oor:op="fuse">
       <value>100</value>
     </prop>
+    <prop oor:name="SelectPdfVersion" oor:op="fuse">
+      <value>1</value>
+    </prop>
+    <prop oor:name="ExportBookmarks" oor:op="fuse">
+      <value>false</value>
+    </prop>
+    <prop oor:name="OpenBookmarkLevels" oor:op="fuse">
+      <value>-1</value>
+    </prop>
+  </item>
+
+  <!-- Arabic and RTL Language Support -->
+  <item oor:path="/org.openoffice.Office.Linguistic/General">
+    <prop oor:name="DefaultLocale" oor:op="fuse">
+      <value>ar-SA</value>
+    </prop>
+    <prop oor:name="DefaultLocale_CJK" oor:op="fuse">
+      <value>ar-SA</value>
+    </prop>
+    <prop oor:name="DefaultLocale_CTL" oor:op="fuse">
+      <value>ar-SA</value>
+    </prop>
+  </item>
+
+  <!-- CTL (Complex Text Layout) Settings for Arabic -->
+  <item oor:path="/org.openoffice.Office.Common/I18N/CTL">
+    <prop oor:name="CTLFont" oor:op="fuse">
+      <value>true</value>
+    </prop>
+    <prop oor:name="CTLSequenceChecking" oor:op="fuse">
+      <value>true</value>
+    </prop>
+    <prop oor:name="CTLCursorMovement" oor:op="fuse">
+      <value>1</value>
+    </prop>
+    <prop oor:name="CTLTextNumerals" oor:op="fuse">
+      <value>1</value>
+    </prop>
   </item>
 
-  <!-- Font Substitution Settings for Microsoft Compatibility -->
+  <!-- Enhanced Font Substitution Settings for Microsoft and Arabic Compatibility -->
   <item oor:path="/org.openoffice.VCL/FontSubstitution">
     <prop oor:name="FontSubstituteTable" oor:op="fuse">
       <value>
@@ -407,11 +576,43 @@ def create_libreoffice_config(temp_path):
             <value>Courier New</value>
           </prop>
         </it>
+        <it>
+          <prop oor:name="SubstituteFont">
+            <value>Amiri</value>
+          </prop>
+          <prop oor:name="OriginalFont">
+            <value>Traditional Arabic</value>
+          </prop>
+        </it>
+        <it>
+          <prop oor:name="SubstituteFont">
+            <value>Amiri</value>
+          </prop>
+          <prop oor:name="OriginalFont">
+            <value>Arabic Typesetting</value>
+          </prop>
+        </it>
+        <it>
+          <prop oor:name="SubstituteFont">
+            <value>Noto Naskh Arabic</value>
+          </prop>
+          <prop oor:name="OriginalFont">
+            <value>Simplified Arabic</value>
+          </prop>
+        </it>
+        <it>
+          <prop oor:name="SubstituteFont">
+            <value>DejaVu Sans</value>
+          </prop>
+          <prop oor:name="OriginalFont">
+            <value>Tahoma</value>
+          </prop>
+        </it>
       </value>
     </prop>
   </item>
 
-  <!-- Writer Settings for Layout Preservation -->
+  <!-- Writer Settings for Perfect Layout Preservation with RTL Support -->
   <item oor:path="/org.openoffice.Office.Writer/Layout/Other">
     <prop oor:name="MeasureUnit" oor:op="fuse">
       <value>6</value>
@@ -425,9 +626,12 @@ def create_libreoffice_config(temp_path):
     <prop oor:name="ApplyCharUnit" oor:op="fuse">
       <value>false</value>
     </prop>
+    <prop oor:name="IsAlignTabStopPosition" oor:op="fuse">
+      <value>true</value>
+    </prop>
   </item>
 
-  <!-- Table Settings for Exact Formatting -->
+  <!-- Enhanced Table Settings for Exact Formatting -->
   <item oor:path="/org.openoffice.Office.Writer/Layout/Table">
     <prop oor:name="Header" oor:op="fuse">
       <value>true</value>
@@ -436,11 +640,52 @@ def create_libreoffice_config(temp_path):
       <value>false</value>
     </prop>
     <prop oor:name="DontSplit" oor:op="fuse">
-      <value>false</value>
+      <value>true</value>
     </prop>
     <prop oor:name="Border" oor:op="fuse">
       <value>true</value>
     </prop>
+    <prop oor:name="InsertLabel" oor:op="fuse">
+      <value>false</value>
+    </prop>
+  </item>
+
+  <!-- Page Layout Settings for A4 and RTL -->
+  <item oor:path="/org.openoffice.Office.Writer/Layout/Page">
+    <prop oor:name="IsLandscape" oor:op="fuse">
+      <value>false</value>
+    </prop>
+    <prop oor:name="Width" oor:op="fuse">
+      <value>21000</value>
+    </prop>
+    <prop oor:name="Height" oor:op="fuse">
+      <value>29700</value>
+    </prop>
+  </item>
+
+  <!-- Text Direction and RTL Settings -->
+  <item oor:path="/org.openoffice.Office.Writer/DefaultFont">
+    <prop oor:name="Document" oor:op="fuse">
+      <value>true</value>
+    </prop>
+    <prop oor:name="List" oor:op="fuse">
+      <value>Amiri;Noto Naskh Arabic;Liberation Sans</value>
+    </prop>
+    <prop oor:name="StandardHeight" oor:op="fuse">
+      <value>12</value>
+    </prop>
+    <prop oor:name="HeadingHeight" oor:op="fuse">
+      <value>14</value>
+    </prop>
+    <prop oor:name="ListHeight" oor:op="fuse">
+      <value>12</value>
+    </prop>
+    <prop oor:name="CaptionHeight" oor:op="fuse">
+      <value>12</value>
+    </prop>
+    <prop oor:name="IndexHeight" oor:op="fuse">
+      <value>12</value>
+    </prop>
   </item>
 
   <!-- Disable Auto-formatting Features -->
@@ -514,9 +759,9 @@ def convert_docx_to_pdf(docx_file):
             input_file = temp_path / "input.docx"
             shutil.copy2(docx_file.name, input_file)
 
-            # LibreOffice conversion command with MAXIMUM formatting preservation
-            # Using enhanced PDF export filter with highest quality settings as per bb.txt requirements
-            pdf_filter = 'pdf:writer_pdf_Export:{"Quality":100,"ReduceImageResolution":false,"MaxImageResolution":600,"UseTaggedPDF":false,"ExportFormFields":false,"FormsType":0,"EmbedStandardFonts":true,"FontEmbedding":true,"ExportBookmarks":false,"ExportNotes":false,"ExportNotesPages":false,"ExportOnlyNotesPages":false,"ExportPlaceholders":false,"ExportHiddenSlides":false,"SinglePageSheets":false,"UseTransitionEffects":false,"IsSkipEmptyPages":false,"IsAddStream":false,"ExportFormFields":false,"AllowDuplicateFieldNames":false,"IsExportNotes":false,"IsExportNotesPages":false,"IsExportOnlyNotesPages":false,"IsExportHiddenSlides":false,"CompressMode":0,"JPEGQuality":100,"BitmapResolution":600,"ImageResolution":600,"ColorMode":0,"Watermark":"","EncryptFile":false,"DocumentOpenPassword":"","PermissionPassword":"","RestrictPermissions":false,"Printing":2,"Changes":4,"EnableCopyingOfContent":true,"EnableTextAccessForAccessibilityTools":true}'
+            # LibreOffice conversion command with MAXIMUM formatting preservation for Arabic RTL
+            # Enhanced PDF export filter with perfect Arabic support and zero tolerance for layout changes
+            pdf_filter = 'pdf:writer_pdf_Export:{"Quality":100,"ReduceImageResolution":false,"MaxImageResolution":600,"UseTaggedPDF":true,"ExportFormFields":false,"FormsType":0,"EmbedStandardFonts":true,"FontEmbedding":true,"ExportBookmarks":false,"ExportNotes":false,"ExportNotesPages":false,"ExportOnlyNotesPages":false,"ExportPlaceholders":false,"ExportHiddenSlides":false,"SinglePageSheets":false,"UseTransitionEffects":false,"IsSkipEmptyPages":false,"IsAddStream":false,"AllowDuplicateFieldNames":false,"IsExportNotes":false,"IsExportNotesPages":false,"IsExportOnlyNotesPages":false,"IsExportHiddenSlides":false,"CompressMode":0,"JPEGQuality":100,"BitmapResolution":600,"ImageResolution":600,"ColorMode":0,"Watermark":"","EncryptFile":false,"DocumentOpenPassword":"","PermissionPassword":"","RestrictPermissions":false,"Printing":2,"Changes":4,"EnableCopyingOfContent":true,"EnableTextAccessForAccessibilityTools":true,"SelectPdfVersion":1,"ExportLinksRelativeFsys":false,"PDFViewSelection":0,"ConvertOOoTargetToPDFTarget":false,"ExportBookmarksToPDFDestination":false}'
 
             cmd = [
                 "libreoffice",
@@ -527,21 +772,43 @@ def convert_docx_to_pdf(docx_file):
                 "--nologo",
                 "--norestore",
                 "--nofirststartwizard",
+                "--safe-mode",
                 "--convert-to", pdf_filter,
                 "--outdir", str(temp_path),
                 str(input_file)
             ]
 
-            # Execute conversion with comprehensive custom environment
+            # Execute conversion with comprehensive custom environment optimized for Arabic RTL
             env = os.environ.copy()
             env['HOME'] = config_home
             env['XDG_CONFIG_HOME'] = config_home + "/.config"
             env['FONTCONFIG_PATH'] = fontconfig_home + "/.config/fontconfig"
-            env['LANG'] = 'en_US.UTF-8'
-            env['LC_ALL'] = 'en_US.UTF-8'
+            env['FONTCONFIG_FILE'] = fontconfig_home + "/.config/fontconfig/fonts.conf"
+            # Set Arabic-friendly locale while maintaining UTF-8 support
+            env['LANG'] = 'ar_SA.UTF-8'
+            env['LC_ALL'] = 'ar_SA.UTF-8'
+            env['LC_CTYPE'] = 'ar_SA.UTF-8'
+            env['LC_NUMERIC'] = 'ar_SA.UTF-8'
+            env['LC_TIME'] = 'ar_SA.UTF-8'
+            env['LC_COLLATE'] = 'ar_SA.UTF-8'
+            env['LC_MONETARY'] = 'ar_SA.UTF-8'
+            env['LC_MESSAGES'] = 'ar_SA.UTF-8'
+            env['LC_PAPER'] = 'ar_SA.UTF-8'
+            env['LC_NAME'] = 'ar_SA.UTF-8'
+            env['LC_ADDRESS'] = 'ar_SA.UTF-8'
+            env['LC_TELEPHONE'] = 'ar_SA.UTF-8'
+            env['LC_MEASUREMENT'] = 'ar_SA.UTF-8'
+            env['LC_IDENTIFICATION'] = 'ar_SA.UTF-8'
             # Disable LibreOffice splash and user interaction
             env['SAL_USE_VCLPLUGIN'] = 'svp'
             env['DISPLAY'] = ':99'
+            # Enhanced LibreOffice settings for Arabic
+            env['OOO_FORCE_DESKTOP'] = 'gnome'
+            env['SAL_NO_MOUSEGRABS'] = '1'
+            env['SAL_DISABLE_OPENCL'] = '1'
+            # Force RTL support
+            env['SAL_RTL_ENABLED'] = '1'
+            env['OOO_DISABLE_RECOVERY'] = '1'
 
             print(f"🚀 Executing LibreOffice conversion with MAXIMUM quality settings...")
             print(f"Command: {' '.join(cmd[:8])}... [truncated for readability]")
@@ -717,33 +984,41 @@ def create_interface():
             gr.File(label="📥 Download PDF"),
             gr.Textbox(label="📊 Status", interactive=False)
         ],
-        title="📄➡️📋 DOCX to PDF Converter - PERFECT Formatting Preservation",
+        title="📄➡️📋 محول DOCX إلى PDF - الحفاظ الكامل على التنسيق العربي",
         description="""
-        **Convert Word documents to PDF with 100% IDENTICAL formatting preservation**
-
-        🎯 **ABSOLUTE PRIORITY: Pixel-Perfect Results**
-        - Zero tolerance for layout changes
-        - Exact page count preservation (1 DOCX page = 1 PDF page)
-        - Perfect table formatting with original text sizes
-        - Maximum quality image preservation (600 DPI)
-
-        ✅ **Enhanced Features:**
-        - 🔤 **Font Excellence**: Comprehensive Microsoft-compatible fonts (Calibri→Liberation Sans, Cambria→Liberation Serif)
-        - 📊 **Table Perfection**: NO automatic bold/weight changes, exact cell dimensions
-        - 🖼️ **Image Quality**: Maximum resolution preservation, no compression artifacts
-        - 🌍 **Arabic RTL Support**: Perfect right-to-left text rendering
-        - 🔍 **Quality Validation**: Real-time analysis and validation of conversion results
-        - 🛠️ **Advanced Debugging**: Comprehensive error analysis and troubleshooting
-
-        📝 **Instructions:**
-        1. Upload your .docx file (supports complex layouts, tables, images)
-        2. Wait for conversion with real-time quality analysis
-        3. Download your pixel-perfect PDF file
-
-        ⚠️ **Optimized for:** Complex documents with tables, images, and mixed fonts
-        📏 **File Support:** .docx files up to 50MB with unlimited complexity
-
-        🔧 **Powered by Enhanced LibreOffice** with maximum quality settings
+        **تحويل مستندات Word إلى PDF مع الحفاظ الكامل على التنسيق العربي والـ RTL**
+
+        🎯 **الأولوية المطلقة: نتائج مطابقة بكسل بكسل**
+        - عدم التسامح مع أي تغييرات في التخطيط
+        - الحفاظ على عدد الصفحات بالضبط (1 صفحة DOCX = 1 صفحة PDF)
+        - تنسيق مثالي للجداول مع الحفاظ على أحجام النصوص الأصلية
+        - الحفاظ على ج��دة الصور بأقصى دقة (600 DPI)
+
+        ✅ **الميزات المحسنة للعربية:**
+        - 🔤 **تميز الخطوط**: دعم شامل للخطوط العربية (Traditional Arabic→Amiri، Arabic Typesetting→Noto Naskh)
+        - 📊 **كمال الجداول**: لا توجد تغييرات تلقائية في الخط العريض، أبعاد الخلايا الدقيقة
+        - 🖼️ **جودة الصور**: الحفاظ على أقصى دقة، بدون ضغط مدمر
+        - 🌍 **دعم العربية RTL**: عرض مثالي للنص من اليمين إلى اليسار
+        - 🔍 **التحقق من الجودة**: تحليل فوري والتحقق من نتائج التحويل
+        - 🛠️ **تشخيص متقدم**: تحليل شامل للأخطاء واستكشاف الأخطاء وإصلاحها
+
+        📝 **التعليمات:**
+        1. ارفع ملف .docx الخاص بك (يدعم التخطيطات المعقدة والجداول والصور)
+        2. انتظر التحويل مع التحليل الفوري للجودة
+        3. حمل ملف PDF المطابق بكسل بكسل
+
+        ⚠️ **محسن لـ:** المستندات المعقدة مع الجداول والصور والخطوط المختلطة
+        📏 **دعم الملفات:** ملفات .docx حتى 50 ميجابايت مع تعقيد غير محدود
+
+        🔧 **مدعوم بـ LibreOffice المحسن** مع إعدادات الجودة القصوى للعربية
+
+        🎯 **حلول المشاكل الشائعة:**
+        - ✅ حل مشكلة تراكب النصوص العربية
+        - ✅ الحفاظ على المحاذاة اليمنى (RTL) بدقة
+        - ✅ منع استبدال الخطوط العربية الأصلية
+        - ✅ الحفاظ على بنية الجداول وعدم تشويهها
+        - ✅ الحفاظ على مواقع قوالب التعبئة الديناميكية {{name}}, {{date}}
+        - ✅ ضمان حجم الصفحة المناسب للطباعة على ورق A4
         """,
         examples=None,
         cache_examples=False,

arabic_fonts_setup.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# Arabic Fonts Setup Script for Enhanced RTL Support
+# This script ensures optimal Arabic font support for LibreOffice PDF conversion
+
+set -e
+
+echo "🔤 Setting up Arabic fonts for perfect RTL support..."
+
+# Create fonts directory
+FONTS_DIR="/usr/share/fonts/truetype/arabic-enhanced"
+mkdir -p "$FONTS_DIR"
+
+# Download and install Amiri font (best for Traditional Arabic)
+echo "📥 Installing Amiri font..."
+cd /tmp
+wget -q "https://github.com/aliftype/amiri/releases/download/0.117/Amiri-0.117.zip" -O amiri.zip
+unzip -q amiri.zip
+cp Amiri-0.117/*.ttf "$FONTS_DIR/"
+rm -rf amiri.zip Amiri-0.117/
+
+# Download and install Scheherazade New font
+echo "📥 Installing Scheherazade New font..."
+wget -q "https://github.com/silnrsi/font-scheherazade/releases/download/v3.300/ScheherazadeNew-3.300.zip" -O scheherazade.zip
+unzip -q scheherazade.zip
+cp ScheherazadeNew-3.300/*.ttf "$FONTS_DIR/"
+rm -rf scheherazade.zip ScheherazadeNew-3.300/
+
+# Set proper permissions
+chmod 644 "$FONTS_DIR"/*.ttf
+
+# Update font cache
+echo "🔄 Updating font cache..."
+fc-cache -fv
+
+# Verify Arabic fonts installation
+echo "✅ Verifying Arabic fonts installation..."
+fc-list | grep -i "amiri\|scheherazade\|noto.*arabic" | head -10
+
+echo "🎯 Arabic fonts setup completed successfully!"
+echo "Available Arabic fonts:"
+fc-list | grep -i "arabic\|amiri\|scheherazade" | cut -d: -f2 | sort | uniq

docker-compose.yml

@@ -0,0 +1,23 @@
+version: '3.8'
+
+services:
+  docx-to-pdf-arabic:
+    build: .
+    container_name: docx-pdf-converter-arabic
+    ports:
+      - "7860:7860"
+    environment:
+      - LANG=ar_SA.UTF-8
+      - LC_ALL=ar_SA.UTF-8
+      - PYTHONUNBUFFERED=1
+    volumes:
+      # Optional: Mount local directories for testing
+      - ./test_files:/app/test_files:ro
+      - ./test_results:/app/test_results
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:7860/"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s

libreoffice_arabic_config.xml

@@ -0,0 +1,108 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- LibreOffice Arabic RTL Configuration Template -->
+<!-- This configuration ensures perfect Arabic text rendering and RTL support -->
+<oor:items xmlns:oor="http://openoffice.org/2001/registry" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  
+  <!-- Arabic Language and Locale Settings -->
+  <item oor:path="/org.openoffice.Setup/L10N">
+    <prop oor:name="ooLocale" oor:op="fuse">
+      <value>ar-SA</value>
+    </prop>
+    <prop oor:name="ooSetupSystemLocale" oor:op="fuse">
+      <value>ar-SA</value>
+    </prop>
+  </item>
+
+  <!-- CTL (Complex Text Layout) for Arabic -->
+  <item oor:path="/org.openoffice.Office.Common/I18N/CTL">
+    <prop oor:name="CTLFont" oor:op="fuse">
+      <value>true</value>
+    </prop>
+    <prop oor:name="CTLSequenceChecking" oor:op="fuse">
+      <value>true</value>
+    </prop>
+    <prop oor:name="CTLCursorMovement" oor:op="fuse">
+      <value>1</value>
+    </prop>
+    <prop oor:name="CTLTextNumerals" oor:op="fuse">
+      <value>1</value>
+    </prop>
+    <prop oor:name="CTLTypeAndReplace" oor:op="fuse">
+      <value>true</value>
+    </prop>
+  </item>
+
+  <!-- Arabic Default Fonts -->
+  <item oor:path="/org.openoffice.VCL/DefaultFonts">
+    <prop oor:name="ar_SANS" oor:op="fuse">
+      <value>Amiri;Noto Naskh Arabic;Liberation Sans</value>
+    </prop>
+    <prop oor:name="ar_SERIF" oor:op="fuse">
+      <value>Amiri;Noto Naskh Arabic;Liberation Serif</value>
+    </prop>
+    <prop oor:name="ar_FIXED" oor:op="fuse">
+      <value>Liberation Mono;Noto Sans Mono</value>
+    </prop>
+    <prop oor:name="ar_UI" oor:op="fuse">
+      <value>Amiri;Noto Naskh Arabic;DejaVu Sans</value>
+    </prop>
+  </item>
+
+  <!-- Text Direction Settings -->
+  <item oor:path="/org.openoffice.Office.Writer/Layout/Other">
+    <prop oor:name="DefaultTextDirection" oor:op="fuse">
+      <value>2</value> <!-- RTL -->
+    </prop>
+    <prop oor:name="IsAlignTabStopPosition" oor:op="fuse">
+      <value>true</value>
+    </prop>
+  </item>
+
+  <!-- Page Layout for Arabic Documents -->
+  <item oor:path="/org.openoffice.Office.Writer/Layout/Page">
+    <prop oor:name="IsLandscape" oor:op="fuse">
+      <value>false</value>
+    </prop>
+    <prop oor:name="Width" oor:op="fuse">
+      <value>21000</value> <!-- A4 width in 1/100mm -->
+    </prop>
+    <prop oor:name="Height" oor:op="fuse">
+      <value>29700</value> <!-- A4 height in 1/100mm -->
+    </prop>
+    <prop oor:name="LeftMargin" oor:op="fuse">
+      <value>2000</value>
+    </prop>
+    <prop oor:name="RightMargin" oor:op="fuse">
+      <value>2000</value>
+    </prop>
+    <prop oor:name="TopMargin" oor:op="fuse">
+      <value>2000</value>
+    </prop>
+    <prop oor:name="BottomMargin" oor:op="fuse">
+      <value>2000</value>
+    </prop>
+  </item>
+
+  <!-- Disable Auto-formatting that might interfere with Arabic -->
+  <item oor:path="/org.openoffice.Office.Writer/AutoFunction/Format/Option">
+    <prop oor:name="UseReplacementTable" oor:op="fuse">
+      <value>false</value>
+    </prop>
+    <prop oor:name="TwoCapitalsAtStart" oor:op="fuse">
+      <value>false</value>
+    </prop>
+    <prop oor:name="CapitalAtStartSentence" oor:op="fuse">
+      <value>false</value>
+    </prop>
+    <prop oor:name="ChgToEnEmDash" oor:op="fuse">
+      <value>false</value>
+    </prop>
+    <prop oor:name="AddNonBrkSpace" oor:op="fuse">
+      <value>false</value>
+    </prop>
+    <prop oor:name="ChgQuotes" oor:op="fuse">
+      <value>false</value>
+    </prop>
+  </item>
+
+</oor:items>

packages.txt

@@ -1,5 +1,7 @@
 libreoffice
 libreoffice-writer
+libreoffice-l10n-ar
+libreoffice-help-ar
 fonts-liberation
 fonts-liberation2
 fonts-dejavu
@@ -10,6 +12,12 @@ fonts-noto-core
 fonts-noto-ui-core
 fonts-noto-mono
 fonts-noto-color-emoji
+fonts-noto-naskh
+fonts-noto-kufi-arabic
 fonts-opensymbol
 fonts-freefont-ttf
+fonts-amiri
+fonts-scheherazade-new
 fontconfig
+wget
+curl

run_local.py

@@ -0,0 +1,113 @@
+#!/usr/bin/env python3
+"""
+Local runner for DOCX to PDF converter with Arabic support
+Run this script to test the converter locally before deploying to Hugging Face Spaces
+"""
+
+import subprocess
+import sys
+import os
+from pathlib import Path
+
+def check_system_requirements():
+    """Check if all system requirements are installed"""
+    print("🔍 Checking system requirements...")
+    
+    requirements = {
+        "LibreOffice": ["libreoffice", "--version"],
+        "Font Cache": ["fc-cache", "--version"],
+        "Font List": ["fc-list", "--help"]
+    }
+    
+    missing = []
+    for name, cmd in requirements.items():
+        try:
+            result = subprocess.run(cmd, capture_output=True, timeout=5)
+            if result.returncode == 0:
+                print(f"✅ {name}: Available")
+            else:
+                print(f"❌ {name}: Not working properly")
+                missing.append(name)
+        except (subprocess.TimeoutExpired, FileNotFoundError):
+            print(f"❌ {name}: Not found")
+            missing.append(name)
+    
+    if missing:
+        print(f"\n⚠️ Missing requirements: {', '.join(missing)}")
+        print("\nTo install on Ubuntu/Debian:")
+        print("sudo apt-get update")
+        print("sudo apt-get install libreoffice libreoffice-writer fonts-liberation fonts-dejavu fonts-noto fontconfig")
+        return False
+    
+    print("✅ All system requirements are available")
+    return True
+
+def install_python_requirements():
+    """Install Python requirements"""
+    print("\n📦 Installing Python requirements...")
+    try:
+        subprocess.run([sys.executable, "-m", "pip", "install", "-r", "requirements.txt"], 
+                      check=True)
+        print("✅ Python requirements installed successfully")
+        return True
+    except subprocess.CalledProcessError as e:
+        print(f"❌ Failed to install Python requirements: {e}")
+        return False
+
+def setup_arabic_fonts():
+    """Setup Arabic fonts if the script exists"""
+    script_path = Path("arabic_fonts_setup.sh")
+    if script_path.exists():
+        print("\n🔤 Setting up Arabic fonts...")
+        try:
+            # Make script executable
+            os.chmod(script_path, 0o755)
+            subprocess.run(["bash", str(script_path)], check=True)
+            print("✅ Arabic fonts setup completed")
+            return True
+        except subprocess.CalledProcessError as e:
+            print(f"⚠️ Arabic fonts setup failed: {e}")
+            print("Continuing without additional Arabic fonts...")
+            return False
+    else:
+        print("⚠️ Arabic fonts setup script not found, skipping...")
+        return False
+
+def run_app():
+    """Run the main application"""
+    print("\n🚀 Starting DOCX to PDF converter...")
+    print("The application will be available at: http://localhost:7860")
+    print("Press Ctrl+C to stop the application")
+    
+    try:
+        subprocess.run([sys.executable, "app.py"], check=True)
+    except KeyboardInterrupt:
+        print("\n👋 Application stopped by user")
+    except subprocess.CalledProcessError as e:
+        print(f"❌ Application failed to start: {e}")
+
+def main():
+    """Main function"""
+    print("🔧 DOCX to PDF Converter - Local Setup")
+    print("=" * 50)
+    
+    # Check system requirements
+    if not check_system_requirements():
+        print("\n❌ System requirements not met. Please install missing components.")
+        return 1
+    
+    # Install Python requirements
+    if not install_python_requirements():
+        print("\n❌ Failed to install Python requirements.")
+        return 1
+    
+    # Setup Arabic fonts (optional)
+    setup_arabic_fonts()
+    
+    # Run the application
+    run_app()
+    
+    return 0
+
+if __name__ == "__main__":
+    sys.exit(main())

test_conversion.py

@@ -0,0 +1,122 @@
+#!/usr/bin/env python3
+"""
+Test script for DOCX to PDF conversion with Arabic RTL support
+This script tests the conversion functionality locally
+"""
+
+import sys
+import os
+from pathlib import Path
+
+# Add the current directory to Python path
+sys.path.insert(0, str(Path(__file__).parent))
+
+from app import convert_docx_to_pdf, setup_libreoffice, setup_font_environment
+
+def test_arabic_conversion():
+    """Test the Arabic DOCX to PDF conversion"""
+    
+    print("🧪 Testing Arabic DOCX to PDF Conversion")
+    print("=" * 50)
+    
+    # Check LibreOffice setup
+    print("1. Checking LibreOffice setup...")
+    if not setup_libreoffice():
+        print("❌ LibreOffice setup failed!")
+        return False
+    print("✅ LibreOffice setup successful")
+    
+    # Setup font environment
+    print("\n2. Setting up font environment...")
+    setup_font_environment()
+    print("✅ Font environment setup completed")
+    
+    # Check for test files
+    test_files_dir = Path("test_files")
+    if not test_files_dir.exists():
+        print(f"\n⚠️ Test files directory '{test_files_dir}' not found")
+        print("Please create test_files/ directory and add sample DOCX files")
+        return False
+    
+    docx_files = list(test_files_dir.glob("*.docx"))
+    if not docx_files:
+        print(f"\n⚠️ No DOCX files found in '{test_files_dir}'")
+        print("Please add sample DOCX files to test the conversion")
+        return False
+    
+    print(f"\n3. Found {len(docx_files)} DOCX files for testing:")
+    for docx_file in docx_files:
+        print(f"   📄 {docx_file.name}")
+    
+    # Test conversion for each file
+    results_dir = Path("test_results")
+    results_dir.mkdir(exist_ok=True)
+    
+    success_count = 0
+    total_count = len(docx_files)
+    
+    for docx_file in docx_files:
+        print(f"\n4. Testing conversion: {docx_file.name}")
+        print("-" * 30)
+        
+        # Create a mock file object
+        class MockFile:
+            def __init__(self, path):
+                self.name = str(path)
+        
+        mock_file = MockFile(docx_file)
+        
+        try:
+            pdf_path, status_message = convert_docx_to_pdf(mock_file)
+            
+            if pdf_path and os.path.exists(pdf_path):
+                # Move the result to test_results directory
+                result_name = docx_file.stem + "_converted.pdf"
+                result_path = results_dir / result_name
+                
+                import shutil
+                shutil.move(pdf_path, result_path)
+                
+                print(f"✅ Conversion successful!")
+                print(f"📁 Output: {result_path}")
+                print(f"📊 Status: {status_message[:100]}...")
+                success_count += 1
+            else:
+                print(f"❌ Conversion failed!")
+                print(f"📊 Error: {status_message}")
+                
+        except Exception as e:
+            print(f"❌ Conversion error: {str(e)}")
+    
+    # Summary
+    print(f"\n🎯 Test Summary:")
+    print(f"   Total files: {total_count}")
+    print(f"   Successful: {success_count}")
+    print(f"   Failed: {total_count - success_count}")
+    print(f"   Success rate: {(success_count/total_count)*100:.1f}%")
+    
+    if success_count > 0:
+        print(f"\n📁 Results saved in: {results_dir}")
+    
+    return success_count == total_count
+
+def create_sample_test_files():
+    """Create sample test files for testing"""
+    test_files_dir = Path("test_files")
+    test_files_dir.mkdir(exist_ok=True)
+    
+    print("📝 Creating sample test files...")
+    print("Note: You need to manually create DOCX files with Arabic content")
+    print("Suggested test cases:")
+    print("1. Simple Arabic text document")
+    print("2. Document with Arabic tables")
+    print("3. Mixed Arabic/English document")
+    print("4. Document with Arabic headers and footers")
+    print("5. Document with Arabic bullet points")
+    print(f"\nPlace your test DOCX files in: {test_files_dir.absolute()}")
+
+if __name__ == "__main__":
+    if len(sys.argv) > 1 and sys.argv[1] == "--create-samples":
+        create_sample_test_files()
+    else:
+        test_arabic_conversion()