TacoTranslate
/
SkjölunVerðlagning
 
  1. Kynning
  2. Byrjaðu
  3. Uppsetning og stillingar
  4. Að nota TacoTranslate
  5. Þjónustuhliðarröðun
  6. Ítarleg notkun
  7. Bestu vinnubrögð
  8. Villumeðhöndlun og villuleit
  9. Stuðningsmál

Að nota TacoTranslate

Þýða strengji

Það eru nú þrjár leiðir til að þýða strengina: Translate componentið, useTranslation hookið, eða translateEntries gagnsemi.


Notkun Translate íhlutans.
Sýnir þýðingar innan span þátta og styður birtingu á HTML.

import {Translate} from 'tacotranslate/react';

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

Þú getur breytt tegund frumefnisins með því að nota, til dæmis, as="p" á íhlutnum.


Notkun á useTranslation hookinu.
Skilar þýðingum sem venjulegum streng. Gagnlegt í, til dæmis, meta merkjum.

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

Notkun á translateEntries gagnsemi.
Þýddu strengina á þjónustuhlið. Gefðu OpenGraph myndum þínum aukna krafta.

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

Hvernig strengir eru þýddir

Þegar strengi berast á okkar netþjóna, staðfestum við þá fyrst og vistum, svo skilarum við tafarlaust vélþýðingu. Þó að vélþýðingar séu almennt af lægri gæðum samanborið við AI-þýðingar okkar, veita þær skjótan fyrstu svörun.

Samtímis byrjum við á ósamstilltu þýðingaverkefni til að búa til há­gæða og nútímalega gervigreindarþýðingu fyrir strenginn þinn. Þegar gervigreindarþýðingin er tilbúin mun hún koma í stað vélþýðingarinnar og verða send hvenær sem þú biður um þýðingar fyrir textana þína.

Ef þú hefur þýtt streng handvirkt, hafa þær þýðingar forgang og eru skilað í staðinn.

Nýting frumkvæða

TacoTranslate verkefni innihalda það sem við köllum uppsprettur. Hugsaðu um þær sem inngangspunkta, möppur eða hópa fyrir strengina þína og þýðingar.

import {TacoTranslate} from 'tacotranslate/react';

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

Origins leyfa þér að aðskilja strengj af merkingarbærum flokkum. Til dæmis gætir þú haft einn origin fyrir skjölun og annan fyrir markaðssíðuna þína.

Fyrir nákvæmari stjórn gætir þú sett upp uppruna á íhlutasviði.

Til að ná þessu skaltu íhuga að nota marga TacoTranslate þjónustuveitendur innan verkefnis þíns.

Vinsamlegast athugið að sami strengur getur fengið mismunandi þýðingar í mismunandi origins.

Að lokum er það þitt og þörfum þínum að skipta strengjum í uppruna. Hins vegar skaltu hafa í huga að að hafa marga strengi innan eins uppruna getur aukið hleðslutíma.

Meðhöndlun breyta

Þú ættir alltaf að nota breytur fyrir gagnvirkt efni, eins og notendanafn, dagsetningar, netföng og fleira.

Breyturnar í strengjum eru tilkynntar með tvöföldum hornklofum, eins og {{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}});
}

Stjórnun á HTML innihaldi

Sjálfgefið styður og birtir Translate íhlutinn HTML-efni. Þú getur þó valið að hætta við þetta með því að stilla useDangerouslySetInnerHTML á false.

Það er eindregið mælt með því að slökkva á HTML-renderun þegar verið er að þýða efni sem ekki er treyst, svo sem efni sem notendur hafa búið til.

Allur úttak er alltaf hreinsaður með sanitize-html áður en það er birt.

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

Ofangreint dæmi mun vera birt sem venjulegur texti.

Þjónustuhliðarröðun

Vara frá NattskiftetFremt í Noregi