مكتبة Python معتمدة لإنشاء مستندات Word عربية بتنسيق RTL كامل وصحيح، وتحويل أي مستند LTR موجود إلى RTL.
<w:bidi/>على الفقرة وحدها لا يكفي — الأحرف المحايدة (◄ ، ☐ ، أقواس) كانت تأخذ اتجاه LTR- الحل الكامل:
<w:rtl/>على كل run +<w:bidiVisual/>على كل جدول +<w:bidi/>على القسم - إضافة جديدة:
w:lang w:val="ar-SA"على كل run + خط Tajawal بدل Arial + native bullets
| الملف | الوظيفة |
|---|---|
/app/rtl_helper.py |
مكتبة بناء المستندات العربية من الصفر |
.agents/skills/arabic-docx/convert_to_rtl.py |
تحويل مستند LTR موجود إلى RTL |
.agents/skills/arabic-docx/references/arabic_qa.md |
مرجع الجودة العربية (12 حالة اختبار + 7 ثوابت) |
import sys; sys.path.insert(0, '/app')
from rtl_helper import (
set_rtl_para, # تفعيل RTL على فقرة
make_run, # إضافة نص مع w:rtl + w:lang + w:cs مضمونة
add_para, # فقرة كاملة RTL
add_native_bullet, # نقطة أصلية (w:numPr) — مفضّلة
add_bullet, # نقطة بصرية ◄ — للتوافق القديم
add_section_title, # عنوان قسم (أخضر، عريض)
add_quote, # استشهاد قانوني
add_field, # حقل إدخال
add_table, # جدول RTL كامل
add_check_row_rtl, # صف تحقق
set_table_rtl, # تفعيل bidiVisual على جدول
audit_arabic_docx, # فحص هيكلي صارم (pass/fail)
)- كل فقرة →
set_rtl_para(para)— يضيفw:bidi - كل run →
make_run(para, text)— يضيفw:rtl+w:lang ar-SA+w:cs=Tajawal - كل جدول →
set_table_rtl(table)— يضيفw:bidiVisual - الخط: Tajawal (افتراضي) مع Arial كـ fallback
- لا Unicode bidi controls (RLM, LRM, RLE...)
- النقاط:
add_native_bullet()مفضّلة علىadd_bullet() - لا خط مائل (italic) على نص عربي
result = audit_arabic_docx(doc)
# → يطبع تقرير: PASS ✅ أو FAIL ❌ مع تفاصيل
# → يعيد True/Falseimport sys
sys.path.insert(0, '/app/.agents/skills/arabic-docx')
from convert_to_rtl import convert_docx_to_rtl
output = convert_docx_to_rtl('/path/to/input.docx')
print(output)اقرأ references/arabic_qa.md قبل تسليم أي مستند عربي مهم. يحتوي على:
- 7 ثوابت هيكلية (OOXML invariants) — إلزامية
- 7 ممنوعات (Unicode bidi controls، عكس الأحرف، نقاط كنص...)
- 12 حالة اختبار (acceptance corpus) — افحصها بصرياً في Word
- 3 طبقات جودة (Structural + Layout + Application QA)
- تشخيص الأخطاء الشائعة
- ترقيات مطلوبة على rtl_helper.py
المصدر: مقتبس من SultanAlsafran/agent-skills (arabic-presentations, MIT) — مكيّف لبيئة Word/docx.
from docx import Document
from docx.shared import Cm
import sys; sys.path.insert(0, '/app')
from rtl_helper import *
doc = Document()
for sec in doc.sections:
sec.right_margin = Cm(3)
sec.left_margin = Cm(2.5)
add_para(doc, "عنوان المستند", bold=True, size=14, center=True)
add_section_title(doc, "أولاً: البيانات")
add_field(doc, "الاسم")
add_native_bullet(doc, "بند أول")
add_native_bullet(doc, "بند ثان")
add_table(doc, ["م", "البند", "الملاحظة"], [["1", "نص", "—"]])
# فحص الجودة قبل الحفظ
audit_arabic_docx(doc)
doc.save('output.docx')