Skip to content

빠른 시작 ​

이 페이지는 단일 언어 프로젝트가 첫 번역 파일을 생성하도록 안내합니다. 이 페이지는 JS/TS 앱, Python 앱, .NET 앱, 웹사이트 또는 문서 사이트, 또는 저장소 README 및 기타 Markdown 파일에 해당합니다. 다음을 가정합니다:

  • Node.js >=22.16.0, 또는 Python 또는 .NET 프로젝트용 독립 실행 파일.
  • LLM 제공업체용 API 키, 또는 로컬 Ollama 설치.
  • 프로젝트가 버전 제어 중이므로 도구가 작성하는 내용을 검토할 수 있습니다.

프로젝트마다 두 가지가 다릅니다. 도구가 텍스트를 찾는 방법과 앱이 결과를 로드하는 방법입니다. 아래의 경로 선택에서 해당 가이드로 이동할 수 있습니다.

실행 가능한 예제 ​

완성된 프로젝트를 먼저 살펴보고 싶으신가요? 저장소를 복제하지 않고 하나를 복사하세요:

bash
npx degit wsj-br/ai-i18n-tools/examples/console-app console-app
cd console-app
pnpm install
pnpm run i18n:sync

console-app을(를) 다른 Node.js 예제로 바꾸세요. Python 및 .NET 예제에는 package.json이(가) 없습니다. 동일한 방식으로 복사하세요. 네 가지 Python 예제는 GitHub 릴리스의 ai-i18n-tools-python-examples.zip에도 있으며, 두 가지 .NET 예제는 ai-i18n-tools-dotnet-examples.zip에 있습니다. 각 예제가 무엇을 보여주는지에 대한 전체 목록은 예제 페이지에 있습니다.

설치 ​

bash
pnpm add -D ai-i18n-tools

npm install --save-dev ai-i18n-tools 및 yarn add --dev ai-i18n-tools도 작동합니다. Python 및 .NET 프로젝트는 독립 실행 파일을 설치하며 Node.js가 필요하지 않습니다. Linux 및 macOS: curl -fsSL https://raw.githubusercontent.com/wsj-br/ai-i18n-tools/main/install.sh | bash. Windows PowerShell: irm https://raw.githubusercontent.com/wsj-br/ai-i18n-tools/main/install.ps1 | iex. 다른 설치 옵션: 설치.

공급자 및 API 키 ​

LLM을 호출하는 모든 명령어(translate-ui, translate-docs, translate-json, translate-svg, sync)에는 다음 두 가지가 모두 필요합니다.

  1. ai-i18n-tools.config.json에 하나 이상의 공급자: translationModels가 포함된 providers.<name> 블록, 그리고 둘 이상의 공급자가 구성된 경우 최상위 provider 키가 필요합니다. init -P <provider>는 해당 사전 설정을 구성합니다. 공급자를 추가하려면 LLM 공급자를 참조하세요. 모델 목록을 선택하려면 AI 모델을 참조하세요.
  2. 환경에 있는 일치하는 API 키, 또는 공급자 API 키가 아직 설정되지 않은 경우 ai-i18n-tools.config.json 옆의 .env / .env.local에 있는 API 키가 필요합니다. 각 내장 사전 설정은 사전 설정 표에서 명명된 변수를 읽습니다. 예를 들어 OPENROUTER_API_KEY은 -P openrouter를, OPENAI_API_KEY은 -P openai을 읽습니다. Ollama는 로컬 엔드포인트를 사용하므로 키가 필요하지 않습니다.
bash
export OPENROUTER_API_KEY=sk-or-v1-your-key-here

LLM을 호출하지 않는 extract, status 및 기타 명령어에는 둘 다 필요하지 않습니다. 환경 파일 및 PATH에 대한 자세한 내용: 설치.

경로 선택 ​

해당하는 항목을 찾아 해당 블록의 명령어를 실행한 다음, 연결된 가이드에서 계속 진행하세요.

JS/TS 앱 ​

버튼과 메시지가 아직 소스에 일반 텍스트로 되어 있어 도구가 아직 찾을 것이 없습니다. 먼저 t()으로 래핑해야 하며, 앱에는 작은 i18next 설정 파일이 필요합니다.

bash
ai-i18n-tools init -P openrouter
ai-i18n-tools suggest-models --apply

그런 다음 JS/TS 앱에 i18n 추가를 따르세요. 이 가이드에서는 extract 및 translate-ui 전에 에이전트 프롬프트를 사용하여 래핑하는 단계를 다룹니다.

Python 앱 ​

bash
ai-i18n-tools init -t ui-python -P openrouter
ai-i18n-tools suggest-models --apply

그 다음 파이썬 앱에 i18n 추가를 따르세요.

Django 앱, Flask-Babel 카탈로그를 사용하는 Flask, 또는 이미 gettext를 호출하는 앱은 해당 호출을 유지합니다. 대신 ui-python-django, ui-python-flask, 또는 ui-python-gettext로 스캐폴딩한 다음 Django / Python gettext 앱에 i18n 추가를 따르세요.

.NET 앱 ​

bash
ai-i18n-tools init -t ui-dotnet -P openrouter
ai-i18n-tools suggest-models --apply

