Dokumentācija: TacoTranslate izmantošana

TacoTranslate izmantoš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!" />;
}

Elementa tipu var mainīt, piemēram, komponentā norādot as="p".

Izmantojot useTranslation hooku.
Atgriež tulkojumus kā vienkāršu virkni. Noderīgi, 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 rīku.
Tulkojiet teksta virknes servera pusē. Padariet savus OpenGraph attēlus daudz jaudīgākus.

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 validējam un saglabājam, pēc tam tūlīt atgriežam mašīntulkojumu. Lai gan mašīntulkojumi parasti ir zemākas kvalitātes nekā mūsu AI tulkojumi, tie nodrošina ātru sākotnēju atbildi.

Vienlaikus mēs uzsākam asinhronu tulkošanas uzdevumu, lai ģenerētu augstas kvalitātes, mūsdienīgu mākslīgā intelekta tulkojumu jūsu teksta virknei. Kad mākslīgā intelekta tulkojums būs gatavs, tas aizstās mašīntulkojumu un tiks nosūtīts katru reizi, kad pieprasīsiet jūsu virknes tulkojumus.

Ja esat manuāli iztulkojis virkni, šie tulkojumi tiek uzskatīti par prioritāti un tiek atgriezti to vietā.

Izcelsmju izmantošana

TacoTranslate projekti satur to, ko mēs saucam par avotiem. Uzskatiet tos par ievades punktiem, mapēm vai grupām jūsu tekstiem un tulkojumiem.

import {TacoTranslate} from 'tacotranslate/react';

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

Origins ļauj jums sadalīt virknes jēgpilnos konteineros. Piemēram, jums var būt viena origin dokumentācijai un cita jūsu mārketinga lapai.

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

Lai to panāktu, apsveriet iespēju izmantot vairākus TacoTranslate pakalpojumu sniedzējus savā projektā.

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

Galu galā tas, kā jūs sadalāt virknes pa sākotnējiem avotiem, ir atkarīgs no jums un jūsu vajadzībām. Tomēr ņemiet vērā, ka, ja vienā sākotnējā avotā ir daudz virkņu, tas var palielināt ielādes laikus.

Mainīgo apstrāde

Dinamiskiem datiem — piemēram, lietotājvārdiem, datumiem, e‑pasta adresēm un citiem — vienmēr jālieto mainīgie.

Virkņās mainīgos deklarē, 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 renderē HTML saturu. Tomēr varat izslēgt šo uzvedību, iestatot useDangerouslySetInnerHTML uz false.

HTML renderēšanas atspējošana ir stingri ieteicama, tulkojot neuzticamu saturu, piemēram, lietotāju radītu saturu.

Visa izvade vienmēr tiek attīrīta ar sanitize-html pirms renderēš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š minētais piemērs tiks attēlots kā vienkāršs teksts.

Servera puses renderēšana

TacoTranslate izmantošana

Kā tiek tulkotas virknes

Izcelsmju izmantošana

Mainīgo apstrāde

HTML satura pārvaldība