@intlayer/docs 8.6.1 → 8.6.10

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 (197) hide show
  1. package/dist/cjs/doc.cjs.map +1 -1
  2. package/dist/cjs/generated/docs.entry.cjs +60 -0
  3. package/dist/cjs/generated/docs.entry.cjs.map +1 -1
  4. package/dist/esm/doc.mjs.map +1 -1
  5. package/dist/esm/generated/docs.entry.mjs +60 -0
  6. package/dist/esm/generated/docs.entry.mjs.map +1 -1
  7. package/dist/types/doc.d.ts.map +1 -1
  8. package/dist/types/generated/docs.entry.d.ts +3 -0
  9. package/dist/types/generated/docs.entry.d.ts.map +1 -1
  10. package/docs/ar/cli/index.md +54 -42
  11. package/docs/ar/cli/init.md +32 -20
  12. package/docs/ar/cli/standalone.md +91 -0
  13. package/docs/ar/configuration.md +39 -7
  14. package/docs/ar/custom_domains.md +250 -0
  15. package/docs/ar/intlayer_with_tanstack+solid.md +14 -33
  16. package/docs/ar/intlayer_with_tanstack.md +25 -16
  17. package/docs/ar/intlayer_with_vanilla.md +506 -0
  18. package/docs/bn/cli/index.md +195 -0
  19. package/docs/bn/cli/init.md +96 -0
  20. package/docs/bn/cli/standalone.md +91 -0
  21. package/docs/bn/configuration.md +46 -14
  22. package/docs/bn/custom_domains.md +250 -0
  23. package/docs/bn/intlayer_with_vanilla.md +506 -0
  24. package/docs/cs/cli/index.md +195 -0
  25. package/docs/cs/cli/init.md +96 -0
  26. package/docs/cs/cli/standalone.md +91 -0
  27. package/docs/cs/configuration.md +46 -7
  28. package/docs/cs/custom_domains.md +250 -0
  29. package/docs/cs/intlayer_with_vanilla.md +506 -0
  30. package/docs/de/cli/index.md +53 -41
  31. package/docs/de/cli/standalone.md +91 -0
  32. package/docs/de/configuration.md +46 -7
  33. package/docs/de/custom_domains.md +250 -0
  34. package/docs/de/intlayer_with_tanstack+solid.md +14 -33
  35. package/docs/de/intlayer_with_tanstack.md +25 -16
  36. package/docs/de/intlayer_with_vanilla.md +506 -0
  37. package/docs/en/bundle_optimization.md +288 -23
  38. package/docs/en/cli/index.md +6 -1
  39. package/docs/en/cli/init.md +13 -1
  40. package/docs/en/cli/standalone.md +91 -0
  41. package/docs/en/configuration.md +46 -7
  42. package/docs/en/custom_domains.md +245 -0
  43. package/docs/en/intlayer_with_tanstack+solid.md +14 -33
  44. package/docs/en/intlayer_with_tanstack.md +25 -16
  45. package/docs/en/intlayer_with_vanilla.md +506 -0
  46. package/docs/en-GB/cli/index.md +56 -44
  47. package/docs/en-GB/cli/init.md +28 -21
  48. package/docs/en-GB/cli/standalone.md +91 -0
  49. package/docs/en-GB/configuration.md +53 -14
  50. package/docs/en-GB/custom_domains.md +250 -0
  51. package/docs/en-GB/intlayer_with_tanstack+solid.md +14 -33
  52. package/docs/en-GB/intlayer_with_tanstack.md +25 -16
  53. package/docs/en-GB/intlayer_with_vanilla.md +506 -0
  54. package/docs/es/cli/index.md +65 -53
  55. package/docs/es/cli/init.md +33 -21
  56. package/docs/es/cli/standalone.md +91 -0
  57. package/docs/es/configuration.md +39 -1
  58. package/docs/es/custom_domains.md +250 -0
  59. package/docs/es/intlayer_with_tanstack+solid.md +14 -33
  60. package/docs/es/intlayer_with_tanstack.md +25 -16
  61. package/docs/es/intlayer_with_vanilla.md +506 -0
  62. package/docs/fr/cli/index.md +43 -31
  63. package/docs/fr/cli/init.md +37 -25
  64. package/docs/fr/cli/standalone.md +91 -0
  65. package/docs/fr/configuration.md +46 -7
  66. package/docs/fr/custom_domains.md +250 -0
  67. package/docs/fr/intlayer_with_tanstack+solid.md +14 -33
  68. package/docs/fr/intlayer_with_tanstack.md +25 -16
  69. package/docs/fr/intlayer_with_vanilla.md +506 -0
  70. package/docs/hi/cli/index.md +71 -59
  71. package/docs/hi/cli/init.md +37 -33
  72. package/docs/hi/cli/standalone.md +91 -0
  73. package/docs/hi/configuration.md +39 -7
  74. package/docs/hi/custom_domains.md +250 -0
  75. package/docs/hi/intlayer_with_tanstack+solid.md +14 -33
  76. package/docs/hi/intlayer_with_tanstack.md +25 -16
  77. package/docs/hi/intlayer_with_vanilla.md +506 -0
  78. package/docs/id/cli/index.md +59 -47
  79. package/docs/id/cli/init.md +32 -25
  80. package/docs/id/cli/standalone.md +91 -0
  81. package/docs/id/configuration.md +46 -7
  82. package/docs/id/custom_domains.md +250 -0
  83. package/docs/id/intlayer_with_tanstack+solid.md +14 -33
  84. package/docs/id/intlayer_with_tanstack.md +25 -16
  85. package/docs/id/intlayer_with_vanilla.md +506 -0
  86. package/docs/it/cli/index.md +58 -41
  87. package/docs/it/cli/init.md +37 -38
  88. package/docs/it/cli/standalone.md +91 -0
  89. package/docs/it/configuration.md +46 -7
  90. package/docs/it/custom_domains.md +250 -0
  91. package/docs/it/intlayer_with_tanstack+solid.md +14 -33
  92. package/docs/it/intlayer_with_tanstack.md +25 -16
  93. package/docs/it/intlayer_with_vanilla.md +506 -0
  94. package/docs/ja/cli/index.md +59 -47
  95. package/docs/ja/cli/init.md +36 -24
  96. package/docs/ja/cli/standalone.md +91 -0
  97. package/docs/ja/configuration.md +46 -7
  98. package/docs/ja/custom_domains.md +250 -0
  99. package/docs/ja/intlayer_with_tanstack+solid.md +14 -33
  100. package/docs/ja/intlayer_with_tanstack.md +25 -16
  101. package/docs/ja/intlayer_with_vanilla.md +506 -0
  102. package/docs/ko/cli/index.md +58 -46
  103. package/docs/ko/cli/init.md +39 -35
  104. package/docs/ko/cli/standalone.md +91 -0
  105. package/docs/ko/configuration.md +47 -8
  106. package/docs/ko/custom_domains.md +250 -0
  107. package/docs/ko/intlayer_with_tanstack+solid.md +14 -33
  108. package/docs/ko/intlayer_with_tanstack.md +25 -16
  109. package/docs/ko/intlayer_with_vanilla.md +506 -0
  110. package/docs/nl/cli/index.md +195 -0
  111. package/docs/nl/cli/init.md +96 -0
  112. package/docs/nl/cli/standalone.md +91 -0
  113. package/docs/nl/configuration.md +46 -7
  114. package/docs/nl/custom_domains.md +250 -0
  115. package/docs/nl/intlayer_with_vanilla.md +506 -0
  116. package/docs/pl/cli/index.md +56 -44
  117. package/docs/pl/cli/init.md +36 -32
  118. package/docs/pl/cli/standalone.md +91 -0
  119. package/docs/pl/configuration.md +46 -7
  120. package/docs/pl/custom_domains.md +250 -0
  121. package/docs/pl/intlayer_with_tanstack+solid.md +14 -33
  122. package/docs/pl/intlayer_with_tanstack.md +25 -16
  123. package/docs/pl/intlayer_with_vanilla.md +506 -0
  124. package/docs/pt/cli/index.md +64 -52
  125. package/docs/pt/cli/init.md +35 -31
  126. package/docs/pt/cli/standalone.md +91 -0
  127. package/docs/pt/configuration.md +46 -7
  128. package/docs/pt/custom_domains.md +250 -0
  129. package/docs/pt/intlayer_with_tanstack+solid.md +14 -33
  130. package/docs/pt/intlayer_with_tanstack.md +25 -16
  131. package/docs/pt/intlayer_with_vanilla.md +506 -0
  132. package/docs/ru/cli/index.md +54 -42
  133. package/docs/ru/cli/init.md +31 -27
  134. package/docs/ru/cli/standalone.md +91 -0
  135. package/docs/ru/configuration.md +46 -7
  136. package/docs/ru/custom_domains.md +250 -0
  137. package/docs/ru/intlayer_with_tanstack+solid.md +14 -33
  138. package/docs/ru/intlayer_with_tanstack.md +25 -16
  139. package/docs/ru/intlayer_with_vanilla.md +506 -0
  140. package/docs/tr/cli/index.md +64 -52
  141. package/docs/tr/cli/init.md +37 -30
  142. package/docs/tr/cli/standalone.md +91 -0
  143. package/docs/tr/configuration.md +46 -7
  144. package/docs/tr/custom_domains.md +250 -0
  145. package/docs/tr/intlayer_with_tanstack+solid.md +14 -33
  146. package/docs/tr/intlayer_with_tanstack.md +25 -16
  147. package/docs/tr/intlayer_with_vanilla.md +506 -0
  148. package/docs/uk/cli/index.md +60 -55
  149. package/docs/uk/cli/init.md +32 -20
  150. package/docs/uk/cli/standalone.md +91 -0
  151. package/docs/uk/configuration.md +46 -7
  152. package/docs/uk/custom_domains.md +250 -0
  153. package/docs/uk/intlayer_with_tanstack+solid.md +14 -33
  154. package/docs/uk/intlayer_with_tanstack.md +25 -16
  155. package/docs/uk/intlayer_with_vanilla.md +506 -0
  156. package/docs/ur/cli/index.md +195 -0
  157. package/docs/ur/cli/init.md +96 -0
  158. package/docs/ur/cli/standalone.md +91 -0
  159. package/docs/ur/configuration.md +46 -7
  160. package/docs/ur/custom_domains.md +250 -0
  161. package/docs/ur/intlayer_with_vanilla.md +506 -0
  162. package/docs/vi/cli/index.md +72 -61
  163. package/docs/vi/cli/init.md +33 -21
  164. package/docs/vi/cli/standalone.md +91 -0
  165. package/docs/vi/configuration.md +46 -7
  166. package/docs/vi/custom_domains.md +250 -0
  167. package/docs/vi/intlayer_with_tanstack+solid.md +14 -33
  168. package/docs/vi/intlayer_with_tanstack.md +25 -16
  169. package/docs/vi/intlayer_with_vanilla.md +506 -0
  170. package/docs/zh/cli/index.md +56 -49
  171. package/docs/zh/cli/init.md +30 -18
  172. package/docs/zh/cli/standalone.md +91 -0
  173. package/docs/zh/configuration.md +46 -7
  174. package/docs/zh/custom_domains.md +250 -0
  175. package/docs/zh/intlayer_with_tanstack+solid.md +14 -33
  176. package/docs/zh/intlayer_with_tanstack.md +25 -16
  177. package/docs/zh/intlayer_with_vanilla.md +506 -0
  178. package/package.json +8 -8
  179. package/src/doc.ts +4 -1
  180. package/src/generated/docs.entry.ts +60 -0
  181. package/docs/ar/bundle_optimization.md +0 -185
  182. package/docs/de/bundle_optimization.md +0 -195
  183. package/docs/en-GB/bundle_optimization.md +0 -184
  184. package/docs/es/bundle_optimization.md +0 -194
  185. package/docs/fr/bundle_optimization.md +0 -184
  186. package/docs/hi/bundle_optimization.md +0 -185
  187. package/docs/id/bundle_optimization.md +0 -185
  188. package/docs/it/bundle_optimization.md +0 -185
  189. package/docs/ja/bundle_optimization.md +0 -185
  190. package/docs/ko/bundle_optimization.md +0 -185
  191. package/docs/pl/bundle_optimization.md +0 -185
  192. package/docs/pt/bundle_optimization.md +0 -184
  193. package/docs/ru/bundle_optimization.md +0 -185
  194. package/docs/tr/bundle_optimization.md +0 -184
  195. package/docs/uk/bundle_optimization.md +0 -186
  196. package/docs/vi/bundle_optimization.md +0 -185
  197. package/docs/zh/bundle_optimization.md +0 -185
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  createdAt: 2024-08-11
3
- updatedAt: 2026-01-06
4
- title: CLI
5
- description: 了解如何使用 Intlayer CLI 来管理您的多语言网站。按照本在线文档中的步骤,几分钟内即可设置您的项目。
3
+ updatedAt: 2026-03-31
4
+ title: CLI - 适用于多语言网站的所有 Intlayer CLI 命令
5
+ description: 了解如何使用 Intlayer CLI 管理您的多语言网站。按照此在线文档中的步骤,在几分钟内设置您的项目。
6
6
  keywords:
