فواتير PDF بالعربي تظهر حروفها مقطّعة: الأسباب والحل
باختصار: حين تظهر كلمة «فاتورة» في ملف PDF هكذا «ف ا ت و ر ة»، أو تظهر الجملة معكوسة من اليسار لليمين، فالمشكلة ليست في بيانات الزبون بل في أداة توليد الـPDF داخل نظامك. السبب في الغالب واحد من ثلاثة: أداة لا تشكّل الحروف العربية فتعرض كل حرف بشكله المنفرد، أو أداة لا تطبق قواعد اتجاه النص، أو خط مستخدم لا يحتوي الحروف العربية أصلًا. والحل يكون بتفعيل التشكيل، وضبط الاتجاه، وتضمين خط عربي كامل في الملف.
تخيل أن متجرك يرسل فاتورة لكل طلب، أو أن مركز الصيانة عندك يطبع أمر عمل للزبون. تظهر الأسماء العربية على الشاشة سليمة، ثم يخرج الملف بحروف متباعدة كأنها مكتوبة حرفًا حرفًا. الزبون يرى في ذلك عدم احتراف، والمحاسب لا يستطيع البحث في الملف. هذا الدليل يربط ما تراه بالسبب ثم بالحل.
لماذا يحتاج العربي إلى معاملة خاصة؟
الحرف العربي يتغير شكله حسب موقعه: في أول الكلمة أو وسطها أو آخرها أو منفردًا. توضح وثائق مكتبة fpdf2 أن هذه العملية، المسماة تشكيل النص أو text shaping، مهمة خصوصًا للكتابات التي تحتاج تخطيطًا معقدًا مثل العربية، حيث تتغير أشكال الحروف حسب السياق، وأنها تشمل ضبط المسافات بين الحروف، والحروف المركبة (ligatures)، واستبدال الحرف بالشكل المناسب لموقعه في الكلمة.
ثم يأتي الاتجاه. العربية تُكتب من اليمين لليسار، لكن الفاتورة مليئة بعناصر تُقرأ من اليسار لليمين: أرقام، رموز منتجات، عناوين بريد. تشرح مواصفة Unicode الخاصة بخوارزمية الاتجاه الثنائي (UAX #9) أن لكل حرف نوعًا اتجاهيًا، وأن الحروف العربية واللاتينية من النوع «القوي»، بينما تُصنف معظم الأرقام كأنواع «ضعيفة» يتحدد موضعها حسب ما حولها. الأداة التي لا تطبق هذه القواعد تخلط ترتيب الجملة.
جدول التشخيص
| ما يظهر في الملف | السبب الأرجح | الحل |
|---|---|---|
| حروف منفصلة غير متصلة | أداة التوليد لا تشكّل النص العربي | تفعيل محرك التشكيل في المكتبة أو استخدام أداة تدعمه |
| حروف متصلة لكن الكلمات بترتيب معكوس | الاتجاه غير مضبوط على RTL | ضبط اتجاه الفقرة أو الصفحة إلى RTL |
| مربعات فارغة أو علامات استفهام مكان العربي | الخط المستخدم لا يحتوي حروفًا عربية | تضمين خط عربي كامل في الملف |
| العربي سليم والأرقام في غير مكانها | نص مختلط الاتجاه دون معالجة | تطبيق خوارزمية الاتجاه الثنائي أو فصل الرقم في خلية مستقلة |
| لام ألف تظهر حرفين منفصلين | التشكيل جزئي أو الخط لا يدعم الحرف المركب | خط عربي يدعم الحروف المركبة مع محرك تشكيل كامل |
| الملف سليم على حاسوبك ومشوه عند الزبون | الخط غير مضمّن في الـPDF | تضمين الخط داخل الملف بدل الاعتماد على خطوط الجهاز |
| النسخ من الملف يعطي حروفًا غريبة | ترتيب الحروف المخزن داخل الملف غير صحيح | أداة توليد تحافظ على النص الأصلي مع شكله المرئي |
الحلول بالتفصيل
تفعيل التشكيل في المكتبة التي تستخدمها
كثير من مكتبات توليد PDF القديمة أو البسيطة ترسم الحروف كما هي دون تشكيل. بعضها يدعم التشكيل لكنه مطفأ افتراضيًا. مثال من وثائق fpdf2 في Python: التشكيل معطل افتراضيًا للحفاظ على التوافق مع الإصدارات السابقة، ويُفعّل بتثبيت حزمة uharfbuzz ثم استدعاء الدالة set_text_shaping، ويمكن تحديد الاتجاه rtl واللغة صراحة بدل تركها للتخمين. وتنبه الوثائق نفسها إلى أن التشكيل غير متاح مع خطوط Type 1، وأن دعم النص ثنائي الاتجاه أضيف في الإصدار 2.7.8.
الرسالة للمطور: «تحقق أن مكتبة الـPDF عندنا تشكّل العربي فعلًا، وأن الخيار مفعّل في الإنتاج لا في جهاز التطوير فقط».
ضبط الاتجاه على مستوى الصفحة والخلية
حتى مع التشكيل، يجب أن يعرف المستند أن الفقرة عربية. في المكتبات التي تبني الملف من HTML، يكفي غالبًا ضبط الاتجاه في القالب. وفي المكتبات التي ترسم النص سطرًا سطرًا، يجب ضبط الاتجاه صراحة. الجداول تحتاج انتباهًا خاصًا: ترتيب الأعمدة في فاتورة عربية يبدأ من اليمين، فالوصف ثم الكمية ثم السعر ثم المجموع.
تضمين خط عربي كامل
اختر خطًا عربيًا يحتوي الحروف العربية والأرقام والرموز التي تحتاجها، وتأكد أن ترخيصه يسمح بتضمينه في المستندات، ثم ضمّنه في الملف. الخط المضمّن يسافر مع الـPDF، فيظهر الملف كما صممته على هاتف الزبون وحاسوب المحاسب. أما الاعتماد على خطوط الجهاز، فيعني أن كل جهاز سيعرض شيئًا مختلفًا.
طريق HTML إلى PDF
بعض الفرق تفضل تصميم الفاتورة كصفحة HTML ثم تحويلها إلى PDF، لأن المتصفحات ومحركات العرض الحديثة تتعامل مع العربية جيدًا. مثلًا، تذكر وثائق تثبيت WeasyPrint أنه يعتمد على مكتبة Pango، وتشمل متطلباته مكتبات HarfBuzz المستخدمة في تشكيل النصوص. هذا الطريق مريح إذا كان عندك مصمم يعرف CSS، لكنه يحتاج خادمًا تثبت عليه هذه المكتبات بإصدارات مناسبة.
وفي PHP، تعرض صفحة أمثلة TCPDF مثالًا مخصصًا لنص عربي وفارسي من اليمين لليسار مع تشكيل الحروف والحروف المركبة مثل لام ألف ولفظ الجلالة، ويمكن للمطور البدء منه للمقارنة.
الأرقام والرموز داخل الجملة العربية
أصعب جزء في الفاتورة جملة مثل «طلب رقم 10452 بتاريخ 2026-11-03». إن خرجت الأرقام بترتيب غريب، فالحل الأبسط تصميمي: ضع رقم الطلب والتاريخ كل منهما في خلية أو سطر مستقل بعنوان واضح، بدل دمجهما في جملة طويلة. هذا يقلل اعتمادك على دقة خوارزمية الاتجاه، ويجعل الفاتورة أسهل قراءة أيضًا.
كيف تختبر قبل أن يصل الملف للزبون؟
جهّز فاتورة اختبار تحتوي على أصعب الحالات: اسم طويل فيه لام ألف، عنوان فيه رقم بناية، منتج اسمه مختلط بالإنجليزية، رقم هاتف، ومبلغ بكسور. افتحها على حاسوب وهاتف آيفون وهاتف أندرويد، وجرب نسخ اسم الزبون من الملف ولصقه في محرر نصوص. إن نجحت هذه الفاتورة، فالأغلب أن فواتيرك اليومية ستنجح.
أسئلة شائعة
ليش الفاتورة على الشاشة سليمة وبالـPDF مقطعة؟
لأن المتصفح يشكّل العربي ويضبط اتجاهه تلقائيًا، أما مكتبة توليد الـPDF فقد لا تفعل ذلك إلا إذا فُعّل التشكيل وضُمّن خط عربي.
هل لازم أغيّر نظام الفواتير كله؟
غالبًا لا. في كثير من الحالات يكفي تفعيل التشكيل، أو تغيير الخط، أو تبديل مكتبة توليد الـPDF وحدها.
أي خط عربي أستخدم بالفاتورة؟
أي خط عربي كامل الحروف واضح في الأحجام الصغيرة، ويسمح ترخيصه بالتضمين في المستندات.
هل المشكلة نفسها ممكن تصير بالتقارير والكشوفات؟
نعم، أي ملف PDF يولده نظامك آليًا معرض لها، لذلك يُصلح الأمر مرة واحدة في القالب أو المكتبة المشتركة.
إن كانت فواتيرك أو كشوفاتك تخرج اليوم بحروف مقطعة، أرسل لنا نموذجًا منها ونخبرك أين يقع الخلل في سلسلة التوليد.