사전 채우기 / 감사 / 번역

npx intlayer fill

이 명령어는 누락된 번역, 구조적 불일치 또는 타입 불일치와 같은 잠재적인 문제를 찾기 위해 콘텐츠 선언 파일을 분석합니다. 문제가 발견되면, intlayer fill은 사전을 일관되고 완전하게 유지하기 위해 업데이트를 제안하거나 적용합니다.

주요 사항:

• AI 모델의 컨텍스트 창 제한 내에서 유지하기 위해 큰 JSON 파일을 청크로 분할합니다.
• 출력 형식이 잘못된 경우 번역을 재시도합니다.
• 번역 정확도를 향상시키기 위해 애플리케이션 및 파일별 컨텍스트를 통합합니다.
• 기존 번역을 덮어쓰지 않아 기존 번역을 보존합니다.
• 큐 시스템을 사용하여 파일, 청크 및 로케일을 병렬로 처리하여 속도를 높입니다.

별칭:

• npx intlayer dictionaries fill
• npx intlayer dictionary fill
• npx intlayer dic fill

출력 예시:

npx intlayer fillPreparing Intlayer (v7.5.14)Done 76ms@intlayer/ai found - Run process locallyProvider: (default) - Model: (default) - API Key: ✓Affected dictionary keys for processing: app, comp-test, hello-world, lang-switcher - [comp-test]      No locales to fill, Skipping comp-test.content.json - [app]            Processing app.content.tsx - [app]            Filling missing metadata for app.content.tsx - [hello-world]    Processing test.content.ts - [hello-world]   [French (fr)]      Preparing test.content.ts - [hello-world]   [Spanish (es)]     Preparing test.content.ts - [lang-switcher]  Processing langSwitcher.content.ts - [lang-switcher]  Filling missing metadata for langSwitcher.content.ts - [hello-world]    Translation completed successfully for test.content.ts - [lang-switcher] [Spanish (es)]     Preparing langSwitcher.content.ts - [app]           [French (fr)]      Preparing app.content.tsx - [app]           [Spanish (es)]     Preparing app.content.tsx - [hello-world]    Content declaration written to test.content.ts - [app]            Translation completed successfully for app.content.tsx - [app]            Content declaration written to app.content.tsx - [lang-switcher]  Translation completed successfully for langSwitcher.content.ts - [lang-switcher]  Content declaration written to langSwitcher.content.ts

인자:

파일 목록 옵션:

• -f, --file [files...]: 감사할 특정 콘텐츠 선언 파일 목록입니다. 제공하지 않으면 구성 파일 설정에 따라 발견된 모든 *.content.{ts,js,mjs,cjs,tsx,jsx,json} 파일이 감사됩니다.

  예시: npx intlayer dictionary fill -f src/home/app.content.ts

• -k, --keys [keys...]: 키를 기준으로 사전을 필터링합니다. 제공하지 않으면 모든 사전이 감사됩니다.

  예시: npx intlayer dictionary fill -k key1 key2

• --key [keys...]: 키를 기준으로 사전을 필터링합니다 (--keys의 별칭).

  예시: npx intlayer dictionary fill --key key1 key2

• --excluded-keys [excludedKeys...]: 키를 기준으로 사전을 제외합니다. 제공하지 않으면 모든 사전이 감사됩니다.

  예시: npx intlayer dictionary fill --excluded-keys key1 key2

• --excluded-key [excludedKeys...]: 키를 기준으로 사전을 제외합니다 (--excluded-keys의 별칭).

  예시: npx intlayer dictionary fill --excluded-key key1 key2

• --path-filter [pathFilters...]: 파일 경로에 대한 glob 패턴을 기준으로 사전을 필터링합니다.

  예시: npx intlayer dictionary fill --path-filter "src/home/**"

엔트리 출력 옵션:

• --source-locale [sourceLocale]: 번역할 소스 로케일입니다. 지정하지 않으면 구성 파일의 기본 로케일이 사용됩니다.

• --output-locales [outputLocales...]: 번역 대상 로케일입니다. 지정하지 않으면 소스 로케일을 제외한 구성 파일의 모든 로케일이 사용됩니다.

• --mode [mode]: 번역 모드: complete, review. 기본값은 complete입니다. complete는 누락된 모든 내용을 채우고, review는 누락된 내용을 채우고 기존 키를 검토합니다.

Git 옵션:

• --git-diff: 기본 브랜치(기본값 origin/main)에서 현재 브랜치(기본값 HEAD)로 변경된 사전만 실행합니다.
• --git-diff-base: git diff의 기준 참조를 지정합니다 (기본값 origin/main).
• --git-diff-current: git diff의 현재 참조를 지정합니다 (기본값 HEAD).
• --uncommitted: 커밋되지 않은 변경 사항을 포함합니다.
• --unpushed: 푸시되지 않은 변경 사항을 포함합니다.

• --untracked: 추적되지 않은 파일을 포함합니다.

  예시: npx intlayer doc translate --git-diff --git-diff-base origin/main --git-diff-current HEAD

  예시: npx intlayer doc translate --uncommitted --unpushed --untracked

AI 옵션:

• --model [model]: 번역에 사용할 AI 모델 (예: gpt-3.5-turbo).
• --provider [provider]: 번역에 사용할 AI 제공자.
• --temperature [temperature]: AI 모델의 온도 설정.
• --api-key [apiKey]: AI 서비스에 사용할 API 키 제공.
• --custom-prompt [prompt]: 번역 지침을 위한 커스텀 프롬프트 제공.
• --application-context [applicationContext]: AI 번역에 추가 컨텍스트 제공.

• --data-serialization [dataSerialization]: Intlayer의 AI 기능에 사용할 데이터 직렬화 형식. 옵션: json (표준, 신뢰할 수 있음), toon (토큰 적음, 일관성 낮음).

  예시: npx intlayer fill --model gpt-3.5-turbo --provider openai --temperature 0.5 --api-key sk-1234567890 --application-context "My application is a cat store"

환경 변수 옵션:

• --env: 환경을 지정합니다 (예: development, production).

• --env-file [envFile]: 변수를 로드할 사용자 정의 환경 파일을 제공합니다.

  예시: npx intlayer fill --env-file .env.production.local

  예시: npx intlayer fill --env production

구성 옵션:

• --base-dir: 프로젝트의 기본 디렉토리를 지정합니다.

  예시: npx intlayer fill --base-dir ./src

• --no-cache: 캐시를 비활성화합니다.

  예시: npx intlayer build --no-cache

준비 옵션:

• --build: 푸시 전에 사전을 빌드하여 콘텐츠가 최신 상태인지 확인합니다. true는 빌드를 강제 실행하며, false는 빌드를 건너뛰고, undefined는 빌드 캐시를 사용할 수 있도록 합니다.

• --skip-metadata: 사전의 누락된 메타데이터(설명, 제목, 태그) 채우기를 건너뜁니다.

로그 옵션:

• --verbose: 디버깅을 위한 상세 로그를 활성화합니다. (CLI 기본값은 true)

예시:

npx intlayer fill --file src/home/*.content.ts --source-locale en --output-locales fr es --model gpt-3.5-turbo

이 명령어는 src/home/ 디렉토리 내 모든 콘텐츠 선언 파일에 대해 GPT-3.5 Turbo 모델을 사용하여 영어에서 프랑스어 및 스페인어로 콘텐츠를 번역합니다.