7
7
  - CLI
8
8
  - 命令行界面
@@ -17,39 +17,45 @@ slugs:
17
17
  - concept
18
18
  - cli
19
19
  history:
20
+ - version: 8.6.4
21
+ date: 2026-03-31
22
+ changes: "添加 standalone 命令内容"
20
23
  - version: 7.5.11
21
24
  date: 2026-01-06
22
- changes: "添加 projects list 命令"
25
+ changes: "添加 CI 命令内容"
26
+ - version: 7.5.11
27
+ date: 2026-01-06
28
+ changes: "添加 list projects 命令内容"
23
29
  - version: 7.5.9
24
30
  date: 2025-12-30
25
- changes: "添加 init 命令"
31
+ changes: "添加 init 命令内容"
26
32
  - version: 7.2.3
27
33
  date: 2025-11-22
28
- changes: "添加 transform 命令"
34
+ changes: "添加 extract 命令内容"
29
35
  - version: 7.1.0
30
36
  date: 2025-11-05
31
- changes: " translate 命令添加 skipIfExists 选项"
37
+ changes: "为翻译命令添加 skipIfExists 选项"
32
38
  - version: 6.1.4
33
39
  date: 2025-01-27
34
- changes: " CLI 参数和命令添加别名"
40
+ changes: "添加 CLI 参数和命令的别名"
35
41
  - version: 6.1.3
36
42
  date: 2025-10-05
37
43
  changes: "为命令添加 build 选项"
38
44
  - version: 6.1.2
39
45
  date: 2025-09-26
40
- changes: "添加 version 命令"
46
+ changes: "添加 version 命令内容"
41
47
  - version: 6.1.0
42
48
  date: 2025-09-26
43
- changes: "使用 CLI 将 verbose 选项默认设置为 true"
49
+ changes: "通过 CLI 将 verbose 选项默认设置为 true"
44
50
  - version: 6.1.0
45
51
  date: 2025-09-23
46
52
  changes: "添加 watch 命令和 with 选项"
47
53
  - version: 6.0.1
48
54
  date: 2025-09-23
49
- changes: "添加 editor 命令"
55
+ changes: "添加 editor 命令内容"
50
56
  - version: 6.0.0
51
57
  date: 2025-09-17
52
- changes: "添加 content test 和 list 命令"
58
+ changes: "添加内容测试和列表命令"
53
59
  - version: 5.5.11
54
60
  date: 2025-07-11
55
61
  changes: "更新 CLI 命令参数文档"
@@ -58,7 +64,7 @@ history:
58
64
  changes: "初始化历史记录"
59
65
  ---
60
66
 
61
- # Intlayer CLI
67
+ # Intlayer CLI - 适用于多语言网站的所有 Intlayer CLI 命令
62
68
 
63
69
  ---
64
70
 
@@ -88,19 +94,19 @@ pnpm add intlayer-cli -g
88
94
  bun add intlayer-cli -g
89
95
  ```
90
96
 
91
- > 如果已经安装了 `intlayer` 包,CLI 会自动安装。你可以跳过这一步。
97
+ > 如果已经安装了 `intlayer` 包,CLI 将自动安装。您可以跳过此步骤。
92
98
 
93
99
  ## intlayer-cli 包
94
100
 
95
- `intlayer-cli` 包旨在将你的 [intlayer 声明](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/content_file.md) 转换成字典。
101
+ `intlayer-cli` 包旨在将您的 [Intlayer 声明](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/content_file.md)转译为字典。
96
102
 
97
- 该包会转换所有 intlayer 文件,例如 `src/**/*.content.{ts|js|mjs|cjs|json}`。[查看如何声明你的 Intlayer 声明文件](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md)。
103
+ 该包会转译所有 Intlayer 文件,例如 `src/**/*.content.{ts|js|mjs|cjs|json}`。[查看如何声明您的 Intlayer 声明文件](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md)。
98
104
 
99
- 要解释 intlayer 字典,你可以使用解释器,例如 [react-intlayer](https://www.npmjs.com/package/react-intlayer) 或 [next-intlayer](https://www.npmjs.com/package/next-intlayer)。
105
+ 要解释 Intlayer 字典,您可以使用解释器,例如 [react-intlayer](https://www.npmjs.com/package/react-intlayer) 或 [next-intlayer](https://www.npmjs.com/package/next-intlayer)。
100
106
 
101
107
  ## 配置文件支持
102
108
 
103
- Intlayer 支持多种配置文件格式:
109
+ Intlayer 接受多种配置文件格式:
104
110
 
105
111
  - `intlayer.config.ts`
106
112
  - `intlayer.config.js`
@@ -109,59 +115,59 @@ Intlayer 支持多种配置文件格式:
109
115
  - `intlayer.config.mjs`
110
116
  - `.intlayerrc`
111
117
 
112
- 有关如何配置可用语言环境或其他参数,请参阅[此处的配置文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)。
118
+ 要了解如何配置可用语言或其他参数,请参阅[此处的配置文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)。
113
119
 
114
- ## 运行 intlayer 命令
120
+ ## 执行 Intlayer 命令
115
121
 
116
122
  ### 身份验证
117
123
 
118
- - **[登录](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/login.md)** - 使用 Intlayer CMS 进行身份验证并获取访问凭据
124
+ - **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/login.md)** - Intlayer CMS 中进行身份验证并获取访问凭据
119
125
 
120
126
  ### 核心命令
121
127
 
122
- - **[构建字典](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/build.md)** - 从内容声明文件构建字典
123
- - **[监视字典](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/watch.md)** - 监视更改并自动构建字典
124
- - **[检查 CLI 版本](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/version.md)** - 检查已安装的 Intlayer CLI 版本
125
- - **[列出项目](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/list_projects.md)** - 列出目录或 git 存储库中的所有 Intlayer 项目
128
+ - **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/build.md)** - 从内容声明文件构建字典
129
+ - **[Watch Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/watch.md)** - 监听更改并自动重新构建字典
130
+ - **[Create Standalone Bundle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/standalone.md)** - 创建包含 Intlayer 和指定包的独立 JavaScript bundle
131
+ - **[Check CLI Version](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/version.md)** - 检查已安装的 Intlayer CLI 版本
132
+ - **[List Projects](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/list_projects.md)** - 列出目录或 git 仓库中的所有 Intlayer 项目
126
133
 
127
134
  ### 字典管理
128
135
 
129
- - **[推送字典](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/push.md)** - 将字典推送到 Intlayer 编辑器和 CMS
130
- - **[拉取词典](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/pull.md)** - 从 Intlayer 编辑器和 CMS 拉取词典
131
- - **[填充词典](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/fill.md)** - 使用 AI 填充、审核和翻译词典
132
- - **[测试缺失翻译](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/test.md)** - 测试并识别缺失的翻译
133
- - **[列出内容声明文件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/list.md)** - 列出项目中所有内容声明文件
136
+ - **[Push Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/push.md)** - 将字典发送到 Intlayer 编辑器和 CMS
137
+ - **[Pull Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/pull.md)** - 从 Intlayer 编辑器和 CMS 获取字典
138
+ - **[Fill Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/fill.md)** - 使用 AI 填充、审核并翻译字典
139
+ - **[Test Missing Translations](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/test.md)** - 测试并识别缺失的翻译
140
+ - **[List Content Declaration Files](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/list.md)** - 列出项目中的所有内容声明文件
134
141
 
135
142
  ### 组件管理
136
143
 
137
- - **[转换组件](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/extract.md)** - 转换现有组件以使用 Intlayer
144
+ - **[Extract Strings](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/extract.md)** - 从组件中提取字符串到组件附近的 .content 文件中
138
145
 
139
146
  ### 配置
140
147
 
141
- - **[初始化 Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/init.md)** - 在您的项目中通过自动配置设置 Intlayer
142
- - **[管理配置](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/configuration.md)** - 获取并推送您的 Intlayer 配置到 CMS
148
+ - **[Initialize Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/init.md)** - 使用自动配置在您的项目中设置 Intlayer
149
+ - **[Manage Configuration](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/configuration.md)** - 获取您的 Intlayer 配置并将其发送到 CMS
143
150
 
144
151
  ### 文档管理
145
152
 
146
- - **[翻译文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/doc-translate.md)** - 使用 AI 自动翻译文档文件
147
- - **[审查文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/doc-review.md)** - 审查文档文件的质量和一致性
153
+ - **[Translate Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/doc-translate.md)** - 使用 AI 自动翻译文档文件
154
+ - **[Review Document](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/doc-review.md)** - 审核文档文件的质量和一致性
148
155
 
149
- ### 编辑器与实时同步
156
+ ### 编辑器与实时同步 (Live Sync)
150
157
 
151
- - **[编辑器命令](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/editor.md)** - 使用 Intlayer 编辑器命令
152
- - **[实时同步命令](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/live.md)** - 使用实时同步在运行时反映 CMS 内容更改
158
+ - **[Editor Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/editor.md)** - 使用 Intlayer 编辑器命令
159
+ - **[Live Sync Commands](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/live.md)** - 使用 Live Sync 在运行时应用来自 CMS 的内容更改
153
160
 
154
- ### 开发工具
161
+ ### CI/CD 与自动化
155
162
 
156
- - **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/sdk.md)** - 在您自己的代码中使用 Intlayer CLI SDK
157
- - **[调试 Intlayer 命令](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/debug.md)** - 调试和排查 Intlayer CLI 问题
163
+ - **[CI Command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/ci.md)** - 使用自动注入的凭据执行 CI/CD 流水的 Intlayer 命令
158
164
 
159
- ## 在您的 `package.json` 中使用 intlayer 命令
165
+ ### 开发工具
160
166
 
161
- - **[编辑器命令](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/editor.md)** - 使用 Intlayer 编辑器命令
162
- - **[实时同步命令](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/live.md)** - 使用实时同步在运行时反映 CMS 内容更改
167
+ - **[CLI SDK](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/sdk.md)** - 在您自己的代码中使用 Intlayer CLI SDK
168
+ - **[Debug Intlayer Command](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/debug.md)** - 调试并修复 Intlayer CLI 的问题
163
169
 
164
- ## 在您的 `package.json` 中使用 intlayer 命令
170
+ ## `package.json` 中使用 intlayer 命令
165
171
 
166
172
  ```json fileName="package.json"
