نموذج مؤقت ثلاثة هياكل للموقع والوثائق. التشغيل والنتائج هنا تمثيل تفاعلي للقرار، وليسا مترجم ASPL حقيقياً.

شغّل برنامجك العربي الأول.

ASPL لغة برمجة نظم عربية أولاً، ولها أسماء إنجليزية مكافئة داخل القواعد نفسها. ابدأ من البرنامج، ثم اختر الطريق الذي تحتاجه.

P الوجهة الأولى: التشغيل في المتصفحالمصدر والتنفيذ يبقيان على جهازك.
D بعدها: مسار قصير إلى المرجعلا يلزم حساب أو تثبيت للبدء.

مثال أساسي موثّق · العرض اتجاهي ومدرك للرموز

مصدر ASPL
جاهز للتشغيل

main → i64 · لم يبدأ التنفيذ

المصدر والتنفيذ داخل المتصفح Bytecode only · No Linux libraries · No ELF execution
Lتعلّم بالمفاهيم، لا بدروس للمبتدئينمن البرنامج الأول إلى الدوال والتشخيصات والحد غير الآمن.
Rمرجع واحد بالعربية والإنجليزيةيحفظ مبدّل اللغة الصفحة والعنوان والموضع، ولا يغيّر المصدر.
Cدليل C يبدأ بالحدود الدقيقةملفان للتكييف في MVP، ولا ادعاء باستدعاء دوال C اعتباطية.

مسار تعلّم لمبرمج نظم.

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

1 / 4

ملف واحد ودالة رئيسية

بنية برنامج ASPL، الأنواع الأساسية، والحالة من 0 إلى 255.

افتح الدليل
2 / 4

الربط والتدفق

دع ومتغير، الشرط، الحلقة، والإرجاع مع قواعد الفحص المحددة.

افتح الدليل
3 / 4

الدوال والتشخيصات

تواقيع مصرح بها، مواقع مصدر دقيقة، وتصحيحات قابلة للتطبيق.

افتح الدليل
4 / 4

الحد غير الآمن مع C

تصريح صريح، استدعاء صريح، وملفا تكييف فقط في MVP.

افتح دليل C

مرجع يُمسح بسرعة.

تتطابق شجرة الصفحات والعناوين والمثبتات في العربية والإنجليزية. تغيير اللغة يبقيك في الموضع نفسه.

فهرس الصفحات

  • L-10دليل اللغة
  • C-20سطر الأوامر
  • D-30التشخيصات والفخاخ
  • F-40التوافق مع C
  • H-50المتصفح مقابل Linux
  • X-60الحدود والفهارس

داخل كل صفحة

  • عقد دقيقالقواعد المقبولة، السلوك، وحالات الفشل بأسمائها الثابتة.
  • مثال عربي أساسيالمثال العربي أولاً، ثم مكافئ إنجليزي يُختبر ضد الرموز الموحّدة نفسها.
  • الحدود والمضيفيفصل كل قسم بين Linux والمتصفح ولا يوحي بقدرات مشتركة غير موجودة.
  • أدلة قابلة للنسخأوامر كاملة، خرج متوقع، وسبب تشخيص ثابت عند الفشل.

دليل C يقول أين تنتهي الضمانات.

لا يبدأ الدليل بوعد تسويقي. يبدأ بنوع الدالة الدقيق، ملف التكييف، عمر القيم، وسلوك الفشل.

على x86-64 Linux مع glibc، يستطيع برنامج ASPL أصلي تحميل مكتبة مشتركة يقبلها محمّل glibc واستدعاء دالة مسماة عندما يطابق نوعها الدقيق ملف تكييف مدعوماً. يدعم MVP النوعين int(const char *) و double(double).

  1. 1اختر دالة تطابق ملف تكييف مدعوماً تطابقاً تاماً.
  2. 2اكتب تصريحاً خارجياً غير آمن باسم المكتبة والرمز الحرفيين.
  3. 3ضع غير_آمن عند كل استدعاء، ثم تعامل مع قيمة الإرجاع كبيانات ASPL عادية.
  4. 4اختبر على Linux. ساحة المتصفح ترفض كل الاستيرادات الأجنبية.
