TacoTranslate
/
DokumentācijaCenas
 
  1. Ievads
  2. Sākt darbu
  3. Uzstādīšana un konfigurēšana
  4. TacoTranslate lietošana
  5. Servera puses renderēšana
  6. Papildu izmantošana
  7. Labākās prakses
  8. Kļūdu apstrāde un atkļūdošana
  9. Atbalstītās valodas

TacoTranslate lietošana

Virkņu tulkošana

Pašlaik ir trīs veidi, kā tulkot virknes: Translate komponents, useTranslation īkšķis 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 hook.
Atgriež tulkojumus kā vienkāršu tekstu. 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 tekstus servera pusē. Uzlabojiet savas OpenGraph bildes.

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

Kā tiek tulkotas virknes

Kad virknes sasniedz mūsu serverus, mēs vispirms tās pārbaudām un saglabājam, pēc tam tūlītīgi 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, modernu AI tulkojumu jūsu teksta virknei. Kad AI tulkojums būs gatavs, tas aizstās mašīntulkojumu un tiks nosūtīts katru reizi, kad pieprasīsiet tulkojumus savām teksta virknei.

Ja esat manuāli iztulkojis virkni, šie tulkojumi tiek prioritizēti un tiek atgriezti tā vietā.

Izcelsmju izmantošana

TacoTranslate projektos ir tas, ko mēs saucam par originiem. Uzlūkojiet tos kā ieejas punktus, mapes vai grupas jūsu virkņu un tulkojumu pārvaldībai.

import {TacoTranslate} from 'tacotranslate/react';

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

Origins ļauj jums sadalīt virknes nozīmīgos konteineros. Piemēram, jums varētu būt viens origins dokumentācijai un cits 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 iespēju projektā izmantot vairākus TacoTranslate pakalpojumu sniedzējus.

Lūdzu, ņemiet vērā, ka tai pašai virknei dažādās izcelsmēs var būt atšķirīgas tulkojuma versijas.

Galu galā, kā jūs sadalāt tekstus oriģinālos, ir jūsu ziņā un atkarīgs no jūsu vajadzībām. Tomēr ņemiet vērā, ka, ja daudz tekstu ir vienā oriģinālī, tas var palielināt ielādes laikus.

Darbs ar mainīgajiem

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

Mainīgie tekstos 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 atveido HTML saturu. Tomēr jūs varat atteikties no šīs uzvedības, iestatot useDangerouslySetInnerHTML uz false.

HTML atveides 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 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

Produkts no NattskiftetRažots Norvēģijā