@intlayer/docs 8.4.8 → 8.4.10

package/docs/ur/introduction.md

@@ -0,0 +1,216 @@
+---
+createdAt: 2025-08-23
+updatedAt: 2025-08-23
+title: تعارف
+description: دریافت کریں کہ Intlayer کیسے کام کرتا ہے۔ اپنی ایپلی کیشن میں Intlayer کے ذریعے استعمال ہونے والے مراحل دیکھیں۔ دیکھیں کہ مختلف پیکیجز کیا کرتے ہیں۔
+keywords:
+  - تعارف
+  - شروع کریں
+  - Intlayer
+  - ایپلی کیشن
+  - پیکیجز
+slugs:
+  - doc
+  - get-started
+history:
+  - version: 5.5.10
+    date: 2025-06-29
+    changes: "تاریخ کا آغاز"
+---
+
+# Intlayer دستاویزات
+
+آفیشل Intlayer دستاویزات میں خوش آمدید! یہاں آپ کو اپنی تمام بین الاقوامی سازی (i18n) کی ضروریات کے لیے Intlayer کو انٹیگریٹ کرنے، کنفیگر کرنے اور اس میں مہارت حاصل کرنے کے لیے درکار ہر چیز ملے گی، چاہے آپ Next.js، React، Vite، Express، یا کسی دوسرے JavaScript ماحول کے ساتھ کام کر رہے ہوں۔
+
+## تعارف
+
+### Intlayer کیا ہے؟
+
+**Intlayer** ایک بین الاقوامی سازی لائبریری ہے جو خاص طور پر JavaScript ڈویلپرز کے لیے ڈیزائن کی گئی ہے۔ یہ آپ کو اپنے کوڈ میں ہر جگہ اپنے مواد کا اعلان کرنے کی اجازت دیتی ہے۔ یہ کثیر لسانی مواد کے اعلانات کو منظم ڈکشنریوں میں تبدیل کرتی ہے تاکہ آپ کے کوڈ میں آسانی سے انٹیگریٹ کیا جا سکے۔ TypeScript کا استعمال کرتے ہوئے، **Intlayer** آپ کی ڈویلپمنٹ کو مضبوط اور زیادہ موثر بناتی ہے۔
+
+Intlayer ایک اختیاری ویژول ایڈیٹر بھی فراہم کرتی ہے جو آپ کو اپنے مواد کو آسانی سے ایڈٹ اور منظم کرنے کی اجازت دیتی ہے۔ یہ ایڈیٹر خاص طور پر ان ڈویلپرز کے لیے مفید ہے جو مواد کے انتظام کے لیے ویژول انٹرفیس کو ترجیح دیتے ہیں، یا ان ٹیموں کے لیے جو کوڈ کی فکر کیے بغیر مواد تیار کرنا چاہتی ہیں۔
+
+### استعمال کی مثال
+
+```bash
+.
+└── Components
+    └── MyComponent
+        ├── index.content.ts
+        └── index.tsx
+```
+
+```tsx fileName="src/components/MyComponent/index.content.ts" contentDeclarationFormat="typescript"
+import { t, type Dictionary } from "intlayer";
+
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
+    }),
+  },
+} satisfies Dictionary;
+
+export default componentContent;
+```
+
+```javascript fileName="src/components/MyComponent/index.content.mjs" contentDeclarationFormat="esm"
+import { t } from "intlayer";
+
+/** @type {import('intlayer').Dictionary} */
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
+    }),
+  },
+};
+
+export default componentContent;
+```
+
+```javascript fileName="src/components/MyComponent/index.content.cjs" contentDeclarationFormat="commonjs"
+const { t } = require("intlayer");
+
+/** @type {import('intlayer').Dictionary} */
+const componentContent = {
+  key: "component-key",
+  content: {
+    myTranslatedContent: t({
+      en: "Hello World",
+      es: "Hola Mundo",
+      fr: "Bonjour le monde",
+    }),
+  },
+};
+
+module.exports = componentContent;
+```
+
+```json fileName="src/components/MyComponent/index.content.json" contentDeclarationFormat="json"
+{
+  "$schema": "https://intlayer.org/schema.json",
+  "key": "component-key",
+  "content": {
+    "myTranslatedContent": {
+      "nodeType": "translation",
+      "translation": {
+        "en": "Hello World",
+        "fr": "Bonjour le monde",
+        "es": "Hola Mundo"
+      }
+    }
+  }
+}
+```
+
+```tsx fileName="src/components/MyComponent/index.tsx" codeFormat="typescript"
+import type { FC } from "react";
+import { useIntlayer } from "react-intlayer";
+
+export const MyComponent: FC = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="src/components/MyComponent/index.mjx" codeFormat="esm"
+import { useIntlayer } from "react-intlayer";
+
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+```jsx fileName="src/components/MyComponent/index.csx" codeFormat="commonjs"
+const { useIntlayer } = require("react-intlayer");
+
+const MyComponent = () => {
+  const { myTranslatedContent } = useIntlayer("component-key");
+
+  return <span>{myTranslatedContent}</span>;
+};
+```
+
+## اہم خصوصیات
+
+Intlayer جدید ویب ڈویلپمنٹ کی ضروریات کو پورا کرنے کے لیے مختلف خصوصیات پیش کرتی ہے۔ نیچے اہم خصوصیات دی گئی ہیں، جن میں سے ہر ایک کے لیے تفصیلی دستاویزات کے لنکس موجود ہیں:
+
+- **بین الاقوامی سازی سپورٹ**: بین الاقوامی سازی کے لیے بلٹ ان سپورٹ کے ساتھ اپنی ایپلی کیشن کی عالمی رسائی کو بڑھائیں۔
+- **ویژول ایڈیٹر**: Intlayer کے لیے ڈیزائن کیے گئے ایڈیٹر پلگ انز کے ساتھ اپنے ڈویلپمنٹ ورک فلو کو بہتر بنائیں۔ [ویژول ایڈیٹر گائیڈ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_visual_editor.md) دیکھیں۔
+- **کنفیگریشن میں لچک**: [کنفیگریشن گائیڈ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/configuration.md) میں بیان کردہ وسیع کنفیگریشن اختیارات کے साथ اپنے سیٹ اپ کو اپنی مرضی کے مطابق بنائیں۔
+- **اعلی درجے کے CLI ٹولز**: Intlayer کے کمانڈ لائن انٹرفیس کا استعمال کرتے ہوئے اپنے پروجیکٹس کو مؤثر طریقے سے منظم کریں۔ [CLI ٹولز دستاویزات](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/cli/index.md) میں صلاحیتوں کو تلاش کریں۔
+
+## بنیادی تصورات
+
+### ڈکشنری (Dictionary)
+
+اپنے کثیر لسانی مواد کو اپنے کوڈ کے قریب منظم کریں تاکہ ہر چیز مستقل اور برقرار رکھنے کے قابل رہے۔
+
+- **[شروع کریں](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/content_file.md)**  
+  Intlayer میں اپنے مواد کے اعلان کی بنیادی باتیں سیکھیں۔
+
+- **[ترجمہ](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/translation.md)**  
+  سمجھیں کہ ترجمہ کیسے تیار، ذخیرہ اور آپ کی ایپلی کیشن میں استعمال کیا جاتا ہے۔
+
+- **[فہرست (Enumeration)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/enumeration.md)**  
+  مختلف زبانوں میں بار بار ہونے والے یا طے شدہ ڈیٹا کے سیٹس کو آسانی سے منظم کریں۔
+
+- **[شرط (Condition)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/condition.md)**  
+  ڈائنامک مواد بنانے کے لیے Intlayer میں مشروط منطق (conditional logic) استعمال کرنا سیکھیں۔
+
+- **[شمولیت (Insertion)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/insertion.md)**
+  دریافت کریں کہ انسریشن پلیس ہولڈرز کا استعمال کرتے ہوئے اسٹرنگ میں ویلیوز کو کیسے شامل کیا جائے۔
+
+- **[فنکشن فیچنگ (Function Fetching)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/function_fetching.md)**  
+  دیکھیں کہ اپنے پروجیکٹ کے ورک فلو کے مطابق کسٹم لاجک کے ساتھ ڈائنامک طور پر مواد حاصل کیا جائے۔
+
+- **[مارک ڈاؤن (Markdown)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/markdown.md)**  
+  بھرپور مواد تخلیق کرنے کے لیے Intlayer میں مارک ڈاؤن استعمال کرنا سیکھیں۔
+
+- **[فائل ایمبیڈنگ (File embeddings)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/file.md)**  
+  دریافت کریں کہ کٹنٹ ایڈیٹر میں استعمال کرنے کے لیے Intlayer میں بیرونی فائلوں کو کیسے شامل کیا جائے۔
+
+- **[نیسٹنگ (Nesting)](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/dictionary/nesting.md)**  
+  پیچیدہ ڈھانچے بنانے کے لیے Intlayer میں مواد کو نیسٹ کرنے کا طریقہ سمجھیں۔
+
+### ماحول اور انٹیگریشنز (Environments & Integrations)
+
+ہم نے Intlayer کو لچک کو مدنظر رکھتے ہوئے بنایا ہے، جو مقبول فریم ورکس اور بلڈ ٹولز میں ہموار انٹیگریشن پیش کرتی ہے:
+
+- **[Next.js 16 کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_nextjs_16.md)**
+- **[Next.js 15 کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_nextjs_15.md)**
+- **[Next.js 14 (App Router) کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_nextjs_14.md)**
+- **[Next.js Page Router کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_nextjs_page_router.md)**
+- **[React CRA کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_create_react_app.md)**
+- **[Vite + React کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_vite+react.md)**
+- **[React Router v7 کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_react_router_v7.md)**
+- **[Tanstack Start کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_tanstack.md)**
+- **[React Native اور Expo کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_react_native+expo.md)**
+- **[Lynx اور React کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_lynx+react.md)**
+- **[Vite + Preact کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_vite+preact.md)**
+- **[Vite + Vue کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_vite+vue.md)**
+- **[Nuxt کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_nuxt.md)**
+- **[Vite + Svelte کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_vite+svelte.md)**
+- **[SvelteKit کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_svelte_kit.md)**
+- **[Express کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_express.md)**
+- **[NestJS کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_nestjs.md)**
+- **[Hono کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_hono.md)**
+- **[Angular کے ساتھ Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ur/intlayer_with_angular.md)**
+
+ہر انٹیگریشن گائیڈ میں Intlayer کی خصوصیات کے استعمال کے لیے بہترین طریقے شامل ہیں، جیسے **سرور سائیڈ رینڈرنگ**، **ڈائنامک روٹنگ**، یا **کلائنٹ سائیڈ رینڈرنگ**، تاکہ آپ ایک تیز، SEO دوستانہ، اور انتہائی توسیع پذیر ایپلی کیشن برقرار رکھ سکیں۔
+
+## تعاون اور فیڈ بیک
+
+ہم اوپن سورس اور کمیونٹی پر مبنی ڈویلپمنٹ کی طاقت کی قدر کرتے ہیں۔ اگر آپ بہتری کی تجویز دینا چاہتے ہیں، کوئی نئی گائیڈ شامل کرنا چاہتے ہیں، یا ہماری دستاویزات میں کسی بھی مسئلے کو درست کرنا چاہتے ہیں، تو بلا جھجھک پل ریکوسٹ (Pull Request) جمع کرائیں یا ہمارے [GitHub ریپوزٹری](https://github.com/aymericzip/intlayer/blob/main/docs/docs) پر ایشو (issue) شروع کریں۔
+
+**اپنی ایپلی کیشن کو تیزی سے اور زیادہ مؤثر طریقے سے ترجمہ کرنے کے لیے تیار ہیں؟** آج ہی Intlayer کا استعمال شروع کرنے کے لیے ہماری دستاویزات دیکھیں۔ بین الاقوامی سازی کے ایک مضبوط، ہموار طریقہ کار کا تجربہ کریں جو آپ کے مواد کو منظم رکھتا ہے اور آپ کی ٹیم کو زیادہ پیداواری بناتا ہے۔

package/docs/vi/CI_CD.md

@@ -18,7 +18,7 @@ slugs:
 history:
   - version: 5.5.10
     date: 2025-06-29
-    changes: Khởi tạo lịch sử
+    changes: "Khởi tạo lịch sử"
 ---
 
 # Tự động tạo bản dịch trong pipeline CI/CD

package/docs/vi/agent_skills.md

@@ -15,7 +15,7 @@ slugs:
 history:
   - version: 8.1.0
     date: 2026-02-09
-    changes: Khởi tạo lịch sử
+    changes: "Khởi tạo lịch sử"
 ---
 
 # Kỹ năng Agent

package/docs/vi/autoFill.md

@@ -18,16 +18,16 @@ slugs:
 history:
   - version: 7.0.0
     date: 2025-10-23
-    changes: Đổi tên `autoFill` thành `fill` và cập nhật hành vi
+    changes: "Đổi tên `autoFill` thành `fill` và cập nhật hành vi"
   - version: 6.0.0
     date: 2025-09-20
-    changes: Thêm cấu hình toàn cục
+    changes: "Thêm cấu hình toàn cục"
   - version: 6.0.0
     date: 2025-09-17
-    changes: Thêm biến `{{fileName}}`
+    changes: "Thêm biến `{{fileName}}`"
   - version: 5.5.10
     date: 2025-06-29
-    changes: Khởi tạo lịch sử
+    changes: "Khởi tạo lịch sử"
 ---
 
 # Dịch Tệp Khai Báo Nội Dung Tự Động Điền

package/docs/vi/bundle_optimization.md

@@ -18,7 +18,7 @@ slugs:
 history:
   - version: 6.0.0
     date: 2025-11-25
-    changes: Khởi tạo lịch sử
+    changes: "Khởi tạo lịch sử"
 ---
 
 # Tối ưu Kích thước & Hiệu suất Gói i18n

package/docs/vi/cli/build.md

@@ -16,7 +16,7 @@ slugs:
 history:
   - version: 8.1.5
     date: 2026-02-23
-    changes: Thêm tùy chọn checkTypes
+    changes: "Thêm tùy chọn checkTypes"
 ---
 
 # Xây dựng Từ điển

package/docs/vi/cli/ci.md

@@ -19,7 +19,7 @@ slugs:
 history:
   - version: 7.5.11
     date: 2026-01-06
-    changes: Thêm lệnh CI
+    changes: "Thêm lệnh CI"
 ---
 
 # Lệnh CI

package/docs/vi/cli/index.md

@@ -19,43 +19,43 @@ slugs:
 history:
   - version: 7.5.11
     date: 2026-01-06
-    changes: Thêm lệnh projects list
+    changes: "Thêm lệnh projects list"
   - version: 7.5.9
     date: 2025-12-30
-    changes: Thêm lệnh init
+    changes: "Thêm lệnh init"
   - version: 7.2.3
     date: 2025-11-22
-    changes: Thêm lệnh transform
+    changes: "Thêm lệnh transform"
   - version: 7.1.0
     date: 2025-11-05
-    changes: Thêm tùy chọn skipIfExists cho lệnh translate
+    changes: "Thêm tùy chọn skipIfExists cho lệnh translate"
   - version: 6.1.4
     date: 2025-01-27
-    changes: Thêm bí danh cho các tham số và lệnh CLI
+    changes: "Thêm bí danh cho các tham số và lệnh CLI"
   - version: 6.1.3
     date: 2025-10-05
-    changes: Thêm tùy chọn build cho các lệnh
+    changes: "Thêm tùy chọn build cho các lệnh"
   - version: 6.1.2
     date: 2025-09-26
-    changes: Thêm lệnh version
+    changes: "Thêm lệnh version"
   - version: 6.1.0
     date: 2025-09-26
-    changes: Đặt tùy chọn verbose mặc định là true khi sử dụng CLI
+    changes: "Đặt tùy chọn verbose mặc định là true khi sử dụng CLI"
   - version: 6.1.0
     date: 2025-09-23
-    changes: Thêm lệnh watch và tùy chọn with
+    changes: "Thêm lệnh watch và tùy chọn with"
   - version: 6.0.1
     date: 2025-09-23
-    changes: Thêm lệnh editor
+    changes: "Thêm lệnh editor"
   - version: 6.0.0
     date: 2025-09-17
-    changes: Thêm lệnh content test và list
+    changes: "Thêm lệnh content test và list"
   - version: 5.5.11
     date: 2025-07-11
-    changes: Cập nhật tài liệu tham số lệnh CLI
+    changes: "Cập nhật tài liệu tham số lệnh CLI"
   - version: 5.5.10
     date: 2025-06-29
-    changes: Khởi tạo lịch sử
+    changes: "Khởi tạo lịch sử"
 ---
 
 # Intlayer CLI

package/docs/vi/cli/init.md

@@ -16,7 +16,7 @@ slugs:
 history:
   - version: 7.5.9
     date: 2025-12-30
-    changes: Thêm lệnh init
+    changes: "Thêm lệnh init"
 ---
 
 # Khởi tạo Intlayer

package/docs/vi/cli/list.md

@@ -16,10 +16,10 @@ slugs:
 history:
   - version: 7.5.12
     date: 2026-01-06
-    changes: Thêm tùy chọn đầu ra tuyệt đối cho lệnh list
+    changes: "Thêm tùy chọn đầu ra tuyệt đối cho lệnh list"
   - version: 7.5.11
     date: 2026-01-06
-    changes: Thêm tùy chọn đầu ra JSON cho lệnh list
+    changes: "Thêm tùy chọn đầu ra JSON cho lệnh list"
 ---
 
 # Liệt kê các tệp khai báo nội dung

package/docs/vi/cli/list_projects.md

@@ -17,7 +17,7 @@ slugs:
 history:
   - version: 7.5.12
     date: 2026-01-06
-    changes: Thêm tùy chọn đầu ra tuyệt đối vào lệnh list projects
+    changes: "Thêm tùy chọn đầu ra tuyệt đối vào lệnh list projects"
 ---
 
 # Liệt kê các dự án Intlayer

package/docs/vi/compiler.md

@@ -22,13 +22,13 @@ slugs:
 history:
   - version: 8.2.0
     date: 2026-03-09
-    changes: Cập nhật các tùy chọn trình biên dịch, thêm hỗ trợ FilePathPattern
+    changes: "Cập nhật các tùy chọn trình biên dịch, thêm hỗ trợ FilePathPattern"
   - version: 8.1.7
     date: 2026-02-25
-    changes: Cập nhật các tùy chọn trình biên dịch
+    changes: "Cập nhật các tùy chọn trình biên dịch"
   - version: 7.3.1
     date: 2025-11-27
-    changes: Phát hành Trình Biên Dịch
+    changes: "Phát hành Trình Biên Dịch"
 ---
 
 # Trình Biên Dịch Intlayer | Trích Xuất Nội Dung Tự Động cho i18n