그런 다음 .NET 앱에 i18n 추가를 따르세요. 이미 ResourceManager 또는 IStringLocalizer을(를) 사용하는 앱은 대신 ui-dotnet-resx을(를) 사용한 다음 .NET ResourceManager 앱에 i18n 추가를 따릅니다. migrate-dotnet-i18n은(는) T($"…")을(를) 번호가 매겨진 {0} 호출로 다시 작성합니다. --wrap은(는) 표시되지 않은 XAML 및 C# 레이블을 감사합니다. 보고서는 Resources.LoginButton과(와) 같은 명명된 resx 키를 제안으로 나열하며 해당 줄을 편집하지 않습니다.

웹사이트 또는 문서 사이트 ​

프레임워크에 맞는 템플릿을 선택하세요:

사이트템플릿
Astro Starlightui-starlight
Docusaurusui-docusaurus
VitePressui-vitepress
Nextraui-nextra
Fumadocsui-fumadocs
일반 Astro 웹사이트ui-astro-website
일반 HTML 페이지ui-plain-html 또는 docs-plain-html
bash
ai-i18n-tools init -t ui-vitepress -P openrouter

그 다음 웹사이트 또는 문서 사이트에 i18n 추가를 따르세요. 해당 에이전트 프롬프트는 프레임워크의 i18n 라우팅을 활성화합니다. 해당 작업을 검토한 후 sync를 실행합니다.

README 또는 Markdown 문서 ​

대부분의 리포지토리는 앱과 함께 이를 원합니다. 기본 ui-markdown 템플릿에는 이미 플랫 README 블록이 포함되어 있습니다. 다른 템플릿의 경우 --with-readme을 추가하세요. Markdown만 있는 리포지토리는 docs-markdown를 사용합니다.

bash
ai-i18n-tools init -P openrouter
ai-i18n-tools init -t ui-python -P openrouter --with-readme
ai-i18n-tools init -t ui-dotnet -P openrouter --with-readme
ai-i18n-tools init -t docs-markdown -P openrouter

그런 다음 README 및 Markdown 문서에 i18n 추가를 따르세요. 언어 목록 마커를 sync 앞에 있는 README.md에 붙여넣으세요. 앱 경로가 있는 경우, 여전히 JS/TS 앱에 i18n 추가, Python 앱에 i18n 추가, 또는 .NET 앱에 i18n 추가입니다.

기타 ​

모든 init 옵션을 포함한 전체 템플릿 목록은 CLI 설정 참조에 있습니다.

실행 및 확인 ​

프로젝트가 준비되면:

bash
ai-i18n-tools doctor
ai-i18n-tools sync
ai-i18n-tools status

doctor는 구성, 경로, 공급자 및 환경이 준비되었는지 확인합니다. --local를 전달하지 않는 한, 공급자와 함께 모델 ID를 확인합니다. sync는 구성에서 활성화된 모든 단계를 순서대로 실행합니다. status는 로케일별로 번역된 내용을 보여줍니다. 도구가 텍스트를 볼 수 없는 프로젝트에서 첫 실행은 오류 없이 완료되며 유용한 내용을 작성하지 않습니다. 따라서 status에 문자열이 표시되지 않으면 경로에 대한 가이드로 돌아가십시오.

suggest-models는 게시된 벤치마크를 기준으로 활성 공급자의 채팅 모델 순위를 매깁니다. suggest-models --apply은 translationModels를 대체하고 uiModels 및 localeModels는 그대로 둡니다. 동일한 순위가 대시보드 모델 탭에 있습니다. 순위가 작동하는 방식과 목록에 둘 이상의 모델이 포함된 이유에 대한 설명은 AI 모델을 참조하세요. 명령어 참조: suggest-models.

번역 유지 ​

소스 텍스트가 변경될 때마다 sync를 다시 실행하세요. SQLite 캐시는 새 텍스트나 변경된 텍스트만 모델로 전송된다는 것을 의미하므로 재실행 비용이 저렴합니다. CI에서 sync를 실행하면 번역이 틀어지는 것을 방지할 수 있습니다. ai-i18n-tools dashboard는 캐시된 번역을 검토하고 편집할 수 있는 번역 대시보드를 엽니다.

권장 package.json 스크립트 ​

패키지가 로컬에 설치된 경우 스크립트는 추가적인 셸 설정 없이 node_modules/.bin에서 ai-i18n-tools을(를) 확인합니다. 대화형 셸의 경우 먼저 PATH를 구성하세요. CLI 사용을(를) 참조하세요.

json
{
  "i18n:extract": "ai-i18n-tools extract",
  "i18n:sync": "ai-i18n-tools sync",
  "i18n:translate:ui": "ai-i18n-tools translate-ui",
  "i18n:translate:svg": "ai-i18n-tools translate-svg",
  "i18n:translate:docs": "ai-i18n-tools translate-docs",
  "i18n:translate:json": "ai-i18n-tools translate-json",
  "i18n:status": "ai-i18n-tools status",
  "i18n:statistics": "ai-i18n-tools statistics",
  "i18n:dashboard": "ai-i18n-tools dashboard",
  "i18n:cleanup": "ai-i18n-tools cleanup"
}

개별 번역 스크립트를 연결하는 것보다 sync을(를) 사용하는 것이 좋습니다. 단일 단계 스크립트는 한 단계만 단독으로 필요할 때만 사용하세요.

CLI 출력 및 대시보드를 다른 언어로 표시하려면 -L <code>를 전달하거나 AI_I18N_LANG를 설정하세요. 자세한 내용은 도구 UI 언어를 참조하세요.

앱 문자열과 문서 사이트처럼 두 가지 이상의 콘텐츠를 함께 번역하시나요? 파이프라인 결합을(를) 참조하세요.

다음: 경로 선택 아래에서 자신의 경로에 맞는 가이드를 확인하세요.

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