@intlayer/docs 8.11.2 → 8.12.0-canary.0

package/docs/bn/introduction.md

@@ -2,7 +2,7 @@
 createdAt: 2025-08-23
 updatedAt: 2025-08-23
 title: ভূমিকা
-description: Intlayer কীভাবে কাজ করে তা জানুন। আপনার অ্যাপ্লিকেশনে Intlayer এর বিভিন্ন ধাপ দেখুন। বিভিন্ন প্যাকেজগুলি কী কাজ করে তা দেখুন।
+description: Intlayer কীভাবে কাজ করে তা আবিষ্কার করুন। আপনার অ্যাপ্লিকেশনে Intlayer যে পদক্ষেপগুলি ব্যবহার করে তা দেখুন। বিভিন্ন প্যাকেজগুলি কী করে তা জানুন।
 keywords:
   - ভূমিকা
   - শুরু করা
@@ -15,22 +15,22 @@ slugs:
 history:
   - version: 5.5.10
     date: 2025-06-29
-    changes: "ইতিহাস শুরু করা হয়েছে"
+    changes: "Init history"
 ---
 
-# Intlayer ডকুমেন্টেশন (Intlayer Documentation)
+# Intlayer ডকুমেন্টেশন
 
-অফিসিয়াল Intlayer ডকুমেন্টেশনে আপনাকে স্বাগতম! এখানে আপনি আপনার সমস্ত আন্তর্জাতিকীকরণ (i18n) প্রয়োজনের জন্য Intlayer ইন্টিগ্রেট, কনফিগার এবং আয়ত্ত করার জন্য প্রয়োজনীয় সবকিছু পাবেন, আপনি Next.js, React, Vite, Express অথবা অন্য কোনো JavaScript পরিবেশে কাজ করছেন কিনা তা নির্বিশেষে।
+অফিসিয়াল Intlayer ডকুমেন্টেশনে আপনাকে স্বাগতম! এখানে আপনি আপনার সমস্ত আন্তর্জাতিকীকরণ (i18n) চাহিদার জন্য Intlayer কে সংহত (integrate), কনফিগার এবং আয়ত্ত করার জন্য প্রয়োজনীয় সবকিছু পাবেন, আপনি Next.js, React, Vite, Express বা অন্য কোনও জাভাস্ক্রিপ্ট পরিবেশে কাজ করুন না কেন।
 
-## ভূমিকা (Introduction)
+## ভূমিকা
 
 ### Intlayer কী?
 
-**Intlayer** হলো একটি আন্তর্জাতিকীকরণ লাইব্রেরি যা বিশেষভাবে JavaScript ডেভেলপারদের জন্য ডিজাইন করা হয়েছে। এটি আপনার কোডের যেকোনো জায়গায় আপনার কন্টেন্ট ঘোষণা করার অনুমতি দেয়। এটি বহুভাষিক কন্টেন্টের ঘোষণাকে আপনার কোডে সহজে ইন্টিগ্রেট করার জন্য স্ট্রাকচার্ড ডিকশনারিতে রূপান্তর করে। TypeScript ব্যবহারের মাধ্যমে, **Intlayer** আপনার ডেভেলপমেন্টকে আরও শক্তিশালী এবং দক্ষ করে তোলে।
+**Intlayer** হল একটি আন্তর্জাতিকীকরণ (internationalization) লাইব্রেরি যা বিশেষভাবে জাভাস্ক্রিপ্ট ডেভেলপারদের জন্য ডিজাইন করা হয়েছে। এটি আপনার কোডের যে কোনও জায়গায় আপনার সামগ্রী (content) ঘোষণা করার অনুমতি দেয়। এটি বহুভাষিক সামগ্রীর ঘোষণাকে কাঠামোগত অভিধানে (structured dictionaries) রূপান্তর করে যাতে সহজেই আপনার কোডে সংহত করা যায়। TypeScript ব্যবহার করে, **Intlayer** আপনার ডেভেলপমেন্টকে আরও শক্তিশালী এবং দক্ষ করে তোলে।
 
-Intlayer একটি ঐচ্ছিক ভিজ্যুয়াল এডিটরও প্রদান করে যা আপনাকে সহজেই আপনার কন্টেন্ট এডিট এবং পরিচালনা করতে দেয়। এই এডিটরটি বিশেষ করে সেই সব ডেভেলপারদের জন্য উপযোগী যারা কন্টেন্ট ম্যানেজমেন্টের জন্য একটি ভিজ্যুয়াল ইন্টারফেস পছন্দ করেন, অথবা সেই সব টিমের জন্য যারা কোড নিয়ে চিন্তা না করেই কন্টেন্ট জেনারেট করতে চান।
+Intlayer একটি ঐচ্ছিক ভিজ্যুয়াল এডিটরও প্রদান করে যা আপনাকে সহজেই আপনার সামগ্রী সম্পাদনা এবং পরিচালনা করতে দেয়। এই এডিটরটি বিশেষত সেই ডেভেলপারদের জন্য দরকারী যারা সামগ্রী পরিচালনার জন্য একটি ভিজ্যুয়াল ইন্টারফেস পছন্দ করেন, বা এমন দলগুলির জন্য যারা কোড নিয়ে চিন্তা না করেই সামগ্রী তৈরি করেন।
 
-### ব্যবহারের উদাহরণ (Example of usage)
+### ব্যবহারের উদাহরণ
 
 ```bash
 .
@@ -50,6 +50,7 @@ const componentContent = {
       en: "Hello World",
       es: "Hola Mundo",
       fr: "Bonjour le monde",
+      bn: "হ্যালো ওয়ার্ল্ড",
     }),
   },
 } satisfies Dictionary;
@@ -67,7 +68,8 @@ export default componentContent;
       "translation": {
         "en": "Hello World",
         "fr": "Bonjour le monde",
-        "es": "Hola Mundo"
+        "es": "Hola Mundo",
+        "bn": "হ্যালো ওয়ার্ল্ড"
       }
     }
   }
@@ -85,55 +87,98 @@ export const MyComponent: FC = () => {
 };
 ```
 
