각 가이드는 Lingo.dev에서 로컬라이제이션 엔진을 구성하는 단계부터 프로덕션에 번역 결과물을 배포하는 단계까지, 특정 로컬라이제이션 시나리오를 처음부터 끝까지 안내합니다. 모든 가이드는 조직과 최소 하나의 로컬라이제이션 엔진이 이미 구성되어 있다는 전제하에 작성되었습니다.
가이드 활용 방식#
제품마다 로컬라이제이션이 필요한 지점은 서로 다릅니다. 웹 앱에는 번역된 UI 문자열이 필요하고, API에는 로캘에 맞는 응답이 필요하며, 문서 사이트에는 번역된 Markdown 파일이 필요합니다. 각 대상은 모두 동일한 로컬라이제이션 엔진에 연결되지만, 통합 방식은 서로 다릅니다.
이 가이드에서는 7가지 통합 패턴을 다룹니다:
| 대상 | 로컬라이즈되는 항목 | 통합 방식 |
|---|---|---|
| Translation API | 키-값 데이터, 동적 콘텐츠 | HTTP API 호출 |
| 웹 앱 | UI 문자열, 컴포넌트 텍스트 | CLI + 프레임워크 연동 |
| 모바일 앱 | iOS .strings, Android .xml | CLI + 모바일 빌드 파이프라인 |
| iOS 앱 | Xcode String Catalogs .xcstrings | CLI + GitHub Actions |
| Android 앱 | Android strings.xml | CLI + GitHub Actions |
| Markdoc와 함께 사용하는 Next.js | Markdoc 페이지와 JSON UI 문자열 | CLI + GitHub Actions |
| i18n과 함께 사용하는 Rails | Rails config/locales YAML | CLI + GitHub Actions |
| 이메일 | 트랜잭션 및 마케팅 템플릿 | 템플릿 형식에 따라 API 또는 CLI |
| 정적 콘텐츠 | Markdown, JSON, YAML 파일 | 파일 기반 번역용 CLI |
| CI/CD 워크플로 | 위 모든 항목의 자동화 | GitHub Actions, GitLab CI, Bitbucket Pipelines |
사전 준비 사항
모든 가이드를 진행하려면 API 키와 구성된 로컬라이제이션 엔진이 필요합니다. 아직 설정하지 않았다면 문서부터 시작하세요.
가이드 선택하기#
Translation API
키-값 데이터를 로컬라이제이션 API로 전송하고, 번역 결과를 프로그래밍 방식으로 받아보세요
웹 앱
CLI를 사용해 React, Next.js 등 다양한 웹 프레임워크를 로컬라이즈하세요
모바일 앱
로캘별 모델 선택으로 iOS 및 Android 앱을 로컬라이즈하세요
String Catalogs를 사용하는 iOS
CLI와 GitHub Actions로 Xcode .xcstrings를 처음부터 끝까지 로컬라이즈하세요
strings.xml을 사용하는 Android
CLI와 GitHub Actions로 Android XML을 처음부터 끝까지 로컬라이즈하세요
i18n을 사용하는 Rails
CLI와 GitHub Actions로 Rails config/locales YAML을 처음부터 끝까지 로컬라이즈하세요
이메일
브랜드 보이스를 적용해 트랜잭션 및 마케팅 이메일 템플릿을 번역하세요
정적 콘텐츠
리포지토리에 있는 Markdown, JSON 및 기타 정적 파일을 번역하세요
CI/CD 워크플로
GitHub Actions, GitLab CI 또는 Bitbucket으로 푸시할 때마다 로컬라이제이션을 자동화하세요
MCP로 엔진 설정하기
Lingo.dev MCP 서버를 통해 AI 코딩 어시스턴트를 활용해 로컬라이제이션 엔진을 구성하세요
Jira 티켓 분류
AI 기반 제안으로 로컬라이제이션 관련 Jira 티켓을 자동 분류하세요
