로컬라이제이션 가이드

각 가이드는 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