Skip to content

Latest commit

 

History

History
53 lines (42 loc) · 2.35 KB

File metadata and controls

53 lines (42 loc) · 2.35 KB

تجهيز مشروع يستخدم نسيج

هذه الصفحة توضح شكل مشروع ويب عملي يكتب مصدره العربي عبر نسيج (Naseej) ثم يسلم خرجا قياسيا لأدوات المتصفح والبناء.

شكل المشروع

project/
  src/
    index.arhtml
  public/
    assets/
  dist/
  pyproject.toml

الأوامر

المهمة الأمر
تحويل صفحة واحدة python -m arweb src/index.arhtml -o dist/index.html --dictionary ar-web-v1.28
استخدام مفردات عربية صارمة لا تضف --allow-english
التعامل مع مصدر إنجليزي قديم أضف --allow-english بقرار واضح
فحص هذا المستودع python scripts/project_health.py
فحص بيانات الإصدار python scripts/check_release.py
عرض الأمثلة docs/EXAMPLES.md

حدود البناء

  • تغليف Python يملك واجهة arhtml CLI.
  • تستطيع bundlers الموجودة استهلاك خرج .html و.css و.js القياسي.
  • عمل TypeScript/JSX يتبع docs/TYPESCRIPT_JSX_TRACK.md.
  • تثبت إصدارات القواميس لكل مشروع.
  • لا تنقل مشروعا من قاموس overlay إلى آخر بصمت؛ وثق ذلك في أوامر البناء.

المحرر

  • ملفات .arhtml بترميز UTF-8.
  • ملفات .arhtml ملفات عربية الاتجاه في التأليف.
  • يجب أن يحافظ المحرر على اتجاه النص العربي وأن يتجنب إدخال أحرف تحكم بالاتجاه داخل الصياغة البرمجية.
  • ينبغي أن يتعامل ملوّن الصياغة مع أسماء الوسوم والسمات ومفردات CSS وJavaScript العربية كمفردات برمجة.
  • التشخيصات يجب أن تظهر بالعربية مع رقم السطر والعمود.

تسليم الإصدار

  • اذكر إصدار القاموس في الوثائق وأوامر البناء.
  • احفظ أمثلة .html المولدة عندما يكون مثال .arhtml جزءا من المستودع.
  • شغّل فحوص الوثائق المولدة بعد إضافة قاموس overlay.
  • حافظ على النص الطبيعي وبيانات المستخدم كما هي.
  • أبق ar-web-v1.json مجمدا.