Skip to content

CLI — UI 문자열 ​

extract ​

개요: ai-i18n-tools extract

includeUiLanguageEnglishNames이(가) 활성화된 경우 t("…") / i18n.t("…") 리터럴, 선택적 package.json 설명 및 선택적 번들 마스터 englishName 항목에서 strings.json을(를) 업데이트합니다(ui.uiExtractor 참조; languagesManifestPath은(는) 읽지 않음). 또한 각 블록의 ui-languages.json을(를) 다시 생성합니다. .html / .htm이(가) ui.uiExtractor.extensions에 나열된 경우 HTML에서 data-i18n / data-i18n-title / data-i18n-placeholder 마커 문자열도 캡처합니다. sourceRoots이(가) 있는 모든 ui 블록을 순회합니다. --ui-block은(는) 실행을 하나의 블록(인덱스, 설명 또는 stringsJson 경로)으로 제한합니다. LLM을 호출하지 않습니다.

참고 항목: UI 문자열 개요, 순수 HTML 앱


migrate-intlayer ​

개요: ai-i18n-tools migrate-intlayer [paths...] [--write] [--report <path>] [--content-glob <glob>] [--t-import <specifier>]

Intlayer *.content.ts 사전을 strings.json 및 플랫 로케일 파일로 가져오고, 간단한 useIntlayer / getIntlayer 호출 사이트를 t('source string')(으)로 재작성합니다. 문자열은 sourceLocale에 작성되며, 모든 언어가 가능합니다. 기본적으로 드라이 런입니다(보고서는 계속 작성됨). --write는 카탈로그를 시드하고 안전한 재작성을 적용합니다. LLM을 호출하지 않습니다.

보고서는 --write에서 남긴 모든 작업에 대한 인수인계 문서이며, 나머지 작업 순서를 정리한 단계별 TODO로 마무리됩니다: 각 수동 사이트별 구체적인 t() 또는 JSX 호출, import { t } 행, 나중에 삭제할 사전 파일 및 IntlayerProvider 잔여 파일, extract 다음 translate-ui 작업이 필요한 소스 문자열, 그리고 앱의 i18n 모듈에 붙여넣을 i18next 런타임 부트스트랩. 로케일 제어는 loadLocale뿐만 아니라 i18n.changeLanguage도 호출해야 합니다. extract은(는) 이 부트스트랩에서 가져오는 ui-languages.json을(를) 생성합니다. strings.json, 플랫 로케일 파일, ui-languages.json은(는) 수동으로 편집하지 마십시오.

