الوثائقالقائم على الملف
طرق ديناميكية
يتطابق مقطع المسار المكتوب بين قوسين مربعين مع أي قيمة ويسلمها إلى الصفحة أو المعالج.
القطاعات الديناميكية
blog/[slug].nexy يخدم /blog/{slug}. في الصفحة، قم بتعريف المقطع كخاصية؛ في معالج Python، اعتبره وسيطة.
slug: prop[str]<h1>{{ slug }}</h1>async def GET(id: int): return {"id": id}المقاطع المكتوبة
الشرح يحدد النوع.
| حيث | التحويل |
|---|---|
.py معالج |
أي نوع FastAPI تعليق توضيحي (int، UUID، Enum...) |
يتم تحويل .nexy صفحة |
int و float؛ كل شيء آخر يبقى سلسلة |
القيمة التي لا تتطابق مع التعليق التوضيحي هي لم يتم العثور عليها: /api/users/abc تجيب على 404، لأن المسار الديناميكي يلتقط أي عنوان URL وعنوان URL الذي لا يمكن تحويله ببساطة غير موجود. انظر التحقق والأخطاء.
قطاعات شاملة
docs/[...path].nexy يخدم /docs/{path:path}. تصل الأجزاء المتبقية كسلسلة واحدة، بما في ذلك الخطوط المائلة.
path: prop[str]<pre>{{ path }}</pre>/docs/a/b/c يعطي path == "a/b/c".
مجموعات الطريق
يقوم الدليل الموجود بين قوسين بتنظيم الملفات دون الظهور في عنوان URL. ولا يزال يشارك في الميراث: ينطبق layout.* و dependencies.py على ما في داخله.
استخدم المجموعات لمنح الأقسام المختلفة تخطيطات مختلفة دون تغيير عناوين URL الخاصة بها.
الأولوية
تتفوق المسارات الثابتة على المسارات الديناميكية، والمسارات الديناميكية على رسائل الصيد الشاملة: /blog/new تتطابق مع blog/new.nexy قبل blog/[slug].nexy.
ملف واحد لكل عنوان URL
يتم تسجيل ملفين يتم تحليلهما إلى نفس عنوان URL. لا تضع blog.nexy بجانب blog/index.nexy، أو تخلط index.nexy و index.py لنفس المسار.