दस्तावेज़टूलींग और सहायता
समस्या निवारण
लोग सबसे पहले जिन समस्याओं से जूझते हैं, वे हैं आप क्या देखते हैं और क्या करना है। प्रत्येक व्यक्ति वास्तविक दौड़ से आता है।
एक पृष्ठ का उत्तर 404 है लेकिन इसकी फ़ाइल मौजूद है
उस टर्मिनल को देखें जो nx dev या nx start चलाता है। जब कोई पृष्ठ आयात नहीं किया जा सकता है, तो नेक्सी अपनी फ़ाइल और लाइन के साथ त्रुटि की रिपोर्ट करती है, और मार्ग पंजीकृत नहीं होता है:
nexy » error __nexy__/src/routes/index.py:18 ImportError: cannot import name 'FrameworkLogo' ...वहां नामित आयात को ठीक करें। सामान्य कारण एक घटक है जिसका फ़ंक्शन नाम आपके द्वारा आयात किए गए से मेल नहीं खाता है (अगला आइटम देखें) और पथ में एक टाइपो।
एक .nexy पृष्ठ संकलित नहीं होता: "तर्क पार्स त्रुटि"
src/components/live-panel.nexy - Logic Parse Error: invalid syntaxएक .nexy घटक को Python मॉड्यूल के रूप में आयात किया जाता है, इसलिए इसका फ़ाइल नाम एक वैध नाम होना चाहिए। एक हाइफ़न नहीं है. इसे पास्कलकेस में नाम दें, LivePanel.nexy, और इसे उसी नाम से आयात करें:
from "@/components/LivePanel.nexy" import LivePanelएक घटक अपने बच्चों को पाठ के रूप में प्रस्तुत करता है <slot />
एक .nexy घटक अपने बच्चों को बड़े अक्षर एस के साथ <Slot /> के साथ रखता है। एक लोअरकेस <slot /> को पृष्ठ में वैसे ही छोड़ दिया जाता है। Vue, जिसका अपना <slot /> है, प्रभावित नहीं होता है।
एक प्रोप वेरिएबल का नाम दिखाता है
<Icon path=icon /> renders: icon<Icon path="{{ icon }}" /> renders: the value of iconबिना ब्रेसिज़ वाला एक गुण टेक्स्ट है। परिकलित मान को पास करने के लिए विशेषता में Jinja अभिव्यक्ति डालें।
{{ ... }} में एक मान खाली हो जाता है
Jinja2 एक अपरिभाषित चर छुपाता है। फ्रंटमैटर (title: prop[str] = "") में आपके द्वारा उपयोग की जाने वाली प्रत्येक संपत्ति की घोषणा करें, और वर्तनी की जांच करें।
.nexy पृष्ठ (UnoCSS) में उपयोगिता कक्षाओं का कोई प्रभाव नहीं पड़ता है
UnoCSS किसी फ़ाइल को तभी पढ़ता है जब उसका एक्सटेंशन उसकी सामग्री पाइपलाइन में होता है। nx new द्वारा UnoCSS के साथ बनाया गया एक सर्वर प्रोजेक्ट पहले से ही .nexy को सूचीबद्ध करता है; एक वृद्ध को इसकी आवश्यकता है uno.config.ts:
content: { filesystem: ['src/**/*.nexy'], pipeline: { include: [/\.(vue|svelte|[jt]sx|mdx?|astro|html|nexy)($|\?)/] },},Tailwind अपने आप ही .nexy फ़ाइलें ढूंढ लेता है।
एक .mdx पेज पैकेज मांगता है
[nexy] MDX support requires optional packages that are not installed.उन्हें प्रोजेक्ट में स्थापित करें: @mdx-js/rollup, remark-gfm और @mdx-js/react (nx build के लिए प्लस @mdx-js/esbuild)। MDX को useFF में React या Preact की आवश्यकता है। क्लाइंट फ़्रेमवर्क के बिना, पृष्ठ को .md के रूप में लिखें। Markdown और MDX देखें।
No module named 'sqlmodel' (या कोई पैकेज) जब कोई कमांड शुरू होता है
nexy » nexyconfig.py cannot be loaded: No module named 'sqlmodel'. If it is a package, install itin this Python (...) or activate the project's virtual environment.आदेश ग़लत चला गया Python। आपके प्रोजेक्ट के पैकेज (आपका ORM, आपकी लाइब्रेरी) इसके .venv में हैं, और uvx nexy या एक वैश्विक nexy अपने स्वयं के वातावरण में चलता है जिसमें इनमें से कोई भी नहीं है।
प्रोजेक्ट फ़ोल्डर से प्रोजेक्ट के वर्चुअल वातावरण को सक्रिय करें, फिर कमांड फिर से चलाएँ:
.venv\Scripts\activate # Windows; on macOS and Linux: source .venv/bin/activatenexy devसक्रिय होने पर प्रॉम्प्ट (.venv) से शुरू होता है। या uv run nexy dev के साथ सक्रियण को छोड़ दें। यदि पैकेज वास्तव में प्रोजेक्ट से गायब है, तो इसे uv add sqlmodel के साथ जोड़ें।
nx dev एक त्रुटि दिखाता है और प्रतीक्षा करता है
जब आपका एप्लिकेशन प्रारंभ नहीं हो पाता, nx dev रिपोर्ट करता है कि क्यों और अगले फ़ाइल परिवर्तन की प्रतीक्षा करता है; यह बाहर नहीं निकलता. फ़ाइल को ठीक करें और सहेजें. केवल Ctrl+C ही इसे रोकता है।
बंदरगाह व्यस्त है
nx dev अगला मुफ़्त पोर्ट लेता है और उसे प्रिंट करता है। किसी एक को चुनने के लिए, --port का उपयोग करें या usePort को nexyconfig.py में सेट करें।
थीम एक अंधेरे पृष्ठ पर सफेद रंग में चमकती है
सहेजी गई थीम को पहले पेंट से पहले लागू किया जाना चाहिए। स्टार्टर की छोटी स्क्रिप्ट को रूट लेआउट के <head> में रखें, और React में suppressHydrationWarning को <html> पर रखें।
अभी भी अटका हुआ है
- दस्तावेज़ीकरण सूचकांक में फ़ीचर का पृष्ठ पढ़ें।
- यदि दस्तावेज़ और कोड असहमत हैं, तो कोड सही है: कृपया पृष्ठ का नामकरण करते हुए एक अंक खोलें।