Localització sense esforç per a aplicacions React

Com funciona

Instal·la el paquet TacoTranslate via npm:

npm install tacotranslate

Quan tinguis el mòdul instal·lat, hauràs de crear un compte de TacoTranslate, un projecte de traducció i les claus API associades. Crea un compte aquí. És gratuït i no requereix que afegeixis una targeta de crèdit.

Dins de la interfície d'usuari de l'aplicació TacoTranslate, crea un projecte i navega a la pestanya de claus API. Crea una clau read i una clau read/write. Les desarem com a variables d'entorn. La clau read és la que anomenem public i la clau read/write és secret. Per exemple, podries afegir-les a un fitxer .env a la carpeta arrel del teu projecte.

També hauràs d'afegir dues variables d'entorn més: TACOTRANSLATE_DEFAULT_LOCALE i TACOTRANSLATE_ORIGIN.

• TACOTRANSLATE_DEFAULT_LOCALE: El codi de la localització de reserva per defecte. En aquest exemple, el configurarem a en per a anglès.
• TACOTRANSLATE_ORIGIN: La “carpeta” on s’emmagatzemaran les vostres cadenes, com ara l’URL del vostre lloc web. Llegiu més sobre els orígens aquí.

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

Assegura’t de no filtrar mai la clau API secreta read/write als entorns de producció del costat client.

Configuració de TacoTranslate

Inicialitza TacoTranslate a la teva aplicació React envoltant la teva aplicació amb el proveïdor de context 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>
	);
}

Ara podeu utilitzar el component Translate en qualsevol lloc dins de la vostra aplicació per mostrar text traduït! Assegureu-vos de consultar la nostra documentació per a més informació i per a guies d'implementació específiques per a la vostra configuració.

import {Translate} from 'tacotranslate/react';

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

Beneficis d’utilitzar TacoTranslate

• Estalvi de temps: Automatitza el procés tediós de la localització i la recopilació de cadenes, estalviant-te un temps valuós.
• Rendible: Redueix la necessitat de traduccions manuals, disminuint els costos de localització.
• Major precisió: Les traduccions assistides per IA asseguren resultats contextos precisos i d’alta qualitat.
• Solució escalable: Fàcilment afegeix suport per a nous idiomes a mesura que la teva aplicació i base de clients creixen.

Comenceu avui mateix!

La teva aplicació React es traduirà automàticament quan afegeixis qualsevol cadena a un component Translate. Tingues en compte que només els entorns amb permisos read/write sobre la clau API podran crear noves cadenes per traduir.

Recomanem tenir un entorn de staging tancat i segur on puguis provar la teva aplicació de producció, afegint noves cadenes abans de fer-la pública. Això evitarà que algú robí la teva clau API secreta i que el teu projecte de traducció s'inflï per afegir cadenes no autoritzades.

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!