الوثائقالقائم على الملف

وضع الخادم ووضع العميل

مشروع Nexy هو إما يتم تقديمه بواسطة الخادم أو يتم توجيهه بواسطة العميل، مثل مشروع Next.js يكون إما صفحات يتم عرضها على الخادم أو تطبيق عميل. useCSR في nexyconfig.py يختار.

وضع الخادم (`useCSR = False`)

nexyconfig.py

from nexy.core.models import NexyConfigModelfrom nexy.frontend import react  class NexyConfig(NexyConfigModel):    useFF = react()

الصفحات هي .nexy، .md أو .mdx ملفات ضمن src/routes/.
الجذر layout.nexy يملك <!DOCTYPE html>، <html>، <head>، و <body>.
يُسمح بمكونات العميل (React أو Vue أو Svelte أو Solid أو Preact) كـ جزر: يمكنك استيراد واحدة من صفحة .nexy ويتم ترطيبها في المتصفح. انظر الجزر.
مكون العميل ليس طريقًا أبدًا. احتفظ بها في src/components/.
إطار عميل واحد في كل مرة.

src/

routes/

layout.nexydocument

index.nexypage

api/users.pyAPI handler

components/Counter.tsx island

وضع العميل (`useCSR = True`)

nexyconfig.py

class NexyConfig(NexyConfigModel):    useFF = react()    useCSR = True

الصفحات هي ملفات إطار عمل العميل الخاص بك: .tsx لـ React، .vue، .svelte.
تظل ملفات .md و .mdx بمثابة مسارات صالحة: يعرضها Nexy على الخادم داخل تخطيط العميل، ويتولى جهاز توجيه العميل التنقل من هناك.
يمتلك التخطيط الجذر لأي إطار عمل (layout.tsx، layout.vue، layout.svelte) <!DOCTYPE html>، <html>، <head> و <body>، مثل التخطيط الجذري لجهاز توجيه التطبيقات Next.js. يقوم Nexy بعرضه في Node للاستجابة الأولى ويقوم الإطار بترطيب المستند بأكمله. انظر layout.tsx.
.py الملفات هي معالجات واجهة برمجة التطبيقات (API) التي يتم تقديمها بواسطة FastAPI، بجوار مسارات العميل.
لا يوجد ملف .nexy على الإطلاق، ولا يوجد layout.nexy.
يتم التنقل بين الصفحات في المتصفح.

src/routes/

layout.tsxdocument

index.tsxpage

users.tsxpage

api/users.pyAPI handler

ما مرفوض

يقوم Nexy بفحص المشروع قبل nx dev و nx start و nx build ويتوقف عند قائمة الملفات:

وضع	مرفوض	رسالة
الخادم	`.tsx`، `.jsx`، `.vue` أو `.svelte` ضمن `src/routes/`	انقل المكونات إلى `src/components/`، أو قم بتعيين `useCSR = True`
العميل	أي ملف `.nexy` ضمن `src/routes/`	كتابته كمكونات إطار عمل، أو تعيين `useCSR = False`
كلا	أكثر من إطار أمامي واحد في `useFF`	`useFF must configure exactly one frontend framework`
العميل	`useRouter` (جهاز التوجيه المعياري)	`useCSR requires file-based routing`
العميل	لا `useFF`	`useCSR requires a client framework`

يتم تجاهل الملفات والمجلدات التي تبدأ بـ _ أو . من خلال هذا الفحص.

أي واحد

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

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

حرِّر على GitHub