Skip to content

ai-i18n-tools란 무엇인가요? ​

앱, 웹사이트, 문서 사이트 또는 저장소 README가 하나의 언어로 되어 있고 더 많은 언어를 추가하고 싶을 수 있습니다. 이 언어는 sourceLocale이며 어떤 언어든 될 수 있습니다. 이 가이드에서는 영어가 일반적인 예입니다. ai-i18n-tools는 텍스트를 찾고, 선택한 LLM 제공업체의 모델로 번역한 다음, 프로젝트가 이미 로드하는 파일에 작성합니다. 모든 결과를 캐시하므로 다시 실행할 때는 새 텍스트나 변경된 텍스트만 모델로 전송합니다.

당신이 하는 일과 도구가 하는 일 ​

사용자도구
시도할 언어, 제공업체, 모델 선택텍스트 추출, 번역, 결과 검증, 카탈로그 또는 페이지 작성
사용자에게 표시되는 텍스트를 도구에 노출: 앱 코드의 t() 호출, 사이트용 프레임워크 자체 i18n 또는 README의 언어 목록 마커번역을 캐시하고 매 재실행 시 재사용합니다
결과를 앱, 사이트 라우팅 또는 README의 언어 행에 연결합니다.진행 상황을 표시하고 대시보드에서 번역을 검토할 수 있도록 합니다.

이 도구는 --write와 함께 migrate-python-i18n 또는 migrate-dotnet-i18n을(를) 실행하지 않는 한 소스를 다시 작성하지 않습니다. 래핑 단계에 대한 코딩 에이전트 프롬프트가 제공됩니다. 이 도구는 i18next 또는 사이트 프레임워크의 i18n을 설치하지 않으며, 이를 위한 런타임 헬퍼가 제공되더라도 언어 전환기를 빌드하지 않습니다.

어디서부터 시작해야 하나요? ​

둘러보기는 프로젝트에 i18n 추가하기에 그룹화되어 있으며, 공통 설정과 각 프로젝트 종류별 페이지가 있습니다. 행을 선택하세요.

보유한 프로젝트시작 위치
소스에 일반 텍스트가 있는 JS/TS 앱(React, Next.js, Node, CLI)JS/TS 앱에 i18n 추가하기
파이썬 앱 (스트림릿, FastAPI, 플라스크, 데스크톱, 스크립트)파이썬 앱에 i18n 추가
.NET 앱(Avalonia, WPF, MAUI, ASP.NET, Blazor, 콘솔).NET 앱에 i18n 추가
이미 ResourceManager 또는 IStringLocalizer을(를) 사용하는 .NET 앱.NET ResourceManager 앱에 i18n 추가
Django 앱, Flask-Babel 카탈로그, 또는 이미 GNU gettext를 사용하는 앱Django / 파이썬 gettext 앱에 i18n 추가
웹사이트 또는 문서 사이트(VitePress, Docusaurus, Starlight, Nextra, Fumadocs, Astro, 일반 HTML)웹사이트 또는 문서 사이트에 i18n 추가하기
리포지토리 README 및 기타 Markdown 파일(보통 앱 옆에 위치)README 및 Markdown 문서에 i18n 추가하기
독립형 중첩 JSON 로케일 파일JSON
텍스트 레이블이 있는 SVG 다이어그램SVG 번역
Intlayer 사전(Intlayer에서 마이그레이션)Intlayer에서 마이그레이션하기
Intlayer 사전(Intlayer 유지, 인플레이스 번역)Intlayer 인플레이스 번역하기

작동 방식 ​

  1. CLI를 설치하고 제공업체의 API 키를 설정합니다: 설치.
  2. init를 실행하여 ai-i18n-tools.config.json를 작성합니다: 빠른 시작.
  3. 프로젝트 준비: 문자열을 t()로 래핑하거나, 사이트 프레임워크의 i18n을 활성화하거나, README에 언어 목록 마커를 추가합니다.
  4. sync를 실행합니다. 텍스트를 추출하고, 새로운 내용을 번역하고, 출력을 작성합니다.
  5. 앱이나 사이트에서 출력을 로드하고, 언어 전환기를 추가하고, 소스가 변경되면 sync를 다시 실행합니다.

번역 모드 ​

내부적으로 이 도구는 네 개의 파이프라인을 실행합니다. 구성에서 필요한 파이프라인을 활성화하면 sync가 순서대로 실행합니다.

  • UI 문자열 — JS/TS 및 Python에서 t("…") 및 _() 호출을, C# 및 XAML에서 T("…") / {loc:Tr '…'}을(를) 추출하고 (GNU gettext 및 .NET .resx 위성 포함) 로케일별 플랫 JSON, .po / .mo 또는 .resx을(를) 작성합니다. 명령: extract, translate-ui, migrate-dotnet-i18n. 가이드: UI 문자열. Python: Python 애플리케이션. .NET: .NET 애플리케이션 및 .NET ResourceManager 앱에 i18n 추가.
  • 문서 — docs[].contentPaths에 나열된 Markdown, MDX 및 .astro 페이지를 번역합니다. VitePress, Starlight, Docusaurus, Nextra, Fumadocs, Astro 및 기타 정적 문서 사이트와 리포지토리 README(flat의 docsOutput.style)에서 작동합니다. 명령: translate-docs. 가이드: 문서 및 README 및 Markdown 문서에 i18n 추가.
  • JSON — 최상위 json[]에 정의된 중첩 JSON 로케일 번들(테마 레이블, i18n 재정의, 소스에 없는 앱 텍스트)을 번역합니다. 명령: translate-json. 가이드: JSON.
  • SVG — SVG 일러스트레이션(<text>, <title>, <desc>) 내의 보이는 텍스트를 번역하고 로케일당 하나의 출력 파일을 작성합니다. 문서 번역과는 별개입니다. 명령: translate-svg. 가이드: SVG 번역.

많은 프로젝트가 모드를 결합합니다. 일반적인 조합은 UI 문자열과 리포지토리 README입니다. VitePress와 같은 문서 사이트도 자주 사용되는 또 다른 조합입니다. 파이프라인 결합 및 README 및 Markdown 문서에 i18n 추가를 참조하세요.

예시 ​

리포지토리는 examples/ 아래에 실행 가능한 예제 프로젝트를 제공하며, 각 프로젝트에는 자체 구성, 커밋된 로케일 출력 및 README가 있습니다. API 키 없이 번역된 파일을 탐색할 수 있으며, 번역을 다시 실행하려면 공급자 키가 필요합니다.

프로젝트 유형예제
JS/TS 앱console-app, nextjs-app
앱과 함께 있는 리포지토리 READMEconsole-app, nextjs-app
Python 앱python-streamlit, python-fastapi, python-gettext
.NET 헬퍼dotnet-console, dotnet-resx
문서 사이트docusaurus-docs, vitepress-docs, astro-docs
웹사이트 또는 일반 HTMLastro-website, plain-html

전체 목록과 npx degit 복사 명령은 예제를 참조하세요.

다음 단계 ​

  1. 설치 — npm 패키지를 설치하거나 Python 프로젝트의 경우 독립 실행형 파일을 다운로드하고 공급자 API 키를 설정합니다.
  2. 빠른 시작 — 구성을 스캐폴드하고 첫 번역을 실행합니다.
  3. LLM 공급자 — 공급자, API 키 및 -P 재정의를 선택합니다.
  4. AI 모델 — suggest-models 또는 대시보드 모델 탭을 사용하여 후보 목록의 순위를 지정하고, 번역 실패 시 다음 모델을 시도할 수 있도록 여러 모델을 유지합니다.

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