@intlayer/docs 7.4.0 → 7.5.0-canary.1

package/docs/ko/cli/login.md

@@ -0,0 +1,188 @@
+---
+createdAt: 2025-12-16
+updatedAt: 2025-12-16
+title: CLI - 로그인
+description: Intlayer CLI의 login 명령을 사용하여 Intlayer CMS에 인증하고 액세스 자격증명을 얻는 방법을 알아보세요.
+keywords:
+  - CLI
+  - Login
+  - Authentication
+  - CMS
+  - Intlayer
+  - Credentials
+slugs:
+  - doc
+  - concept
+  - cli
+  - login
+---
+
+# Intlayer CLI 로그인 명령
+
+---
+
+## 설명
+
+`login` 명령은 Intlayer CLI에서 Intlayer CMS에 인증할 수 있게 해줍니다. 이 명령은 기본 브라우저를 자동으로 열어 인증 절차를 완료하고 Intlayer 서비스를 사용하기 위한 필요한 자격증명(Client ID 및 Client Secret)을 수신합니다.
+
+## 사용법
+
+```bash
+npx intlayer login [options]
+```
+
+또는
+
+```bash
+intlayer login [options]
+```
+
+## 옵션
+
+### `--cms-url <url>`
+
+인증을 위해 연결할 Intlayer CMS의 URL을 지정합니다.
+
+- **타입**: `string`
+- **기본값**: `intlayer.config.*`에 설정된 값 또는 `https://intlayer.org`
+- **예제**:
+
+```bash
+npx intlayer login --cms-url https://intlayer.org
+```
+
+### 구성 옵션
+
+일반적인 구성 옵션도 사용할 수 있습니다:
+
+- `--env-file <path>`: 환경 파일의 경로
+- `-e, --env <env>`: 실행 환경
+- `--base-dir <dir>`: 프로젝트의 기본 디렉터리
+- `--verbose`: 자세한 출력 활성화 (기본값: true)
+- `--prefix <prefix>`: 로그 접두사
+
+## 동작 방식
+
+1. **로컬 서버 시작**: 명령은 CMS로부터 자격증명을 수신하기 위해 무작위 포트에서 로컬 HTTP 서버를 시작합니다
+
+인증을 위해 연결할 Intlayer CMS의 URL을 지정합니다.
+
+- **형식**: `string`
+- **기본값**: `intlayer.config.*`에 구성된 값 또는 `https://intlayer.org`
+- **예제**:
+
+```bash
+npx intlayer login --cms-url https://intlayer.org
+```
+
+### 구성 옵션
+
+다음과 같은 공통 구성 옵션도 사용할 수 있습니다:
+
+- `--env-file <path>`: 환경 파일의 경로
+- `-e, --env <env>`: 실행 환경
+- `--base-dir <dir>`: 프로젝트의 기본 디렉터리
+- `--verbose`: 자세한 출력 활성화 (기본값: true)
+- `--prefix <prefix>`: 로그 접두사
+
+## 동작 방식
+
+1. **로컬 서버 시작**: 이 명령은 CMS로부터 자격증명을 수신하기 위해 임의의 포트에서 로컬 HTTP 서버를 시작합니다
+2. **브라우저 열기**: 명령어는 기본 브라우저를 자동으로 열어 CMS 로그인 URL로 이동합니다
+3. **인증**: 브라우저에서 Intlayer 계정으로 인증을 완료합니다
+4. **자격증명 수신**: 로컬 서버는 CMS로부터 Client ID 및 Client Secret을 수신합니다
+5. **지침**: 명령어가 프로젝트에서 자격증명을 구성하는 방법에 대한 지침을 표시합니다
+
+## 출력
+
+성공적으로 로그인한 후, 명령어는 다음을 표시합니다:
+
+1. **수신된 자격증명** (Client ID 및 Client Secret)
+2. **`.env` 파일에 대한 지침**:
+
+```bash
+INTLAYER_CLIENT_ID=your_client_id
+INTLAYER_CLIENT_SECRET=your_client_secret
+```
+
+3. **Intlayer 구성 파일에 대한 지침**:
+
+```typescript
+{
+  editor: {
+    cmsURL: 'https://intlayer.org',
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+}
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+}
+```
+
+## 수동 구성
+
+브라우저가 자동으로 열리지 않는 경우, 터미널에 표시된 URL을 수동으로 방문할 수 있습니다.
+
+## 예제
+
+### 사용자 정의 CMS URL로 로그인
+
+```bash
+npx intlayer login --cms-url https://custom-cms.example.com
+```
+
+### 지정된 환경 파일로 로그인
+
+```bash
+npx intlayer login --env-file .env.production
+```
+
+### Verbose 모드로 로그인
+
+```bash
+npx intlayer login --verbose
+```
+
+## 문제 해결
+
+### 브라우저가 열리지 않는 경우
+
+브라우저가 자동으로 열리지 않으면, 터미널에 표시된 URL을 복사하여 브라우저에 수동으로 붙여 넣어 열어보세요.
+
+### 연결 문제
+
+연결 문제가 발생하면 다음을 확인하세요:
+
+1. CMS URL이 올바른지
+2. 인터넷 연결이 정상인지
+3. 연결을 차단하는 방화벽이 없는지
+4. 인터넷 연결이 정상적으로 작동하는지 확인하세요
+5. 방화벽이 연결을 차단하고 있지 않은지 확인하세요
+
+### 자격 증명을 받지 못한 경우
+
+자격 증명을 받지 못한 경우:
+
+1. 브라우저에서 인증 과정을 완료했는지 확인하세요
+2. 로컬 포트가 차단되어 있지 않은지 확인하세요
+3. 명령을 다시 시도하세요
+
+## 다음 단계
+
+로그인 완료 후:
+
+1. 자격 증명을 `.env` 파일에 추가하세요
+2. 자격 증명을 사용하여 `intlayer.config.*` 파일을 구성하세요
+3. 딕셔너리 관리를 위해 CLI 명령어를 사용하세요:
+   - [`npx intlayer push`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/push.md) - 딕셔너리를 CMS에 푸시합니다
+   - [`npx intlayer pull`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/pull.md) - CMS에서 딕셔너리를 가져옵니다
+   - [`npx intlayer fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/fill.md) - 누락된 번역을 채웁니다
+   - [`npx intlayer fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/fill.md) - 누락된 번역 채우기
+
+## 참고
+
+- [CLI 문서](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/cli/index.md)
+- [Intlayer 구성](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)

