दस्तावेज़मॉडल को समझें
दृश्य
फ़ाइल प्रारूप चुनने से पहले, यह अंतर करना महत्वपूर्ण है कि नेक्सी संसाधनों को कैसे संभालती है और उन्हें कैसे प्रस्तुत करती है।
| अवधि | परिभाषा |
|---|---|
| पेज | एप्लिकेशन का एक यूआरएल-पता योग्य संसाधन। इसे src/routes/ के अंतर्गत एक फ़ाइल द्वारा परिभाषित किया गया है। |
| देखें | किसी पृष्ठ के लिए प्रतिक्रिया निकाय तैयार करने की प्रक्रिया। एक दृश्य तर्क और डेटा को HTML या JSON में बदल देता है। |
| घटक | एक पुन: प्रयोज्य यूआई बिल्डिंग ब्लॉक का उपयोग किसी दृश्य को बनाने के लिए किया जाता है। घटक मूल नेक्सी सहायक या फ्रेमवर्क-विशिष्ट (React, Vue, आदि) हो सकते हैं। |
| रूट हैंडलर | एक Python फ़ंक्शन जो एक विशिष्ट विधि के लिए HTTP अनुरोध को संभालता है (उदाहरण के लिए, GET, POST)। |
| समापन बिंदु | एक यूआरएल और एक HTTP विधि का अनूठा संयोजन जो एक रूट हैंडलर उत्तर देता है। |
निश्चित नहीं? एक .nexy फ़ाइल लिखें। इसके लिए किसी क्लाइंट फ्रेमवर्क की आवश्यकता नहीं है, और आप बाद में एक द्वीप के रूप में इसके अंदर एक React, Vue, Svelte, Solid या Preact घटक जोड़ सकते हैं।
.nexy(Python frontmatter + Jinja2).md(GitHub-flavoured Markdown).mdx(React or Preact).tsx .vue .svelte(framework files).py(GET, POST, …)प्रारूप
| प्रारूप | फ़ाइल | सर्वर रेंडर | ग्राहक ढाँचा | टिप्पणियाँ |
|---|---|---|---|---|
.nexy |
.nexy फ़ाइलें | Jinja2 + Python तर्क, स्ट्रीम किया गया | वैकल्पिक | नेटिव नेक्सी पेज प्रारूप |
.md |
Markdown और MDX | Markdown अनुरोध समय पर | लेआउट के माध्यम से वैकल्पिक | शुद्ध Markdown, जीएफएम, लेआउट-लिपटे |
.mdx |
Markdown और MDX | फ्रेमवर्क एसएसआर | React या Preact | Markdown घटकों के साथ |
.tsx |
React, Solid या Preact | क्लाइंट मोड: फ्रेमवर्क, नोड में प्रस्तुत किया गया | React, Solid या Preact | घटक मार्ग |
.vue |
Vue | क्लाइंट मोड: फ्रेमवर्क, नोड में प्रस्तुत किया गया | Vue | एसएफसी मार्ग |
.svelte |
Svelte | क्लाइंट मोड: फ्रेमवर्क, नोड में प्रस्तुत किया गया | Svelte | एसएफसी मार्ग |
अंतर्निहित Image, Link, Audio, Video और Import सहायक: घटक ।
मिश्रण प्रारूप
आप एक ही प्रोजेक्ट में विभिन्न तकनीकों को मिला सकते हैं:
- द्वीप: आप
.nexyपृष्ठ के अंदर एक React या Vue घटक आयात कर सकते हैं। सर्वर शेल को प्रस्तुत करता है, और फ्रेमवर्क क्लाइंट पर घटक को हाइड्रेट करता है। - साझा तर्क:
.pyफ़ाइलों में रूट हैंडलर साझा एप्लिकेशन स्थिति या एपीआई कॉल के माध्यम से किसी भी प्रारूप में पृष्ठों को डेटा प्रदान कर सकते हैं।
एक रूपरेखा सक्षम करें
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 सहायक