दस्तावेज़परंपराएँ और अवधारणाएँ
शब्दावली
इन दस्तावेज़ों में जिन शब्दों का उपयोग किया गया है, वे वर्णमाला क्रम में एक-एक पंक्ति में हैं। जिस शब्द के लिए एक पंक्ति से अधिक की आवश्यकता होती है उसमें एक पृष्ठ होता है: लिंक का अनुसरण करें। यह जानने के लिए कि धारणाएँ एक साथ कैसे फिट होती हैं, मुख्य अवधारणाएँ पढ़ें।
शर्तें
| अवधि | एक पंक्ति में |
|---|---|
| कार्रवाई | एक Python फ़ंक्शन को @Action के रूप में चिह्नित किया गया है, जो POST के रूप में कार्य करता है और क्लाइंट से कॉल करने योग्य है (क्रियाएं) |
| एएसजीआई | इंटरफ़ेस Uvicorn बोलता है, FastAPI और Starlette द्वारा कार्यान्वित किया जाता है |
| क्लाइंट मोड | useCSR = True: फ्रेमवर्क फ़ाइलें मार्ग हैं और ब्राउज़र नेविगेट करता है (मोड) |
| घटक | एक पुन: प्रयोज्य यूआई बिल्डिंग ब्लॉक का उपयोग एक दृश्य बनाने के लिए किया जाता है (विचार) |
| सीएसआर | क्लाइंट-साइड रेंडरिंग: ब्राउज़र पहले दस्तावेज़ के बाद पेजों को रेंडर करता है (सीएसआर) |
| निर्भरता | एक फ़ंक्शन FastAPI एक हैंडलर से पहले चलता है, प्रति रूट या प्रति फ़ोल्डर (निर्भरताएं) |
| दस्तावेज़ खोल | <html>, <head> और <body> एक पृष्ठ के आसपास, निकटतम लेआउट के स्वामित्व में या नेक्सी के पास (लेआउट्स) |
| समापन बिंदु | एक यूआरएल और एक HTTP विधि का अनूठा संयोजन (विचार) |
| एफबीआर | फ़ाइल-आधारित रूटिंग: src/routes/ के अंतर्गत एक फ़ाइल एक रूट है (रूटिंग) |
| फ्रंटमैटर | Python एक .nexy या .md फ़ाइल की दो --- पंक्तियों के बीच का ब्लॉक (.nexy फ़ाइलें) |
| रक्षक | एक निर्भरता जो HTTPException (गार्ड) बढ़ाकर अनुरोध को अस्वीकार कर देती है |
| हैंडलर | एक Python फ़ंक्शन जो एक विशिष्ट विधि के लिए HTTP अनुरोध को संभालता है (विचार) |
| एचएमआर | हॉट मॉड्यूल प्रतिस्थापन: डेव सर्वर पूर्ण पुनः लोड किए बिना, बदले गए मॉड्यूल को स्वैप करता है (फ्रंटएंड) |
| जलयोजन | ब्राउज़र HTML में एक फ़्रेमवर्क संलग्न कर रहा है जिसे सर्वर ने पहले ही भेज दिया है (द्वीप) |
| द्वीप | एक सर्वर-रेंडर पेज के अंदर माउंट किया गया एक क्लाइंट घटक (द्वीप) |
| आईएसआर | वृद्धिशील स्थैतिक पुनर्जनन: प्रति पथ एक कैश्ड पृष्ठ, पृष्ठभूमि में ताज़ा (आईएसआर) |
| लेआउट | एक layout.* फ़ाइल जो अपने फ़ोल्डर के नीचे पृष्ठों को लपेटती है (लेआउट) |
| मॉड्यूलर राउटर | src/apps/ (मॉड्यूलर) के अंतर्गत @Module और @Controller के साथ घोषित मार्ग |
| पेज | src/routes/ (विचार) के अंतर्गत एक फ़ाइल द्वारा परिभाषित एक यूआरएल-पता योग्य संसाधन |
| प्रीफ़ेच | पाठक द्वारा लिंक पर क्लिक करने से पहले पेज को उसके पीछे लोड करना (लिंक करना) |
| सहारा | वे मान जो माता-पिता किसी घटक को देते हैं (.nexy फ़ाइलें) |
| पुन: सत्यापित करें | सेकंड की संख्या जिसके बाद पृष्ठभूमि में एक आईएसआर पेज फिर से बनाया जाता है (आईएसआर) |
| मार्ग | एक यूआरएल पैटर्न, जो रूट फ़ाइल के पथ द्वारा निर्मित होता है (रूटिंग) |
| मार्ग समूह | कोष्ठक में एक फ़ोल्डर जो खंड जोड़े बिना मार्गों को समूहित करता है (गतिशील मार्ग) |
| रूट हैंडलर | GET, POST, ... .py रूट फ़ाइल का फ़ंक्शन (हैंडलर ) |
| सर्वर मोड | useCSR = False, डिफ़ॉल्ट: सर्वर .nexy और .md पेज (मोड) प्रस्तुत करता है |
| कौशल | SKILL.md वाला एक फ़ोल्डर जो एक कोडिंग एजेंट को नेक्सी का एक भाग सिखाता है (कोडिंग एजेंट ) |
| एसएसजी | स्थैतिक साइट निर्माण; नेक्सी मोड नहीं: समय से पहले बनाया गया HTML हमेशा सर्वर द्वारा वापस पढ़ा जाता है (रेंडरिंग) |
| एसएसआर | सर्वर-साइड रेंडरिंग: सर्वर अपने अनुरोध के लिए प्रत्येक पेज को रेंडर करता है, और यह डिफ़ॉल्ट है (एसएसआर) |
| देखें | किसी पृष्ठ के लिए प्रतिक्रिया निकाय तैयार करने की प्रक्रिया (विचार) |
फ़ाइलें और फ़ोल्डर्स
| नाम | एक पंक्ति में |
|---|---|
__nexy__/ |
उत्पन्न आउटपुट: संकलित पृष्ठ, क्लाइंट प्रविष्टि और एक्शन क्लाइंट; कभी संपादित नहीं, कभी प्रतिबद्ध नहीं |
nexyconfig.py |
प्रोजेक्ट कॉन्फ़िगरेशन, use* फ़ील्ड्स का एक वर्ग (कॉन्फ़िगरेशन) |
public/ |
रूट पर परोसी जाने वाली फ़ाइलें, जैसे कि public/logo.svg → /logo.svg (फ़ाइल कन्वेंशन) |
src/apps/ |
मॉड्यूलर राउटर के नियंत्रक और मॉड्यूल (मॉड्यूलर) |
src/components/ |
पृष्ठों द्वारा आयातित घटक; कभी रूट नहीं (फ़ाइल कन्वेंशन) |
src/routes/ |
एप्लिकेशन के मार्ग (फ़ाइल कन्वेंशन) |
अगले चरण
- मूल अवधारणाएँ: वह मॉडल जिससे ये शब्द संबंधित हैं
- दस्तावेज़ीकरण सूचकांक: मौजूदा कार्य के लिए पृष्ठ
- फ़ाइल कन्वेंशन: इन परिभाषाओं के पीछे आरक्षित नाम
- एआई एजेंटों के लिए: वही अपरिवर्तनीय, जो एक एजेंट के लिए लिखा गया है