@intlayer/docs 7.5.10 → 7.5.11

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 (94) hide show
  1. package/dist/cjs/generated/docs.entry.cjs +38 -0
  2. package/dist/cjs/generated/docs.entry.cjs.map +1 -1
  3. package/dist/esm/generated/docs.entry.mjs +38 -0
  4. package/dist/esm/generated/docs.entry.mjs.map +1 -1
  5. package/dist/types/generated/docs.entry.d.ts +2 -0
  6. package/dist/types/generated/docs.entry.d.ts.map +1 -1
  7. package/docs/ar/cli/ci.md +137 -0
  8. package/docs/ar/cli/index.md +7 -1
  9. package/docs/ar/cli/list.md +39 -2
  10. package/docs/ar/cli/list_projects.md +131 -0
  11. package/docs/ar/intlayer_CMS.md +20 -0
  12. package/docs/de/cli/ci.md +137 -0
  13. package/docs/de/cli/index.md +7 -1
  14. package/docs/de/cli/list.md +39 -2
  15. package/docs/de/cli/list_projects.md +130 -0
  16. package/docs/de/intlayer_CMS.md +20 -0
  17. package/docs/en/cli/ci.md +137 -0
  18. package/docs/en/cli/index.md +14 -1
  19. package/docs/en/cli/list.md +39 -2
  20. package/docs/en/cli/list_projects.md +128 -0
  21. package/docs/en/interest_of_intlayer.md +1 -1
  22. package/docs/en/intlayer_CMS.md +20 -0
  23. package/docs/en-GB/cli/ci.md +137 -0
  24. package/docs/en-GB/cli/index.md +7 -1
  25. package/docs/en-GB/cli/list.md +39 -2
  26. package/docs/en-GB/cli/list_projects.md +130 -0
  27. package/docs/en-GB/intlayer_CMS.md +20 -0
  28. package/docs/es/cli/ci.md +137 -0
  29. package/docs/es/cli/index.md +7 -1
  30. package/docs/es/cli/list.md +39 -2
  31. package/docs/es/cli/list_projects.md +130 -0
  32. package/docs/es/intlayer_CMS.md +20 -0
  33. package/docs/fr/cli/ci.md +137 -0
  34. package/docs/fr/cli/index.md +7 -1
  35. package/docs/fr/cli/list.md +39 -2
  36. package/docs/fr/cli/list_projects.md +131 -0
  37. package/docs/fr/intlayer_CMS.md +20 -0
  38. package/docs/hi/cli/ci.md +137 -0
  39. package/docs/hi/cli/index.md +7 -1
  40. package/docs/hi/cli/list.md +38 -1
  41. package/docs/hi/cli/list_projects.md +130 -0
  42. package/docs/hi/intlayer_CMS.md +20 -0
  43. package/docs/id/cli/ci.md +137 -0
  44. package/docs/id/cli/index.md +7 -1
  45. package/docs/id/cli/list.md +38 -1
  46. package/docs/id/cli/list_projects.md +128 -0
  47. package/docs/id/intlayer_CMS.md +20 -0
  48. package/docs/it/cli/ci.md +137 -0
  49. package/docs/it/cli/index.md +7 -1
  50. package/docs/it/cli/list.md +39 -2
  51. package/docs/it/cli/list_projects.md +130 -0
  52. package/docs/it/intlayer_CMS.md +20 -0
  53. package/docs/ja/cli/ci.md +137 -0
  54. package/docs/ja/cli/index.md +7 -1
  55. package/docs/ja/cli/list.md +38 -1
  56. package/docs/ja/cli/list_projects.md +136 -0
  57. package/docs/ja/intlayer_CMS.md +20 -0
  58. package/docs/ko/cli/ci.md +137 -0
  59. package/docs/ko/cli/index.md +7 -1
  60. package/docs/ko/cli/list.md +38 -1
  61. package/docs/ko/cli/list_projects.md +128 -0
  62. package/docs/ko/intlayer_CMS.md +20 -0
  63. package/docs/pl/cli/ci.md +137 -0
  64. package/docs/pl/cli/index.md +7 -1
  65. package/docs/pl/cli/list.md +39 -2
  66. package/docs/pl/cli/list_projects.md +130 -0
  67. package/docs/pl/intlayer_CMS.md +20 -0
  68. package/docs/pt/cli/ci.md +137 -0
  69. package/docs/pt/cli/index.md +7 -1
  70. package/docs/pt/cli/list.md +39 -2
  71. package/docs/pt/cli/list_projects.md +134 -0
  72. package/docs/pt/intlayer_CMS.md +20 -0
  73. package/docs/ru/cli/ci.md +137 -0
  74. package/docs/ru/cli/index.md +7 -1
  75. package/docs/ru/cli/list.md +39 -2
  76. package/docs/ru/cli/list_projects.md +130 -0
  77. package/docs/ru/intlayer_CMS.md +20 -0
  78. package/docs/tr/cli/ci.md +137 -0
  79. package/docs/tr/cli/index.md +7 -1
  80. package/docs/tr/cli/list.md +39 -2
  81. package/docs/tr/cli/list_projects.md +134 -0
  82. package/docs/tr/intlayer_CMS.md +20 -0
  83. package/docs/vi/cli/ci.md +137 -0
  84. package/docs/vi/cli/index.md +7 -1
  85. package/docs/vi/cli/list.md +38 -1
  86. package/docs/vi/cli/list_projects.md +130 -0
  87. package/docs/vi/intlayer_CMS.md +20 -0
  88. package/docs/zh/cli/ci.md +137 -0
  89. package/docs/zh/cli/index.md +7 -1
  90. package/docs/zh/cli/list.md +38 -1
  91. package/docs/zh/cli/list_projects.md +130 -0
  92. package/docs/zh/intlayer_CMS.md +20 -0
  93. package/package.json +6 -6
  94. package/src/generated/docs.entry.ts +38 -0