استدعاء puts من libc
قرض C-string صالح طوال الاستدعاء فقطint(const char *) → i64

التثبيت طريق قصير، لا نظام بناء.

صفحة مخصصة لـ x86-64 Linux مع glibc. تعرض ملف aspl الواحد، الإصدار، المجموع الاختباري، ثم أول فحص. رابط التنزيل الدقيق يتبع قرار التوزيع.

1

تحقق من النظام

x86-64 Linux مع glibc. لا تدّعي الصفحة دعماً عاماً لكل Linux.

uname -m
2

نزّل الملف والمجموع

يظهر الإصدار بجوار الملف، ويُفحص المجموع قبل وضعه على PATH.

sha256sum -c aspl.sha256
3

ثبّت الملف الواحد

لا توجد مكتبة تشغيل منفصلة ولا تبدأ عملية بناء برنامج C.

install -m 755 aspl ~/.local/bin/aspl
4

افحص برنامجاً

يبدأ المسار بـ check، ثم يوضح run و build في الصفحة نفسها.

aspl check hello.aspl
WCAG 2.2 AAهدف إصدار، لا شارة ادعاء
لوحة المفاتيحكل مسار وتشغيل وإيقاف وتبديل لغة واتجاه يعمل بلا مؤشر.
التركيز وإعادة التدفقتركيز ظاهر غير محجوب، أهداف مريحة، ومحتوى يعاد ترتيبه دون تمرير ثنائي المحور.
اللغة والاتجاهlang و dir صحيحان، والعبارات المقابلة الاتجاه معزولة، والمصدر يستخدم عرضاً مدركاً للرموز.
بوابة الإصدارفحص آلي، لوحة مفاتيح، قارئ شاشة، تكبير، واختبارات يدوية للنص العربي المختلط.

ابدأ بالكود. واتبع الخط.

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

اذهب إلى البرنامج
المحطة الأولى · شغّل
جاهز للتشغيل

main → i64 · لم يبدأ التنفيذ

المصدر والتنفيذ داخل المتصفحBytecode only · No Linux libraries · No ELF execution

المفاهيم على خط واحد.

1 / 4
البرنامج والدالة الرئيسيةملف واحد، دوال عليا، وحالة خروج محددة.
المرجع
2 / 4
الأنواع والربط والتدفقخمسة أنواع قابلة للتخزين ونتيجة وحدة.
المرجع
3 / 4
التشخيصات والفخاخهوية ثابتة، موقع آمن، وفشل مصنف.
المرجع
4 / 4
التوافق غير الآمن مع Cملفات تكييف دقيقة، تحميل متعجل، ومسؤولية صريحة.
دليل C

المرجع مخرج من كل دليل.

لا يفصل هذا البديل التعلم عن المرجع في صومعتين. كل مفهوم ينتهي برابط إلى العقد الكامل، وكل صفحة مرجعية تعود إلى مثال قابل للتشغيل.

المسارات

  • Lاللغة
  • CLIالأوامر والبناء
  • ERRالتشخيصات والفشل
  • FFIالتوافق مع C
  • HOSTقدرات المضيف

قاعدة نشر

  • تكافؤ الصفحاتنفس الشجرة والمثبتات والأمثلة في اللغتين.
  • العربية أولاًالعربية هي الافتراضية في التصفح والنتائج والأمثلة الأساسية.
  • لا ترجمة للمصدرمبدّل الواجهة لا يغيّر الكلمات أو الأسماء داخل المثال.
  • فرق المضيف ظاهركل مثال يحدد هل يعمل في المتصفح أو Linux أو كليهما.

محطة C لها بوابة تحذير.

يدعم MVP ملفي تكييف فقط: int(const char *) و double(double). كل تصريح وكل استدعاء يذكر غير_آمن صراحة.

libc.so.6 · puts
Linux أصلي فقطNo browser foreign imports

آخر محطة: أداة واحدة.

تتدرج صفحة التثبيت من توافق النظام إلى المجموع الاختباري ثم PATH وأول أمر. لا تخلط بناء ASPL للمساهمين بتثبيته للمستخدمين.

1

x86-64 + glibc

حد الدعم معلن قبل التنزيل.

