ملفات PDF بالعربية: كيف تصدّر تقارير سليمة الحروف؟

فريق كودينُشِر في
ملفات PDF بالعربية: كيف تصدّر تقارير سليمة الحروف؟

هل تظهر فاتورتك بحروف متقطعة؟ الحل يحتاج ثلاثة عناصر فقط: محرك يشبك الحروف العربية ببعضها، وخط عربي مضمَّن داخل الملف نفسه، واتجاه نص محدد صراحةً من اليمين إلى اليسار. إذا غاب عنصر واحد خرجت ملفات PDF بالعربية بكلمات مفككة وأرقام مقلوبة. قد تبدو الشاشة عندك سليمة، ثم يصل للعميل مستند محرج. سأشرح لك ما يحدث خلف الكواليس بلغة بسيطة ودون برمجة، وكيف تطلب من مطورك أو منصتك نتيجة نظيفة من أول مرة.

لماذا تتقطع الحروف العربية عند توليد ملف PDF؟

تتقطع الحروف لأن مكتبة التصدير ترسم كل حرف بشكله المنفرد. للحرف العربي حتى أربعة أشكال بحسب موقعه في الكلمة، واختيار الشكل الصحيح ووصله بجاره مهمة «محرك تشكيل» مثل HarfBuzz. حين لا تمر المكتبة على هذا المحرك تظهر كلمة «محمد» هكذا: م ح م د، حروفاً متباعدة يصعب قراءتها.

خذ حرف الهاء مثالاً. وحده يبدو «ه»، وفي أول الكلمة «هـ»، وفي وسطها «ـهـ»، وفي آخرها «ـه». الحاسوب يخزّن الحرف مرة واحدة، ثم يقرر محرك العرض أي شكل يرسم. غياب هذا القرار يعطيك نصاً يبدو صادراً عن نظام رخيص.

وهناك حالات أصعب. «لا» ليست لاماً تليها ألف، بل رسم مدمج إجباري. لفظ الجلالة له شكل خاص في معظم الخطوط. والتشكيل يحتاج تموضعاً دقيقاً وإلا طارت الشدة إلى منتصف السطر.

معظم المكتبات القديمة صُممت للإنجليزية. ليست معطوبة، لكنها لم تُبنَ لنا أصلاً.

والآن التفصيل الذي لا يخبرك به أحد قبل أن تقع فيه. بعض المطورين يلجؤون إلى حيلة سريعة: يحوّلون النص إلى أشكال جاهزة ثم يعكسون ترتيبه يدوياً، كما يحدث مع ReportLab في بايثون عبر arabic-reshaper وpython-bidi. يبدو الملف مثالياً. جرّب نسخ سطر منه ولصقه في الواتساب: ستجد الحروف معكوسة أو رموزاً غريبة، وسيفشل البحث داخل الملف تماماً. الحل الجيد يجتاز اختبار النسخ، لا اختبار النظر وحده.

مشكلة الاتجاه: حين تنقلب الأرقام والأقواس

قد تتصل الحروف ويبقى الملف معطوباً. العربية تُكتب من اليمين، والأرقام والكلمات الإنجليزية من اليسار. حين يجتمعان في سطر واحد تتدخل خوارزمية يونيكود ثنائية الاتجاه (Unicode Bidirectional Algorithm) لترتيب المقاطع. فإن لم يعرف النظام أن الفقرة عربية، رتّبها بمنطق إنجليزي.

تأمل هذا السطر من فاتورة حقيقية: «طلب رقم INV-2026-0045 بقيمة 1250 ر.س». في ملف سيئ الإعداد قد يظهر الرقم 0045-2026-INV، أو تقفز «ر.س» إلى أول السطر. ليست مشكلة شكلية؛ محاسب عميلك سيبحث عن رقم الفاتورة ولن يجده.

