ডকুমেন্টেশন/উন্নত

Nexy কিভাবে কাজ করে

আপনার লেখা একটি ফাইল এবং ব্রাউজারে পৃষ্ঠার মধ্যে কী ঘটে: একটি অনুরোধ যে স্তরগুলি অতিক্রম করে, কে কী তৈরি করে এবং Nexy আপনার অ্যাপ্লিকেশনে কী রেখে যায়৷ শুরু করার জন্য আপনার এই পৃষ্ঠার প্রয়োজন নেই; এটি পরে "কেন এটি এমন কাজ করে" প্রশ্নের উত্তর দেয়।

স্তরগুলো

Browser
   │
   ▼
Uvicorn ───── ASGI transport
   │
   ▼
Middleware ── sessions, CORS, gzip, trusted hosts, your own
   │
   ▼
Router ────── FBR | Modular | Custom ── picks the file that answers
   │
   ▼
Renderer ──── HTML (Jinja2, Markdown, Node) or JSON
   │
   ▼
Response

কে কি নির্মাণ করে

টেবিলের পিছনের নিয়ম: Nexy যা তার মালিকানা তৈরি করে এবং যা Vite কম্পাইল করে তা কখনই কম্পাইল করে না।

রাউটিং সিস্টেম

src/routes/ এর অধীনে একটি পাথ চারটি নিয়ম দ্বারা একটি URL হয়ে যায়:

এক্সটেনশন কখনই দেখা যায় না; index হল এর ফোল্ডারের রুট; বন্ধনীতে থাকা একটি ফোল্ডার একটি সেগমেন্ট যোগ না করে ফাইলগুলিকে গোষ্ঠীভুক্ত করে।

যখন দুটি জিনিস একই URL এর উত্তর দিতে পারে, প্রথমটি নিবন্ধিত জয়ী হয়, এবং Nexy সর্বদা এই ক্রমে নিবন্ধন করে:

1. অ্যাকশন এন্ডপয়েন্ট;
2. স্ট্যাটিক ফাইল: /public, /assets, /favicon.ico;
3. একটি মডুলার APIRouter (useRouter);
4. ফাইল রুট, সবচেয়ে নির্দিষ্ট প্রথম: স্ট্যাটিক পাথ, তারপর সবচেয়ে নির্দিষ্ট সেগমেন্ট সহ গতিশীল পাথ, তারপর ক্যাচ-অল।

সমান নির্দিষ্টতার দুটি ফাইল রুট বর্ণানুক্রমিক পাথ ক্রমানুসারে নিবন্ধিত হয়, তাই [id].nexy [slug].nexy এর আগে উত্তর দেয়। একটি মডুলার রুট তাই একই পথের সাথে একটি পৃষ্ঠাকে বীট করে। এটি একটি অগ্রাধিকার আদেশ যা আপনি নির্ভর করতে পারেন, খেলার জন্য টাই-ব্রেক নিয়ম নয়: একটি URL একটি ফাইল দিন৷

ভিউ সিস্টেম

একটি ফাইলের এক্সটেনশন নির্ধারণ করে যে এটি কী, এবং প্রকল্প কনফিগ সিদ্ধান্ত নেয় কোন এক্সটেনশনগুলি সক্রিয়।

একটি ফাইল যার এক্সটেনশন সক্রিয় নয় একটি সতর্কতা সহ বাদ দেওয়া হয়, পরিবেশন করা হয় না। ক্লায়েন্ট মোডে, সার্ভার শুরু হওয়ার আগে .nexy প্রত্যাখ্যান করা হয়। দেখুন ফাইল কনভেনশন।

রেন্ডারিং জীবনচক্র

তিনটি প্রশ্ন একটি পাঠক নোটিশ সবকিছু নির্ধারণ:

সার্ভার মোডে সার্ভার প্রতিটি পৃষ্ঠা রেন্ডার করে, revalidate প্রতি ইউআরএলে একটি পৃষ্ঠা ক্যাশ করে এবং দ্বীপগুলি একটি উপাদানে JavaScript যোগ করে। ক্লায়েন্ট মোডে প্রথম নথিটি নোডে রেন্ডার করা হয় এবং নেভিগেশন তারপর ব্রাউজারে ঘটে।

