@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,137 @@
|
|
|
1
|
+
---
|
|
2
|
+
createdAt: 2026-01-06
|
|
3
|
+
updatedAt: 2026-01-06
|
|
4
|
+
title: Polecenie CI
|
|
5
|
+
description: Dowiedz się, jak używać polecenia Intlayer CI do uruchamiania poleceń Intlayer z automatycznie wstrzykiwanymi poświadczeniami w pipeline'ach CI/CD i monorepo.
|
|
6
|
+
keywords:
|
|
7
|
+
- CI
|
|
8
|
+
- CI/CD
|
|
9
|
+
- Automatyzacja
|
|
10
|
+
- Monorepo
|
|
11
|
+
- Poświadczenia
|
|
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: Dodaj polecenie CI
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
# Polecenie CI
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
npx intlayer ci <command...>
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Polecenie CI jest zaprojektowane do automatyzacji i pipeline'ów CI/CD. Automatycznie wstrzykuje poświadczenia ze zmiennej środowiskowej `INTLAYER_PROJECT_CREDENTIALS` i może uruchamiać polecenia Intlayer w wielu projektach w monorepo.
|
|
32
|
+
|
|
33
|
+
## Jak działa
|
|
34
|
+
|
|
35
|
+
Polecenie CI działa w dwóch trybach:
|
|
36
|
+
|
|
37
|
+
1. **Tryb pojedynczego projektu**: Jeśli bieżący katalog roboczy pasuje do jednej ze ścieżek projektu w `INTLAYER_PROJECT_CREDENTIALS`, uruchamia polecenie tylko dla tego konkretnego projektu.
|
|
38
|
+
|
|
39
|
+
2. **Tryb iteracji**: Jeśli nie wykryto określonego kontekstu projektu, iteruje po wszystkich skonfigurowanych projektach i uruchamia polecenie dla każdego z nich.
|
|
40
|
+
|
|
41
|
+
## Zmienna środowiskowa
|
|
42
|
+
|
|
43
|
+
Polecenie wymaga ustawienia zmiennej środowiskowej `INTLAYER_PROJECT_CREDENTIALS`. Ta zmienna powinna zawierać obiekt JSON mapujący ścieżki projektów na ich poświadczenia:
|
|
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
|
+
## Wykrywanie menedżera pakietów
|
|
59
|
+
|
|
60
|
+
Polecenie CI automatycznie wykrywa, który menedżer pakietów jest używany (npm, yarn, pnpm lub bun) na podstawie zmiennej środowiskowej `npm_config_user_agent` i używa odpowiedniego polecenia do wykonania Intlayer.
|
|
61
|
+
|
|
62
|
+
## Argumenty
|
|
63
|
+
|
|
64
|
+
- **`<command...>`**: Polecenie Intlayer do wykonania (np. `fill`, `push`, `build`). Możesz przekazać dowolne polecenie Intlayer i jego argumenty.
|
|
65
|
+
|
|
66
|
+
> Przykład: `npx intlayer ci fill --verbose`
|
|
67
|
+
>
|
|
68
|
+
> Przykład: `npx intlayer ci push`
|
|
69
|
+
>
|
|
70
|
+
> Przykład: `npx intlayer ci build --watch`
|
|
71
|
+
|
|
72
|
+
## Przykłady
|
|
73
|
+
|
|
74
|
+
### Uruchomienie polecenia w trybie pojedynczego projektu
|
|
75
|
+
|
|
76
|
+
Jeśli jesteś w katalogu projektu, który pasuje do jednej ze ścieżek w `INTLAYER_PROJECT_CREDENTIALS`:
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
cd packages/app
|
|
80
|
+
npx intlayer ci fill
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
To uruchomi polecenie `fill` z poświadczeniami automatycznie wstrzykniętymi dla projektu `packages/app`.
|
|
84
|
+
|
|
85
|
+
### Uruchomienie polecenia we wszystkich projektach
|
|
86
|
+
|
|
87
|
+
Jeśli jesteś w katalogu, który nie pasuje do żadnej ścieżki projektu, polecenie będzie iterować po wszystkich skonfigurowanych projektach:
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
cd /path/to/monorepo
|
|
91
|
+
npx intlayer ci push
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
To uruchomi polecenie `push` dla każdego projektu skonfigurowanego w `INTLAYER_PROJECT_CREDENTIALS`.
|
|
95
|
+
|
|
96
|
+
### Przekazywanie dodatkowych flag
|
|
97
|
+
|
|
98
|
+
Możesz przekazać dowolne flagi do podstawowego polecenia Intlayer:
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
npx intlayer ci fill --verbose --mode complete
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
### Użycie w pipeline'ach CI/CD
|
|
105
|
+
|
|
106
|
+
W konfiguracji CI/CD (np. GitHub Actions, GitLab CI) ustaw `INTLAYER_PROJECT_CREDENTIALS` jako sekret:
|
|
107
|
+
|
|
108
|
+
```yaml
|
|
109
|
+
# Przykład GitHub Actions
|
|
110
|
+
env:
|
|
111
|
+
INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
|
|
112
|
+
|
|
113
|
+
steps:
|
|
114
|
+
- name: Wypełnij słowniki
|
|
115
|
+
run: npx intlayer ci fill
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
## Obsługa błędów
|
|
119
|
+
|
|
120
|
+
- Jeśli `INTLAYER_PROJECT_CREDENTIALS` nie jest ustawiona, polecenie zakończy się błędem.
|
|
121
|
+
- Jeśli `INTLAYER_PROJECT_CREDENTIALS` nie jest prawidłowym JSON, polecenie zakończy się błędem.
|
|
122
|
+
- Jeśli ścieżka projektu nie istnieje, zostanie pominięta z ostrzeżeniem.
|
|
123
|
+
- Jeśli jakikolwiek projekt się nie powiedzie, polecenie zakończy się niezerowym kodem statusu.
|
|
124
|
+
|
|
125
|
+
## Przypadki użycia
|
|
126
|
+
|
|
127
|
+
- **Automatyzacja monorepo**: Uruchamianie poleceń Intlayer w wielu projektach w monorepo
|
|
128
|
+
- **Pipeline'y CI/CD**: Automatyzacja zarządzania słownikami w przepływach pracy ciągłej integracji
|
|
129
|
+
- **Operacje masowe**: Wykonywanie tej samej operacji na wielu projektach Intlayer jednocześnie
|
|
130
|
+
- **Zarządzanie sekretami**: Bezpieczne zarządzanie poświadczeniami dla wielu projektów przy użyciu zmiennych środowiskowych
|
|
131
|
+
|
|
132
|
+
## Najlepsze praktyki bezpieczeństwa
|
|
133
|
+
|
|
134
|
+
- Przechowuj `INTLAYER_PROJECT_CREDENTIALS` jako zaszyfrowane sekrety w swojej platformie CI/CD
|
|
135
|
+
- Nigdy nie commituj poświadczeń do kontroli wersji
|
|
136
|
+
- Używaj poświadczeń specyficznych dla środowiska dla różnych środowisk wdrożeniowych
|
|
137
|
+
- Regularnie rotuj poświadczenia
|
package/docs/pl/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: Odkryj, jak używać Intlayer CLI do zarządzania Twoją wielojęzyczną stroną internetową. Postępuj zgodnie z krokami w tej dokumentacji online, aby skonfigurować swój projekt w kilka minut.
|
|
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: Dodano polecenie projects list
|
|
20
23
|
- version: 7.5.9
|
|
21
24
|
date: 2025-12-30
|
|
22
25
|
changes: Dodano polecenie init
|
|
@@ -119,6 +122,7 @@ Aby zobaczyć, jak skonfigurować dostępne lokalizacje lub inne parametry, zapo
|
|
|
119
122
|
- **[Build Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/build.md)** - Buduj swoje słowniki z plików deklaracji treści
|
|
120
123
|
- **[Watch Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/watch.md)** - Obserwuj zmiany i automatycznie buduj słowniki
|
|
121
124
|
- **[Check CLI Version](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/version.md)** - Sprawdź zainstalowaną wersję CLI Intlayer
|
|
125
|
+
- **[Lista projektów](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/list_projects.md)** - Wyświetl listę wszystkich projektów Intlayer w katalogu lub repozytorium git
|
|
122
126
|
|
|
123
127
|
### Zarządzanie słownikami
|
|
124
128
|
|
|
@@ -166,6 +170,7 @@ Aby zobaczyć, jak skonfigurować dostępne lokalizacje lub inne parametry, zapo
|
|
|
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 @@ Aby zobaczyć, jak skonfigurować dostępne lokalizacje lub inne parametry, zapo
|
|
|
175
180
|
>
|
|
176
181
|
> - `npx intlayer list` zamiast `npx intlayer content list`
|
|
177
182
|
> - `npx intlayer test` zamiast `npx intlayer content test`
|
|
183
|
+
> - `npx intlayer projects-list` lub `npx intlayer pl` zamiast `npx intlayer projects list`
|
package/docs/pl/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: Lista plików deklaracji zawartości
|
|
5
5
|
description: Dowiedz się, jak wyświetlić listę wszystkich plików deklaracji zawartości w swoim projekcie.
|
|
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: Dodano opcję wyjścia bezwzględnego do polecenia list
|
|
20
|
+
- version: 7.5.11
|
|
21
|
+
date: 2026-01-06
|
|
22
|
+
changes: Dodano opcję wyjścia JSON do polecenia list
|
|
16
23
|
---
|
|
17
24
|
|
|
18
25
|
# Lista plików deklaracji zawartości
|
|
@@ -27,14 +34,36 @@ npx intlayer content list
|
|
|
27
34
|
|
|
28
35
|
To polecenie wyświetla wszystkie pliki deklaracji zawartości w Twoim projekcie, pokazując ich klucze słownika oraz ścieżki do plików. Jest to przydatne, aby uzyskać przegląd wszystkich plików zawartości i zweryfikować, czy są one poprawnie wykrywane przez Intlayer.
|
|
29
36
|
|
|
30
|
-
##
|
|
37
|
+
## Argumenty:
|
|
38
|
+
|
|
39
|
+
- **`--json`**: Wyświetla wyniki jako JSON zamiast sformatowanego tekstu. Przydatne do skryptów i dostępu programowego.
|
|
40
|
+
|
|
41
|
+
> Przykład: `npx intlayer content list --json`
|
|
42
|
+
|
|
43
|
+
## Przykłady:
|
|
44
|
+
|
|
45
|
+
### Lista plików deklaracji zawartości:
|
|
31
46
|
|
|
32
47
|
```bash
|
|
33
48
|
npx intlayer content list
|
|
34
49
|
```
|
|
35
50
|
|
|
51
|
+
### Wyjście jako JSON:
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
npx intlayer content list --json
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### Wyjście jako ścieżki bezwzględne:
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
npx intlayer content list --absolute
|
|
61
|
+
```
|
|
62
|
+
|
|
36
63
|
## Przykładowy wynik:
|
|
37
64
|
|
|
65
|
+
### Sformatowane wyjście:
|
|
66
|
+
|
|
38
67
|
```bash
|
|
39
68
|
npx intlayer content list
|
|
40
69
|
Content declaration files:
|
|
@@ -45,6 +74,14 @@ Content declaration files:
|
|
|
45
74
|
Łączna liczba plików deklaracji zawartości: 3
|
|
46
75
|
```
|
|
47
76
|
|
|
77
|
+
### Wyjście 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
|
To polecenie wyświetli:
|
|
49
86
|
|
|
50
87
|
- Sformatowaną listę wszystkich plików deklaracji zawartości wraz z ich kluczami i względnymi ścieżkami do plików
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
---
|
|
2
|
+
createdAt: 2025-12-30
|
|
3
|
+
updatedAt: 2026-01-06
|
|
4
|
+
title: Lista projektów Intlayer
|
|
5
|
+
description: Dowiedz się, jak wypisać wszystkie projekty Intlayer w katalogu lub repozytorium git.
|
|
6
|
+
keywords:
|
|
7
|
+
- Lista
|
|
8
|
+
- Projekty
|
|
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: Dodaj opcję wyjścia bezwzględnego do polecenia list projects
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
# Lista projektów Intlayer
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
npx intlayer projects list
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
To polecenie przeszukuje i wypisuje wszystkie projekty Intlayer, znajdując katalogi zawierające pliki konfiguracyjne Intlayer. Przydaje się do odnalezienia wszystkich projektów Intlayer w monorepo, workspace lub repozytorium git.
|
|
30
|
+
|
|
31
|
+
## Aliasy:
|
|
32
|
+
|
|
33
|
+
- `npx intlayer projects-list`
|
|
34
|
+
- `npx intlayer pl`
|
|
35
|
+
|
|
36
|
+
## Argumenty:
|
|
37
|
+
|
|
38
|
+
- **`--base-dir [path]`**: Określ katalog bazowy, od którego ma się rozpocząć wyszukiwanie. Domyślnie używany jest bieżący katalog roboczy.
|
|
39
|
+
|
|
40
|
+
> Przykład: `npx intlayer projects list --base-dir /path/to/workspace`
|
|
41
|
+
|
|
42
|
+
> Przykład: `npx intlayer projects list --base-dir /path/to/workspace`
|
|
43
|
+
|
|
44
|
+
- **`--git-root`**: Wyszukaj od katalogu głównego gita zamiast od katalogu bazowego. Przydaje się do odnalezienia wszystkich projektów Intlayer w monorepo lub repozytorium git.
|
|
45
|
+
|
|
46
|
+
> Przykład: `npx intlayer projects list --git-root`
|
|
47
|
+
|
|
48
|
+
- **`--json`**: Wyświetla wyniki jako JSON zamiast sformatowanego tekstu. Przydatne do skryptów i dostępu programowego.
|
|
49
|
+
|
|
50
|
+
> Przykład: `npx intlayer projects list --json`
|
|
51
|
+
|
|
52
|
+
- **`--absolute`**: Wyświetla wyniki jako ścieżki bezwzględne zamiast ścieżek względnych.
|
|
53
|
+
|
|
54
|
+
> Przykład: `npx intlayer projects list --absolute`
|
|
55
|
+
|
|
56
|
+
## Jak to działa:
|
|
57
|
+
|
|
58
|
+
Polecenie przeszukuje pliki konfiguracyjne Intlayer w określonym katalogu (lub w katalogu głównym gita, jeśli użyto `--git-root`). Wyszukuje następujące wzorce plików konfiguracyjnych:
|
|
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
|
+
Każdy katalog zawierający jeden z tych plików jest uznawany za projekt Intlayer i zostanie wypisany w wynikach.
|
|
68
|
+
|
|
69
|
+
## Przykłady:
|
|
70
|
+
|
|
71
|
+
### Wypisz projekty w bieżącym katalogu:
|
|
72
|
+
|
|
73
|
+
```bash
|
|
74
|
+
npx intlayer projects list
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
### Lista projektów w określonym katalogu:
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
npx intlayer projects list --base-dir ./packages
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### Wyświetl wszystkie projekty w repozytorium git:
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
npx intlayer projects list --git-root
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
### Użycie aliasu skrótu:
|
|
90
|
+
|
|
91
|
+
```bash
|
|
92
|
+
npx intlayer pl --git-root
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### Wyjście jako JSON:
|
|
96
|
+
|
|
97
|
+
```bash
|
|
98
|
+
npx intlayer projects list --json
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
## Przykładowe wyjście:
|
|
102
|
+
|
|
103
|
+
### Sformatowane wyjście:
|
|
104
|
+
|
|
105
|
+
```bash
|
|
106
|
+
$ npx intlayer projects list --git-root
|
|
107
|
+
|
|
108
|
+
Found 3 Intlayer project(s):
|
|
109
|
+
|
|
110
|
+
- /Users/user/workspace/packages/app
|
|
111
|
+
- /Users/user/workspace/packages/admin
|
|
112
|
+
- /Users/user/workspace/packages/shared
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
### Wyjście 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
|
+
## Zastosowania:
|
|
124
|
+
|
|
125
|
+
- **Zarządzanie monorepo**: Odkryj wszystkie projekty Intlayer w strukturze monorepo
|
|
126
|
+
- **Wykrywanie projektów**: Znajdź wszystkie projekty korzystające z Intlayer w workspace
|
|
127
|
+
- **CI/CD**: Weryfikacja projektów Intlayer w zautomatyzowanych workflowach
|
|
128
|
+
- **Dokumentacja**: Generuj dokumentację zawierającą listę wszystkich projektów używających Intlayer
|
|
129
|
+
|
|
130
|
+
Wyjście zawiera absolutne ścieżki do każdego katalogu projektu, co ułatwia nawigację lub tworzenie skryptów operujących na wielu projektach Intlayer.
|
package/docs/pl/intlayer_CMS.md
CHANGED
|
@@ -77,6 +77,26 @@ Aby zintegrować z Vite + React, zapoznaj się z [przewodnikiem instalacji](http
|
|
|
77
77
|
|
|
78
78
|
## Konfiguracja
|
|
79
79
|
|
|
80
|
+
Uruchom następujące polecenie, aby zalogować się do 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
|
+
Spowoduje to otwarcie domyślnej przeglądarki w celu ukończenia procesu uwierzytelniania i otrzymania niezbędnych poświadczeń (Client ID i Client Secret) do korzystania z usług Intlayer.
|
|
99
|
+
|
|
80
100
|
W pliku konfiguracyjnym Intlayer możesz dostosować ustawienia 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: Aprenda como usar o comando Intlayer CI para executar comandos Intlayer com credenciais auto-injetadas em pipelines CI/CD e monorepos.
|
|
6
|
+
keywords:
|
|
7
|
+
- CI
|
|
8
|
+
- CI/CD
|
|
9
|
+
- Automação
|
|
10
|
+
- Monorepo
|
|
11
|
+
- Credenciais
|
|
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: Adicionar comando CI
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
# Comando CI
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
npx intlayer ci <command...>
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
O comando CI é projetado para automação e pipelines CI/CD. Ele injeta automaticamente credenciais da variável de ambiente `INTLAYER_PROJECT_CREDENTIALS` e pode executar comandos Intlayer em vários projetos em um monorepo.
|
|
32
|
+
|
|
33
|
+
## Como funciona
|
|
34
|
+
|
|
35
|
+
O comando CI opera em dois modos:
|
|
36
|
+
|
|
37
|
+
1. **Modo de projeto único**: Se o diretório de trabalho atual corresponder a um dos caminhos do projeto em `INTLAYER_PROJECT_CREDENTIALS`, ele executa o comando apenas para esse projeto específico.
|
|
38
|
+
|
|
39
|
+
2. **Modo de iteração**: Se nenhum contexto de projeto específico for detectado, ele itera sobre todos os projetos configurados e executa o comando para cada um.
|
|
40
|
+
|
|
41
|
+
## Variável de ambiente
|
|
42
|
+
|
|
43
|
+
O comando requer que a variável de ambiente `INTLAYER_PROJECT_CREDENTIALS` seja definida. Esta variável deve conter um objeto JSON mapeando caminhos de projeto para suas credenciais:
|
|
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
|
+
## Detecção do gerenciador de pacotes
|
|
59
|
+
|
|
60
|
+
O comando CI detecta automaticamente qual gerenciador de pacotes está sendo usado (npm, yarn, pnpm ou bun) com base na variável de ambiente `npm_config_user_agent` e usa o comando apropriado para executar Intlayer.
|
|
61
|
+
|
|
62
|
+
## Argumentos
|
|
63
|
+
|
|
64
|
+
- **`<command...>`**: O comando Intlayer a ser executado (por exemplo, `fill`, `push`, `build`). Você pode passar qualquer comando Intlayer e seus argumentos.
|
|
65
|
+
|
|
66
|
+
> Exemplo: `npx intlayer ci fill --verbose`
|
|
67
|
+
>
|
|
68
|
+
> Exemplo: `npx intlayer ci push`
|
|
69
|
+
>
|
|
70
|
+
> Exemplo: `npx intlayer ci build`
|
|
71
|
+
|
|
72
|
+
## Exemplos
|
|
73
|
+
|
|
74
|
+
### Executar um comando no modo de projeto único
|
|
75
|
+
|
|
76
|
+
Se você estiver em um diretório de projeto que corresponde a um dos caminhos em `INTLAYER_PROJECT_CREDENTIALS`:
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
cd packages/app
|
|
80
|
+
npx intlayer ci fill
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
Isso executará o comando `fill` com credenciais automaticamente injetadas para o projeto `packages/app`.
|
|
84
|
+
|
|
85
|
+
### Executar um comando em todos os projetos
|
|
86
|
+
|
|
87
|
+
Se você estiver em um diretório que não corresponde a nenhum caminho de projeto, o comando iterará sobre todos os projetos configurados:
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
cd /path/to/monorepo
|
|
91
|
+
npx intlayer ci push
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Isso executará o comando `push` para cada projeto configurado em `INTLAYER_PROJECT_CREDENTIALS`.
|
|
95
|
+
|
|
96
|
+
### Passar flags adicionais
|
|
97
|
+
|
|
98
|
+
Você pode passar quaisquer flags para o comando Intlayer subjacente:
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
npx intlayer ci fill --verbose --mode complete
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
### Usar em pipelines CI/CD
|
|
105
|
+
|
|
106
|
+
Em sua configuração CI/CD (por exemplo, GitHub Actions, GitLab CI), defina `INTLAYER_PROJECT_CREDENTIALS` como um segredo:
|
|
107
|
+
|
|
108
|
+
```yaml
|
|
109
|
+
# Exemplo GitHub Actions
|
|
110
|
+
env:
|
|
111
|
+
INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
|
|
112
|
+
|
|
113
|
+
steps:
|
|
114
|
+
- name: Preencher dicionários
|
|
115
|
+
run: npx intlayer ci fill
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
## Tratamento de erros
|
|
119
|
+
|
|
120
|
+
- Se `INTLAYER_PROJECT_CREDENTIALS` não estiver definida, o comando sairá com um erro.
|
|
121
|
+
- Se `INTLAYER_PROJECT_CREDENTIALS` não for um JSON válido, o comando sairá com um erro.
|
|
122
|
+
- Se um caminho de projeto não existir, ele será ignorado com um aviso.
|
|
123
|
+
- Se algum projeto falhar, o comando sairá com um código de status diferente de zero.
|
|
124
|
+
|
|
125
|
+
## Casos de uso
|
|
126
|
+
|
|
127
|
+
- **Automação de monorepo**: Executar comandos Intlayer em vários projetos em um monorepo
|
|
128
|
+
- **Pipelines CI/CD**: Automatizar o gerenciamento de dicionários em fluxos de trabalho de integração contínua
|
|
129
|
+
- **Operações em massa**: Realizar a mesma operação em vários projetos Intlayer de uma vez
|
|
130
|
+
- **Gerenciamento de segredos**: Gerenciar com segurança credenciais para vários projetos usando variáveis de ambiente
|
|
131
|
+
|
|
132
|
+
## Melhores práticas de segurança
|
|
133
|
+
|
|
134
|
+
- Armazene `INTLAYER_PROJECT_CREDENTIALS` como segredos criptografados em sua plataforma CI/CD
|
|
135
|
+
- Nunca faça commit de credenciais no controle de versão
|
|
136
|
+
- Use credenciais específicas do ambiente para diferentes ambientes de implantação
|
|
137
|
+
- Rotacione credenciais regularmente
|
package/docs/pt/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: Descubra como usar o Intlayer CLI para gerenciar seu site multilíngue. Siga os passos nesta documentação online para configurar seu projeto em poucos minutos.
|
|
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: Adicionado comando projects list
|
|
20
23
|
- version: 7.5.9
|
|
21
24
|
date: 2025-12-30
|
|
22
25
|
changes: Adicionado comando init
|
|
@@ -119,6 +122,7 @@ Para ver como configurar os locais disponíveis ou outros parâmetros, consulte
|
|
|
119
122
|
- **[Construir Dicionários](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/build.md)** - Construa seus dicionários a partir dos arquivos de declaração de conteúdo
|
|
120
123
|
- **[Observar Dicionários](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/watch.md)** - Observe alterações e construa automaticamente os dicionários
|
|
121
124
|
- **[Verificar Versão do CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/version.md)** - Verifique a versão instalada do Intlayer CLI
|
|
125
|
+
- **[Listar Projetos](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pt/cli/list_projects.md)** - Liste todos os projetos Intlayer em um diretório ou repositório git
|
|
122
126
|
|
|
123
127
|
### Gerenciamento de Dicionários
|
|
124
128
|
|
|
@@ -166,6 +170,7 @@ Para ver como configurar os locais disponíveis ou outros parâmetros, consulte
|
|
|
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 @@ Para ver como configurar os locais disponíveis ou outros parâmetros, consulte
|
|
|
175
180
|
>
|
|
176
181
|
> - `npx intlayer list` ao invés de `npx intlayer content list`
|
|
177
182
|
> - `npx intlayer test` ao invés de `npx intlayer content test`
|
|
183
|
+
> - `npx intlayer projects-list` ou `npx intlayer pl` ao invés de `npx intlayer projects list`
|
package/docs/pt/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: Listar Arquivos de Declaração de Conteúdo
|
|
5
5
|
description: Aprenda como listar todos os arquivos de declaração de conteúdo no seu projeto.
|
|
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: Adicionar opção de saída absoluta ao comando list
|
|
20
|
+
- version: 7.5.11
|
|
21
|
+
date: 2026-01-06
|
|
22
|
+
changes: Adicionar opção de saída JSON ao comando list
|
|
16
23
|
---
|
|
17
24
|
|
|
18
25
|
# Listar arquivos de declaração de conteúdo
|
|
@@ -27,14 +34,36 @@ npx intlayer content list
|
|
|
27
34
|
|
|
28
35
|
Este comando exibe todos os arquivos de declaração de conteúdo no seu projeto, mostrando suas chaves de dicionário e caminhos dos arquivos. É útil para obter uma visão geral de todos os seus arquivos de conteúdo e verificar se eles estão sendo corretamente descobertos pelo Intlayer.
|
|
29
36
|
|
|
30
|
-
##
|
|
37
|
+
## Argumentos:
|
|
38
|
+
|
|
39
|
+
- **`--json`**: Exibe os resultados como JSON em vez de texto formatado. Útil para scripts e acesso programático.
|
|
40
|
+
|
|
41
|
+
> Exemplo: `npx intlayer content list --json`
|
|
42
|
+
|
|
43
|
+
## Exemplos:
|
|
44
|
+
|
|
45
|
+
### Listar arquivos de declaração de conteúdo:
|
|
31
46
|
|
|
32
47
|
```bash
|
|
33
48
|
npx intlayer content list
|
|
34
49
|
```
|
|
35
50
|
|
|
51
|
+
### Saída como JSON:
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
npx intlayer content list --json
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### Saída como caminhos absolutos:
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
npx intlayer content list --absolute
|
|
61
|
+
```
|
|
62
|
+
|
|
36
63
|
## Exemplo de saída:
|
|
37
64
|
|
|
65
|
+
### Saída formatada:
|
|
66
|
+
|
|
38
67
|
```bash
|
|
39
68
|
npx intlayer content list
|
|
40
69
|
Content declaration files:
|
|
@@ -45,6 +74,14 @@ Content declaration files:
|
|
|
45
74
|
Total de arquivos de declaração de conteúdo: 3
|
|
46
75
|
```
|
|
47
76
|
|
|
77
|
+
### Saída 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
|
Este comando exibirá:
|
|
49
86
|
|
|
50
87
|
- Uma lista formatada de todos os arquivos de declaração de conteúdo com suas chaves e caminhos relativos dos arquivos
|