package/docs/ko/configuration.md

@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 7.5.0
+    date: 2025-12-17
+    changes: `buildMode` 옵션 추가
   - version: 6.0.0
     date: 2025-09-16
     changes: `live` 가져오기 모드 추가
@@ -527,6 +530,15 @@ Intlayer가 애플리케이션의 국제화를 최적화하고 빌드하는 방
 
 #### 속성
 
+- **mode**:
+  - _타입_: `'auto' | 'manual'`
+  - _기본값_: `'auto'`
+  - _설명_: 빌드 모드를 제어합니다.
+  - _예시_: `'manual'`
+  - _참고_: 'auto'인 경우, 애플리케이션이 빌드될 때 빌드가 자동으로 활성화됩니다.
+  - _참고_: 'manual'인 경우, 빌드 명령이 실행될 때만 빌드가 설정됩니다.
+  - _참고_: 사전 빌드를 비활성화하는 데 사용할 수 있습니다. 예를 들어 Node.js 환경에서 실행을 피해야 하는 경우입니다.
+
 - **optimize**:
   - _타입_: `boolean`
   - _기본값_: `process.env.NODE_ENV === 'production'`

package/docs/ko/dictionary/content_file.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2025-09-20
+updatedAt: 2025-12-13
 title: 콘텐츠 파일
 description: 콘텐츠 선언 파일의 확장자를 사용자 정의하는 방법을 배우세요. 이 문서를 따라 프로젝트에서 조건을 효율적으로 구현하세요.
 keywords:
@@ -12,6 +12,9 @@ slugs:
   - concept
   - content
 history:
+  - version: 7.5.0
+    date: 2025-12-13
+    changes: ICU 및 i18next 형식 지원 추가
   - version: 6.0.0
     date: 2025-09-20
     changes: 필드 문서 추가
