Lokalisasi yang mudah untuk aplikasi React

Cara kerjanya

Instal paket TacoTranslate melalui npm:

npm install tacotranslate

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

Di dalam 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 apa yang kami sebut public dan kunci read/write adalah secret. Sebagai contoh, Anda dapat 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 (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 origins di sini.

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

Pastikan untuk 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 sesuai dengan pengaturan Anda.

import {Translate} from 'tacotranslate/react';

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

Manfaat menggunakan TacoTranslate

• Menghemat waktu: Mengotomatisasi proses lokalisasi dan pengumpulan string yang melelahkan, sehingga menghemat waktu berharga Anda.
• Hemat biaya: Mengurangi kebutuhan akan terjemahan manual, sehingga menurunkan biaya lokalisasi Anda.
• Akurasi yang lebih baik: Terjemahan bertenaga AI memastikan hasil yang akurat secara kontekstual dan berkualitas tinggi.
• Solusi yang dapat diskalakan: Tambahkan dukungan untuk bahasa baru dengan mudah seiring pertumbuhan aplikasi dan basis pelanggan Anda.

Mulai hari ini!

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

Kami menyarankan agar Anda memiliki lingkungan staging yang tertutup dan aman di mana Anda dapat menguji aplikasi produksi Anda, menambahkan string baru sebelum diluncurkan. Ini akan mencegah siapa pun siapa pun 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!