167
173
  "scripts": {
@@ -169,6 +175,7 @@ Intlayer 支持多种配置文件格式:
169
175
  "intlayer:login": "npx intlayer login",
170
176
  "intlayer:build": "npx intlayer build",
171
177
  "intlayer:watch": "npx intlayer build --watch",
178
+ "intlayer:standalone": "npx intlayer standalone --packages intlayer vanilla-intlayer",
172
179
  "intlayer:push": "npx intlayer push",
173
180
  "intlayer:pull": "npx intlayer pull",
174
181
  "intlayer:fill": "npx intlayer fill",
@@ -181,8 +188,8 @@ Intlayer 支持多种配置文件格式:
181
188
  }
182
189
  ```
183
190
 
184
- > **注意**:您也可以使用更简短的别名:
191
+ > **注意**:您也可以使用较短的别名:
185
192
  >
186
- > - 使用 `npx intlayer list` 替代 `npx intlayer content list`
187
- > - 使用 `npx intlayer test` 替代 `npx intlayer content test`
188
- > - 使用 `npx intlayer projects-list` 或 `npx intlayer pl` 替代 `npx intlayer projects list`
193
+ > - `npx intlayer list` 代替 `npx intlayer content list`
194
+ > - `npx intlayer test` 代替 `npx intlayer content test`
195
+ > - `npx intlayer projects-list` 或 `npx intlayer pl` 代替 `npx intlayer projects list`
@@ -2,7 +2,7 @@
2
2
  createdAt: 2025-12-30
3
3
  updatedAt: 2025-12-30
4
4
  title: 初始化 Intlayer
5
- description: 了解如何在项目中初始化 Intlayer。
5
+ description: 了解如何在您的项目中初始化 Intlayer。
6
6
  keywords:
7
7
  - 初始化
8
8
  - CLI
@@ -14,9 +14,12 @@ slugs:
14
14
  - cli
15
15
  - init
16
16
  history:
17
+ - version: 8.6.4
18
+ date: 2026-03-31
19
+ changes: "添加 --no-gitignore 选项"
17
20
  - version: 7.5.9
18
21
  date: 2025-12-30
19
- changes: "添加 init 命令"
22
+ changes: "添加 init 命令内容"
20
23
  ---
21
24
 
22
25
  # 初始化 Intlayer
@@ -25,7 +28,7 @@ history:
25
28
  npx intlayer init
26
29
  ```
27
30
 
28
- `init` 命令会自动在你的项目中设置 Intlayer,配置必要的文件和设置。这是开始使用 Intlayer 的推荐方式。
31
+ `init` 命令通过创建必要的文件和设置,在您的项目中自动配置 Intlayer。这是开始使用 Intlayer 的推荐方式。
29
32
 
30
33
  ## 别名:
31
34
 
@@ -33,28 +36,29 @@ npx intlayer init
33
36
 
34
37
  ## 参数:
35
38
 
36
- - `--project-root [projectRoot]` - 可选。指定项目根目录。如果未提供,命令将从当前工作目录开始向上搜索项目根目录。
39
+ - `--project-root [projectRoot]` - 可选。指定项目的根目录。如果未提供,命令将从当前工作目录开始搜索项目根目录。
40
+ - `--no-gitignore` - 可选。跳过自动更新 `.gitignore` 文件。如果设置了此标志,`.intlayer` 将不会添加到 `.gitignore` 中。
37
41
 
38
- ## 它会执行以下操作:
42
+ ## 工作原理:
39
43
 
40
44
  `init` 命令执行以下设置任务:
41
45
 
42
- 1. **验证项目结构** - 确保你位于包含 `package.json` 文件的有效项目目录中
43
- 2. **更新 `.gitignore`** - 将 `.intlayer` 添加到你的 `.gitignore` 文件中,以将生成的文件排除在版本控制之外
44
- 3. **配置 TypeScript** - 更新所有 `tsconfig.json` 文件以包含 Intlayer 类型定义(`.intlayer/**/*.ts`)
45
- 4. **创建配置文件** - 生成带有默认设置的 `intlayer.config.ts`(用于 TypeScript 项目)或 `intlayer.config.mjs`(用于 JavaScript 项目)
46
- 5. **更新 Vite 配置** - 如果检测到 Vite 配置文件,则添加 `vite-intlayer` 插件的导入
47
- 6. **更新 Next.js 配置** - 如果检测到 Next.js 配置文件,则添加 `next-intlayer` 插件的导入
46
+ 1. **验证项目结构** - 确保您位于包含 `package.json` 文件的有效项目目录中。
47
+ 2. **更新 `.gitignore`** - 将 `.intlayer` 添加到您的 `.gitignore` 文件中,以将生成的文件排除在版本控制之外(可以使用 `--no-gitignore` 跳过)。
48
+ 3. **配置 TypeScript** - 更新任何 `tsconfig.json` 文件以包含 Intlayer 类型定义 (`.intlayer/**/*.ts`)。
49
+ 4. **创建配置文件** - 使用默认设置生成 `intlayer.config.ts`(对于 TypeScript 项目)或 `intlayer.config.mjs`(对于 JavaScript 项目)。
50
+ 5. **更新 Vite 配置** - 如果检测到 Vite 配置文件,将添加 `vite-intlayer` 插件的导入。
51
+ 6. **更新 Next.js 配置** - 如果检测到 Next.js 配置文件,将添加 `next-intlayer` 插件的导入。
48
52
 
49
53
  ## 示例:
50
54
 
51
- ### 基本初始化:
55
+ ### 基础初始化:
52
56
 
53
57
  ```bash
54
58
  npx intlayer init
55
59
  ```
56
60
 
57
- 这将在当前目录初始化 Intlayer,自动检测项目根目录。
61
+ 这将在当前目录中初始化 Intlayer,并自动检测项目根目录。
58
62
 
59
63
  ### 使用自定义项目根目录初始化:
60
64
 
@@ -62,9 +66,17 @@ npx intlayer init
62
66
  npx intlayer init --project-root ./my-project
63
67
  ```
64
68
 
65
- 这将在指定目录初始化 Intlayer。
69
+ 这将在指定的目录中初始化 Intlayer。
66
70
 
67
- ## 示例输出:
71
+ ### 初始化而不更新 .gitignore:
72
+
73
+ ```bash
74
+ npx intlayer init --no-gitignore
75
+ ```
76
+
77
+ 这将设置所有配置文件,但不会修改您的 `.gitignore`。
78
+
79
+ ## 输出示例:
68
80
 
69
81
  ```bash
70
82
  npx intlayer init
@@ -78,7 +90,7 @@ Checking Intlayer configuration...
78
90
 
79
91
  ## 注意事项:
80
92
 
81
- - 该命令是幂等的 - 可以安全地多次运行。它会跳过已配置的步骤。
93
+ - 该命令是幂等的——您可以安全地多次运行它。已配置的步骤将被跳过。
82
94
  - 如果配置文件已存在,则不会被覆盖。
