@intlayer/docs 7.5.10 → 7.5.12

package/docs/ko/plugins/sync-json.md

@@ -108,18 +108,22 @@ syncJSON({
   source: ({ key, locale }) => string, // 필수
   location?: string, // 선택적 레이블, 기본값: "plugin"
   priority?: number, // 충돌 해결을 위한 선택적 우선순위, 기본값: 0
-  format?: 'intlayer' | 'icu' | 'i18next', // 선택적 포맷터, 기본값: 'intlayer'
+  format?: 'intlayer' | 'icu' | 'i18next', // 선택적 포맷터, Intlayer 런타임 호환성에 사용
 });
 ```
 
 #### `format` ('intlayer' | 'icu' | 'i18next')
 
-JSON 파일을 동기화할 때 사전 콘텐츠에 사용할 포맷터를 지정합니다. 이를 통해 다양한 i18n 라이브러리와 호환되는 다양한 메시지 포맷팅 구문을 사용할 수 있습니다.
+JSON 파일을 동기화할 때 사전 콘텐츠에 사용할 포맷터를 지정합니다. 이를 통해 Intlayer 런타임과 호환되는 다양한 메시지 포맷팅 구문을 사용할 수 있습니다.
 
+- `undefined`: 포맷터가 사용되지 않으며, JSON 콘텐츠가 그대로 사용됩니다.
 - `'intlayer'`: 기본 Intlayer 포맷터 (기본값).
 - `'icu'`: ICU 메시지 포맷팅을 사용합니다 (react-intl, vue-i18n과 같은 라이브러리와 호환).
 - `'i18next'`: i18next 메시지 포맷팅을 사용합니다 (i18next, next-i18next, Solid-i18next와 호환).
 
+> 포맷터를 사용하면 JSON 콘텐츠가 입력과 출력에서 변환된다는 점에 유의하세요. ICU 복수형과 같은 복잡한 JSON 규칙의 경우, 파싱이 입력과 출력 간의 1대1 매핑을 보장하지 못할 수 있습니다.
+> Intlayer 런타임을 사용하지 않는 경우, 포맷터를 설정하지 않는 것이 더 나을 수 있습니다.
+
 **예시:**
 
 ```ts

package/docs/pl/cli/ci.md