주요 옵션: --write, --report, --content-glob (기본값 **/*.content.ts), --t-import

참고 항목: Intlayer에서 마이그레이션


translate-intlayer ​

개요: ai-i18n-tools translate-intlayer [paths...] [-l <codes>] [--ui-block <selector>] [--dry-run] [-j <n>]

Intlayer *.content.ts 사전 내에서 누락되거나 오래된 로케일 리프를 제자리에서 번역하고, 사전을 신뢰할 수 있는 단일 출처로 유지합니다. migrate-intlayer와 달리, 이 기능은 앱을 Intlayer에서 이전하지 않고 t({ … }) 리프만 채웁니다. 런타임에 Intlayer를 유지하고 ai-i18n-tools를 번역 엔진으로 사용하려는 경우에 사용하세요.

모든 t({ … }) 리프를 추출하고, 선택된 UI 블록의 strings.json을(를) 원본 텍스트로 채우며, translate-ui와(과) 동일한 엔진(공급자 선택, 용어집, 번역 컨텍스트, 모델 대체)을 실행한 다음, 새로운 로케일별 문자열을 각 t({ … }) 객체에 다시 기록합니다. 편집은 정확합니다. 누락되었거나 오래된 로케일 라인만 변경되므로, 서식과 주석은 보존됩니다. Intlayer {token} 플레이스홀더는 번역을 위해 {{token}}(으)로 왕복합니다.

리프+로케일은 리프에 로케일이 없거나(누락), 해당 로케일에 대한 마지막 실행 이후 소스 로케일 텍스트가 변경된 경우(오래됨) 번역됩니다. 오래된 상태는 cacheDir에서 추적되므로, 해당 소스 문자열을 편집하면 다음 실행 시 해당 리프 하나가 다시 번역됩니다. 소스 언어는 sourceLocale이며 모든 언어가 가능합니다. --dry-run는 LLM을 호출하거나 아무것도 쓰지 않고 누락/오래된 항목의 수를 보고합니다. features.translateUIStrings 및 UI 블록의 stringsJson(translate-ui와 동일)가 필요합니다.

주요 옵션: -l / --locale, --ui-block, --dry-run, -j / --concurrency

[paths...]: 스캔할 파일/디렉터리/글롭 (기본값: 블록의 sourceRoots). -l / --locale: 채울 쉼표로 구분된 대상 로케일 (기본값: 블록에 구성된 targetLocales). --ui-block: 0부터 시작하는 인덱스, 설명 또는 stringsJson 경로 (기본값: 블록 0). -j는 로케일을 병렬화합니다.

참고 항목: migrate-intlayer, Intlayer에서 마이그레이션


mark-html ​

개요: ai-i18n-tools mark-html [paths...] [--write]

소스 텍스트가 한 번만 작성되도록(요소 자체에) HTML에 단순 data-i18n / data-i18n-title / data-i18n-placeholder 마커를 삽입합니다. 지정된 파일/디렉터리/글롭을 스캔합니다(기본값: 모든 블록의 sourceRoots 아래 .html / .htm). 기본적으로 드라이 런을 수행하며(파일별 추가 횟수 및 수동 <span data-i18n>이(가) 필요한 혼합 콘텐츠 요소 보고), --write은(는) 변경 사항을 적용합니다. 멱등성을 유지하며 data-i18n-ignore을(를) 준수하고(요소와 해당 하위 트리 건너뛰기), 코드 유사 요소(code, pre, kbd, samp, var)나 비어 있거나 숫자로만 이루어진 텍스트는 건드리지 않으며, 값이 있는 마커를 내보내지 않습니다. LLM을 호출하지 않습니다.

주요 옵션: --write

참고 항목: 번역을 위한 HTML 마킹


generate-ui-languages ​

개요: ai-i18n-tools generate-ui-languages [--master <path>] [--dry-run]

sourceLocale + targetLocales 및 번들된 data/ui-languages-complete.json(또는 --master)를 사용하여 ui-languages.json을(를) languagesManifestPath(기본값: {ui.flatOutputDir}/ui-languages.json)에 씁니다. 마스터 파일에 없는 로케일에 대해 경고를 표시하고 TODO 자리 표시자를 생성합니다. 사용자 지정된 label 또는 englishName 값이 있는 기존 매니페스트가 있는 경우, 마스터 카탈로그 기본값으로 대체됩니다 — 생성된 파일을 이후에 검토하고 조정하십시오.

주요 옵션: --master, --dry-run


translate-ui ​

개요: ai-i18n-tools translate-ui [-l <codes>] [--force] [--dry-run] [-j <n>]

UI 문자열만 번역합니다(strings.json → 로케일 JSON). features.translateUIStrings이(가) 필요합니다.

주요 옵션: -l / --locale, --force, --dry-run, -j / --concurrency

-l / --locale: 쉼표로 구분된 대상 로케일(기본값: 구성 targetLocales에서 sourceLocale 제외). --force: 로케일별로 모든 항목을 다시 번역(기존 번역 무시). --dry-run: 쓰기 없음, API 호출 없음. -j은 로케일을 병렬화하며, 각 로케일 내에서 구성 uiBatchConcurrency(기본값 2)은 LLM 배치(50개 문자열 청크, 그 다음 복수 그룹)를 병렬화합니다. uiBatchConcurrency에 대한 CLI 플래그는 없습니다. 각 성공적인 배치는 다음 배치가 시작되기 전에 strings.json 및 플랫 로케일 파일에 기록됩니다. sync-ui과 sync의 UI 단계는 동일한 쓰기를 사용합니다.

플레이스홀더가 원본과 일치하지 않는 저장된 번역은 다시 번역됩니다. 이 검사는 이름 변경 ({schedule}이(가) {cronograma}(으)로 변경됨), 누락되거나 새로 생성된 토큰, 그리고 형식 지정 변경 ({price:,.2f}이(가) {price}(으)로 변경됨)을 포함합니다. 개수는 배치 전에 인쇄되며, --dry-run에도 포함됩니다. 모델이 user-edited인 행은 그대로 유지되며 경고만 표시됩니다. {state} · {title}과 같이 플레이스홀더와 구두점으로만 구성된 문자열은 복사되며 모델로 전송되지 않습니다. 플레이스홀더의 이름을 변경하는 배치는 거부되며, 해당 오류가 추가된 상태로 체인의 다음 모델이 시도됩니다. 대시보드는 동일한 행에 플래그를 지정하고, 플레이스홀더를 손상시키는 번역을 저장하기 전에 확인을 요청합니다.


sync-ui ​

개요: ai-i18n-tools sync-ui [-l <codes>] [--force] [--dry-run] [-j <n>]

UI 문자열을 추출한 다음 번역합니다(features.translateUIStrings 필요). UI 전용 — 문서, SVG 또는 json[]은(는) 제외됩니다. translate-ui과(와) 동일한 -l, --force, --dry-run, -j 옵션을 사용합니다.


proofread-ui ​

개요: ai-i18n-tools proofread-ui [-l <code>] [--chunk <n>] [--dry-run] [--json] [-j <n>]

extract을(를) 먼저 실행하여 (features.translateUIStrings 필요) 선택된 각 카탈로그가 소스와 일치하도록 한 다음, 소스 로케일 UI 문자열에 대한 LLM 검토(철자, 문법)를 수행합니다. --ui-block는 추출 및 검토를 하나의 블록으로 제한합니다. 용어 힌트는 glossary.userGlossary CSV에서만 제공됩니다 (translate-ui와 동일한 범위 — UI 카탈로그는 다시 피드백되지 않으므로 잘못된 복사본이 용어로 강화되지 않습니다). 활성 LLM 공급자(해당 API 키 환경 변수)를 사용합니다.

실패 시(기능 플래그 누락, 추출 실패, 카탈로그 누락 또는 유효하지 않음, API 키 누락, 모든 배치 실패) 1로 종료하고, 실행이 성공적으로 완료되면(결과는 권고 사항) 0으로 종료합니다. cacheDir 아래에 proofread-ui-results_<timestamp>.log을(를) 사람이 읽을 수 있는 보고서(요약, 문제, 검토되지 않은 행, 문자열별 정상 행)로 작성합니다. 터미널에는 요약 개수와 문제만 출력되며(문자열당 [ok] 줄은 출력되지 않음), 실패한 배치나 배치보다 짧고 각 슬롯에 사용 가능한 index이(가) 없는 모델 응답의 경우 해당 문자열은 검토되지 않은 것으로 처리됩니다. 짧은 배열이 잘못된 문자열에 적용되는 것을 방지하기 위해 해당 문제는 삭제됩니다. 마지막 줄에 로그 파일 이름을 출력합니다. --json을(를) 사용하면 사용자 친화적 형식의 출력이 stderr로 전송됩니다. 링크는 대시보드 UI 문자열 링크 버튼과 마찬가지로 path:line을(를) 사용합니다.

주요 옵션: -l / --locale, --chunk (기본값 50), --dry-run, --json, -j / --concurrency


export-ui-xliff ​

개요: ai-i18n-tools export-ui-xliff [-l <codes>] [-o <dir>] [--untranslated-only] [--dry-run]

strings.json을(를) XLIFF 2.0으로 내보냅니다(대상 로케일당 하나의 .xliff). 읽기 전용이며 API는 없습니다.

주요 옵션: -l / --locale, -o / --output-dir, --untranslated-only, --dry-run

-o / --output-dir: 출력 디렉터리(기본값: 카탈로그와 동일한 폴더). --untranslated-only: 해당 로케일에 대한 번역이 누락된 단위만 해당합니다.

MIT 라이선스에 따라 배포됩니다.