@intlayer/docs 7.5.0 → 7.5.2-canary.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (111) hide show
  1. package/README.md +19 -19
  2. package/blog/ar/l10n_platform_alternative/Lokalise.md +80 -0
  3. package/blog/ar/l10n_platform_alternative/crowdin.md +86 -0
  4. package/blog/ar/l10n_platform_alternative/phrase.md +82 -0
  5. package/blog/de/l10n_platform_alternative/Lokalise.md +84 -0
  6. package/blog/de/l10n_platform_alternative/crowdin.md +80 -0
  7. package/blog/de/l10n_platform_alternative/phrase.md +82 -0
  8. package/blog/en/l10n_platform_alternative/Lokalise.md +80 -0
  9. package/blog/en/l10n_platform_alternative/crowdin.md +80 -0
  10. package/blog/en/l10n_platform_alternative/phrase.md +78 -0
  11. package/blog/en-GB/l10n_platform_alternative/Lokalise.md +80 -0
  12. package/blog/en-GB/l10n_platform_alternative/crowdin.md +80 -0
  13. package/blog/en-GB/l10n_platform_alternative/phrase.md +78 -0
  14. package/blog/es/l10n_platform_alternative/Lokalise.md +80 -0
  15. package/blog/es/l10n_platform_alternative/crowdin.md +86 -0
  16. package/blog/es/l10n_platform_alternative/phrase.md +84 -0
  17. package/blog/fr/l10n_platform_alternative/Lokalise.md +84 -0
  18. package/blog/fr/l10n_platform_alternative/crowdin.md +86 -0
  19. package/blog/fr/l10n_platform_alternative/phrase.md +91 -0
  20. package/blog/hi/l10n_platform_alternative/Lokalise.md +86 -0
  21. package/blog/hi/l10n_platform_alternative/crowdin.md +84 -0
  22. package/blog/hi/l10n_platform_alternative/phrase.md +78 -0
  23. package/blog/id/l10n_platform_alternative/Lokalise.md +86 -0
  24. package/blog/id/l10n_platform_alternative/crowdin.md +84 -0
  25. package/blog/id/l10n_platform_alternative/phrase.md +89 -0
  26. package/blog/it/l10n_platform_alternative/Lokalise.md +84 -0
  27. package/blog/it/l10n_platform_alternative/crowdin.md +86 -0
  28. package/blog/it/l10n_platform_alternative/phrase.md +82 -0
  29. package/blog/ja/l10n_platform_alternative/Lokalise.md +80 -0
  30. package/blog/ja/l10n_platform_alternative/crowdin.md +80 -0
  31. package/blog/ja/l10n_platform_alternative/phrase.md +78 -0
  32. package/blog/ko/l10n_platform_alternative/Lokalise.md +80 -0
  33. package/blog/ko/l10n_platform_alternative/crowdin.md +86 -0
  34. package/blog/ko/l10n_platform_alternative/phrase.md +78 -0
  35. package/blog/pl/l10n_platform_alternative/Lokalise.md +84 -0
  36. package/blog/pl/l10n_platform_alternative/crowdin.md +80 -0
  37. package/blog/pl/l10n_platform_alternative/phrase.md +82 -0
  38. package/blog/pt/l10n_platform_alternative/Lokalise.md +80 -0
  39. package/blog/pt/l10n_platform_alternative/crowdin.md +86 -0
  40. package/blog/pt/l10n_platform_alternative/phrase.md +78 -0
  41. package/blog/ru/l10n_platform_alternative/Lokalise.md +80 -0
  42. package/blog/ru/l10n_platform_alternative/crowdin.md +86 -0
  43. package/blog/ru/l10n_platform_alternative/phrase.md +82 -0
  44. package/blog/tr/l10n_platform_alternative/Lokalise.md +80 -0
  45. package/blog/tr/l10n_platform_alternative/crowdin.md +80 -0
  46. package/blog/tr/l10n_platform_alternative/phrase.md +89 -0
  47. package/blog/vi/l10n_platform_alternative/Lokalise.md +87 -0
  48. package/blog/vi/l10n_platform_alternative/crowdin.md +80 -0
  49. package/blog/vi/l10n_platform_alternative/phrase.md +82 -0
  50. package/blog/zh/l10n_platform_alternative/Lokalise.md +80 -0
  51. package/blog/zh/l10n_platform_alternative/crowdin.md +84 -0
  52. package/blog/zh/l10n_platform_alternative/phrase.md +84 -0
  53. package/dist/cjs/generated/blog.entry.cjs +57 -0
  54. package/dist/cjs/generated/blog.entry.cjs.map +1 -1
  55. package/dist/esm/generated/blog.entry.mjs +57 -0
  56. package/dist/esm/generated/blog.entry.mjs.map +1 -1
  57. package/dist/types/generated/blog.entry.d.ts +3 -0
  58. package/dist/types/generated/blog.entry.d.ts.map +1 -1
  59. package/docs/ar/configuration.md +7 -0
  60. package/docs/ar/intlayer_with_nuxt.md +2 -2
  61. package/docs/ar/packages/intlayer/getLocaleName.md +17 -1
  62. package/docs/de/configuration.md +7 -0
  63. package/docs/de/intlayer_with_nuxt.md +2 -2
  64. package/docs/de/packages/intlayer/getLocaleName.md +17 -1
  65. package/docs/en/configuration.md +10 -0
  66. package/docs/en/intlayer_with_nuxt.md +2 -2
  67. package/docs/en/packages/intlayer/getLocaleName.md +17 -0
  68. package/docs/en-GB/configuration.md +7 -0
  69. package/docs/en-GB/intlayer_with_nuxt.md +2 -2
  70. package/docs/en-GB/packages/intlayer/getLocaleName.md +17 -1
  71. package/docs/es/configuration.md +7 -0
  72. package/docs/es/intlayer_with_nuxt.md +2 -2
  73. package/docs/es/packages/intlayer/getLocaleName.md +17 -1
  74. package/docs/fr/configuration.md +7 -0
  75. package/docs/fr/intlayer_with_nuxt.md +2 -2
  76. package/docs/fr/packages/intlayer/getLocaleName.md +17 -1
  77. package/docs/hi/configuration.md +7 -0
  78. package/docs/hi/intlayer_with_nuxt.md +2 -2
  79. package/docs/hi/packages/intlayer/getLocaleName.md +17 -1
  80. package/docs/id/configuration.md +7 -0
  81. package/docs/id/intlayer_with_nuxt.md +2 -2
  82. package/docs/id/packages/intlayer/getLocaleName.md +17 -0
  83. package/docs/it/configuration.md +7 -0
  84. package/docs/it/intlayer_with_nuxt.md +2 -2
  85. package/docs/it/packages/intlayer/getLocaleName.md +17 -1
  86. package/docs/ja/configuration.md +7 -0
  87. package/docs/ja/intlayer_with_nuxt.md +2 -2
  88. package/docs/ja/packages/intlayer/getLocaleName.md +17 -1
  89. package/docs/ko/configuration.md +7 -0
  90. package/docs/ko/intlayer_with_nuxt.md +2 -2
  91. package/docs/ko/packages/intlayer/getLocaleName.md +17 -1
  92. package/docs/pl/configuration.md +7 -0
  93. package/docs/pl/intlayer_with_nuxt.md +2 -2
  94. package/docs/pl/packages/intlayer/getLocaleName.md +17 -0
  95. package/docs/pt/configuration.md +7 -0
  96. package/docs/pt/intlayer_with_nuxt.md +2 -2
  97. package/docs/pt/packages/intlayer/getLocaleName.md +17 -1
  98. package/docs/ru/configuration.md +7 -0
  99. package/docs/ru/intlayer_with_nuxt.md +2 -2
  100. package/docs/ru/packages/intlayer/getLocaleName.md +17 -1
  101. package/docs/tr/configuration.md +7 -0
  102. package/docs/tr/intlayer_with_nuxt.md +2 -2
  103. package/docs/tr/packages/intlayer/getLocaleName.md +17 -0
  104. package/docs/vi/configuration.md +7 -0
  105. package/docs/vi/intlayer_with_nuxt.md +2 -2
  106. package/docs/vi/packages/intlayer/getLocaleName.md +17 -0
  107. package/docs/zh/configuration.md +7 -0
  108. package/docs/zh/intlayer_with_nuxt.md +2 -2
  109. package/docs/zh/packages/intlayer/getLocaleName.md +17 -1
  110. package/package.json +6 -6
  111. package/src/generated/blog.entry.ts +57 -0