@@ -386,6 +389,46 @@ content: { /* ... */ }
 }
 ```
 
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+사전 콘텐츠에 사용할 포맷터를 지정합니다. 이를 통해 다양한 메시지 포맷팅 구문을 사용할 수 있습니다.
+
+- `'intlayer'`: 기본 Intlayer 포맷터.
+- `'icu'`: ICU 메시지 포맷팅을 사용합니다.
+- `'i18next'`: i18next 메시지 포맷팅을 사용합니다.
+
+**예시:**
+
+```typescript
+{
+  key: "my-dictionary",
+  format: "icu",
+  content: {
+    message: "Hello {name}, you have {count, plural, one {# message} other {# messages}}"
+  }
+}
+```
+
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+사전 콘텐츠에 사용할 포맷터를 지정합니다. 이를 통해 다양한 메시지 포맷팅 구문을 사용할 수 있습니다.
+
+- `'intlayer'`: 기본 Intlayer 포맷터.
+- `'icu'`: ICU 메시지 포맷팅을 사용합니다.
+- `'i18next'`: i18next 메시지 포맷팅을 사용합니다.
+
+**예시:**
+
+```typescript
+{
+  key: "my-dictionary",
+  format: "icu",
+  content: {
+    message: "Hello {name}, you have {count, plural, one {# message} other {# messages}}"
+  }
+}
+```
+
 #### `locale` (LocalesValues)
 
 사전을 각 로케일별 사전으로 변환하며, content에 선언된 각 필드는 자동으로 번역 노드로 변환됩니다. 이 속성이 설정되면:

package/docs/ko/intlayer_with_astro.md

@@ -2,7 +2,7 @@
 createdAt: 2024-03-07
 updatedAt: 2025-10-03
 title: Astro 앱 번역하는 방법 – i18n 가이드 2025
-description: Intlayer를 사용하여 Vite 및 React 애플리케이션에 국제화(i18n)를 추가하는 방법을 배우세요. 이 가이드를 따라 앱을 다국어로 만드세요.
+description: Intlayer를 사용하여 Astro 웹사이트에 국제화(i18n)를 추가하는 방법을 배우세요. 이 가이드를 따라 사이트를 다국어로 만드세요.
 keywords:
   - 국제화
   - 문서

package/docs/ko/intlayer_with_express.md

@@ -2,7 +2,7 @@
 createdAt: 2024-08-11
 updatedAt: 2025-06-29
 title: Express backend 앱 번역하는 방법 – i18n 가이드 2025
-description: vite 백엔드를 다국어로 만드는 방법을 알아보세요. 국제화(i18n)하고 번역하려면 문서를 따르세요.
+description: Express 백엔드를 다국어로 만드는 방법을 알아보세요. 국제화(i18n)하고 번역하려면 문서를 따르세요.
 keywords:
   - 국제화
   - 문서

package/docs/ko/intlayer_with_nestjs.md

@@ -2,7 +2,7 @@
 createdAt: 2025-09-09
 updatedAt: 2025-09-09
 title: Nest backend 앱 번역하는 방법 – i18n 가이드 2025
-description: Vite 백엔드를 다국어로 만드는 방법을 알아보세요. 국제화(i18n) 및 번역을 위한 문서를 따라가세요.
+description: NestJS 백엔드를 다국어로 만드는 방법을 알아보세요. 국제화(i18n) 및 번역을 위한 문서를 따라가세요.
 keywords:
   - 국제화
   - 문서

package/docs/ko/intlayer_with_next-i18next.md

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

package/docs/ko/intlayer_with_next-intl.md

@@ -419,6 +419,7 @@ const config: IntlayerConfig = {
   plugins: [
     // 네임스페이스별 폴더 구조를 Intlayer와 동기화 상태로 유지하세요
     syncJSON({
+      format: "icu",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
     }),
   ],

package/docs/ko/intlayer_with_tanstack.md

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-09-09
-updatedAt: 2025-09-09
+updatedAt: 2025-12-11
 title: Tanstack Start 앱 번역하는 방법 – i18n 가이드 2025
 description: Intlayer를 사용하여 Tanstack Start 애플리케이션에 국제화(i18n)를 추가하는 방법을 배우세요. 로케일 인식 라우팅으로 앱을 다국어 지원으로 만드는 종합 가이드를 따르세요.
 keywords:
@@ -633,17 +633,6 @@ export function NotFoundComponent() {
 }
 ```
 
