React 애플리케이션을 위한 손쉬운 현지화

작동 방식

npm을 통해 TacoTranslate 패키지를 설치하세요:

npm install tacotranslate

모듈을 설치하면 TacoTranslate 계정과 번역 프로젝트 및 관련 API 키를 생성해야 합니다. 여기에서 계정을 생성하세요. 무료이며, 신용카드를 등록할 필요가 없습니다.

TacoTranslate 애플리케이션 UI에서 프로젝트를 생성한 다음 API 키 탭으로 이동하세요. 하나의 read 키와 하나의 read/write 키를 생성하세요. 이 키들은 환경 변수로 저장합니다. read 키는 우리가 public이라고 부르는 것이고, read/write 키는 secret입니다. 예를 들어, 프로젝트 루트에 있는 .env 파일에 추가할 수 있습니다.

또한 두 개의 환경 변수를 추가로 설정해야 합니다: TACOTRANSLATE_DEFAULT_LOCALE 및 TACOTRANSLATE_ORIGIN.

• TACOTRANSLATE_DEFAULT_LOCALE: 기본 대체 로케일 코드입니다. 이 예에서는 영어에 대해 en으로 설정합니다.
• TACOTRANSLATE_ORIGIN: 문자열이 저장될 "폴더"로, 예를 들어 웹사이트의 URL과 같습니다. 여기에서 오리진에 대해 자세히 알아보세요.

TACOTRANSLATE_PUBLIC_API_KEY=123456
TACOTRANSLATE_SECRET_API_KEY=789010
TACOTRANSLATE_DEFAULT_LOCALE=en
TACOTRANSLATE_ORIGIN=your-website-url.com

비밀 read/write API 키를 클라이언트 측 프로덕션 환경에 절대 유출하지 마세요.

TacoTranslate 설정하기

애플리케이션을 TacoTranslate 컨텍스트 제공자(provider)로 감싸서 React 애플리케이션에서 TacoTranslate를 초기화하세요:

import React, {useState} from 'react';
import TacoTranslate, {Translate} from 'tacotranslate/react';

const tacoTranslate = createTacoTranslateClient({
	apiKey: 'YOUR_API_KEY',
});

export default function App() {
	const [locale, setLocale] = useState('en');

	return (
		<TacoTranslate client={tacoTranslate} locale={locale}>
			<Translate string="Hello, world!"/>
		</TacoTranslate>
	);
}

이제 애플리케이션 어디에서나 Translate 컴포넌트를 사용하여 번역된 텍스트를 표시할 수 있습니다! 자세한 정보와 환경별 구현 가이드를 보려면 문서를 꼭 확인하세요.

import {Translate} from 'tacotranslate/react';

export default async function Component() {
	return (
		<Translate string="Hello? This is TacoTranslate speaking." />
	);
}

TacoTranslate 사용의 이점

• 시간 절약: 로컬라이제이션과 문자열 수집이라는 번거로운 과정을 자동화하여 귀중한 시간을 절약해줍니다.
• 비용 효율적: 수작업 번역의 필요성을 줄여 로컬라이제이션 비용을 낮춥니다.
• 정확도 향상: AI 기반 번역은 문맥에 맞는 정확하고 고품질의 결과를 보장합니다.
• 확장 가능한 솔루션: 애플리케이션과 고객 기반이 성장함에 따라 손쉽게 새로운 언어 지원을 추가할 수 있습니다.

지금 시작하세요!

React 애플리케이션은 Translate 컴포넌트에 문자열을 추가하면 자동으로 번역됩니다. 참고로 API 키에 대해 read/write 권한이 있는 환경에서만 새로 번역할 문자열을 생성할 수 있습니다.

프로덕션 애플리케이션을 테스트하고 라이브 이전에 새로운 문자열을 추가할 수 있는 폐쇄적이고 보안된 스테이징 환경을 마련할 것을 권장합니다. 이렇게 하면 누군가가 당신의 비밀 API 키를 탈취하는 것을 방지하고, 악성 문자열을 추가하여 번역 프로젝트가 불필요하게 부풀어 오르는 것을 막을 수 있습니다.

Be sure to check out the complete examples over at our GitHub profile. If you encounter any problems, feel free to reach out, and we’ll be more than happy to help.

TacoTranslate lets you automatically localize your React applications quickly to and from over 75 languages. Translate for free!