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 palīgfunkcija.

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, izmantojot as="p" komponentā.

Izmantojot useTranslation hooku.
Atgriež tulkojumus kā vienkāršu virkni. Noderīgs, 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ē. Ievērojami 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 validējam un saglabājam, pēc tam nekavējoties 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ējo 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 virknei. Tiklīdz mākslīgā intelekta tulkojums būs gatavs, tas aizstās mašīntulkojumu un tiks nosūtīts ikreiz, kad pieprasīsiet tulkojumus savām virknēm.

Ja esat manuāli iztulkojis virkni, manuālie tulkojumi tiek uzskatīti par prioritāti un tiek atgriezti.

Izcelsmju izmantošana

TacoTranslate projekti satur to, ko mēs saucam par avotiem. Uztveriet tos kā ieejas punktus, mapes vai grupas 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, vienu avotu var izmantot dokumentācijai, bet citu — jūsu mārketinga lapai.

Lai iegūtu sīkāku kontroli, jūs varētu iestatīt origins komponenta līmenī.

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

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

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

Mainīgo apstrāde

Jums vienmēr jāizmanto mainīgie dinamiskam saturam, piemēram, lietotājvārdiem, datumiem, e‑pasta adresēm un citiem līdzīgiem datiem.

Mainīgie virkņu iekšpusē 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 varat atteikties no šīs uzvedības, iestatot useDangerouslySetInnerHTML uz false.

Stingri ieteicams atslēgt HTML renderēšanu, tulkojot neuzticamu saturu, piemēram, lietotāju radītu saturu.

Visa izvade vienmēr tiek sanitizēta ar sanitize-html pirms tās 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ā neformatēts teksts.

Servera puses renderēšana

TacoTranslate lietošana

Kā tiek tulkotas virknes

Izcelsmju izmantošana

Mainīgo apstrāde

HTML satura pārvaldība