@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,128 @@
1
+ ---
2
+ createdAt: 2025-12-30
3
+ updatedAt: 2026-01-06
4
+ title: Daftar Proyek Intlayer
5
+ description: Pelajari cara mendaftarkan semua proyek Intlayer di sebuah direktori atau repositori git.
6
+ keywords:
7
+ - Daftar
8
+ - Proyek
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: Tambahkan opsi output absolut ke perintah list projects
21
+ ---
22
+
23
+ # Daftar Proyek Intlayer
24
+
25
+ ```bash
26
+ npx intlayer projects list
27
+ ```
28
+
29
+ Perintah ini mencari dan menampilkan semua proyek Intlayer dengan menemukan direktori yang berisi berkas konfigurasi Intlayer. Ini berguna untuk menemukan semua proyek Intlayer dalam monorepo, workspace, atau repositori git.
30
+
31
+ ## Alias:
32
+
33
+ - `npx intlayer projects-list`
34
+ - `npx intlayer pl`
35
+
36
+ ## Argumen:
37
+
38
+ - **`--base-dir [path]`**: Tentukan direktori dasar untuk memulai pencarian. Secara default adalah direktori kerja saat ini.
39
+
40
+ > Contoh: `npx intlayer projects list --base-dir /path/to/workspace`
41
+
42
+ - **`--git-root`**: Cari dari direktori root git alih-alih direktori dasar. Ini berguna untuk menemukan semua proyek Intlayer dalam monorepo atau repositori git.
43
+
44
+ > Contoh: `npx intlayer projects list --git-root`
45
+
46
+ - **`--json`**: Menampilkan hasil sebagai JSON alih-alih teks yang diformat. Berguna untuk scripting dan akses programatik.
47
+
48
+ > Contoh: `npx intlayer projects list --json`
49
+
50
+ - **`--absolute`**: Menampilkan hasil sebagai jalur absolut alih-alih jalur relatif.
51
+
52
+ > Contoh: `npx intlayer projects list --absolute`
53
+
54
+ ## Cara kerjanya:
55
+
56
+ Perintah ini mencari berkas konfigurasi Intlayer di direktori yang ditentukan (atau root git jika `--git-root` digunakan). Ia mencari pola berkas konfigurasi berikut:
57
+
58
+ - `intlayer.config.ts`
59
+ - `intlayer.config.js`
60
+ - `intlayer.config.json`
61
+ - `intlayer.config.cjs`
62
+ - `intlayer.config.mjs`
63
+ - `.intlayerrc`
64
+
65
+ Setiap direktori yang berisi salah satu berkas ini dianggap sebagai proyek Intlayer dan akan ditampilkan dalam output.
66
+
67
+ ## Contoh:
68
+
69
+ ### Daftar proyek di direktori saat ini:
70
+
71
+ ```bash
72
+ npx intlayer projects list
73
+ ```
74
+
75
+ ### Daftar proyek di direktori tertentu:
76
+
77
+ ```bash
78
+ npx intlayer projects list --base-dir ./packages
79
+ ```
80
+
81
+ ### Daftar semua proyek di repositori git:
82
+
83
+ ```bash
84
+ npx intlayer projects list --git-root
85
+ ```
86
+
87
+ ### Menggunakan alias pintas:
88
+
89
+ ```bash
90
+ npx intlayer pl --git-root
91
+ ```
92
+
93
+ ### Output sebagai JSON:
94
+
95
+ ```bash
96
+ npx intlayer projects list --json
97
+ ```
98
+
99
+ ## Contoh output:
100
+
101
+ ### Output yang diformat:
102
+
103
+ ```bash
104
+ $ npx intlayer projects list --git-root
105
+
106
+ Found 3 Intlayer project(s):
107
+
108
+ - /Users/user/workspace/packages/app
109
+ - /Users/user/workspace/packages/admin
110
+ - /Users/user/workspace/packages/shared
111
+ ```
112
+
113
+ ### Output JSON:
114
+
115
+ ```bash
116
+ $ npx intlayer projects list --json
117
+
118
+ ["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
119
+ ```
120
+
121
+ ## Kasus penggunaan:
122
+
123
+ - **Manajemen monorepo**: Temukan semua proyek Intlayer dalam struktur monorepo
124
+ - **Penemuan proyek**: Temukan semua proyek yang mendukung Intlayer di sebuah workspace
125
+ - **CI/CD**: Verifikasi proyek Intlayer dalam alur kerja otomatis
126
+ - **Dokumentasi**: Hasilkan dokumentasi yang mencantumkan semua proyek yang menggunakan Intlayer
127
+
128
+ Keluaran menyediakan jalur absolut ke setiap direktori proyek, sehingga mudah untuk menavigasi atau membuat skrip operasi pada beberapa proyek Intlayer.
@@ -77,6 +77,26 @@ Untuk integrasi dengan Vite + React, lihat [panduan pengaturan](https://github.c
77
77
 
78
78
  ## Konfigurasi
79
79
 
80
+ Jalankan perintah berikut untuk masuk ke Intlayer CMS:
81
+
82
+ ```bash packageManager="npm"
83
+ npx intlayer login
84
+ ```
85
+
86
+ ```bash packageManager="yarn"
87
+ yarn intlayer login
88
+ ```
89
+
90
+ ```bash packageManager="pnpm"
91
+ pnpm intlayer login
92
+ ```
93
+
94
+ ```bash packageManager="bun"
95
+ bunx intlayer login
96
+ ```
97
+
98
+ Ini akan membuka browser default Anda untuk menyelesaikan proses autentikasi dan menerima kredensial yang diperlukan (Client ID dan Client Secret) untuk menggunakan layanan Intlayer.
99
+
80
100
  Dalam file konfigurasi Intlayer Anda, Anda dapat menyesuaikan pengaturan CMS:
81
101
 
82
102
  ```typescript fileName="intlayer.config.ts" codeFormat="typescript"
@@ -0,0 +1,137 @@
1
+ ---
2
+ createdAt: 2026-01-06
3
+ updatedAt: 2026-01-06
4
+ title: Comando CI
5
+ description: Impara come usare il comando Intlayer CI per eseguire comandi Intlayer con credenziali auto-iniettate nelle pipeline CI/CD e nei monorepo.
6
+ keywords:
7
+ - CI
8
+ - CI/CD
9
+ - Automatizzazione
10
+ - Monorepo
11
+ - Credenziali
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: Aggiungere comando CI
23
+ ---
24
+
25
+ # Comando CI
26
+
27
+ ```bash
28
+ npx intlayer ci <command...>
29
+ ```
30
+
31
+ Il comando CI è progettato per l'automazione e le pipeline CI/CD. Inietta automaticamente le credenziali dalla variabile d'ambiente `INTLAYER_PROJECT_CREDENTIALS` e può eseguire comandi Intlayer su più progetti in un monorepo.
32
+
33
+ ## Come funziona
34
+
35
+ Il comando CI opera in due modalità:
36
+
37
+ 1. **Modalità progetto singolo**: Se la directory di lavoro corrente corrisponde a uno dei percorsi del progetto in `INTLAYER_PROJECT_CREDENTIALS`, esegue il comando solo per quel progetto specifico.
38
+
39
+ 2. **Modalità iterazione**: Se non viene rilevato un contesto di progetto specifico, itera su tutti i progetti configurati ed esegue il comando per ciascuno.
40
+
41
+ ## Variabile d'ambiente
42
+
43
+ Il comando richiede che la variabile d'ambiente `INTLAYER_PROJECT_CREDENTIALS` sia impostata. Questa variabile deve contenere un oggetto JSON che mappa i percorsi del progetto alle loro credenziali:
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
+ ## Rilevamento del gestore di pacchetti
59
+
60
+ Il comando CI rileva automaticamente quale gestore di pacchetti viene utilizzato (npm, yarn, pnpm o bun) in base alla variabile d'ambiente `npm_config_user_agent` e utilizza il comando appropriato per eseguire Intlayer.
61
+
62
+ ## Argomenti
63
+
64
+ - **`<command...>`**: Il comando Intlayer da eseguire (ad esempio, `fill`, `push`, `build`). Puoi passare qualsiasi comando Intlayer e i suoi argomenti.
65
+
66
+ > Esempio: `npx intlayer ci fill --verbose`
67
+ >
68
+ > Esempio: `npx intlayer ci push`
69
+ >
70
+ > Esempio: `npx intlayer ci build`
71
+
72
+ ## Esempi
73
+
74
+ ### Eseguire un comando in modalità progetto singolo
75
+
76
+ Se ti trovi in una directory di progetto che corrisponde a uno dei percorsi in `INTLAYER_PROJECT_CREDENTIALS`:
77
+
78
+ ```bash
79
+ cd packages/app
80
+ npx intlayer ci fill
81
+ ```
82
+
83
+ Questo eseguirà il comando `fill` con le credenziali iniettate automaticamente per il progetto `packages/app`.
84
+
85
+ ### Eseguire un comando su tutti i progetti
86
+
87
+ Se ti trovi in una directory che non corrisponde a nessun percorso di progetto, il comando itererà su tutti i progetti configurati:
88
+
89
+ ```bash
90
+ cd /path/to/monorepo
91
+ npx intlayer ci push
92
+ ```
93
+
94
+ Questo eseguirà il comando `push` per ogni progetto configurato in `INTLAYER_PROJECT_CREDENTIALS`.
95
+
96
+ ### Passare flag aggiuntivi
97
+
98
+ Puoi passare qualsiasi flag al comando Intlayer sottostante:
99
+
100
+ ```bash
101
+ npx intlayer ci fill --verbose --mode complete
102
+ ```
103
+
104
+ ### Utilizzare nelle pipeline CI/CD
105
+
106
+ Nella tua configurazione CI/CD (ad esempio, GitHub Actions, GitLab CI), imposta `INTLAYER_PROJECT_CREDENTIALS` come segreto:
107
+
108
+ ```yaml
109
+ # Esempio GitHub Actions
110
+ env:
111
+ INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
112
+
113
+ steps:
114
+ - name: Riempire dizionari
115
+ run: npx intlayer ci fill
116
+ ```
117
+
118
+ ## Gestione degli errori
119
+
120
+ - Se `INTLAYER_PROJECT_CREDENTIALS` non è impostata, il comando terminerà con un errore.
121
+ - Se `INTLAYER_PROJECT_CREDENTIALS` non è un JSON valido, il comando terminerà con un errore.
122
+ - Se un percorso di progetto non esiste, verrà saltato con un avviso.
123
+ - Se un progetto fallisce, il comando terminerà con un codice di stato diverso da zero.
124
+
125
+ ## Casi d'uso
126
+
127
+ - **Automatizzazione monorepo**: Eseguire comandi Intlayer su più progetti in un monorepo
128
+ - **Pipeline CI/CD**: Automatizzare la gestione dei dizionari nei flussi di lavoro di integrazione continua
129
+ - **Operazioni in batch**: Eseguire la stessa operazione su più progetti Intlayer contemporaneamente
130
+ - **Gestione dei segreti**: Gestire in modo sicuro le credenziali per più progetti utilizzando variabili d'ambiente
131
+
132
+ ## Best practice di sicurezza
133
+
134
+ - Archivia `INTLAYER_PROJECT_CREDENTIALS` come segreti crittografati nella tua piattaforma CI/CD
135
+ - Non committare mai le credenziali nel controllo versione
136
+ - Usa credenziali specifiche dell'ambiente per diversi ambienti di distribuzione
137
+ - Ruota le credenziali regolarmente
@@ -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: Scopri come utilizzare la CLI di Intlayer per gestire il tuo sito web multilingue. Segui i passaggi in questa documentazione online per configurare il tuo progetto in pochi minuti.
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: Aggiunto comando projects list
20
23
  - version: 7.5.9
21
24
  date: 2025-12-30
22
25
  changes: Aggiunto comando init
@@ -119,6 +122,7 @@ Per vedere come configurare le localizzazioni disponibili o altri parametri, con
119
122
  - **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/build.md)** - Costruisci i tuoi dizionari dai file di dichiarazione dei contenuti
120
123
  - **[Watch Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/watch.md)** - Monitora le modifiche e costruisci automaticamente i dizionari
121
124
  - **[Check CLI Version](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/version.md)** - Controlla la versione installata della CLI di Intlayer
125
+ - **[Elenca Progetti](https://github.com/aymericzip/intlayer/blob/main/docs/docs/it/cli/list_projects.md)** - Elenca tutti i progetti Intlayer in una directory o repository git
122
126
 
123
127
  ### Gestione dei Dizionari
124
128
 
@@ -161,6 +165,7 @@ Per vedere come configurare le localizzazioni disponibili o altri parametri, con
161
165
  "intlayer:list": "npx intlayer content list",
162
166
  "intlayer:test": "npx intlayer content test",
163
167
  "intlayer:transform": "npx intlayer transform",
168
+ "intlayer:projects": "npx intlayer projects list",
164
169
  "intlayer:doc:translate": "npx intlayer doc translate",
165
170
  "intlayer:doc:review": "npx intlayer doc review"
166
171
  }
@@ -170,3 +175,4 @@ Per vedere come configurare le localizzazioni disponibili o altri parametri, con
170
175
  >
171
176
  > - `npx intlayer list` invece di `npx intlayer content list`
172
177
  > - `npx intlayer test` invece di `npx intlayer content test`
178
+ > - `npx intlayer projects-list` o `npx intlayer pl` invece di `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: Elencare i file di dichiarazione del contenuto
5
5
  description: Scopri come elencare tutti i file di dichiarazione del contenuto nel tuo progetto.
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: Aggiunta opzione di output assoluto al comando list
20
+ - version: 7.5.11
21
+ date: 2026-01-06
22
+ changes: Aggiunta opzione di output JSON al comando list
16
23
  ---
17
24
 
18
25
  # Elencare i file di dichiarazione del contenuto
@@ -27,14 +34,36 @@ npx intlayer content list
27
34
 
28
35
  Questo comando mostra tutti i file di dichiarazione del contenuto nel tuo progetto, visualizzando le loro chiavi nel dizionario e i percorsi dei file. È utile per avere una panoramica di tutti i tuoi file di contenuto e verificare che siano correttamente rilevati da Intlayer.
29
36
 
30
- ## Esempio:
37
+ ## Argomenti:
38
+
39
+ - **`--json`**: Mostra i risultati come JSON invece di testo formattato. Utile per scripting e accesso programmatico.
40
+
41
+ > Esempio: `npx intlayer content list --json`
42
+
43
+ ## Esempi:
44
+
45
+ ### Elencare i file di dichiarazione del contenuto:
31
46
 
32
47
  ```bash
33
48
  npx intlayer content list
34
49
  ```
35
50
 
51
+ ### Output come JSON:
52
+
53
+ ```bash
54
+ npx intlayer content list --json
55
+ ```
56
+
57
+ ### Output come percorsi assoluti:
58
+
59
+ ```bash
60
+ npx intlayer content list --absolute
61
+ ```
62
+
36
63
  ## Output di esempio:
37
64
 
65
+ ### Output formattato:
66
+
38
67
  ```bash
39
68
  npx intlayer content list
40
69
  Content declaration files:
@@ -45,6 +74,14 @@ Content declaration files:
45
74
  Totale file di dichiarazione del contenuto: 3
46
75
  ```
47
76
 
77
+ ### Output 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
  Questo comando mostrerà:
49
86
 
50
87
  - Un elenco formattato di tutti i file di dichiarazione del contenuto con le loro chiavi e i percorsi relativi dei file
@@ -0,0 +1,130 @@
1
+ ---
2
+ createdAt: 2025-12-30
3
+ updatedAt: 2026-01-06
4
+ title: Elencare i progetti Intlayer
5
+ description: Scopri come elencare tutti i progetti Intlayer in una directory o in un repository git.
6
+ keywords:
7
+ - Elenco
8
+ - Progetti
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: Aggiungere opzione di output assoluto al comando list projects
21
+ ---
22
+
23
+ # Elencare i progetti Intlayer
24
+
25
+ ```bash
26
+ npx intlayer projects list
27
+ ```
28
+
29
+ Questo comando cerca ed elenca tutti i progetti Intlayer trovando le directory che contengono file di configurazione di Intlayer. È utile per scoprire tutti i progetti Intlayer in un monorepo, workspace o repository git.
30
+
31
+ ## Alias:
32
+
33
+ - `npx intlayer projects-list`
34
+ - `npx intlayer pl`
35
+
36
+ ## Argomenti:
37
+
38
+ - **`--base-dir [path]`**: Specifica la directory base da cui avviare la ricerca. Predefinita è la directory di lavoro corrente.
39
+
40
+ > Esempio: `npx intlayer projects list --base-dir /path/to/workspace`
41
+
42
+ > Esempio: `npx intlayer projects list --base-dir /path/to/workspace`
43
+
44
+ - **`--git-root`**: Effettua la ricerca dalla root del repository git invece che dalla directory base. Questo è utile per trovare tutti i progetti Intlayer in un monorepo o in un repository git.
45
+
46
+ > Esempio: `npx intlayer projects list --git-root`
47
+
48
+ - **`--json`**: Mostra i risultati come JSON invece di testo formattato. Utile per scripting e accesso programmatico.
49
+
50
+ > Esempio: `npx intlayer projects list --json`
51
+
52
+ - **`--absolute`**: Mostra i risultati come percorsi assoluti invece di percorsi relativi.
53
+
54
+ > Esempio: `npx intlayer projects list --absolute`
55
+
56
+ ## Come funziona:
57
+
58
+ Il comando cerca i file di configurazione di Intlayer nella directory specificata (o nella root git se viene usato `--git-root`). Cerca i seguenti pattern di file di configurazione:
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
+ Ogni directory che contiene uno di questi file è considerata un progetto Intlayer e verrà elencata nell'output.
68
+
69
+ ## Esempi:
70
+
71
+ ### Elencare i progetti nella directory corrente:
72
+
73
+ ```bash
74
+ npx intlayer projects list
75
+ ```
76
+
77
+ ### Elencare i progetti in una directory specifica:
78
+
79
+ ```bash
80
+ npx intlayer projects list --base-dir ./packages
81
+ ```
82
+
83
+ ### Elencare tutti i progetti nel repository git:
84
+
85
+ ```bash
86
+ npx intlayer projects list --git-root
87
+ ```
88
+
89
+ ### Utilizzo dell'alias rapido:
90
+
91
+ ```bash
92
+ npx intlayer pl --git-root
93
+ ```
94
+
95
+ ### Output come JSON:
96
+
97
+ ```bash
98
+ npx intlayer projects list --json
99
+ ```
100
+
101
+ ## Esempio di output:
102
+
103
+ ### Output formattato:
104
+
105
+ ```bash
106
+ $ npx intlayer projects list --git-root
107
+
108
+ Trovati 3 progetti Intlayer:
109
+
110
+ - /Users/user/workspace/packages/app
111
+ - /Users/user/workspace/packages/admin
112
+ - /Users/user/workspace/packages/shared
113
+ ```
114
+
115
+ ### Output JSON:
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
+ ## Casi d'uso:
124
+
125
+ - **Monorepo management**: Scoprire tutti i progetti Intlayer in una struttura monorepo
126
+ - **Project discovery**: Trovare tutti i progetti abilitati a Intlayer in uno workspace
127
+ - **CI/CD**: Verificare i progetti Intlayer nei workflow automatizzati
128
+ - **Documentazione**: Generare documentazione che elenchi tutti i progetti che utilizzano Intlayer
129
+
130
+ L'output fornisce i percorsi assoluti di ogni directory di progetto, rendendo semplice navigare verso di essi o scrivere script per operazioni su più progetti Intlayer.
@@ -71,6 +71,26 @@ Per l'integrazione con Vite + React, consulta la [guida all'installazione](https
71
71
 
72
72
  ## Configurazione
73
73
 
74
+ Esegui il seguente comando per accedere all'Intlayer CMS:
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
+ Questo aprirà il tuo browser predefinito per completare il processo di autenticazione e ricevere le credenziali necessarie (Client ID e Client Secret) per utilizzare i servizi Intlayer.
93
+
74
94
  Nel file di configurazione di Intlayer, puoi personalizzare le impostazioni del CMS:
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: CIコマンド
5
+ description: CI/CDパイプラインとモノレポで自動注入された認証情報を使用してIntlayerコマンドを実行する方法を学びます。
6
+ keywords:
7
+ - CI
8
+ - CI/CD
9
+ - 自動化
10
+ - モノレポ
11
+ - 認証情報
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コマンドを追加
23
+ ---
24
+
25
+ # CIコマンド
26
+
27
+ ```bash
28
+ npx intlayer ci <command...>
29
+ ```
30
+
31
+ CIコマンドは、自動化とCI/CDパイプライン用に設計されています。`INTLAYER_PROJECT_CREDENTIALS`環境変数から認証情報を自動的に注入し、モノレポ内の複数のプロジェクトでIntlayerコマンドを実行できます。
32
+
33
+ ## 動作方法
34
+
35
+ CIコマンドは2つのモードで動作します:
36
+
37
+ 1. **単一プロジェクトモード**: 現在の作業ディレクトリが`INTLAYER_PROJECT_CREDENTIALS`内のプロジェクトパスのいずれかと一致する場合、その特定のプロジェクトに対してのみコマンドを実行します。
38
+
39
+ 2. **反復モード**: 特定のプロジェクトコンテキストが検出されない場合、すべての設定済みプロジェクトを反復処理し、それぞれに対してコマンドを実行します。
40
+
41
+ ## 環境変数
42
+
43
+ コマンドには`INTLAYER_PROJECT_CREDENTIALS`環境変数の設定が必要です。この変数には、プロジェクトパスを認証情報にマッピングするJSONオブジェクトが含まれている必要があります:
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
+ ## パッケージマネージャーの検出
59
+
60
+ CIコマンドは、`npm_config_user_agent`環境変数に基づいて使用されているパッケージマネージャー(npm、yarn、pnpm、またはbun)を自動的に検出し、Intlayerを実行するために適切なコマンドを使用します。
61
+
62
+ ## 引数
63
+
64
+ - **`<command...>`**: 実行するIntlayerコマンド(例:`fill`、`push`、`build`)。任意のIntlayerコマンドとその引数を渡すことができます。
65
+
66
+ > 例: `npx intlayer ci fill --verbose`
67
+ >
68
+ > 例: `npx intlayer ci push`
69
+ >
70
+ > 例: `npx intlayer ci build`
71
+
72
+ ## 例
73
+
74
+ ### 単一プロジェクトモードでコマンドを実行
75
+
76
+ `INTLAYER_PROJECT_CREDENTIALS`内のパスのいずれかと一致するプロジェクトディレクトリにいる場合:
77
+
78
+ ```bash
79
+ cd packages/app
80
+ npx intlayer ci fill
81
+ ```
82
+
83
+ これにより、`packages/app`プロジェクトの認証情報が自動的に注入されて`fill`コマンドが実行されます。
84
+
85
+ ### すべてのプロジェクトでコマンドを実行
86
+
87
+ プロジェクトパスと一致しないディレクトリにいる場合、コマンドはすべての設定済みプロジェクトを反復処理します:
88
+
89
+ ```bash
90
+ cd /path/to/monorepo
91
+ npx intlayer ci push
92
+ ```
93
+
94
+ これにより、`INTLAYER_PROJECT_CREDENTIALS`で設定された各プロジェクトに対して`push`コマンドが実行されます。
95
+
96
+ ### 追加のフラグを渡す
97
+
98
+ 基になるIntlayerコマンドに任意のフラグを渡すことができます:
99
+
100
+ ```bash
101
+ npx intlayer ci fill --verbose --mode complete
102
+ ```
103
+
104
+ ### CI/CDパイプラインで使用
105
+
106
+ CI/CD設定(例:GitHub Actions、GitLab CI)で、`INTLAYER_PROJECT_CREDENTIALS`をシークレットとして設定します:
107
+
108
+ ```yaml
109
+ # GitHub Actionsの例
110
+ env:
111
+ INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
112
+
113
+ steps:
114
+ - name: 辞書を埋める
115
+ run: npx intlayer ci fill
116
+ ```
117
+
118
+ ## エラーハンドリング
119
+
120
+ - `INTLAYER_PROJECT_CREDENTIALS`が設定されていない場合、コマンドはエラーで終了します。
121
+ - `INTLAYER_PROJECT_CREDENTIALS`が有効なJSONでない場合、コマンドはエラーで終了します。
122
+ - プロジェクトパスが存在しない場合、警告とともにスキップされます。
123
+ - いずれかのプロジェクトが失敗した場合、コマンドは非ゼロのステータスコードで終了します。
124
+
125
+ ## 使用例
126
+
127
+ - **モノレポの自動化**: モノレポ内の複数のプロジェクトでIntlayerコマンドを実行
128
+ - **CI/CDパイプライン**: 継続的インテグレーションワークフローでの辞書管理の自動化
129
+ - **一括操作**: 複数のIntlayerプロジェクトに対して同じ操作を一度に実行
130
+ - **シークレット管理**: 環境変数を使用して複数のプロジェクトの認証情報を安全に管理
131
+
132
+ ## セキュリティのベストプラクティス
133
+
134
+ - CI/CDプラットフォームで`INTLAYER_PROJECT_CREDENTIALS`を暗号化されたシークレットとして保存
135
+ - 認証情報をバージョン管理にコミットしない
136
+ - 異なるデプロイ環境に対して環境固有の認証情報を使用
137
+ - 定期的に認証情報をローテーション