83
- - 如果 TypeScript 配置文件没有 `include` 数组(例如带 references solution 样式配置),则会被跳过。
84
- - 如果在项目根目录未找到 `package.json`,命令将以错误退出。
95
+ - 不包含 `include` 数组的 TypeScript 配置(例如带有引用的 solution-style 配置)将被跳过。
96
+ - 如果在项目根目录中未找到 `package.json`,该命令将报错退出。
@@ -0,0 +1,91 @@
1
+ ---
2
+ createdAt: 2024-08-11
3
+ updatedAt: 2026-03-31
4
+ title: 独立 Bundle (Standalone Bundle)
5
+ description: 了解如何为应用程序内容创建独立的 JavaScript bundle。
6
+ keywords:
7
+ - Standalone
8
+ - Bundle
9
+ - CLI
10
+ - Intlayer
11
+ - Editor
12
+ - CMS
13
+ slugs:
14
+ - doc
15
+ - concept
16
+ - cli
17
+ - standalone
18
+ history:
19
+ - version: 8.6.4
20
+ date: 2026-03-31
21
+ changes: "初始化 standalone 命令文档"
22
+ ---
23
+
24
+ # 独立 Bundle (Standalone Bundle)
25
+
26
+ `standalone` 命令允许您创建一个包含 Intlayer 和任何其他指定包的独立 JavaScript bundle。这对于在没有包管理器或构建工具的环境(如简单的 HTML/JS 应用)中使用 Intlayer 特别有用。
27
+
28
+ 该 bundle 使用 [esbuild](https://esbuild.github.io/) 将请求的包及其依赖项合并为一个文件,该文件可以轻松导入到任何 Web 项目中。
29
+
30
+ ## 用法
31
+
32
+ ```bash
33
+ npx intlayer standalone --packages [包名...] [选项]
34
+ ```
35
+
36
+ ## 选项
37
+
38
+ - `-o, --outfile [outfile]` - 可选。输出文件名。默认值:`intlayer-bundle.js`。
39
+ - `--packages [包名...]` - 必选。要包含在 bundle 中的包列表(例如:`intlayer`、`vanilla-intlayer`)。
40
+ - `--version [version]` - 可选。要打包的包版本。如果未指定,默认使用 Intlayer CLI 的版本。
41
+ - `--minify` - 可选。是否压缩输出。默认值:`true`。
42
+ - `--platform [platform]` - 可选。bundle 的目标平台(例如:`browser`、`node`)。默认值:`browser`。
43
+ - `--format [format]` - 可选。bundle 的输出格式(例如:`esm`、`cjs`、`iife`)。默认值:`esm`。
44
+
45
+ ## 通用选项
46
+
47
+ - `--env-file [envFile]` - 环境文件。
48
+ - `-e, --env [env]` - 环境。
49
+ - `--base-dir [baseDir]` - 基础目录。
50
+ - `--no-cache` - 禁用缓存。
51
+ - `--verbose` - 详细输出。
52
+
53
+ ## 示例:
54
+
55
+ ### 为 Vanilla JS 创建 bundle:
56
+
57
+ ```bash
58
+ npx intlayer standalone --packages intlayer vanilla-intlayer --outfile intlayer.js
59
+ ```
60
+
61
+ 这将创建一个包含 `intlayer` 和 `vanilla-intlayer` 包的 `intlayer.js` 文件,经过压缩并采用 ESM 格式,随时可以通过 `<script>` 标签在浏览器中使用。
62
+
63
+ ### 打包特定版本:
64
+
65
+ ```bash
66
+ npx intlayer standalone --packages intlayer --version 8.6.4
67
+ ```
68
+
69
+ ### 以不同格式打包:
70
+
71
+ ```bash
72
+ npx intlayer standalone --packages intlayer --format iife
73
+ ```
74
+
75
+ ## 工作原理:
76
+
77
+ 1. **创建临时环境** - 设置一个临时目录来管理依赖项。
78
+ 2. **安装包** - 使用 `npm` 或 `bun`(如果可用)安装请求的包及其依赖项。
79
+ 3. **生成入口点** - 创建一个临时入口点文件,导出所有请求的包,并在浏览器中运行时将其暴露为全局变量。
80
+ 4. **使用 esbuild 打包** - 使用 esbuild 将所有内容合并为一个文件,并按要求应用压缩和格式化。
81
+ 5. **生成文件** - 将生成的 bundle 写入指定的输出路径。
82
+
83
+ ## 全局变量
84
+
85
+ 当 bundle 在浏览器中加载时,它会将请求的包暴露为 `window` 对象上的全局变量。变量名称源自包名(例如:`intlayer` 变为 `Intlayer`,`vanilla-intlayer` 变为 `VanillaIntlayer`)。
86
+
87
+ ```javascript
88
+ // 从 bundle 访问 Intlayer
89
+ const { getLocaleName } = window.Intlayer;
90
+ const { installIntlayer, useIntlayer } = window.VanillaIntlayer;
91
+ ```
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  createdAt: 2024-08-13
3
- updatedAt: 2026-03-20
3
+ updatedAt: 2026-04-08
4
4
  title: 配置
5
5
  description: 了解如何为您的应用程序配置 Intlayer。了解可用于根据您的需求自定义 Intlayer 的各种设置和选项。
6
6
  keywords:
@@ -14,6 +14,12 @@ slugs:
14
14
  - concept
15
15
  - configuration
16
16
  history:
17
+ - version: 8.7.0
18
+ date: 2026-04-08
19
+ changes: "在构建配置中添加了 `prune` 和 `minify` 选项"
20
+ - version: 8.7.0
21
+ date: 2026-04-03
22
+ changes: "添加了 `currentDomain` 选项"
17
23
  - version: 8.4.0
18
24
  date: 2026-03-20
19
25
  changes: "为 'compiler.output' 和 'dictionary.fill' 添加了按区域设置的路径定义支持"
@@ -237,6 +243,17 @@ const config: IntlayerConfig = {
237
243
  fr: "/[locale]/a-propos",
238
244
  },
239
245
  }),
246
+
247
+ /**
248
+ * 将区域设置映射到域主机名以进行基于域的路由。
249
+ * 这些区域设置的 URL 将是绝对的(例如,https://intlayer.cn/)。
250
+ * 域意味着区域设置,因此不会向路径添加区域设置前缀。
251
+ * 默认值:undefined
252
+ */
253
+ domains: {
254
+ en: "intlayer.org",
255
+ zh: "intlayer.cn",
256
+ },
240
257
  },
241
258
 
242
259
  /**
@@ -388,6 +405,25 @@ const config: IntlayerConfig = {
388
405
  */
389
406
  optimize: true,
390
407
 
