프로젝트에 i18n 추가하기
이 섹션은 현재 단일 언어를 사용하는 프로젝트를 위한 워크스루 모음입니다. 여기서 시작하세요. 아래의 각 페이지에서는 한 종류의 프로젝트를 설정부터 첫 번째 번역 파일 생성까지 안내합니다. 시작하기에서는 이 도구가 무엇인지, 설치 옵션, 제공업체 및 모델에 대해 다룹니다. 해당 페이지를 먼저 읽지 않고도 워크스루를 시작할 수 있습니다.
당신이 하는 일과 도구가 하는 일
| 사용자 | 도구 |
|---|---|
| 언어, 제공업체, 사용해 볼 모델을 선택합니다 | 텍스트를 추출하고 번역한 다음, 결과를 확인하고 카탈로그 또는 페이지를 작성합니다 |
텍스트를 보이게 만듭니다: 앱 코드의 t(), 사이트 프레임워크의 i18n, 또는 README의 언어 목록 마커 | 모든 번역을 캐시하고 다음 실행 시 재사용합니다 |
| 파일을 로드하고 한 언어를 확인합니다 | 진행 상황을 보여주고, 번역 대시보드에서 문구를 검토할 수 있도록 합니다 |
단계별 안내서에는 어떤 소스 편집이 당신의 몫인지 명시되어 있습니다. 해당 편집이 기계적인 경우 코딩 에이전트 프롬프트가 포함됩니다. CLI는 카탈로그와 번역된 파일을 작성합니다. i18next 또는 사이트 프레임워크의 i18n을 설치하지 않습니다.
공통 설정
모든 단계별 안내서는 동일한 순서를 따릅니다. 선택한 페이지에서 세부 정보를 채워줍니다.
- CLI를 설치하고 제공자의 API 키를 설정합니다. Ollama는 키가 필요 없습니다. 설치 및 제공자 및 API 키.
- 해당 페이지에 명시된 템플릿으로
init을(를) 실행합니다. 그러면ai-i18n-tools.config.json이(가) 작성됩니다. - 도구가 텍스트를 볼 수 있도록 프로젝트를 준비합니다.
ai-i18n-tools sync을(를) 실행한 다음ai-i18n-tools status을(를) 실행합니다.- 출력을 로드하고, 하나의 대상 언어를 확인한 다음, 소스가 변경되면
sync을(를) 다시 실행합니다. 캐시는 새롭거나 변경된 텍스트만 모델로 보냅니다.
이 섹션의 페이지
| 당신이 가진 것 | 페이지 | 해당 페이지에서 다루는 내용 |
|---|---|---|
| 버튼과 메시지가 여전히 일반 텍스트인 JS/TS 앱 (React, Next.js, Node, CLI) | JS/TS 앱에 i18n 추가하기 | i18next를 설치하고, 부트스트랩을 추가하고, 리터럴을 t()으로(로) 감싼 다음, extract 및 translate-ui를(을) 실행합니다 |
| Python 앱 (Streamlit, FastAPI, Flask, Django, gettext) | Python 앱에 i18n 추가하기 | t() 또는 _()을(를) 감싸거나, GNU gettext를 유지합니다. CLI는 Node.js 설치 없이 독립 실행 파일에서 실행할 수 있습니다 |
| 문서 또는 마케팅 사이트 (VitePress, Starlight, Docusaurus, Nextra, Fumadocs, Astro, 일반 HTML) | 웹사이트 또는 문서 사이트에 i18n 추가하기 | 프레임워크 자체의 언어 경로를 활성화한 다음, 페이지와 테마 레이블을 번역합니다 |
| 일반적으로 앱 옆에 있는 저장소 README 및 기타 마크다운 파일 | README 및 마크다운 문서에 i18n 추가하기 | 언어당 하나의 파일 (translated-docs/README.de.md) 및 README의 언어 행. init --with-readme은(는) 해당 블록을 모든 템플릿에 추가합니다 |
| 하나의 저장소에 위 항목 중 두 개 이상 | 파이프라인 결합하기 | 하나의 구성과 하나의 sync. 일반적인 쌍은 앱 UI 문자열과 README입니다 |
| Intlayer 사전이 있고 Intlayer를 유지하려는 경우 | Intlayer를 제자리에서 번역하기 | translate-intlayer은(는) *.content.ts 내에서 누락되거나 오래된 리프를 채웁니다 |
| Intlayer 사전이 있고 Intlayer에서 벗어나려는 경우 | Intlayer에서 마이그레이션하기 | migrate-intlayer은(는) 사전에서 카탈로그를 시드하고 안전한 호출 사이트를 t()으로(로) 다시 작성합니다 |
README도 있는 앱은 앱 페이지와 README 페이지를 함께 사용합니다. README도 있는 사이트는 웹사이트 페이지와 README 블록에 init … --with-readme을(를) 사용합니다.
더 알아보기
단계별 안내는 첫 번째 언어 설정이 완료되면 중단됩니다. 그 이후부터는 참조 페이지를 참고하세요: