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 rīks.

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 hooku.
Atgriež tulkojumus kā parastu 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 utilītu.
Tulkojiet virknes servera pusē. Padariet savus OpenGraph attēlus 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 pārbaudām un saglabājam, pēc tam uzreiz atgriežam mašīntulkojumu. Lai gan mašīntulkojumi parasti ir zemākas kvalitātes salīdzinājumā ar mūsu AI tulkojumiem, tie nodrošina ātru sākotnēju atbildi.

Vienlaikus mēs uzsākam asinhronu tulkošanas uzdevumu, lai jūsu virknei ģenerētu kvalitatīvu, modernu mākslīgā intelekta tulkojumu. Tiklīdz AI tulkojums būs gatavs, tas aizstās mašīntulkojumu un tiks nosūtīts katru reizi, kad pieprasīsiet šo virkņu tulkojumus.

Ja esat manuāli iztulkojis virkni, šie tulkojumi ir prioritāri un tiek atgriezti.

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 virkņu un tulkojumu.

import {TacoTranslate} from 'tacotranslate/react';

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

Origins ļauj jums sadalīt virknes loģiskos konteineros. Piemēram, varat izmantot vienu origin dokumentācijai un citu — jūsu mārketinga lapai.

Lai iegūtu sīkāku kontroli, varat izveidot originus komponenta līmenī.

Lai to panāktu, apsveriet izmantot vairākus TacoTranslate nodrošinātājus savā projektā.

Lūdzu, ņemiet vērā, ka viena un tā pati virkne dažādās sadaļās var saņemt atšķirīgus tulkojumus.

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

Mainīgo apstrāde

Vienmēr izmantojiet mainīgos 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 renderē HTML saturu. Tomēr, lai atteiktos no šīs uzvedības, varat iestatīt useDangerouslySetInnerHTML uz false.

Stingri ieteicams atspējot HTML renderēšanu, tulkojot neuzticamu saturu, piemēram, lietotāju radī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š 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