408
+ /**
409
+ * 压缩字典以减小包体大小。
410
+ * 默认值:true
411
+ *
412
+ * 注意:
413
+ * - 如果禁用 `optimize`,此选项将被忽略。
414
+ * - 如果 `editor.enabled` 为 true,此选项将被忽略。
415
+ */
416
+ minify: true,
417
+
418
+ /**
419
+ * 清除字典中未使用的键。
420
+ * 默认值:true
421
+ *
422
+ * 注意:
423
+ * - 如果禁用 `optimize`,此选项将被忽略。
424
+ */
425
+ purge: true,
426
+
391
427
  /**
392
428
  * 生成的字典文件的输出格式。
393
429
  * 默认值:['cjs', 'esm']
@@ -600,12 +636,13 @@ export default config;
600
636
 
601
637
  控制路由行为的设置,包括 URL 结构、区域设置存储和中间件管理。
602
638
 
603
- | 字段 | 说明 | 类型 | 默认值 | 示例 | 备注 |
604
- | ---------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
605
- | `mode` | 区域设置管理的 URL 路由模式。 | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'` | `'prefix-no-default'` | `'prefix-no-default'`: `/dashboard` (en) 或 `/fr/dashboard` (fr)。 `'prefix-all'`: `/en/dashboard` 。 `'no-prefix'`: 区域设置以其他方式管理。 `'search-params'`: `/dashboard?locale=fr` | 不影响 cookie 管理或本地存储。 |
606
- | `storage` | 客户端区域设置存储的配置。 | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]` | 参阅下方的存储参数表。 |
607
- | `basePath` | 应用程序 URL 的基础路径。 | `string` | `''` | `'/my-app'` | 如果您的应用程序位于 `https://example.com/my-app`,则 basePath 为 `'/my-app'`,指向 URL 为 `https://example.com/my-app/en` 。 |
608
- | `rewrite` | 自定义 URL 重写规则,用于覆盖特定路径的默认路由模式。支持动态参数 `[param]`。 | `Record<string, StrictModeLocaleMap<string>>` | `undefined` | 见下方示例 | • 重写规则优先级高于 `mode`。<br/>• 与 Next.js 和 Vite 配合。 <br/>• `getLocalizedUrl()` 自动应用适当的规则。<br/>• 见 [自定义 URL 重写](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md)。 |
639
+ | 字段 | 说明 | 类型 | 默认值 | 示例 | 备注 |
640
+ | ---------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
641
+ | `mode` | 区域设置管理的 URL 路由模式。 | `'prefix-no-default'` &#124; <br/> `'prefix-all'` &#124; <br/> `'no-prefix'` &#124; <br/> `'search-params'` | `'prefix-no-default'` | `'prefix-no-default'`: `/dashboard` (en) 或 `/fr/dashboard` (fr)。 `'prefix-all'`: `/en/dashboard` 。 `'no-prefix'`: 区域设置以其他方式管理。 `'search-params'`: `/dashboard?locale=fr` | 不影响 cookie 管理或本地存储。 |
642
+ | `storage` | 客户端区域设置存储的配置。 | `false` &#124; <br/> `'cookie'` &#124; <br/> `'localStorage'` &#124; <br/> `'sessionStorage'` &#124; <br/> `'header'` &#124; <br/> `CookiesAttributes` &#124; <br/> `StorageAttributes` &#124; <br/> `Array` | `['cookie', 'header']` | `'localStorage'` <br/> `[{ type: 'cookie', name: 'custom-locale', secure: true }]` | 参阅下方的存储参数表。 |
643
+ | `basePath` | 应用程序 URL 的基础路径。 | `string` | `''` | `'/my-app'` | 如果您的应用程序位于 `https://example.com/my-app`,则 basePath 为 `'/my-app'`,指向 URL 为 `https://example.com/my-app/en` 。 |
644
+ | `rewrite` | 自定义 URL 重写规则,用于覆盖特定路径的默认路由模式。支持动态参数 `[param]`。 | `Record<string, StrictModeLocaleMap<string>>` | `undefined` | 见下方示例 | • 重写规则优先级高于 `mode`。<br/>• 与 Next.js 和 Vite 配合。 <br/>• `getLocalizedUrl()` 自动应用适当的规则。<br/>• 见 [自定义 URL 重写](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/custom_url_rewrites.md)。 |
645
+ | `domains` | 将区域设置映射到域主机名以进行基于域的路由。设置后,区域设置的 URL 将使用该域作为基础(绝对 URL),并且不会向路径添加区域设置前缀。 | `Partial<Record<Locale, string>>` | `undefined` | `{ zh: 'intlayer.zh', fr: 'intlayer.org' }` | • 如果主机名中未包含,默认协议为 `https://`。<br/>• 域本身标识区域设置,因此不会添加 `/zh/` 前缀。<br/>• `getLocalizedUrl('/', 'zh')` 返回 `https://intlayer.zh/`。 |
609
646
 
610
647
  **`rewrite` 示例**:
611
648
 
@@ -909,6 +946,8 @@ Intlayer 支持多个 AI 提供商,以提供最大的灵活性。当前支持
909
946
  | ----------------- | ---------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
910
947
  | `mode` | 控制构建模式。 | `'auto'` &#124; <br/> `'manual'` | `'auto'` | `'manual'` | • `'auto'`: 构建在应用程序构建期间自动启动。<br/>• `'manual'`: 仅通过显式构建命令触发。<br/>• 可用于防止字典构建(例如避免在 Node.js 环境中运行)。 |
911
948
  | `optimize` | 控制是否应执行构建优化。 | `boolean` | `undefined` | `process.env.NODE_ENV === 'production'` | • 如果未定义,则在框架构建 (Vite/Next.js) 期间启动优化。<br/>• `true` 在开发模式下也会强制执行优化。<br/>• `false` 将其禁用。<br/>• 如果启用,则会替换字典调用以优化分块。<br/>• 需要 `@intlayer/babel` 和 `@intlayer/swc` 插件。 |
949
+ | `minify` | 压缩字典以减小包体大小。 | `boolean` | `false` | | • 指定是否应最小化包内容。<br/>• 默认值:生产环境中为 `true`。<br/>• 如果禁用了 `optimize`,该选项将被忽略。<br/>• 如果 `editor.enabled` 为 true,该选项将被忽略。 |
950
+ | `purge` | 清除字典中未使用的键。 | `boolean` | `false` | | • 指定是否应清理包内容。<br/>• 默认值:生产环境中为 `true`。<br/>• 如果禁用了 `optimize`,该选项将被忽略。 |
912
951
  | `checkTypes` | 指示构建是否应检查 TypeScript 类型并记录错误。 | `boolean` | `false` | | 可能会减慢构建过程。 |
913
952
  | `outputFormat` | 控制字典的输出格式。 | `('esm' &#124; 'cjs')[]` | `['esm', 'cjs']` | `['cjs']` | |
914
953
  | `traversePattern` | 优化期间指定要扫描的文件的模式。 | `string[]` | `['**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,svte}', '!**/node_modules/**', '!**/dist/**', '!**/.intlayer/**', '!**/*.config.*', '!**/*.test.*', '!**/*.spec.*', '!**/*.stories.*']` | `['src/**/*.{ts,tsx}', '../ui-library/**/*.{ts,tsx}', '!**/node_modules/**']` | • 通过将优化限制在相关文件来提高构建性能。<br/>• 如果 `optimize` 关闭则忽略。<br/>• 使用 glob 模式。 |