Dokumentācija: TacoTranslate izmantošana

TacoTranslate lietošana

Latvian

Virkņu tulkošana

Pašlaik ir trīs veidi, kā tulkot virknes: Translate komponents, useTranslation hook, vai translateEntries utilīta.

Izmantojot Translate komponentu.
Izvada tulkojumus span elementā un atbalsta HTML renderēšanu.

import {Translate} from 'tacotranslate/react';

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

Jūs varat mainīt elementa tipu, piemēram, izmantojot as="p" komponentā.

Izmantojot useTranslation hook.
Atgriež tulkojumus kā vienkāršu virkni. Noder, piemēram, meta tagos.

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

Izmantojot translateEntries utilītu.
Tulkojiet virknes servera pusē. Uzlabojiet savus OpenGraph attēlus.

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

Kad virknes nonāk mūsu serveros, mēs vispirms tās pārbaudām un saglabājam, pēc tam nekavējoties atgriežam mašīntulkojumu. Lai gan mašīntulkojumi parasti ir zemākas kvalitātes nekā mūsu AI tulkojumi, tie sniedz ātru sākotnējo atbildi.

Vienlaikus mēs uzsākam asinhronu tulkošanas uzdevumu, lai ģenerētu augstas kvalitātes, pasaules līmeņa AI tulkojumu jūsu virknei. Kad AI tulkojums būs gatavs, tas aizstās mašīntulkojumu un tiks nosūtīts ikreiz, kad pieprasīsiet šīs virknes tulkojumus.

Ja esat manuāli pārtulkojis virkni, šie tulkojumi tiek uzskatīti par prioritāti un tiek atgriezti.

Originu izmantošana

TacoTranslate projekti satur to, ko mēs saucam par origins. Uzskatiet tos par ieejas punktiem, mapēm vai grupām jūsu virkņu un tulkojumu organizēšanai.

import {TacoTranslate} from 'tacotranslate/react';

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

Avoti ļauj sadalīt virknes jēgpilnos konteineros. Piemēram, dokumentācijai var būt viens avots, bet jūsu mārketinga lapai — cits.

Lai iegūtu smalkāku kontroli, varat iestatīt origins komponenta līmenī.

Lai to panāktu, apsveriet vairāku TacoTranslate sniedzēju izmantošanu savā projektā.

Lūdzu, ņemiet vērā, ka vienai un tai pašai virknei dažādos originos var būt atšķirīgi tulkojumi.

Galu galā par to, kā sadalīt virknes pa izcelsmēm, izlemjat jūs, ņemot vērā savas vajadzības. Tomēr ņemiet vērā, ka daudz virknju vienā izcelsmē var palielināt ielādes laiku.

Mainīgo apstrāde

Jums vienmēr jāizmanto mainīgie dinamiskam saturam, piemēram, lietotājvārdiem, datumiem, e-pasta adresēm un tamlīdzīgi.

Virkņu mainīgie tiek deklarēti, izmantojot dubultās iekavas, piemēram {{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 satura pārvaldība

Pēc noklusējuma, Translate komponents atbalsta un attēlo HTML saturu. Tomēr varat atteikties no šīs uzvedības, iestatot useDangerouslySetInnerHTML uz false.

Stingri ieteicams atspējot HTML renderēšanu, tulkojot neuzticamu saturu, piemēram, lietotāju ģenerētu saturu.

Visa izvade vienmēr tiek attīrīta ar sanitize-html pirms tās attēlošanas.

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

Iepriekšējais piemērs tiks attēlots kā vienkāršs teksts.

Servera puses renderēšana

TacoTranslate lietošana

Kā tiek tulkotas virknes

Originu izmantošana

Mainīgo apstrāde

HTML satura pārvaldība