개발자 도구
파일을 번역하고, 서버에서 API를 호출하고, 자바스크립트 패키지로 다국어 애플리케이션을 렌더링하세요.
로컬라이제이션은 번역을 생성하는 코드와 번역을 사용하는 코드를 연결합니다. 서버는 레코드가 변경될 때 번역된 콘텐츠를 요청할 수 있고, 빌드 과정에서는 번역된 파일을 모을 수 있습니다. 리액트 컴포넌트는 번역을 요청하지 않고도 기존 카탈로그를 읽을 수 있습니다.
구현하려는 부분부터 시작하세요. 각 섹션은 첫 작업을 끝까지 안내한 다음, 이후 작업에 필요한 규약을 설명합니다.
API #
서버가 이미 콘텐츠를 보유하고 있고 번역 요청 시점, 저장 위치, 사용 시점을 결정해야 한다면 API를 사용하세요. JSON 콘텐츠나 업로드한 파일을 번역 작업으로 제출하고 실행한 뒤, 대상별로 완료된 결과를 가져오세요. 번역과 검토 단계는 엔진이 제어합니다.
첫 요청 보내기에서는 소량의 요청 데이터를 보내고 번역된 데이터를 로컬에 저장합니다. 이 가이드는 애플리케이션 저장소에 연결하기 전에 알아야 할 인증 정보, 로컬라이제이션 엔진 선택 방법, 응답 필드, 확인 사항을 설명합니다.
CLI #
콘텐츠가 파일로 저장되어 있다면 CLI를 사용하세요. 원본 경로와 대상 로캘을 설정하고, 선택한 작업을 제출한 뒤, 대상 파일을 프로젝트로 가져오세요. CLI는 원본의 기준 상태를 기록하므로, 이후 실행에서는 모든 파일을 새 파일로 취급하지 않고 변경 사항만 처리할 수 있습니다.
첫 파일 번역하기에서는 설치, 인증, 설정, 결과 가져오기를 다룹니다. 같은 CLI로 명시적으로 작성된 리액트 메시지를 추출해 카탈로그에 담을 수도 있습니다. 추출은 로컬에서 수행되며 번역을 요청하지 않습니다.
자바스크립트 #
자바스크립트 패키지는 서버 클라이언트, 리액트 메시지 렌더링, 로캘 라우팅을 지원합니다. 번역을 요청하려면 클라이언트를, 애플리케이션에 이미 있는 메시지를 표시하려면 렌더링 라이브러리를 선택하세요. 브라우저에서 렌더링할 때는 번역 API 키가 필요하지 않습니다.
리액트 문서에서는 로컬에서 첫 메시지를 표시하는 예제부터 카탈로그 불러오기, 문법에 따른 대체 표현, 서식 있는 텍스트, 프레임워크별 통합까지 다룹니다. URL 협상과 번역된 텍스트 처리는 별개의 역할입니다. 라우팅 레퍼런스에서는 선택한 로캘과 불러온 메시지가 서로 일치하도록 유지하는 방법을 설명합니다.
기존 프로젝트 가져오기 #
형식에서는 각 처리기가 무엇을 번역하고 재구성하는지 설명합니다. 처리기를 호출하는 도구의 형식 목록도 확인하세요. 서버 통합에서 사용할 수 있는 처리기라도 CLI에서 파일 형식으로 설정되어 있다고는 할 수 없습니다.
i18n.json 또는 LingoDotDevEngine를 사용하는 프로젝트를 위해 버전별 CLI 버전 0 및 SDK 버전 0 레퍼런스를 제공합니다. 마이그레이션을 계획하는 동안에는 설치된 버전을 유지하세요. 세대가 바뀌면 설정, 보존되는 상태, 반환값이 달라질 수 있습니다.
로컬 파일이나 계정 설정을 다루는 어시스턴트에는 MCP를 사용하세요. 저장소, 콘텐츠 관리 시스템, 고객 지원 센터와 연동해 번역하려면 통합을 사용하세요. 각 연결은 작업 시작 방식, 사용하는 권한, 결과가 반환되는 위치를 정의합니다.