@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.
- package/dist/cjs/generated/docs.entry.cjs +38 -0
- package/dist/cjs/generated/docs.entry.cjs.map +1 -1
- package/dist/esm/generated/docs.entry.mjs +38 -0
- package/dist/esm/generated/docs.entry.mjs.map +1 -1
- package/dist/types/generated/docs.entry.d.ts +2 -0
- package/dist/types/generated/docs.entry.d.ts.map +1 -1
- package/docs/ar/cli/ci.md +137 -0
- package/docs/ar/cli/index.md +7 -1
- package/docs/ar/cli/list.md +39 -2
- package/docs/ar/cli/list_projects.md +131 -0
- package/docs/ar/intlayer_CMS.md +20 -0
- package/docs/de/cli/ci.md +137 -0
- package/docs/de/cli/index.md +7 -1
- package/docs/de/cli/list.md +39 -2
- package/docs/de/cli/list_projects.md +130 -0
- package/docs/de/intlayer_CMS.md +20 -0
- package/docs/en/cli/ci.md +137 -0
- package/docs/en/cli/index.md +14 -1
- package/docs/en/cli/list.md +39 -2
- package/docs/en/cli/list_projects.md +128 -0
- package/docs/en/interest_of_intlayer.md +1 -1
- package/docs/en/intlayer_CMS.md +20 -0
- package/docs/en-GB/cli/ci.md +137 -0
- package/docs/en-GB/cli/index.md +7 -1
- package/docs/en-GB/cli/list.md +39 -2
- package/docs/en-GB/cli/list_projects.md +130 -0
- package/docs/en-GB/intlayer_CMS.md +20 -0
- package/docs/es/cli/ci.md +137 -0
- package/docs/es/cli/index.md +7 -1
- package/docs/es/cli/list.md +39 -2
- package/docs/es/cli/list_projects.md +130 -0
- package/docs/es/intlayer_CMS.md +20 -0
- package/docs/fr/cli/ci.md +137 -0
- package/docs/fr/cli/index.md +7 -1
- package/docs/fr/cli/list.md +39 -2
- package/docs/fr/cli/list_projects.md +131 -0
- package/docs/fr/intlayer_CMS.md +20 -0
- package/docs/hi/cli/ci.md +137 -0
- package/docs/hi/cli/index.md +7 -1
- package/docs/hi/cli/list.md +38 -1
- package/docs/hi/cli/list_projects.md +130 -0
- package/docs/hi/intlayer_CMS.md +20 -0
- package/docs/id/cli/ci.md +137 -0
- package/docs/id/cli/index.md +7 -1
- package/docs/id/cli/list.md +38 -1
- package/docs/id/cli/list_projects.md +128 -0
- package/docs/id/intlayer_CMS.md +20 -0
- package/docs/it/cli/ci.md +137 -0
- package/docs/it/cli/index.md +7 -1
- package/docs/it/cli/list.md +39 -2
- package/docs/it/cli/list_projects.md +130 -0
- package/docs/it/intlayer_CMS.md +20 -0
- package/docs/ja/cli/ci.md +137 -0
- package/docs/ja/cli/index.md +7 -1
- package/docs/ja/cli/list.md +38 -1
- package/docs/ja/cli/list_projects.md +136 -0
- package/docs/ja/intlayer_CMS.md +20 -0
- package/docs/ko/cli/ci.md +137 -0
- package/docs/ko/cli/index.md +7 -1
- package/docs/ko/cli/list.md +38 -1
- package/docs/ko/cli/list_projects.md +128 -0
- package/docs/ko/intlayer_CMS.md +20 -0
- package/docs/pl/cli/ci.md +137 -0
- package/docs/pl/cli/index.md +7 -1
- package/docs/pl/cli/list.md +39 -2
- package/docs/pl/cli/list_projects.md +130 -0
- package/docs/pl/intlayer_CMS.md +20 -0
- package/docs/pt/cli/ci.md +137 -0
- package/docs/pt/cli/index.md +7 -1
- package/docs/pt/cli/list.md +39 -2
- package/docs/pt/cli/list_projects.md +134 -0
- package/docs/pt/intlayer_CMS.md +20 -0
- package/docs/ru/cli/ci.md +137 -0
- package/docs/ru/cli/index.md +7 -1
- package/docs/ru/cli/list.md +39 -2
- package/docs/ru/cli/list_projects.md +130 -0
- package/docs/ru/intlayer_CMS.md +20 -0
- package/docs/tr/cli/ci.md +137 -0
- package/docs/tr/cli/index.md +7 -1
- package/docs/tr/cli/list.md +39 -2
- package/docs/tr/cli/list_projects.md +134 -0
- package/docs/tr/intlayer_CMS.md +20 -0
- package/docs/vi/cli/ci.md +137 -0
- package/docs/vi/cli/index.md +7 -1
- package/docs/vi/cli/list.md +38 -1
- package/docs/vi/cli/list_projects.md +130 -0
- package/docs/vi/intlayer_CMS.md +20 -0
- package/docs/zh/cli/ci.md +137 -0
- package/docs/zh/cli/index.md +7 -1
- package/docs/zh/cli/list.md +38 -1
- package/docs/zh/cli/list_projects.md +130 -0
- package/docs/zh/intlayer_CMS.md +20 -0
- package/package.json +6 -6
- 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.
|
package/docs/id/intlayer_CMS.md
CHANGED
|
@@ -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
|
package/docs/it/cli/index.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
createdAt: 2024-08-11
|
|
3
|
-
updatedAt:
|
|
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`
|
package/docs/it/cli/list.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
createdAt: 2024-08-11
|
|
3
|
-
updatedAt:
|
|
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
|
-
##
|
|
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.
|
package/docs/it/intlayer_CMS.md
CHANGED
|
@@ -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
|
+
- 定期的に認証情報をローテーション
|