Skjöl: Að nota TacoTranslate

Að nota TacoTranslate

Icelandic

Þýðing strengja

Það eru að jafnaði þrjár leiðir til að þýða strengi: Translate íhlutinn, useTranslation hakaðurinn, eða translateEntries hjálpartækið.

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 króknum.
Skilar þýðingum sem hreinum streng. Nýtist 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 hjálparefnisins.
Þýddu textastrengi á þjónustuhlið. Gakktu úr skugga um að OpenGraph myndir þínar séu öflugri.

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

Þegar strengirnir berast til okkar netþjóna, staðfestum við þá fyrst og vistum, og skila síðan tafarlaust vélþýðingu. Þó að vélþýðingar séu almennt minni gæðaflokks en AI-þýðingar okkar, veita þær fljótlegt upphaflegt svar.

Á sama tíma setjum við af stað ósamstilltan þýðingarverkefni til að búa til hágæða, nútímalega AI-þýðingu fyrir strenginn þinn. Þegar AI-þýðingin er tilbúin mun hún koma í stað vélþýðingarinnar og verða send hvenær sem þú biður um þýðingar fyrir strengina þína.

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

Notkun uppruna

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

import {TacoTranslate} from 'tacotranslate/react';

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

Uppruni leyfir þér að aðskilja strengina í merkingarbærar einingar. Til dæmis gætir þú haft einn uppruna fyrir skjölun og annan fyrir markaðssíðuna þína.

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

Til að ná þessu markmiði skaltu íhuga að nota fleiri en einn TacoTranslate veitanda innan verkefnis þíns.

Vinsamlegast athugið að sama strengur getur fengið mismunandi þýðingar í mismunandi uppruna.

Að lokum er það undir þér komið hvernig þú skiptir strengjum í uppruna. Athugaðu þó að það getur aukið hleðslutíma að hafa marga strengi innan eins uppruna.

Meðhöndlun breyta

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

Breyturnar í strengjum eru skilgreindar 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}});
}

Meðhöndlun HTML-efnis

Í sjálfgefinni stillingu styður Translate íhluturinn HTML-innihald og birtir það. Þú getur þó valið að sleppa þessu með því að stilla useDangerouslySetInnerHTML á false.

Mælt er eindregið með að slökkva á HTML-renderingu þegar verið er að þýða ótraust efni, svo sem efni sem notendur hafa búið til.

Allt úttak er alltaf hreinsað 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 verður sýnt sem hreinn texti.

Þjónabirting

Að nota TacoTranslate

Hvernig eru strengir þýddir

Notkun uppruna

Meðhöndlun breyta

Meðhöndlun HTML-efnis