-## মূল বৈশিষ্ট্যসমূহ (Main Features)
+### বিকল্পগুলির চেয়ে Intlayer কেন?
 
-Intlayer আধুনিক ওয়েব ডেভেলপমেন্টের চাহিদা মেটানোর জন্য তৈরি করা বিভিন্ন বৈশিষ্ট্য অফার করে। নিচে মূল বৈশিষ্ট্যসমূহ এবং প্রতিটির জন্য বিস্তারিত ডকুমেন্টেশনের লিঙ্ক দেওয়া হলো:
+`next-intl` বা `i18next` এর মতো প্রধান সমাধানগুলির তুলনায়, Intlayer এমন একটি সমাধান যা সমন্বিত অপ্টিমাইজেশনের সাথে আসে যেমন:
 
-- **আন্তর্জাতিকীকরণ সমর্থন (Internationalization Support)**: আন্তর্জাতিকীকরণের জন্য বিল্ট-ইন সমর্থনের মাধ্যমে আপনার অ্যাপ্লিকেশনের গ্লোবাল রিচ বৃদ্ধি করুন।
-- **ভিজ্যুয়াল এডিটর (Visual Editor)**: Intlayer এর জন্য ডিজাইন করা এডিটর প্লাগইনগুলির মাধ্যমে আপনার ডেভেলপমেন্ট ওয়ার্কফ্লো উন্নত করুন। [ভিজ্যুয়াল এডিটর গাইড](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/intlayer_visual_editor.md) দেখুন।
-- **কনফিগারেশনের নমনীয়তা (Configuration Flexibility)**: [কনফিগারেশন গাইড](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/configuration.md)-এ বর্ণিত বিস্তারিত কনফিগারেশন অপশনগুলির মাধ্যমে আপনার সেটআপ কাস্টমাইজ করুন।
-- **অ্যাডভান্সড CLI টুলস (Advanced CLI Tools)**: Intlayer এর কমান্ড লাইন ইন্টারফেস ব্যবহার করে আপনার প্রোজেক্টগুলি দক্ষতার সাথে পরিচালনা করুন। [CLI টুলস ডকুমেন্টেশন](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/cli/index.md)-এ ক্ষমতাগুলি অন্বেষণ করুন।
+<AccordionGroup>
 
-## মূল ধারণা (Core Concepts)
+<Accordion header="বান্ডিল সাইজ (Bundle size)">
 
-### ডিকশনারি (Dictionary)
+আপনার পেজগুলিতে বিশাল JSON ফাইল লোড করার পরিবর্তে, শুধুমাত্র প্রয়োজনীয় সামগ্রী লোড করুন। Intlayer আপনার **বান্ডিল এবং পেজের আকার ৫০% পর্যন্ত কমাতে** সাহায্য করে।
 
-সবকিছু সামঞ্জস্যপূর্ণ এবং রক্ষণাবেক্ষণযোগ্য রাখতে আপনার কোডের কাছাকাছি আপনার বহুভাষিক কন্টেন্ট সংগঠিত করুন।
+</Accordion>
+
+<Accordion header="রক্ষণাবেক্ষণযোগ্যতা (Maintainability)">
+
+আপনার অ্যাপ্লিকেশনের বিষয়বস্তুকে স্কোপ করা বৃহৎ-স্কেল অ্যাপ্লিকেশনগুলির জন্য **রক্ষণাবেক্ষণ সহজ করে তোলে**। আপনার সম্পূর্ণ কন্টেন্ট কোডবেস পর্যালোচনা করার মানসিক বোঝা ছাড়াই আপনি একটি একক বৈশিষ্ট্য ফোল্ডার নকল বা মুছতে পারেন। উপরন্তু, আপনার সামগ্রীর যথার্থতা নিশ্চিত করতে Intlayer **সম্পূর্ণরূপে টাইপড (fully typed)**।
+
+</Accordion>
+
+<Accordion header="এআই এজেন্ট (AI Agent)">
+
+বিষয়বস্তু সহ-অবস্থান (Co-locating content) লার্জ ল্যাঙ্গুয়েজ মডেল (LLMs) দ্বারা **প্রয়োজনীয় প্রসঙ্গ হ্রাস করে**। Intlayer অনুপস্থিত অনুবাদের পরীক্ষা করার জন্য **CLI**, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/mcp_server.md)** এবং এআই এজেন্টদের জন্য ডেভেলপার অভিজ্ঞতা (DX) আরও মসৃণ করতে **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/agent_skills.md)** এর মতো সরঞ্জামগুলির একটি স্যুট নিয়ে আসে।
+
+</Accordion>
+
+<Accordion header="স্বয়ংক্রিয়করণ (Automation)">
+
+আপনার এআই প্রদানকারীর খরচে আপনার পছন্দের LLM ব্যবহার করে আপনার CI/CD পাইপলাইনে অনুবাদ করার জন্য স্বয়ংক্রিয়করণ ব্যবহার করুন। Intlayer বিষয়বস্তু নিষ্কাশন স্বয়ংক্রিয় করতে একটি **কম্পাইলার (compiler)** এবং **ব্যাকগ্রাউন্ডে অনুবাদ** করতে সাহায্য করার জন্য একটি [ওয়েব প্ল্যাটফর্ম](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/intlayer_CMS.md) অফার করে।
+
+</Accordion>
+
+<Accordion header="কর্মক্ষমতা (Performance)">
+
+উপাদানগুলির (components) সাথে বিশাল JSON ফাইলগুলি সংযোগ করা কর্মক্ষমতা এবং প্রতিক্রিয়াশীলতা (reactivity) সমস্যাগুলির দিকে পরিচালিত করতে পারে। Intlayer বিল্ড টাইমে (build time) আপনার সামগ্রী লোড করা অপ্টিমাইজ করে।
+
+</Accordion>
+
+<Accordion header="নন-ডেভদের সাথে স্কেলিং (Scaling with non-dev)">
+
+শুধুমাত্র একটি i18n সমাধানের চেয়ে বেশি, Intlayer আপনাকে **রিয়েল-টাইমে** আপনার বহুভাষিক সামগ্রী পরিচালনা করতে সহায়তা করার জন্য একটি **স্ব-হোস্টেড (self-hosted) [ভিজ্যুয়াল এডিটর](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/intlayer_visual_editor.md)** এবং একটি **[সম্পূর্ণ CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/intlayer_CMS.md)** প্রদান করে, যা অনুবাদক, কপিরাইটার এবং অন্যান্য দলের সদস্যদের সাথে সহযোগিতা নির্বিঘ্ন করে। সামগ্রী স্থানীয়ভাবে এবং/বা দূরবর্তীভাবে সংরক্ষণ করা যেতে পারে।
+
+</Accordion>
+</AccordionGroup>
+
+## প্রধান বৈশিষ্ট্যসমূহ
+
+Intlayer আধুনিক ওয়েব ডেভেলপমেন্টের চাহিদা মেটাতে বিভিন্ন বৈশিষ্ট্য প্রদান করে। নিচে প্রতিটি বৈশিষ্ট্যের জন্য বিস্তারিত ডকুমেন্টেশনের লিঙ্ক সহ মূল বৈশিষ্ট্যগুলি দেওয়া হলো:
+
+- **আন্তর্জাতিকীকরণ সমর্থন**: আন্তর্জাতিকীকরণের জন্য অন্তর্নির্মিত সমর্থন দিয়ে আপনার অ্যাপ্লিকেশনের বিশ্বব্যাপী পৌঁছানো বাড়ান।
+- **ভিজ্যুয়াল এডিটর**: Intlayer-এর জন্য ডিজাইন করা এডিটর প্লাগইনগুলির মাধ্যমে আপনার ডেভেলপমেন্ট ওয়ার্কফ্লো উন্নত করুন। [ভিজ্যুয়াল এডিটর গাইড](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/intlayer_visual_editor.md) দেখুন।
+- **কনফিগারেশন নমনীয়তা**: [কনফিগারেশন গাইড](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/configuration.md)-এ বিস্তারিত কনফিগারেশন বিকল্পগুলির সাথে আপনার সেটআপ কাস্টমাইজ করুন।
+- **উন্নত CLI টুলস**: Intlayer-এর কমান্ড লাইন ইন্টারফেস ব্যবহার করে দক্ষতার সাথে আপনার প্রকল্পগুলি পরিচালনা করুন। [CLI টুলস ডকুমেন্টেশন](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/cli/index.md)-এ সক্ষমতাগুলি অন্বেষণ করুন।
+
+## মূল ধারণা
+
+### অভিধান (Dictionary)
+
+সবকিছু সামঞ্জস্যপূর্ণ এবং রক্ষণাবেক্ষণযোগ্য রাখতে আপনার বহুভাষিক সামগ্রী আপনার কোডের কাছাকাছি সংগঠিত করুন।
 
 - **[শুরু করা (Get Started)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/dictionary/content_file.md)**  