@@ -0,0 +1,137 @@
+---
+createdAt: 2026-01-06
+updatedAt: 2026-01-06
+title: Polecenie CI
+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.
+keywords:
+  - CI
+  - CI/CD
+  - Automatyzacja
+  - Monorepo
+  - Poświadczenia
+  - CLI
+  - Intlayer
+slugs:
+  - doc
+  - concept
+  - cli
+  - ci
+history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Dodaj polecenie CI
+---
+
+# Polecenie CI
+
+```bash
+npx intlayer ci <command...>
+```
+
+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.
+
+## Jak działa
+
+Polecenie CI działa w dwóch trybach:
+
+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.
+
+2. **Tryb iteracji**: Jeśli nie wykryto określonego kontekstu projektu, iteruje po wszystkich skonfigurowanych projektach i uruchamia polecenie dla każdego z nich.
+
+## Zmienna środowiskowa
+
+Polecenie wymaga ustawienia zmiennej środowiskowej `INTLAYER_PROJECT_CREDENTIALS`. Ta zmienna powinna zawierać obiekt JSON mapujący ścieżki projektów na ich poświadczenia:
+
+```json
+{
+  "packages/app": {
+    "clientId": "your-client-id-1",
+    "clientSecret": "your-client-secret-1"
+  },
+  "packages/admin": {
+    "clientId": "your-client-id-2",
+    "clientSecret": "your-client-secret-2"
+  }
+}
+```
+
+## Wykrywanie menedżera pakietów
+
+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.
+
+## Argumenty
+
+- **`<command...>`**: Polecenie Intlayer do wykonania (np. `fill`, `push`, `build`). Możesz przekazać dowolne polecenie Intlayer i jego argumenty.
+
+  > Przykład: `npx intlayer ci fill --verbose`
+  >
+  > Przykład: `npx intlayer ci push`
+  >
+  > Przykład: `npx intlayer ci build --watch`
+
+## Przykłady
+
+### Uruchomienie polecenia w trybie pojedynczego projektu
+
+Jeśli jesteś w katalogu projektu, który pasuje do jednej ze ścieżek w `INTLAYER_PROJECT_CREDENTIALS`:
+
+```bash
+cd packages/app
+npx intlayer ci fill
+```
+
+To uruchomi polecenie `fill` z poświadczeniami automatycznie wstrzykniętymi dla projektu `packages/app`.
+
+### Uruchomienie polecenia we wszystkich projektach
+
+Jeśli jesteś w katalogu, który nie pasuje do żadnej ścieżki projektu, polecenie będzie iterować po wszystkich skonfigurowanych projektach:
+
+```bash
+cd /path/to/monorepo
+npx intlayer ci push
+```
+
+To uruchomi polecenie `push` dla każdego projektu skonfigurowanego w `INTLAYER_PROJECT_CREDENTIALS`.
+
+### Przekazywanie dodatkowych flag
+
+Możesz przekazać dowolne flagi do podstawowego polecenia Intlayer:
+
+```bash
+npx intlayer ci fill --verbose --mode complete
+```
+
+### Użycie w pipeline'ach CI/CD
+
+W konfiguracji CI/CD (np. GitHub Actions, GitLab CI) ustaw `INTLAYER_PROJECT_CREDENTIALS` jako sekret:
+
+```yaml
+# Przykład GitHub Actions
+env:
+  INTLAYER_PROJECT_CREDENTIALS: ${{ secrets.INTLAYER_PROJECT_CREDENTIALS }}
+
+steps:
+  - name: Wypełnij słowniki
+    run: npx intlayer ci fill
+```
+
+## Obsługa błędów
+
+- Jeśli `INTLAYER_PROJECT_CREDENTIALS` nie jest ustawiona, polecenie zakończy się błędem.
+- Jeśli `INTLAYER_PROJECT_CREDENTIALS` nie jest prawidłowym JSON, polecenie zakończy się błędem.
+- Jeśli ścieżka projektu nie istnieje, zostanie pominięta z ostrzeżeniem.
+- Jeśli jakikolwiek projekt się nie powiedzie, polecenie zakończy się niezerowym kodem statusu.
+
+## Przypadki użycia
+
+- **Automatyzacja monorepo**: Uruchamianie poleceń Intlayer w wielu projektach w monorepo
+- **Pipeline'y CI/CD**: Automatyzacja zarządzania słownikami w przepływach pracy ciągłej integracji
+- **Operacje masowe**: Wykonywanie tej samej operacji na wielu projektach Intlayer jednocześnie
+- **Zarządzanie sekretami**: Bezpieczne zarządzanie poświadczeniami dla wielu projektów przy użyciu zmiennych środowiskowych
+
+## Najlepsze praktyki bezpieczeństwa
+
+- Przechowuj `INTLAYER_PROJECT_CREDENTIALS` jako zaszyfrowane sekrety w swojej platformie CI/CD
+- Nigdy nie commituj poświadczeń do kontroli wersji
+- Używaj poświadczeń specyficznych dla środowiska dla różnych środowisk wdrożeniowych
+- Regularnie rotuj poświadczenia

package/docs/pl/cli/index.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-12-30
+updatedAt: 2026-01-06
 title: CLI
 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.
 keywords:
@@ -17,6 +17,9 @@ slugs:
   - concept
   - cli
 history:
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Dodano polecenie projects list
   - version: 7.5.9
     date: 2025-12-30
     changes: Dodano polecenie init