@@ -19,6 +19,9 @@ slugs:
19
19
  - intlayer
20
20
  - getLocaleName
21
21
  history:
22
+ - version: 7.5.0
23
+ date: 2025-12-18
24
+ changes: React Native ve eski ortamlar için polyfills ekle
22
25
  - version: 5.5.10
23
26
  date: 2025-06-29
24
27
  changes: Geçmiş başlatıldı
@@ -116,3 +119,17 @@ getLocaleName("unknown-locale"); // Çıktı: "Unknown locale"
116
119
  - Fonksiyon varsayılan olarak `displayLocale`'un kendi adını döndürür.
117
120
  - **Eksik çeviriler:**
118
121
  - `localeNameTranslations` `targetLocale` veya belirli `displayLocale` için bir giriş içermezse, fonksiyon `ownLocalesName`'e geri döner veya `"Unknown locale"` döndürür.
122
+
123
+ ## React Native ve Eski Ortamlar için Polyfills
124
+
125
+ `getLocaleName` fonksiyonu `Intl.DisplayNames` API'sine bağımlıdır ve bu API React Native veya eski JavaScript ortamlarında mevcut değildir. Bu ortamlarda `getLocaleName` kullanıyorsanız, polyfills eklemeniz gerekir.
126
+
127
+ Polyfills'i uygulamanızın başında, tercihen giriş noktası dosyanızda (örneğin, `index.js`, `App.tsx` veya `main.tsx`) içe aktarın:
128
+
129
+ ```typescript
130
+ import "intl";
131
+ import "@formatjs/intl-locale/polyfill";
132
+ import "@formatjs/intl-displaynames/polyfill";
133
+ ```
134
+
135
+ Daha fazla ayrıntı için [FormatJS polyfills belgelerine](https://formatjs.io/docs/polyfills/intl-displaynames/) bakın.
@@ -657,6 +657,13 @@ Intlayer hỗ trợ nhiều nhà cung cấp AI để tăng tính linh hoạt và
657
657
  - _Mặc định_: Không có
658
658
  - _Mô tả_: Cung cấp bối cảnh bổ sung về ứng dụng của bạn cho mô hình AI, giúp nó tạo ra các bản dịch chính xác hơn và phù hợp với ngữ cảnh. Điều này có thể bao gồm thông tin về lĩnh vực ứng dụng, đối tượng mục tiêu, giọng điệu hoặc thuật ngữ cụ thể của bạn.
659
659
 
660
+ - **baseURL**:
661
+ - _Kiểu_: `string`
662
+ - _Mặc định_: Không có
663
+ - _Mô tả_: URL cơ sở cho API AI.
664
+ - _Ví dụ_: `'https://api.openai.com/v1'`
665
+ - _Lưu ý_: Có thể được sử dụng để trỏ đến một điểm cuối API AI cục bộ hoặc tùy chỉnh.
666
+
660
667
  ### Cấu hình Build
661
668
 
662
669
  Các thiết lập kiểm soát cách Intlayer tối ưu hóa và xây dựng tính quốc tế hóa của ứng dụng bạn.
@@ -373,11 +373,11 @@ import { useIntlayer } from "vue-intlayer";
373
373
  const content = useIntlayer("home-page");
374
374
 
375
375
  useHead({
376
- title: content.metaTitle.value,
376
+ title: content.metaTitle.raw,
377
377
  meta: [
378
378
  {
379
379
  name: "description",
380
- content: content.metaDescription.value,
380
+ content: content.metaDescription.raw,
381
381
  },
382
382
  ],
383
383
  });
@@ -19,6 +19,9 @@ slugs:
19
19
  - intlayer
20
20
  - getLocaleName
21
21
  history:
22
+ - version: 7.5.0
23
+ date: 2025-12-18
24
+ changes: Thêm polyfills cho React Native và các môi trường cũ hơn
22
25
  - version: 5.5.10
23
26
  date: 2025-06-29
24
27
  changes: Khởi tạo lịch sử
@@ -127,3 +130,17 @@ getLocaleName("unknown-locale"); // Kết quả: "Unknown locale"
127
130
  - Hàm mặc định trả về tên của chính `displayLocale`.
128
131
  - **Thiếu bản dịch:**
129
132
  - Nếu `localeNameTranslations` không chứa mục cho `targetLocale` hoặc `displayLocale` cụ thể, hàm sẽ sử dụng lại `ownLocalesName` hoặc trả về `"Unknown locale"`.
133
+
134
+ ## Polyfills cho React Native và các môi trường cũ hơn
135
+
136
+ Hàm `getLocaleName` phụ thuộc vào API `Intl.DisplayNames`, không có sẵn trong React Native hoặc các môi trường JavaScript cũ hơn. Nếu bạn đang sử dụng `getLocaleName` trong các môi trường này, bạn cần thêm polyfills.
137
+
138
+ Nhập polyfills sớm trong ứng dụng của bạn, lý tưởng là trong tệp điểm vào của bạn (ví dụ: `index.js`, `App.tsx` hoặc `main.tsx`):
139
+
140
+ ```typescript
141
+ import "intl";
142
+ import "@formatjs/intl-locale/polyfill";
143
+ import "@formatjs/intl-displaynames/polyfill";
144
+ ```
145
+
146
+ Để biết thêm chi tiết, xem [tài liệu polyfills FormatJS](https://formatjs.io/docs/polyfills/intl-displaynames/).
@@ -519,6 +519,13 @@ Intlayer 支持多个 AI 提供商,以增强灵活性和选择。目前支持
519
519
  - _默认值_: 无
520
520
  - _描述_: 向 AI 模型提供有关您的应用程序的额外上下文,帮助其生成更准确且符合上下文的翻译。这可以包括您的应用领域、目标受众、语气或特定术语的信息。
521
521
 
522
+ - **baseURL**:
523
+ - _类型_: `string`
524
+ - _默认值_: 无
525
+ - _描述_: AI API 的基础 URL。
526
+ - _示例_: `'https://api.openai.com/v1'`
527
+ - _注意_: 可用于指向本地或自定义的 AI API 端点。
528
+
522
529
  ### 构建配置
523
530
 
524
531
  控制 Intlayer 如何优化和构建您的应用程序国际化的设置。
@@ -373,11 +373,11 @@ import { useIntlayer } from "vue-intlayer";
373
373
  const content = useIntlayer("home-page");
374
374
 
375
375
  useHead({
376
- title: content.metaTitle.value,
376
+ title: content.metaTitle.raw,
377
377
  meta: [
378
378
  {
379
379
  name: "description",
380
- content: content.metaDescription.value,
380
+ content: content.metaDescription.raw,
381
381
  },
382
382
  ],
383
383
  });
@@ -19,6 +19,9 @@ slugs:
19
19
  - intlayer
20
20
  - getLocaleName
21
21
  history:
22
+ - version: 7.5.0
23
+ date: 2025-12-18
24
+ changes: 为 React Native 和旧环境添加 polyfills
22
25
  - version: 5.5.10
23
26
  date: 2025-06-29
24
27
  changes: 初始化历史
@@ -33,7 +36,6 @@ history:
33
36
  ## 参数
34
37
 
35
38
  - `displayLocale: Locales`
36
-
37
39
  - **描述**:用于显示目标语言环境名称的语言环境。
38
40
  - **类型**:表示有效语言环境的枚举或字符串。
39
41
 
@@ -117,3 +119,17 @@ getLocaleName("unknown-locale"); // 输出: "Unknown locale"
117
119
  - 该函数默认返回 `displayLocale` 自身的名称。
118
120
  - **缺少翻译:**
119
121
  - 如果 `localeNameTranslations` 中不包含 `targetLocale` 或特定 `displayLocale` 的条目,函数将回退到 `ownLocalesName`,或者返回 `"Unknown locale"`。
122
+
123
+ ## React Native 和旧环境的 Polyfills
124
+
125
+ `getLocaleName` 函数依赖于 `Intl.DisplayNames` API,该 API 在 React Native 或较旧的 JavaScript 环境中不可用。如果您在这些环境中使用 `getLocaleName`,需要添加 polyfills。
126
+
127
+ 在应用程序的早期导入 polyfills,最好在入口文件中(例如 `index.js`、`App.tsx` 或 `main.tsx`):
128
+
129
+ ```typescript
130
+ import "intl";
131
+ import "@formatjs/intl-locale/polyfill";
132
+ import "@formatjs/intl-displaynames/polyfill";
133
+ ```
134
+
135
+ 更多详细信息,请参阅 [FormatJS polyfills 文档](https://formatjs.io/docs/polyfills/intl-displaynames/)。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@intlayer/docs",
3
- "version": "7.5.0",
3
+ "version": "7.5.2-canary.0",
4
4
  "private": false,
5
5
  "description": "Intlayer documentation",
6
6
  "keywords": [
@@ -73,13 +73,13 @@
73
73
  "watch": "webpack --config ./webpack.config.ts --watch"
74
74
  },
75
75
  "dependencies": {
76
- "@intlayer/config": "7.5.0",
77
- "@intlayer/core": "7.5.0",
78
- "@intlayer/types": "7.5.0"
76
+ "@intlayer/config": "7.5.2-canary.0",
77
+ "@intlayer/core": "7.5.2-canary.0",
78
+ "@intlayer/types": "7.5.2-canary.0"
79
79
  },
80
80
  "devDependencies": {
81
- "@intlayer/api": "7.5.0",
82
- "@intlayer/cli": "7.5.0",
81
+ "@intlayer/api": "7.5.2-canary.0",
82
+ "@intlayer/cli": "7.5.2-canary.0",
83
83
  "@types/node": "25.0.3",
84
84
  "@utils/ts-config": "1.0.4",
85
85
  "@utils/ts-config-types": "1.0.4",
@@ -262,6 +262,63 @@ export const blogEntry = {
262
262
  id: readLocale('intlayer_with_vue-i18n.md', 'id'),
263
263
  vi: readLocale('intlayer_with_vue-i18n.md', 'vi'),
264
264
  } as unknown as Record<LocalesValues, Promise<string>>,
265
+ './blog/en/l10n_platform_alternative/Lokalise.md': {
266
+ en: readLocale('l10n_platform_alternative/Lokalise.md', 'en'),
267
+ ru: readLocale('l10n_platform_alternative/Lokalise.md', 'ru'),
268
+ ja: readLocale('l10n_platform_alternative/Lokalise.md', 'ja'),
269
+ fr: readLocale('l10n_platform_alternative/Lokalise.md', 'fr'),
270
+ ko: readLocale('l10n_platform_alternative/Lokalise.md', 'ko'),
271
+ zh: readLocale('l10n_platform_alternative/Lokalise.md', 'zh'),
272
+ es: readLocale('l10n_platform_alternative/Lokalise.md', 'es'),
273
+ de: readLocale('l10n_platform_alternative/Lokalise.md', 'de'),
274
+ ar: readLocale('l10n_platform_alternative/Lokalise.md', 'ar'),
275
+ it: readLocale('l10n_platform_alternative/Lokalise.md', 'it'),
276
+ 'en-GB': readLocale('l10n_platform_alternative/Lokalise.md', 'en-GB'),
277
+ pt: readLocale('l10n_platform_alternative/Lokalise.md', 'pt'),
278
+ hi: readLocale('l10n_platform_alternative/Lokalise.md', 'hi'),
279
+ tr: readLocale('l10n_platform_alternative/Lokalise.md', 'tr'),
280
+ pl: readLocale('l10n_platform_alternative/Lokalise.md', 'pl'),
281
+ id: readLocale('l10n_platform_alternative/Lokalise.md', 'id'),
282
+ vi: readLocale('l10n_platform_alternative/Lokalise.md', 'vi'),
283
+ } as unknown as Record<LocalesValues, Promise<string>>,
284
+ './blog/en/l10n_platform_alternative/crowdin.md': {
285
+ en: readLocale('l10n_platform_alternative/crowdin.md', 'en'),
286
+ ru: readLocale('l10n_platform_alternative/crowdin.md', 'ru'),
287
+ ja: readLocale('l10n_platform_alternative/crowdin.md', 'ja'),
288
+ fr: readLocale('l10n_platform_alternative/crowdin.md', 'fr'),
289
+ ko: readLocale('l10n_platform_alternative/crowdin.md', 'ko'),
290
+ zh: readLocale('l10n_platform_alternative/crowdin.md', 'zh'),
291
+ es: readLocale('l10n_platform_alternative/crowdin.md', 'es'),
292
+ de: readLocale('l10n_platform_alternative/crowdin.md', 'de'),
293
+ ar: readLocale('l10n_platform_alternative/crowdin.md', 'ar'),
294
+ it: readLocale('l10n_platform_alternative/crowdin.md', 'it'),
295
+ 'en-GB': readLocale('l10n_platform_alternative/crowdin.md', 'en-GB'),
296
+ pt: readLocale('l10n_platform_alternative/crowdin.md', 'pt'),
297
+ hi: readLocale('l10n_platform_alternative/crowdin.md', 'hi'),
298
+ tr: readLocale('l10n_platform_alternative/crowdin.md', 'tr'),
299
+ pl: readLocale('l10n_platform_alternative/crowdin.md', 'pl'),
300
+ id: readLocale('l10n_platform_alternative/crowdin.md', 'id'),
301
+ vi: readLocale('l10n_platform_alternative/crowdin.md', 'vi'),
302
+ } as unknown as Record<LocalesValues, Promise<string>>,
303
+ './blog/en/l10n_platform_alternative/phrase.md': {
304
+ en: readLocale('l10n_platform_alternative/phrase.md', 'en'),
305
+ ru: readLocale('l10n_platform_alternative/phrase.md', 'ru'),
306
+ ja: readLocale('l10n_platform_alternative/phrase.md', 'ja'),
307
+ fr: readLocale('l10n_platform_alternative/phrase.md', 'fr'),
308
+ ko: readLocale('l10n_platform_alternative/phrase.md', 'ko'),
309
+ zh: readLocale('l10n_platform_alternative/phrase.md', 'zh'),
310
+ es: readLocale('l10n_platform_alternative/phrase.md', 'es'),
311
+ de: readLocale('l10n_platform_alternative/phrase.md', 'de'),
312
+ ar: readLocale('l10n_platform_alternative/phrase.md', 'ar'),
313
+ it: readLocale('l10n_platform_alternative/phrase.md', 'it'),
314
+ 'en-GB': readLocale('l10n_platform_alternative/phrase.md', 'en-GB'),
315
+ pt: readLocale('l10n_platform_alternative/phrase.md', 'pt'),
316
+ hi: readLocale('l10n_platform_alternative/phrase.md', 'hi'),
317
+ tr: readLocale('l10n_platform_alternative/phrase.md', 'tr'),
318
+ pl: readLocale('l10n_platform_alternative/phrase.md', 'pl'),
319
+ id: readLocale('l10n_platform_alternative/phrase.md', 'id'),
320
+ vi: readLocale('l10n_platform_alternative/phrase.md', 'vi'),
321
+ } as unknown as Record<LocalesValues, Promise<string>>,
265
322
  './blog/en/list_i18n_technologies/CMS/drupal.md': {
266
323
  en: readLocale('list_i18n_technologies/CMS/drupal.md', 'en'),
267
324
  ru: readLocale('list_i18n_technologies/CMS/drupal.md', 'ru'),