Dokumentatsioon: TacoTranslate'i kasutamine

TacoTranslate kasutamine

Estonian

Stringide tõlkimine

Praegu on stringide tõlkimiseks kolm võimalust: Translate komponent, useTranslation hook või translateEntries utiliit.

Translate komponendi kasutamine.
Kuvab tõlkeid span elemendi sees ja toetab HTML-i renderdamist.

import {Translate} from 'tacotranslate/react';

function Page() {
	return <Translate string="Hello, world!" />;
}

Elementtüüpi saab muuta, näiteks komponendil as="p".

Kasutades useTranslation hooki.
Tagastab tõlked lihttekstina. Kasulik näiteks meta siltides.

import {useEffect} from 'react';
import {useTranslation} from 'tacotranslate/react';

function Page() {
	const helloWorld = useTranslation('Hello, world!');

	useEffect(() => {
		alert(helloWorld);
	}, [helloWorld]);

	return (
		<title>{useTranslation('My page title')}</title>
	);
}

translateEntries utiliidi kasutamine.
Tõlgib stringid serveripoolselt. Võimendab oma OpenGraph pilte.

import {createEntry, translateEntries} from 'tacotranslate';

async function generateMetadata(locale = 'es') {
	const title = createEntry({string: 'Hello, world!'});
	const description = createEntry({string: 'TacoTranslate on the server'});

	const translations = await translateEntries(
		tacoTranslate,
		{origin: 'opengraph', locale},
		[title, description]
	);

	return {
		title: translations(title),
		description: translations(description)
	};
}

Kui stringid jõuavad meie serveritesse, valideerime ja salvestame need esmalt ning tagastame kohe masintõlke. Kuigi masintõlked on üldiselt meie AI-tõlgetega võrreldes madalama kvaliteediga, pakuvad need kiiret esialgset vastust.

Samal ajal alustame asünkroonset tõlketööd, et genereerida teie stringi jaoks kõrgekvaliteediline, tipptasemel tehisintellekti tõlge. Kui tehisintellekti tõlge on valmis, asendab see masintõlke ja seda saadetakse alati, kui taotlete oma stringide tõlkeid.

Kui olete stringi käsitsi tõlkinud, omavad need tõlked eelist ja need tagastatakse selle asemel.

Päritolude kasutamine

TacoTranslate'i projektid sisaldavad seda, mida me nimetame originsiks. Mõelge neile kui teie stringide ja tõlgete jaoks mõeldud sisenemispunktidele, kaustadele või rühmadele.

import {TacoTranslate} from 'tacotranslate/react';

function Menu() {
	return (
		<TacoTranslate origin="application-menu">
			// ...
		</TacoTranslate>
	);
}

Originid võimaldavad teil jagada sõned tähenduslikesse konteineritesse. Näiteks võiks teil olla üks origin dokumentatsiooni jaoks ja teine turunduslehe jaoks.

Täpsema kontrolli jaoks võiksite seadistada originid komponendi tasandil.

Selle saavutamiseks kaaluge oma projektis mitme TacoTranslate pakkuja kasutamist.

Pange tähele, et sama tekstijupp võib erinevates päritoludes saada erinevaid tõlkeid.

Lõppkokkuvõttes on see, kuidas te stringe originidesse jagate, teie otsustada ja see sõltub teie vajadustest. Siiski pange tähele, et kui ühes originis on palju stringe, võib see suurendada laadimisaegu.

Muutujate käsitlemine

Dünaamilise sisu puhul peaksite alati kasutama muutujaid, näiteks kasutajanimesid, kuupäevi, e-posti aadresse ja palju muud.

Stringides olevad muutujad deklareeritakse topeltsulgudega, näiteks {{variable}}.

import {Translate} from 'tacotranslate/react';

function Greeting() {
	const name = 'Juan';
	return <Translate string="Hello, {{name}}!" variables={{name}} />;
}

import {useTranslation} from 'tacotranslate/react';

function useGreeting() {
	const name = 'Juan';
	return useTranslation('Hello, {{name}}!', {variables: {name}});
}

HTML-sisu haldamine

Vaikimisi Translate komponent toetab ja renderdab HTML-sisu. Siiski saate sellest käitumisest loobuda, määrates useDangerouslySetInnerHTML väärtuseks false.

HTML-i renderdamise keelamine on tungivalt soovitatav, kui tõlgitakse usaldusväärsust mitteomavat sisu, näiteks kasutajate loodud sisu.

Kõik väljundid puhastatakse enne renderdamist alati sanitize-html.

import {Translate} from 'tacotranslate/react';

function Page() {
	return (
		<Translate
			string={`
				Welcome to <strong>my</strong> website.
				I’m using <a href="{{url}}">TacoTranslate</a> to translate text.
			`}
			variables={{url: 'https://tacotranslate.com'}}
			useDangerouslySetInnerHTML={false}
		/>
	);
}

Ülaltoodud näide kuvatakse tavalise tekstina.

Serveripoolne renderdamine

TacoTranslate kasutamine

Kuidas stringid tõlgitakse

Päritolude kasutamine

Muutujate käsitlemine

HTML-sisu haldamine