@@ -0,0 +1,137 @@
1
+ ---
2
+ createdAt: 2026-01-06
3
+ updatedAt: 2026-01-06
4
+ title: CI Komutu
5
+ description: CI/CD pipeline'ları ve monorepo'larda otomatik olarak enjekte edilen kimlik bilgileriyle Intlayer komutlarını çalıştırmak için Intlayer CI komutunu nasıl kullanacağınızı öğrenin.
6
+ keywords:
7
+ - CI
8
+ - CI/CD
9
+ - Otomasyon
10
+ - Monorepo
11
+ - Kimlik Bilgileri
12
+ - CLI
13
+ - Intlayer
14
+ slugs:
15
+ - doc
16
+ - concept
17
+ - cli
18
+ - ci
19
+ history:
20
+ - version: 7.5.11
21
+ date: 2026-01-06
22
+ changes: CI komutu ekle
23
+ ---
24
+
25
+ # CI Komutu
26
+
27
+ ```bash
28
+ npx intlayer ci <command...>
29
+ ```
30
+
31
+ CI komutu otomasyon ve CI/CD pipeline'ları için tasarlanmıştır. `INTLAYER_PROJECT_CREDENTIALS` ortam değişkeninden kimlik bilgilerini otomatik olarak enjekte eder ve bir monorepo'daki birden fazla projede Intlayer komutlarını çalıştırabilir.
32
+
33
+ ## Nasıl çalışır
34
+
35
+ CI komutu iki modda çalışır:
36
+
37
+ 1. **Tek Proje Modu**: Mevcut çalışma dizini `INTLAYER_PROJECT_CREDENTIALS` içindeki proje yollarından biriyle eşleşiyorsa, komutu yalnızca o belirli proje için çalıştırır.
38
+
39
+ 2. **Yineleme Modu**: Belirli bir proje bağlamı algılanmazsa, yapılandırılmış tüm projeler üzerinde yineler ve her biri için komutu çalıştırır.
40
+
41
+ ## Ortam Değişkeni
42
+
43
+ Komut, `INTLAYER_PROJECT_CREDENTIALS` ortam değişkeninin ayarlanmış olmasını gerektirir. Bu değişken, proje yollarını kimlik bilgilerine eşleyen bir JSON nesnesi içermelidir:
44
+
45
+ ```json
46
+ {
47
+ "packages/app": {
48
+ "clientId": "your-client-id-1",
49
+ "clientSecret": "your-client-secret-1"
50
+ },
51
+ "packages/admin": {
52
+ "clientId": "your-client-id-2",
53
+ "clientSecret": "your-client-secret-2"
54
+ }
55
+ }
56
+ ```
57
+
58
+ ## Paket Yöneticisi Algılama
59
+
60
+ CI komutu, `npm_config_user_agent` ortam değişkenine dayalı olarak hangi paket yöneticisinin kullanıldığını (npm, yarn, pnpm veya bun) otomatik olarak algılar ve Intlayer'ı çalıştırmak için uygun komutu kullanır.
61
+
62
+ ## Argümanlar
63
+
64
+ - **`<command...>`**: Çalıştırılacak Intlayer komutu (örneğin, `fill`, `push`, `build`). Herhangi bir Intlayer komutunu ve argümanlarını iletebilirsiniz.
65
+
66
+ > Örnek: `npx intlayer ci fill --verbose`
67
+ >
68
+ > Örnek: `npx intlayer ci push`
69
+ >
70
+ > Örnek: `npx intlayer ci build`
71
+
72
+ ## Örnekler
73
+
74
+ ### Tek proje modunda komut çalıştırma
75
+
76
+ `INTLAYER_PROJECT_CREDENTIALS` içindeki yollardan biriyle eşleşen bir proje dizinindeyken:
77
+
78
+ ```bash
79
+ cd packages/app
80
+ npx intlayer ci fill
81
+ ```
82
+
83
+ Bu, `packages/app` projesi için kimlik bilgileri otomatik olarak enjekte edilerek `fill` komutunu çalıştıracaktır.
84
+
85
+ ### Tüm projelerde komut çalıştırma
86
+
87
+ Herhangi bir proje yoluyla eşleşmeyen bir dizindeyken, komut yapılandırılmış tüm projeler üzerinde yineleyecektir:
88
+
89
+ ```bash
90
+ cd /path/to/monorepo
91
+ npx intlayer ci push
92
+ ```
93
+
94
+ Bu, `INTLAYER_PROJECT_CREDENTIALS` içinde yapılandırılmış her proje için `push` komutunu çalıştıracaktır.
95
+
96
+ ### Ek bayraklar iletme
97
+
98
+ Temel Intlayer komutuna herhangi bir bayrak iletebilirsiniz:
99
+
100
+ ```bash
101
+ npx intlayer ci fill --verbose --mode complete
102
+ ```
103
+
104
+ ### CI/CD pipeline'larında kullanma
105
+
106
+ CI/CD yapılandırmanızda (örneğin, GitHub Actions, GitLab CI), `INTLAYER_PROJECT_CREDENTIALS`'i bir sır olarak ayarlayın:
107
+
108
+ ```yaml
109
+ # GitHub Actions örneği
110
+ env:
111
+ INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
112
+
113
+ steps:
114
+ - name: Sözlükleri doldur
115
+ run: npx intlayer ci fill
116
+ ```
117
+
118
+ ## Hata İşleme
119
+
120
+ - `INTLAYER_PROJECT_CREDENTIALS` ayarlanmamışsa, komut bir hata ile çıkacaktır.
121
+ - `INTLAYER_PROJECT_CREDENTIALS` geçerli bir JSON değilse, komut bir hata ile çıkacaktır.
122
+ - Bir proje yolu mevcut değilse, bir uyarı ile atlanacaktır.
123
+ - Herhangi bir proje başarısız olursa, komut sıfır olmayan bir durum kodu ile çıkacaktır.
124
+
125
+ ## Kullanım Durumları
126
+
127
+ - **Monorepo otomasyonu**: Bir monorepo'daki birden fazla projede Intlayer komutlarını çalıştırma
128
+ - **CI/CD pipeline'ları**: Sürekli entegrasyon iş akışlarında sözlük yönetimini otomatikleştirme
129
+ - **Toplu işlemler**: Birden fazla Intlayer projesinde aynı işlemi aynı anda gerçekleştirme
130
+ - **Gizli yönetimi**: Ortam değişkenlerini kullanarak birden fazla proje için kimlik bilgilerini güvenli bir şekilde yönetme
131
+
132
+ ## Güvenlik En İyi Uygulamaları
133
+
134
+ - `INTLAYER_PROJECT_CREDENTIALS`'i CI/CD platformunuzda şifrelenmiş sırlar olarak saklayın
135
+ - Kimlik bilgilerini asla sürüm kontrolüne commit etmeyin
136
+ - Farklı dağıtım ortamları için ortama özel kimlik bilgileri kullanın
137
+ - Kimlik bilgilerini düzenli olarak döndürün
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  createdAt: 2024-08-11
3
- updatedAt: 2025-12-30
3
+ updatedAt: 2026-01-06
4
4
  title: CLI