2

ملف ومجموع

الإصدار والمجموع بجوار الملف نفسه.

3

ضعه على PATH

~/.local/bin/aspl
4

افحص hello.aspl

aspl check hello.aspl
WCAG 2.2 AAهدف الإصدار
اتجاه صحيحلغة واتجاه على مستوى الصفحة، وعزل للحقول المقابلة.
تشغيل كامل باللوحةمن المثال إلى الإيقاف والمرجع دون فخ تركيز.
حالة منطوقةالفحص والتشغيل والنتيجة تصل إلى التقنيات المساعدة.
اختبار بشريقارئ شاشة، تكبير، ولوحة مفاتيح مع نص عربي ولاتيني مختلط.

جرّب اللغة، ثم افتح العقد.

هذا البديل يجعل المرجع هو الهيكل الدائم للموقع، لكنه يبقي البرنامج العربي أول محتوى في الصفحة وأول إجراء واضح.

ارجع إلى زر التشغيل
مثال البداية
جاهز للتشغيل

main → i64 · لم يبدأ التنفيذ

المصدر والتنفيذ داخل المتصفحBytecode only · No Linux libraries · No ELF execution

التعلّم يختصر الطريق إلى المرجع.

أربع وحدات لمبرمج يعرف أساسيات C. لا منهج مبتدئين، ولا فصل بين شرح المفهوم وعقده الدقيق.

1 / 4

ابدأ

ملف واحد، main، و run.

2 / 4

ابنِ

الأنواع والربط والتدفق.

3 / 4

شخّص

الأسباب والمواقع والفخاخ.

4 / 4

اعبر إلى C

الحد غير الآمن وملفات التكييف.

شجرة مرجع واحدة.

تتطابق مسارات URL والعناوين والمثبتات بين النسختين. يظهر مبدّل اللغة في كل صفحة ويحافظ على المكان نفسه.

الأقسام

  • /languageاللغة
  • /cliسطر الأوامر
  • /diagnosticsالتشخيصات
  • /c-interopالتوافق مع C
  • /hostsقدرات المضيف
  • /limitsالحدود

قالب الصفحة

  • الخلاصةجملة دقيقة تقول ما يضمنه MVP.
  • الصيغةقواعد أو أمر أو سجل منظم قابل للنسخ.
  • مثالان متكافئانعربي أساسي وإنجليزي مكافئ، مع مثال مختلط عندما يوضح القاعدة.
  • الفشل والحدودالأسباب الثابتة، إصلاح آمن، وفروق المتصفح وLinux.

C: عقدان مدعومان، لا وعد مفتوح.

تضع صفحة C عبارة التوافق الكاملة قبل أول مثال. ثم تفصل التصريح، الاستدعاء، التحويل، عمر القيم، تحميل المكتبات، والفشل.

الملفان المدعومان هما int(const char *) و double(double). لا تحليل لترويسات C، ولا دوال متغيرة الوسائط، ولا توافق كامل مع C.

  1. 1التصريح غير آمن.
  2. 2كل استدعاء غير آمن.
  3. 3المكتبة والرمز حرفيان.
  4. 4التحميل يجري قبل main على Linux.
libc.so.6 · puts
مثال Linux، مرفوض في المتصفحforeign-imports-not-supported

التثبيت موثق كعملية تحقق.

لا يكتفي الدليل بأمر نسخ. يثبت حدود النظام والإصدار والمجموع وPATH، ثم يشغل check قبل run وbuild.

1

x86-64 Linux

glibc

2

الإصدار والمجموع

sha256sum -c
3

PATH

~/.local/bin
4

أول فحص

aspl check hello.aspl

الإتاحة شرط نشر.

الهدف WCAG 2.2 AA، مع اختبارات إضافية للنص ثنائي الاتجاه وعرض المصدر المدرك للرموز. لا تتحول النتيجة إلى شارة امتثال بلا تحقق الإصدار.

WCAG 2.2 AAالهدف
اللوحةكل الوظائف.
الاتجاهlang و dir وعزل الحقول.
الحالةإعلانات غير مرئية تعتمد على المعنى.
التحققآلي ويدوي وقارئ شاشة.