التوثيق
بنية المشروع
الملفات التي يتكوّن منها برنامج Orb، والملفات التي يكتبها المترجم.
في هذه الصفحة
يمكن أن يكون برنامج Orb ملف .lolo واحدًا. ومع نموه تنضم إليه ملفات قليلة، ويكتب المترجم ملفات أخرى لا تحرّرها أبدًا.
ما الذي تكتبه
text
my-app/
├── app.lolo the program: orbitals, entities, traits, pages
├── locales/
│ ├── en/my-app.json copy for (i18n/t "key") in each declared locale
│ └── ar/my-app.json
├── blocks/
│ └── Invoices.lolo your own building blocks, imported as "@app/blocks/Invoices"
└── public/ files copied as-is to the built site (logos, downloads).loloهي اللغة التي تكتبها، صياغة على طريقة Lisp: كل استدعاء لعامل قائمة بين قوسين(op args…).locales/<locale>/<app>.jsonيحمل نصوص كل لغة يعلنها البرنامج بـlocales [en, ar, sl]. راجع التوطين.blocks/يحمل وحدات البناء التي تستوردها بـuses X from "@app/blocks/<Name>".public "./public"في ترويسةappيحدد مجلدًا يُنسخ كما هو إلى جذر الموقع المبني.
ما الذي يكتبه المترجم
.orbهو صيغة JSON للبرنامج: تنخفض إليه.loloدون فقد، وهو ما تقرؤه بيئة التشغيل والمدقق. الأمرorb emit orb app.loloيطبعه.orb resolve app.lolo --output app.orbيكتب البرنامج محلولًا بالكامل: كل استيراد مسطّح وكل مرجع مضمَّن. البرنامج الذي يستخدمuses lazyيحصل أيضًا على مجلدlazy/فيه ملف.orbلكل سلوك يُحمَّل عند الحاجة، والبرنامج الذي يعلنlocalesيحصل على كتالوج مدمج لكل لغة بجانبه.orb compileيكتب تطبيقًا كاملًا (TypeScript افتراضيًا) في--output. لا تحرّره أبدًا: غيّر البرنامج وترجمه مجددًا.
الاستيراد
يحدد uses مصدر السلوك:
text
uses Browse from "std/behaviors/std-browse" the public standard library
uses Invoices from "@app/blocks/Invoices" your own blocks
uses lazy Guide from "./guide" loaded only when one of its pages opensحزم السلوكيات مثبَّتة لا مدمجة: orb list يعرض المتاح، وorb add <package> يضيف حزمة إلى مشروع.
التالي
صفحة الكيانات تبدأ جولة اللغة.
Not reported here