@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: 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
@@ -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: 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`
@@ -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: 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
- ## Przykład:
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.
@@ -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
@@ -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: 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`
@@ -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: 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
- ## Exemplo:
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