التشغيل الأول

احفظ المصدر الصغير

اتبع أولا التثبيت والمتطلبات. تصف هذه التعليمات اللوحة 0.8.0 مع أداة لبات 0.7.0. تحقق من الإصدار المختار وتوافق الأداة قبل اتباع الخطوات.

حقائق الإصدار مرتبطة بالأرشيف المتحقق وسجل النشر. تحقق من بصمة الملفات قبل التثبيت.

أنشئ مجلد عمل بمدير الملفات، مثلا /home/samira/console-first-run. نزل المصدر الأصلي hello-en.aspl أدناه إلى المجلد أو احفظ نصه الدقيق بمحرر خارجي بترميز UTF-8. تشغل اللوحة المصدر المحفوظ؛ ليست محرر مصدر. تبقى المفردات الإنجليزية كما هي في لغتي التوثيق.

fn start_main() -> i64 {
    print("Your name?\n");
    let name: string = read_line();
    print("Hello, " + name + "\n");
    return 0;
}

يطبع البرنامج سؤالا ويقرأ سطرا واحدا ثم يطبع تحية ويرجع 0. لا يحتاج ملفات بيانات إضافية. يمكنك حفظ المصدر العربي المورّد المكافئ باسم hello-ar.aspl في المجلد نفسه:

دالة ابدأ_الرئيسية() -> ص64 {
    اطبع("ما اسمك؟\س").
    دع اسم: نص = اقرأ_سطر().
    اطبع("مرحباً، " + اسم + "\س").
    أرجع 0.
}

حدد مجلد اللوحة الحالي

ابدأ الملف التنفيذي داخل التثبيت الكامل مع أداة لبات المنفصلة. استبدل مساري التثبيت والأداة في المثال بمساريك الفعليين:

"$HOME/.local/opt/aspl-console-0.8.0-linux-x86_64/bin/aspl-console" --aspl "$HOME/.local/bin/aspl"

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

cd -- "/home/samira/console-first-run"
pwd

ينجح cd بصمت؛ يعرض pwd المجلد الفيزيائي المطلق. يحتفظ فشل cd بالمجلد السابق. يعمل الاسمان العربيان أيضا: انتقل ومسار. المسارات حرفية. لا توسع اللوحة ~ أو $HOME، فاستخدم المسار المطلق الفعلي هنا. راجع التنقل بين المجلدات.

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

شغل المصدر المحفوظ

أدخل عند محث الأوامر:

run -- hello-en.aspl

اضغط Enter للتحقق والبدء. للمصدر العربي استخدم تشغيل -- hello-ar.aspl أو run -- hello-ar.aspl. يفشل المصدر المفقود أو غير المقروء أو الأداة غير الصالحة أو المجلد غير الصالح دون بدء برنامج. صحح المسار أو الأداة المذكورة ثم أرسل مجددا. يكون المحث للقراءة فقط أثناء البدء والإنهاء النهائي. راجع عقد التشغيل الدقيق.

يمكنك بدلا من ذلك تمرير معامل مصدر عند بدء التطبيق من طرفية لينكس:

"$HOME/.local/opt/aspl-console-0.8.0-linux-x86_64/bin/aspl-console" --aspl "$HOME/.local/bin/aspl" "/home/samira/console-first-run/hello-en.aspl"

يملأ المعامل مسودة run -- بمسار مطلق مقتبس بأمان. لا يشغل المصدر. اضغط Enter على مسودة التشغيل للتحقق والبدء. لا يحدد معامل المصدر المجلد الحالي. لفحص المجلد أو تغييره أولا، احتفظ بمسار المصدر واستبدل المسودة بأمر pwd وأمر cd أعلاه، ثم أعد إدخال run -- مع مسار المصدر المطلق. يبقى الملف المفقود القابل للتمثيل مسودة حتى Enter. يترك المسار غير القابل للتمثيل محثا فارغا صالحا مع شرح. توضح خيارات بدء التطبيق الاقتباس وأولوية اختيار الأداة.

أرسل سطرا واحدا

حين يعرض stdout السؤال Your name? ويخص المحث التشغيل النشط، أدخل:

Samira

اضغط Enter لإرسال السطر. أكمل تركيب طريقة الإدخال أولا؛ قد يعتمد Enter التركيب بدلا من الإرسال. يكتب الإرسال النص الملتزم ونهاية سطر إلى البرنامج. قد يبقى الإرسال معلقا؛ قبول الإرسال لا يثبت أن البرنامج استهلكه. لا تعد إرسال إدخال غير مؤكد تلقائيا. إذا توقف التحرير، افتح الإعدادات بواسطة Ctrl+, وصحح مشكلة مسار الإدخال المذكورة واختر إعادة محاولة مسار الإدخال صراحة. يحتفظ بالتركيب غير المكتمل بشكل منفصل ولا تعيد المحاولة إرساله.

أثناء التشغيل، يكون النص الشبيه بالأوامر مثل help أو clear أو exit إدخالا للبرنامج. سيحيي برنامج المثال ذلك النص. لا تنفذ اللوحة النص كأمر حين يملك التشغيل المحث. يطلب Ctrl+D نهاية الإدخال ويطلب Ctrl+C الإيقاف في سياق التشغيل النشط. لا يتراجع الإيقاف عن الإدخال المسلم أو آثار البرنامج، وينتظر الاكتمال نتيجة ملاحظة. لا يحتاج هذا المثال ذو السطر الواحد هذين الإجراءين.

اقرأ النتيجة الملاحظة

للمصدر الإنجليزي المورّد والإدخال Samira يحتوي stdout:

Your name?
Hello, Samira

للمصدر العربي المورّد والإدخال نفسه:

ما اسمك؟
مرحباً، Samira

تسمي اللوحة stdout وstderr بشكل منفصل. بعد آخر ناتج تسجل حالة الخروج الملاحظة 0 وتعيد محث أوامر فارغا. تحقق من التحية وسجل النتيجة معا؛ رقم الخروج وحده لا يثبت النجاح. خطأ بدء العملية أو التحقق المسبق أو الإشراف نتيجة مختلفة. حين يعود محث الأوامر، أدخل help أو مساعدة للمتابعة.

السابق: التثبيت. تابع تشغيل البرامج والإدخال التفاعلي. لدروس اللغة، استخدم لبات بالعربية.