-  Intlayer-এ আপনার কন্টেন্ট ঘোষণার প্রাথমিক বিষয়গুলি শিখুন।
+  Intlayer-এ আপনার সামগ্রী ঘোষণা করার মূল বিষয়গুলি শিখুন।
 
 - **[অনুবাদ (Translation)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/dictionary/translation.md)**  
-  কীভাবে অনুবাদ জেনারেট, সংরক্ষিত এবং আপনার অ্যাপ্লিকেশনে ব্যবহৃত হয় তা বুঝতে শিখুন।
+  আপনার অ্যাপ্লিকেশনে অনুবাদগুলি কীভাবে তৈরি, সংরক্ষণ এবং ব্যবহার করা হয় তা বুঝুন।
 
-- **[এনিমেরেশন (Enumeration)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/dictionary/enumeration.md)**  
-  বিভিন্ন ল্যাঙ্গুয়েজ জুড়ে বারবার ব্যবহৃত বা নির্দিষ্ট ডেটাসেট সহজে পরিচালনা করুন।
+- **[গণনা (Enumeration)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/dictionary/enumeration.md)**  
+  বিভিন্ন ভাষায় পুনরাবৃত্ত বা নির্দিষ্ট ডেটাসেটগুলি সহজেই পরিচালনা করুন।
 
 - **[শর্ত (Condition)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/dictionary/condition.md)**  
-  গতিশীল কন্টেন্ট তৈরি করতে Intlayer-এ কন্ডিশনাল লজিক কীভাবে ব্যবহার করবেন তা শিখুন।
+  গতিশীল সামগ্রী তৈরি করতে Intlayer-এ শর্তযুক্ত যুক্তি ব্যবহার করা শিখুন।
 
-- **[ইনসার্টেশন (Insertion)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/dictionary/insertion.md)**  
-  ইনসার্টেশন প্লেসহোল্ডার ব্যবহার করে স্ট্রিংয়ে কীভাবে ভ্যালু ইনসার্ট করবেন তা আবিষ্কার করুন।
+- **[সন্নিবেশ (Insertion)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/dictionary/insertion.md)**  
+  সন্নিবেশ প্লেসহোল্ডার ব্যবহার করে স্ট্রিংয়ে মান কীভাবে প্রবেশ করাবেন তা আবিষ্কার করুন।
 
 - **[ফাংশন ফেচিং (Function Fetching)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/dictionary/function_fetching.md)**  
-  আপনার প্রোজেক্টের ওয়ার্কফ্লোর সাথে মিল রেখে কাস্টম লজিকের মাধ্যমে কীভাবে গতিশীলভাবে কন্টেন্ট ফেচ করবেন তা দেখুন।
+  আপনার প্রকল্পের ওয়ার্কফ্লো মেলাতে কাস্টম যুক্তির সাথে গতিশীলভাবে সামগ্রী কীভাবে আনতে হয় তা দেখুন।
 
 - **[মার্কডাউন (Markdown)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/dictionary/markdown.md)**  
-  সমৃদ্ধ কন্টেন্ট তৈরি করতে Intlayer-এ কীভাবে মার্কডাউন ব্যবহার করবেন তা শিখুন।
+  সমৃদ্ধ সামগ্রী তৈরি করতে Intlayer-এ মার্কডাউন কীভাবে ব্যবহার করবেন তা শিখুন।
 
 - **[ফাইল এম্বেডিং (File embeddings)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/dictionary/file.md)**  