__nexy__/ উত্পন্ন সবকিছু ধারণ করে: সংকলিত পৃষ্ঠা, ক্লায়েন্ট এন্ট্রি, বিল্ড আউটপুট। এটি কখনই সম্পাদনা করবেন না, এটি কখনও করবেন না; একটি পরিষ্কার বিল্ড জোর করে এটি মুছুন.

ফ্রন্টএন্ড ইন্টিগ্রেশন

Vite প্রতিস্থাপন করে না নেক্সি Vite ক্লায়েন্ট কোড বান্ডিল করে এটি একটি অনুরোধ রুট করে না, একটি .nexy পৃষ্ঠা রেন্ডার করে, একটি অ্যাকশন চালায় বা মূলের মালিক হয় না। ব্রাউজারটি একটি মূলের সাথে কথা বলে - Nexy এর - এবং বিকাশে Nexy proxies Vite এর এন্ডপয়েন্ট এর মাধ্যমে, তাই কনফিগার করার জন্য কোন CORS নেই।

Nexy প্রতিস্থাপন না React. Nexy সিদ্ধান্ত নেয় কোন উপাদান রেন্ডার করে, কখন, এবং কোন প্রপস দিয়ে; কাঠামোটি উপাদান মডেল, প্রতিক্রিয়াশীলতা এবং বাস্তুতন্ত্রের মালিক। একটি .nexy পৃষ্ঠা একটি দ্বীপ হিসাবে একটি উপাদান আমদানি করে; ক্লায়েন্ট মোডে একটি রুট * একটি উপাদান।

একটি কম্পোনেন্ট রুটের জন্য, Python শুধুমাত্র একটি পাতলা মোড়ক মডিউল লেখে যা ফাইলের দিকে নির্দেশ করে। সংকলন এবং সার্ভার-সাইড রেন্ডারিং হল Vite এর কাজ।

উন্নয়ন এবং উৎপাদন

nx dev চেক করে nexyconfig.py, পৃষ্ঠাগুলি কম্পাইল করে, শুরু হয় Vite যখন প্রজেক্টের ফ্রন্টএন্ড ফ্রেমওয়ার্ক থাকে এবং আপনি যখন সেভ করেন তখন সার্ভার রিস্টার্ট করে। nx build একই কাজ একবার করে, সময়ের আগে, এবং nx start ফলাফল দেয়।

কি পরিবর্তন হয় না: একই রাউটিং নিয়ম, একই পৃষ্ঠা ফাইল, একই nexyconfig.py। একটি পৃষ্ঠা যা উভয়ের মধ্যে ভিন্নভাবে আচরণ করে সেটি একটি বাগ, একটি মোড নয়।

Nexy আপনার কাছে যা রেখে যায়

Nexy উদ্দেশ্যমূলকভাবে আপনার অ্যাপ্লিকেশনের প্রান্তে থামে:

কারণটি ছয়টির জন্যই একই: একটি ফ্রেমওয়ার্ক যা আপনার ORM বা আপনার প্রমাণীকরণ লাইব্রেরি বাছাই করে এমন জিনিসগুলি নির্ধারণ করে যা শুধুমাত্র আপনার অ্যাপ্লিকেশন সিদ্ধান্ত নিতে পারে। খরচ সুস্পষ্ট: আপনার জন্য কিছুই তারযুক্ত নয়, এবং টেবিলে লিঙ্ক করা গাইড প্রতিটিকে কোথায় প্লাগ ইন করতে হবে তা বলে।

পরবর্তী পদক্ষেপ

• প্রকল্প কাঠামো : যেখানে প্রতিটি অংশ একটি প্রকল্পে থাকে
• রাউটিং : ফাইল-ভিত্তিক, মডুলার এবং কাস্টম রাউটার
• রেন্ডারিং : SSR, ISR, CSR এবং দ্বীপপুঞ্জ
• ফ্রন্টএন্ড: Vite, স্টাইলিং এবং ক্লায়েন্ট বিল্ড

পাতাটি Markdown হিসেবে কপি করুন GitHub-এ সম্পাদনা করুন