Lokalisasi mudah untuk aplikasi React

Cara kerjanya

Instal paket TacoTranslate melalui npm:

npm install tacotranslate

Setelah Anda menginstal modul, Anda perlu membuat akun TacoTranslate, sebuah proyek terjemahan, dan kunci API terkait. Buat akun di sini. Gratis, dan tidak mengharuskan Anda menambahkan kartu kredit.

Di antarmuka aplikasi TacoTranslate, buat sebuah proyek, lalu buka tab kunci API. Buat satu kunci read dan satu kunci read/write. Kami akan menyimpannya sebagai variabel lingkungan. Kunci read adalah yang kami sebut public, dan kunci read/write adalah secret. Misalnya, Anda bisa menambahkannya ke file .env di root proyek Anda.

Anda juga perlu menambahkan dua variabel lingkungan lagi: TACOTRANSLATE_DEFAULT_LOCALE dan TACOTRANSLATE_ORIGIN.

• TACOTRANSLATE_DEFAULT_LOCALE: Kode locale default yang digunakan sebagai fallback. Dalam contoh ini, kami akan mengaturnya ke en untuk Bahasa Inggris.
• TACOTRANSLATE_ORIGIN: “folder” tempat string Anda akan disimpan, seperti URL situs web Anda. Baca selengkapnya tentang origin di sini.

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

Pastikan Anda tidak pernah membocorkan kunci API rahasia read/write ke lingkungan produksi sisi klien.

Menyiapkan TacoTranslate

Inisialisasikan TacoTranslate di aplikasi React Anda dengan membungkus aplikasi Anda dalam penyedia konteks 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>
	);
}

Anda sekarang dapat menggunakan komponen Translate di mana saja dalam aplikasi Anda untuk menampilkan teks yang diterjemahkan! Pastikan untuk melihat dokumentasi kami untuk informasi lebih lanjut, dan untuk panduan implementasi yang spesifik untuk pengaturan Anda.

import {Translate} from 'tacotranslate/react';

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

Manfaat menggunakan TacoTranslate

• Hemat waktu: Mengotomatisasi proses lokalisasi dan pengumpulan string yang melelahkan, sehingga menghemat waktu berharga Anda.
• Hemat biaya: Mengurangi kebutuhan akan terjemahan manual, menurunkan biaya lokalisasi Anda.
• Peningkatan akurasi: Terjemahan bertenaga AI memastikan hasil yang akurat secara kontekstual dan berkualitas tinggi.
• Solusi yang dapat diskalakan: Mudah menambahkan dukungan untuk bahasa baru seiring aplikasi dan basis pelanggan Anda berkembang.

Mulai hari ini!

Aplikasi React Anda akan diterjemahkan secara otomatis ketika Anda menambahkan string apa pun ke komponen Translate. Perlu dicatat bahwa hanya lingkungan dengan izin read/write pada kunci API yang akan dapat membuat string baru untuk diterjemahkan.

Kami menyarankan untuk memiliki lingkungan staging tertutup dan aman di mana Anda dapat menguji aplikasi produksi Anda, menambahkan string baru sebelum diluncurkan. Ini akan mencegah siapapun siapapun mencuri kunci API rahasia Anda, dan berpotensi membengkakkan proyek terjemahan Anda dengan menambahkan string yang tidak sah.

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!