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 인플레이스 번역하기 |
작동 방식
- CLI를 설치하고 제공업체의 API 키를 설정합니다: 설치.
init를 실행하여ai-i18n-tools.config.json를 작성합니다: 빠른 시작.- 프로젝트 준비: 문자열을
t()로 래핑하거나, 사이트 프레임워크의 i18n을 활성화하거나, README에 언어 목록 마커를 추가합니다. sync를 실행합니다. 텍스트를 추출하고, 새로운 내용을 번역하고, 출력을 작성합니다.- 앱이나 사이트에서 출력을 로드하고, 언어 전환기를 추가하고, 소스가 변경되면
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 |
| 앱과 함께 있는 리포지토리 README | console-app, nextjs-app |
| Python 앱 | python-streamlit, python-fastapi, python-gettext |
| .NET 헬퍼 | dotnet-console, dotnet-resx |
| 문서 사이트 | docusaurus-docs, vitepress-docs, astro-docs |
| 웹사이트 또는 일반 HTML | astro-website, plain-html |
전체 목록과 npx degit 복사 명령은 예제를 참조하세요.