5
5
  description: Çok dilli web sitenizi yönetmek için Intlayer CLI'nın nasıl kullanılacağını keşfedin. Projenizi birkaç dakika içinde kurmak için bu çevrimiçi dokümantördeki adımları izleyin.
6
6
  keywords:
@@ -17,6 +17,9 @@ slugs:
17
17
  - concept
18
18
  - cli
19
19
  history:
20
+ - version: 7.5.11
21
+ date: 2026-01-06
22
+ changes: projects list komutu eklendi
20
23
  - version: 7.5.9
21
24
  date: 2025-12-30
22
25
  changes: init komutu eklendi
@@ -119,6 +122,7 @@ Mevcut yerellerin veya diğer parametrelerin nasıl yapılandırılacağını g
119
122
  - **[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
120
123
  - **[Sözlükleri İzle](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/watch.md)** - Değişiklikleri izleyin ve sözlükleri otomatik olarak derleyin
121
124
  - **[CLI Sürümünü Kontrol Et](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/version.md)** - Yüklü Intlayer CLI sürümünü kontrol edin
125
+ - **[Projeleri Listele](https://github.com/aymericzip/intlayer/blob/main/docs/docs/tr/cli/list_projects.md)** - Bir dizindeki veya git deposundaki tüm Intlayer projelerini listeleyin
122
126
 
123
127
  ### Sözlük Yönetimi
124
128
 
@@ -166,6 +170,7 @@ Mevcut yerellerin veya diğer parametrelerin nasıl yapılandırılacağını g
166
170
  "intlayer:list": "npx intlayer content list",
167
171
  "intlayer:test": "npx intlayer content test",
168
172
  "intlayer:transform": "npx intlayer transform",
173
+ "intlayer:projects": "npx intlayer projects list",
169
174
  "intlayer:doc:translate": "npx intlayer doc translate",
170
175
  "intlayer:doc:review": "npx intlayer doc review"
171
176
  }
@@ -175,3 +180,4 @@ Mevcut yerellerin veya diğer parametrelerin nasıl yapılandırılacağını g
175
180
  >
176
181
  > - `npx intlayer list` yerine `npx intlayer content list`
177
182
  > - `npx intlayer test` yerine `npx intlayer content test`
183
+ > - `npx intlayer projects-list` veya `npx intlayer pl` yerine `npx intlayer projects list`
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  createdAt: 2024-08-11
3
- updatedAt: 2025-11-22
3
+ updatedAt: 2026-01-06
4
4
  title: İçerik Beyan Dosyalarını Listele
5
5
  description: Projenizdeki tüm içerik beyan dosyalarını nasıl listeleyeceğinizi öğrenin.
6
6
  keywords:
@@ -13,6 +13,13 @@ slugs:
13
13
  - concept
14
14
  - cli
15
15
  - list
16
+ history:
17
+ - version: 7.5.12
18
+ date: 2026-01-06
19
+ changes: list komutuna mutlak çıktı seçeneği eklendi
20
+ - version: 7.5.11
21
+ date: 2026-01-06
22
+ changes: list komutuna JSON çıktı seçeneği eklendi
16
23
  ---
17
24
 
18
25
  # İçerik beyan dosyalarını listele
@@ -27,14 +34,36 @@ npx intlayer content list
27
34
 
28
35
  Bu komut, projenizdeki tüm içerik beyan dosyalarını, sözlük anahtarları ve dosya yolları ile birlikte gösterir. Tüm içerik dosyalarınızın genel bir görünümünü elde etmek ve Intlayer tarafından doğru şekilde keşfedildiklerini doğrulamak için faydalıdır.
29
36
 
30
- ## Örnek:
37
+ ## Argümanlar:
38
+
39
+ - **`--json`**: Sonuçları biçimlendirilmiş metin yerine JSON olarak çıktılar. Betik oluşturma ve programatik erişim için yararlıdır.
40
+
41
+ > Örnek: `npx intlayer content list --json`
42
+
43
+ ## Örnekler:
44
+
45
+ ### İçerik beyan dosyalarını listele:
31
46
 
32
47
  ```bash
33
48
  npx intlayer content list
34
49
  ```
35
50
 
51
+ ### JSON olarak çıktı:
52
+
53
+ ```bash
54
+ npx intlayer content list --json
55
+ ```
56
+
57
+ ### Mutlak yollar olarak çıktı:
58
+
59
+ ```bash
60
+ npx intlayer content list --absolute
61
+ ```
62
+
36
63
  ## Örnek çıktı:
37
64
 
65
+ ### Biçimlendirilmiş çıktı:
66
+
38
67
  ```bash
39
68
  npx intlayer content list
40
69
  İçerik beyan dosyaları:
@@ -45,6 +74,14 @@ npx intlayer content list
45
74
  Toplam içerik beyan dosyası: 3
46
75
  ```
47
76
 
77
+ ### JSON çıktı:
78
+
79
+ ```bash
80
+ $ npx intlayer content list --json
81
+
82
+ [{"key":"home-page","path":"src/components/HomePage/homePage.content.ts"},{"key":"server-component","path":"src/components/ServerComponent/serverComponent.content.ts"},{"key":"client-component","path":"src/components/ClientComponent/clientComponent.content.ts"}]
83
+ ```
84
+
48
85
  Bu komut aşağıdakileri çıktı olarak verir:
49
86
 
50
87
  - Anahtarları ve göreli dosya yolları ile birlikte tüm içerik beyan dosyalarının biçimlendirilmiş listesi
@@ -0,0 +1,134 @@
1
+ ---
2
+ createdAt: 2025-12-30
3
+ updatedAt: 2026-01-06
4
+ title: Intlayer Projelerini Listele
5
+ description: Bir dizinde veya git deposunda bulunan tüm Intlayer projelerinin nasıl listeleneceğini öğrenin.
6
+ keywords:
7
+ - Liste
8
+ - Projeler
9
+ - CLI
10
+ - Intlayer
11
+ - Git
12
+ slugs:
13
+ - doc
14
+ - concept
15
+ - cli
16
+ - list-projects
17
+ history:
18
+ - version: 7.5.12
19
+ date: 2026-01-06
20
+ changes: list projects komutuna mutlak çıktı seçeneği ekle
21
+ ---
22
+
23
+ # Intlayer Projelerini Listele
24
+
25
+ ```bash
26
+ npx intlayer projects list
27
+ ```
28
+
29
+ Bu komut, Intlayer yapılandırma dosyalarını içeren dizinleri bularak tüm Intlayer projelerini arar ve listeler. Monorepo, workspace veya git deposundaki tüm Intlayer projelerini keşfetmek için faydalıdır.
30
+
31
+ ## Kısaltmalar:
32
+
33
+ - `npx intlayer projects-list`
34
+ - `npx intlayer pl`
35
+
36
+ ## Argümanlar:
37
+
38
+ - **`--base-dir [path]`**: Aramaya başlanacak temel dizini belirtin. Varsayılan olarak geçerli çalışma dizinidir.
39
+
40
+ > Örnek: `npx intlayer projects list --base-dir /path/to/workspace`
41
+
42
+ > Örnek: `npx intlayer projects list --base-dir /path/to/workspace`
43
+
44
+ - **`--git-root`**: Temel dizin yerine git kök dizininden arama yapar. Bu, monorepo veya git deposundaki tüm Intlayer projelerini bulmak için faydalıdır.
45
+
46
+ > Örnek: `npx intlayer projects list --git-root`
47
+
48
+ - **`--json`**: Sonuçları biçimlendirilmiş metin yerine JSON olarak çıktılar. Betik oluşturma ve programatik erişim için yararlıdır.
49
+
50
+ > Örnek: `npx intlayer projects list --json`
51
+
52
+ - **`--absolute`**: Sonuçları göreli yollar yerine mutlak yollar olarak çıktılar.
53
+
54
+ > Örnek: `npx intlayer projects list --absolute`
55
+
56
+ ## Nasıl çalışır:
57
+
58
+ Komut, belirtilen dizinde (veya `--git-root` kullanıldıysa git kökünde) Intlayer yapılandırma dosyalarını arar. Aşağıdaki yapılandırma dosyası desenlerini kontrol eder:
59
+
60
+ - `intlayer.config.ts`
61
+ - `intlayer.config.js`
62
+ - `intlayer.config.json`
63
+ - `intlayer.config.cjs`
64
+ - `intlayer.config.mjs`
65
+ - `.intlayerrc`
66
+
67
+ Bu dosyalardan birini içeren her dizin bir Intlayer projesi olarak kabul edilir ve çıktıda listelenecektir.
68
+
69
+ ## Örnekler:
70
+
71
+ ### Geçerli dizindeki projeleri listele:
72
+
73
+ ```bash
74
+ npx intlayer projects list
75
+ ```
76
+
77
+ ### Belirli bir dizindeki projeleri listele:
78
+
79
+ ```bash
80
+ npx intlayer projects list --base-dir ./packages
81
+ ```
82
+
83
+ ### Git deposundaki tüm projeleri listele:
84
+
85
+ ```bash
86
+ npx intlayer projects list --git-root
87
+ ```
88
+
89
+ ### Kısayol alias'ı kullanma:
90
+
91
+ ```bash
92
+ npx intlayer pl --git-root
93
+ ```
94
+
95
+ ### JSON olarak çıktı:
96
+
97
+ ```bash
98
+ npx intlayer projects list --json
99
+ ```
100
+
101
+ ## Örnek çıktı:
102
+
103
+ ### Biçimlendirilmiş çıktı:
104
+
105
+ ```bash
106
+ $ npx intlayer projects list --git-root
107
+
108
+ 3 Intlayer projesi bulundu:
109
+
110
+ - /Users/user/workspace/packages/app
111
+ - /Users/user/workspace/packages/admin
112
+ - /Users/user/workspace/packages/shared
113
+ ```
114
+
115
+ ### JSON çıktı:
116
+
117
+ ```bash
118
+ $ npx intlayer projects list --json
119
+
120
+ ["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
121
+ ```
122
+
123
+ ## Kullanım durumları:
124
+
125
+ - **Monorepo yönetimi**: Monorepo yapısındaki tüm Intlayer projelerini keşfetme
126
+ - **Proje keşfi**: Bir workspace içindeki Intlayer etkin projeleri bulma
127
+ - **CI/CD**: Otomatik iş akışlarında Intlayer projelerini doğrulama
128
+ - **Dokümantasyon**: Intlayer kullanan tüm projeleri listeleyen dokümantasyon oluşturma
129
+
130
+ Çıktı, her proje dizinine mutlak yollar sağlar; bu da bu dizinlere gitmeyi veya birden çok Intlayer projesi üzerinde betik tabanlı işlemler yapmayı kolaylaştırır.
131
+
132
+ - **Dokümantasyon**: Intlayer kullanan tüm projelerin listesini içeren dokümantasyon oluşturma
133
+
134
+ Çıktı, her proje dizinine mutlak yollar sağlar; bu da birden fazla Intlayer projesine kolayca erişmeyi veya bu projeler üzerinde betiklerle işlem yapmayı kolaylaştırır.
@@ -71,6 +71,26 @@ Vite + React ile entegrasyon için, [kurulum kılavuzuna](https://github.com/aym
71
71
 
72
72
  ## Konfigürasyon
73
73
 
74
+ Intlayer CMS'ye giriş yapmak için aşağıdaki komutu çalıştırın:
75
+
76
+ ```bash packageManager="npm"
77
+ npx intlayer login
78
+ ```
79
+
80
+ ```bash packageManager="yarn"
81
+ yarn intlayer login
82
+ ```
83
+
84
+ ```bash packageManager="pnpm"
85
+ pnpm intlayer login
86
+ ```
87
+
88
+ ```bash packageManager="bun"
89
+ bunx intlayer login
90
+ ```
91
+
92
+ Bu, kimlik doğrulama işlemini tamamlamak ve Intlayer hizmetlerini kullanmak için gerekli kimlik bilgilerini (Client ID ve Client Secret) almak için varsayılan tarayıcınızı açacaktır.
93
+
74
94
  Intlayer konfigürasyon dosyanızda, CMS ayarlarını özelleştirebilirsiniz:
75
95
 
76
96
  ```typescript fileName="intlayer.config.ts" codeFormat="typescript"
@@ -0,0 +1,137 @@
1
+ ---
2
+ createdAt: 2026-01-06
3
+ updatedAt: 2026-01-06
4
+ title: Lệnh CI
5
+ description: Tìm hiểu cách sử dụng lệnh Intlayer CI để chạy các lệnh Intlayer với thông tin xác thực được tự động chèn vào trong các pipeline CI/CD và monorepo.
6
+ keywords:
7
+ - CI
8
+ - CI/CD
9
+ - Tự động hóa
10
+ - Monorepo
11
+ - Thông tin xác thực
12
+ - CLI
13
+ - Intlayer
14
+ slugs:
15
+ - doc
16
+ - concept
17
+ - cli
18
+ - ci
19
+ history:
20
+ - version: 7.5.11
21
+ date: 2026-01-06
22
+ changes: Thêm lệnh CI
23
+ ---
24
+
25
+ # Lệnh CI
26
+
27
+ ```bash
28
+ npx intlayer ci <command...>
29
+ ```
30
+
31
+ Lệnh CI được thiết kế cho tự động hóa và các pipeline CI/CD. Nó tự động chèn thông tin xác thực từ biến môi trường `INTLAYER_PROJECT_CREDENTIALS` và có thể chạy các lệnh Intlayer trên nhiều dự án trong một monorepo.
32
+
33
+ ## Cách hoạt động
34
+
35
+ Lệnh CI hoạt động ở hai chế độ:
36
+
37
+ 1. **Chế độ dự án đơn**: Nếu thư mục làm việc hiện tại khớp với một trong các đường dẫn dự án trong `INTLAYER_PROJECT_CREDENTIALS`, nó sẽ chạy lệnh chỉ cho dự án cụ thể đó.
38
+
39
+ 2. **Chế độ lặp lại**: Nếu không phát hiện ngữ cảnh dự án cụ thể, nó sẽ lặp lại tất cả các dự án đã cấu hình và chạy lệnh cho từng dự án.
40
+
41
+ ## Biến môi trường
42
+
43
+ Lệnh yêu cầu biến môi trường `INTLAYER_PROJECT_CREDENTIALS` được đặt. Biến này phải chứa một đối tượng JSON ánh xạ các đường dẫn dự án đến thông tin xác thực của chúng:
44
+
45
+ ```json
46
+ {
47
+ "packages/app": {
48
+ "clientId": "your-client-id-1",
49
+ "clientSecret": "your-client-secret-1"
50
+ },
51
+ "packages/admin": {
52
+ "clientId": "your-client-id-2",
53
+ "clientSecret": "your-client-secret-2"
54
+ }
55
+ }
56
+ ```
57
+
58
+ ## Phát hiện trình quản lý gói
59
+
60
+ Lệnh CI tự động phát hiện trình quản lý gói đang được sử dụng (npm, yarn, pnpm hoặc bun) dựa trên biến môi trường `npm_config_user_agent` và sử dụng lệnh phù hợp để thực thi Intlayer.
61
+
62
+ ## Đối số
63
+
64
+ - **`<command...>`**: Lệnh Intlayer để thực thi (ví dụ: `fill`, `push`, `build`). Bạn có thể truyền bất kỳ lệnh Intlayer nào và các đối số của nó.
65
+
66
+ > Ví dụ: `npx intlayer ci fill --verbose`
67
+ >
68
+ > Ví dụ: `npx intlayer ci push`
69
+ >
70
+ > Ví dụ: `npx intlayer ci build --watch`
71
+
72
+ ## Ví dụ
73
+
74
+ ### Chạy lệnh ở chế độ dự án đơn
75
+
76
+ Nếu bạn đang ở trong thư mục dự án khớp với một trong các đường dẫn trong `INTLAYER_PROJECT_CREDENTIALS`:
77
+
78
+ ```bash
79
+ cd packages/app
80
+ npx intlayer ci fill
81
+ ```
82
+
83
+ Điều này sẽ chạy lệnh `fill` với thông tin xác thực được tự động chèn cho dự án `packages/app`.
84
+
85
+ ### Chạy lệnh trên tất cả các dự án
86
+
87
+ Nếu bạn đang ở trong thư mục không khớp với bất kỳ đường dẫn dự án nào, lệnh sẽ lặp lại tất cả các dự án đã cấu hình:
88
+
89
+ ```bash
90
+ cd /path/to/monorepo
91
+ npx intlayer ci push
92
+ ```
93
+
94
+ Điều này sẽ chạy lệnh `push` cho mỗi dự án được cấu hình trong `INTLAYER_PROJECT_CREDENTIALS`.
95
+
96
+ ### Truyền cờ bổ sung
97
+
98
+ Bạn có thể truyền bất kỳ cờ nào cho lệnh Intlayer cơ bản:
99
+
100
+ ```bash
101
+ npx intlayer ci fill --verbose --mode complete
102
+ ```
103
+
104
+ ### Sử dụng trong pipeline CI/CD
105
+
106
+ Trong cấu hình CI/CD của bạn (ví dụ: GitHub Actions, GitLab CI), đặt `INTLAYER_PROJECT_CREDENTIALS` làm bí mật:
107
+
108
+ ```yaml
109
+ # Ví dụ GitHub Actions
110
+ env:
111
+ INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
112
+
113
+ steps:
114
+ - name: Điền từ điển
115
+ run: npx intlayer ci fill
116
+ ```
117
+
118
+ ## Xử lý lỗi
119
+
120
+ - Nếu `INTLAYER_PROJECT_CREDENTIALS` không được đặt, lệnh sẽ thoát với lỗi.
121
+ - Nếu `INTLAYER_PROJECT_CREDENTIALS` không phải là JSON hợp lệ, lệnh sẽ thoát với lỗi.
122
+ - Nếu đường dẫn dự án không tồn tại, nó sẽ được bỏ qua với cảnh báo.
123
+ - Nếu bất kỳ dự án nào thất bại, lệnh sẽ thoát với mã trạng thái khác không.
124
+
125
+ ## Trường hợp sử dụng
126
+
127
+ - **Tự động hóa monorepo**: Chạy các lệnh Intlayer trên nhiều dự án trong một monorepo
128
+ - **Pipeline CI/CD**: Tự động hóa quản lý từ điển trong quy trình tích hợp liên tục
129
+ - **Thao tác hàng loạt**: Thực hiện cùng một thao tác trên nhiều dự án Intlayer cùng một lúc
130
+ - **Quản lý bí mật**: Quản lý an toàn thông tin xác thực cho nhiều dự án bằng cách sử dụng biến môi trường
131
+
132
+ ## Thực hành bảo mật tốt nhất
133
+
134
+ - Lưu trữ `INTLAYER_PROJECT_CREDENTIALS` dưới dạng bí mật được mã hóa trong nền tảng CI/CD của bạn
135
+ - Không bao giờ commit thông tin xác thực vào kiểm soát phiên bản
136
+ - Sử dụng thông tin xác thực cụ thể theo môi trường cho các môi trường triển khai khác nhau
137
+ - Xoay thông tin xác thực thường xuyên
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  createdAt: 2024-08-11
3
- updatedAt: 2025-12-30
3
+ updatedAt: 2026-01-06
4
4
  title: CLI
5
5
  description: Khám phá cách sử dụng Intlayer CLI để quản lý trang web đa ngôn ngữ của bạn. Làm theo các bước trong tài liệu trực tuyến này để thiết lập dự án của bạn trong vài phút.
6
6
  keywords:
@@ -17,6 +17,9 @@ slugs:
17
17
  - concept
18
18
  - cli
19
19
  history:
20
+ - version: 7.5.11
21
+ date: 2026-01-06
22
+ changes: Thêm lệnh projects list
20
23
  - version: 7.5.9
21
24
  date: 2025-12-30
22
25
  changes: Thêm lệnh init
@@ -120,6 +123,7 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình:
120
123
  - **[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
121
124
  - **[Theo dõi Từ điển](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/watch.md)** - Theo dõi các thay đổi và tự động xây dựng từ điển
122
125
  - **[Kiểm tra Phiên bản CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/version.md)** - Kiểm tra phiên bản Intlayer CLI đã cài đặt
126
+ - **[Liệt kê Dự án](https://github.com/aymericzip/intlayer/blob/main/docs/docs/vi/cli/list_projects.md)** - Liệt kê tất cả các dự án Intlayer trong thư mục hoặc kho lưu trữ git
123
127
 
124
128
  ### Quản lý Từ điển
125
129
 
@@ -167,6 +171,7 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình:
167
171
  "intlayer:list": "npx intlayer content list",
168
172
  "intlayer:test": "npx intlayer content test",
169
173
  "intlayer:transform": "npx intlayer transform",
174
+ "intlayer:projects": "npx intlayer projects list",
170
175
  "intlayer:doc:translate": "npx intlayer doc translate",
171
176
  "intlayer:doc:review": "npx intlayer doc review"
172
177
  }
@@ -176,3 +181,4 @@ Intlayer chấp nhận nhiều định dạng tệp cấu hình:
176
181
  >
177
182
  > - `npx intlayer list` thay vì `npx intlayer content list`
178
183
  > - `npx intlayer test` thay vì `npx intlayer content test`
184
+ > - `npx intlayer projects-list` hoặc `npx intlayer pl` thay vì `npx intlayer projects list`
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  createdAt: 2024-08-11
3
- updatedAt: 2025-11-22
3
+ updatedAt: 2026-01-06
4
4
  title: Liệt kê các tệp khai báo nội dung
5
5
  description: Tìm hiểu cách liệt kê tất cả các tệp khai báo nội dung trong dự án của bạn.
6
6
  keywords:
@@ -13,6 +13,13 @@ slugs:
13
13
  - concept
14
14
  - cli
15
15
  - list
16
+ history:
17
+ - version: 7.5.12
18
+ date: 2026-01-06
19
+ changes: Thêm tùy chọn đầu ra tuyệt đối cho lệnh list
20
+ - version: 7.5.11
21
+ date: 2026-01-06
22
+ changes: Thêm tùy chọn đầu ra JSON cho lệnh list
16
23
  ---
17
24
 
18
25
  # Liệt kê các tệp khai báo nội dung
@@ -27,14 +34,36 @@ npx intlayer content list
27
34
 
28
35
  Lệnh này hiển thị tất cả các tệp khai báo nội dung trong dự án của bạn, cho thấy các khóa từ điển và đường dẫn tệp của chúng. Nó hữu ích để có cái nhìn tổng quan về tất cả các tệp nội dung của bạn và xác minh rằng chúng được Intlayer phát hiện đúng cách.
29
36
 
37
+ ## Đối số:
38
+
39
+ - **`--json`**: Xuất kết quả dưới dạng JSON thay vì văn bản được định dạng. Hữu ích cho việc viết script và truy cập lập trình.
40
+
41
+ > Ví dụ: `npx intlayer content list --json`
42
+
30
43
  ## Ví dụ:
31
44
 
45
+ ### Liệt kê các tệp khai báo nội dung:
46
+
32
47
  ```bash
33
48
  npx intlayer content list
34
49
  ```
35
50
 
51
+ ### Đầu ra dưới dạng JSON:
52
+
53
+ ```bash
54
+ npx intlayer content list --json
55
+ ```
56
+
57
+ ### Đầu ra dưới dạng đường dẫn tuyệt đối:
58
+
59
+ ```bash
60
+ npx intlayer content list --absolute
61
+ ```
62
+
36
63
  ## Ví dụ đầu ra:
37
64
 
65
+ ### Đầu ra được định dạng:
66
+
38
67
  ```bash
39
68
  npx intlayer content list
40
69
  Content declaration files:
@@ -45,6 +74,14 @@ Content declaration files:
45
74
  Tổng số tệp khai báo nội dung: 3
46
75
  ```
47
76
 
77
+ ### Đầu ra JSON:
78
+
79
+ ```bash
80
+ $ npx intlayer content list --json
81
+
82
+ [{"key":"home-page","path":"src/components/HomePage/homePage.content.ts"},{"key":"server-component","path":"src/components/ServerComponent/serverComponent.content.ts"},{"key":"client-component","path":"src/components/ClientComponent/clientComponent.content.ts"}]
83
+ ```
84
+
48
85
  Lệnh này sẽ xuất ra:
49
86
 
50
87
  - Một danh sách được định dạng của tất cả các tệp khai báo nội dung với các khóa và đường dẫn tệp tương đối của chúng