@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.
- package/dist/cjs/doc.cjs.map +1 -1
- package/dist/cjs/generated/docs.entry.cjs +60 -0
- package/dist/cjs/generated/docs.entry.cjs.map +1 -1
- package/dist/esm/doc.mjs.map +1 -1
- package/dist/esm/generated/docs.entry.mjs +60 -0
- package/dist/esm/generated/docs.entry.mjs.map +1 -1
- package/dist/types/doc.d.ts.map +1 -1
- package/dist/types/generated/docs.entry.d.ts +3 -0
- package/dist/types/generated/docs.entry.d.ts.map +1 -1
- package/docs/ar/cli/index.md +54 -42
- package/docs/ar/cli/init.md +32 -20
- package/docs/ar/cli/standalone.md +91 -0
- package/docs/ar/configuration.md +39 -7
- package/docs/ar/custom_domains.md +250 -0
- package/docs/ar/intlayer_with_tanstack+solid.md +14 -33
- package/docs/ar/intlayer_with_tanstack.md +25 -16
- package/docs/ar/intlayer_with_vanilla.md +506 -0
- package/docs/bn/cli/index.md +195 -0
- package/docs/bn/cli/init.md +96 -0
- package/docs/bn/cli/standalone.md +91 -0
- package/docs/bn/configuration.md +46 -14
- package/docs/bn/custom_domains.md +250 -0
- package/docs/bn/intlayer_with_vanilla.md +506 -0
- package/docs/cs/cli/index.md +195 -0
- package/docs/cs/cli/init.md +96 -0
- package/docs/cs/cli/standalone.md +91 -0
- package/docs/cs/configuration.md +46 -7
- package/docs/cs/custom_domains.md +250 -0
- package/docs/cs/intlayer_with_vanilla.md +506 -0
- package/docs/de/cli/index.md +53 -41
- package/docs/de/cli/standalone.md +91 -0
- package/docs/de/configuration.md +46 -7
- package/docs/de/custom_domains.md +250 -0
- package/docs/de/intlayer_with_tanstack+solid.md +14 -33
- package/docs/de/intlayer_with_tanstack.md +25 -16
- package/docs/de/intlayer_with_vanilla.md +506 -0
- package/docs/en/bundle_optimization.md +288 -23
- package/docs/en/cli/index.md +6 -1
- package/docs/en/cli/init.md +13 -1
- package/docs/en/cli/standalone.md +91 -0
- package/docs/en/configuration.md +46 -7
- package/docs/en/custom_domains.md +245 -0
- package/docs/en/intlayer_with_tanstack+solid.md +14 -33
- package/docs/en/intlayer_with_tanstack.md +25 -16
- package/docs/en/intlayer_with_vanilla.md +506 -0
- package/docs/en-GB/cli/index.md +56 -44
- package/docs/en-GB/cli/init.md +28 -21
- package/docs/en-GB/cli/standalone.md +91 -0
- package/docs/en-GB/configuration.md +53 -14
- package/docs/en-GB/custom_domains.md +250 -0
- package/docs/en-GB/intlayer_with_tanstack+solid.md +14 -33
- package/docs/en-GB/intlayer_with_tanstack.md +25 -16
- package/docs/en-GB/intlayer_with_vanilla.md +506 -0
- package/docs/es/cli/index.md +65 -53
- package/docs/es/cli/init.md +33 -21
- package/docs/es/cli/standalone.md +91 -0
- package/docs/es/configuration.md +39 -1
- package/docs/es/custom_domains.md +250 -0
- package/docs/es/intlayer_with_tanstack+solid.md +14 -33
- package/docs/es/intlayer_with_tanstack.md +25 -16
- package/docs/es/intlayer_with_vanilla.md +506 -0
- package/docs/fr/cli/index.md +43 -31
- package/docs/fr/cli/init.md +37 -25
- package/docs/fr/cli/standalone.md +91 -0
- package/docs/fr/configuration.md +46 -7
- package/docs/fr/custom_domains.md +250 -0
- package/docs/fr/intlayer_with_tanstack+solid.md +14 -33
- package/docs/fr/intlayer_with_tanstack.md +25 -16
- package/docs/fr/intlayer_with_vanilla.md +506 -0
- package/docs/hi/cli/index.md +71 -59
- package/docs/hi/cli/init.md +37 -33
- package/docs/hi/cli/standalone.md +91 -0
- package/docs/hi/configuration.md +39 -7
- package/docs/hi/custom_domains.md +250 -0
- package/docs/hi/intlayer_with_tanstack+solid.md +14 -33
- package/docs/hi/intlayer_with_tanstack.md +25 -16
- package/docs/hi/intlayer_with_vanilla.md +506 -0
- package/docs/id/cli/index.md +59 -47
- package/docs/id/cli/init.md +32 -25
- package/docs/id/cli/standalone.md +91 -0
- package/docs/id/configuration.md +46 -7
- package/docs/id/custom_domains.md +250 -0
- package/docs/id/intlayer_with_tanstack+solid.md +14 -33
- package/docs/id/intlayer_with_tanstack.md +25 -16
- package/docs/id/intlayer_with_vanilla.md +506 -0
- package/docs/it/cli/index.md +58 -41
- package/docs/it/cli/init.md +37 -38
- package/docs/it/cli/standalone.md +91 -0
- package/docs/it/configuration.md +46 -7
- package/docs/it/custom_domains.md +250 -0
- package/docs/it/intlayer_with_tanstack+solid.md +14 -33
- package/docs/it/intlayer_with_tanstack.md +25 -16
- package/docs/it/intlayer_with_vanilla.md +506 -0
- package/docs/ja/cli/index.md +59 -47
- package/docs/ja/cli/init.md +36 -24
- package/docs/ja/cli/standalone.md +91 -0
- package/docs/ja/configuration.md +46 -7
- package/docs/ja/custom_domains.md +250 -0
- package/docs/ja/intlayer_with_tanstack+solid.md +14 -33
- package/docs/ja/intlayer_with_tanstack.md +25 -16
- package/docs/ja/intlayer_with_vanilla.md +506 -0
- package/docs/ko/cli/index.md +58 -46
- package/docs/ko/cli/init.md +39 -35
- package/docs/ko/cli/standalone.md +91 -0
- package/docs/ko/configuration.md +47 -8
- package/docs/ko/custom_domains.md +250 -0
- package/docs/ko/intlayer_with_tanstack+solid.md +14 -33
- package/docs/ko/intlayer_with_tanstack.md +25 -16
- package/docs/ko/intlayer_with_vanilla.md +506 -0
- package/docs/nl/cli/index.md +195 -0
- package/docs/nl/cli/init.md +96 -0
- package/docs/nl/cli/standalone.md +91 -0
- package/docs/nl/configuration.md +46 -7
- package/docs/nl/custom_domains.md +250 -0
- package/docs/nl/intlayer_with_vanilla.md +506 -0
- package/docs/pl/cli/index.md +56 -44
- package/docs/pl/cli/init.md +36 -32
- package/docs/pl/cli/standalone.md +91 -0
- package/docs/pl/configuration.md +46 -7
- package/docs/pl/custom_domains.md +250 -0
- package/docs/pl/intlayer_with_tanstack+solid.md +14 -33
- package/docs/pl/intlayer_with_tanstack.md +25 -16
- package/docs/pl/intlayer_with_vanilla.md +506 -0
- package/docs/pt/cli/index.md +64 -52
- package/docs/pt/cli/init.md +35 -31
- package/docs/pt/cli/standalone.md +91 -0
- package/docs/pt/configuration.md +46 -7
- package/docs/pt/custom_domains.md +250 -0
- package/docs/pt/intlayer_with_tanstack+solid.md +14 -33
- package/docs/pt/intlayer_with_tanstack.md +25 -16
- package/docs/pt/intlayer_with_vanilla.md +506 -0
- package/docs/ru/cli/index.md +54 -42
- package/docs/ru/cli/init.md +31 -27
- package/docs/ru/cli/standalone.md +91 -0
- package/docs/ru/configuration.md +46 -7
- package/docs/ru/custom_domains.md +250 -0
- package/docs/ru/intlayer_with_tanstack+solid.md +14 -33
- package/docs/ru/intlayer_with_tanstack.md +25 -16
- package/docs/ru/intlayer_with_vanilla.md +506 -0
- package/docs/tr/cli/index.md +64 -52
- package/docs/tr/cli/init.md +37 -30
- package/docs/tr/cli/standalone.md +91 -0
- package/docs/tr/configuration.md +46 -7
- package/docs/tr/custom_domains.md +250 -0
- package/docs/tr/intlayer_with_tanstack+solid.md +14 -33
- package/docs/tr/intlayer_with_tanstack.md +25 -16
- package/docs/tr/intlayer_with_vanilla.md +506 -0
- package/docs/uk/cli/index.md +60 -55
- package/docs/uk/cli/init.md +32 -20
- package/docs/uk/cli/standalone.md +91 -0
- package/docs/uk/configuration.md +46 -7
- package/docs/uk/custom_domains.md +250 -0
- package/docs/uk/intlayer_with_tanstack+solid.md +14 -33
- package/docs/uk/intlayer_with_tanstack.md +25 -16
- package/docs/uk/intlayer_with_vanilla.md +506 -0
- package/docs/ur/cli/index.md +195 -0
- package/docs/ur/cli/init.md +96 -0
- package/docs/ur/cli/standalone.md +91 -0
- package/docs/ur/configuration.md +46 -7
- package/docs/ur/custom_domains.md +250 -0
- package/docs/ur/intlayer_with_vanilla.md +506 -0
- package/docs/vi/cli/index.md +72 -61
- package/docs/vi/cli/init.md +33 -21
- package/docs/vi/cli/standalone.md +91 -0
- package/docs/vi/configuration.md +46 -7
- package/docs/vi/custom_domains.md +250 -0
- package/docs/vi/intlayer_with_tanstack+solid.md +14 -33
- package/docs/vi/intlayer_with_tanstack.md +25 -16
- package/docs/vi/intlayer_with_vanilla.md +506 -0
- package/docs/zh/cli/index.md +56 -49
- package/docs/zh/cli/init.md +30 -18
- package/docs/zh/cli/standalone.md +91 -0
- package/docs/zh/configuration.md +46 -7
- package/docs/zh/custom_domains.md +250 -0
- package/docs/zh/intlayer_with_tanstack+solid.md +14 -33
- package/docs/zh/intlayer_with_tanstack.md +25 -16
- package/docs/zh/intlayer_with_vanilla.md +506 -0
- package/package.json +8 -8
- package/src/doc.ts +4 -1
- package/src/generated/docs.entry.ts +60 -0
- package/docs/ar/bundle_optimization.md +0 -185
- package/docs/de/bundle_optimization.md +0 -195
- package/docs/en-GB/bundle_optimization.md +0 -184
- package/docs/es/bundle_optimization.md +0 -194
- package/docs/fr/bundle_optimization.md +0 -184
- package/docs/hi/bundle_optimization.md +0 -185
- package/docs/id/bundle_optimization.md +0 -185
- package/docs/it/bundle_optimization.md +0 -185
- package/docs/ja/bundle_optimization.md +0 -185
- package/docs/ko/bundle_optimization.md +0 -185
- package/docs/pl/bundle_optimization.md +0 -185
- package/docs/pt/bundle_optimization.md +0 -184
- package/docs/ru/bundle_optimization.md +0 -185
- package/docs/tr/bundle_optimization.md +0 -184
- package/docs/uk/bundle_optimization.md +0 -186
- package/docs/vi/bundle_optimization.md +0 -185
- package/docs/zh/bundle_optimization.md +0 -185
package/docs/zh/cli/index.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
createdAt: 2024-08-11
|
|
3
|
-
updatedAt: 2026-
|
|
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: "添加
|
|
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: "添加
|
|
34
|
+
changes: "添加 extract 命令内容"
|
|
29
35
|
- version: 7.1.0
|
|
30
36
|
date: 2025-11-05
|
|
31
|
-
changes: "
|
|
37
|
+
changes: "为翻译命令添加 skipIfExists 选项"
|
|
32
38
|
- version: 6.1.4
|
|
33
39
|
date: 2025-01-27
|
|
34
|
-
changes: "
|
|
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: "
|
|
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: "
|
|
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`
|
|
101
|
+
`intlayer-cli` 包旨在将您的 [Intlayer 声明](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/content_file.md)转译为字典。
|
|
96
102
|
|
|
97
|
-
|
|
103
|
+
该包会转译所有 Intlayer 文件,例如 `src/**/*.content.{ts|js|mjs|cjs|json}`。[查看如何声明您的 Intlayer 声明文件](https://github.com/aymericzip/intlayer/blob/main/packages/intlayer/README.md)。
|
|
98
104
|
|
|
99
|
-
要解释
|
|
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
|
-
|
|
118
|
+
要了解如何配置可用语言或其他参数,请参阅[此处的配置文档](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/configuration.md)。
|
|
113
119
|
|
|
114
|
-
##
|
|
120
|
+
## 执行 Intlayer 命令
|
|
115
121
|
|
|
116
122
|
### 身份验证
|
|
117
123
|
|
|
118
|
-
- **[
|
|
124
|
+
- **[Login](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/login.md)** - 在 Intlayer CMS 中进行身份验证并获取访问凭据
|
|
119
125
|
|
|
120
126
|
### 核心命令
|
|
121
127
|
|
|
122
|
-
- **[
|
|
123
|
-
- **[
|
|
124
|
-
- **[
|
|
125
|
-
- **[
|
|
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
|
-
- **[
|
|
130
|
-
- **[
|
|
131
|
-
- **[
|
|
132
|
-
- **[
|
|
133
|
-
- **[
|
|
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
|
-
- **[
|
|
144
|
+
- **[Extract Strings](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/extract.md)** - 从组件中提取字符串到组件附近的 .content 文件中
|
|
138
145
|
|
|
139
146
|
### 配置
|
|
140
147
|
|
|
141
|
-
- **[
|
|
142
|
-
- **[
|
|
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
|
-
- **[
|
|
147
|
-
- **[
|
|
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
|
-
- **[
|
|
152
|
-
- **[
|
|
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
|
-
- **[
|
|
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
|
-
|
|
165
|
+
### 开发工具
|
|
160
166
|
|
|
161
|
-
- **[
|
|
162
|
-
- **[
|
|
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
|
-
##
|
|
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
|
-
> -
|
|
187
|
-
> -
|
|
188
|
-
> -
|
|
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`
|
package/docs/zh/cli/init.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
createdAt: 2025-12-30
|
|
3
3
|
updatedAt: 2025-12-30
|
|
4
4
|
title: 初始化 Intlayer
|
|
5
|
-
description:
|
|
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`
|
|
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. **验证项目结构** -
|
|
43
|
-
2. **更新 `.gitignore`** - 将 `.intlayer`
|
|
44
|
-
3. **配置 TypeScript** -
|
|
45
|
-
4. **创建配置文件** -
|
|
46
|
-
5. **更新 Vite 配置** - 如果检测到 Vite
|
|
47
|
-
6. **更新 Next.js 配置** - 如果检测到 Next.js
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
-
|
|
84
|
-
-
|
|
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
|
+
```
|
package/docs/zh/configuration.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
createdAt: 2024-08-13
|
|
3
|
-
updatedAt: 2026-
|
|
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 路由模式。
|
|
606
|
-
| `storage` | 客户端区域设置存储的配置。
|
|
607
|
-
| `basePath` | 应用程序 URL 的基础路径。
|
|
608
|
-
| `rewrite` | 自定义 URL 重写规则,用于覆盖特定路径的默认路由模式。支持动态参数 `[param]`。
|
|
639
|
+
| 字段 | 说明 | 类型 | 默认值 | 示例 | 备注 |
|
|
640
|
+
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
641
|
+
| `mode` | 区域设置管理的 URL 路由模式。 | `'prefix-no-default'` | <br/> `'prefix-all'` | <br/> `'no-prefix'` | <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` | <br/> `'cookie'` | <br/> `'localStorage'` | <br/> `'sessionStorage'` | <br/> `'header'` | <br/> `CookiesAttributes` | <br/> `StorageAttributes` | <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'` | <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' | '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 模式。 |
|