-```tsx fileName="src/routes/__root.tsx"
-import { createRootRoute } from "@tanstack/react-router";
-
-// 루트 경로는 최상위 레이아웃 역할을 합니다
-// 404를 직접 처리하지 않습니다 - 이것은 자식 경로에 위임됩니다
-// 이것은 루트를 단순하게 유지하고 로케일 인식 경로가 자체 404 로직을 관리할 수 있게 합니다
-export const Route = createRootRoute({
-  component: Outlet,
-});
-```
-
 ```tsx fileName="src/routes/{-$locale}/route.tsx"
 import { createFileRoute, Outlet, redirect } from "@tanstack/react-router";
 import { validatePrefix } from "intlayer";

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

@@ -1,6 +1,6 @@
 ---
 createdAt: 2025-03-13
-updatedAt: 2025-10-05
+updatedAt: 2025-12-13
 title: Sync JSON 플러그인
 description: Intlayer 사전을 서드파티 i18n JSON 파일(i18next, next-intl, react-intl, vue-i18n 등)과 동기화합니다. 기존 i18n을 유지하면서 Intlayer를 사용하여 메시지를 관리, 번역 및 테스트할 수 있습니다.
 keywords:
@@ -24,12 +24,15 @@ slugs:
   - sync-json
 youtubeVideo: https://www.youtube.com/watch?v=MpGMxniDHNg
 history:
+  - version: 7.5.0
+    date: 2025-12-13
+    changes: ICU 및 i18next 형식 지원 추가
   - version: 6.1.6
     date: 2025-10-05
     changes: Sync JSON 플러그인 초기 문서화
 ---
 
-# Sync JSON (i18n 브리지)
+# Sync JSON (i18n 브리지) - ICU / i18next 지원이 포함된 Sync JSON
 
 <iframe title="Intlayer와 JSON 번역을 동기화 상태로 유지하는 방법" class="m-auto aspect-[16/9] w-full overflow-hidden rounded-lg border-0" allow="autoplay; gyroscope;" loading="lazy" width="1080" height="auto" src="https://www.youtube.com/embed/MpGMxniDHNg?autoplay=0&amp;origin=http://intlayer.org&amp;controls=0&amp;rel=1"/>
 
@@ -105,9 +108,27 @@ syncJSON({
   source: ({ key, locale }) => string, // 필수
   location?: string, // 선택적 레이블, 기본값: "plugin"
   priority?: number, // 충돌 해결을 위한 선택적 우선순위, 기본값: 0
+  format?: 'intlayer' | 'icu' | 'i18next', // 선택적 포맷터, 기본값: 'intlayer'
 });
 ```
 
+#### `format` ('intlayer' | 'icu' | 'i18next')
+
+JSON 파일을 동기화할 때 사전 콘텐츠에 사용할 포맷터를 지정합니다. 이를 통해 다양한 i18n 라이브러리와 호환되는 다양한 메시지 포맷팅 구문을 사용할 수 있습니다.
+
+- `'intlayer'`: 기본 Intlayer 포맷터 (기본값).
+- `'icu'`: ICU 메시지 포맷팅을 사용합니다 (react-intl, vue-i18n과 같은 라이브러리와 호환).
+- `'i18next'`: i18next 메시지 포맷팅을 사용합니다 (i18next, next-i18next, Solid-i18next와 호환).
+
+**예시:**
+
+```ts
+syncJSON({
+  source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
+  format: "i18next", // 호환성을 위해 i18next 포맷팅 사용
+}),
+```
+
 ## 여러 JSON 소스 및 우선순위
 
 여러 `syncJSON` 플러그인을 추가하여 서로 다른 JSON 소스를 동기화할 수 있습니다. 이는 프로젝트에 여러 i18n 라이브러리나 다양한 JSON 구조가 있을 때 유용합니다.
