자바스크립트와 리액트
서버에서 콘텐츠를 번역하고, 리액트에서 메시지 카탈로그를 렌더링하고, 애플리케이션에 로캘 라우팅을 연결하세요.
자바스크립트 애플리케이션에서 번역은 두 곳에서 이루어집니다. 서버는 콘텐츠를 로컬라이제이션 엔진에 보내고 결과를 저장합니다. 사용자 인터페이스는 번역된 메시지를 불러와 알맞은 값과 문법, 서식을 적용해 렌더링합니다. 구현할 부분에 맞는 패키지를 선택하세요.
서버에서 번역하기 #
자바스크립트 API 가이드를 따라 네이티브 fetch로 번역 작업을 생성하고, 진행 상황을 확인하고, 완료된 파일을 다운로드하세요. API 키는 서버에 보관하고, 각 작업의 식별 정보는 해당 작업에서 번역하는 원본의 리비전과 함께 보관하세요.
LingoDotDevEngine를 사용하는 애플리케이션에는 별도의 SDK 버전 0 레퍼런스가 있습니다. 동기 API와 클라이언트 측 일괄 처리에 관한 설명은 해당 레퍼런스에서 계속 확인할 수 있습니다.
리액트에서 메시지 렌더링하기 #
리액트는 원본 메시지와 맥락을 컴포넌트 안에 유지합니다. 카탈로그가 번역된 템플릿을 제공하면 런타임이 값을 삽입하고, 애플리케이션에서 제어하는 리액트 요소를 생성합니다. 렌더링에는 번역 API 키가 필요하지 않습니다.
로컬 카탈로그로 컴포넌트 하나를 번역하는 것부터 시작하세요. 애플리케이션 규모가 커지면 카탈로그를 추출하고 불러오세요. 넥스트제이에스 페이지와 탠스택 스타트 활용 가이드에서는 카탈로그를 요청, 경로, 언어 전환에 연결하는 방법을 안내합니다. 자체 라우터를 사용한다면 로캘 라우터가 URL과 선호 언어를 결정하는 기반 로직을 제공합니다.
Payload 애플리케이션 연결하기 #
Payload 콘텐츠 관리 시스템 플러그인은 필드 스키마를 노출하고, 원본 콘텐츠가 변경되면 Lingo.dev에 알립니다. Payload 연동에서는 번역할 콘텐츠와 번역 결과를 다시 저장할 위치를 설정합니다.
예제 프로젝트 #
다음 저장소에서 원본 파일과 애플리케이션의 로딩 과정이 어떻게 연결되는지 확인할 수 있습니다. 활용하기 전에 각 프로젝트의 의존성 버전과 설정을 확인하세요. 일부 프로젝트는 이 설명서에서 다루는 것과 다른 세대의 패키지를 사용합니다. 포크한 저장소에서는 번역 작업을 제출하기 전에 본인의 Lingo.dev 프로젝트를 연결하세요.
| 프로젝트 | 시작할 때 참고할 내용 |
|---|---|
| 리액트 + 비트 | 컴포넌트 메시지, 메시지 추출, 카탈로그 불러오기. |
| 넥스트제이에스 페이지 | 페이지 메시지와 로캘을 반영한 경로. |
| 타입스크립트 모듈 | 정적으로 내보낸 로캘 데이터. 타입스크립트 핸들러에서 지원하는 기본 내보내기 형식을 사용하세요. 지원하지 않는 형식으로 내보내면 번역 단위가 생성되지 않을 수 있습니다. |
| 아이오에스 | 애플 리소스와 네이티브 로캘 선택. |
| 안드로이드 | 리소스 디렉터리와 문자열 조회. |
| Flutter | ARB 메타데이터와 생성된 메시지. |
| 마크다운 | 문서 경로와 프런트매터. |
| 마크독 + 넥스트제이에스 | 번역 가능한 태그 속성과 문서 렌더링. |
| 오픈에이피아이 | API 명세에서 사람이 읽을 수 있도록 작성된 설명. |
| Rails | 로캘을 최상위 키로 사용하는 YAML과 프레임워크 조회. |
| Laravel | 리소스 파일과 프레임워크 로딩. |
네이티브 리소스와 문서는 CLI와 각 형식 핸들러를 사용합니다. 이 예제 모음에 포함되어 있다는 이유만으로 리액트 런타임이 필요한 것은 아닙니다.