-  কন্টেন্ট এডিটরে ব্যবহারের জন্য Intlayer-এ এক্সটার্নাল ফাইলগুলি কীভাবে এম্বেড করবেন তা আবিষ্কার করুন।
+  কন্টেন্ট এডিটরে ব্যবহার করার জন্য Intlayer-এ বহিরাগত ফাইলগুলি কীভাবে এম্বেড করবেন তা আবিষ্কার করুন।
 
 - **[নেস্টিং (Nesting)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/dictionary/nesting.md)**  
-  জটিল স্ট্রাকচার তৈরি করতে Intlayer-এ কন্টেন্ট কীভাবে নেস্ট করবেন তা বুঝুন।
+  জটিল কাঠামো তৈরি করতে Intlayer-এ সামগ্রী কীভাবে নেস্ট করবেন তা বুঝুন।
 
-### পরিবেশ এবং ইন্টিগ্রেশন (Environments & Integrations)
+### পরিবেশ এবং ইন্টিগ্রেশন
 
-আমরা নমনীয়তার কথা মাথায় রেখে Intlayer তৈরি করেছি, যা জনপ্রিয় ফ্রেমওয়ার্ক এবং বিল্ড টুল জুড়ে নির্বিঘ্নে ইন্টিগ্রেট করা যায়:
+আমরা নমনীয়তা মাথায় রেখে Intlayer তৈরি করেছি, যা জনপ্রিয় ফ্রেমওয়ার্ক এবং বিল্ড টুলস জুড়ে বিরামবিহীন ইন্টিগ্রেশন প্রদান করে:
 
 - **[Next.js 16 এর সাথে Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/intlayer_with_nextjs_16.md)**
 - **[Next.js 15 এর সাথে Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/intlayer_with_nextjs_15.md)**
-- **[Next.js 14 এর সাথে Intlayer (App Router)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/intlayer_with_nextjs_14.md)**
+- **[Next.js 14 (App Router) এর সাথে Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/intlayer_with_nextjs_14.md)**
 - **[Next.js Page Router এর সাথে Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/intlayer_with_nextjs_page_router.md)**
 - **[React CRA এর সাথে Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/intlayer_with_create_react_app.md)**
 - **[Vite + React এর সাথে Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/intlayer_with_vite+react.md)**
@@ -149,12 +194,12 @@ Intlayer আধুনিক ওয়েব ডেভেলপমেন্টে
 - **[Express এর সাথে Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/intlayer_with_express.md)**
 - **[NestJS এর সাথে Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/intlayer_with_nestjs.md)**
 - **[Hono এর সাথে Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/intlayer_with_hono.md)**
-- **[Angular এর সাথে Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/intlayer_with_angular.md)**
+- **[Angular এর সাথে Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/bn/intlayer_with_angular_21.md)**
 
-প্রতিটি ইন্টিগ্রেশন গাইডে Intlayer-এর বৈশিষ্ট্যগুলি ব্যবহারের সেরা অনুশীলন অন্তর্ভুক্ত রয়েছে, যেমন **সার্ভার-সাইড রেন্ডারিং**, **গতিশীল রাউটিং**, অথবা **ক্লায়েন্ট-সাইড রেন্ডারিং**, যাতে আপনি একটি দ্রুত, SEO-ফ্রেন্ডলি এবং অত্যন্ত স্কেলেবল অ্যাপ্লিকেশন রক্ষণাবেক্ষণ করতে পারেন।
+প্রতিটি ইন্টিগ্রেশন গাইডে Intlayer-এর বৈশিষ্ট্যগুলি ব্যবহার করার জন্য সর্বোত্তম অনুশীলন (best practices) অন্তর্ভুক্ত রয়েছে, যেমন **সার্ভার-সাইড রেন্ডারিং (SSR)**, **ডায়নামিক রাউটিং**, বা **ক্লায়েন্ট-সাইড রেন্ডারিং**, যাতে আপনি একটি দ্রুত, SEO-বান্ধব এবং অত্যন্ত স্কেলেবল অ্যাপ্লিকেশন বজায় রাখতে পারেন।
 
-## অবদান এবং প্রতিক্রিয়া (Contributing & Feedback)
+## অবদান এবং প্রতিক্রিয়া
 
-আমরা ওপেন-সোর্স এবং সম্প্রদায়-চালিত ডেভেলপমেন্টের শক্তিতে বিশ্বাস করি। আপনি যদি উন্নতির প্রস্তাব দিতে চান, একটি নতুন গাইড যোগ করতে চান, অথবা আমাদের ডক্সে কোনো সমস্যা সংশোধন করতে চান, তবে নির্দ্বिধায় একটি পুল রিকোয়েস্ট জমা দিন অথবা আমাদের [GitHub রিপোজিটরি](https://github.com/aymericzip/intlayer/blob/main/docs/docs)-এ একটি ইস্যু ওপেন করুন।
+আমরা ওপেন-সোর্স এবং সম্প্রদায়-চালিত (community-driven) বিকাশের শক্তিকে মূল্য দিই। আপনি যদি উন্নতির প্রস্তাব দিতে চান, একটি নতুন গাইড যোগ করতে চান বা আমাদের ডকুমেন্টেশনে কোনো সমস্যা ঠিক করতে চান, তবে নির্দ্বিধায় একটি পুল রিকোয়েস্ট (Pull Request) জমা দিন বা আমাদের [GitHub রিপোজিটরিতে](https://github.com/aymericzip/intlayer/blob/main/docs/docs) একটি ইস্যু খুলুন।
 
-**আপনার অ্যাপ্লিকেশন আরও দ্রুত এবং আরও দক্ষতার সাথে অনুবাদ করতে প্রস্তুত?** আজই Intlayer ব্যবহার শুরু করতে আমাদের ডক্সে ডুব দিন। একটি শক্তিশালী, সুবিন্যস্ত আন্তর্জাতিকীকরণ পদ্ধতির অভিজ্ঞতা নিন যা আপনার কন্টেন্টকে সংগঠিত রাখে এবং আপনার টিমকে আরও বেশি প্রোডাক্টিভ করে তোলে।
+**আপনার অ্যাপ্লিকেশনটি আরও দ্রুত এবং আরও দক্ষতার সাথে অনুবাদ করার জন্য প্রস্তুত?** আজই Intlayer ব্যবহার শুরু করতে আমাদের ডকুমেন্টেশনে ডুব দিন। আন্তর্জাতিকীকরণের জন্য একটি শক্তিশালী, সুশৃঙ্খল পদ্ধতির অভিজ্ঞতা নিন যা আপনার সামগ্রীকে সংগঠিত রাখে এবং আপনার দলকে আরও বেশি উৎপাদনশীল করে তোলে।

package/docs/cs/cli/index.md

@@ -100,7 +100,7 @@ bun add intlayer-cli -g
 
 Balíček `intlayer-cli` je navržen k transpilaci vašich [deklarací intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/dictionary/content_file.md) do slovníků.
 
-Tento balíček transpiluje všechny soubory intlayer, jako jsou `src/**/*.content.{ts|js|mjs|cjs|json}`. [Podívejte se, jak deklarovat soubory s deklarací Intlayer](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
+Tento balíček transpiluje všechny soubory intlayer, jako jsou `src/**/*.content.{ts|js|mjs|cjs|json|tsx|jsx|md|mdx|yaml|yml}`. [Podívejte se, jak deklarovat soubory s deklarací Intlayer](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md).
 
 K interpretaci slovníků Intlayer můžete použít interprety, jako je [react-intlayer](https://www.npmjs.com/package/react-intlayer) nebo [next-intlayer](https://www.npmjs.com/package/next-intlayer).
 

package/docs/cs/interest_of_intlayer.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-14
-updatedAt: 2025-09-27
+updatedAt: 2026-05-31
 title: Výhody Intlayer
 description: Objevte výhody a přednosti používání Intlayer ve vašich projektech. Pochopte, proč Intlayer vyniká mezi ostatními frameworky.
 keywords:
@@ -13,6 +13,9 @@ slugs:
   - doc
   - why
 history:
+  - version: 8.11.2
+    date: 2026-05-31
+    changes: "Přidána sekce Proč Intlayer před alternativami"
   - version: 7.3.1
     date: 2025-11-27
     changes: "Vydání překladače"
@@ -30,6 +33,61 @@ history:
 
 **Intlayer** je knihovna pro internacionalizaci navržená speciálně pro vývojáře v JavaScriptu. Umožňuje deklarovat obsah kdekoli ve vašem kódu. Převádí deklarace vícejazyčného obsahu do strukturovaných slovníků, které lze snadno integrovat do vašeho kódu. Díky použití TypeScriptu činí **Intlayer** váš vývoj robustnějším a efektivnějším.
 
+## Proč Intlayer před alternativami?
+
+Ve srovnání s hlavními řešeními jako `next-intl` nebo `i18next` je Intlayer řešením, které přichází s integrovanými optimalizacemi, jako jsou:
+
+<AccordionGroup>
+
+<Accordion header="Velikost balíčku (Bundle size)">
+
+Místo načítání obrovských souborů JSON do vašich stránek načtěte pouze nezbytný obsah. Intlayer pomáhá **snížit velikost vašeho balíčku a stránek až o 50 %**.
+
+</Accordion>
+
+<Accordion header="Udržovatelnost">
+
+Omezení rozsahu obsahu vaší aplikace na úroveň komponent **usnadňuje údržbu** u velkých projektů. Můžete duplikovat nebo smazat jednu složku s funkcí bez mentální zátěže z nutnosti procházet celou kódovou základnu obsahu. Intlayer je navíc **plně typovaný**, což zaručuje přesnost vašeho obsahu.
+
+</Accordion>
+
+<Accordion header="AI Agenti">
+
+Umístění obsahu přímo u komponent **snižuje rozsah kontextu** potřebného pro velké jazykové modely (LLM). Intlayer také přichází se sadou nástrojů, jako je **CLI** pro testování chybějících překladů, **[LSP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/lsp.md)**, **[MCP](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/mcp_server.md)** a **[agent skills](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/agent_skills.md)**, které AI agentům usnadňují vývojářské prostředí (DX).
+
+</Accordion>
+
+<Accordion header="Funkce">
+
+Intlayer nabízí řadu dodatečných funkcí, které jiná i18n řešení nemají, jako je [podpora Markdownu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/dictionary/markdown.md), [načítání externího obsahu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/dictionary/function_fetching.md), [načítání obsahu ze souborů](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/dictionary/file.md), [živá aktualizace obsahu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/cli/live.md), [vizuální editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_visual_editor.md) a další.
+
+</Accordion>
+
+<Accordion header="Automatizace">
+
+Využijte automatizaci k překladu ve vaší CI/CD pipeline pomocí LLM podle vaší volby za cenu vašeho poskytovatele AI. Intlayer nabízí také **kompilátor** pro automatickou extrakci obsahu a [webovou platformu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_CMS.md) pro podporu **překladu na pozadí**.
+
+</Accordion>
+
+<Accordion header="Výkon">
+
+Připojení masivních souborů JSON ke komponentám může způsobit problémy s výkonem a reaktivitou. Intlayer optimalizuje načítání vašeho obsahu již při sestavení (build).
+
+</Accordion>
+
+<Accordion header="Spolupráce s netechnickými profily">
+
+Více než jen i18n řešení, Intlayer poskytuje **[vizuální editor](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_visual_editor.md) s možností vlastního hostování** a **[plnohodnotný CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/intlayer_CMS.md)**, které vám pomohou spravovat vícejazyčný obsah v **reálném čase**. Spolupráce s překladateli, textaři a dalšími členy týmu je tak zcela bezproblémová. Obsah lze ukládat lokálně a/nebo vzdáleně.
+
+</Accordion>
+
+<Accordion header="Návrh napříč frameworky">
+
+Pokud používáte různé frameworky pro různé části vaší aplikace (např. React, React-native, Vue, Angular, Svelte atd.), Intlayer poskytuje způsob, jak **používat společnou syntaxi a implementaci ve všech hlavních frontendových frameworcích**. Své deklarace obsahu budete moci sdílet napříč vaším design systémem, aplikacemi, backendem atd.
+
+</Accordion>
+</AccordionGroup>
+
 ## Proč byl Intlayer vytvořen?
 
 Intlayer byl vytvořen, aby vyřešil běžný problém, který postihuje všechny běžné i18n knihovny, jako jsou `next-intl`, `react-i18next`, `react-intl`, `next-i18next`, `react-intl` a `vue-i18n`.
@@ -174,9 +232,9 @@ Tento přístup vám umožňuje:
 
 | Funkce                                                                                                                    | Popis                                                                                                                                                                                                                                                                                                                                                                                                              |
 | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| ![Funkce](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                           | **Podpora napříč frameworky**<br><br>Intlayer je kompatibilní se všemi hlavními frameworky a knihovnami, včetně Next.js, React, Vite, Vue.js, Nuxt, Preact, Express a dalších.                                                                                                                                                                                                                                     |
+| ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/frameworks.png?raw=true)                          | **Podpora napříč frameworky**<br><br>Intlayer je kompatibilní se všemi hlavními frameworky a knihovnami, včetně Next.js, React, Vite, Vue.js, Nuxt, Preact, Express a dalších.                                                                                                                                                                                                                                     |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/javascript_content_management.jpg?raw=true)       | **Správa obsahu poháněná JavaScriptem**<br><br>Využijte flexibilitu JavaScriptu k efektivní definici a správě vašeho obsahu. <br><br> - [Deklarace obsahu](https://intlayer.org/doc/concept/content)                                                                                                                                                                                                               |
-| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Funkce" width="700">   | **Překladač (Compiler)**<br><br>Překladač Intlayer automaticky extrahuje obsah z komponent a generuje soubory slovníků.<br><br> - [Překladač](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                                   |
+| <img src="https://github.com/aymericzip/intlayer/blob/main/docs/assets/compiler.jpg?raw=true" alt="Feature" width="700">  | **Překladač (Compiler)**<br><br>Překladač Intlayer automaticky extrahuje obsah z komponent a generuje soubory slovníků.<br><br> - [Překladač](https://intlayer.org/doc/compiler)                                                                                                                                                                                                                                   |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/per_locale_content_declaration_file.png?raw=true) | **Soubor deklarace obsahu pro každé národní prostředí**<br><br>Zrychlete svůj vývoj deklarováním obsahu jednou, před automatickým generováním.<br><br> - [Soubor deklarace obsahu pro každé národní prostředí](https://intlayer.org/doc/concept/per-locale-file)                                                                                                                                                   |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/autocompletion.png?raw=true)                      | **Typově bezpečné prostředí**<br><br>Využijte TypeScript k zajištění bezchybnosti definic obsahu a kódu a zároveň čerpejte výhody z automatického doplňování v IDE.<br><br> - [Konfigurace TypeScriptu](https://intlayer.org/doc/environment/vite-and-react#configure-typescript)                                                                                                                                  |
 | ![Feature](https://github.com/aymericzip/intlayer/blob/main/docs/assets/config_file.png?raw=true)                         | **Zjednodušené nastavení**<br><br>Rychle začněte s minimální konfigurací. Snadno upravte nastavení pro internacionalizaci, směrování, AI, sestavování a zpracování obsahu. <br><br> - [Prozkoumejte integraci Next.js](https://intlayer.org/doc/environment/nextjs)                                                                                                                                                |
@@ -216,13 +274,11 @@ Tento přístup vám umožňuje:
 | **Tree-shaking (načítat pouze použitý obsah)** | ✅ Ano, pro každou komponentu v době sestavení přes Babel/SWC pluginy                                                         | ⚠️ Většinou načítá vše (lze zlepšit jmennými prostory / rozdělením kódu)                                                 | ⚠️ Většinou načítá vše                                                                                                                           | ❌ Není výchozí                                                      | ⚠️ Částečně                                                                                                              | ⚠️ Částečně                                                                                                              | ⚠️ Částečně (s rozdělením kódu/ručním nastavením)                     |
 | **Opožděné načítání (Lazy loading)**           | ✅ Ano, pro každé národní prostředí / pro každý slovník                                                                       | ✅ Ano (např. on-demand backendy/jmenné prostory)                                                                        | ✅ Ano (rozdělené balíčky národních prostředí)                                                                                                   | ✅ Ano (dynamické importy katalogů)                                  | ✅ Ano (pro každou trasu / každé národní prostředí), vyžaduje správu jmenných prostorů                                   | ✅ Ano (pro každou trasu / každé národní prostředí), vyžaduje správu jmenných prostorů                                   | ✅ Ano (asynchronní zprávy národních prostředí)                       |
 | **Vyčištění nepoužívaného obsahu**             | ✅ Ano, pro každý slovník v době sestavení                                                                                    | ❌ Ne, pouze ručním segmentováním jmenných prostorů                                                                      | ❌ Ne, všechny deklarované zprávy jsou zabaleny                                                                                                  | ✅ Ano, nepoužívané klíče jsou detekovány a při sestavení odstraněny | ❌ Ne, lze spravovat ručně se správou jmenných prostorů                                                                  | ❌ Ne, lze spravovat ručně se správou jmenných prostorů                                                                  | ❌ Ne, možné pouze přes ruční lazy-loading                            |
-| **Správa velkých projektů**                    | ✅ Podporuje modularitu, vhodné pro designové systémy                                                                         | ⚠️ Vyžaduje dobrou disciplínu v souborech                                                                                | ⚠️ Centrální katalogy se mohou rozrůst                                                                                                           | ⚠️ Může se stát komplexním                                           | ✅ Modulární s nastavením                                                                                                | ✅ Modulární s nastavením                                                                                                | ✅ Modulární s nastavením Vue Router/Nuxt i18n                        |
-
----
+| **Správa velkých projektů**                    | ✅ Podporuje modularitu, vhodné pro designové systémy                                                                         | ⚠️ Vyžaduje dobrou disciplínu ve souborech                                                                               | ⚠️ Centrální katalogy se mohou rozrůst                                                                                                           | ⚠️ Může se stát komplexním                                           | ✅ Modulární s nastavením                                                                                                | ✅ Modulární s nastavením                                                                                                | ✅ Modulární s nastavením Vue Router/Nuxt i18n                        |
 
 ## Hvězdičky na GitHubu
 
-Hvězdičky na GitHubu jsou silným ukazatelem popularity projektu, důvěry komunity a dlouhodobé relevance. Přestože nejsou přímým měřítkem technické kvality, odrážejí, kolik vývojářů považuje projekt za užitečný, sleduje jeho pokrok a pravděpodobně jej přijme. Pro odhad hodnoty projektu pomáhají hvězdičky porovnat zájem o alternativy a poskytují náhled na růst ekosystému.
+Les étoiles GitHub sont un indicateur fort de la popularité d'un projet, de la confiance de la communauté et de sa pertinence à long terme. Bien qu'elles ne soient pas une mesure directe de la qualité technique, elles reflètent le nombre de développeurs qui trouvent le projet utile, suivent ses progrès et sont susceptibles de l'adopter. Pour estimer la valeur d'un projet, les étoiles aident à comparer l'attraction entre les alternatives et fournissent des informations sur la croissance de l'écosystème.
 
 [![Star History Chart](https://api.star-history.com/chart?repos=aymericzip/intlayer%2Cformatjs/formatjs%2Ci18next/react-i18next%2Ci18next/i18next%2Ci18next/next-i18next%2Clingui/js-lingui%2Camannn/next-intl%2Cintlify/vue-i18n%2Ccodingcommons/typesafe-i18n%2Copral/paraglide-js&type=date&legend=top-left)](https://www.star-history.com/#aymericzip/intlayer&formatjs/formatjs&i18next/react-i18next&i18next/i18next&i18next/next-i18next&lingui/js-lingui&amannn/next-intl&intlify/vue-i18n&codingcommons/typesafe-i18n&opral/paraglide-js)
 

package/docs/cs/intlayer_with_angular_21.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-04-18
-updatedAt: 2026-05-06
-title: Angular i18n - Jak přeložit aplikaci Angular 21 (Vite) v roce 2026
-description: Objevte, jak udělat váš web v Angularu vícejazyčným. Postupujte podle dokumentace, abyste jej internacionalizovali (i18n) a přeložili.
+updatedAt: 2026-05-31
+title: "Angular 21 i18n - Kompletní průvodce překladem vaší aplikace"
+description: "Žádný i18next. Průvodce 2026 pro vytváření vícejazyčné (i18n) aplikace Angular 21. Překládejte pomocí agentů AI a optimalizujte velikost bundlu, SEO a výkon."
 keywords:
   - Internacionalizace
   - Dokumentace
@@ -78,7 +78,9 @@ S Intlayer můžete:
 
 Podívejte se na [šablonu aplikace](https://github.com/aymericzip/intlayer-angular-21-template) na GitHubu.
 
-### Krok 1: Instalace závislostí
+<Steps>
+
+<Step number={1} title="Instalace závislostí">
 
 Nainstalujte potřebné balíčky pomocí npm:
 
@@ -116,7 +118,9 @@ bun x intlayer init
 - **@angular-builders/custom-esbuild**
   Požadováno k přizpůsobení konfigurace esbuild v Angular CLI.
 
-### Krok 2: Konfigurace vašeho projektu
+</Step>
+
+<Step number={2} title="Konfigurace vašeho projektu">
 
 Vytvořte konfigurační soubor k nastavení jazyků vaší aplikace:
 
@@ -140,7 +144,9 @@ export default config;
 
 > Prostřednictvím tohoto konfiguračního souboru můžete nastavit lokalizované adresy URL, přesměrování middleware, názvy souborů cookie, umístění a rozšíření vašich deklarací obsahu, zakázat logování Intlayer v konzoli a další. Pro úplný seznam dostupných parametrů se podívejte na [dokumentaci ke konfiguraci](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/configuration.md).
 
-### Krok 3: Integrace Intlayer do vaší konfigurace Angular
+</Step>
+
+<Step number={3} title="Integrace Intlayer do vaší konfigurace Angular">
 
 K integraci Intlayer s Angular CLI je nutné použít vlastní builder. Tento průvodce předpokládá, že používáte Vite/esbuild (výchozí pro projekty Angular 21).
 
@@ -202,7 +208,9 @@ export default [intlayerEsbuildPlugin()];
 >
 > Poté v `angular.json` nasměrujte na `"./esbuild.plugins.mjs"` místo `"./esbuild.plugins.ts"`.
 
-### Krok 4: Deklarace vašeho obsahu
+</Step>
+
+<Step number={4} title="Deklarace vašeho obsahu">
 
 Vytvářejte a spravujte své deklarace obsahu pro uložení překladů:
 
@@ -252,7 +260,9 @@ export default appContent;
 
 > Další podrobnosti najdete v [dokumentaci k deklaraci obsahu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/cs/dictionary/content_file.md).
 
-### Krok 5: Využití Intlayer ve vašem kódu
+</Step>
+
+<Step number={5} title="Využití Intlayer ve vašem kódu">
 
 K využití funkcí internacionalizace Intlayer v celé vaší aplikaci Angular je třeba poskytnout Intlayer v konfiguraci aplikace.
 
@@ -300,7 +310,9 @@ A ve vaší šabloně:
 
 Obsah Intlayer je vrácen jako `Signal`, takže přístup k hodnotám získáte voláním signálu: `content().title`.
 
-### (Volitelné) Krok 6: Změna jazyka vašeho obsahu
+</Step>
+
+<Step number={6} title="Změna jazyka vašeho obsahu" isOptional={true}>
 
 K přepínání jazyka obsahu můžete použít funkci `setLocale`, kterou poskytuje `useLocale`. Umožňuje vám nastavit lokalizaci aplikace a odpovídajícím způsobem aktualizovat obsah.
 
@@ -357,6 +369,10 @@ export class AppComponent {
 }
 ```
 
+</Step>
+
+</Steps>
+
 ### Konfigurace TypeScriptu
 
 Intlayer používá Module Augmentation, aby získal výhody TypeScriptu a vaše kódová základna byla silnější.

package/docs/cs/intlayer_with_fastify.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-12-30
-updatedAt: 2026-05-06
-title: Fastify i18n - Jak přeložit aplikaci Fastify v roce 2026
-description: Objevte, jak učinit váš backend ve Fastify vícejazyčným. Postupujte podle dokumentace pro internacionalizaci (i18n) a překlad.
+updatedAt: 2026-05-31
+title: "Fastify i18n - Kompletní průvodce překladem vaší aplikace"
+description: "Žádný i18next. Průvodce 2026 pro vytváření vícejazyčné (i18n) aplikace Fastify. Překládejte pomocí agentů AI a optimalizujte velikost bundlu, SEO a výkon."
 keywords:
   - Internacionalizace
   - Dokumentace

package/docs/cs/intlayer_with_hono.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-08-23
-updatedAt: 2026-05-06
-title: i18n pro Hono - Jak přeložit aplikaci Hono v roce 2026
-description: Zjistěte, jak vytvořit multilinguální backend pro Hono. Postupujte podle dokumentace pro internacionalizaci (i18n) a překlad.
+updatedAt: 2026-05-31
+title: "Hono i18n - Kompletní průvodce překladem vaší aplikace"
+description: "Žádný i18next. Průvodce 2026 pro vytváření vícejazyčné (i18n) aplikace Hono. Překládejte pomocí agentů AI a optimalizujte velikost bundlu, SEO a výkon."
 keywords:
   - Internacionalizace
   - Dokumentace

package/docs/cs/intlayer_with_storybook.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2026-03-20
 updatedAt: 2026-05-06
-title: Jak nastavit Intlayer se Storybookem
-description: Naučte se, jak vytvořit svůj design systém vícejazyčný pomocí Intlayeru se Storybookem - kompilujte deklarace obsahu, přidejte přepínač jazyků a prohlížejte své komponenty v libovolném jazyce.
+title: "Storybook i18n - Kompletní průvodce překladem vaší aplikace"
+description: "Žádný i18next. Průvodce 2026 pro vytváření vícejazyčné (i18n) aplikace Storybook. Překládejte pomocí agentů AI a optimalizujte velikost bundlu, SEO a výkon."
 keywords:
   - Internacionalizace
   - Dokumentace
@@ -59,7 +59,9 @@ Storybook je standardní nástroj pro vývoj a dokumentaci UI komponent v izolac
 <Tabs>
 <Tab value="Vite Setup">
 
-### Krok 1: Instalace závislostí
+<Steps>
+
+<Step number={1} title="Instalace závislostí">
 
 ```bash packageManager="npm"
 npm install intlayer react-intlayer
@@ -89,7 +91,9 @@ bun add vite-intlayer --dev
 
 ---
 
-### Krok 2: Vytvoření konfigurace Intlayer
+</Step>
+
+<Step number={2} title="Vytvoření konfigurace Intlayer">
 
 Vytvořte `intlayer.config.ts` v kořenovém adresáři vašeho projektu (nebo uvnitř vašeho design-system balíčku):
 
@@ -118,7 +122,9 @@ export default config;
 
 ---
 
-### Krok 3: Přidání Vite pluginu do Storybooku
+</Step>
+
+<Step number={3} title="Přidání Vite pluginu do Storybooku">
 
 Hook `viteFinal` ve Storybooku vám umožní rozšířit interní konfiguraci Vite. Zde importujte a přidejte plugin `intlayer()`:
 
@@ -159,7 +165,9 @@ Plugin `intlayer()` sleduje vaše soubory `*.content.ts` a automaticky znovu ses
 
 ---
 
-### Krok 4: Přidání dekorátoru `IntlayerProvider` a nástrojové lišty jazyků
+</Step>
+
+<Step number={4} title="Přidání dekorátoru `IntlayerProvider` a nástrojové lišty jazyků">
 
 Soubor `preview` ve Storybooku je správným místem pro obalení každého příběhu (story) pomocí `IntlayerProvider` a vystavení přepínače jazyků v nástrojové liště:
 
@@ -216,7 +224,9 @@ export default preview;
 </Tab>
 <Tab value="Webpack Setup">
 
-### Krok 1: Instalace závislostí
+</Step>
+
+<Step number={1} title="Instalace závislostí">
 
 ```bash packageManager="npm"
 npm install intlayer react-intlayer
@@ -240,7 +250,9 @@ bun add @intlayer/webpack --dev
 
 ---
 
-### Krok 2: Vytvoření konfigurace Intlayer
+</Step>
+
+<Step number={2} title="Vytvoření konfigurace Intlayer">
 
 Vytvořte `intlayer.config.ts` v kořenovém adresáři vašeho projektu:
 
@@ -262,7 +274,9 @@ export default config;
 
 ---
 
-### Krok 3: Konfigurace Webpacku pro Storybook
+</Step>
+
+<Step number={3} title="Konfigurace Webpacku pro Storybook">
 
 U Storybooků založených na Webpacku (např. `@storybook/react-webpack5`) rozšiřte konfiguraci webpacku přes `webpackFinal` a přidejte Intlayer aliasy a loader:
 
@@ -289,7 +303,9 @@ export default config;
 
 ---
 
-### Krok 4: Přidání dekorátoru `IntlayerProvider` a nástrojové lišty jazyků
+</Step>
+
+<Step number={4} title="Přidání dekorátoru `IntlayerProvider` a nástrojové lišty jazyků">
 
 Stejné jako u nastavení Vite - přidejte dekorátor a globální typ lokality v `.storybook/preview.tsx`:
 
@@ -335,6 +351,10 @@ export default preview;
 
 ---
 
+</Step>
+
+</Steps>
+
 ## Deklarování obsahu
 
 Vytvořte soubor `*.content.ts` vedle každé komponenty. Intlayer jej automaticky zachytí během kompilace.