@intlayer/docs 7.5.0-canary.0 → 7.5.0-canary.1

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 (62) hide show
  1. package/dist/cjs/generated/docs.entry.cjs +19 -0
  2. package/dist/cjs/generated/docs.entry.cjs.map +1 -1
  3. package/dist/esm/generated/docs.entry.mjs +19 -0
  4. package/dist/esm/generated/docs.entry.mjs.map +1 -1
  5. package/dist/types/generated/docs.entry.d.ts +1 -0
  6. package/dist/types/generated/docs.entry.d.ts.map +1 -1
  7. package/docs/ar/cli/index.md +5 -0
  8. package/docs/ar/cli/login.md +157 -0
  9. package/docs/ar/configuration.md +12 -0
  10. package/docs/de/cli/index.md +5 -0
  11. package/docs/de/cli/login.md +160 -0
  12. package/docs/de/configuration.md +12 -0
  13. package/docs/en/cli/index.md +5 -0
  14. package/docs/en/cli/login.md +157 -0
  15. package/docs/en/configuration.md +13 -0
  16. package/docs/en/index.md +1 -0
  17. package/docs/en/intlayer_with_tanstack.md +7 -6
  18. package/docs/en-GB/cli/index.md +5 -0
  19. package/docs/en-GB/cli/login.md +181 -0
  20. package/docs/en-GB/configuration.md +12 -0
  21. package/docs/es/cli/index.md +5 -0
  22. package/docs/es/cli/login.md +182 -0
  23. package/docs/es/configuration.md +12 -0
  24. package/docs/fr/cli/index.md +5 -0
  25. package/docs/fr/cli/login.md +185 -0
  26. package/docs/fr/configuration.md +12 -0
  27. package/docs/hi/cli/index.md +5 -0
  28. package/docs/hi/cli/login.md +181 -0
  29. package/docs/hi/configuration.md +12 -0
  30. package/docs/id/cli/index.md +5 -0
  31. package/docs/id/cli/login.md +157 -0
  32. package/docs/id/configuration.md +12 -0
  33. package/docs/it/cli/index.md +5 -0
  34. package/docs/it/cli/login.md +157 -0
  35. package/docs/it/configuration.md +12 -0
  36. package/docs/ja/cli/index.md +5 -0
  37. package/docs/ja/cli/login.md +159 -0
  38. package/docs/ja/configuration.md +12 -0
  39. package/docs/ko/cli/index.md +5 -0
  40. package/docs/ko/cli/login.md +188 -0
  41. package/docs/ko/configuration.md +12 -0
  42. package/docs/pl/cli/index.md +5 -0
  43. package/docs/pl/cli/login.md +187 -0
  44. package/docs/pl/configuration.md +12 -0
  45. package/docs/pt/cli/index.md +5 -0
  46. package/docs/pt/cli/login.md +186 -0
  47. package/docs/pt/configuration.md +12 -0
  48. package/docs/pt/intlayer_with_react_router_v7_fs_routes.md +570 -0
  49. package/docs/ru/cli/index.md +5 -0
  50. package/docs/ru/cli/login.md +181 -0
  51. package/docs/ru/configuration.md +12 -0
  52. package/docs/tr/cli/index.md +5 -0
  53. package/docs/tr/cli/login.md +171 -0
  54. package/docs/tr/configuration.md +12 -0
  55. package/docs/vi/cli/index.md +5 -0
  56. package/docs/vi/cli/login.md +186 -0
  57. package/docs/vi/configuration.md +12 -0
  58. package/docs/zh/cli/index.md +5 -0
  59. package/docs/zh/cli/login.md +182 -0
  60. package/docs/zh/configuration.md +12 -0
  61. package/package.json +9 -9
  62. package/src/generated/docs.entry.ts +19 -0
