الوثائق/متقدم

كيف يعمل نيكسي

ماذا يحدث بين الملف الذي تكتبه والصفحة في المتصفح: الطبقات التي يتقاطع معها الطلب، ومن يبني ماذا، وماذا يترك Nexy لتطبيقك. لا تحتاج إلى هذه الصفحة للبدء؛ فهو يجيب على أسئلة "لماذا يعمل بهذه الطريقة" لاحقًا.

الطبقات

Browser
   │
   ▼
Uvicorn ───── ASGI transport
   │
   ▼
Middleware ── sessions, CORS, gzip, trusted hosts, your own
   │
   ▼
Router ────── FBR | Modular | Custom ── picks the file that answers
   │
   ▼
Renderer ──── HTML (Jinja2, Markdown, Node) or JSON
   │
   ▼
Response

من يبني ماذا

القاعدة خلف الطاولة: النكسي يبني ما يملك، ولا يجمع ما يجمع Vite أبدًا.

نظام التوجيه

المسار تحت src/routes/ يصبح عنوان URL بأربع قواعد:

لا يظهر الامتداد مطلقًا؛ index هو مسار المجلد الخاص به؛ مجلد بين قوسين يجمع الملفات دون إضافة مقطع.

عندما يتمكن شيئين من الإجابة على نفس عنوان URL، أول واحد مسجل يفوز، ويسجل Nexy دائمًا بهذا الترتيب:

1. نقطة نهاية الإجراءات؛
2. الملفات الثابتة: /public، /assets، /favicon.ico؛
3. معياري APIRouter (useRouter)؛
4. مسارات الملفات، الأكثر تحديدًا أولاً: المسارات الثابتة، ثم المسارات الديناميكية ذات المقاطع الأكثر ثباتًا، ثم رسائل التقاط الرسائل الخاطئة.

يتم تسجيل مسارين للملفات متساويين في الخصوصية بترتيب المسار الأبجدي، لذلك يجيب [id].nexy قبل [slug].nexy. وبالتالي فإن المسار المعياري يتفوق على الصفحة التي لها نفس المسار. هذا هو ترتيب الأسبقية الذي يمكنك الاعتماد عليه، وليس قاعدة فاصلة للعب بها: أعط عنوان URL واحدًا وملفًا واحدًا.

نظام المشاهدة

يحدد امتداد الملف ما هو عليه، ويقرر تكوين المشروع الامتدادات النشطة.

يتم تخطي الملف الذي لا يكون امتداده نشطًا مع تحذير، ولا يتم عرضه. في وضع العميل، يتم رفض .nexy قبل بدء تشغيل الخادم. انظر اصطلاحات الملفات.

دورة حياة العرض

ثلاثة أسئلة تقرر كل ما يلاحظه القارئ:

في وضع الخادم، يعرض الخادم كل صفحة، ويخزن revalidate صفحة واحدة مؤقتًا لكل عنوان URL، وتضيف الجزر JavaScript إلى مكون واحد. في وضع العميل، يتم عرض المستند الأول في Node ثم يتم التنقل في المتصفح.

__nexy__/ يحمل كل ما تم إنشاؤه: الصفحات المجمعة، وإدخال العميل، ومخرجات البناء. لا تقم بتحريره أبدًا، ولا تلتزم به أبدًا؛ احذفه لفرض بناء نظيف.

تكامل الواجهة الأمامية

Vite لا يحل محل Nexy. Vite يجمع ويخدم كود العميل. ولا يقوم بتوجيه طلب أو عرض صفحة .nexy أو تشغيل إجراء أو امتلاك الأصل. يتحدث المتصفح إلى أصل واحد - Nexy - وفي تطوير نقاط نهاية وكلاء Nexy Vite من خلاله، لذلك لا يوجد CORS لتكوينه.

Nexy لا يحل محل React. Nexy هو الذي يقرر أي مكون يتم عرضه، ومتى، وبأي دعم؛ يمتلك الإطار النموذج المكون والتفاعل والنظام البيئي. تستورد صفحة .nexy مكونًا كجزيرة؛ في وضع العميل، يكون المسار مكونًا.

بالنسبة لمسار المكون، يكتب Python فقط وحدة مجمعة رفيعة تشير إلى الملف. التجميع والعرض من جانب الخادم هما مهمة Vite.

التطوير والإنتاج

nx dev يتحقق من nexyconfig.py، ويجمع الصفحات، ويبدأ Vite عندما يكون للمشروع إطار عمل للواجهة الأمامية، ويعيد تشغيل الخادم عند الحفظ. nx build يقوم بنفس العمل مرة واحدة، قبل الموعد المحدد، و nx start يخدم النتيجة.

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

ما يتركه لك Nexy

يتوقف Nexy عند حافة التطبيق الخاص بك، عن قصد:

السبب هو نفسه بالنسبة لجميع الستة: إطار العمل الذي يختار ORM الخاص بك أو مكتبة المصادقة الخاصة بك تقرر الأشياء التي يمكن لتطبيقك فقط أن يقررها. التكلفة واضحة: لا يوجد شيء موصل لك، والأدلة المرتبطة في الجدول توضح مكان توصيل كل منها.

الخطوات التالية

• هيكل المشروع: حيث يعيش كل جزء في المشروع
• التوجيه : أجهزة التوجيه القائمة على الملفات والوحدات والمخصصة
• تقديم: SSR، ISR، CSR والجزر
• الواجهة الأمامية: Vite والتصميم وبناء العميل

انسخ الصفحة بصيغة Markdown حرِّر على GitHub