الوثائقالاتفاقيات والمفاهيم
مسرد
الكلمات التي تستخدمها هذه المستندات، سطر واحد لكل منها، بالترتيب الأبجدي. مصطلح يحتاج إلى أكثر من سطر له صفحة: اتبع الرابط. للتعرف على كيفية توافق المفاهيم معًا، اقرأ المفاهيم الأساسية.
الشروط
| المصطلح | في سطر واحد |
|---|---|
| الإجراء | وظيفة Python تم وضع علامة @Action، بمثابة POST وقابلة للاستدعاء من العميل (الإجراءات) |
| ASGI | الواجهة Uvicorn تتحدث، يتم تنفيذها بواسطة FastAPI و Starlette |
| وضع العميل | useCSR = True: ملفات إطار العمل هي المسارات التي يتنقل بها المتصفح (الأوضاع) |
| المكون | كتلة بناء لواجهة المستخدم قابلة لإعادة الاستخدام تُستخدم لإنشاء طريقة عرض (طرق العرض) |
| CSR | العرض من جانب العميل: يعرض المتصفح الصفحات بعد المستند الأول (CSR) |
| التبعية | يتم تشغيل الوظيفة FastAPI قبل المعالج، لكل مسار أو لكل مجلد (التبعيات) |
| غلاف المستند | و <html> و <head> و <body> حول الصفحة، مملوك لأقرب تخطيط أو Nexy (تخطيطات) |
| نقطة النهاية | مزيج فريد من عنوان URL وطريقة HTTP (المشاهدات) |
| FBR | التوجيه المستند إلى الملف: الملف الموجود ضمن src/routes/ هو مسار (توجيه) |
| Frontmatter | الكتلة Python بين السطرين --- لملف .nexy أو .md (ملفات .nexy) |
| حراسة | تبعية ترفض الطلب عن طريق رفع HTTPException (الحراس) |
| المعالج | وظيفة Python التي تعالج طلب HTTP لطريقة معينة (المشاهدات) |
| HMR | استبدال الوحدة الساخنة: يقوم خادم التطوير بتبديل الوحدات التي تم تغييرها، دون إعادة تحميل كاملة (الواجهة الأمامية) |
| الترطيب | المتصفح الذي يرفق إطار عمل بـ HTML الذي أرسله الخادم بالفعل (الجزر) |
| الجزيرة | مكون العميل المثبت داخل الصفحة المعروضة بواسطة الخادم (الجزر) |
| ISR | التجديد الثابت التزايدي: صفحة واحدة مخبأة لكل مسار، يتم تحديثها في الخلفية (ISR) |
| التخطيط | ملف layout.* الذي يغلف الصفحات الموجودة أسفل مجلده (التخطيطات) |
| تم الإعلان عن مسارات جهاز التوجيه المعياري | بـ @Module و @Controller ضمن src/apps/ (المعياري) |
| صفحة | مورد يمكن عنونة عنوان URL محدد بواسطة ملف ضمن src/routes/ (المشاهدات) |
| الجلب المسبق | تحميل الصفحة خلف الرابط قبل أن ينقر القارئ عليها (ربط) |
| الدعائم | القيم التي يمررها أحد الوالدين إلى المكون (ملفات .nexy) |
| إعادة التحقق من | عدد الثواني التي يتم بعدها إعادة إنشاء صفحة ISR في الخلفية (ISR) |
| توجيه | نمط عنوان URL، الناتج عن مسار ملف التوجيه (توجيه) |
| مجموعة التوجيه | مجلد بين قوسين يقوم بتجميع المسارات دون إضافة مقطع (المسارات الديناميكية) |
| معالج المسار | وظيفة GET، POST، ... لملف المسار .py (معالجات) |
| وضع الخادم | useCSR = False، الافتراضي: يعرض الخادم .nexy و .md الصفحات (الأوضاع) |
| المهارة | مجلد به SKILL.md يعلم وكيل الترميز جزءًا واحدًا من Nexy (وكلاء الترميز) |
| SSG | إنشاء موقع ثابت؛ ليس وضع Nexy: تتم دائمًا قراءة HTML الذي تم إنشاؤه مسبقًا بواسطة الخادم (تقديم) |
| SSR | العرض من جانب الخادم: يعرض الخادم كل صفحة لطلبه، وهو الافتراضي (SSR) |
| مشاهدة | عملية إنتاج نص الاستجابة للصفحة (المشاهدات) |
الملفات والمجلدات
| الاسم | في سطر واحد |
|---|---|
__nexy__/ |
المخرجات المولدة: الصفحات المجمعة، وإدخال العميل وعميل الإجراء؛ لم يتم تحريره مطلقًا، ولم يتم الالتزام به مطلقًا |
nexyconfig.py |
تكوين المشروع، فئة use* الحقول (الإعداد) |
public/ |
الملفات المقدمة في الجذر، مثل public/logo.svg → /logo.svg (اصطلاحات الملفات) |
src/apps/ |
وحدات التحكم والوحدات النمطية لجهاز التوجيه المعياري (المعياري) |
src/components/ |
المكونات المستوردة بالصفحات؛ لا يوجه أبدًا (اصطلاحات الملف) |
src/routes/ |
مسارات التطبيق (اصطلاحات الملف) |
الخطوات التالية
- المفاهيم الأساسية: النموذج الذي تنتمي إليه هذه الكلمات
- فهرس التوثيق]: صفحة المهمة المطروحة
- اصطلاحات الملفات: الأسماء المحجوزة وراء هذه التعريفات
- بالنسبة لوكلاء الذكاء الاصطناعي: نفس الثوابت، مكتوبة للوكيل