Enkel lokalisering for React-applikasjonar

Korleis det fungerer

Installer TacoTranslate-pakken via npm:

npm install tacotranslate

Når du har installert modulen, må du opprette ein TacoTranslate-konto, eit omsetjingsprosjekt, og tilhøyrande API-nøklar. Opprett ein konto her. Det er gratis, og krev ikkje at du legg til kreditkort.

Innenfor TacoTranslate-applikasjonen sin brukargrensesnitt, opprett eit prosjekt, og naviger til fanen for API-nøklar. Lag ein read nøkkel, og ein read/write nøkkel. Vi vil lagre dei som miljøvariablar. read nøkkelen er det vi kallar public, og read/write nøkkelen er secret. Til dømes kan du legge dei til i ei .env fil i rotmappa av prosjektet ditt.

Du må òg legge til to fleire miljøvariablar: TACOTRANSLATE_DEFAULT_LOCALE og TACOTRANSLATE_ORIGIN.

• TACOTRANSLATE_DEFAULT_LOCALE: Standard tilbakefallsstadkoden. I dette dømet set vi den til en for engelsk.
• TACOTRANSLATE_ORIGIN: «Mappa» der strengane dine blir lagra, til dømes URLen til nettsida di. Les meir om opphav her.

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

Pass på å aldri lekke den hemmelige read/write API-nøkkelen til klient-side produksjonsmiljø.

Setje opp TacoTranslate

Initialiser TacoTranslate i React-applikasjonen din ved å pakke applikasjonen din inn i TacoTranslate context provider:

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>
	);
}

Du kan no bruke Translate komponenten kor som helst i applikasjonen din for å vise omsette tekstar! Ver sikker på å sjå dokumentasjonen vår for meir informasjon, og for implementeringsrettleiingar spesifikke for oppsetet ditt.

import {Translate} from 'tacotranslate/react';

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

Fordelar med å bruke TacoTranslate

• Tidsbesparande: Automatiserer den tidkrevjande prosessen med lokaliserng og innsamling av tekststrengar, og sparar deg verdifull tid.
• Kostnadseffektiv: Reduserer behovet for manuelle omsettingar, noko som senkar kostnadene til lokaliseringsarbeidet ditt.
• Forbetra nøyaktigheit: AI-drevne omsettingar sikrar kontekstrelevante og høgkvalitets resultat.
• Skalerbar løysing: Legg enkelt til støtte for nye språk etter kvart som applikasjonen og kundebasen din veks.

Kom i gang i dag!

Din React-applikasjon vil bli automatisk oversatt når du legg til tekststrengar i ein Translate komponent. Merk at berre miljø med read/write tilgong på API-nøkkelen vil kunne opprette nye tekststrengar som skal omsetjast.

Vi tilrår å ha eit lukka og sikra staging-miljø der du kan teste produksjonsapplikasjonen din, og leggje til nye tekststrengar før du går live. Dette vil hindre at nokon får tak i din sekreteste API-nøkkel, og potensielt fyller opp omsetjingsprosjektet ditt med uønskte tekststrangar.

Hugs å sjekke ut dei komplette eksempla på vår GitHub-profil. Om du møter på problem, ikkje nøl med å ta kontakt, så hjelper vi deg gjerne.

TacoTranslate lar deg automatisk lokaliserer React-applikasjonane dine raskt til og frå kva som helst språk. Oversett gratis!