@@ -119,6 +122,7 @@ Aby zobaczyć, jak skonfigurować dostępne lokalizacje lub inne parametry, zapo
 - **[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
 - **[Watch Dictionaries](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/watch.md)** - Obserwuj zmiany i automatycznie buduj słowniki
 - **[Check CLI Version](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/version.md)** - Sprawdź zainstalowaną wersję CLI Intlayer
+- **[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
 
 ### Zarządzanie słownikami
 
@@ -166,6 +170,7 @@ Aby zobaczyć, jak skonfigurować dostępne lokalizacje lub inne parametry, zapo
   "intlayer:list": "npx intlayer content list",
   "intlayer:test": "npx intlayer content test",
   "intlayer:transform": "npx intlayer transform",
+  "intlayer:projects": "npx intlayer projects list",
   "intlayer:doc:translate": "npx intlayer doc translate",
   "intlayer:doc:review": "npx intlayer doc review"
 }
@@ -175,3 +180,4 @@ Aby zobaczyć, jak skonfigurować dostępne lokalizacje lub inne parametry, zapo
 >
 > - `npx intlayer list` zamiast `npx intlayer content list`
 > - `npx intlayer test` zamiast `npx intlayer content test`
+> - `npx intlayer projects-list` lub `npx intlayer pl` zamiast `npx intlayer projects list`

package/docs/pl/cli/list.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2024-08-11
-updatedAt: 2025-11-22
+updatedAt: 2026-01-06
 title: Lista plików deklaracji zawartości
 description: Dowiedz się, jak wyświetlić listę wszystkich plików deklaracji zawartości w swoim projekcie.
 keywords:
@@ -13,6 +13,13 @@ slugs:
   - concept
   - cli
   - list
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Dodano opcję wyjścia bezwzględnego do polecenia list
+  - version: 7.5.11
+    date: 2026-01-06
+    changes: Dodano opcję wyjścia JSON do polecenia list
 ---
 
 # Lista plików deklaracji zawartości
@@ -27,14 +34,36 @@ npx intlayer content list
 
 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.
 
-## Przykład:
+## Argumenty:
+
+- **`--json`**: Wyświetla wyniki jako JSON zamiast sformatowanego tekstu. Przydatne do skryptów i dostępu programowego.
+
+  > Przykład: `npx intlayer content list --json`
+
+## Przykłady:
+
+### Lista plików deklaracji zawartości:
 
 ```bash
 npx intlayer content list
 ```
 
+### Wyjście jako JSON:
+
+```bash
+npx intlayer content list --json
+```
+
+### Wyjście jako ścieżki bezwzględne:
+
+```bash
+npx intlayer content list --absolute
+```
+
 ## Przykładowy wynik:
 
+### Sformatowane wyjście:
+
 ```bash
 npx intlayer content list
 Content declaration files:
@@ -45,6 +74,14 @@ Content declaration files:
 Łączna liczba plików deklaracji zawartości: 3
 ```
 
+### Wyjście JSON:
+
+```bash
+$ npx intlayer content list --json
+
+[{"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"}]
+```
+
 To polecenie wyświetli:
 
 - Sformatowaną listę wszystkich plików deklaracji zawartości wraz z ich kluczami i względnymi ścieżkami do plików

package/docs/pl/cli/list_projects.md

@@ -0,0 +1,130 @@
+---
+createdAt: 2025-12-30
+updatedAt: 2026-01-06
+title: Lista projektów Intlayer
+description: Dowiedz się, jak wypisać wszystkie projekty Intlayer w katalogu lub repozytorium git.
+keywords:
+  - Lista
+  - Projekty
+  - CLI
+  - Intlayer
+  - Git
+slugs:
+  - doc
+  - concept
+  - cli
+  - list-projects
+history:
+  - version: 7.5.12
+    date: 2026-01-06
+    changes: Dodaj opcję wyjścia bezwzględnego do polecenia list projects
+---
+
+# Lista projektów Intlayer
+
+```bash
+npx intlayer projects list
+```
+
+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.
+
+## Aliasy:
+
+- `npx intlayer projects-list`
+- `npx intlayer pl`
+
+## Argumenty:
+
+- **`--base-dir [path]`**: Określ katalog bazowy, od którego ma się rozpocząć wyszukiwanie. Domyślnie używany jest bieżący katalog roboczy.
+
+  > Przykład: `npx intlayer projects list --base-dir /path/to/workspace`
+
+  > Przykład: `npx intlayer projects list --base-dir /path/to/workspace`
+
+- **`--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.
+
+  > Przykład: `npx intlayer projects list --git-root`
+
+- **`--json`**: Wyświetla wyniki jako JSON zamiast sformatowanego tekstu. Przydatne do skryptów i dostępu programowego.
+
+  > Przykład: `npx intlayer projects list --json`
+
+- **`--absolute`**: Wyświetla wyniki jako ścieżki bezwzględne zamiast ścieżek względnych.
+
+  > Przykład: `npx intlayer projects list --absolute`
+
+## Jak to działa:
+
+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:
+
+- `intlayer.config.ts`
+- `intlayer.config.js`
+- `intlayer.config.json`
+- `intlayer.config.cjs`
+- `intlayer.config.mjs`
+- `.intlayerrc`
+
+Każdy katalog zawierający jeden z tych plików jest uznawany za projekt Intlayer i zostanie wypisany w wynikach.
+
+## Przykłady:
+
+### Wypisz projekty w bieżącym katalogu:
+
+```bash
+npx intlayer projects list
+```
+
+### Lista projektów w określonym katalogu:
+
+```bash
+npx intlayer projects list --base-dir ./packages
+```
+
+### Wyświetl wszystkie projekty w repozytorium git:
+
+```bash
+npx intlayer projects list --git-root
+```
+
+### Użycie aliasu skrótu:
+
+```bash
+npx intlayer pl --git-root
+```
+
+### Wyjście jako JSON:
+
+```bash
+npx intlayer projects list --json
+```
+
+## Przykładowe wyjście:
+
+### Sformatowane wyjście:
+
+```bash
+$ npx intlayer projects list --git-root
+
+Found 3 Intlayer project(s):
+
+  - /Users/user/workspace/packages/app
+  - /Users/user/workspace/packages/admin
+  - /Users/user/workspace/packages/shared
+```
+
+### Wyjście JSON:
+
+```bash
+$ npx intlayer projects list --json
+
+["/Users/user/workspace/packages/app","/Users/user/workspace/packages/admin","/Users/user/workspace/packages/shared"]
+```
+
+## Zastosowania:
+
+- **Zarządzanie monorepo**: Odkryj wszystkie projekty Intlayer w strukturze monorepo
+- **Wykrywanie projektów**: Znajdź wszystkie projekty korzystające z Intlayer w workspace
+- **CI/CD**: Weryfikacja projektów Intlayer w zautomatyzowanych workflowach
+- **Dokumentacja**: Generuj dokumentację zawierającą listę wszystkich projektów używających Intlayer
+
+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

@@ -77,6 +77,26 @@ Aby zintegrować z Vite + React, zapoznaj się z [przewodnikiem instalacji](http
 
 ## Konfiguracja
 
+Uruchom następujące polecenie, aby zalogować się do Intlayer CMS:
+
+```bash packageManager="npm"
+npx intlayer login
+```
+
+```bash packageManager="yarn"
+yarn intlayer login
+```
+
+```bash packageManager="pnpm"
+pnpm intlayer login
+```
+
+```bash packageManager="bun"
+bunx intlayer login
+```
+
+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.
+
 W pliku konfiguracyjnym Intlayer możesz dostosować ustawienia CMS:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/pl/intlayer_with_next-i18next.md

@@ -593,7 +593,6 @@ const config: IntlayerConfig = {
   },
   plugins: [
     syncJSON({
-      format: "i18next",
       source: ({ locale }) => `./locales/${locale}.json`,
     }),
   ],

package/docs/pl/intlayer_with_nextjs_14.md

@@ -105,6 +105,34 @@ bunx intlayer init
 
 ### Krok 2: Skonfiguruj swój projekt
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Utwórz plik konfiguracyjny, aby skonfigurować języki swojej aplikacji:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/pl/intlayer_with_nextjs_15.md

@@ -128,6 +128,34 @@ bunx intlayer init
 
 ### Krok 2: Skonfiguruj swój projekt
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── middleware.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Utwórz plik konfiguracyjny, aby skonfigurować języki swojej aplikacji:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"

package/docs/pl/intlayer_with_nextjs_16.md

@@ -104,6 +104,34 @@ bunx intlayer init
 
 ### Krok 2: Skonfiguruj swój projekt
 
+Here is the final structure that we will make:
+
+```bash
+.
+├── src
+│   ├── app
+│   │   ├── [locale]
+│   │   │   ├── layout.tsx            # Locale layout for the Intlayer provider
+│   │   │   ├── page.content.ts
+│   │   │   └── page.tsx
+│   │   └── layout.tsx                # Root layout for style and global providers
+│   ├── components
+│   │   ├── client-component-example.content.ts
+│   │   ├── ClientComponentExample.tsx
+│   │   ├── LocaleSwitcher
+│   │   │   ├── localeSwitcher.content.ts
+│   │   │   └── LocaleSwitcher.tsx
+│   │   ├── server-component-example.content.ts
+│   │   └── ServerComponentExample.tsx
+│   └── proxy.ts
+├── intlayer.config.ts
+├── next.config.ts
+├── package.json
+└── tsconfig.json
+```
+
+> If you don't want locale routing, intlayer can be used as a simple provider / hook. See [this guide](https://github.com/aymericzip/intlayer/blob/main/docs/docs/en/intlayer_with_nextjs_no_locale_path.md) for more details.
+
 Utwórz plik konfiguracyjny, aby skonfigurować języki swojej aplikacji:
 
 ```typescript fileName="intlayer.config.ts" codeFormat="typescript"