دستاویزاتماڈل کو سمجھیں۔

مناظر

فائل فارمیٹ کو منتخب کرنے سے پہلے، یہ فرق کرنا ضروری ہے کہ Nexy وسائل کو کیسے ہینڈل کرتا ہے اور اسے کیسے پیش کرتا ہے۔

مدت	تعریف
صفحہ	ایپلیکیشن کا ایک URL ایڈریس ایبل وسیلہ۔ اس کی تعریف `src/routes/` کے تحت فائل کے ذریعے کی گئی ہے۔
دیکھیں	ایک صفحہ کے لیے رسپانس باڈی تیار کرنے کا عمل۔ ایک منظر منطق اور ڈیٹا کو HTML یا JSON میں تبدیل کرتا ہے۔
جزو	ایک دوبارہ قابل استعمال UI بلڈنگ بلاک جو منظر تحریر کرنے کے لیے استعمال ہوتا ہے۔ اجزاء مقامی Nexy مددگار یا فریم ورک کے لیے مخصوص (React، Vue، وغیرہ) ہو سکتے ہیں۔
روٹ ہینڈلر	ایک Python فنکشن جو ایک مخصوص طریقہ (جیسے، `GET`، `POST`) کے لیے HTTP درخواست کو ہینڈل کرتا ہے۔
نقطہ اختتام	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	کلائنٹ موڈ: فریم ورک، نوڈ میں پیش کیا گیا ہے۔	React، Solid یا Preact	اجزاء کے راستے
`.vue`	Vue	کلائنٹ موڈ: فریم ورک، نوڈ میں پیش کیا گیا ہے۔	Vue	ایس ایف سی کے راستے
`.svelte`	Svelte	کلائنٹ موڈ: فریم ورک، نوڈ میں پیش کیا گیا ہے۔	Svelte	ایس ایف سی کے راستے

بلٹ ان Image، Link، Audio، Video اور Import مددگار: اجزاء۔

اختلاط کی شکلیں

آپ ایک ہی پروجیکٹ میں مختلف ٹیکنالوجیز کو ملا سکتے ہیں:

جزائر: آپ React یا Vue ایک .nexy صفحہ کے اندر ایک جزو درآمد کر سکتے ہیں۔ سرور شیل کو پیش کرتا ہے، اور فریم ورک کلائنٹ پر جزو کو ہائیڈریٹ کرتا ہے۔
مشترکہ منطق: .py فائلوں میں روٹ ہینڈلرز مشترکہ ایپلیکیشن اسٹیٹ یا API کالز کے ذریعے کسی بھی فارمیٹ میں صفحات کو ڈیٹا فراہم کر سکتے ہیں۔

ایک فریم ورک کو فعال کریں۔

useFF کو nexyconfig.py میں سیٹ کریں اور انحصار شامل کرنے کے لیے nexy new چلائیں:

nexyconfig.py

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

ایک فریم ورک کو فعال کرنے کے ساتھ، Vite اپنے کلائنٹ بنڈلز کو ہینڈل کرتا ہے۔ کلائنٹ موڈ میں اس کی ایکسٹینشن روٹس بن جاتی ہے۔ سرور موڈ میں وہی فائلیں ہیں جو آپ جزائر کے طور پر درآمد کرتے ہیں - src/routes/ کے تحت ایک فریم ورک فائل وہاں مسترد کردی جاتی ہے۔ دیکھیں سرور موڈ اور کلائنٹ موڈ۔

لے آؤٹ

ڈائرکٹری میں ایک layout.* اس کے نیچے صفحات لپیٹتا ہے۔ دیکھیں لے آؤٹس۔

اگلے اقدامات

.nexy فائلیں: Python + Jinja2 + props
Markdown اور MDX: مواد کے صفحات
اجزاء: بلٹ ان HTML مددگار

GitHub پر ترمیم کریں