أشهر الأعراض:

  • الأقواس المعكوسة: تظهر «)ضريبة القيمة المضافة(» بدل الشكل الصحيح.
  • أرقام الجوال المبعثرة: رقم مثل ‎+966 55 123 4567 ينتقل فيه الرمز + إلى نهايته.
  • علامات الترقيم الهاربة: النقطة الختامية تظهر في أول الجملة.
  • أعمدة بترتيب إنجليزي: عمود «الصنف» في اليسار بدل اليمين.

العلاج المعتمد بسيط لمن يعرفه. يُحدَّد اتجاه المستند كاملاً على أنه RTL (في HTML عبر الخاصية dir="rtl" على مستوى الصفحة)، ثم يُعزل كل مقطع إنجليزي أو رقمي حساس داخل وسم مثل bdi. هذا العزل يقول للنظام: لهذا المقطع اتجاهه الخاص، فلا تخلطه بما حوله.

نصيحتي؟ لا تكتفِ بمحاذاة النص إلى اليمين. المحاذاة تغيّر مكان الكلام، أما الاتجاه فيغيّر ترتيبه. الخلط بينهما سبب شائع لانقلاب الأرقام في نص «يبدو» عربياً.

الخطوط: سبب نصف المشكلات

رأيت مرة فاتورة لمتجر عطور في الرياض خرجت كلها مربعات فارغة. النظام كان يعمل بلا عيوب على جهاز المطور، ثم نُقل إلى خادم Linux لا يحتوي أي خط عربي. ويندوز كان يوفّر خط Arial بصمت، أما الخادم فلم يجد ما يرسم به. يسمي المطورون هذه المربعات «tofu».

القاعدة الذهبية: ضمِّن الخط داخل الملف ولا تعتمد على ما هو مثبت في جهاز القارئ أو الخادم. عندها يحمل الملف حروفه معه، فيظهر بالشكل ذاته على آيفون العميل وطابعة مكتبه في دبي. ويمكن تضمين الحروف المستخدمة فقط (subsetting) ليبقى الحجم صغيراً، غالباً أقل من 200 كيلوبايت لفاتورة عادية.

ترشيحاتي من الاستعمال الفعلي:

  • IBM Plex Sans Arabic: واضح جداً في الجداول والأرقام، ومثالي للفواتير.
  • Noto Naskh Arabic: مريح للعقود والشروط والنصوص الطويلة.
  • Tajawal وAlmarai: عصريان ويناسبان العناوين وهوية العلامات الناشئة.

كلها على Google Fonts برخصة SIL Open Font License التي تسمح بالاستخدام التجاري مجاناً. تجنّب الخط الديواني في المستندات الرسمية. جميل في بطاقة دعوة، مرهق في جدول من عشرين صنفاً.

انتبه للوزن أيضاً. إن استخدمت الخط العريض للعناوين فضمّن ملف الوزن العريض، وإلا «زيّف» البرنامج السماكة وشوّه نقاط الحروف. للتوسع في اختيار الخطوط وتناسقها راجع دليلنا عن الخطوط العربية في الواجهات، فالمبادئ نفسها تنطبق على المطبوعات.

أي طريقة تصدير تختار لتقاريرك وفواتيرك؟

اختر تصميم المستند كصفحة HTML ثم تحويلها إلى PDF عبر متصفح كروم يعمل في الخلفية بأداة مثل Puppeteer أو Playwright. هذه أفضل طريقة لمعظم المشاريع، لأن كروم يحمل محرك تشكيل ناضجاً يعالج العربية يومياً لمئات الملايين، فتحصل على حروف متصلة واتجاه صحيح ونص قابل للنسخ والبحث.

مقارنة سريعة بالخيارات الشائعة:

  • كروم الخلفي: الأعلى جودة ومرونة، وعيبه أنه يستهلك ذاكرة أكثر على الخادم.
  • WeasyPrint: خيار ممتاز في بيئة بايثون، يعتمد على Pango وHarfBuzz فيدعم العربية جيداً.
  • wkhtmltopdf: شاع لسنوات، لكن مستودعه أُرشف عام 2023 ومحرّكه القديم يخطئ في حالات عربية كثيرة. لا تبدأ به مشروعاً جديداً.
  • jsPDF وpdfmake: سريعتان وخفيفتان، لكن دعم التشكيل فيهما محدود ويحتاج ترقيعات.
  • ReportLab بحيلة إعادة التشكيل: تنجح بصرياً وتسقط في اختبار النسخ والبحث.

تصدّر يدوياً من Word أو Google Docs؟ الوضع أسهل مما تظن. «حفظ بتنسيق PDF» في Word يعالج العربية جيداً، بشرط ضبط اتجاه الفقرات من اليمين إلى اليسار لا محاذاتها فقط.

وإن كنت تبني نظامك على منصة no code عربية فاسأل مباشرة: ما المحرك الذي تستخدمونه للتصدير؟ منصة جادة ستذكر كروم أو محركاً مبنياً على HarfBuzz دون تلعثم. أما جواب «ارفع خطاً عربياً وسيعمل» دون حديث عن التشكيل، فغالباً يعني مشكلات لاحقة.

الفواتير في الخليج: متطلبات تتجاوز الشكل

في السعودية الأمر ليس جمالياً فقط. هيئة الزكاة والضريبة والجمارك (ZATCA) تشترط أن تكون الفاتورة الضريبية باللغة العربية، مع السماح بلغة أخرى إلى جانبها. فاتورة بحروف مقطعة تُعد عملياً غير مقروءة، فضلاً عن ضررها بسمعتك.

بدأت المرحلة الأولى من منظومة «فاتورة» في 4 ديسمبر 2021، وانطلقت مرحلة الربط والتكامل على موجات منذ 1 يناير 2023، وما زالت الموجات تتسع لتشمل منشآت أصغر. ما يجب أن تعرفه:

  • رمز QR إلزامي على الفاتورة المبسطة، ويحمل اسم البائع ورقمه الضريبي والتاريخ والإجمالي ومبلغ الضريبة.
  • صيغة PDF/A-3 مع ملف XML مضمَّن من الصيغ المقبولة في المرحلة الثانية. هي نسخة أرشيفية تشترط تضمين الخطوط كلها، وهذا يخدم العربية أصلاً.
  • النسبة الصحيحة: ضريبة القيمة المضافة 15% في السعودية و5% في الإمارات، فلا تنسخ قالباً بين البلدين دون مراجعة.

الفواتير ثنائية اللغة شائعة في الخليج. أنجح تصميم جربته: العربي في اليمين والإنجليزي في اليسار، وجدول أصناف موحّد تحمل عناوين أعمدته اللغتين. لا تضع سطرين بلغتين في الخلية نفسها؛ تتصادم الاتجاهات ويتوه القارئ.

هذه الفقرة لا تغني عن مستشارك الضريبي، فالتفاصيل تتغير مع كل موجة. وإن كنت تبني نظام فوترة داخل تطبيقك، فدليلنا عن الفوترة العربية في التطبيقات يغطي الجانب التقني بتفصيل أكبر.

الأرقام والتواريخ والعملات: تفاصيل صغيرة تصنع الفرق

أول قرار: أرقام هندية (١٢٣) أم غربية (123)؟ كلاهما مقبول في الخليج. رأيي الصريح: استخدم الأرقام الغربية في الفواتير والتقارير المالية. حين ينسخ محاسب عميلك المبلغ إلى Excel تعمل الغربية فوراً، بينما قد تُقرأ الهندية نصاً فتفشل المعادلات.

الأهم بعد الاختيار هو الثبات. تاريخ بأرقام هندية ومبلغ بأرقام غربية في الصفحة نفسها يوحي بالعشوائية.

والعملة لها قصة. اعتمد البنك المركزي السعودي رمزاً جديداً للريال عام 2025، وأُضيف إلى يونيكود في إصداره 17.0. لكن خطوطاً كثيرة لم تُحدَّث بعد، فيظهر مكانه مربع فارغ. إلى أن تتأكد من دعم خطك له، اكتب «ر.س» أو «SAR»، أو أدرج الرمز صورة متجهة صغيرة. ينطبق الأمر ذاته على رمز الدرهم الإماراتي الجديد.

وللتواريخ قواعدها:

  • للتاريخ الهجري اعتمد تقويم أم القرى المعتمد رسمياً في السعودية.
  • اكتب اسم الشهر نصاً («18 نوفمبر 2026») لتتجنب لبس ترتيب اليوم والشهر.
  • الصيغة الرقمية مثل 18/11/2026 تحتاج عزلاً في اتجاه مستقل حتى لا تنعكس أجزاؤها.

اختبار الخمس دقائق قبل أن يرى عميلك الملف

لن تحتاج خبرة برمجية لتكتشف معظم المشكلات. أنشئ فاتورة تجريبية تحتوي «حالات صعبة» عمداً، ثم مرّ على هذه القائمة:

  • كلمات الاختبار: ضع «لا» و«الله» و«مستشفى» و«بِسْمِ». إن اتصلت كلها وجلس التشكيل في مكانه فالمحرك سليم.
  • النسخ واللصق: انسخ سطراً والصقه في ملاحظات الجوال. هل خرج مقروءاً؟
  • البحث: اضغط Ctrl+F وابحث عن اسم عميل. إن لم يُعثر عليه فهناك خلل خفي.
  • السطر المختلط: اكتب «رقم الطلب INV-2026-0045 (مدفوع)» وتأكد من سلامة الرقم والأقواس.
  • اسم طويل: جرّب اسم منتج من 60 حرفاً لترى كيف ينكسر السطر داخل الجدول.
  • الخطوط المضمّنة: في Adobe Acrobat Reader افتح خصائص المستند ثم تبويب الخطوط، وابحث عن عبارة Embedded Subset بجانب كل خط.

ثم افتح الملف في معاينة الواتساب، وتطبيق الملفات في آيفون، وطابعة حقيقية على ورق A4. الطباعة تكشف ما لا تكشفه الشاشة: هوامش تقطع آخر عمود، أو رمز QR صغير يرفضه الماسح.

تحذير أخير من التجربة: تجنّب «ضبط النص» (justify) في الفقرات العربية الطويلة. بعض المحركات تملأ السطر بفراغات واسعة بدل الكشيدة، فتبدو الفقرة مثقوبة.

كيف تطلب ذلك من مطورك أو منصتك دون لغة تقنية؟

لست مضطراً لفهم كل ما سبق بعمق. يكفي أن تطرح الأسئلة الصحيحة. انسخ هذه وأرسلها لمن يبني نظامك:

  • «ما الأداة التي تولّد الملفات؟ وهل تدعم التشكيل العربي فعلياً أم بإعادة ترتيب يدوية؟»
  • «هل الخطوط مضمّنة داخل الملف أم معتمدة على الخادم؟»
  • «هل أستطيع نسخ نص الفاتورة والبحث فيه؟»
  • «هل اتجاه المستند RTL بالكامل، والمقاطع الإنجليزية معزولة؟»
  • «هل يدعم القالب صيغة PDF/A-3 إن احتجتها؟»

جاءك جواب غامض مثل «العربية تعمل عادةً»؟ اطلب ملفاً تجريبياً فوراً وطبّق عليه الاختبار. الملف لا يجامل.

وفكّر في الصورة الأكبر: ملفات PDF بالعربية جزء من تجربة عربية متكاملة تشمل الواجهة والنماذج والرسائل والتقارير. إن كانت مستنداتك تُبنى من بيانات مالية، فدليل التقارير المالية العربية في التطبيقات يكمل الصورة.

الخلاصة العملية بسيطة: محرك يعرف التشكيل، وخط مضمَّن، واتجاه RTL واضح، ثم اختبار نسخ وطباعة قبل الإرسال. أربع خطوات تفصل بين فاتورة تحرجك وأخرى تقول لعميلك إنك تهتم بالتفاصيل.

الأسئلة الشائعة

لماذا يظهر النص العربي سليماً على الشاشة ومقطعاً في ملف PDF؟

لأن المتصفح أو البرنامج الذي تعرض فيه الصفحة يملك محرك تشكيل يربط الحروف، بينما مكتبة التصدير المستخدمة قد لا تملكه فترسم كل حرف بشكله المنفرد. الحل أن يتم التصدير بأداة تدعم التشكيل مثل كروم الخلفي أو WeasyPrint، مع تضمين خط عربي داخل الملف بدل الاعتماد على خطوط الخادم.

هل يجب أن تكون الفاتورة الإلكترونية في السعودية باللغة العربية؟

نعم، تشترط هيئة الزكاة والضريبة والجمارك أن تكون الفاتورة الضريبية بالعربية، ويُسمح بإضافة لغة ثانية بجانبها مثل الإنجليزية. لذلك يجب أن تكون الحروف متصلة والأرقام مرتبة بوضوح، مع رمز QR في الفواتير المبسطة. راجع مستشارك الضريبي للتفاصيل الخاصة بموجة الربط التي تشمل منشأتك.

ما أفضل خط عربي للفواتير والتقارير؟

أرشّح IBM Plex Sans Arabic للفواتير والجداول لوضوح أرقامه، وNoto Naskh Arabic للعقود والنصوص الطويلة. كلاهما مجاني للاستخدام التجاري عبر Google Fonts. المهم أكثر من اسم الخط أن يكون مضمَّناً داخل الملف، وأن تضمّن الوزن العريض أيضاً إن استخدمته في العناوين.

كيف أعرف أن ملف PDF العربي سليم دون خبرة تقنية؟

انسخ سطراً من الملف والصقه في ملاحظات الجوال، ثم ابحث داخله عن اسم عميل باستخدام Ctrl+F. إن خرج النص مقروءاً ووجد البحث الاسم، فالملف سليم غالباً. أضف كلمات اختبار مثل «لا» و«الله»، وتحقق من الأرقام والأقواس، ثم اطبع نسخة على ورق A4 للتأكد من الهوامش.

اقرأْ أيضًا

ملفات PDF بالعربية: كيف تصدّر تقارير سليمة الحروف؟ | codeyy