الوثائقفهم النموذج
وجهات النظر
قبل اختيار تنسيق الملف، من المهم التمييز بين كيفية تعامل Nexy مع الموارد وكيفية عرضها.
| مصطلح | التعريف |
|---|---|
| الصفحة | مورد يمكن عنونة URL للتطبيق. يتم تعريفه بواسطة ملف تحت src/routes/. |
| عرض | عملية إنتاج نص الاستجابة للصفحة. يقوم العرض بتحويل المنطق والبيانات إلى HTML أو JSON. |
| المكون | كتلة بناء لواجهة المستخدم قابلة لإعادة الاستخدام تُستخدم لإنشاء طريقة عرض. يمكن أن تكون المكونات مساعدات Nexy أصلية أو خاصة بإطار العمل (React، Vue، وما إلى ذلك). |
| معالج المسار | دالة Python تعالج طلب HTTP لطريقة محددة (على سبيل المثال، GET، POST). |
| نقطة النهاية | المزيج الفريد من عنوان URL وطريقة HTTP التي يجيب عليها معالج المسار. |
لست متأكدا؟ اكتب ملف .nexy. لا يحتاج إلى إطار عمل للعميل، ويمكنك إضافة مكون React أو Vue أو Svelte أو Solid أو Preact بداخله لاحقًا، كجزيرة.
server logic + HTML
.nexy(Python frontmatter + Jinja2)prose that changes rarely
.md(GitHub-flavoured Markdown)prose + components
.mdx(React or Preact)app-like page, client router
.tsx .vue .svelte(framework files)API handler
.py(GET, POST, …)التنسيقات
| التنسيق | ملف | تقديم الخادم | إطار العميل | ملاحظات |
|---|---|---|---|---|
.nexy |
ملفات .nexy | Jinja2 + Python منطق، متدفق | اختياري | تنسيق صفحة Nexy الأصلي |
.md |
Markdown و MDX | Markdown عند الطلب | اختياري عبر التخطيط | نقي Markdown، GFM، مغلف بالتخطيط |
.mdx |
Markdown و MDX | الإطار SSR | React أو Preact | Markdown بالمكونات |
.tsx |
React ، Solid أو Preact | وضع العميل: الإطار المعروض في Node | React أو Solid أو Preact | طرق المكونات |
.vue |
Vue | وضع العميل: الإطار المعروض في Node | Vue | طرق SFC |
.svelte |
Svelte | وضع العميل: الإطار المعروض في Node | Svelte | طرق SFC |
المساعدين المدمجين Image، Link، Audio، Video و Import: المكونات.
تنسيقات الخلط
يمكنك مزج تقنيات مختلفة في نفس المشروع:
- الجزر: يمكنك استيراد مكون React أو Vue داخل صفحة
.nexy. يعرض الخادم الصدفة، ويقوم إطار العمل بترطيب المكون الموجود على العميل. - المنطق المشترك: يمكن لمعالجات المسار في ملفات
.pyتوفير البيانات للصفحات بأي تنسيق عبر حالة التطبيق المشترك أو استدعاءات واجهة برمجة التطبيقات (API).
تمكين الإطار
قم بتعيين useFF في nexyconfig.py وقم بتشغيل nexy new لإضافة التبعيات:
from nexy.core.models import NexyConfigModelfrom nexy.frontend import react class NexyConfig(NexyConfigModel): useFF = react()مع تمكين إطار العمل، يتعامل Vite مع حزم العملاء الخاصة به. في وضع العميل، تصبح امتداداته مسارات؛ في وضع الخادم، تكون نفس الملفات عبارة عن مكونات تقوم باستيرادها كجزر - حيث يتم رفض ملف إطار العمل ضمن src/routes/ هناك. انظر وضع الخادم ووضع العميل.
التخطيطات
layout.* في الدليل يلتف الصفحات الموجودة أسفله. انظر التخطيطات.
الخطوات التالية
- ملفات .nexy: Python + Jinja2 + الدعائم
- Markdown و MDX: صفحات المحتوى
- المكونات: مساعدات HTML المضمنة