@@ -134,6 +155,7 @@ export default defineConfig({
   plugins: [
     // 주요 JSON 소스 (가장 높은 우선순위)
     syncJSON({
+      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
       location: "main-translations",
       priority: 10,
@@ -141,6 +163,7 @@ export default defineConfig({
 
     // 대체 JSON 소스 (낮은 우선순위)
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `./fallback-locales/${locale}.json`,
       location: "fallback-translations",
       priority: 5,
@@ -148,6 +171,7 @@ export default defineConfig({
 
     // 레거시 JSON 소스 (가장 낮은 우선순위)
     syncJSON({
+      format: "i18next",
       source: ({ locale }) => `/my/other/app/legacy/${locale}/messages.json`,
       location: "legacy-translations",
       priority: 1,
@@ -178,6 +202,7 @@ import { syncJSON } from "@intlayer/sync-json-plugin";
 export default {
   plugins: [
     syncJSON({
+      format: "i18next",
       source: ({ key, locale }) => `./locales/${locale}/${key}.json`,
     }),
   ],

package/docs/pl/cli/index.md

@@ -103,6 +103,10 @@ Aby zobaczyć, jak skonfigurować dostępne lokalizacje lub inne parametry, zapo
 
 ## Uruchamianie poleceń intlayer
 
+### Uwierzytelnianie
+
+- **[Logowanie](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/login.md)** - Uwierzytelnij się w Intlayer CMS i uzyskaj dane dostępowe
+
 ### Podstawowe polecenia
 
 - **[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
@@ -144,6 +148,7 @@ Aby zobaczyć, jak skonfigurować dostępne lokalizacje lub inne parametry, zapo
 
 ```json fileName="package.json"
 "scripts": {
+  "intlayer:login": "npx intlayer login",
   "intlayer:build": "npx intlayer build",
   "intlayer:watch": "npx intlayer build --watch",
   "intlayer:push": "npx intlayer push",

package/docs/pl/cli/login.md

@@ -0,0 +1,187 @@
+---
+createdAt: 2025-12-16
+updatedAt: 2025-12-16
+title: CLI - Logowanie
+description: Dowiedz się, jak użyć polecenia login w Intlayer CLI, aby uwierzytelnić się w Intlayer CMS i uzyskać dane dostępowe.
+keywords:
+  - CLI
+  - Login
+  - Authentication
+  - CMS
+  - Intlayer
+  - Credentials
+slugs:
+  - doc
+  - concept
+  - cli
+  - login
+---
+
+# Polecenie logowania Intlayer CLI
+
+---
+
+## Opis
+
+Polecenie `login` w Intlayer CLI umożliwia uwierzytelnienie w Intlayer CMS. Polecenie to automatycznie otwiera domyślną przeglądarkę, aby dokończyć proces uwierzytelniania i otrzymać niezbędne dane dostępowe (Client ID i Client Secret) do korzystania z usług Intlayer.
+
+## Użycie
+
+```bash
+npx intlayer login [options]
+```
+
+or
+
+```bash
+intlayer login [options]
+```
+
+## Opcje
+
+### `--cms-url <url>`
+
+Określa URL Intlayer CMS, z którym należy się połączyć w celu uwierzytelnienia.
+
+- **Typ**: `string`
+- **Domyślnie**: Wartość skonfigurowana w `intlayer.config.*` lub `https://intlayer.org`
+- **Przykład**:
+
+```bash
+npx intlayer login --cms-url https://intlayer.org
+```
+
+### Opcje konfiguracji
+
+Możesz także użyć standardowych opcji konfiguracji:
+
+- `--env-file <path>`: Ścieżka do pliku środowiskowego
+- `-e, --env <env>`: Środowisko wykonawcze
+- `--base-dir <dir>`: Katalog bazowy projektu
+- `--verbose`: Włącz szczegółowe logowanie (domyślnie: true)
+- `--prefix <prefix>`: Prefiks dla logów
+
+## Jak to działa
+
+1. **Uruchomienie serwera lokalnego**: Polecenie uruchamia lokalny serwer HTTP na losowym porcie, aby odebrać poświadczenia z CMS
+
+Określ URL Intlayer CMS, z którym należy się połączyć w celu uwierzytelnienia.
+
+- **Typ**: `string`
+- **Domyślna wartość**: Wartość skonfigurowana w `intlayer.config.*` lub `https://intlayer.org`
+- **Przykład**:
+
+```bash
+npx intlayer login --cms-url https://intlayer.org
+```
+
+### Opcje konfiguracyjne
+
+Możesz również użyć ogólnych opcji konfiguracyjnych:
+
+- `--env-file <path>`: Ścieżka do pliku środowiskowego
+- `-e, --env <env>`: Środowisko wykonawcze
+- `--base-dir <dir>`: Katalog główny projektu
+- `--verbose`: Włącz szczegółowe wyjście (domyślnie: true)
+- `--prefix <prefix>`: Prefiks dla logów
+
+## Jak to działa
+
+1. **Uruchomienie lokalnego serwera**: Polecenie uruchamia lokalny serwer HTTP na losowym porcie, aby odebrać dane dostępowe od CMS
+2. **Otwieranie przeglądarki**: Polecenie automatycznie otworzy domyślną przeglądarkę do adresu logowania CMS
+3. **Uwierzytelnianie**: Ukończ proces uwierzytelniania w przeglądarce, używając konta Intlayer
+4. **Odbiór poświadczeń**: Serwer lokalny otrzymuje Client ID i Client Secret od CMS
+5. **Instrukcje**: Polecenie wyświetla instrukcje konfiguracji poświadczeń w Twoim projekcie
+
+## Wyjście
+
+Po pomyślnym logowaniu polecenie wyświetli:
+
+1. **Otrzymane poświadczenia** (Client ID i Client Secret)
+2. **Instrukcje dla pliku `.env`**:
+
+```bash
+INTLAYER_CLIENT_ID=your_client_id
+INTLAYER_CLIENT_SECRET=your_client_secret
+```
+
+3. **Instrukcje dla pliku konfiguracyjnego Intlayer**:
+
+```typescript
+{
+  editor: {
+    cmsURL: 'https://intlayer.org',
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+}
+    clientId: process.env.INTLAYER_CLIENT_ID,
+    clientSecret: process.env.INTLAYER_CLIENT_SECRET,
+  },
+}
+```
+
+## Ręczna konfiguracja
+
+Jeśli przeglądarka nie otworzy się automatycznie, możesz ręcznie odwiedzić URL wyświetlony w terminalu.
+
+## Przykłady
+
+### Logowanie z niestandardowym URL CMS
+
+```bash
+npx intlayer login --cms-url https://custom-cms.example.com
+```
+
+### Logowanie z określonym plikiem środowiskowym
+
+```bash
+npx intlayer login --env-file .env.production
+```
+
+### Logowanie w trybie verbose
+
+```bash
+npx intlayer login --verbose
+```
+
+## Rozwiązywanie problemów
+
+### Przeglądarka się nie otwiera
+
+Jeśli przeglądarka nie otworzy się automatycznie, skopiuj URL wyświetlony w terminalu i otwórz go ręcznie w przeglądarce.
+
+### Problemy z połączeniem
+
+Jeśli wystąpią problemy z połączeniem, sprawdź:
+
+1. Czy adres URL CMS jest poprawny
+2. Czy połączenie internetowe działa poprawnie
+3. Czy żadne zapory sieciowe (firewalle) nie blokują połączenia
+4. Że Twoje połączenie z internetem działa poprawnie
+5. Że żadne zapory sieciowe nie blokują połączenia
+
+### Nie otrzymano poświadczeń
+
+Jeśli poświadczenia nie zostały otrzymane:
+
+1. Upewnij się, że zakończyłeś proces uwierzytelniania w przeglądarce
+2. Sprawdź, czy lokalny port nie jest zablokowany
+3. Spróbuj ponownie uruchomić polecenie
+
+## Następne kroki
+
+Po zakończeniu logowania:
+
+1. Dodaj poświadczenia do pliku `.env`
+2. Skonfiguruj plik `intlayer.config.*`, używając tych poświadczeń
+3. Użyj poleceń CLI do zarządzania słownikami:
+   - [`npx intlayer push`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/push.md) - Prześlij słowniki do CMS
+   - [`npx intlayer pull`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/pull.md) - Pobierz słowniki z CMS
+   - [`npx intlayer fill`](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/fill.md) - Wypełnij brakujące tłumaczenia
+
+## Zobacz także
+
+- [Dokumentacja CLI](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/cli/index.md)
+- [Konfiguracja Intlayer](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/configuration.md)
+- [Intlayer CMS](https://github.com/aymericzip/intlayer/blob/main/docs/docs/pl/intlayer_CMS.md)

package/docs/pl/configuration.md

@@ -14,6 +14,9 @@ slugs:
   - concept
   - configuration
 history:
+  - version: 7.5.0
+    date: 2025-12-17
+    changes: Dodano opcję `buildMode`
   - version: 7.0.0
     date: 2025-10-25
     changes: Dodano konfigurację `dictionary`
@@ -666,6 +669,15 @@ Opcje budowania dotyczą wtyczek `@intlayer/babel` oraz `@intlayer/swc`.
 
 #### Właściwości
 
+- **mode**:
+  - _Typ_: `'auto' | 'manual'`
+  - _Domyślnie_: `'auto'`
+  - _Opis_: Kontroluje tryb budowania.
+  - _Przykład_: `'manual'`
+  - _Uwaga_: Jeśli 'auto', budowanie zostanie włączone automatycznie podczas budowania aplikacji.
+  - _Uwaga_: Jeśli 'manual', budowanie zostanie ustawione tylko po wykonaniu polecenia budowania.
+  - _Uwaga_: Może być używane do wyłączenia budowania słowników, na przykład gdy należy unikać wykonywania w środowisku Node.js.
+
 - **optimize**:
   - _Typ_: `boolean`
   - _Domyślnie_: `process.env.NODE_ENV === 'production'`