@@ -0,0 +1,181 @@
1
+ ---
2
+ createdAt: 2025-12-16
3
+ updatedAt: 2025-12-16
4
+ title: CLI - Вход
5
+ description: Узнайте, как использовать команду login в Intlayer CLI для аутентификации в Intlayer CMS и получения учетных данных доступа.
6
+ keywords:
7
+ - CLI
8
+ - Login
9
+ - Authentication
10
+ - CMS
11
+ - Intlayer
12
+ - Credentials
13
+ slugs:
14
+ - doc
15
+ - concept
16
+ - cli
17
+ - login
18
+ ---
19
+
20
+ # Команда входа Intlayer CLI
21
+
22
+ ---
23
+
24
+ ## Описание
25
+
26
+ Команда `login` Intlayer CLI позволяет аутентифицироваться в Intlayer CMS. Эта команда автоматически открывает ваш браузер по умолчанию, чтобы завершить процесс аутентификации и получить необходимые учетные данные (Client ID и Client Secret) для использования сервисов Intlayer.
27
+
28
+ ## Использование
29
+
30
+ ```bash
31
+ npx intlayer login [options]
32
+ ```
33
+
34
+ или
35
+
36
+ ```bash
37
+ intlayer login [options]
38
+ ```
39
+
40
+ ## Параметры
41
+
42
+ ### `--cms-url <url>`
43
+
44
+ Укажите URL Intlayer CMS, к которой нужно подключиться для аутентификации.
45
+
46
+ - **Тип**: `string`
47
+ - **По умолчанию**: Значение, настроенное в `intlayer.config.*` или `https://intlayer.org`
48
+ - **Пример**:
49
+
50
+ ```bash
51
+ npx intlayer login --cms-url https://intlayer.org
52
+ ```
53
+
54
+ ### Параметры конфигурации
55
+
56
+ Вы также можете использовать общие параметры конфигурации:
57
+
58
+ - `--env-file <path>`: Путь к файлу окружения
59
+ - `-e, --env <env>`: Среда выполнения
60
+ - `--base-dir <dir>`: Базовый каталог проекта
61
+ - `--verbose`: Включить подробный вывод (по умолчанию: true)
62
+ - `--prefix <prefix>`: Префикс для логов
63
+
64
+ ## Как это работает
65
+
66
+ 1. **Запуск локального сервера**: команда запускает локальный HTTP-сервер на случайном порту, чтобы получить учетные данные от CMS
67
+
68
+ Укажите URL Intlayer CMS, к которой нужно подключиться для аутентификации.
69
+
70
+ - **Тип**: `string`
71
+ - **По умолчанию**: Значение, настроенное в `intlayer.config.*` или `https://intlayer.org`
72
+ - **Пример**:
73
+
74
+ ```bash
75
+ npx intlayer login --cms-url https://intlayer.org
76
+ ```
77
+
78
+ ### Параметры конфигурации
79
+
80
+ Вы также можете использовать общие параметры конфигурации:
81
+
82
+ - `--env-file <path>`: Путь к файлу окружения
83
+ - `-e, --env <env>`: Среда выполнения
84
+ - `--base-dir <dir>`: Базовая директория проекта
85
+ - `--verbose`: Включить подробный вывод (по умолчанию: true)
86
+ - `--prefix <prefix>`: Префикс для логов
87
+
88
+ ## Как это работает
89
+
90
+ 1. **Запуск локального сервера**: команда запускает локальный HTTP-сервер на случайном порту для получения учетных данных от CMS
91
+ 2. **Открытие браузера**: команда автоматически открывает ваш браузер по умолчанию на URL входа в CMS
92
+ 3. **Аутентификация**: завершите аутентификацию в браузере, используя вашу учетную запись Intlayer
93
+ 4. **Получение учетных данных**: локальный сервер получает Client ID и Client Secret от CMS
94
+ 5. **Инструкции**: команда отображает инструкции по настройке учетных данных в вашем проекте
95
+
96
+ ## Вывод
97
+
98
+ После успешного входа команда выведет:
99
+
100
+ 1. **Полученные учетные данные** (Client ID и Client Secret)
101
+ 2. **Инструкции для файла `.env`**:
102
+
103
+ ```bash
104
+ INTLAYER_CLIENT_ID=your_client_id
105
+ INTLAYER_CLIENT_SECRET=your_client_secret
106
+ ```
107
+
108
+ 3. **Инструкции для конфигурационного файла Intlayer**:
109
+
110
+ ```typescript
111
+ {
112
+ editor: {
113
+ cmsURL: 'https://intlayer.org',
114
+ clientId: process.env.INTLAYER_CLIENT_ID,
115
+ clientSecret: process.env.INTLAYER_CLIENT_SECRET,
116
+ },
117
+ }
118
+ ```
119
+
120
+ ## Ручная настройка
121
+
122
+ Если браузер не откроется автоматически, вы можете вручную перейти по URL, отображаемому в терминале.
123
+
124
+ ## Примеры
125
+
126
+ ### Вход с указанием пользовательского URL CMS
127
+
128
+ ```bash
129
+ npx intlayer login --cms-url https://custom-cms.example.com
130
+ ```
131
+
132
+ ### Вход с указанием файла окружения
133
+
134
+ ```bash
135
+ npx intlayer login --env-file .env.production
136
+ ```
137
+
138
+ ### Вход в verbose-режиме
139
+
140
+ ```bash
141
+ npx intlayer login --verbose
142
+ ```
143
+
144
+ ## Устранение неполадок
145
+
146
+ ### Браузер не открылся
147
+
148
+ Если браузер не откроется автоматически, скопируйте URL, показанный в терминале, и откройте его вручную в браузере.
149
+
150
+ ### Проблемы с подключением
151
+
152
+ Если возникают проблемы с подключением, проверьте:
153
+
154
+ 1. Что URL CMS указан корректно
155
+ 2. Что ваше интернет-соединение работает корректно
156
+ 3. Что брандмауэры не блокируют соединение
157
+
158
+ ### Учетные данные не получены
159
+
160
+ Если учетные данные не получены:
161
+
162
+ 1. Убедитесь, что вы завершили процесс аутентификации в браузере
163
+ 2. Проверьте, что локальный порт не заблокирован
164
+ 3. Повторите команду
165
+
166
+ ## Следующие шаги
167
+
168
+ После завершения входа:
169
+
170
+ 1. Добавьте учетные данные в файл `.env`
171
+ 2. Настройте файл `intlayer.config.*`, указав учетные данные
172
+ 3. Используйте команды CLI для управления словарями:
173
+ - [`npx intlayer push`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/push.md) - Отправить словари в CMS
174
+ - [`npx intlayer pull`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/pull.md) - Получить словари из CMS
175
+ - [`npx intlayer fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/fill.md) - Заполнить отсутствующие переводы
176
+
177
+ ## См. также
178
+
179
+ - [Документация CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/cli/index.md)
180
+ - [Конфигурация Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/configuration.md)
181
+ - [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ru/intlayer_CMS.md)
@@ -14,6 +14,9 @@ slugs:
14
14
  - concept
15
15
  - configuration
16
16
  history:
17
+ - version: 7.5.0
18
+ date: 2025-12-17
19
+ changes: Добавлена опция `buildMode`
17
20
  - version: 6.0.0
18
21
  date: 2025-09-16
19
22
  changes: Добавлен режим импорта `live`
@@ -524,6 +527,15 @@ Intlayer поддерживает несколько провайдеров ИИ
524
527
 
525
528
  #### Свойства
526
529
 
530
+ - **mode**:
531
+ - _Тип_: `'auto' | 'manual'`
532
+ - _По умолчанию_: `'auto'`
533
+ - _Описание_: Управляет режимом сборки.
534
+ - _Пример_: `'manual'`
535
+ - _Примечание_: Если 'auto', сборка будет автоматически включена при сборке приложения.
536
+ - _Примечание_: Если 'manual', сборка будет установлена только при выполнении команды сборки.
537
+ - _Примечание_: Может использоваться для отключения сборки словарей, например, когда следует избегать выполнения в среде Node.js.
538
+
527
539
  - **optimize**:
528
540
  - _Тип_: `boolean`
529
541
  - _По умолчанию_: `process.env.NODE_ENV === 'production'`
@@ -103,6 +103,10 @@ Mevcut yerellerin veya diğer parametrelerin nasıl yapılandırılacağını g
103
103
 
104
104
  ## Intlayer komutlarını çalıştırma
105
105
 
106
+ ### Kimlik Doğrulama
107
+
108
+ - **[Giriş Yap](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/login.md)** - Intlayer CMS ile kimlik doğrulama yapın ve erişim kimlik bilgilerini alın
109
+
106
110
  ### Temel Komutlar
107
111
 
108
112
  - **[Sözlükleri Derle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/build.md)** - İçerik beyan dosyalarından sözlüklerinizi derleyin
@@ -144,6 +148,7 @@ Mevcut yerellerin veya diğer parametrelerin nasıl yapılandırılacağını g
144
148
 
145
149
  ```json fileName="package.json"
146
150
  "scripts": {
151
+ "intlayer:login": "npx intlayer login",
147
152
  "intlayer:build": "npx intlayer build",
148
153
  "intlayer:watch": "npx intlayer build --watch",
149
154
  "intlayer:push": "npx intlayer push",
@@ -0,0 +1,171 @@
1
+ ---
2
+ createdAt: 2025-12-16
3
+ updatedAt: 2025-12-16
4
+ title: CLI - Giriş
5
+ description: Intlayer CLI'nin login komutunu kullanarak Intlayer CMS ile nasıl kimlik doğrulaması yapacağınızı ve erişim kimlik bilgileri elde edeceğinizi öğrenin.
6
+ keywords:
7
+ - CLI
8
+ - Login
9
+ - Authentication
10
+ - CMS
11
+ - Intlayer
12
+ - Credentials
13
+ slugs:
14
+ - doc
15
+ - concept
16
+ - cli
17
+ - login
18
+ ---
19
+
20
+ # Intlayer CLI Login Komutu
21
+
22
+ ---
23
+
24
+ ## Açıklama
25
+
26
+ Intlayer CLI'nin `login` komutu, Intlayer CMS ile kimlik doğrulaması yapmanıza olanak tanır. Bu komut, kimlik doğrulama işlemini tamamlamak ve Intlayer hizmetlerini kullanmak için gerekli kimlik bilgilerini (Client ID ve Client Secret) almak üzere varsayılan tarayıcınızı otomatik olarak açar.
27
+
28
+ ## Kullanım
29
+
30
+ ```bash
31
+ npx intlayer login [options]
32
+ ```
33
+
34
+ veya
35
+
36
+ ```bash
37
+ intlayer login [options]
38
+ ```
39
+
40
+ ## Seçenekler
41
+
42
+ ### `--cms-url <url>`
43
+
44
+ Intlayer CMS ile kimlik doğrulaması için bağlanılacak URL'yi belirtin.
45
+
46
+ - **Type**: `string`
47
+ - **Default**: `intlayer.config.*` içinde yapılandırılmış değer veya `https://intlayer.org`
48
+ - **Example**:
49
+
50
+ ```bash
51
+ npx intlayer login --cms-url https://intlayer.org
52
+ ```
53
+
54
+ ### Yapılandırma Seçenekleri
55
+
56
+ Ayrıca ortak yapılandırma seçeneklerini de kullanabilirsiniz:
57
+
58
+ - `--env-file <path>`: Ortam dosyasının yolu
59
+ - `-e, --env <env>`: Çalışma ortamı
60
+ - `--base-dir <dir>`: Projenin temel dizini
61
+ - `--verbose`: Ayrıntılı çıktıyı etkinleştir (varsayılan: true)
62
+ - `--prefix <prefix>`: Loglar için ön ek
63
+
64
+ ## Nasıl Çalışır
65
+
66
+ 1. **Yerel Sunucu Başlatma**: Komut, CMS'den kimlik bilgilerini almak için rastgele bir portta yerel bir HTTP sunucusu başlatır
67
+ 2. **Tarayıcı Açma**: Komut varsayılan tarayıcınızı CMS giriş URL'siyle otomatik olarak açar
68
+ 3. **Kimlik Doğrulama**: Tarayıcıda Intlayer hesabınızı kullanarak kimlik doğrulamayı tamamlayın
69
+ 4. **Kimlik Bilgilerinin Alınması**: Yerel sunucu, CMS'den Client ID ve Client Secret'i alır
70
+ 5. **Talimatlar**: Komut, projenizde kimlik bilgilerini yapılandırmak için talimatlar gösterir
71
+
72
+ ## Çıktı
73
+
74
+ Başarılı bir girişten sonra, komut şunları gösterecektir:
75
+
76
+ 1. **Alınan kimlik bilgileri** (Client ID ve Client Secret)
77
+ 2. **`.env` dosyası için talimatlar**:
78
+
79
+ ```bash
80
+ INTLAYER_CLIENT_ID=your_client_id
81
+ INTLAYER_CLIENT_SECRET=your_client_secret
82
+ ```
83
+
84
+ 3. **Intlayer yapılandırma dosyası için talimatlar**:
85
+
86
+ ```typescript
87
+ {
88
+ editor: {
89
+ cmsURL: 'https://intlayer.org',
90
+ typescript
91
+ {
92
+ editor: {
93
+ cmsURL: 'https://intlayer.org',
94
+ clientId: process.env.INTLAYER_CLIENT_ID,
95
+ clientSecret: process.env.INTLAYER_CLIENT_SECRET,
96
+ },
97
+ }
98
+ ```
99
+
100
+ ## Manuel Yapılandırma
101
+
102
+ Tarayıcı otomatik olarak açılmıyorsa, terminalde gösterilen URL'yi kopyalayarak tarayıcınızda manuel olarak ziyaret edebilirsiniz.
103
+
104
+ ## Örnekler
105
+
106
+ ### Özel CMS URL'si ile Giriş
107
+
108
+ ```bash
109
+ npx intlayer login --cms-url https://custom-cms.example.com
110
+ ```
111
+
112
+ ### Belirli Bir Ortam Dosyası ile Giriş
113
+
114
+ ```bash
115
+ npx intlayer login --env-file .env.production
116
+ ```
117
+
118
+ ### Ayrıntılı Modda Giriş
119
+
120
+ ```bash
121
+ npx intlayer login --verbose
122
+ ```
123
+
124
+ ## Sorun Giderme
125
+
126
+ ### Tarayıcı Açılmıyor
127
+
128
+ Tarayıcı otomatik olarak açılmıyorsa, terminalde gösterilen URL'yi kopyalayın ve tarayıcınızda manuel olarak açın.
129
+
130
+ ### Bağlantı Sorunları
131
+
132
+ Bağlantı sorunlarıyla karşılaşırsanız, şunları doğrulayın:
133
+
134
+ 1. CMS URL'sinin doğru olduğunu
135
+ 2. İnternet bağlantınızın düzgün çalıştığını
136
+ 3. Bağlantıyı engelleyen bir güvenlik duvarı olmadığını
137
+
138
+ ### Kimlik Bilgileri Alınmadı
139
+
140
+ Kimlik bilgileri alınmadıysa:
141
+
142
+ 1. Tarayıcıda kimlik doğrulama işlemini tamamladığınızdan emin olun
143
+ 2. Yerel portun engellenmediğini doğrulayın
144
+ 3. Komutu tekrar deneyin
145
+ 4. İnternet bağlantınızın düzgün çalıştığından emin olun
146
+ 5. Bağlantıyı engelleyen herhangi bir güvenlik duvarı olmadığından emin olun
147
+
148
+ ### Kimlik Bilgileri Alınmadı
149
+
150
+ Kimlik bilgileri alınmadıysa:
151
+
152
+ 1. Tarayıcıda kimlik doğrulama sürecini tamamladığınızdan emin olun
153
+ 2. Yerel portun engellenmediğini doğrulayın
154
+ 3. Komutu tekrar deneyin
155
+
156
+ ## Sonraki Adımlar
157
+
158
+ Giriş işlemini tamamladıktan sonra:
159
+
160
+ 1. Kimlik bilgilerini `.env` dosyanıza ekleyin
161
+ 2. Kimlik bilgileri ile `intlayer.config.*` dosyanızı yapılandırın
162
+ 3. Sözlüklerinizi yönetmek için CLI komutlarını kullanın:
163
+ - [`npx intlayer push`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/push.md) - Sözlükleri CMS'ye gönderir
164
+ - [`npx intlayer pull`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/pull.md) - CMS'den sözlükleri çeker
165
+ - [`npx intlayer fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/fill.md) - Eksik çevirileri doldur
166
+
167
+ ## Ayrıca Bakınız
168
+
169
+ - [CLI Dokümantasyonu](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/index.md)
170
+ - [Intlayer Yapılandırması](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/configuration.md)
171
+ - [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/intlayer_CMS.md)
@@ -14,6 +14,9 @@ slugs:
14
14
  - concept
15
15
  - configuration
16
16
  history:
17
+ - version: 7.5.0
18
+ date: 2025-12-17
19
+ changes: `buildMode` seçeneği eklendi
17
20
  - version: 6.0.0
18
21
  date: 2025-09-16
19
22
  changes: `live` import modu eklendi
@@ -526,6 +529,15 @@ Derleme seçenekleri `@intlayer/babel` ve `@intlayer/swc` eklentilerine uygulan
526
529
 
527
530
  #### Özellikler
528
531
 
532
+ - **mode**:
533
+ - _Tür_: `'auto' | 'manual'`
534
+ - _Varsayılan_: `'auto'`
535
+ - _Açıklama_: Derleme modunu kontrol eder.
536
+ - _Örnek_: `'manual'`
537
+ - _Not_: 'auto' ise, uygulama derlendiğinde derleme otomatik olarak etkinleştirilir.
538
+ - _Not_: 'manual' ise, derleme yalnızca derleme komutu çalıştırıldığında ayarlanır.
539
+ - _Not_: Sözlük derlemesini devre dışı bırakmak için kullanılabilir, örneğin Node.js ortamında yürütmeden kaçınılması gerektiğinde.
540
+
529
541
  - **optimize**:
530
542
  - _Tür_: `boolean`
531
543
  - _Varsayılan_: `process.env.NODE_ENV === 'production'`
@@ -103,6 +103,10 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình:
103
103
 
104
104
  ## Chạy các lệnh intlayer
105
105
 
106
+ ### Xác thực
107
+
108
+ - **[Đăng nhập](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/login.md)** - Xác thực với Intlayer CMS và lấy thông tin đăng nhập
109
+
106
110
  ### Các Lệnh Cơ Bản
107
111
 
108
112
  - **[Xây dựng Từ điển](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/build.md)** - Xây dựng từ điển của bạn từ các tệp khai báo nội dung
@@ -144,6 +148,7 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình:
144
148
 
145
149
  ```json fileName="package.json"
146
150
  "scripts": {
151
+ "intlayer:login": "npx intlayer login",
147
152
  "intlayer:build": "npx intlayer build",
148
153
  "intlayer:watch": "npx intlayer build --watch",
149
154
  "intlayer:push": "npx intlayer push",
@@ -0,0 +1,186 @@
1
+ ---
2
+ createdAt: 2025-12-16
3
+ updatedAt: 2025-12-16
4
+ title: CLI - Đăng nhập
5
+ description: Tìm hiểu cách sử dụng lệnh login của Intlayer CLI để xác thực với Intlayer CMS và lấy thông tin truy cập.
6
+ keywords:
7
+ - CLI
8
+ - Login
9
+ - Authentication
10
+ - CMS
11
+ - Intlayer
12
+ - Credentials
13
+ slugs:
14
+ - doc
15
+ - concept
16
+ - cli
17
+ - login
18
+ ---
19
+
20
+ # Lệnh Login của Intlayer CLI
21
+
22
+ ---
23
+
24
+ ## Mô tả
25
+
26
+ Lệnh `login` của Intlayer CLI cho phép bạn xác thực với Intlayer CMS. Lệnh này tự động mở trình duyệt mặc định của bạn để hoàn tất quá trình xác thực và nhận các thông tin xác thực cần thiết (Client ID và Client Secret) để sử dụng dịch vụ Intlayer.
27
+
28
+ ## Cách sử dụng
29
+
30
+ ```bash
31
+ npx intlayer login [options]
32
+ ```
33
+
34
+ hoặc
35
+
36
+ ```bash
37
+ intlayer login [options]
38
+ ```
39
+
40
+ ## Tùy chọn
41
+
42
+ ### `--cms-url <url>`
43
+
44
+ Chỉ định URL của Intlayer CMS để kết nối và thực hiện xác thực.
45
+
46
+ - **Loại**: `string`
47
+ - **Mặc định**: Giá trị cấu hình trong `intlayer.config.*` hoặc `https://intlayer.org`
48
+ - **Ví dụ**:
49
+
50
+ ```bash
51
+ npx intlayer login --cms-url https://intlayer.org
52
+ ```
53
+
54
+ ### Tùy chọn cấu hình
55
+
56
+ Bạn cũng có thể sử dụng các tùy chọn cấu hình chung sau:
57
+
58
+ - `--env-file <path>`: Đường dẫn tới file môi trường
59
+ - `-e, --env <env>`: Môi trường thực thi
60
+ - `--base-dir <dir>`: Thư mục gốc của dự án
61
+ - `--verbose`: Bật đầu ra chi tiết (mặc định: true)
62
+ - `--prefix <prefix>`: Tiền tố cho logs
63
+
64
+ ## Cách hoạt động
65
+
66
+ 1. **Khởi động máy chủ cục bộ**: Lệnh khởi động một máy chủ HTTP cục bộ trên một cổng ngẫu nhiên để nhận thông tin xác thực từ CMS
67
+
68
+ Chỉ định URL của Intlayer CMS để kết nối xác thực.
69
+
70
+ - **Loại**: `string`
71
+ - **Mặc định**: Giá trị được cấu hình trong `intlayer.config.*` hoặc `https://intlayer.org`
72
+ - **Ví dụ**:
73
+
74
+ ```bash
75
+ npx intlayer login --cms-url https://intlayer.org
76
+ ```
77
+
78
+ ### Tùy chọn cấu hình
79
+
80
+ Bạn cũng có thể sử dụng các tùy chọn cấu hình chung:
81
+
82
+ - `--env-file <path>`: Đường dẫn tới file môi trường
83
+ - `-e, --env <env>`: Môi trường thực thi
84
+ - `--base-dir <dir>`: Thư mục gốc của dự án
85
+ - `--verbose`: Bật hiển thị chi tiết (mặc định: true)
86
+ - `--prefix <prefix>`: Tiền tố cho các log
87
+
88
+ ## Cách hoạt động
89
+
90
+ 1. **Khởi động máy chủ cục bộ**: Lệnh khởi động một HTTP server cục bộ trên một cổng ngẫu nhiên để nhận thông tin xác thực từ CMS
91
+ 2. **Mở trình duyệt**: Lệnh tự động mở trình duyệt mặc định của bạn tới URL đăng nhập của CMS
92
+ 3. **Xác thực**: Hoàn tất xác thực trong trình duyệt bằng tài khoản Intlayer của bạn
93
+ 4. **Nhận thông tin xác thực**: Máy chủ cục bộ nhận Client ID và Client Secret từ CMS
94
+ 5. **Hướng dẫn**: Lệnh hiển thị hướng dẫn để cấu hình thông tin xác thực trong dự án của bạn
95
+
96
+ ## Đầu ra
97
+
98
+ Sau khi đăng nhập thành công, lệnh sẽ hiển thị:
99
+
100
+ 1. **Thông tin xác thực nhận được** (Client ID và Client Secret)
101
+ 2. **Hướng dẫn cho file `.env`**:
102
+
103
+ ```bash
104
+ INTLAYER_CLIENT_ID=your_client_id
105
+ INTLAYER_CLIENT_SECRET=your_client_secret
106
+ ```
107
+
108
+ 3. **Hướng dẫn cho file cấu hình Intlayer**:
109
+
110
+ ```typescript
111
+ {
112
+ editor: {
113
+ cmsURL: 'https://intlayer.org',
114
+ clientId: process.env.INTLAYER_CLIENT_ID,
115
+ clientSecret: process.env.INTLAYER_CLIENT_SECRET,
116
+ },
117
+ }
118
+ clientId: process.env.INTLAYER_CLIENT_ID,
119
+ clientSecret: process.env.INTLAYER_CLIENT_SECRET,
120
+ },
121
+ }
122
+ ```
123
+
124
+ ## Cấu hình thủ công
125
+
126
+ Nếu trình duyệt không tự mở, bạn có thể truy cập thủ công URL hiển thị trong terminal.
127
+
128
+ ## Ví dụ
129
+
130
+ ### Đăng nhập với URL CMS tùy chỉnh
131
+
132
+ ```bash
133
+ npx intlayer login --cms-url https://custom-cms.example.com
134
+ ```
135
+
136
+ ### Đăng nhập với file môi trường cụ thể
137
+
138
+ ```bash
139
+ npx intlayer login --env-file .env.production
140
+ ```
141
+
142
+ ### Đăng nhập ở chế độ verbose
143
+
144
+ ```bash
145
+ npx intlayer login --verbose
146
+ ```
147
+
148
+ ## Khắc phục sự cố
149
+
150
+ ### Trình duyệt không tự mở
151
+
152
+ Nếu trình duyệt không tự mở, sao chép URL hiển thị trong terminal và mở thủ công trên trình duyệt của bạn.
153
+
154
+ ### Sự cố kết nối
155
+
156
+ Nếu bạn gặp sự cố kết nối, kiểm tra:
157
+
158
+ 1. Đảm bảo URL của CMS là chính xác
159
+ 2. Kết nối Internet của bạn đang hoạt động bình thường
160
+ 3. Không có tường lửa nào chặn kết nối
161
+
162
+ ### Không nhận được thông tin xác thực
163
+
164
+ Nếu không nhận được thông tin xác thực:
165
+
166
+ 1. Đảm bảo bạn đã hoàn tất quy trình xác thực trong trình duyệt
167
+ 2. Xác nhận rằng cổng cục bộ không bị chặn
168
+ 3. Thử chạy lại lệnh
169
+
170
+ ## Các bước tiếp theo
171
+
172
+ Sau khi hoàn tất đăng nhập:
173
+
174
+ 1. Thêm thông tin xác thực vào file `.env` của bạn
175
+ 2. Cấu hình file `intlayer.config.*` của bạn với thông tin xác thực
176
+ 3. Sử dụng các lệnh CLI để quản lý các từ điển của bạn:
177
+ - [`npx intlayer push`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/push.md) - Đẩy từ điển lên CMS
178
+ - [`npx intlayer pull`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/pull.md) - Kéo từ điển từ CMS
179
+
180
+ - [`npx intlayer fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/fill.md) - Điền các bản dịch còn thiếu
181
+
182
+ ## Xem thêm
183
+
184
+ - [Tài liệu CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/index.md)
185
+ - [Cấu hình Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/configuration.md)
186
+ - [CMS của Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/intlayer_CMS.md)
@@ -14,6 +14,9 @@ slugs:
14
14
  - concept
15
15
  - configuration
16
16
  history:
17
+ - version: 7.5.0
18
+ date: 2025-12-17
19
+ changes: Thêm tùy chọn `buildMode`
17
20
  - version: 7.0.0
18
21
  date: 2025-10-25
19
22
  changes: Thêm cấu hình `dictionary`
@@ -666,6 +669,15 @@ Các tùy chọn build áp dụng cho các plugin `@intlayer/babel` và `@intlay
666
669
 
667
670
  #### Thuộc tính
668
671
 
672
+ - **mode**:
673
+ - _Kiểu_: `'auto' | 'manual'`
674
+ - _Mặc định_: `'auto'`
675
+ - _Mô tả_: Điều khiển chế độ build.
676
+ - _Ví dụ_: `'manual'`
677
+ - _Lưu ý_: Nếu 'auto', build sẽ được bật tự động khi ứng dụng được build.
678
+ - _Lưu ý_: Nếu 'manual', build sẽ chỉ được đặt khi lệnh build được thực thi.
679
+ - _Lưu ý_: Có thể được sử dụng để vô hiệu hóa build từ điển, ví dụ khi nên tránh thực thi trong môi trường Node.js.
680
+
669
681
  - **optimize**:
670
682
  - _Kiểu_: `boolean`
671
683
  - _Mặc định_: `process.env.NODE_ENV === 'production'`
@@ -103,6 +103,10 @@ Intlayer 支持多种配置文件格式:
103
103
 
104
104
  ## 运行 intlayer 命令
105
105
 
106
+ ### 身份验证
107
+
108
+ - **[登录](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/login.md)** - 使用 Intlayer CMS 进行身份验证并获取访问凭据
109
+
106
110
  ### 核心命令
107
111
 
108
112
  - **[构建字典](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/cli/build.md)** - 从内容声明文件构建字典
@@ -149,6 +153,7 @@ Intlayer 支持多种配置文件格式:
149
153
 
150
154
  ```json fileName="package.json"
151
155
  "scripts": {
156
+ "intlayer:login": "npx intlayer login",
152
157
  "intlayer:build": "npx intlayer build",
153
158
  "intlayer:watch": "npx intlayer build --watch",
154
159
  "intlayer:push": "npx intlayer push",